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

vtkRuledSurfaceFilter Class Reference

generates a surface from a set of lines. More...

#include <vtkRuledSurfaceFilter.h>

Inheritance diagram for vtkRuledSurfaceFilter:

Inheritance graph
[legend]
Collaboration diagram for vtkRuledSurfaceFilter:

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 SetDistanceFactor (float)
virtual float GetDistanceFactor ()
virtual void SetOnRatio (int)
virtual int GetOnRatio ()
virtual void SetOffset (int)
virtual int GetOffset ()
virtual void SetCloseSurface (int)
virtual int GetCloseSurface ()
virtual void CloseSurfaceOn ()
virtual void CloseSurfaceOff ()
virtual void SetRuledMode (int)
virtual int GetRuledMode ()
void SetRuledModeToResample ()
void SetRuledModeToPointWalk ()
const char * GetRuledModeAsString ()
virtual void SetResolution (int, int)
void SetResolution (int[2])
virtual int * GetResolution ()
virtual void GetResolution (int data[2])
virtual void SetPassLines (int)
virtual int GetPassLines ()
virtual void PassLinesOn ()
virtual void PassLinesOff ()

Static Public Methods

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

Protected Methods

 vtkRuledSurfaceFilter ()
 ~vtkRuledSurfaceFilter ()
 vtkRuledSurfaceFilter (const vtkRuledSurfaceFilter &)
void operator= (const vtkRuledSurfaceFilter &)
void Execute ()

Protected Attributes

float DistanceFactor
int OnRatio
int Offset
int CloseSurface
int RuledMode
int Resolution [2]
int PassLines

Detailed Description

generates a surface from a set of lines.

Date:
2000/12/10 20:08:51
Revision:
1.3

vtkRuledSurfaceFilter is a filter that generates a surface from a set of lines. The lines are assumed to be "parallel" in the sense that they do not intersect and remain somewhat close to one another. A surface is generated by connecting the points defining each pair of lines with straight lines. This creates a strip for each pair of lines (i.e., a triangulation is created from two generating lines). The filter can handle an arbitrary number of lines, with lines i and i+1 assumed connected. Note that there are several different approaches for creating the ruled surface, the method for creating the surface can either use the input points or resample from the polylines (using a user-specified resolution).

This filter offers some other important features. A DistanceFactor ivar is used to decide when two lines are too far apart to connect. (The factor is a multiple of the distance between the first two points of the two lines defining the strip.) If the distance between the two generating lines becomes too great, then the surface is not generated in that region. (Note: if the lines separate and then merge, then a hole can be generated in the surface.) In addition, the Offset and OnRation ivars can be used to create nifty striped surfaces. Closed surfaces (e.g., tubes) can be created by setting the CloseSurface ivar. (The surface can be closed in the other direction by repeating the first and last point in the polylines defining the surface.)

An important use of this filter is to combine it with vtkStreamLine to generate stream surfaces. It can also be used to create surfaces from contours.

Warning:
The number of lines must be greater than two if a surface is to be generated. sides (i.e., a ribbon), use vtkRibbonFilter.
See also:
vtkRibbonFilter vtkStreamLine
Examples:
vtkRuledSurfaceFilter (examples)

Definition at line 91 of file vtkRuledSurfaceFilter.h.


Constructor & Destructor Documentation

vtkRuledSurfaceFilter::vtkRuledSurfaceFilter   [protected]
 

vtkRuledSurfaceFilter::~vtkRuledSurfaceFilter   [protected]
 

vtkRuledSurfaceFilter::vtkRuledSurfaceFilter const vtkRuledSurfaceFilter &    [inline, protected]
 

Definition at line 156 of file vtkRuledSurfaceFilter.h.


Member Function Documentation

virtual const char* vtkRuledSurfaceFilter::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 vtkPolyDataToPolyDataFilter.

int vtkRuledSurfaceFilter::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 vtkPolyDataToPolyDataFilter.

virtual int vtkRuledSurfaceFilter::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 vtkPolyDataToPolyDataFilter.

vtkRuledSurfaceFilter* vtkRuledSurfaceFilter::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 vtkPolyDataToPolyDataFilter.

void vtkRuledSurfaceFilter::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 vtkSource.

vtkRuledSurfaceFilter* vtkRuledSurfaceFilter::New   [static]
 

Construct object with OnRatio=1, Offset=0. DistanceFactor=3.0, CloseSurface off, and PassLines off.

