The Cmaxwell class describes the whole Maxwell Render scene.
...
typeCallback and InteractiveFlags.
Methods
| Name | Description |
|---|---|
| Cmaxwell | Class constructor. |
| ~Cmaxwell | Class destructor. |
| getMxsVersion | Gets MXS file version. |
| getMostRecentVersionMXS | Gets most recent MXS version supported. |
| getPluginID | Gets the plug-in identifier from which the MXS was created. |
| setPluginID | Gets the plug-in identifier from which the MXS was created. |
| isProtectionEnabled | Gets scene protection state in Maxwell Studio (ability to export to other formats). |
| enableProtection | Sets scene protection state in Maxwell Studio (ability to export to other formats). |
| Scene methods | |
| freeGeometry | Deletes all geometry of the scene. |
| freeScene | Resets the scene. Cleans all objects, geometry, materials, etc. |
| getScenePreview | Preview image of the scene stored in the file (useful for thumbnals). |
| setScenePreview | Sets preview image. |
| readPreview | Sets sene preview image from another MXS. |
| setInputDataType | Set the axis orientation of the scene. |
| setSinglePrecisionOfGeometry | Uses floats instead of doubles for geometry. |
| setSceneUserData | Internal use. |
| addCluster | Adds a triangle cluster to the scene. |
| Object methods | |
| getObject | Gets a object reference from the scene. |
| createMesh | Creates a mesh with the given parameters and adds it to the scene. |
| createInstancement | Creates an instancement. |
| createProxy | Creates a proxy object from a MXS. |
| createRFRK | Creates a RealFlow RenderKit object. |
| addObject | Adds an existent object to the scene. |
| mergeMeshes | Merges meshes into a new one. |
| Camera methods | |
| addCamera | Adds a new camera to the scene with the given parameters. |
| getCamera | Gets a camera requested by name. |
| getActiveCamera | Gets the active camera of the scene. |
| Paths methods | |
| setPath | Sets the path and depth for the given channel. |
| getPath | Gets the path and depth for the given channel. |
| addSearchingPath | Adds a path to look for missing textures, ior and ies files. |
| getSearchingPaths | Gets all searching paths of the scene. |
| Sky methods | |
| getSunPositionType | Sets sun position type. |
| setSunPositionType | Gets sun position type. |
| getSkyConstant | Gets the parameters of the constant sky. |
| setSkyConstant | Sets the parameters of the constant sky. |
| getSunLongitudeAndLatitude | Gets sun longitude and latitude data. |
| setSunLongitudeAndLatitude | Sets sun longitude and latitude data. |
| getSunAngles | Gets sun position angles. |
| setSunAngles | Sets sun position angles. |
| getSunDirection | Gets sun direction vector. |
| setSunDirection | Sets sun direction vector. |
| getSunRotation | Gets sun rotation angles. |
| setSunRotation | Sets sun rotation angles. |
| getSunProperties | Gets sun properties |
| setSunProperties | Sets sun properties. |
| getPhysicalSkyAtmosphere | Gets physical atmosphere parameters. |
| setPhysicalSkyAtmosphere | Sets physical atmosphere parameters. |
| getActiveSky | Gets active sky name. |
| setActiveSky | Sets active sky name. |
| Additional sky methods | |
| getSunDirectionUsedForRendering | Returns the sun direction. |
| saveSkyToHDR | Saves current sky to an HDR file. |
| saveSkyToPreset | Saves current physical sky values to a file. |
| loadSkyFromPreset | Loads a preset file replacing current physical sky values. |
| getSkyColor | Returns sky RGB color of the current sky values in the given direction. |
| getSkyColorNoTonemapped | Returns sky RGB color (without tonemapping nor exposure) of the current sky values in the given direction. |
| Environment methods | |
| isEnvironmentEnabled | Gets IBL (Image Based Lighting) state. |
| enableEnvironment | Sets the IBL (Image Based Lighting) on/off. |
| getEnvironmentWeight | Gets the value for the global multiplier of all the environment layers. |
| setEnvironmentWeight | Sets the value for the global multiplier of all the environment layers. |
| getEnvironmentLayer | Gets the parameters of each environment layer. |
| setEnvironmentLayer | Sets the parameters of each environment layer. |
| Material methods | |
| readMaterial | Reads a material from file (MXM). |
| createMaterial | Creates a new material. |
| getMaterial | Gets a material by name. |
| addMaterial | Adds a material to the scene. |
| eraseUnusedMaterials | Remove unused materials from the scene. |
| setOverrideMaterial | Sets the path and state (enabled/disabled) of the material that overrides all materials of the scene (except emitter materials). |
| getOverrideMaterial | gets the path and state (enabled/disabled) of the material that overrides all materials of the scene (except emitter materials). |
| setDefaultMaterial | Sets the path and state (enabled/disabled) of the material that will be used for all the objects/triangles without material. |
| getDefaultMaterial | Gets the path and state (enabled/disabled) of the material that will be used for all the objects/triangles without material. |
| Render methods | |
| setRenderParameter | Sets render parameter. |
| getRenderParameter | Gets render parameter. |
| Tonemapping methods | |
| getToneMapping | Gets tonemapping values. |
| setToneMapping | Sets tonemapping values. |
| getActiveToneMapping | Gets the active tonemapping used ("BASIC" or "ADVANCED" ). |
| setAdvancedToneMapping | Deprecated. |
| getAdvancedToneMapping | Deprecated. |
| Read/write scene methods | |
| readMXS | Reads scene from disk. |
| writeMXS | Writes scene to disk. |
| Glare methods | |
| setDiffraction | Sets diffraction parameters. |
| getDiffraction | Gets diffraction parameters. |
| enableDiffraction | Enables diffraction. |
| disableDiffraction | Disables diffraction. |
| setColorSpace | Sets the output color space used by the render engine. |
| getColorSpace | Gets the output color space used by the render engine. |
| getColorSpaceGamma | Returns the gamma used by the active color space. |
| Miscellaneous methods | |
| getLastError | Returns the latest error occurred. |
| getLastErrorString | Returns an human readable string containing the latest error occurred. |
| getDependencies | Returns all the extern dependencies of the scene (textures, ior files, hdr files, etc). |
| getObjectsCount | Returns the number of objects in the scene. |
| getMaterialsCount | Returns the number of materials in the scene. |
| getCamerasCount | Returns the number of cameras in the scene. |
| getTriangleGroupsCount | Returns the number of triangle groups in the scene. Deprecated. |
| getSceneInfo | Returns by reference a Cmaxwell::CsceneInfo structure with information about the scene. |
| computeFresnelGraph | --TODO-- |
| computeAbbeGraph | --TODO-- |
| getCorrelatedColorTemperature | Gets the correlated RGB values given the temperature color. |
| generateUuid | Generates an unique ID. |
| searchFileInCommonPaths | Looks for the given file in all of the searching paths of the scene. |
| createGeometryLoaderObject | --TODO-- |
| createGeometryProceduralObject | --TODO-- |
| applySkyExtension | --TODO-- |
| applySceneModifierExtension | --TODO-- |
...
| Name | Description |
|---|---|
| getEngineVersion | Returns the current engine version. |
| getSdkVersion | Returns the current SDK version. |
| isDepthSupportedForThisFormat | Returns true if for the given extension the depth is valid. |
| getHighestDepthSupportedForThisFormat | Returns the highest bits per plane supported for the given format. |
| isEmbeddingAlphaSupportedForThisFormat | Returns true if for the given format it is possible embedding the alpha channel. |
| isEmbeddingAllChannelsSupportedForThisFormat | Returns true if for the given format it is possible embedding all channels in a multilayer file. |
| isTextureExtensionSupported | Returns true if the extension of the given texture path is supported by the render engine. |
| getSquareSwatchIES | Used to get the IES/EULUM emission pattern plotted into a square rgb buffer of size "resolution". The caller is responsible of freeing the buffer "buf" after using it. |
| getSolidLobeIES | Used to get the IES/EULUM emission pattern plotted as a 3d object. The caller is responsible of freeing the buffers "faces, points" after using them. |
Virtual Methods
| Name | Description |
|---|---|
| printMessage | Prints a message in the render console or in the message handler installed. |
...
| Type | Name | In/out | Description |
|---|---|---|---|
| const char* | pName | in | Cluster name |
Return value
Returns a Cmaxwell::Ccluster object, that is a reference to the cluster added to the scene.
...
| Value | C++ | Python |
|---|---|---|
| 0 | Cmaxwell::ALL_CLEAN | Cmaxwell.ALL_CLEAN |
| 1 | Cmaxwell::CAMERA_DIRTY | Cmaxwell.CAMERA_DIRTY |
| 2 | Cmaxwell::MATERIALS_ASSIGNMENTS_DIRTY | Cmaxwel.MATERIALS_ASSIGNMENTS_DIRTY |
| 8 | Cmaxwell::GEOMETRY_DIRTY | Cmaxwell.GEOMETRY_DIRTY |
| 16 | Cmaxwell::VOXELIZATION_DIRTY | Cmaxwell.VOXELIZATION_DIRTY |
| 32 | Cmaxwell::SKY_OR_HDR_DIRTY | Cmaxwell.SKY_OR_HDR_DIRTY |
| 64 | Cmaxwell::DEFAULT_OR_OVERRIDE_MATERIAL_DIRTY | Cmaxwell.DEFAULT_OR_OVERRIDE_MATERIAL_DIRTY |
| 0x3F | Cmaxwell::ALL_DIRTY | Cmaxwell.ALL_DIRTY |
...