NAME

DoMinBoundingVolExt − Create an attribute object which specifies the minimum renderable bounding extent

SYNOPSIS

C:

DtObject DoMinBoundingVolExt(extension)
DtReal Extension;

Fortran:

INTEGER∗4 DOMBVE(EXTENS)
REAL∗8 EXTENS

DESCRIPTION

DoMinBoundingVolExt creates an attribute object which specifies the minimum renderable bounding extent.  The parameter extension specifies the shortest length in device coordinates (pixels) that a bounding volume (specified with DoBoundingVol <DOBV>) must span in X and Y on the device before the renderer will ignore objects.  The renderer will either ignore objects below that bounding volume or render their alternate object instead. 

The bounding volume object’s intersection with the display volume is computed when a bounding volume object is executed.  If the intersection is empty, that is if the bounding volume is not currently visible, then execution of the current group is aborted because nothing else in the group will draw.  If the intersection is not empty, then a further test is made.  First, the smallest right rectangle that can enclose the projection of the bounding volume on the device is computed.  Then, if the length of the diagonal of that rectangle is less than the current minimum bounding extention, then execution of the current group will be aborted and any alternate object will be executed in its place. 

See DoBoundingVol for more information on the process used to determine whether an object or its alternate representation should be rendered. 

DEFAULTS

The default value for DoMinBoundingVolExt is 2.0 pixels. 

SEE ALSO

DoBoundingVol(3D), DoBoundingVolSwitch(3D), DsCompBoundingVol(3D)

September 29, 2021