Skip to content

GeometryVolumeFile

GeometryVolumeFile#

(File)

Go to User page.

Description#

Creates a volume.

Public Attributes#

Type Name Visual Hint Description
string filename VISUAL_HINT_FILENAME_OPEN File containing the OpenVdb data.
string density_property VISUAL_HINT_TAG Set the name of the property containing the density. This property is used for the raytracing.
bool density_scale_compensation VISUAL_HINT_DEFAULT Maintain the optical, rather than physical, density of the volume at all geometry scales.
double density_offset VISUAL_HINT_DEFAULT Value directly added to the density at evaluation.
double density_multiplier VISUAL_HINT_DEFAULT Set the density of the volume.
double density_cutoff VISUAL_HINT_DEFAULT Removes intersections with a density below this value in the 3D View.
string velocity_property VISUAL_HINT_TAG Set the name of the property containing the velocity. This property is used for the raytracing.
double velocity_multiplier VISUAL_HINT_DEFAULT Set the scale of the velocities.
long velocity_space VISUAL_HINT_DEFAULT Specify in which space the velocities are expressed.
long quality_mode VISUAL_HINT_DEFAULT Control the sampling according to the distance. In constant mode, the step between samples is the same. In distance based mode, the steps vary according to the distance.
long deformation_quality VISUAL_HINT_DEFAULT Control the quality of the evaluation for non linear deformations (motion blur).
double camera_quality VISUAL_HINT_PERCENTAGE Control the sampling for camera rays.
double reflection_quality VISUAL_HINT_PERCENTAGE Control the sampling for reflection rays.
double refraction_quality VISUAL_HINT_PERCENTAGE Control the sampling for refraction rays.
double shadow_quality VISUAL_HINT_PERCENTAGE Control the sampling for shadow rays.
double global_illumination_quality VISUAL_HINT_PERCENTAGE Control the sampling for global illumination rays.
double primary_rays_quality VISUAL_HINT_PERCENTAGE Control the influence of the distance on sampling steps for primary rays (coming from a camera).
double secondary_rays_quality VISUAL_HINT_PERCENTAGE Control the influence of the distance on sampling steps for secondary rays (reflection, refraction, shadows, global illumination, ...).
action detect_sequence VISUAL_HINT_DEFAULT
long sequence_mode VISUAL_HINT_DEFAULT Enable / disable the sequence mode.
long start_frame VISUAL_HINT_DEFAULT In custom frame range mode, set the start frame to use.
long end_frame VISUAL_HINT_DEFAULT In custom frame range mode, set the end frame to use.
long frame_offset VISUAL_HINT_DEFAULT Offsets the time. If the offset is set to 50 and the sequence starts at 10, then the first file will be used at frame 60.
double frame_rate VISUAL_HINT_FREQUENCY Set the frame rate of the sequence.
long missing_frame VISUAL_HINT_DEFAULT Behavior to apply in case a file is missing. Drop shows nothing, Hold uses the last read file.
long pre_behavior VISUAL_HINT_DEFAULT Behavior to apply before the beginning of the sequence. Drop shows nothing, Hold uses the first file, Repeat loops on the sequence.
long post_behavior VISUAL_HINT_DEFAULT Behavior to apply after the end of the sequence. Drop shows nothing, Hold uses the last file, Repeat loops on the sequence.
long grid_mode VISUAL_HINT_DEFAULT When the file contains grids terminating with .x, .y or .z, it is possible to leave them as it is or to merge them into a single grid.
long delayed_load VISUAL_HINT_DEFAULT Enable or disable the delayed load for the volume.
long file_size_mode VISUAL_HINT_DEFAULT Use a maximum file size when delayed load is limited. If the size is smaller than the temporary file then there will be no delayed load.
double file_max_size VISUAL_HINT_MEMSIZE Set the size use when file max size is enabled.

Inherited Public Attributes#

