Class

Shape

 

synopsis

Volume shape to load OpenVDB volume data.

 


 

visibility

You can selectively disable an object's visibility for the various types of rays in the renderer. By default, objects are visible to all types of rays. Camera - Camera (AA) rays (i.e., primary or view rays). Shadow - shadow rays fired in the direct lighting calculations. Specular - specular_reflection rays. Transmission - transmission rays. Diffuse - indirect_diffuse rays (i.e. global illumination or GI rays). Specular - indirect_specular rays (i.e. specular reflection rays).

To set the visibility, add up the values of the rays you want to "see" the object.

For example, if an object is visible to the camera (primary visibility), and to transmission (both diffuse and specular), then that’s visibility 13 (1 + 4 + 8).


Ray typeDecimal Value
Camera (Primary Visibility)1
Shadow (Casts Shadows)2
Diffuse transmission4
Specular transmission8
Volume16
Diffuse reflection32
Specular reflection64
SSS (subsurface)128

sidedness

Just like you can disable the visibility for specific ray types, you can also change an object's sidedness depending on the ray type. By default, objects are double-sided for all rays. By unclicking any of these checkboxes, the object will become single-sided, which means that those parts of the object whose normal vector points away from the incoming ray direction will not be rendered.

receive_shadows

Determines whether or not the object picks up shadows from other objects.

self_shadows

Determines whether or not the object casts shadows on itself.


invert_normals

Invert normals (so that normals face inwards and not outwards).

ray_bias

Raytrace bias value specified for the object.

matrix

Transformation matrix. This can be either a single matrix or an array of matrices that define the SRT motion of the object for the current frame (the matrices define the motion for the full-frame, not just between the shutter open - close time).

shader

An array of nodes pointing to the shader or shaders in the case of per-face shader assignment.

opaque

As of Arnold 5.3, this flag is set automatically by changing the opacity or transmission on a material.

Determines whether the object is considered opaque (transparent). By default, Arnold built-in shaders set the opaque flag automatically, based on whether or not the shader settings would require disabling the opaque flag on the object to render correctly. For example, it's no longer necessary to manually disable the opaque flag to get transparent shadows for a glass shader.


Exceptions are curves and points when min_pixel_width is in use, and OSL shaders.  



matte

The matte option enables you to create holdout effects by rendering the alpha as zero.

use_light_group

A boolean to enable selective light linking

light_group

An array of nodes pointing to the lights that will affect the node if use_light_group is enabled.

use_shadow_group

A boolean to enable selective shadow linking.

shadow_group

An array of nodes pointing to the lights that will not cast shadows on the polymesh, if use_shadow_group is enabled.

trace_sets

An array of strings each of which names a trace set. A custom shader must be used to make effective use of these strings via the AiShaderGlobalsSetTraceSet and the AiShaderGlobalsUnsetTraceSet API calls.

It is possible to tag objects to be part of one or many trace sets. The trace_set shader tags specific rays with an inclusive or exclusive trace set. Both geometry and rays can be tagged with trace sets:

  • A piece of geometry can have none or any number of trace set tags.
  • A ray can optionally have one trace set tag, and it can be exclusive or inclusive.


The way those two tags interact makes it possible to control visibility for specific rays:

  • A ray with no trace set will hit all geometry.
  • A ray tagged with an inclusive trace set will only hit geometry which has that trace set tag.
  • A ray tagged with an exclusive trace set will only see geometry that does NOT have that trace set tag.

motion_start

The time at which the first motion key of the shape is sampled. Other motion keys must be uniformly spaced within this range. Times can be absolute or relative as long as shutter and motion times use the same convention. By convention, the times are frame relative. For example, start and end times -0.5 to 0.5 indicate that two motion keys will be sampled midway between the previous and current frame, and the current frame and next frame. This is applied to cameras, lights, and shapes.

motion_end

The time at which the last motion key of the shape is sampled. Other motion keys must be uniformly spaced within this range. Times can be absolute or relative as long as shutter and motion times use the same convention. By convention, the times are frame relative. For example, start and end times -0.5 to 0.5 indicate that two motion keys will be sampled midway between the previous and current frame, and the current frame and next frame. This is applied to cameras, lights, and shapes.

id

Unique ID for a node in the Arnold scene. 

volume_padding

Enlarge the volume by Padding. This is useful when displacing a volume with a noise for example. Note that this slack applies not only to the bounding box but also to the voxels used for ray extents inside the bounding box. When velocity motion blur is enabled, some extra padding is computed, based on the maximum value of the velocity field, and the maximum of the velocity padding and user padding is applied. When padding exceeds the bounding box maximum dimension, the ray extents acceleration makes little sense and is disabled, so you should set the padding as tightly as possible.

 

For best performance, this should be set as low as possible, while still covering the maximum displacement amount.

The amount of padding to add to the volume bounds for displacement

step_size

Sets the size for sampling inside the volume. It should be small enough to capture the smallest feature in the volume (aka the Nyquist limit). If the size is too large, aliasing, bias or banding will appear. Smaller (and therefore more accurate) sizes will increase render times while larger sizes will render more quickly. 

filename

The location of the VDB file.

filedata

A byte array that may be used to pass the contents of a VDB file directly. This may be useful for interactive rendering, to pass the application data directly to Arnold without going through the disk.

step_scale

A scaling factor applied to the step size, mostly useful when the Volume Step is set to Automatic, to modulate the automatic value. For low frequency, smoke-like volumes, a value of 4 is a reasonable starting point.

compress

Compress grids to reduce memory usage, enabled by default. This is a lossy compression, however, in most cases renders will be almost the same. If there is a problem, however, this parameter can be used to disable lossy compression.

grids

A list of OpenVDB grids to read and make available as channels in the volume shading context. Examples of Grid names are density, fuel, heat, temperature or velocity.

velocity_grids

Either 1 vector grid (eg. v or vel) or 3 float grids (eg. vel.xvel.yvel.z) representing the velocity field, to be used for motion blur. No motion blur will occur if an invalid combination of grids or if no grids are specified. Note that all velocity grids declared here are also available as channels in the shading context.

velocity_scale

A scale factor for the velocity field. A value of 0 disables motion blur.

velocity_fps

Sets the frames per second velocity value.

velocity_outlier_threshold

Controls filtering of noisy velocities resulting in the faster rendering of motion blur from physics simulations. The default value of 0.001 should have little to no visual impact. Setting it to zero disables filtering entirely. 
transform_type

Specifies what type of motion the object has. Options are linearrotate_about_center, and rotate_about_originlinear corresponds to the linear interpolation between matrices. rotate_about_origin corresponds to curved_motionblur=true. Unlike, rotate_about_origin which sets the rotation pivot at the origin, rotate_about_center will rotate about the object's center. This is the default mode and is useful for wheels, propellers, and other objects which spin.

 

ginstance step size

ginstance nodes can override the step_size parameter of volume containers such as points, poly meshes, cubes and spheres. This allows, for example, an instance of a volume shape to be shaded as a surface (by setting the instance step size to zero, opaque off, and using a surface shader.

Volume and surface 

Surface only

  • No labels
© 2020-2021 Autodesk. All Rights Reserved / website terms / privacy/cookies / ccpa settings