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 | Computes the reflectance as a function of the angle of incidence. |
| computeAbbeGraph | Computes the reflectance as a function of the spectral input. |
| 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 | |
| createGeometryProceduralObject | |
| applySkyExtension | |
| applySceneModifierExtension | |
...
| 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.
...
So it's highly reccommended to assign unique names in each instancement creation when we create a lot of them. A good example of creating instancements is provided here.
| Language | Syntax |
|---|---|
| C++ | Cmaxwell::Cobject createInstancement( const char* pName, Cmaxwell::Cobject& object ) |
| Python | CmaxwellObject createInstancement( str pName, CmaxwellObject object ) |
...
| Type | Name | In/Out | Description |
|---|---|---|---|
| dword | type | in | Color space selected. See COLOR_SPACES enum. |
Return value
0 = Error setting color space.
...
| Type | Name | In/Out | Description |
|---|---|---|---|
| dword | type | out | (C++) Color space used. See COLOR_SPACES enum. |
Return value
Python
Color space used. See COLOR_SPACES enum.
| Anchor | ||||
|---|---|---|---|---|
|
...