Type Name Visual Hint Description
double[3] translate VISUAL_HINT_DISTANCE Set the XYZ position of the item relative to its parent item.
double[3] rotate VISUAL_HINT_ANGLE Set the XYZ rotation of the item relative to its parent item.
double[3] scale VISUAL_HINT_SCALE Set the XYZ scaling of the item relative to its parent item.
double[3] shear VISUAL_HINT_SCALE Set the XYZ shear of the item relative to its parent item.
long rotation_order VISUAL_HINT_DEFAULT Specify on which order the Euler rotations are composed. By default Clarisse's uses YXZ
reference (SceneItem) parent VISUAL_HINT_DEFAULT Set the parent item of the item.
bool inherit_transform VISUAL_HINT_DEFAULT Does the current object inherits its parent transformation ?
long reference_frame VISUAL_HINT_FRAME Set the reference frame that defines the base transform and deformation state of the item. This reference is used when computing texture projections or when generating point cloud (in Global Base) on the base geometry.
object[] (Constraint) constraints VISUAL_HINT_DEFAULT Stack of constraint operators. Constraints like Target, Point, Orient... are applied to a Scene Item in order to drive the transformation of the item.
double[3] scale_pivot VISUAL_HINT_DISTANCE Set the coordinates of the scale pivot.
double[3] rotate_pivot VISUAL_HINT_DISTANCE Set the coordinates of the rotation pivot.
double[3] translate_offset VISUAL_HINT_DISTANCE Set the XYZ position of the pivot point of the item.
double[3] rotate_offset VISUAL_HINT_ANGLE Set the XYZ rotation of the pivot point of the item.
double[3] scale_offset VISUAL_HINT_SCALE Set the XYZ scaling of the pivot point of the item.
long rotation_offset_order VISUAL_HINT_DEFAULT Set the rotation axis mode.
bool display_visible VISUAL_HINT_DEFAULT Set whether the item is shown in the 3D View or not.
bool display_pickable VISUAL_HINT_DEFAULT Set whether the item is pickable in the 3D View or in the Image View.
long display_color VISUAL_HINT_DEFAULT Set the item color for constant or simple shading display in the 3D View.
double[3] display_custom_color VISUAL_HINT_COLOR Set the item custom color used for display in the 3D View when the Display Color attribute is set to Custom.
bool enable_motion_blur VISUAL_HINT_DEFAULT Set whether the renderer will do motion blur on the item or not.
long display_mode VISUAL_HINT_DEFAULT Define how the object is displayed in the 3D View.
long highlight_mode VISUAL_HINT_DEFAULT Define how the object is highlighted in the 3D View when selected.
reference (Material) override_material VISUAL_HINT_DEFAULT Setting a material here will set the specified material to all elements of the scene object. Ex: all shading groups of a geometry will have the same material. Ex: all elements of a combiner or a scatterer will have the same material.
bool matte_object VISUAL_HINT_DEFAULT Switch the object to 2D matte mode.
double[3] matte_color VISUAL_HINT_COLOR Set the color of the object in matte mode.
double matte_alpha VISUAL_HINT_PERCENTAGE Set the opacity of the object in matte mode. When the matte alpha is less than 100%, the object creates a hole in the layer as no transparency is evaluated.
long custom_id VISUAL_HINT_DEFAULT
double raytrace_offset VISUAL_HINT_DISTANCE Set the minimum distance for raytracing visibility. If the ray hit point distance from the ray source position is smaller than this value, then the geometry is not seen. Note: this attribute is used to prevent self intersection artifacts.
string shading_variables VISUAL_HINT_SCRIPT
bool unseen_by_renderer VISUAL_HINT_DEFAULT Set whether the object is hidden from the renderer or not.
bool unseen_by_camera VISUAL_HINT_DEFAULT Set whether the object is hidden from the camera (primary rays) or not.
bool unseen_by_rays VISUAL_HINT_DEFAULT Set whether the object is hidden from the raytraced shading effects like reflection/refraction (secondary rays) or not.
bool unseen_by_reflections VISUAL_HINT_DEFAULT Set whether the object is hidden from reflections or not.
bool unseen_by_refractions VISUAL_HINT_DEFAULT Set whether the object is hidden from refractions or not.
bool unseen_by_gi VISUAL_HINT_DEFAULT Set whether the object is hidden from global illumination or not.
bool unseen_by_sss VISUAL_HINT_DEFAULT Set whether the object is hidden from sub-surface scattering or not.
bool cast_shadows VISUAL_HINT_DEFAULT Set whether the object casts shadows or not.
bool receive_shadows VISUAL_HINT_DEFAULT Set whether the object receives cast shadows or not.
bool receive_self_shadows VISUAL_HINT_DEFAULT Set whether the object receives self shadows or not.
reference (Group) lights VISUAL_HINT_GROUP Specify the group of lights that illuminate this object. By default, scene objects are lit using the lights gathered by the 3D layer.

CID#

