Cobject

Describes a scene object.

Inherits from

Cpointer.

Sub-classes

Citerator

Methods

free

Destroys the object.

Return value

0 = Error destroying object.

1 = Success.

getName

Gets the name of the object.

Return value

C++

0 = Error getting name.

1 = Success.

Python

Object name.

setName

Sets the name of the object.

Return value

0 = Error setting name.

1 = Success.

isMesh

Checks whether the object is a mesh.

Return value

C++

0 = Error getting isMesh value.

1 = Success.

Python

0 = The object is not a mesh.

1 = The object is a mesh.

"" = Error.

isInstance

Checks whether the object is an instance.

Return value

C++

0 = Error getting isInstance value.

1 = Success.

Python

0 = The object is not an instance.

1 = The object is an instance.

"" = Error.

getInstanced

If this Cobject is an instance this method returns its parent object.

Return value

Cmaxwell::Cobject reference to the instanced object. Null object if the object is not an instance, (Cmaxwell::Cobject::isNull() == true).

isRFRK

Checks whether the object is a RealFlow RenderKit object.

Return value

C++

0 = Error getting isRfrk value.

1 = Success.

Python

0 = Object is not a RFRK object.

1 = Object is a RFRK object.

"" = Error.

getRFRKParameters

Gets RealFlow parameters of the object if it is a RFRK object.

Parameters

Return value

C++

0 = Error getting RFRK parameters.

1 = Success.

Python

Dictionary containing all RFRK parameters.

"" = Error.

setRFRKParameters

Gets RealFlow parameters of the object if it is a RFRK object.

Parameters

Return value

0 = Error setting RFRK parameters.

1 = Success.

getReferencedScenePath

Gets the scene file referenced by this object.

setReferencedScenePach

Sets the scene file referenced by this object.

Return value

0 = Error setting reference scene file.

1 = Success.

getReferencedSceneMaterial

Gets the material of an specific object inside the referenced scene.

setReferencedSceneMaterial

Sets the material of an specific object inside the referenced scene.

Return value

0 = Error setting reference scene file.

1 = Success.

mergeMeshes

Merges an array of meshes into a single mesh. The original meshes are not removed (it can be done later calling Cmaxwell::Cobject::free() ). The target object must not be included in the mesh list, so target geometry (if exists) will be erased.

Return value

0 = Error setting reference scene file.

1 = Success.

Examples

meshes  = []
meshes.append( scene.getObject("sphere") );
meshes.append( scene.getObject("cube") );
scene.getObject("cubesphere").mergeMeshes( meshes ); // "cubesphere must exists"
scene.getObject("sphere").free();
scene.getObject("cube").free(); 

getParent

Gets the parent object in the hierarchy.

Return value

C++

0 = Error getting parent object.

1 = Success.

Python

Parent object.

setParent

Sets the parent object in the hierarchy.

Return value

0 = Error setting parent object.

1 = Success.

getUuid

Unique user ID that can be used for custom purposes.

setUuid

Sets the unique user ID.

Return value

0 = Error setting unique user ID.

1 = Success.

getMaterial

Gets the material applied.

Return value

C++

0 = Error getting object material.

1 = Success.

Python

Object material.

setMaterial

Sets the object material.

Return value

0 = Error setting object material.

1 = Success.

setProperties

Sets the caustics properties of the object. 1 enables, 0 disables.

Return value

0 = Error setting object material.

1 = Success.

getDependencies

Returns an array of strings with all the extern dependencies of the object (rfrk files, etc).

Parameters

Return value

C++

0 = Error getting dependency paths.

1 = Success.

Python

List of str containing the dependency paths.

getNumVertexes

Gets number of vertexes of the object.

Return value

C++

0 = Error getting number of vertexes.

1 = Success.

Python

Number of vertexes.

getNumTriangles

Gets number of triangles of the object.

Return value

C++

0 = Error getting number of triangles.

1 = Success.

Python

Number of triangles.

getNumNormals

Gets number of normals of the object.

Return value

C++

0 = Error getting number of normals.

1 = Success.

Python

Number of normals.

getNumPositionsPerVertex

Gets number of positions per vertex of the object.

Return value

C++

0 = Error getting number of positions per vertex.

1 = Success.

Python

Number of positions per vertex.

getNumChannelsUVW

Gets number of UVW channels of the object.

Return value

C++

0 = Error getting number UVW channels.

1 = Success.

Python

