painter that performs LIC on the surface of arbitrary geometry. More...
#include <vtkSurfaceLICPainter.h>
Detailed Description
painter that performs LIC on the surface of arbitrary geometry.
vtkSurfaceLICPainter painter performs LIC on the surface of arbitrary geometry. Point vectors are used as the vector field for generating the LIC. The implementation was originallu based on "Image Space Based Visualization on Unsteady Flow on Surfaces" by Laramee, Jobard and Hauser appeared in proceedings of IEEE Visualization '03, pages 131-138.
Internal pipeline:
noise
|
[ PROJ (GAT) (COMP) LIC2D (SCAT) SHADE (CCE) DEP]
| |
vectors surface LIC
PROj - prject vectors onto surface GAT - gather data for compositing and guard pixel generation (parallel only) COMP - composite gathered data LIC2D - line intengral convolution, see vtkLineIntegralConvolution2D. SCAT - scatter result (parallel only, not all compositors use it) SHADE - combine LIC and scalar colors CCE - color contrast enhancement (optional) DEP - depth test and copy to back buffer
The result of each stage is cached in a texture so that during interaction a stage may be skipped if the user has not modified its paramters or input data.
The parallel parts of algorithm are implemented in vtkPSurfaceLICPainter. Note that for MPI enabled builds this class will be automatically created by the object factory.
Definition at line 72 of file vtkSurfaceLICPainter.h.
Member Typedef Documentation
Reimplemented from vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
Definition at line 76 of file vtkSurfaceLICPainter.h.
Member Enumeration Documentation
| anonymous enum |
Enable/Disable contrast and dynamic range correction stages. Contrast enhancement can be enabled during LIC computations (See vtkLineINtegralComvolution2D) and after the scalar colors have been combined with the LIC. The best appraoch for using this feature is to enable LIC enhancement, and only if the image is to dark or dull enable COLOR enhancement. Both stages are implemented by a histogram stretching algorithm. During LIC stages the contrast enhancement is applied to gray scale LIC image. During the scalar coloring stage the contrast enhancement is applied to the lightness channel of the color image in HSL color space. The histogram stretching is implemented as follows: L = (L-m)/(M-m) where, L is the fragment intensity/lightness, m is the intensity/lightness to map to 0, M is the intensity/lightness to map to 1. The default values of m and M are the min and max taken over all fragments. This increase the dynamic range and contrast in the LIC'd image, both of which are natuarly attenuated by the convolution proccess. Values ENHANCE_CONTRAST_OFF -- don't enhance LIC or scalar colors ENHANCE_CONTRAST_LIC -- enhance in LIC high-pass input and output ENHANCE_CONTRAST_COLOR -- enhance after scalars are combined with LIC ENHANCE_CONTRAST_BOTH -- enhance in LIC stages and after scalar colors This feature is disabled by default.
Definition at line 211 of file vtkSurfaceLICPainter.h.
| anonymous enum |
Set/Get the color mode. The color mode controls how scalar colors are combined with the LIC in the final image. The BLEND mode combines scalar colors with LIC intensities with proportional blending controled by the LICIntensity parameter. The MAP mode combines scalar colors with LIC, by multiplication the HSL represntation of color's lightness. The default is COLOR_MODE_BLEND.
Definition at line 262 of file vtkSurfaceLICPainter.h.
| anonymous enum |
Select the statistical distribution of randomly generated noise values. With uniform noise there is greater control over the range of values in the noise texture. The Default is NOISE_TYPE_GAUSSIAN.
Definition at line 323 of file vtkSurfaceLICPainter.h.
| anonymous enum |
Control the screen space decomposition where LIC is computed.
Definition at line 387 of file vtkSurfaceLICPainter.h.
Constructor & Destructor Documentation
| vtkSurfaceLICPainter::vtkSurfaceLICPainter | ( | ) | [protected] |
| vtkSurfaceLICPainter::~vtkSurfaceLICPainter | ( | ) | [protected] |
Member Function Documentation
| static vtkSurfaceLICPainter* vtkSurfaceLICPainter::New | ( | ) | [static] |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on.
Reimplemented from vtkObject.
Reimplemented in vtkPSurfaceLICPainter.
| static int vtkSurfaceLICPainter::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 vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
| virtual int vtkSurfaceLICPainter::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 vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
| static vtkSurfaceLICPainter* vtkSurfaceLICPainter::SafeDownCast | ( | vtkObjectBase * | o | ) | [static] |
Reimplemented from vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
| virtual vtkObjectBase* vtkSurfaceLICPainter::NewInstanceInternal | ( | ) | const [protected, virtual] |
Reimplemented from vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
Reimplemented from vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
| void vtkSurfaceLICPainter::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 vtkPainter.
Reimplemented in vtkPSurfaceLICPainter.
| virtual void vtkSurfaceLICPainter::ReleaseGraphicsResources | ( | vtkWindow * | win | ) | [virtual] |
Release any graphics resources that are being consumed by this mapper. The parameter window could be used to determine which graphic resources to release. In this case, releases the display lists.
Reimplemented from vtkPainter.
| virtual vtkDataObject* vtkSurfaceLICPainter::GetOutput | ( | ) | [virtual] |
Get the output data object from this painter. Overridden to pass the input points (or cells) vectors as the tcoords to the deletage painters. This is required by the internal GLSL shader programs used for generating LIC.
Reimplemented from vtkPainter.
| void vtkSurfaceLICPainter::SetEnable | ( | int | val | ) |
Enable/Disable this painter.
| virtual int vtkSurfaceLICPainter::GetEnable | ( | ) | [virtual] |
Enable/Disable this painter.
| void vtkSurfaceLICPainter::SetEnableOn | ( | ) | [inline] |
Enable/Disable this painter.
Definition at line 94 of file vtkSurfaceLICPainter.h.
| void vtkSurfaceLICPainter::SetEnableOff | ( | ) | [inline] |
Enable/Disable this painter.
Definition at line 95 of file vtkSurfaceLICPainter.h.
| void vtkSurfaceLICPainter::SetInputArrayToProcess | ( | int | fieldAssociation, |
| const char * | name | ||
| ) |
Set the vectors to used for applying LIC. By default point vectors are used. Arguments are same as those passed to vtkAlgorithm::SetInputArrayToProcess except the first 3 arguments i.e. idx, port, connection.
| void vtkSurfaceLICPainter::SetInputArrayToProcess | ( | int | fieldAssociation, |
| int | fieldAttributeType | ||
| ) |
Set the vectors to used for applying LIC. By default point vectors are used. Arguments are same as those passed to vtkAlgorithm::SetInputArrayToProcess except the first 3 arguments i.e. idx, port, connection.
| void vtkSurfaceLICPainter::SetNumberOfSteps | ( | int | val | ) |
Get/Set the number of integration steps in each direction.
| virtual int vtkSurfaceLICPainter::GetNumberOfSteps | ( | ) | [virtual] |
Get/Set the number of integration steps in each direction.
| void vtkSurfaceLICPainter::SetStepSize | ( | double | val | ) |
Get/Set the step size (in pixels).
| virtual double vtkSurfaceLICPainter::GetStepSize | ( | ) | [virtual] |
Get/Set the step size (in pixels).
| void vtkSurfaceLICPainter::SetNormalizeVectors | ( | int | val | ) |
Normalize vectors during integration. When set(the default) the input vector field is normalized during integration, and each integration occurs over the same arclength. When not set each integration occurs over an arc length proportional to the field magnitude as is customary in traditional numerical methods. See, "Imaging Vector Fields Using Line Integral Convolution" for an axample where normalization is used. See, "Image Space Based Visualization of Unsteady Flow on Surfaces" for an example of where no normalization is used.
| virtual void vtkSurfaceLICPainter::NormalizeVectorsOn | ( | ) | [virtual] |
Normalize vectors during integration. When set(the default) the input vector field is normalized during integration, and each integration occurs over the same arclength. When not set each integration occurs over an arc length proportional to the field magnitude as is customary in traditional numerical methods. See, "Imaging Vector Fields Using Line Integral Convolution" for an axample where normalization is used. See, "Image Space Based Visualization of Unsteady Flow on Surfaces" for an example of where no normalization is used.
| virtual void vtkSurfaceLICPainter::NormalizeVectorsOff | ( | ) | [virtual] |
Normalize vectors during integration. When set(the default) the input vector field is normalized during integration, and each integration occurs over the same arclength. When not set each integration occurs over an arc length proportional to the field magnitude as is customary in traditional numerical methods. See, "Imaging Vector Fields Using Line Integral Convolution" for an axample where normalization is used. See, "Image Space Based Visualization of Unsteady Flow on Surfaces" for an example of where no normalization is used.
| virtual int vtkSurfaceLICPainter::GetNormalizeVectors | ( | ) | [virtual] |
Normalize vectors during integration. When set(the default) the input vector field is normalized during integration, and each integration occurs over the same arclength. When not set each integration occurs over an arc length proportional to the field magnitude as is customary in traditional numerical methods. See, "Imaging Vector Fields Using Line Integral Convolution" for an axample where normalization is used. See, "Image Space Based Visualization of Unsteady Flow on Surfaces" for an example of where no normalization is used.
| void vtkSurfaceLICPainter::SetMaskOnSurface | ( | int | val | ) |
When set MaskOnSurface computes |V| for use in the fragment masking tests on the surface. When not set the original un-projected un-transformed |V| is used.
| virtual void vtkSurfaceLICPainter::MaskOnSurfaceOn | ( | ) | [virtual] |
When set MaskOnSurface computes |V| for use in the fragment masking tests on the surface. When not set the original un-projected un-transformed |V| is used.
| virtual void vtkSurfaceLICPainter::MaskOnSurfaceOff | ( | ) | [virtual] |
When set MaskOnSurface computes |V| for use in the fragment masking tests on the surface. When not set the original un-projected un-transformed |V| is used.
| virtual int vtkSurfaceLICPainter::GetMaskOnSurface | ( | ) | [virtual] |
When set MaskOnSurface computes |V| for use in the fragment masking tests on the surface. When not set the original un-projected un-transformed |V| is used.
| void vtkSurfaceLICPainter::SetMaskThreshold | ( | double | val | ) |
The MaskThreshold controls the rendering of fragments in stagnant regions of flow. // In these regions LIC noise texture will be masked, where |V| < MaskThreshold is satisifed. The masking process blends a the MaskColor with the scalar color of the surface proportional to MaskIntesnsity. See MaskIntensity for more information on the blending algorithm. This blending allows one control over the masking process so that masked fragments may be: highlighted (by setting a unique mask color and mask intensity > 0), made invisible with and without passing the un-convolved noise texture (by setting mask intensity 0), made to blend into the LIC. MaskThreshold units are in the original vector space. Note that the threshold can be applied to the original vector field or to the surface projected vector field. See MaskOnSurface.
| virtual double vtkSurfaceLICPainter::GetMaskThreshold | ( | ) | [virtual] |
The MaskThreshold controls the rendering of fragments in stagnant regions of flow. // In these regions LIC noise texture will be masked, where |V| < MaskThreshold is satisifed. The masking process blends a the MaskColor with the scalar color of the surface proportional to MaskIntesnsity. See MaskIntensity for more information on the blending algorithm. This blending allows one control over the masking process so that masked fragments may be: highlighted (by setting a unique mask color and mask intensity > 0), made invisible with and without passing the un-convolved noise texture (by setting mask intensity 0), made to blend into the LIC. MaskThreshold units are in the original vector space. Note that the threshold can be applied to the original vector field or to the surface projected vector field. See MaskOnSurface.
| void vtkSurfaceLICPainter::SetMaskColor | ( | double * | val | ) |
The MaskColor is used on masked fragments. The default of (0.5, 0.5, 0.5) makes the masked fragments look similar to the LIC'd fragments. The mask color is applied only when MaskIntensity > 0.
| void vtkSurfaceLICPainter::SetMaskColor | ( | double | r, |
| double | g, | ||
| double | b | ||
| ) | [inline] |
The MaskColor is used on masked fragments. The default of (0.5, 0.5, 0.5) makes the masked fragments look similar to the LIC'd fragments. The mask color is applied only when MaskIntensity > 0.
Definition at line 166 of file vtkSurfaceLICPainter.h.
| virtual double* vtkSurfaceLICPainter::GetMaskColor | ( | ) | [virtual] |
The MaskColor is used on masked fragments. The default of (0.5, 0.5, 0.5) makes the masked fragments look similar to the LIC'd fragments. The mask color is applied only when MaskIntensity > 0.
| virtual void vtkSurfaceLICPainter::GetMaskColor | ( | double & | , |
| double & | , | ||
| double & | |||
| ) | [virtual] |
The MaskColor is used on masked fragments. The default of (0.5, 0.5, 0.5) makes the masked fragments look similar to the LIC'd fragments. The mask color is applied only when MaskIntensity > 0.
| virtual void vtkSurfaceLICPainter::GetMaskColor | ( | double | [3] | ) | [virtual] |
The MaskColor is used on masked fragments. The default of (0.5, 0.5, 0.5) makes the masked fragments look similar to the LIC'd fragments. The mask color is applied only when MaskIntensity > 0.
| void vtkSurfaceLICPainter::SetMaskIntensity | ( | double | val | ) |
The MaskIntensity controls the blending of the mask color and the geometry color. The color of masked fragments is given by: c = maskColor * maskIntensity + geomColor * (1 - maskIntensity) The default value of 0.0 results in the geometry color being used.
| virtual double vtkSurfaceLICPainter::GetMaskIntensity | ( | ) | [virtual] |
The MaskIntensity controls the blending of the mask color and the geometry color. The color of masked fragments is given by: c = maskColor * maskIntensity + geomColor * (1 - maskIntensity) The default value of 0.0 results in the geometry color being used.
| void vtkSurfaceLICPainter::SetEnhancedLIC | ( | int | val | ) |
EnhancedLIC mean compute the LIC twice with the second pass using the edge-enhanced result of the first pass as a noise texture. Edge enhancedment is made by a simple Laplace convolution.
| virtual int vtkSurfaceLICPainter::GetEnhancedLIC | ( | ) | [virtual] |
EnhancedLIC mean compute the LIC twice with the second pass using the edge-enhanced result of the first pass as a noise texture. Edge enhancedment is made by a simple Laplace convolution.
| virtual void vtkSurfaceLICPainter::EnhancedLICOn | ( | ) | [virtual] |
EnhancedLIC mean compute the LIC twice with the second pass using the edge-enhanced result of the first pass as a noise texture. Edge enhancedment is made by a simple Laplace convolution.
| virtual void vtkSurfaceLICPainter::EnhancedLICOff | ( | ) | [virtual] |
EnhancedLIC mean compute the LIC twice with the second pass using the edge-enhanced result of the first pass as a noise texture. Edge enhancedment is made by a simple Laplace convolution.
| void vtkSurfaceLICPainter::SetEnhanceContrast | ( | int | val | ) |
Enable/Disable contrast and dynamic range correction stages. Contrast enhancement can be enabled during LIC computations (See vtkLineINtegralComvolution2D) and after the scalar colors have been combined with the LIC. The best appraoch for using this feature is to enable LIC enhancement, and only if the image is to dark or dull enable COLOR enhancement. Both stages are implemented by a histogram stretching algorithm. During LIC stages the contrast enhancement is applied to gray scale LIC image. During the scalar coloring stage the contrast enhancement is applied to the lightness channel of the color image in HSL color space. The histogram stretching is implemented as follows: L = (L-m)/(M-m) where, L is the fragment intensity/lightness, m is the intensity/lightness to map to 0, M is the intensity/lightness to map to 1. The default values of m and M are the min and max taken over all fragments. This increase the dynamic range and contrast in the LIC'd image, both of which are natuarly attenuated by the convolution proccess. Values ENHANCE_CONTRAST_OFF -- don't enhance LIC or scalar colors ENHANCE_CONTRAST_LIC -- enhance in LIC high-pass input and output ENHANCE_CONTRAST_COLOR -- enhance after scalars are combined with LIC ENHANCE_CONTRAST_BOTH -- enhance in LIC stages and after scalar colors This feature is disabled by default.
| virtual int vtkSurfaceLICPainter::GetEnhanceContrast | ( | ) | [virtual] |
Enable/Disable contrast and dynamic range correction stages. Contrast enhancement can be enabled during LIC computations (See vtkLineINtegralComvolution2D) and after the scalar colors have been combined with the LIC. The best appraoch for using this feature is to enable LIC enhancement, and only if the image is to dark or dull enable COLOR enhancement. Both stages are implemented by a histogram stretching algorithm. During LIC stages the contrast enhancement is applied to gray scale LIC image. During the scalar coloring stage the contrast enhancement is applied to the lightness channel of the color image in HSL color space. The histogram stretching is implemented as follows: L = (L-m)/(M-m) where, L is the fragment intensity/lightness, m is the intensity/lightness to map to 0, M is the intensity/lightness to map to 1. The default values of m and M are the min and max taken over all fragments. This increase the dynamic range and contrast in the LIC'd image, both of which are natuarly attenuated by the convolution proccess. Values ENHANCE_CONTRAST_OFF -- don't enhance LIC or scalar colors ENHANCE_CONTRAST_LIC -- enhance in LIC high-pass input and output ENHANCE_CONTRAST_COLOR -- enhance after scalars are combined with LIC ENHANCE_CONTRAST_BOTH -- enhance in LIC stages and after scalar colors This feature is disabled by default.
| virtual double vtkSurfaceLICPainter::GetLowLICContrastEnhancementFactor | ( | ) | [virtual] |
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
| virtual double vtkSurfaceLICPainter::GetHighLICContrastEnhancementFactor | ( | ) | [virtual] |
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
| virtual double vtkSurfaceLICPainter::GetLowColorContrastEnhancementFactor | ( | ) | [virtual] |
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
| virtual double vtkSurfaceLICPainter::GetHighColorContrastEnhancementFactor | ( | ) | [virtual] |
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
This feature is used to fine tune the contrast enhancement. There are two modes AUTOMATIC and MANUAL.In AUTOMATIC mode values are provided indicating the fraction of the range to adjust M and m by, during contrast enahncement histogram stretching. M and m are the intensity/lightness values that map to 1 and 0. (see EnhanceContrast for an explanation of the mapping procedure). m and M are computed using the factors as follows: m = min(C) + mFactor * (max(C) - min(C)) M = max(C) - MFactor * (max(C) - min(C)) the default values for mFactor and MFactor are 0 which result in m = min(C), M = max(C), taken over the entire image. Modifying mFactor and MFactor above or below zero provide control over the saturation/ de-saturation during contrast enhancement.
| void vtkSurfaceLICPainter::SetAntiAlias | ( | int | val | ) |
Enable/Disable the anti-aliasing pass. This optional pass (disabled by default) can be enabled to reduce jagged patterns in the final LIC image. Values greater than 0 control the number of iterations, 1 is typically sufficient.
| virtual void vtkSurfaceLICPainter::AntiAliasOn | ( | ) | [virtual] |
Enable/Disable the anti-aliasing pass. This optional pass (disabled by default) can be enabled to reduce jagged patterns in the final LIC image. Values greater than 0 control the number of iterations, 1 is typically sufficient.
| virtual void vtkSurfaceLICPainter::AntiAliasOff | ( | ) | [virtual] |
Enable/Disable the anti-aliasing pass. This optional pass (disabled by default) can be enabled to reduce jagged patterns in the final LIC image. Values greater than 0 control the number of iterations, 1 is typically sufficient.
| virtual int vtkSurfaceLICPainter::GetAntiAlias | ( | ) | [virtual] |
Enable/Disable the anti-aliasing pass. This optional pass (disabled by default) can be enabled to reduce jagged patterns in the final LIC image. Values greater than 0 control the number of iterations, 1 is typically sufficient.
| void vtkSurfaceLICPainter::SetColorMode | ( | int | val | ) |
Set/Get the color mode. The color mode controls how scalar colors are combined with the LIC in the final image. The BLEND mode combines scalar colors with LIC intensities with proportional blending controled by the LICIntensity parameter. The MAP mode combines scalar colors with LIC, by multiplication the HSL represntation of color's lightness. The default is COLOR_MODE_BLEND.
| virtual int vtkSurfaceLICPainter::GetColorMode | ( | ) | [virtual] |
Set/Get the color mode. The color mode controls how scalar colors are combined with the LIC in the final image. The BLEND mode combines scalar colors with LIC intensities with proportional blending controled by the LICIntensity parameter. The MAP mode combines scalar colors with LIC, by multiplication the HSL represntation of color's lightness. The default is COLOR_MODE_BLEND.
| void vtkSurfaceLICPainter::SetLICIntensity | ( | double | val | ) |
Factor used when blend mode is set to COLOR_MODE_BLEND. This controls the contribution of the LIC in the final output image as follows: c = LIC * LICIntensity + scalar * (1 - LICIntensity); 0.0 produces same result as disabling LIC altogether, while 1.0 implies show LIC result alone.
| virtual double vtkSurfaceLICPainter::GetLICIntensity | ( | ) | [virtual] |
Factor used when blend mode is set to COLOR_MODE_BLEND. This controls the contribution of the LIC in the final output image as follows: c = LIC * LICIntensity + scalar * (1 - LICIntensity); 0.0 produces same result as disabling LIC altogether, while 1.0 implies show LIC result alone.
| void vtkSurfaceLICPainter::SetMapModeBias | ( | double | val | ) |
Factor used when blend mode is set to COLOR_MODE_MAP. This adds a bias to the LIC image. The purpose of this is to adjust the brightness when a brighter image is desired. The default of 0.0 results in no change. Values gretaer than 0.0 will brighten the image while values less than 0.0 darken the image.
| virtual double vtkSurfaceLICPainter::GetMapModeBias | ( | ) | [virtual] |
Factor used when blend mode is set to COLOR_MODE_MAP. This adds a bias to the LIC image. The purpose of this is to adjust the brightness when a brighter image is desired. The default of 0.0 results in no change. Values gretaer than 0.0 will brighten the image while values less than 0.0 darken the image.
| void vtkSurfaceLICPainter::SetNoiseDataSet | ( | vtkImageData * | data | ) |
Set the data containing a noise array as active scalars. Active scalars array will be converted into a texture for use as noise in the LIC process. Noise datasets are expected to be gray scale.
Set the data containing a noise array as active scalars. Active scalars array will be converted into a texture for use as noise in the LIC process. Noise datasets are expected to be gray scale.
| void vtkSurfaceLICPainter::SetGenerateNoiseTexture | ( | int | shouldGenerate | ) |
Set/Get the noise texture source. When not set the default 200x200 white noise texture is used (see VTKData/Data/Data/noise.png). When set a noise texture is generated based on the following parameters: NoiseType - select noise type. Gaussian, Uniform, etc NoiseTextureSize - number of pixels in square noise texture(side) NoiseGrainSize - number of pixels each noise value spans(side) MinNoiseValue - minimum noise color >=0 && < MaxNoiseValue MaxNoiseValue - maximum noise color <=1
MinNoiseValue NumberOfNoiseLevels - number of discrete noise
colors ImpulseNoiseProbability - impulse noise is generated when < 1 ImpulseNoiseBackgroundValue - the background color for untouched pixels NoiseGeneratorSeed - seed the random number generators Changing the noise texture gives one greater control over the look of the final image. The default is 0 which results in the use of a static 200x200 Gaussian noise texture. See VTKData/Data/Data/noise.png.
| virtual int vtkSurfaceLICPainter::GetGenerateNoiseTexture | ( | ) | [virtual] |
Set/Get the noise texture source. When not set the default 200x200 white noise texture is used (see VTKData/Data/Data/noise.png). When set a noise texture is generated based on the following parameters: NoiseType - select noise type. Gaussian, Uniform, etc NoiseTextureSize - number of pixels in square noise texture(side) NoiseGrainSize - number of pixels each noise value spans(side) MinNoiseValue - minimum noise color >=0 && < MaxNoiseValue MaxNoiseValue - maximum noise color <=1
MinNoiseValue NumberOfNoiseLevels - number of discrete noise
colors ImpulseNoiseProbability - impulse noise is generated when < 1 ImpulseNoiseBackgroundValue - the background color for untouched pixels NoiseGeneratorSeed - seed the random number generators Changing the noise texture gives one greater control over the look of the final image. The default is 0 which results in the use of a static 200x200 Gaussian noise texture. See VTKData/Data/Data/noise.png.
| void vtkSurfaceLICPainter::SetNoiseType | ( | int | type | ) |
Select the statistical distribution of randomly generated noise values. With uniform noise there is greater control over the range of values in the noise texture. The Default is NOISE_TYPE_GAUSSIAN.
| virtual int vtkSurfaceLICPainter::GetNoiseType | ( | ) | [virtual] |
Select the statistical distribution of randomly generated noise values. With uniform noise there is greater control over the range of values in the noise texture. The Default is NOISE_TYPE_GAUSSIAN.
| void vtkSurfaceLICPainter::SetNoiseTextureSize | ( | int | length | ) |
Set/Get the side length in pixels of the noise texture. The texture will be length^2 pixels in area.
| virtual int vtkSurfaceLICPainter::GetNoiseTextureSize | ( | ) | [virtual] |
Set/Get the side length in pixels of the noise texture. The texture will be length^2 pixels in area.
| void vtkSurfaceLICPainter::SetNoiseGrainSize | ( | int | val | ) |
Set/Get the side length in pixels of the noise values in the noise texture. Each noise value will be length^2 pixels in area.
| virtual int vtkSurfaceLICPainter::GetNoiseGrainSize | ( | ) | [virtual] |
Set/Get the side length in pixels of the noise values in the noise texture. Each noise value will be length^2 pixels in area.
| void vtkSurfaceLICPainter::SetMinNoiseValue | ( | double | val | ) |
Set/Get the minimum and mximum gray scale values that the generated noise can take on. The generated noise will be in the range of MinNoiseValue to MaxNoiseValue. Values are clamped within 0 to 1. MinNoiseValue must be less than MaxNoiseValue.
| void vtkSurfaceLICPainter::SetMaxNoiseValue | ( | double | val | ) |
Set/Get the minimum and mximum gray scale values that the generated noise can take on. The generated noise will be in the range of MinNoiseValue to MaxNoiseValue. Values are clamped within 0 to 1. MinNoiseValue must be less than MaxNoiseValue.
| virtual double vtkSurfaceLICPainter::GetMinNoiseValue | ( | ) | [virtual] |
Set/Get the minimum and mximum gray scale values that the generated noise can take on. The generated noise will be in the range of MinNoiseValue to MaxNoiseValue. Values are clamped within 0 to 1. MinNoiseValue must be less than MaxNoiseValue.
| virtual double vtkSurfaceLICPainter::GetMaxNoiseValue | ( | ) | [virtual] |
Set/Get the minimum and mximum gray scale values that the generated noise can take on. The generated noise will be in the range of MinNoiseValue to MaxNoiseValue. Values are clamped within 0 to 1. MinNoiseValue must be less than MaxNoiseValue.
| void vtkSurfaceLICPainter::SetNumberOfNoiseLevels | ( | int | val | ) |
Set/Get the number of discrete values a noise pixel may take on. Default 1024.
| virtual int vtkSurfaceLICPainter::GetNumberOfNoiseLevels | ( | ) | [virtual] |
Set/Get the number of discrete values a noise pixel may take on. Default 1024.
Control the density of of the noise. A value of 1.0 produces uniform random noise while values < 1.0 produce impulse noise with the given probabilty.
| virtual double vtkSurfaceLICPainter::GetImpulseNoiseProbability | ( | ) | [virtual] |
Control the density of of the noise. A value of 1.0 produces uniform random noise while values < 1.0 produce impulse noise with the given probabilty.
The color to use for untouched pixels when impulse noise probability < 1.
| virtual double vtkSurfaceLICPainter::GetImpulseNoiseBackgroundValue | ( | ) | [virtual] |
The color to use for untouched pixels when impulse noise probability < 1.
| void vtkSurfaceLICPainter::SetNoiseGeneratorSeed | ( | int | val | ) |
Set/Get the seed value used by the random number generator.
| virtual int vtkSurfaceLICPainter::GetNoiseGeneratorSeed | ( | ) | [virtual] |
Set/Get the seed value used by the random number generator.
| void vtkSurfaceLICPainter::SetCompositeStrategy | ( | int | val | ) |
Control the screen space decomposition where LIC is computed.
| virtual int vtkSurfaceLICPainter::GetCompositeStrategy | ( | ) | [virtual] |
Control the screen space decomposition where LIC is computed.
| static bool vtkSurfaceLICPainter::IsSupported | ( | vtkRenderWindow * | context | ) | [static] |
Returns true if the rendering context supports extensions needed by this painter.
| virtual void vtkSurfaceLICPainter::WriteTimerLog | ( | const char * | ) | [inline, virtual] |
Methods used for parallel benchmarks. Use cmake to define vtkSurfaceLICPainterTIME to enable benchmarks. During each update timing information is stored, it can be written to disk by calling WriteLog.
Reimplemented in vtkPSurfaceLICPainter.
Definition at line 405 of file vtkSurfaceLICPainter.h.
| virtual void vtkSurfaceLICPainter::ProcessInformation | ( | vtkInformation * | info | ) | [protected, virtual] |
Called before RenderInternal() if the Information has been changed since the last time this method was called. We use this to detect when LUT has changed.
Reimplemented from vtkPainter.
| virtual void vtkSurfaceLICPainter::GetGlobalMinMax | ( | vtkPainterCommunicator * | , |
| float & | , | ||
| float & | |||
| ) | [inline, protected, virtual] |
Get the min/max across all ranks. min/max are in/out. In serial operation this is a no-op, in parallel it is a global collective reduction.
Reimplemented in vtkPSurfaceLICPainter.
Definition at line 419 of file vtkSurfaceLICPainter.h.
| virtual void vtkSurfaceLICPainter::StartTimerEvent | ( | const char * | ) | [inline, protected, virtual] |
Methods used for parallel benchmarks. Use cmake to define vtkSurfaceLICPainterTIME to enable benchmarks. During each update timing information is stored, it can be written to disk by calling WriteLog.
Reimplemented in vtkPSurfaceLICPainter.
Definition at line 426 of file vtkSurfaceLICPainter.h.
| virtual void vtkSurfaceLICPainter::EndTimerEvent | ( | const char * | ) | [inline, protected, virtual] |
Methods used for parallel benchmarks. Use cmake to define vtkSurfaceLICPainterTIME to enable benchmarks. During each update timing information is stored, it can be written to disk by calling WriteLog.
Reimplemented in vtkPSurfaceLICPainter.
Definition at line 427 of file vtkSurfaceLICPainter.h.
| virtual vtkPainterCommunicator* vtkSurfaceLICPainter::CreateCommunicator | ( | int | ) | [protected, virtual] |
Creates a new communicator with/without the calling processes as indicated by the passed in flag, if not 0 the calling process is included in the new communicator. In parallel this call is mpi collective on the world communicator. In serial this is a no-op.
Reimplemented in vtkPSurfaceLICPainter.
| void vtkSurfaceLICPainter::CreateCommunicator | ( | ) | [protected] |
Creates a new communicator for internal use based on this rank's visible data.
| void vtkSurfaceLICPainter::GetBounds | ( | vtkDataObject * | data, |
| double | bounds[6] | ||
| ) | [protected] |
Computes data bounds.
| virtual void vtkSurfaceLICPainter::ReportReferences | ( | vtkGarbageCollector * | collector | ) | [protected, virtual] |
Take part in garbage collection.
Reimplemented from vtkPainter.
| void vtkSurfaceLICPainter::UpdateNoiseImage | ( | vtkRenderWindow * | renWin | ) | [protected] |
Updates the noise texture, downsampling by the requested sample rate.
| virtual void vtkSurfaceLICPainter::RenderInternal | ( | vtkRenderer * | renderer, |
| vtkActor * | actor, | ||
| unsigned long | typeflags, | ||
| bool | forceCompileOnly | ||
| ) | [protected, virtual] |
Performs the actual rendering. Subclasses may override this method. default implementation merely call a Render on the DelegatePainter, if any. When RenderInternal() is called, it is assured that the DelegatePainter is in sync with this painter i.e. UpdateDelegatePainter() has been called.
Reimplemented from vtkPainter.
| void vtkSurfaceLICPainter::ValidateContext | ( | vtkRenderer * | renderer | ) | [protected] |
Look for changes that would trigger stage updates
| bool vtkSurfaceLICPainter::NeedToUpdateOutputData | ( | ) | [protected] |
Return false if stage can be skipped
| virtual bool vtkSurfaceLICPainter::NeedToUpdateCommunicator | ( | ) | [protected, virtual] |
Return false if stage can be skipped
Reimplemented in vtkPSurfaceLICPainter.
| bool vtkSurfaceLICPainter::NeedToRenderGeometry | ( | vtkRenderer * | renderer, |
| vtkActor * | actor | ||
| ) | [protected] |
Return false if stage can be skipped
| bool vtkSurfaceLICPainter::NeedToGatherVectors | ( | ) | [protected] |
Return false if stage can be skipped
| bool vtkSurfaceLICPainter::NeedToComputeLIC | ( | ) | [protected] |
Return false if stage can be skipped
| bool vtkSurfaceLICPainter::NeedToColorLIC | ( | ) | [protected] |
Return false if stage can be skipped
| void vtkSurfaceLICPainter::SetUpdateAll | ( | ) | [protected] |
Return false if stage can be skipped
| bool vtkSurfaceLICPainter::PrepareOutput | ( | ) | [protected] |
resoucre allocators
| void vtkSurfaceLICPainter::InitializeResources | ( | ) | [protected] |
resoucre allocators
| bool vtkSurfaceLICPainter::VectorsToTCoords | ( | vtkDataObject * | dataObj | ) | [protected] |
set tcoords with vectors
| bool vtkSurfaceLICPainter::VectorsToTCoords | ( | vtkDataSet * | dataObj | ) | [protected] |
set tcoords with vectors
| void vtkSurfaceLICPainter::ClearTCoords | ( | vtkDataSet * | data | ) | [protected] |
set tcoords with vectors
| bool vtkSurfaceLICPainter::CanRenderSurfaceLIC | ( | vtkActor * | actor, |
| int | typeflags | ||
| ) | [protected] |
Returns true when rendering LIC is possible.
Member Data Documentation
int vtkSurfaceLICPainter::NumberOfSteps [protected] |
Definition at line 495 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::StepSize [protected] |
Definition at line 496 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NormalizeVectors [protected] |
Definition at line 497 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::EnhancedLIC [protected] |
Definition at line 499 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::EnhanceContrast [protected] |
Definition at line 500 of file vtkSurfaceLICPainter.h.
Definition at line 501 of file vtkSurfaceLICPainter.h.
Definition at line 502 of file vtkSurfaceLICPainter.h.
Definition at line 503 of file vtkSurfaceLICPainter.h.
Definition at line 504 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::AntiAlias [protected] |
Definition at line 505 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::MaskOnSurface [protected] |
Definition at line 507 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MaskThreshold [protected] |
Definition at line 508 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MaskIntensity [protected] |
Definition at line 509 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MaskColor[3] [protected] |
Definition at line 510 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::ColorMode [protected] |
Definition at line 512 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::LICIntensity [protected] |
Definition at line 513 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MapModeBias [protected] |
Definition at line 514 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::GenerateNoiseTexture [protected] |
Definition at line 516 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NoiseType [protected] |
Definition at line 517 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NoiseTextureSize [protected] |
Definition at line 518 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NoiseGrainSize [protected] |
Definition at line 519 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MinNoiseValue [protected] |
Definition at line 520 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::MaxNoiseValue [protected] |
Definition at line 521 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NumberOfNoiseLevels [protected] |
Definition at line 522 of file vtkSurfaceLICPainter.h.
double vtkSurfaceLICPainter::ImpulseNoiseProbability [protected] |
Definition at line 523 of file vtkSurfaceLICPainter.h.
Definition at line 524 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::NoiseGeneratorSeed [protected] |
Definition at line 525 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::AlwaysUpdate [protected] |
Definition at line 527 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::Enable [protected] |
Definition at line 528 of file vtkSurfaceLICPainter.h.
int vtkSurfaceLICPainter::CompositeStrategy [protected] |
Definition at line 529 of file vtkSurfaceLICPainter.h.
vtkDataObject* vtkSurfaceLICPainter::Output [protected] |
Definition at line 531 of file vtkSurfaceLICPainter.h.
vtkInternals* vtkSurfaceLICPainter::Internals [protected] |
Definition at line 532 of file vtkSurfaceLICPainter.h.
The documentation for this class was generated from the following file:
- dox/Rendering/LIC/vtkSurfaceLICPainter.h
