an actor that supports multiple levels of detail More...

#include <vtkLODActor.h>

Inheritance diagram for vtkLODActor:

Collaboration diagram for vtkLODActor:

Public Types
typedef vtkActor	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkLODActor *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
virtual void	Render (vtkRenderer , vtkMapper )
int	RenderOpaqueGeometry (vtkViewport *viewport)
void	ReleaseGraphicsResources (vtkWindow *)
void	AddLODMapper (vtkMapper *mapper)
void	Modified ()
void	ShallowCopy (vtkProp *prop)

virtual void	SetLowResFilter (vtkPolyDataAlgorithm *)
virtual void	SetMediumResFilter (vtkPolyDataAlgorithm *)
virtual vtkPolyDataAlgorithm *	GetLowResFilter ()
virtual vtkPolyDataAlgorithm *	GetMediumResFilter ()

virtual int	GetNumberOfCloudPoints ()
virtual void	SetNumberOfCloudPoints (int)

virtual vtkMapperCollection *	GetLODMappers ()
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkLODActor *	SafeDownCast (vtkObjectBase *o)
static vtkLODActor *	New ()
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkLODActor ()
	~vtkLODActor ()
virtual void	CreateOwnLODs ()
virtual void	UpdateOwnLODs ()
virtual void	DeleteOwnLODs ()
Protected Attributes
vtkActor *	Device
vtkMapperCollection *	LODMappers
vtkPolyDataAlgorithm *	LowResFilter
vtkPolyDataAlgorithm *	MediumResFilter
vtkPolyDataMapper *	LowMapper
vtkPolyDataMapper *	MediumMapper
vtkTimeStamp	BuildTime
int	NumberOfCloudPoints

Detailed Description

an actor that supports multiple levels of detail

vtkLODActor is an actor that stores multiple levels of detail (LOD) and can automatically switch between them. It selects which level of detail to use based on how much time it has been allocated to render. Currently a very simple method of TotalTime/NumberOfActors is used. (In the future this should be modified to dynamically allocate the rendering time between different actors based on their needs.)

There are three levels of detail by default. The top level is just the normal data. The lowest level of detail is a simple bounding box outline of the actor. The middle level of detail is a point cloud of a fixed number of points that have been randomly sampled from the mapper's input data. Point attributes are copied over to the point cloud. These two lower levels of detail are accomplished by creating instances of a vtkOutlineFilter (low-res) and vtkMaskPoints (medium-res). Additional levels of detail can be add using the AddLODMapper() method.

To control the frame rate, you typically set the vtkRenderWindowInteractor DesiredUpdateRate and StillUpdateRate. This then will cause vtkLODActor to adjust its LOD to fulfill the requested update rate.

For greater control on levels of detail, see also vtkLODProp3D. That class allows arbitrary definition of each LOD.

Warning:: If you provide your own mappers, you are responsible for setting its ivars correctly, such as ScalarRange, LookupTable, and so on.; On some systems the point cloud rendering (the default, medium level of detail) can result in points so small that they can hardly be seen. In this case, use the GetProperty()->SetPointSize() method to increase the rendered size of the points.

See also:: vtkActor vtkRenderer vtkLODProp3D

Examples:: vtkLODActor (Examples)

Tests:: vtkLODActor (Tests)

Definition at line 75 of file vtkLODActor.h.

Member Typedef Documentation

typedef vtkActor vtkLODActor::Superclass

Reimplemented from vtkActor.

Definition at line 78 of file vtkLODActor.h.

Constructor & Destructor Documentation

vtkLODActor::vtkLODActor ( ) [protected]

vtkLODActor::~vtkLODActor ( ) [protected]

Member Function Documentation

static int vtkLODActor::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkActor.

virtual int vtkLODActor::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkActor.

static vtkLODActor* vtkLODActor::SafeDownCast ( vtkObjectBase * o ) [static]

Reimplemented from vtkActor.

virtual vtkObjectBase* vtkLODActor::NewInstanceInternal ( ) const [protected, virtual]

Reimplemented from vtkActor.

vtkLODActor* vtkLODActor::NewInstance ( ) const

Reimplemented from vtkActor.

void vtkLODActor::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)		`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkActor.

static vtkLODActor* vtkLODActor::New ( ) [static]

Creates a vtkLODActor with the following defaults: origin(0,0,0) position=(0,0,0) scale=(1,1,1) visibility=1 pickable=1 dragable=1 orientation=(0,0,0). NumberOfCloudPoints is set to 150.

Reimplemented from vtkActor.

virtual void vtkLODActor::Render	(	vtkRenderer *	,
		vtkMapper *
	)		`[virtual]`

This causes the actor to be rendered. It, in turn, will render the actor's property and then mapper.

Reimplemented from vtkActor.

int vtkLODActor::RenderOpaqueGeometry ( vtkViewport * viewport ) [virtual]

This method is used internally by the rendering process. We overide the superclass method to properly set the estimated render time.

Reimplemented from vtkActor.

void vtkLODActor::ReleaseGraphicsResources ( vtkWindow * ) [virtual]

Release any graphics resources that are being consumed by this actor. The parameter window could be used to determine which graphic resources to release.

Reimplemented from vtkActor.

void vtkLODActor::AddLODMapper ( vtkMapper * mapper )

Add another level of detail. They do not have to be in any order of complexity.

virtual void vtkLODActor::SetLowResFilter ( vtkPolyDataAlgorithm * ) [virtual]

You may plug in your own filters to decimate/subsample the input. The default is to use a vtkOutlineFilter (low-res) and vtkMaskPoints (medium-res).

virtual void vtkLODActor::SetMediumResFilter ( vtkPolyDataAlgorithm * ) [virtual]

You may plug in your own filters to decimate/subsample the input. The default is to use a vtkOutlineFilter (low-res) and vtkMaskPoints (medium-res).

virtual vtkPolyDataAlgorithm* vtkLODActor::GetLowResFilter ( ) [virtual]

You may plug in your own filters to decimate/subsample the input. The default is to use a vtkOutlineFilter (low-res) and vtkMaskPoints (medium-res).

virtual vtkPolyDataAlgorithm* vtkLODActor::GetMediumResFilter ( ) [virtual]

You may plug in your own filters to decimate/subsample the input. The default is to use a vtkOutlineFilter (low-res) and vtkMaskPoints (medium-res).

virtual int vtkLODActor::GetNumberOfCloudPoints ( ) [virtual]