Main Page   Class Hierarchy   Alphabetical List   Compound List   Compound Members   Related Pages  

vtkTexture Class Reference

handles properties associated with a texture map. More...

#include <vtkTexture.h>

Inheritance diagram for vtkTexture:

Inheritance graph
[legend]
Collaboration diagram for vtkTexture:

Collaboration graph
[legend]
List of all members.

Public Methods

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
virtual void Render (vtkRenderer *ren)
virtual void ReleaseGraphicsResources (vtkWindow *)
virtual void Load (vtkRenderer *)
virtual int GetRepeat ()
virtual void SetRepeat (int)
virtual void RepeatOn ()
virtual void RepeatOff ()
virtual int GetInterpolate ()
virtual void SetInterpolate (int)
virtual void InterpolateOn ()
virtual void InterpolateOff ()
virtual void SetQuality (int)
virtual int GetQuality ()
void SetQualityToDefault ()
void SetQualityTo16Bit ()
void SetQualityTo32Bit ()
virtual int GetMapColorScalarsThroughLookupTable ()
virtual void SetMapColorScalarsThroughLookupTable (int)
virtual void MapColorScalarsThroughLookupTableOn ()
virtual void MapColorScalarsThroughLookupTableOff ()
virtual void SetInput (vtkStructuredPoints *)
virtual vtkStructuredPointsGetInput ()
void SetInput (vtkImageData *cache)
void SetLookupTable (vtkLookupTable *)
virtual vtkLookupTableGetLookupTable ()
virtual vtkScalarsGetMappedScalars ()
unsigned char * MapScalarsToColors (vtkScalars *scalars)

Static Public Methods

vtkTexture * New ()
int IsTypeOf (const char *type)
vtkTexture * SafeDownCast (vtkObject *o)

Protected Methods

 vtkTexture ()
 ~vtkTexture ()
 vtkTexture (const vtkTexture &)
void operator= (const vtkTexture &)

Protected Attributes

int Repeat
int Interpolate
int Quality
int MapColorScalarsThroughLookupTable
vtkStructuredPointsInput
vtkLookupTableLookupTable
vtkScalarsMappedScalars
int SelfAdjustingTableRange

Detailed Description

handles properties associated with a texture map.

Date:
2000/12/10 20:08:55
Revision:
1.46

vtkTexture is an object that handles loading and binding of texture maps. It obtains its data from an input structured points dataset type. Thus you can create visualization pipelines to read, process, and construct textures. Note that textures will only work if texture coordinates are also defined, and if the rendering system supports texture.

Instances of vtkTexture are associated with actors via the actor's SetTexture() method. Actors can share texture maps (this is encouraged to save memory resources.)

Warning:
Currently only 2D texture maps are supported, even though the data pipeline supports 1,2, and 3D texture coordinates.
Warning:
Some renderers such as OpenGL require that the texture map dimensions are a power of two in each direction. Other renderers may have similar (ridiculous) restrictions, so be careful out there... (Note: a recent change to vtk allows use of non-power of two texture maps in OpenGL. The texture is automatically resampled to a power of two in one or more directions.)
See also:
vtkActor vtkRenderer vtkOpenGLTexture
Examples:
vtkTexture (examples)


Member Function Documentation

virtual const char* vtkTexture::GetClassName   [virtual]
 

Return the class name as a string. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMesaTexture.

virtual int vtkTexture::GetInterpolate   [virtual]
 

Turn on/off linear interpolation of the texture map when rendering.

virtual int vtkTexture::GetMapColorScalarsThroughLookupTable   [virtual]
 

Turn on/off the mapping of color scalars through the lookup table. The default is Off. If Off, unsigned char scalars will be used directly as texture. If On, scalars will be mapped through the lookup table to generate 4-component unsigned char scalars. This ivar does not affect other scalars like unsigned short, float, etc. These scalars are always mapped through lookup tables.

virtual vtkScalars* vtkTexture::GetMappedScalars   [virtual]
 

Get Mapped Scalars

virtual int vtkTexture::GetRepeat   [virtual]
 

Turn on/off the repetition of the texture map when the texture coords extend beyond the [0,1] range.

virtual int vtkTexture::IsA const char *    type [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 vtkObject.

Reimplemented in vtkMesaTexture.

int vtkTexture::IsTypeOf const char *    type [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 vtkObject.

Reimplemented in vtkMesaTexture.

virtual void vtkTexture::Load vtkRenderer   [inline, virtual]
 

Abstract interface to renderer. Each concrete subclass of vtkTexture will load its data into graphics system in response to this method invocation.

Reimplemented in vtkMesaTexture.

unsigned char* vtkTexture::MapScalarsToColors vtkScalars   scalars
 

Map scalar values into color scalars.

vtkTexture* vtkTexture::New   [static]
 

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

Reimplemented in vtkMesaTexture.

void vtkTexture::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 vtkObject.

virtual void vtkTexture::ReleaseGraphicsResources vtkWindow   [inline, virtual]
 

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

Reimplemented in vtkMesaTexture.

virtual void vtkTexture::Render vtkRenderer   ren [virtual]
 

Renders a texture map. It first checks the object's modified time to make sure the texture maps Input is valid, then it invokes the Load() method.

vtkTexture* vtkTexture::SafeDownCast vtkObject   o [static]
 

Will cast the supplied object to vtkObject* is this is a safe operation (i.e., a safe downcast); otherwise NULL is returned. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMesaTexture.

virtual void vtkTexture::SetInput vtkStructuredPoints   [virtual]
 

Specify the data for the texture map.

void vtkTexture::SetLookupTable vtkLookupTable  
 

Specify the lookup table to convert scalars if necessary

virtual void vtkTexture::SetQuality int    [virtual]
 

Force texture quality to 16-bit or 32-bit. This might not be supported on all machines.


The documentation for this class was generated from the following file:
Generated on Tue Mar 19 13:33:40 2002 for VTK by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002