Reimplemented from vtkPolyDataSource.

virtual void vtkRuledSurfaceFilter::SetDistanceFactor float    [virtual]
 

Set/Get the factor that controls tearing of the surface.

virtual float vtkRuledSurfaceFilter::GetDistanceFactor   [virtual]
 

virtual void vtkRuledSurfaceFilter::SetOnRatio int    [virtual]
 

Control the striping of the ruled surface. If OnRatio is greater than 1, then every nth strip is turned on, beginning with the Offset strip.

virtual int vtkRuledSurfaceFilter::GetOnRatio   [virtual]
 

virtual void vtkRuledSurfaceFilter::SetOffset int    [virtual]
 

Control the striping of the ruled surface. The offset sets the first stripe that is visible. Offset is generally used with OnRatio to create nifty striping effects.

virtual int vtkRuledSurfaceFilter::GetOffset   [virtual]
 

virtual void vtkRuledSurfaceFilter::SetCloseSurface int    [virtual]
 

Indicate whether the surface is to be closed. If this boolean is on, then the first and last polyline are used to generate a stripe that closes the surface. (Note: to close the surface in the other direction, repeat the first point in the polyline as the last point in the polyline.)

virtual int vtkRuledSurfaceFilter::GetCloseSurface   [virtual]
 

virtual void vtkRuledSurfaceFilter::CloseSurfaceOn   [virtual]
 

virtual void vtkRuledSurfaceFilter::CloseSurfaceOff   [virtual]
 

virtual void vtkRuledSurfaceFilter::SetRuledMode int    [virtual]
 

Set the mode by which to create the ruled surface. (Dramatically different results are possible depending on the chosen mode.) The resample mode evenly resamples the polylines (based on length) and generates triangle strips. The

virtual int vtkRuledSurfaceFilter::GetRuledMode   [virtual]
 

void vtkRuledSurfaceFilter::SetRuledModeToResample   [inline]
 

Definition at line 133 of file vtkRuledSurfaceFilter.h.

void vtkRuledSurfaceFilter::SetRuledModeToPointWalk   [inline]
 

Definition at line 135 of file vtkRuledSurfaceFilter.h.

const char* vtkRuledSurfaceFilter::GetRuledModeAsString  
 

virtual void vtkRuledSurfaceFilter::SetResolution int   ,
int   
[virtual]
 

If the ruled surface generation mode is RESAMPLE, then these parameters are used to determine the resample rate. Resolution[0] defines the resolution in the direction of the polylines; Resolution[1] defines the resolution across the polylines (i.e., direction orthogonal to Resolution[0]).

void vtkRuledSurfaceFilter::SetResolution int   [2]
 

virtual int* vtkRuledSurfaceFilter::GetResolution   [virtual]
 

virtual void vtkRuledSurfaceFilter::GetResolution int    data[2] [virtual]
 

virtual void vtkRuledSurfaceFilter::SetPassLines int    [virtual]
 

Indicate whether the generating lines are to be passed to the output. By defualt lines are not passed to the output.

virtual int vtkRuledSurfaceFilter::GetPassLines   [virtual]
 

virtual void vtkRuledSurfaceFilter::PassLinesOn   [virtual]
 

virtual void vtkRuledSurfaceFilter::PassLinesOff   [virtual]
 

void vtkRuledSurfaceFilter::operator= const vtkRuledSurfaceFilter &    [inline, protected]
 

Definition at line 157 of file vtkRuledSurfaceFilter.h.

void vtkRuledSurfaceFilter::Execute   [protected, virtual]
 

Reimplemented from vtkSource.


Member Data Documentation

float vtkRuledSurfaceFilter::DistanceFactor [protected]
 

Definition at line 162 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::OnRatio [protected]
 

Definition at line 163 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::Offset [protected]
 

Definition at line 164 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::CloseSurface [protected]
 

Definition at line 165 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::RuledMode [protected]
 

Definition at line 166 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::Resolution[2] [protected]
 

Definition at line 167 of file vtkRuledSurfaceFilter.h.

int vtkRuledSurfaceFilter::PassLines [protected]
 

Definition at line 168 of file vtkRuledSurfaceFilter.h.


The documentation for this class was generated from the following file:
Generated on Wed Nov 21 12:59:54 2001 for VTK by doxygen1.2.11.1 written by Dimitri van Heesch, © 1997-2001