VisualizationFoundation CAT3DLodRep

Usage: you must use this class as is. You should never derive it.


public class CAT3DLodRep

Class to define several representations, each of a different accuracy, to visualize the same object.
Role: This representation introduces the concept of Levels Of Details within the visualization of a scene. It manages a list of representations, that are supposed to be of the same element, at different accuracy levels. Representations of the element with a low accuracy level are supposed to take less time to be drawn. When the representation is requested to Draw itself, it chooses the best of it's representations to draw, that is the representation whose accuracy fits the pixel resolution of the element (size of a pixel onto the object). The CAT3DLodRep behaves as a CAT3DBagRep for which the children would be a same representation computed at different accuracy levels. Methods are provided, once the representation has been created, to add Levels Of Detail (Lods). A Lod is added with a given accuracy (sag), that will determine when it has to be drawn (at which distance from the eye) instead of the original geometry. The first Lod is considered as the 'original' geometry defining the element. The used bounding element is the one of the first Lod. Any other Lod should fit in this bounding element. At the representation destruction, every Lod is being deleted, including the original geometry itself. A call to SuppressLod deletes the targetted representation.


Constructor and Destructor Index


o CAT3DLodRep(void)
o ~CAT3DLodRep(void)
Destructor.

Method Index


o AddLod(CAT3DRep*,float)
Adds a representation as a new level of detail.
o CreateRep()
Default constructor.
o GetLod(int)
Gets the representation of a given LOD.
o GetLodSag(int)
Gets the sag associated to the representation of a given LOD.
o NbLods(void)
Gets the number of different representations used to represent the same object at different accuracy levels.
o SuppressLod(int)
Supresses a given representation from the list of representations used as levels of details.

Constructor and Destructor


o CAT3DLodRep
public CAT3DLodRep( )
Deprecated:
R417 : Use CreateRep instead.
o ~CAT3DLodRep
public virtual ~CAT3DLodRep( )
Destructor.

Methods


o AddLod
public AddLod( iLod,
iSag)
Adds a representation as a new level of detail.
Parameters:
iLod
The 3D representation that would be used to visualize the object at the associated accuracy.
iSag
The sag used to tessellate the associated representation, expressed in millimeters. This sag is used to determine which LOD is the most appropriated to represent the object at a certain distance, and with a certain session sag, fixed thanks to the CATIA Tools > Options > Performance menu.
o CreateRep
public static CreateRep()
Default constructor.
o GetLod
public GetLod( iNumLod)
Gets the representation of a given LOD.
Parameters:
iNumLod
The index of the LOD which representation is retrieved.
o GetLodSag
public GetLodSag( iNumLod)
Gets the sag associated to the representation of a given LOD.
Parameters:
iNumLod
The index of the LOD which sag is retrieved.
o NbLods
public NbLods( )
Gets the number of different representations used to represent the same object at different accuracy levels.
o SuppressLod
public SuppressLod( iNumLod)
Supresses a given representation from the list of representations used as levels of details. The supressed representation is destroyed.
Parameters:
iNumLod
The index of the LOD you want to supress.

This object is included in the file: CAT3DLodRep.h
If needed, your Imakefile.mk should include the module: CATVisFoundation

Copyright © 1999-2015, Dassault Systèmes. All rights reserved.