Creates a transparent volume from a volumetric density field. This process is GL accelerated by using graphics hardware.
Internally, jit.gl.volume creates a 3d jit.gl.texture object and applies it to multiple view-aligned slices of geometry. The resulting slices are then blended together using the standard ob3d blend modes. The density and intensity attributes subsequently control which features are visibile. By enabling the cubes attribute, slices will be rendered in both horizontal and vertical direction, which may result in a visualization which that is comparatively better or worse depending on the volume dataset being used.
The jit.gl.volume object requires one argument: the name of a drawing context. A named drawing context is a named instance of a jit.window, jit.pwindow, or jit.matrix object that has an instance of the jit.gl.render object associated with it. Additionally it can reference the name of a jit.gl.node sub-context. This value may also be set via the OB3D drawto attribute. If no argument is present, the object is implicitly added to the first valid drawing context or sub-context found in the current patch or by searching up the patcher hierarchy.
Flag which enables or disables the rendering of the bounding box surrounding the volume (default = 0).
Flag for enabling a controllable clip plane to slice the volume along an arbitrary axis (default = 0)
Rotation angles per axis for the clip plane (default = 0 0 0)
clipaxis [3 floats]
Axis coefficients for the clip plane (default = 1 0 0)
Flag which enables or disables cube subdivision (default = 1).
The density threshold for constructing the surface. (default = 0.5)
Cache in displaylist flag (default = 0) This feature may be used to speed up rendering time by creating and storing a list of gl drawing commands on the graphics card. This will have no effect if matrixoutput turned on.
The distance offset from the camera. (default = -5)
Step size in raycast mode
Exposure in raycast mode
The intensity scale factor for multiplying against volume density values. (default = 0.5)
Raycast mode adapts resolution to rendering destination
raycast_dim [2 ints]
Resolution of raycast mode
Number of samples in raycast mode
Sets he number of slices used as proxies for rendering the volume data.