Difference between revisions of "PRIM TYPE SCULPT"

From Second Life Wiki
Jump to navigation Jump to search
m (<lsl> tag to <source>)
 
(14 intermediate revisions by 2 users not shown)
Line 3: Line 3:
{{#vardefine:type_sculpt_const|{{LSL Const|PRIM_TYPE_SCULPT|integer|7|c=A parameter of PRIM_TYPE used to make prim into a sculpty and to change specific properties that define it's shape and type.}}}}
{{#vardefine:type_sculpt_const|{{LSL Const|PRIM_TYPE_SCULPT|integer|7|c=A parameter of PRIM_TYPE used to make prim into a sculpty and to change specific properties that define it's shape and type.}}}}


{{LSL_Function/inventory|map|uuid=true|type=texture|{{#ifeq:{{{1|}}}|get|no_caveat=true}}|full={{{remote|}}}}}
{{#if:{{{child|}}}||
 
{{#vardefine:caveats-before|{{#var:caveats}}{{#vardefine:caveats}}}}
 
{{LSL_Function/inventory|map|uuid=true|type=texture|full={{{remote|}}}|remote={{#ifeq:{{{1|set}}}|get|*}}}}
 
{{#vardefine:p_type_desc|PRIM_SCULPT_TYPE_* flag with optional additional PRIM_SCULPT_FLAG_* flags OR'ed on}}
{{#vardefine:p_type_desc|PRIM_SCULPT_TYPE_* flag with optional additional PRIM_SCULPT_FLAG_* flags OR'ed on}}
{{#vardefine:caveats-get|{{#var:caveats-get}}
*The value of {{LSLP|map}} is {{LSL Constant/NULL KEY}} when the {{LSLGC|Owner|owner}} does not have {{LSLGC|Permissions/Asset|full permissions}} to the object and the map asset is not in the prim's inventory.
{{#var:caveats}}}}
{{#vardefine:caveats|{{#var:caveats-before}}{{#vardefine:caveats-before}}
{{#var:caveats-{{{1|get}}}}}{{#vardefine:caveats-{{{1|get}}}}}}}
{{#vardefine:caveats-set|{{#var:caveats-set}}
*While it is possible to use {{#if:<noinclude>1</noinclude>|this|{{#var:type_sculpt_const}}}} to animate an object, it is not recommended. For details see: [[Why UUID Flipping is Bad]]}}
}}


}}</onlyinclude>{{#if:
}}</onlyinclude>{{#if:
{{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats-set}}}}


}}{{LSL Constant
}}{{LSL Constant
Line 17: Line 37:
|text=For use with [[llSetPrimitiveParams]] and [[llSetLinkPrimitiveParams]]
|text=For use with [[llSetPrimitiveParams]] and [[llSetLinkPrimitiveParams]]
{{LSL_Constants/PrimitiveParams/sculpt_types|table=*|sortable=*}}
{{LSL_Constants/PrimitiveParams/sculpt_types|table=*|sortable=*}}
{{LSL Const|PRIM_SCULPT_TYPE_MASK|integer|7|c=Used to filter out the PRIM_SCULPT_FLAG_* flags from the type to determine the PRIM_SCULPT_TYPE_* flag}} can be used to filter out the PRIM_SCULPT_FLAG_* flags from the '''type''' to determine the PRIM_SCULPT_TYPE_* flag. The main application of this would be when using [[llGetPrimitiveParams]].
{{LSL Const|PRIM_SCULPT_TYPE_MASK|integer|7|c=Used to filter out the PRIM_SCULPT_FLAG_* flags from the type to determine the PRIM_SCULPT_TYPE_* flag}} can be used to filter out the PRIM_SCULPT_FLAG_* flags from the {{LSLP|type}} to determine the PRIM_SCULPT_TYPE_* flag. The main application of this would be when using [[llGetPrimitiveParams]].
|i1_type=string |i1_name=map
|i1_type=string |i1_name=map
|i2_type=integer|i2_name=type
|i2_type=integer|i2_name=type
Line 23: Line 43:
}}
}}
|examples=
|examples=
<lsl>llSetPrimitiveParams([PRIM_TYPE,  
<source lang="lsl2">llSetPrimitiveParams([PRIM_TYPE,  
                         PRIM_TYPE_SCULPT,  
                         PRIM_TYPE_SCULPT,  
                             "d962089b-2197-993c-9ec9-4993eb0a95f2",  // sculpty texture
                             "d962089b-2197-993c-9ec9-4993eb0a95f2",  // sculpty texture
                             PRIM_SCULPT_TYPE_SPHERE                  // type
                             PRIM_SCULPT_TYPE_SPHERE                  // type
                       ]);</lsl>
                            | PRIM_SCULPT_FLAG_MIRROR    // use pipe | to add each flag
<lsl>//Rotates between the different sculpt types.
                       ]);</source>
<source lang="lsl2">//Rotates between the different sculpt types.
default
default
{
{
Line 41: Line 62:
         llSetPrimitiveParams(PRIM_TYPE + llList2List(b, 0, 1) + (type + 1));
         llSetPrimitiveParams(PRIM_TYPE + llList2List(b, 0, 1) + (type + 1));
     }
     }
}</lsl>
}</source>


<lsl>//A simple script to setup a prim as a sculpty.
<source lang="lsl2">//A simple script to setup a prim as a sculpty.
default
default
{
{
Line 53: Line 74:
//          , PRIM_SIZE, <0.63,0.199,0.52> // If you need to change the scale (size) of the object, uncomment this line.
//          , PRIM_SIZE, <0.63,0.199,0.52> // If you need to change the scale (size) of the object, uncomment this line.
         ]);
         ]);
     } // The grey color you see on your sculpt object is the SL no found texture that is grey.
     } // The gray color you see on your sculpt object is the SL no found texture that is gray.
}</lsl>
}</source>


|constants=
|constants=

Latest revision as of 17:04, 23 January 2015

Description

Constant: integer PRIM_TYPE_SCULPT = 7;

The integer constant PRIM_TYPE_SCULPT has the value 7

PRIM_TYPE_SCULPT is a parameter of PRIM_TYPE used to make a prim into a sculpty of specific shape and type.
Sculpted Prims: FAQ

PRIM_TYPE

[ PRIM_TYPE, PRIM_TYPE_SCULPT, string map, integer type ]
• string map a texture in the inventory of the prim this script is in or a UUID of a texture
• integer type PRIM_SCULPT_TYPE_* flag with optional additional PRIM_SCULPT_FLAG_* flags OR'ed on

For use with llSetPrimitiveParams and llSetLinkPrimitiveParams

type Flags Style Description
PRIM_SCULPT_TYPE_SPHERE 1 Sphere Converge top & bottom, stitch left side to right
PRIM_SCULPT_TYPE_TORUS 2 Torus Stitch top to bottom, stitch left side to right
PRIM_SCULPT_TYPE_PLANE 3 Plane No stitching or converging
PRIM_SCULPT_TYPE_CYLINDER 4 Cylinder Stitch left side to right.
PRIM_SCULPT_TYPE_MESH 5 Mesh model See: Mesh
PRIM_SCULPT_FLAG_ZZZZZZZZ 63
PRIM_SCULPT_FLAG_ANIMESH 0x20 Animesh Read-only flag to query Animated mesh status.
PRIM_SCULPT_FLAG_INVERT 0x40 Invert Render inside out (inverts the normals).
PRIM_SCULPT_FLAG_MIRROR 0x80 Mirror Render an X axis mirror of the sculpty.

PRIM_SCULPT_TYPE_MASK can be used to filter out the PRIM_SCULPT_FLAG_* flags from the type to determine the PRIM_SCULPT_TYPE_* flag. The main application of this would be when using llGetPrimitiveParams.

Caveats

  • The value of map is NULL_KEY when the owner does not have full permissions to the object and the map asset is not in the prim's inventory.
  • If map is missing from the prim's inventory and it is not a UUID or it is not a texture then an error is shouted on DEBUG_CHANNEL.
  • If map is a UUID then there are no new asset permissions consequences for the object.
    • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
  • While it is possible to use this to animate an object, it is not recommended. For details see: Why UUID Flipping is Bad
All Issues ~ Search JIRA for related Bugs

Related Articles

Constants

•  PRIM_TYPE
•  CHANGED_SHAPE

Functions

•  llSetPrimitiveParams
•  llSetLinkPrimitiveParams
•  llGetPrimitiveParams

Events

•  changed

Examples

llSetPrimitiveParams([PRIM_TYPE, 
                        PRIM_TYPE_SCULPT, 
                            "d962089b-2197-993c-9ec9-4993eb0a95f2",  // sculpty texture
                            PRIM_SCULPT_TYPE_SPHERE                  // type
                            | PRIM_SCULPT_FLAG_MIRROR     // use pipe | to add each flag
                      ]);
//Rotates between the different sculpt types.
default
{
    touch_start(integer a)
    {
        list b = llGetPrimitiveParams([PRIM_TYPE]);
        integer type = llList2Integer(b,2) % 4;
        llSetObjectDesc(llList2String([ "Sphere",
                                        "Torus",
                                        "Plane",
                                        "Cylinder"], type));
        llSetPrimitiveParams(PRIM_TYPE + llList2List(b, 0, 1) + (type + 1));
    }
}
//A simple script to setup a prim as a sculpty.
default
{
    state_entry()
    {
        llSetPrimitiveParams([
            PRIM_TYPE, PRIM_TYPE_SCULPT, "your Sculpt map name in the object", PRIM_SCULPT_TYPE_SPHERE
          , PRIM_TEXTURE, ALL_SIDES, "your texture name in the object", <1.0, 1.0, 0.0>, <0.0, 0.0, 0.0>, 0.0 //comment out if not needed.
//          , PRIM_SIZE, <0.63,0.199,0.52> // If you need to change the scale (size) of the object, uncomment this line.
        ]);
    } // The gray color you see on your sculpt object is the SL no found texture that is gray.
}

Deep Notes

History

Search JIRA for related Issues

Signature

integer PRIM_TYPE_SCULPT = 7;