VolumeMeshRenderPropertiesOperations
Provides an interface for managing render properties of 3D volume mesh objects. This class enables control over visual representation, material properties, lighting, and display widgets for volume mesh objects in the 3D scene.
Import
import ScriptingApi as api
# Access via Application
app = api.Application()
ops = app.get_volume_mesh_render_properties_operations()
Methods
Properties
set_representation
Sets the volume mesh visualization representation mode. Controls how the volume mesh geometry is displayed (points, wireframe, solid, or solid with edges).
Signature:
set_representation(volumeMeshNames: list, representation: VolumeMeshRepresentation) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
representation | any | Visualization mode. Use api.VolumeMeshRepresentation.Points, api.VolumeMeshRepresentation.Wireframe, api.VolumeMeshRepresentation.Solid, or api.VolumeMeshRepresentation.SolidEdges. |
set_interpolation
Sets the volume mesh shading interpolation method. Controls the shading algorithm used for rendering the volume mesh.
Signature:
set_interpolation(volumeMeshNames: list, interpolation: VolumeMeshInterpolation) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
interpolation | any | Shading method. Use api.VolumeMeshInterpolation.Flat, api.VolumeMeshInterpolation.Gouraud, api.VolumeMeshInterpolation.Phong, or api.VolumeMeshInterpolation.PBR (Physically Based Rendering). |
set_line_width
Sets the line width for wireframe and edges visualization.
Signature:
set_line_width(volumeMeshNames: list, width: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
width | any | Line width value in pixels (typically 1.0 to 10.0). |
set_point_size
Sets the point size for point cloud visualization.
Signature:
set_point_size(volumeMeshNames: list, size: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
size | any | Point size value in pixels (typically 1.0 to 16.0). |
set_scalar_visibility
Enables or disables scalar color visualization. When enabled, displays colors based on scalar data stored in the mesh points. When disabled, uses the material color instead.
Signature:
set_scalar_visibility(volumeMeshNames: list, visible: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
visible | any | True to enable scalar colors, false to use material color. |
set_color
Sets the material base color for the volume meshes.
Signature:
set_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGB color [r, g, b] components in range [0.0, 1.0]. |
set_colors
Sets different material colors for multiple volume meshes.
Signature:
set_colors(volumeMeshNames: list, colors: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
colors | any | List of RGB colors [r, g, b] (must match the length of volumeMeshNames). Each color has RGB components in range [0.0, 1.0]. |
set_random_color
Assigns random colors to the specified volume meshes.
Signature:
set_random_color(volumeMeshNames: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
set_opacity
Sets the opacity (transparency) of the volume meshes.
Signature:
set_opacity(volumeMeshNames: list, opacity: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
opacity | any | Opacity value in range [0.0, 1.0], where 0.0 is fully transparent and 1.0 is fully opaque. |
set_ambient_color
Sets the ambient lighting color. Ambient light represents constant illumination from all directions.
Signature:
set_ambient_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGB color [r, g, b] components in range [0.0, 1.0]. |
set_diffuse_color
Sets the diffuse lighting color. Diffuse light represents matte surface reflection based on angle to light source.
Signature:
set_diffuse_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGB color [r, g, b] components in range [0.0, 1.0]. |
set_specular_color
Sets the specular (highlight) color. Specular light represents shiny surface reflections and highlights.
Signature:
set_specular_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGB color [r, g, b] components in range [0.0, 1.0]. |
set_ambient_coefficient
Sets the ambient lighting coefficient.
Signature:
set_ambient_coefficient(volumeMeshNames: list, coefficient: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
coefficient | any | Ambient intensity in range [0.0, 1.0]. |
set_diffuse_coefficient
Sets the diffuse lighting coefficient.
Signature:
set_diffuse_coefficient(volumeMeshNames: list, coefficient: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
coefficient | any | Diffuse intensity in range [0.0, 1.0]. |
set_specular_coefficient
Sets the specular lighting coefficient.
Signature:
set_specular_coefficient(volumeMeshNames: list, coefficient: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
coefficient | any | Specular intensity in range [0.0, 1.0]. |
set_specular_power
Sets the specular power (shininess). Higher values create tighter, more focused highlights.
Signature:
set_specular_power(volumeMeshNames: list, power: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
power | any | Specular power in range [0.0, 128.0]. |
set_metallic_coefficient
Sets the metallic coefficient for PBR rendering. Controls how metallic the surface appears. Only used with PBR interpolation.
Signature:
set_metallic_coefficient(volumeMeshNames: list, coefficient: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
coefficient | any | Metallic value in range [0.0, 1.0], where 0.0 is non-metallic and 1.0 is fully metallic. |
set_roughness_coefficient
Sets the roughness coefficient for PBR rendering. Controls surface roughness. Only used with PBR interpolation.
Signature:
set_roughness_coefficient(volumeMeshNames: list, coefficient: float) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
coefficient | any | Roughness value in range [0.0, 1.0], where 0.0 is glossy and 1.0 is rough. |
set_lighting_enabled
Enables or disables lighting calculations for the volume meshes. When disabled, volume meshes display flat colors without shading.
Signature:
set_lighting_enabled(volumeMeshNames: list, enable: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
enable | any | True to enable lighting, false to disable. |
set_bounding_box_visible
Shows or hides the outline bounding box. Displays a wireframe box representing the object's extent.
Signature:
set_bounding_box_visible(volumeMeshNames: list, visible: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
visible | any | True to show bounding box, false to hide. |
set_corner_bounding_box_visible
Shows or hides the corner bounding box markers. Displays small markers at the corners of the bounding box.
Signature:
set_corner_bounding_box_visible(volumeMeshNames: list, visible: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
visible | any | True to show corner markers, false to hide. |
set_axis_labels_visible
Shows or hides the axis labels on the bounding box. Displays coordinate labels (e.g., "X", "Y", "Z") on bounding box edges.
Signature:
set_axis_labels_visible(volumeMeshNames: list, visible: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
visible | any | True to show labels, false to hide. |
set_bounding_box_color
Sets the color of the outline bounding box.
Signature:
set_bounding_box_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGBA color [r, g, b, a] components in range [0.0, 1.0]. |
set_corner_bounding_box_color
Sets the color of the corner bounding box markers.
Signature:
set_corner_bounding_box_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGBA color [r, g, b, a] components in range [0.0, 1.0]. |
set_axis_labels_color
Sets the color of the axis labels.
Signature:
set_axis_labels_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGBA color [r, g, b, a] components in range [0.0, 1.0]. |
get_opacity
Retrieves the opacity (transparency) value for the specified volume mesh.
Signature:
get_opacity(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Opacity value in range [0.0, 1.0] where 0.0 is fully transparent and 1.0 is opaque.
get_color
Retrieves the RGB color for the specified volume mesh.
Signature:
get_color(volumeMeshName: str) -> list
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: list — Array of RGB color [r, g, b] components in range [0.0, 1.0].
get_representation
Retrieves the volume mesh representation mode.
Signature:
get_representation(volumeMeshName: str) -> VolumeMeshRepresentation
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: VolumeMeshRepresentation — VolumeMeshRepresentation enum value (Points, Wireframe, Solid, or SolidEdges).
get_interpolation
Retrieves the volume mesh interpolation mode.
Signature:
get_interpolation(volumeMeshName: str) -> VolumeMeshInterpolation
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: VolumeMeshInterpolation — VolumeMeshInterpolation enum value (Flat, Gouraud, Phong, or PBR).
get_line_width
Retrieves the line width for the specified volume mesh.
Signature:
get_line_width(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Line width value in pixels.
get_point_size
Retrieves the point size for the specified volume mesh.
Signature:
get_point_size(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Point size value in pixels.
get_scalar_visibility
Gets the scalar visibility flag for the specified volume mesh.
Signature:
get_scalar_visibility(volumeMeshName: str) -> bool
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: bool — True if scalar visibility is enabled, false otherwise.
get_ambient_color
Retrieves the ambient color for the specified volume mesh.
Signature:
get_ambient_color(volumeMeshName: str) -> list
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: list — Array of RGB color [r, g, b] components in range [0.0, 1.0].
get_diffuse_color
Retrieves the diffuse color for the specified volume mesh.
Signature:
get_diffuse_color(volumeMeshName: str) -> list
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: list — Array of RGB color [r, g, b] components in range [0.0, 1.0].
get_specular_color
Retrieves the specular color for the specified volume mesh.
Signature:
get_specular_color(volumeMeshName: str) -> list
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: list — Array of RGB color [r, g, b] components in range [0.0, 1.0].
get_ambient_coefficient
Retrieves the ambient coefficient for the specified volume mesh.
Signature:
get_ambient_coefficient(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Ambient intensity value in range [0.0, 1.0].
get_diffuse_coefficient
Retrieves the diffuse coefficient for the specified volume mesh.
Signature:
get_diffuse_coefficient(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Diffuse intensity value in range [0.0, 1.0].
get_specular_coefficient
Retrieves the specular coefficient for the specified volume mesh.
Signature:
get_specular_coefficient(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Specular intensity value in range [0.0, 1.0].
get_specular_power
Retrieves the specular power for the specified volume mesh.
Signature:
get_specular_power(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Specular power value in range [0.0, 128.0].
get_metallic_coefficient
Retrieves the metallic coefficient for PBR rendering for the specified volume mesh.
Signature:
get_metallic_coefficient(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Metallic value in range [0.0, 1.0], where 0.0 is non-metallic and 1.0 is fully metallic.
get_roughness_coefficient
Retrieves the roughness coefficient for PBR rendering for the specified volume mesh.
Signature:
get_roughness_coefficient(volumeMeshName: str) -> float
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshName | any | Name of the volume mesh object. Must exist in the current scene. |
Returns: float — Roughness value in range [0.0, 1.0], where 0.0 is glossy and 1.0 is rough.
Modification
set_clipping_enabled
Enables or disables 3D clipping plane interactions. When enabled, volume meshes can be clipped by active clipping planes.
Signature:
set_clipping_enabled(volumeMeshNames: list, enable: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
enable | any | True to enable clipping, false to disable. |
set_scale_axes_visible
Shows or hides the scale axes widget. Displays a 3D coordinate system widget showing the object's orientation and scale.
Signature:
set_scale_axes_visible(volumeMeshNames: list, visible: bool) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
visible | any | True to show scale axes, false to hide. |
set_scale_axes_color
Sets the color of the scale axes widget.
Signature:
set_scale_axes_color(volumeMeshNames: list, color: list) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
volumeMeshNames | any | List of volume mesh object names to modify. |
color | any | RGBA color [r, g, b, a] components in range [0.0, 1.0]. |