NAME
vtkImplicitTextureCoords - generate 1D, 2D, or 3D texture coordinates based on implicit function(s)
SYNOPSIS
#include "/opt/vtk-c++/graphics/vtkImplicitTextureCoords.h"
class VTK_EXPORT vtkImplicitTextureCoords : public vtkDataSetToDataSetFilter
vtkImplicitTextureCoords();
static vtkImplicitTextureCoords *New() {return new vtkImplicitTextureCoords;};
const char *GetClassName() {return "vtkImplicitTextureCoords";};
void PrintSelf(ostream& os, vtkIndent indent);
void SetRFunction(vtkImplicitFunction*);
void SetRFunction(vtkImplicitFunction& );
vtkImplicitFunction *GetRFunction();
void SetSFunction(vtkImplicitFunction*);
void SetSFunction(vtkImplicitFunction& );
vtkImplicitFunction *GetSFunction();
void SetTFunction(vtkImplicitFunction*);
void SetTFunction(vtkImplicitFunction& );
vtkImplicitFunction *GetTFunction();
void SetFlipTexture(int);
int GetFlipTexture();
void FlipTextureOn();
void FlipTextureOff();
void Update();
DESCRIPTION
vtkImplicitTextureCoords is a filter to generate 1D, 2D, or 3D texture coordinates from one, two, or three implicit functions, respectively. In combinations with a vtkBooleanTexture map (or another texture map of your own creation), the texture coordinates can be used to highlight via color or intensity) or cut (via transparency) dataset geometry without any complex geometric processing. (Note: the texture coordinates are referred to as r-s-t coordinates.)
The texture coordinates are automatically normalized to lie between (0,1). Thus, no matter what the implicit functions evaluate to, the resulting texture coordinates lie between (0,1), with the zero implicit function value mapped to the 0.5 texture coordinates value. Depending upon the maximum negative/positive implicit function values, the full (0,1) range may not be occupied (i.e., the positive/negative ranges are mapped using the same scale factor).
A boolean variable InvertTexture is available to flip the texture coordinates around 0.5 (value 1.0 becomes 0.0, 0.25->0.75). This is equivalent to flipping the texture map (but a whole lot easier).
CAVEATS
You can use the transformation capabilities of vtkImplicitFunction to orient, translate, and scale the implicit functions. Also, the dimension of the texture coordinates is implicitly defined by the number of implicit functions defined.
SEE ALSO
vtkImplicitFunction vtkTexture vtkBooleanTexture vtkTransformTexture
SUMMARY
void SetRFunction(vtkImplicitFunction*)
void SetRFunction(vtkImplicitFunction& )
Specify an implicit function to compute the r texture coordinate.
void SetSFunction(vtkImplicitFunction*)
void SetSFunction(vtkImplicitFunction& )
Specify an implicit function to compute the s texture coordinate.
void SetTFunction(vtkImplicitFunction*)
void SetTFunction(vtkImplicitFunction& )
Specify an implicit function to compute the t texture coordinate.
void SetFlipTexture(int)
If enabled, this will flip the sense of inside and outside the implicit function (i.e., a rotation around the r-s-t=0.5 axis).
vtkImplicitTextureCoords()
Create object with texture dimension=2 and no r-s-t implicit functions defined and FlipTexture turned off.
void Update()
Update input to this filter and the filter itself. Note that we are overloading this method because the output is an abstract dataset type. This requires special treatment.