CreatePrim

Categories

primitive

Description

Creates an implicit primitive and converts it to a given geometry type. Contrary to implicit primitives, converted primitives have explicit geometry elements that can be manipulated, ex.: control points, edges, polygons...

Note: The implicit primitives must be compatible with the geometry types. For more information, see the $cdname X3DObject.AddGeometry@cdname method.

Scripting Syntax

oReturn = CreatePrim( PresetObj, GeometryType, [Name], [Parent] );

Return Value

Returns the primitive object (usually an X3DObject object).

Parameters

Parameter Type Description
PresetObj String or a preset object (see SIGetPreset) Geometry Primitives
GeometryType String Geometry type

Possible Values:

Description:

NurbsCurve Convert primitive to a Nurbs curve
NurbsSurface Convert primitive to a Nurbs surface
MeshSurface Convert primitive to a Mesh surface
PointCloud Convert primitive to a PointCloudGeometry
Name String Name of the new object.
Parent String Name of an existing object to use as the parent of the new primitive.

Examples

VBScript Example

'This example creates a new primitive
newscene
dim nurbssphere, meshsphere
'Create a nurbs sphere and name it aSphere. Assign to variable nurbssphere
set nurbssphere = CreatePrim( "Sphere", "NurbsSurface", "aSphere" )
'Create a mesh sphere and name it bSphere. Assign to variable meshsphere.
'Make bSphere child of aSphere
set meshsphere = CreatePrim( "Sphere", "MeshSurface", "bSphere", "aSphere" )
'Logged information:
'INFO : "Sphere information: X3DObject polymsh"
logmessage "Sphere information: " & typename( meshsphere) & " " & meshsphere.type

See Also

GetPrim SIGetPrim