Difference between revisions of "PRIM TYPE SCULPT"

From Second Life Wiki
Jump to: navigation, search
Line 4: Line 4:
  
 
{{LSL_Function/inventory|map|uuid=true|type=texture|{{#ifeq:{{{1|}}}|get|no_caveat=true}}|full={{{remote|}}}}}
 
{{LSL_Function/inventory|map|uuid=true|type=texture|{{#ifeq:{{{1|}}}|get|no_caveat=true}}|full={{{remote|}}}}}
{{#vardefine:p_type_desc|PRIM_SCULPT_TYPE_* flag}}
+
{{#vardefine:p_type_desc|PRIM_SCULPT_TYPE_* flag with optional additional PRIM_SCULPT_FLAG_* flags OR'ed on}}
  
 
}}</onlyinclude>{{#if:
 
}}</onlyinclude>{{#if:
Line 17: Line 17:
 
|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]].
 
|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 65: Line 66:
 
{{LSL DefineRow||[[changed]]|}}
 
{{LSL DefineRow||[[changed]]|}}
 
|location
 
|location
 +
|history=
 +
* {{SVN|1053|rev=94734|branch=trunk|date=Tuesday, 19 August 2008}} - PRIM_SCULPT_FLAG_* syntax merged into the Trunk. Support for syntax slated for Client 1.21.0
 +
* {{SVN|758|rev=91966|branch=featurettes-5|date=Thursday, 10 July 2008}} - Introduction of PRIM_SCULPT_FLAG_* extended syntax.
 
|cat1=Prim
 
|cat1=Prim
 
|cat2
 
|cat2

Revision as of 16:26, 21 August 2008

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_A 5 Mesh model See: Mesh
PRIM_SCULPT_FLAG_ZZZZZZZZ 63
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

  • 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.
All Issues ~ Search JIRA for related Bugs

Related Articles

Constants

•  PRIM_TYPE
•  CHANGED_SHAPE

Functions

•  llSetPrimitiveParams
•  llSetLinkPrimitiveParams
•  llGetPrimitiveParams

Events

•  changed

Examples

<lsl>llSetPrimitiveParams([PRIM_TYPE,

                       PRIM_TYPE_SCULPT, 
                           "d962089b-2197-993c-9ec9-4993eb0a95f2",  // sculpty texture
                           PRIM_SCULPT_TYPE_SPHERE                  // type
                     ]);</lsl>

<lsl>//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));
   }

}</lsl>

<lsl>//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 grey color you see on your sculpt object is the SL no found texture that is grey.

}</lsl>

Deep Notes

History

Search JIRA for related Issues

Signature

integer PRIM_TYPE_SCULPT = 7;