class "GeometryVolumeFile" "GeometryVolume" {
    #version 0.91
    icon "../icons/object_icons/geometry_volume_file.iconrc"
    doc "Creates a volume."
    attribute_group "volume" {
        filename_open "filename" {
            doc "File containing the OpenVdb data."
            extension "vdb"
            value ""
        }
        tag "density_property" {
            doc "Set the name of the property containing the density. This property is used for the raytracing."
            value "density"
        }
        bool "density_scale_compensation" {
            doc "Maintain the optical, rather than physical, density of the volume at all geometry scales."
            value yes
        }
        double "density_offset" {
            doc "Value directly added to the density at evaluation."
            animatable yes
            ui_range yes -10 10
            value 0.0
        }
        double "density_multiplier" {
            doc "Set the density of the volume."
            texturable yes
            animatable yes
            numeric_range yes 0.0 1000000
            ui_range yes 0.0 10
            value 1
        }
        double "density_cutoff" {
            doc "Removes intersections with a density below this value in the 3D View."
            output "gl"
            animatable yes
            numeric_range yes 0.0 1000000
            ui_range yes 0.0 2
            value 0.0
        }
    }
    attribute_group "volume>velocity" {
        collapsed yes
        tag "velocity_property" {
            doc "Set the name of the property containing the velocity. This property is used for the raytracing."
            value ""
        }
        double "velocity_multiplier" {
            doc "Set the scale of the velocities."
            animatable yes
            numeric_range yes 0.0 1000000
            ui_range yes 0.0 10
            value 1
        }
        long "velocity_space" {
            doc "Specify in which space the velocities are expressed."
            preset "Grid Space" "0"
            preset "World Space" "1"
            value 1
        }
    }
    attribute_group "volume>sampling" {
        collapsed yes
        long "quality_mode" {
            doc "Control the sampling according to the distance. In constant mode, the step between samples is the same. In distance based mode, the steps vary according to the distance."
            preset "Constant" "0"
            preset "Distance based" "1"
            value 1
        }
        long "deformation_quality" {
            doc "Control the quality of the evaluation for non linear deformations (motion blur)."
            preset "Lowest" "6"
            preset "Very Low" "5"
            preset "Low" "4"
            preset "Medium" "3"
            preset "High" "2"
            preset "Very High" "1"
            preset "Highest" "0"
            value 3
        }
        percentage "camera_quality" {
            doc "Control the sampling for camera rays."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 0.5
        }
        percentage "reflection_quality" {
            doc "Control the sampling for reflection rays."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 0.5
        }
        percentage "refraction_quality" {
            doc "Control the sampling for refraction rays."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 0.5
        }
        percentage "shadow_quality" {
            doc "Control the sampling for shadow rays."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 0.5
        }
        percentage "global_illumination_quality" {
            doc "Control the sampling for global illumination rays."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 0.5
        }
        percentage "primary_rays_quality" {
            doc "Control the influence of the distance on sampling steps for primary rays (coming from a camera)."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 1
        }
        percentage "secondary_rays_quality" {
            doc "Control the influence of the distance on sampling steps for secondary rays (reflection, refraction, shadows, global illumination, ...)."
            numeric_range yes 0.0 1000
            ui_range yes 0.0 1
            value 1
        }
    }
    attribute_group "volume>file_sequence" {
        collapsed yes
        action "detect_sequence" {
            value <empty>
        }
        filename_open "filename_sys" {
            private yes
            saveable no
            value ""
        }
        long "sequence_mode" {
            doc "Enable / disable the sequence mode."
            preset "Still" "0"
            preset "Sequence" "1"
            value 0
        }
        long "start_frame" {
            doc "In custom frame range mode, set the start frame to use."
            read_only yes
            value 0
        }
        long "end_frame" {
            doc "In custom frame range mode, set the end frame to use."
            read_only yes
            value 1
        }
        long "frame_offset" {
            doc "Offsets the time. If the offset is set to 50 and the sequence starts at 10, then the first file will be used at frame 60."
            ui_range yes -1000 1000
            read_only yes
            value 0
        }
        frequency "frame_rate" {
            doc "Set the frame rate of the sequence."
            numeric_range yes 0.1 200
            ui_range yes 0.1 60
            read_only yes
            value 30
        }
        long "missing_frame" {
            doc "Behavior to apply in case a file is missing. Drop shows nothing, Hold uses the last read file."
            read_only yes
            preset "Drop" "0"
            preset "Hold" "1"
            value 1
        }
        long "pre_behavior" {
            doc "Behavior to apply before the beginning of the sequence. Drop shows nothing, Hold uses the first file, Repeat loops on the sequence."
            read_only yes
            preset "Drop" "0"
            preset "Hold" "1"
            preset "Loop" "2"
            value 0
        }
        long "post_behavior" {
            doc "Behavior to apply after the end of the sequence. Drop shows nothing, Hold uses the last file, Repeat loops on the sequence."
            read_only yes
            preset "Drop" "0"
            preset "Hold" "1"
            preset "Loop" "2"
            value 0
        }
    }
    attribute_group "volume>openVDB_settings" {
        collapsed yes
        long "grid_mode" {
            doc "When the file contains grids terminating with .x, .y or .z, it is possible to leave them as it is or to merge them into a single grid."
            preset "Leave XYZ Components Apart" "0"
            preset "Merge XYZ Components" "1"
            value 0
        }
        long "delayed_load" {
            doc "Enable or disable the delayed load for the volume."
            preset "Use Preferences" "0"
            preset "Enabled" "1"
            preset "Disabled" "2"
            value 0
        }
        long "file_size_mode" {
            doc "Use a maximum file size when delayed load is limited. If the size is smaller than the temporary file then there will be no delayed load."
            preset "Use Preferences" "0"
            preset "Unlimited" "1"
            preset "Limited" "2"
            value 0
        }
        memsize "file_max_size" {
            doc "Set the size use when file max size is enabled."
            numeric_range yes 0.0 1000000
            read_only yes
            value 0.0
        }
        bool "gb_delayed_load" {
            hidden yes
            value yes
        }
        bool "gb_use_file_size_max" {
            hidden yes
            value yes
        }
        double "gb_file_max_size" {
            hidden yes
            value 0.0
        }
    }
}