AlRenderInfo

A structure used to transfer render information.

Synopsis

#include <AlRenderInfo.h>

Description

An AlRenderInfo structure is used to store render information for an object. Before setting the AlRenderInfo for an object, it is necessary to retrieve the current values from the object.

For example:

// No error checking is done here for brevity in the example.
AlRenderInfo	renderInfo;
newSurface->renderInfo( renderInfo );
renderInfo.castsShadow = FALSE;
newSurface->setRenderInfo( renderInfo );

See Render->globals in the Menu Book for a more detailed description of these fields.

doubleSided

Sets whether both sides of an object (inside and outside) or only the outside is to be rendered. For example, a closed object, such as a sphere doesn't have to be double sided; only one side of the object is going to be seen when it is rendered. The default is TRUE.

opposite

Determines which side of a surface will be used for the render; the side that the normals point out of, or the opposite side. The default is FALSE, meaning the side the normals point out of will be used.

castsShadow

Indicates whether or not the object will cast shadows in the RayCaster and RayTracer. The default is TRUE.

adaptive

Indicates whether adaptive or uniform subdivisions will be used. The default is TRUE, meaning adaptive subdivisions.

adaptive_min

Indicates the minimum level of adaptive subdivision on the object. The level must be a power of 2 between 0 and 7; any other values will cause the next higher power of 2 to be used. The default it 2.

adaptive_max

Indicates the maximum level of adaptive subdivision on the object. The level must be a power of 2 between 0 and 7; any other values will cause the next higher power of 2 to be used. The default it 4.

curvature_threshold

Controls the threshold for subdivision of the surface. Values must be between 0 and 1, with 0.96 being the default.

uniform_u

When "adaptive" is FALSE, this indicates the number of subdivisions in the U direction. Values must be between 1 and 256, with 4 being the default.

uniform_v

When "adaptive" is FALSE, this indicates the number of subdivisions in the V direction. Values must be between 1 and 256, with 4 being the default.

smooth_shading

Indicates whether smooth or flat shading should be used. The default is TRUE, meaning that smooth shading will be used.

motion_blur

Indicates whether the object should be motion blurred. The default is TRUE.

reflection_only

Indicates the object is a reflection only object.

motion_blur_texture_sample_level

motion_blur_shading_samples

Parameters for motion blur.