AlRender
 
 
 

Interface to Alias render options.

Synopsis

#include <AlRender.h> class AlResolutionItem : public AlLinkItem
AlResolutionItem*	nextItem() AlResolutionItem*	prevItem() char*	name; int	x, y; double	aspect;
class AlRender
//	general settings static Source	render(); static statusCode	setRender( Source ); static boolean	animation(); static statusCode	setAnimation( boolean ); static AnimationRange	animationRange(); static statusCode	setAnimationRange( AnimationRange ); static statusCode	animationRange(double&start, double&end, double&by ); static statusCode	setAnimationRange(double start, double end, double by); static Scope	hiddenLineParms(); static statusCode	setHiddenLineParams( Scope ); static Scope	qualityScope( Quality ); static statusCode	setQualityScope( Quality, Scope ); static Quality	qualityType( Quality ); static statusCode	setQualityType( Quality, Scope ); //	Global Quality Parameters: Subdivision & AntiAlias for low,med,high
class Subdivision { static Type	type( Quality ); static statusCode	setType( Quality, Type ); static int	uniformU( Quality ); static statusCode	setUniformU( Quality, int );			    // 1..256 static int	uniformV( Quality ); static statusCode	setUniformV( Quality, int );			    // 1..256 static int	adaptiveMin( Quality ); static statusCode	setAdaptiveMin( Quality, int );		    // 1..128 static int	adaptiveMax( Quality ); static statusCode	setAdaptiveMax( Quality, int );		    // 1..128 static double	adaptiveThreshold( Quality ); static statusCode	setAdaptiveThreshold( Quality, double ); // 0..1 };
 class AntiAlias
 {
static int	min( Quality ); static statusCode	setMin( Quality, int ); // 0..6 static int	max( Quality ); static statusCode	setMax( Quality, int );			    // 0..6 static double	threshold( Quality ); static statusCode	setThreshold( Quality, double );		 };
 class Limits
 { static boolean	createPreview( Quality ); static statusCode	setCreatePreview( Quality, boolean ); static int	maxReflections( Quality ); static statusCode	setMaxReflections(  Quality,int );	    // 0..10 static int	maxRefractions( Quality ); static statusCode	setMaxRefractions( Quality,int );	    // 0..10 static int	maxShadowLevels( Quality ); static statusCode	setMaxShadowLevels(  Quality,int );	    // 0..10 static int	subdivideRecurse( void ); static statusCode	setSubdivideRecurse( int );	    // 1..3 };
 class Composite
 { static boolean	enabled(); static statusCode	setEnabled( boolean ); static double	coverageThreshold(); static statusCode	setCoverageThreshold( double );	    // 0..1 };
 class Blur
 { static boolean	postFilter(); static statusCode	setPostFilter( boolean ); static int	postCenter(); static statusCode	setPostCenter( int );		    // 0..20 static int	postAdjacent(); static statusCode	setPostAdjacent( int );		    // 0..20 static int	postDiagonal(); static statusCode	setPostDiagonal( int );		    // 0..20 static boolean	motionBlur(); static statusCode	setMotionBlur( boolean ); static double	shutterAngle(); static statusCode	setShutterAngle( double );		    // 1..360 };
 class Misc
 { static GeometrySource	geometrySource(); static statusCode	setGeometrySource( GeometrySource ); static boolean	textures(); static statusCode	setTextures( boolean ); static boolean	skeletons(); static statusCode	setSkeletons( boolean ); static boolean	noTransparencyInDepth(); static statusCode	setNoTransparencyInDepth( boolean ); static double	transparency(); static statusCode	setTransparency( double );		    // 0..1 static boolean	keepNonglowedImage(); static statusCode	setKeepNonglowedImage( boolean ); static boolean	spotLightDepthMaps(); static statusCode	setSpotLightDepthMaps( boolean ); static boolean	depthMapsInMemory(); static statusCode	setDepthMapsInMemory( boolean ); static boolean	attenuateTransparency(); static statusCode	setAttenuateTransparency( boolean ); };
 class Image
 { static Format	format(); static statusCode	setFormat( Format ); static DepthFormat	depthFormat(); static statusCode	setDepthFormat( DepthFormat ); static Fields	fields(); static statusCode	setFields( Fields ); static boolean	oddFirst(); static statusCode	setOddFirst( boolean ); static boolean	ignoreFilmGate(); static statusCode	setIgnoreFilmGate( boolean ); static double	gammaCorrection(); static statusCode	source( const char *, boolean &, boolean &, boolean & ); static statusCode	setSource( const char *, boolean, boolean, boolean ); static statusCode	setGammaCorrection( double );	    // 0..2 static boolean	XYRatioLock(); static statusCode	setXYRatioLock( boolean ); static int	resolutionX(); static statusCode	setResolutionX( int );		    // 0..2048 static int	resolutionY(); static statusCode	setResolutionY( int );		    // 0..2048 static double	aspectRatio(); static statusCode	setAspectRatio( double );		    // 0..1 static statusCode	readResolutions( AlList* &list ); };
 class HiddenLine
 { static boolean	useFillColor(); static statusCode	setUseFillColor( boolean ); static statusCode	fillColor( double &, double &, double &); static statusCode	setFillColor( double, double, double );	    // 0..255 static statusCode	lineColor( double &, double &, double &); static statusCode	setLineColor( double, double, double );	    // 0..255 static int	patchLinesU(); static statusCode	setPatchLinesU( int );		    // 0..8 static int	patchLinesV(); static statusCode	setPatchLinesV( int );		    // 0..8 };
 class Particle
 { static boolean	show(); static statusCode	setShow( boolean ); static int	simulationSubsteps(); static statusCode	setSimulationSubsteps( int );	    // 1..8 static int	framesPerSecond(); static statusCode	setFramesPerSecond( int );		    // 1..30 };

Description

This class encapsulates all access to the Alias render options. Every value in the window can be retrieved and set. Please see the Menu Book for additional information on these parameters and their functions.

AlRender::Source AlRender::render()

Description

Returns the source that is currently being rendered.

statusCode AlRender::setRender( AlRender::Source source )

Description

Sets the source to kAll or kActive. Note: this setting is overridden by the store_active flag in the AlUniverse::writeSDL() method.

Arguments

< source - new value, kAll or kActive

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

boolean AlRender::animation()

Description

Returns TRUE if animation is currently being rendered.

statusCode AlRender::setAnimation( boolean on )

Description

Sets if animation should be rendered.

Return Codes

sSuccess - value was set

AlRender::AnimationRange AlRender::animationRange()

Description

Returns the animation type range that is being used.

statusCode AlRender::setAnimationRange( AlRender::AnimationRange range )

Description

Sets the type of animation range to kGlobalRange, kMinMax or kTimeSlider.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

statusCode AlRender::animationRange( double& start, double& end, double& by)

Description

Retrieves the animation range endpoints and step size. This is only valid for min/max and global.

Arguments

start - start of the range

end - end of the range

by - step size

Return Codes

sSuccess - operation succeeded

sFailure - operation failed

sInvalidObject - the current animationRange is not MinMax or Global

statusCode AlRender::setAnimationRange( double start, double end, double by)

Description

Sets the animation range. This is only valid for kGlobalRange.

Arguments

start - start of the range (must be >=0)

end - end of the range (must be >= start)

by - step size (must be >0 )

Return Codes

sSuccess - operation succeeded

sFailure - operation failed

sInvalidObject - the current animationRange is not Global

sInvalidArgument - by was negative, start was negative or end < start

AlRender::Scope AlRender::hiddenLineParms()

Description

Returns the current hidden line parameter setting.

statusCode AlRender::setHiddenLineParams( AlRender::Scope scope )

Description

Sets the hidden line parameter option in the rendering. Scope is either kPerObject or kGlobal.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

AlRender::Scope AlRender::qualityScope( AlRender::Quality )

Description

Returns the current rendering quality scope.

statusCode AlRender::setQualityScope( AlRender::Quality, AlRender::Scope scope )

Description

Sets the rendering quality scope. Scope is either kPerObject or kGlobal.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

AlRender::Quality AlRender::qualityType()

Description

Returns the rendering quality type.

statusCode AlRender::setQualityType( AlRender::Quality q )SDescription

Sets the rendering quality type. Quality is one of kLow, kMedium or kHigh.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

AlRender::Subdivision::Type AlRender::Subdivision::type( AlRender::Quality q )

Description

Returns the rendering subdivision type of the quality parameter.

statusCode AlRender::Subdivision::setType( AlRender::Quality q, AlRender::Subdivision::Type t )

Description

Sets the rendering subdivision type. The type is either kAdaptive or kUniform and is applied to the quality parameter selected.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

int AlRender::Subdivision::uniformU( AlRender::Quality q )

Description

Returns the uniform U value for quality parameter.

statusCode AlRender::Subdivision::setUniformU( AlRender::Quality q, int num )

Description

Sets the uniform U value for the quality parameter. The uniform U value is used to subdivide patches into triangles without taking the curvature into account.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..256

int AlRender::Subdivision::uniformV( AlRender::Quality q)

Description

Returns the uniform V value for the quality parameter.

statusCode AlRender::Subdivision::setUniformV( AlRender::Quality q, int num)

Description

Sets the uniform V value for the quality parameter. The uniform Vvalue is used to subdivide patches into triangles without taking the curvature into account.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..256

int AlRender::Subdivision::adaptiveMin( AlRender::Quality q)

Description

Returns the adaptive minimum for the quality parameter.

statusCode AlRender::Subdivision::setAdaptiveMin( AlRender::Quality q, int num)

Description

Sets the adaptive minimum of the subdivision for the quality parameter. This value determines the minimum number of subdivisions between CVs in both U and V.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..128

int AlRender::Subdivision::adaptiveMax( AlRender::Quality q)

Description

Returns the adaptive maximum of the quality parameter.

statusCode AlRender::Subdivision::setAdaptiveMax( AlRender::Quality q, int num)

Description

Sets the adaptive maximum of the subdivision for the quality parameter. This value determines the maximum number of subdivisions between CVs in both U and V.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..128

double AlRender::Subdivision::adaptiveThreshold( AlRender::Quality q)

Description

Returns the adaptive threshold of the quality parameter.

statusCode AlRender::Subdivision::setAdaptiveThreshold( AlRender::Quality q, double num )

Description

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..1

int AlRender::AntiAlias::min( AlRender::Quality q )

Description

Returns the anti-alias minimum for the quality parameter.

statusCode AlRender::AntiAlias::setMin( AlRender::Quality q, int num)

Description

Sets the anti-alias minimum for the quality parameter. The anti-alias minimum determines the minimum number of subdivisions per pixel.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..6

int AlRender::AntiAlias::max( AlRender::Quality q )

Description

Returns the anti-alias maximum for the quality parameter.

statusCode AlRender::AntiAlias::setMax( AlRender::Quality q, int num)

Description

Sets the adaptive maximum for the quality parameter. The adaptive maximum determines the maximum number of subdivisions per pixel.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..6

double AlRender::AntiAlias::threshold( AlRender::Quality q )

Description

Returns the anti-alias threshold for the quality parameter.

statusCode AlRender::AntiAlias::setThreshold( AlRender::Quality q, double num )

Description

Sets the anti-alias threshold for the quality parameter. If the samples of colors at each corner of a pixel is over threshold then subdivision is used to do a finer grain of anti-aliasing.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..1

boolean AlRender::Limits::createPreview( AlRender::Quality q )

Description

Returns if the preview option is selected for the quality parameter.

statusCode AlRender::Limits::setCreatePreview( AlRender::Quality q, boolean on )

Description

Sets the preview option for the quality parameter. If preview is turned on, a postage stamp sized raytraced image is calculated.

Return Codes

sSuccess - value was set

int AlRender::Limits::maxReflections( AlRender::Quality q )

Description

Returns the maximum number of reflections allowed for the quality parameter.

statusCode AlRender::Limits::setMaxReflections( AlRender::Quality q, int num)

Description

Sets the maximum number of reflections for the quality parameter. This controls the number of levels that reflected rays will be raytraced.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..10

int AlRender::Limits::maxRefractions( AlRender::Quality q )

Description

Returns the maximum number of refractions allowed for the quality parameter.

statusCode AlRender::Limits::setMaxRefractions( AlRender::Quality q, int num)

Description

Sets the maximum number of refractions allowed for the quality parameter. This controls the number of levels of refracted rays that will be raytraced.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..10

int AlRender::Limits::maxShadowLevels( AlRender::Quality q )

Description

Returns the maximum number of shadow levels allowed for the quality parameter.

statusCode AlRender::Limits::setMaxShadowLevels( AlRender::Quality q, int num )

Description

Sets the maximum number of shadow levels allowed for the quality parameter. This controls the number of levels of shadows rays that will be raytraced.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range -1..10

int AlRender::Limits::subdivideRecurse( void )

Description

Returns the current subdivide recurse setting.

statusCode AlRender::Limits::setSubdivideRecurse( int num )

Description

Sets the subdivide recurse setting to num. This setting provides a limit on the number of times that spatial subdivision is recursively applied to the scene.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..3

boolean AlRender::Composite::enabled()

Description

Returns if composite rendering is enabled.

statusCode AlRender::Composite::setEnabled( boolean on )

Description

Sets composite rendering to on or off. If this option is on, then objects that are rendered are not anti-aliased against the background.

Return Codes

sSuccess - value was set

double AlRender::Composite::coverageThreshold()

Description

Returns the composite rendering coverage threshold.

statusCode AlRender::Composite::setCoverageThreshold( double cover )

Description

Sets the composite rendering coverage threshold to cover. This setting determines the number of subsamples required for a pixel as a whole to be considered a part of an object and not a part of the background.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..1

boolean AlRender::Blur::postFilter()

Description

Returns if motion blur post filter option is set.

statusCode AlRender::Blur::setPostFilter( boolean on )

Description

Sets the motion blur post filter option to on or off. Setting this option to on provides additional anti-aliasing after the regular rendering process.

Return Codes

sSuccess - value was set

int AlRender::Blur::postCenter()

Description

Returns the blur center pixel weight.

statusCode AlRender::Blur::setPostCenter( int center )

Description

Sets the blurring center pixel weight.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..20

int AlRender::Blur::postAdjacent()

Description

Returns the blur edge pixel weights.

statusCode AlRender::Blur::setPostAdjacent( int adj )

Description

Sets the blur edge pixel weights.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..20

int AlRender::Blur::postDiagonal()

Description

Returns the blur corner pixel weights.

statusCode AlRender::Blur::setPostDiagonal( int diag )

Description

Sets the blur corner pixel weights.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..20

boolean AlRender::Blur::motionBlur()

Description

Returns TRUE if motion blur is on.

statusCode AlRender::Blur::setMotionBlur( boolean on )

Description

Sets the motion blur to be on or off. Turning this option on produces smoother animations.

Return Codes

sSuccess - value was set

double AlRender::Blur::shutterAngle()

Description

Returns the current shutter angle.

statusCode AlRender::Blur::setShutterAngle( double shutter )

Description

Sets the current shutter angle if blur is on. The larger the shutter value the greater the blur.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..360

AlRender::Misc::GeometrySource AlRender::Misc::geometrySource()

Description

Returns the current geometry source.

statusCode AlRender::Misc::setGeometrySource( AlRender::Misc::GeometrySource source )

Description

Sets the current geometry source to either kModeler or kSDLFile.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

boolean AlRender::Misc::textures()

Description

Returns TRUE if textures will be used in the rendering.

statusCode AlRender::Misc::setTextures( boolean on )

Description

Sets if textures will be used in the rendering.

Return Codes

sSuccess - value was set

boolean AlRender::Misc::skeletons()

Description

Returns TRUE if skeletons are being displayed in the rendering.

statusCode AlRender::Misc::setSkeletons( boolean on )

Description

Sets if skeletons are being used in the rendering.

Return Codes

sSuccess - value was set

boolean AlRender::Misc::noTransparencyInDepth()

Description

Returns TRUE if the "no transparency in depth" option is on.

statusCode AlRender::Misc::setNoTransparencyInDepth( boolean on )

Description

Sets the "no transparency in depth map" option. If this option is set, transparent objects appear in the depth map file.

Return Codes

sSuccess - value was set

double AlRender::Misc::transparency()

Description

Returns the transparency percentage.

statusCode AlRender::Misc::setTransparency( double trans )

Description

Sets the transparency percentage. Objects with a transparency greater than or equal to the ’trans’ value will not appear in the depth file.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..1

boolean AlRender::Misc::keepNonglowedImage()

Description

Returns TRUE if the renderer will not keep the post processed non glowed image.

statusCode AlRender::Misc::setKeepNonglowedImage( boolean on )

Description

Sets the renderer to keep the non glowed image in the rendering post process if parameter on is TRUE.

Return Codes

sSuccess - value was set

boolean AlRender::Misc::spotLightDepthMaps()

Description

Returns TRUE if shadow depth maps are being written to disk.

statusCode AlRender::Misc::setSpotLightDepthMaps( boolean on )

Description

Sets if shadow depth maps should be written to disk based.

Return Codes

sSuccess - value was set

boolean AlRender::Misc::depthMapsInMemory()

Description

Returns TRUE if depth maps are kept in memory.

statusCode AlRender::Misc::setDepthMapsInMemory( boolean on )

Description

Sets if depth maps are to be kept in memory. If set to TRUE, then the depth map is not recomputed for subsequent frames.

Return Codes

sSuccess - value was set

boolean AlRender::Misc::attenuateTransparency()

Description

Returns FALSE if attenuate transparency is on.

statusCode AlRender::Misc::setAttenuateTransparency( boolean on )

Description

Sets attenuate transparency to off to make totally transparent objects appear opaque.

Return Codes

sSuccess - value was set

AlRender::Image::Format AlRender::Image::format()

Description

Returns the image format.

statusCode AlRender::Image::setFormat( AlRender::Image::Format imageFormat )

Description

Sets the image format to one of kAlias, kSGI, kTIFF, kTIFF16, kRLA, kFIDO or kHARRY.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

AlRender::Image::DepthFormat AlRender::Image::depthFormat()

Description

Returns the depth format.

statusCode AlRender::Image::setDepthFormat( AlRender::Image::DepthFormat depth )

Description

Sets the image depth format to either kDepthAlias or kDepthComposer.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

AlRender::Image::Fields AlRender::Image::fields()

Description

Returns the images fields.

statusCode AlRender::Image::setFields( AlRender::Image::Fields setFields )

Description

Sets the image fields to one of kOff, kEven, kOdd or kBoth.

Return Codes

sSuccess - value was set

sInvalidArgument - value was not a valid enum member

boolean AlRender::Image::oddFirst()

Description

Returns TRUE if odd first ordering was chosen for field ordering.

statusCode AlRender::Image::setOddFirst( boolean oddFirst )

Description

Sets fields to be ordered by odd first if the parameter oddFirst is TRUE. If oddFirst if FALSE then field ordering will be even first.

Return Codes

sSuccess - value was set

boolean AlRender::Image::ignoreFilmGate()

Description

Returns TRUE if the rendered image will ignore film gates.

statusCode AlRender::Image::setIgnoreFilmGate( boolean ignoreGate )

Description

Sets ignoreGate to TRUE if the region outside of the filmback should not be rendered.

Return Codes

sSuccess - value was set

double AlRender::Image::gammaCorrection()

Description

Returns the current gamma correction value.

statusCode AlRender::Image::setGammaCorrection( double gamma )

Description

Sets the gamma correction value. Gamma correction is used to alter images by specified factors in each channel to correct the rendered color.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..2

statusCode AlRender::Image::source( const char *camName, boolean &image, boolean &mask, boolean &depth )

Description

Returns the Image File Output toggles in the camera named camName.

Arguments

< camName - name of the camera

> image - Image toggle

> mask - Mask toggle

> depth - Depth toggle

Return Codes

sSuccess - the values were retrieved

sInvalidArgument - camName was NULL

sFailure - camera of the given name was not found

statusCode AlRender::Image::setSource( const char *camName, boolean image, boolean mask, boolean depth )

Description

Sets the Image File Output toggles in the camera named camName.

Arguments

< camName - name of the camera

< image - Image toggle

< mask - Mask toggle

< depth - Depth toggle

Return Codes

sSuccess - the values were set

sInvalidArgument - camName was NULL

sFailure - camera of the given name was not found

boolean AlRender::Image::XYRatioLock()

Description

Returns TRUE if XY ratio lock is on.

statusCode AlRender::Image::setXYRatioLock( boolean ratioLock )

Description

Sets the lock on the X/Y pixel ratio. If the lock is on, then doubling the X resolution will also double the Y resolution. If the lock is off, X and Y resolutions are independent.

Arguments

< ratioLock - new value of the lock

int AlRender::Image::resolutionX()

Description

Returns the X resolution of the image.

statusCode AlRender::Image::setResolutionX( int xres )

Description

Sets the X resolution of the image.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..32767

int AlRender::Image::resolutionY()

Description

Returns the Y resolution of the image.

statusCode AlRender::Image::setResolutionY( int yres )

Description

Sets the Y resolution of the image.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..32767

double AlRender::Image::aspectRatio()

Description

Returns the aspect ratio of the image.

statusCode AlRender::Image::setAspectRatio( double aspect )

Description

Sets the aspect ratio of the image.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..1

boolean AlRender::HiddenLine::useFillColor()

Description

Returns TRUE if all surfaces in the scene are to be filled with the fill color specified by the setFillColor() method.

statusCode AlRender::HiddenLine::setUseFillColor( boolean useFill )

Description

Sets the usage of fill colors for surfaces within a scene.

Return Codes

sSuccess - value was set

statusCode AlRender::HiddenLine::fillColor( double& r, double &g, double &b)

Description

Returns the current fill colors.

Return Codes

sSuccess - the method succeeded

statusCode AlRender::HiddenLine::setFillColor( double r, double g, double b )

Description

Sets the fill color to r,g,b.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..255

statusCode AlRender::HiddenLine::lineColor( double& r, double& g, double& b)

Description

Returns the line color.

Return Codes

sSuccess - the line color was returned

statusCode AlRender::HiddenLine::setLineColor( double r, double g, double b )

Description

Sets the color of lines for all surfaces within a scene to r,g,b.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..255

int AlRender::HiddenLine::patchLinesU()

Description

Returns the U patch lines for a surface.

statusCode AlRender::HiddenLine::setPatchLinesU( int lines )

Description

Sets the number of U patch lines for a surface in a scene. This controls the number of lines that are shown in the U direction of each surface in a scene. Setting this to 0 will cause only edges of a surface to be displayed.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..8

int AlRender::HiddenLine::patchLinesV()

Description

Returns the V patch lines for a surface.

statusCode AlRender::HiddenLine::setPatchLinesV( int lines )

Description

Sets the number of V patch lines for a surface in a scene. This controls the number of lines that are shown in the V direction of each surface in a scene. Setting this to 0 will cause only edges of a surface to be displayed.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 0..8

boolean AlRender::Particle::show()

Description

Returns TRUE if particles will be shown in the scene.

statusCode AlRender::Particle::setShow( boolean on )

Description

Sets if particles should be rendered in the scene.

Return Codes

sSuccess - value was set

int AlRender::Particle::simulationSubsteps()

Description

Returns the particle simulation substeps.

statusCode AlRender::Particle::setSimulationSubsteps( int substeps )

Description

Sets the particle simulation substeps. A higher number produces a more accurate animation but also increases rendering time.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..8

int AlRender::Particle::framesPerSecond()

Description

Returns the particle frames for second setting.

statusCode AlRender::Particle::setFramesPerSecond( int frames )

Description

Sets the particle frames per second value. This value is used to specify how fast images will be displayed from the final animation. This value is also used to calculate the correct amount of force and gravity to apply to particles during the simulation.

Return Codes

sSuccess - the value was set

sInvalidArgument - the value was not in the range 1..30

statusCode AlRender::Image::readResolutions( AlList* &resolutions )

Description

Returns a list of resolutions as name,x,y,aspect. These are the entries that are found in the ’predefined’ area of the render globals area.

Arguments

> resolutions - list of resolutions

Return Codes

sSuccess - a list of resolutions was returned

sFailure - the list could not be allocated

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.