Python Script Engine  8.3
GL Studio Editor Python Script API
Gls3DCable Class Reference
+ Inheritance diagram for Gls3DCable:

Public Types

enum  ECollisionStyle {
  COLLISIONSTYLE_NONE = 0 ,
  COLLISIONSTYLE_FAST = 1
}
 
- Public Types inherited from DisplayObject
enum  MemberAccess_e {
  PUBLIC ,
  PRIVATE ,
  PROTECTED
}
 
enum  PickableType_e {
  UNPICKABLE ,
  FIRST_PICK ,
  BEST_PICK ,
  ALWAYS_PICK
}
 
enum  PolygonClose_e {
  POLY_OPEN ,
  POLY_CLOSED
}
 
enum  PolygonMode_e {
  POLY_MODE_UNDEFINED ,
  POLY_MODE_POINTS ,
  POLY_MODE_OUTLINE ,
  POLY_MODE_FILLED ,
  POLY_MODE_FILL_AND_OUTLINE
}
 
enum  ShadingType_e {
  SHADING_FLAT ,
  SHADING_GOURAUD
}
 
enum  TextureMap_e {
  TEXTURE_MAP_MODULATE ,
  TEXTURE_MAP_DECAL ,
  TEXTURE_MAP_BLEND ,
  TEXTURE_MAP_REPLACE
}
 
enum  TextureFilter_e {
  TEXTURE_FILTER_NEAREST ,
  TEXTURE_FILTER_LINEAR ,
  TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST ,
  TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR ,
  TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR ,
  TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST
}
 
enum  TessellateType_e {
  TESSELLATE_UNION ,
  TESSELLATE_INTERSECT ,
  TESSELLATE_DIFFERENCE
}
 
enum  RotationAxis_e {
  X_AXIS ,
  Y_AXIS ,
  Z_AXIS
}
 
enum  LineStyle_e {
  SOLID_LINE_STYLE ,
  SMALL_DOTTED_LINE_STYLE ,
  DOTTED_LINE_STYLE ,
  DASHED_LINE_STYLE ,
  DOT_DASHED_LINE_STYLE ,
  SMALL_DASHED_LINE_STYLE
}
 
enum  AlphaMode_e {
  ALPHA_MODE_UNDEFINED ,
  ALPHA_MODE_OPAQUE ,
  ALPHA_MODE_2_LEVEL ,
  ALPHA_MODE_256_LEVEL
}
 

Public Member Functions

 Gls3DCable ()
 
 Gls3DCable (Gls3DCable &src)
 
 Gls3DCable (DisplayObjectArray *objs)
 
int CollisionStyle ()
 
None CollisionStyle (int value)
 
float Flexibility ()
 
None Flexibility (float value)
 
bool Gravity ()
 
None Gravity (bool value)
 
float Length ()
 
None Length (float value)
 
int NumberOfSegments ()
 
None NumberOfSegments (int value)
 
int NumberOfSides ()
 
None NumberOfSides (int value)
 
float Radius ()
 
None Radius (float value)
 
- Public Member Functions inherited from Group
 Group ()
 
 Group (DisplayObjectArray *objs)
 
None Ungroup ()
 
None InsertObject (DisplayObject *obj, bool reparent=true, bool recalculateBoundingbox=true, int loc=DEFAULT_GROUP_LOCATION, bool renameName=false)
 
None InsertObjectAllowDuplicateNames (DisplayObject *obj, bool reparent=true, bool recalculateBoundingbox=true, int loc=DEFAULT_GROUP_LOCATION)
 
None MoveObjectToGroup (DisplayObject *obj, bool recalculateBoundingbox=true, int loc=DEFAULT_GROUP_LOCATION, bool renameName=false)
 
None MoveObjectToGroupAllowDuplicateNames (DisplayObject *obj, bool recalculateBoundingbox=true, int loc=DEFAULT_GROUP_LOCATION)
 
None ReorderObject (int oldIndex, int newIndex)
 
DisplayObjectArrayGetObjectList ()
 
DisplayObjectGetObjectByIndex (int index)
 
int Count ()
 
None CalculateTextureCoordinates (None)
 
None SetGroupLocation (Vertex &v)
 
None CalculateBoundingBox ()
 
int GetCount ()
 
- Public Member Functions inherited from DisplayObject
bool isNULL ()
 
str GetName ()
 
str SetName (str name)
 
None SetProtectionMode (DisplayObject::MemberAccess_e mode)
 
DisplayObject::MemberAccess_e GetProtectionMode (None)
 
None SetLocked (bool val)
 
bool GetLocked (None)
 
bool GetGenerateMemberVariable ()
 
None SetGenerateMemberVariable (bool b)
 
bool GetAntiAliasing ()
 
None SetAntiAliasing (bool antiAliasing)
 
bool GetBlinking ()
 
None SetBlinking (bool blinking)
 
float GetBlinkRate ()
 
