VTK
|
GPU-based implementation of Line Integral Convolution (LIC) More...
#include <vtkLineIntegralConvolution2D.h>
Public Types | |
typedef vtkObject | Superclass |
![]() | |
typedef vtkObjectBase | Superclass |
Public Member Functions | |
virtual const char * | GetClassName () |
virtual int | IsA (const char *type) |
void | PrintSelf (ostream &os, vtkIndent indent) |
int | Execute () |
virtual void | SetEnhancedLIC (int) |
virtual int | GetEnhancedLIC () |
virtual void | EnhancedLICOn () |
virtual void | EnhancedLICOff () |
virtual void | SetLICForSurface (int) |
virtual int | GetLICForSurface () |
virtual void | LICForSurfaceOn () |
virtual void | LICForSurfaceOff () |
virtual void | SetNumberOfSteps (int) |
virtual int | GetNumberOfSteps () |
virtual void | SetLICStepSize (double) |
virtual double | GetLICStepSize () |
void | SetNoise (vtkTextureObject *noise) |
virtual vtkTextureObject * | GetNoise () |
void | SetVectorField (vtkTextureObject *vectorField) |
virtual vtkTextureObject * | GetVectorField () |
virtual void | SetComponentIds (int, int) |
void | SetComponentIds (int[2]) |
virtual int * | GetComponentIds () |
virtual void | GetComponentIds (int &, int &) |
virtual void | GetComponentIds (int[2]) |
virtual void | SetGridSpacings (double, double) |
void | SetGridSpacings (double[2]) |
virtual double * | GetGridSpacings () |
virtual void | GetGridSpacings (double &, double &) |
virtual void | GetGridSpacings (double[2]) |
virtual void | SetTransformVectors (int) |
virtual void | TransformVectorsOn () |
virtual void | TransformVectorsOff () |
virtual int | GetTransformVectors () |
virtual void | SetMagnification (int) |
virtual int | GetMagnification () |
void | SetVectorShiftScale (double shift, double scale) |
int | Execute (unsigned int extent[4]) |
int | Execute (int extent[4]) |
void | SetLIC (vtkTextureObject *lic) |
virtual vtkTextureObject * | GetLIC () |
![]() | |
virtual void | DebugOn () |
virtual void | DebugOff () |
unsigned char | GetDebug () |
void | SetDebug (unsigned char debugFlag) |
virtual void | Modified () |
virtual unsigned long | GetMTime () |
unsigned long | AddObserver (unsigned long event, vtkCommand *, float priority=0.0f) |
unsigned long | AddObserver (const char *event, vtkCommand *, float priority=0.0f) |
vtkCommand * | GetCommand (unsigned long tag) |
void | RemoveObserver (vtkCommand *) |
void | RemoveObservers (unsigned long event, vtkCommand *) |
void | RemoveObservers (const char *event, vtkCommand *) |
int | HasObserver (unsigned long event, vtkCommand *) |
int | HasObserver (const char *event, vtkCommand *) |
void | RemoveObserver (unsigned long tag) |
void | RemoveObservers (unsigned long event) |
void | RemoveObservers (const char *event) |
void | RemoveAllObservers () |
int | HasObserver (unsigned long event) |
int | HasObserver (const char *event) |
template<class U , class T > | |
unsigned long | AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f) |
template<class U , class T > | |
unsigned long | AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f) |
int | InvokeEvent (unsigned long event, void *callData) |
int | InvokeEvent (const char *event, void *callData) |
int | InvokeEvent (unsigned long event) |
int | InvokeEvent (const char *event) |
![]() | |
const char * | GetClassName () const |
virtual void | Delete () |
virtual void | FastDelete () |
void | Print (ostream &os) |
virtual void | Register (vtkObjectBase *o) |
virtual void | UnRegister (vtkObjectBase *o) |
void | SetReferenceCount (int) |
void | PrintRevisions (ostream &os) |
virtual void | PrintHeader (ostream &os, vtkIndent indent) |
virtual void | PrintTrailer (ostream &os, vtkIndent indent) |
int | GetReferenceCount () |
Static Public Member Functions | |
static vtkLineIntegralConvolution2D * | New () |
static int | IsTypeOf (const char *type) |
static vtkLineIntegralConvolution2D * | SafeDownCast (vtkObject *o) |
static bool | IsSupported (vtkRenderWindow *renWin) |
![]() | |
static void | BreakOnError () |
static void | SetGlobalWarningDisplay (int val) |
static void | GlobalWarningDisplayOn () |
static void | GlobalWarningDisplayOff () |
static int | GetGlobalWarningDisplay () |
Protected Member Functions | |
vtkLineIntegralConvolution2D () | |
~vtkLineIntegralConvolution2D () | |
![]() | |
vtkObject () | |
virtual | ~vtkObject () |
virtual void | RegisterInternal (vtkObjectBase *, int check) |
virtual void | UnRegisterInternal (vtkObjectBase *, int check) |
void | InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL) |
void | InternalReleaseFocus () |
![]() | |
vtkObjectBase () | |
virtual | ~vtkObjectBase () |
virtual void | CollectRevisions (ostream &os) |
virtual void | ReportReferences (vtkGarbageCollector *) |
vtkObjectBase (const vtkObjectBase &) | |
void | operator= (const vtkObjectBase &) |
Protected Attributes | |
int | Magnification |
int | NumberOfSteps |
int | LICForSurface |
int | EnhancedLIC |
double | LICStepSize |
double | VectorShift |
double | VectorScale |
int | TransformVectors |
int | ComponentIds [2] |
double | GridSpacings [2] |
vtkTextureObject * | VectorField |
vtkTextureObject * | Noise |
vtkTextureObject * | LIC |
![]() | |
unsigned char | Debug |
vtkTimeStamp | MTime |
vtkSubjectHelper * | SubjectHelper |
![]() | |
int | ReferenceCount |
vtkWeakPointerBase ** | WeakPointers |
GPU-based implementation of Line Integral Convolution (LIC)
This class resorts to GLSL to implement GPU-based Line Integral Convolution (LIC) for visualizing a 2D vector field that may be obtained by projecting an original 3D vector field onto a surface (such that the resulting 2D vector at each grid point on the surface is tangential to the local normal, as done in vtkSurfaceLICPainter).
As an image-based technique, 2D LIC works by (1) integrating a bidirectional streamline from the center of each pixel (of the LIC output image), (2) locating the pixels along / hit by this streamline as the correlated pixels of the starting pixel (seed point / pixel), (3) indexing a (usually white) noise texture (another input to LIC, in addition to the 2D vector field, usually with the same size as that of the 2D vetor field) to determine the values (colors) of these pixels (the starting and the correlated pixels), typically through bi-linear interpolation, and (4) performing convolution (weighted averaging) on these values, by adopting a low-pass filter (such as box, ramp, and Hanning kernels), to obtain the result value (color) that is then assigned to the seed pixel.
The GLSL-based GPU implementation herein maps the aforementioned pipeline to fragment shaders and a box kernel is employed. Both the white noise and the vector field are provided to the GPU as texture objects (supported by the multi-texturing capability). In addition, there are four texture objects (color buffers) allocated to constitute two pairs that work in a ping-pong fashion, with one as the read buffers and the other as the write / render targets. Maintained by a frame buffer object (GL_EXT_framebuffer_object), each pair employs one buffer to store the current (dynamically updated) position (by means of the texture coordinate that keeps being warped by the underlying vector) of the (virtual) particle initially released from each fragment while using the bother buffer to store the current (dynamically updated too) accumulated texture value that each seed fragment (before the 'mesh' is warped) collects. Given NumberOfSteps integration steps in each direction, there are a total of (2 * NumberOfSteps + 1) fragments (including the seed fragment) are convolved and each contributes 1 / (2 * NumberOfSteps
One pass of LIC (basic LIC) tends to produce low-contrast / blurred images and vtkLineIntegralConvolution2D provides an option for creating enhanced LIC images. Enhanced LIC improves image quality by increasing inter-streamline contrast while suppressing artifacts. It performs two passes of LIC, with a 3x3 Laplacian high-pass filter in between that processes the output of pass #1 LIC and forwards the result as the input 'noise' to pass #2 LIC. Enhanced LIC automatically degenerates to basic LIC during user interaction.
vtkLineIntegralConvolution2D applies masking to zero-vector fragments so that un-filtered white noise areas are made totally transparent by class vtkSurfaceLICPainter to show the underlying geometry surface.
Definition at line 86 of file vtkLineIntegralConvolution2D.h.
Definition at line 91 of file vtkLineIntegralConvolution2D.h.
|
protected |
|
protected |
|
static |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on.
Reimplemented from vtkObject.
|
virtual |
Reimplemented from vtkObject.
|
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.
|
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.
|
static |
Reimplemented from vtkObject.
|
virtual |
|
virtual |
Enable/Disable enhanced LIC that improves image quality by increasing inter-streamline contrast while suppressing artifacts. Enhanced LIC performs two passes of LIC, with a 3x3 Laplacian high-pass filter in between that processes the output of pass #1 LIC and forwards the result as the input 'noise' to pass #2 LIC. This flag is automatically turned off during user interaction.
|
virtual |
Enable/Disable enhanced LIC that improves image quality by increasing inter-streamline contrast while suppressing artifacts. Enhanced LIC performs two passes of LIC, with a 3x3 Laplacian high-pass filter in between that processes the output of pass #1 LIC and forwards the result as the input 'noise' to pass #2 LIC. This flag is automatically turned off during user interaction.
|
virtual |
Enable/Disable enhanced LIC that improves image quality by increasing inter-streamline contrast while suppressing artifacts. Enhanced LIC performs two passes of LIC, with a 3x3 Laplacian high-pass filter in between that processes the output of pass #1 LIC and forwards the result as the input 'noise' to pass #2 LIC. This flag is automatically turned off during user interaction.
|
virtual |
Enable/Disable enhanced LIC that improves image quality by increasing inter-streamline contrast while suppressing artifacts. Enhanced LIC performs two passes of LIC, with a 3x3 Laplacian high-pass filter in between that processes the output of pass #1 LIC and forwards the result as the input 'noise' to pass #2 LIC. This flag is automatically turned off during user interaction.
|
virtual |
Enable/Disable LICForSurface, for which the LIC texture is composited with the underlying geometry.
|
virtual |
Enable/Disable LICForSurface, for which the LIC texture is composited with the underlying geometry.
|
virtual |
Enable/Disable LICForSurface, for which the LIC texture is composited with the underlying geometry.
|
virtual |
Enable/Disable LICForSurface, for which the LIC texture is composited with the underlying geometry.
|
virtual |
Number of streamline integration steps (initial value is 1). In term of visual quality, the greater (within some range) the better.
|
virtual |
Number of streamline integration steps (initial value is 1). In term of visual quality, the greater (within some range) the better.
|
virtual |
Get/Set the streamline integration step size (0.01 by default). This is the length of each step in normalized image space i.e. in range [0, 1]. In term of visual quality, the smaller the better. The type for the interface is double as VTK interface is, but GPU only supports float. Thus it will be converted to float in the execution of the algorithm.
|
virtual |
Get/Set the streamline integration step size (0.01 by default). This is the length of each step in normalized image space i.e. in range [0, 1]. In term of visual quality, the smaller the better. The type for the interface is double as VTK interface is, but GPU only supports float. Thus it will be converted to float in the execution of the algorithm.
void vtkLineIntegralConvolution2D::SetNoise | ( | vtkTextureObject * | noise | ) |
Set/Get the input white noise texture (initial value is NULL).
|
virtual |
Set/Get the input white noise texture (initial value is NULL).
void vtkLineIntegralConvolution2D::SetVectorField | ( | vtkTextureObject * | vectorField | ) |
Set/Get the vector field (initial value is NULL).
|
virtual |
Set/Get the vector field (initial value is NULL).
|
virtual |
If VectorField has >= 3 components, we must choose which 2 components form the (X, Y) components for the vector field. Must be in the range [0, 3].
void vtkLineIntegralConvolution2D::SetComponentIds | ( | int | [2] | ) |
If VectorField has >= 3 components, we must choose which 2 components form the (X, Y) components for the vector field. Must be in the range [0, 3].
|
virtual |
If VectorField has >= 3 components, we must choose which 2 components form the (X, Y) components for the vector field. Must be in the range [0, 3].
|
virtual |
If VectorField has >= 3 components, we must choose which 2 components form the (X, Y) components for the vector field. Must be in the range [0, 3].
|
virtual |
If VectorField has >= 3 components, we must choose which 2 components form the (X, Y) components for the vector field. Must be in the range [0, 3].
|
virtual |
Set/Get the spacing in each dimension of the plane on which the vector field is defined. This class performs LIC in the normalized image space and hence generally it needs to transform the input vector field (given in physical space) to the normalized image space. The Spacing is needed to determine the tranform. Default is (1.0, 1.0). It is possible to disable vector transformation by setting TransformVectors to 0.
void vtkLineIntegralConvolution2D::SetGridSpacings | ( | double | [2] | ) |
Set/Get the spacing in each dimension of the plane on which the vector field is defined. This class performs LIC in the normalized image space and hence generally it needs to transform the input vector field (given in physical space) to the normalized image space. The Spacing is needed to determine the tranform. Default is (1.0, 1.0). It is possible to disable vector transformation by setting TransformVectors to 0.
|
virtual |
Set/Get the spacing in each dimension of the plane on which the vector field is defined. This class performs LIC in the normalized image space and hence generally it needs to transform the input vector field (given in physical space) to the normalized image space. The Spacing is needed to determine the tranform. Default is (1.0, 1.0). It is possible to disable vector transformation by setting TransformVectors to 0.
|
virtual |
Set/Get the spacing in each dimension of the plane on which the vector field is defined. This class performs LIC in the normalized image space and hence generally it needs to transform the input vector field (given in physical space) to the normalized image space. The Spacing is needed to determine the tranform. Default is (1.0, 1.0). It is possible to disable vector transformation by setting TransformVectors to 0.
|
virtual |
Set/Get the spacing in each dimension of the plane on which the vector field is defined. This class performs LIC in the normalized image space and hence generally it needs to transform the input vector field (given in physical space) to the normalized image space. The Spacing is needed to determine the tranform. Default is (1.0, 1.0). It is possible to disable vector transformation by setting TransformVectors to 0.
|
virtual |
This class performs LIC in the normalized image space. Hence, by default it transforms the input vectors to the normalized image space (using the GridSpacings and input vector field dimensions). Set this to 0 to disable tranformation if the vectors are already tranformed.
|
virtual |
This class performs LIC in the normalized image space. Hence, by default it transforms the input vectors to the normalized image space (using the GridSpacings and input vector field dimensions). Set this to 0 to disable tranformation if the vectors are already tranformed.
|
virtual |
This class performs LIC in the normalized image space. Hence, by default it transforms the input vectors to the normalized image space (using the GridSpacings and input vector field dimensions). Set this to 0 to disable tranformation if the vectors are already tranformed.
|
virtual |
This class performs LIC in the normalized image space. Hence, by default it transforms the input vectors to the normalized image space (using the GridSpacings and input vector field dimensions). Set this to 0 to disable tranformation if the vectors are already tranformed.
|
virtual |
The the magnification factor (default is 1.0).
|
virtual |
The the magnification factor (default is 1.0).
|
inline |
On machines where the vector field texture is clamped between [0,1], one can specify the shift/scale factor used to convert the original vector field to lie in the clamped range. Default is (0.0, 1.0);
Definition at line 184 of file vtkLineIntegralConvolution2D.h.
|
static |
Returns if the context supports the required extensions.
int vtkLineIntegralConvolution2D::Execute | ( | ) |
Perform the LIC and obtain the LIC texture. Return 1 if no error.
int vtkLineIntegralConvolution2D::Execute | ( | unsigned int | extent[4] | ) |
Same as Execute() except that the LIC operation is performed only on a window (given by the extent
) in the input VectorField. The extent
is relative to the input VectorField. The output LIC image will be of the size specified by extent.
int vtkLineIntegralConvolution2D::Execute | ( | int | extent[4] | ) |
Same as Execute() except that the LIC operation is performed only on a window (given by the extent
) in the input VectorField. The extent
is relative to the input VectorField. The output LIC image will be of the size specified by extent.
void vtkLineIntegralConvolution2D::SetLIC | ( | vtkTextureObject * | lic | ) |
LIC texture (initial value is NULL) set by Execute().
|
virtual |
LIC texture (initial value is NULL) set by Execute().
|
protected |
Definition at line 217 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 218 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 219 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 220 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 221 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 222 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 223 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 225 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 226 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 227 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 229 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 230 of file vtkLineIntegralConvolution2D.h.
|
protected |
Definition at line 231 of file vtkLineIntegralConvolution2D.h.