Number of UVW channels.

addChannelUVW

Adds an UVW channel to the object.

Return value

C++

0 = Error adding UVW channel.

1 = Success.

Python

Index of the new channel.

generateSphericalUVW

Generates spherical UVW coordinates.

Return value

0 = Error generating spherical UVW coordinaltes.

1 = Success.

generateCylindricalUVW

Generates cylindrical UVW coordinates.

Return value

0 = Error generating cylindrical UVW coordinaltes.

1 = Success.

generateCubicUVW

Generates cubic UVW coordinates.

Return value

0 = Error generating cubic UVW coordinaltes.

1 = Success.

generatePlanarUVW

Generates planar UVW coordinates.

Return value

0 = Error generating planar UVW coordinaltes.

1 = Success.

getVertex

Gets vertex by index.

Return value

C++

0 = Error getting the vertex.

1 = Success.

Python

Cvector containing the vertex requested.

setVertex

Sets vertex by index.

Return value

0 = Error setting the vertex.

1 = Success.

getNormal

Gets normal by index.

Return value

C++

0 = Error getting the normal.

1 = Success.

Python

Cvector containing the normal requested.

setNormal

Sets normal by index.

Return value

0 = Error setting the normal.

1 = Success.

getTriangle

Gets triangle (vertexes and normals) by index.

Return value

C++

0 = Error getting the triangle.

1 = Success.

Python

Dictionary containing the triangle data ("iVertex1", "iVertex2", "iVertex3", "iNormal1", "iNormal2", "iNormal3").

setTriangle

Sets triangle (vertexes and normals) by index.

Return value

0 = Error setting the triangle.

1 = Success.

getTriangleGroup

Gets triangle group by index.

Return value

C++

0 = Error getting the triangle group.

1 = Success.

Python

Triangle group ID.

setTriangleGroup

Sets group that's the triangle belongs to.

Return value

0 = Error setting the triangle group.

1 = Success.

getTriangleUVW

Gets triangle UVW coordinates.

Return value

C++

0 = Error getting the triangle UVW coordinates.

1 = Success.

Python

Dictionary containing the triangle UVW coordinates ('u1','v1,'w1,'u2','v2','w2','u2','v2','w3').

setTriangleUVW

Sets triangle UVW coordinantes.

Return value

0 = Error setting the triangle UVW coordinates.

1 = Success.

getTriangleMaterial

Gets triangle material.

Return value

C++

0 = Error getting triangle material.

1 = Success.

Python

Triangle material.

setTriangleMaterial

Sets the triangle material.

Return value

0 = Error setting triangle material.

1 = Success.

getGroupMaterial

Gets material of a group of triangles.

Return value

C++

0 = Error getting triangle group material.

1 = Success.

Python

Triangle group material.

setGroupMaterial

Sets material of a group of triangles.

Return value

0 = Error setting triangle group material.

1 = Success.

setBaseAndPivot

Sets base and pivot axes of the object.

Return value

0 = Error setting object base and pivot.

1 = Success.

getBaseAndPivot

Gets base and pivot axes of the object.

Return value

C++

0 = Error getting object base and pivot.

1 = Success.

Python

Object base and pivot axes.

getWorldTransform

Returns the world transform of the object taking into account base and pivot of all its parents..

Return value

C++

0 = Error getting world transform of the object.

1 = Success.

Python

Object world transform.

getTransfromSubstepsCount

Return the number of substeps used for defining Base and Pivot motion blur.

getTransformStepInfoByIndex

Return transform information( base, pivot and time) for the given index.

Return value

C++

0 = Error getting transform information of the object.

1 = Success.

Python

Dictionary containing transform information ('base','pivot','time').

isPosRotScaleInitialized

Checks if any of the following methods have been used for the object: setPosition, setRotation, setScale, setShear, setPivotPosition and setPivotRotation. The correct way to transform the object is through the setBaseAndPivot method.

Return value

C++

0 = Error getting object transformed for Maxwell Studio.

1 = Success.

Python

True = object initialized using setPosition, setRotation, setScale, setShear, setPivotPosition and/or setPivotRotation (methods used for Maxwell Studio, not for rendering.

cleanGeometry

Optional routine that removes degenerated triangles, repeated/unused vertex and normals. This function is automatically called inside the writeMXS method. It is not needed to call it except in scenarios like the interactive engine.

Return value

0 = Error cleaning geometry.

1 = Success.