None SetBlinkRate (float rate)
 
int GetAlphaMode ()
 
None SetAlphaMode (int mode)
 
bool GetCullBackFaces ()
 
None SetCullBackFaces (bool cullFaces)
 
bool GetZBufferTestedFlag ()
 
None SetZBufferTestedFlag (bool tested)
 
bool GetAffectZBufferFlag ()
 
None SetAffectZBufferFlag (bool affect)
 
bool GetLightingEnabledFlag ()
 
None SetLightingEnabledFlag (bool enabled)
 
DisplayObject::PickableType_e GetPickMode ()
 
None SetPickMode (DisplayObject::PickableType_e mode)
 
bool GetVisibilityFlag ()
 
None SetVisibilityFlag (bool visible)
 
PolygonClose_e GetClosePolygonFlag ()
 
None SetClosePolygonFlag (PolygonClose_e closePolygon)
 
PolygonMode_e GetPolygonMode ()
 
None SetPolygonMode (PolygonMode_e polygonMode)
 
ShadingType_e GetShadingMode ()
 
None SetShadingMode (ShadingType_e shadingMode)
 
Vertex GetLocation ()
 
None SetLocation (Vertex loc)
 
Vertex GetRotationPoint ()
 
None SetRotationPoint (Vertex rotPoint)
 
GlsMatrixAffineGetDcsMatrix ()
 
None SetDcsMatrix (GlsMatrixAffine *matrix)
 
int GetMaterialIndex ()
 
None SetMaterialIndex (int matIndex)
 
str GetObjectClassName ()
 
int GetTextureIndex ()
 
None SetTextureIndex (int texIndex)
 
TextureMap_e GetTextureMappingTechnique ()
 
None SetTextureMappingTechnique (TextureMap_e mappingTechnique)
 
bool GetTextureRepeat ()
 
None SetTextureRepeat (bool repeat)
 
disti::GlsColor GetBlendingColor ()
 
None SetBlendingColor (GlsColor blendColor)
 
DisplayObject::TextureFilter_e GetTextureMagnificationFilter ()
 
None SetTextureMagnificationFilter (DisplayObject::TextureFilter_e filter)
 
DisplayObject::TextureFilter_e GetTextureMinificationFilter ()
 
None SetTextureMinificationFilter (DisplayObject::TextureFilter_e filter)
 
list GetTextureCoordinates ()
 
None SetTextureCoordinates (list &texVerts)
 
None GetTextureCoordinates (VertexArray *texVerts)
 
None SetTextureCoordinates (VertexArray &texVerts)
 
None GetTexturePoints (VertexArray *texVerts)
 
None SetTexturePoints (VertexArray &texVerts)
 
None SetTexturePoints (list &texVerts)
 
list GetTexturePoints ()
 
None GetVertices (VertexArray *verts)
 
None SetVertices (VertexArray &verts)
 
str GetInitialization ()
 
None SetInitialization (str initCode)
 
str GetCallbackCode ()
 
None SetCallbackCode (str cbCode)
 
DisplayObjectDuplicateObject (Document *doc=NULL)
 
DisplayObjectTessellateObject ()
 
DisplayObjectExtrudeObject (float amount)
 
None RotateObject (float amount, RotationAxis_e axis)
 
None TranslateObject (float x, float y, float z)
 
None ScaleObject (float x, float y, float z, Vertex *anchor=NULL)
 
None LineWidth (float width)
 
float LineWidth ()
 
LineStyle_e LineStyle ()
 
None LineStyle (LineStyle_e style)
 
GlsColor LineColor ()
 
None LineColor (GlsColor color)
 
GlsColor FillColor ()
 
None FillColor (GlsColor color)
 
None GetExtents (Vector &min, Vector &max)
 
bool HasUserDefinedAttribute (str attribName)
 
std::map< str, str > GetUserDefinedAttributes ()
 
UserDefinedValueAttributeList GetAllUserDefinedAttributes ()
 
str GetUserDefinedAttributeValue (str attribName)
 
 typemap (check) str attribName
 
None SetUserDefinedAttributeValue (str attribName, str value)
 
DisplayObjectGetParent ()
 
DocumentGetDocument ()
 
str AlternateClassName ()
 
None AlternateClassName (str name)
 
str GetAlternateClassHeaderFile ()
 
None SetAlternateClassHeaderFile (str name)
 
str GetResources ()
 
str GetRuntimeResources (bool recursive)
 
str GetAttributeType (str attribName)
 
str GetAttributeValuestr (str attribName)
 
None SetAttributeValuestr (str attribName, str value)
 
int RegisterObserver (str attribName, PyObject *pyfunc)
 
None UnregisterObserver (str attribName, int id)
 
list GetNormals ()
 
None SetNormals (list &normals)
 
list GetExtraAttributes ()
 
DisplayObjectCloneObject ()
 
None CopyProperties (DisplayObject *sourceObj)
 
None SetLocation (Vector loc)
 
GlsMatrixAffine GetObjectCoordinatesTransform (DisplayObject *targetObject)
 
None CalculateParentBoundingBox ()
 
None SetOrigin (Vertex &vert)
 

Static Public Member Functions

static Gls3DCableCastToGls3DCable (DisplayObject *obj)
 
- Static Public Member Functions inherited from Group
static GroupCastToGroup (DisplayObject *obj)
 

Additional Inherited Members

- Static Public Attributes inherited from Group
static int DEFAULT_GROUP_LOCATION = -1
 
- Static Public Attributes inherited from DisplayObject
static int TEXTURE_INDEX_NONE = -1
 

Detailed Description

Plug-in used to create 3d cables in GL Studio.

Member Enumeration Documentation

◆ ECollisionStyle

CollisionStyle values.

Enumerator
COLLISIONSTYLE_NONE 
COLLISIONSTYLE_FAST 

Constructor & Destructor Documentation

◆ Gls3DCable() [1/3]

Gls3DCable::Gls3DCable ( )

default ructor

◆ Gls3DCable() [2/3]

Gls3DCable::Gls3DCable ( Gls3DCable src)

copy ructor

◆ Gls3DCable() [3/3]

Gls3DCable::Gls3DCable ( DisplayObjectArray objs)

Convert-to-Gls3DCable ructor.

Parameters
objsArray of display objects to be combined into the 3D Cable

Member Function Documentation

◆ CastToGls3DCable()

static Gls3DCable * Gls3DCable::CastToGls3DCable ( DisplayObject obj)
static

Casts the Display Object as a Gls3DCable NOTE: perform an isNULL check on the returned value to ensure the cast was accomplished.

Parameters
objobjects to cast
Returns
Gls3DCable the Gls3DCable
Exceptions
CEIException

◆ CollisionStyle() [1/2]

int Gls3DCable::CollisionStyle ( )

Gets the collision style.

Returns
The current collision style

◆ CollisionStyle() [2/2]

None Gls3DCable::CollisionStyle ( int  value)

Sets the collision style COLLISIONSTYLE_NONE will disable all collision detection and therefore any cable deformation caused thereby.


COLLISIONSTYLE_FAST will check for collisions with other objects in the scene, but will only move / orient the cable midpoint such that it appears as though the cable is laying flat on a single surface.

Parameters
valueThe collision mode for the cable.

◆ Flexibility() [1/2]

float Gls3DCable::Flexibility ( )

Gets the flexibility ant.

Returns
How stiff the cable is.

◆ Flexibility() [2/2]

None Gls3DCable::Flexibility ( float  value)

Sets the flexibility ant.

Parameters
valueControls how stiff the cable is. The value should be in the range of 0 to 1, inclusive. 0 is very inflexible, while 1 is very flexible.

◆ Gravity() [1/2]

bool Gls3DCable::Gravity ( )

Gets the gravity enable flag.

Returns
Returns whether or not gravity is simulated on the cable.

◆ Gravity() [2/2]

None Gls3DCable::Gravity ( bool  value)

Sets the gravity enable flag.

Parameters
valueWhether or not to simulate gravity on the cable.

◆ Length() [1/2]

float Gls3DCable::Length ( )

Gets the length of the cable.

Returns
The length of the cable in logical units.

◆ Length() [2/2]

None Gls3DCable::Length ( float  value)

Sets the length of the cable This is the cable length when not under duress (the cable will stretch when the end-points are moved too far from each other).

Parameters
valueThe approximate length of the cable in logical units.

◆ NumberOfSegments() [1/2]

int Gls3DCable::NumberOfSegments ( )

Gets the number of segments.

Returns
The number of segments in the cable.

◆ NumberOfSegments() [2/2]

None Gls3DCable::NumberOfSegments ( int  value)

Sets the number of segments This is the number of segments in the entire length of the cable.

A cable with one section (that is, with only two control objects) would be a straight cylinder connecting two points, incapable of bending.
The higher this number, the smoother your cable will appear.

Parameters
valueThe number of cylindrical segments that will traverse

◆ NumberOfSides() [1/2]

int Gls3DCable::NumberOfSides ( )

Gets the number of sides.

Returns
The number of sides on the cable.

◆ NumberOfSides() [2/2]

None Gls3DCable::NumberOfSides ( int  value)

Sets the number of sides The more sides, the smoother the cable will appear.


A value of two will produce a ribbon-like cable.
A value of one will render only a line.

Parameters
valueThe number of sides the cable "tube" will have.

◆ Radius() [1/2]

float Gls3DCable::Radius ( )

Gets the radius of the cable.

Returns
The radius in logical units.

◆ Radius() [2/2]

None Gls3DCable::Radius ( float  value)

Sets the radius of the cable.

Parameters
valueThe radius in logical units.

The documentation for this class was generated from the following file: