Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
vtkSquirtCompressor Class Reference

Image compressor/decompressor using SQUIRT. More...

#include <vtkSquirtCompressor.h>

Inheritance diagram for vtkSquirtCompressor:
Inheritance graph
[legend]
Collaboration diagram for vtkSquirtCompressor:
Collaboration graph
[legend]

Public Types

typedef vtkImageCompressor Superclass
 
- Public Types inherited from vtkImageCompressor
typedef vtkObject Superclass
 

Public Member Functions

virtual const char * GetClassName ()
 
virtual int IsA (const char *type)
 
void PrintSelf (ostream &os, vtkIndent indent) override
 
const char * SaveConfiguration () override
 Serialize compressor configuration (but not the data) into the stream. More...
 
const char * RestoreConfiguration (const char *stream) override
 Restore state from the stream, The stream format for all image compressor is: [ClassName, LossLessMode, [Derived Class Stream]]. More...
 
virtual void SetSquirtLevel (int)
 Set Squirt compression level. More...
 
virtual int GetSquirtLevel ()
 Set Squirt compression level. More...
 
int Compress () override
 Compress/Decompress data array on the objects input with results in the objects output. More...
 
int Decompress () override
 Compress/Decompress data array on the objects input with results in the objects output. More...
 
void SaveConfiguration (vtkMultiProcessStream *stream) override
 Serialize/Restore compressor configuration (but not the data) into the stream. More...
 
bool RestoreConfiguration (vtkMultiProcessStream *stream) override
 Serialize/Restore compressor configuration (but not the data) into the stream. More...
 
- Public Member Functions inherited from vtkImageCompressor
virtual void SetImageResolution (int width, int height)
 Communicates the next expected image resolution. More...
 
void SetInput (vtkUnsignedCharArray *input)
 Get/Set the input to this compressor. More...
 
virtual vtkUnsignedCharArrayGetInput ()
 Get/Set the input to this compressor. More...
 
virtual vtkUnsignedCharArrayGetOutput ()
 Get/Set the output of the compressor. More...
 
void SetOutput (vtkUnsignedCharArray *)
 Get/Set the output of the compressor. More...
 
virtual void SetLossLessMode (int)
 When set the implementation must use loss-less compression, otherwise implemnetation should user provided settings. More...
 
virtual int GetLossLessMode ()
 When set the implementation must use loss-less compression, otherwise implemnetation should user provided settings. More...
 
- Public Member Functions inherited from vtkObject
 vtkBaseTypeMacro (vtkObject, vtkObjectBase)
 
virtual void DebugOn ()
 
virtual void DebugOff ()
 
bool GetDebug ()
 
void SetDebug (bool debugFlag)
 
virtual void Modified ()
 
virtual vtkMTimeType GetMTime ()
 
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)
 
int InvokeEvent (unsigned long event)
 
int InvokeEvent (const char *event)
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 
vtkCommandGetCommand (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 *)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
int InvokeEvent (unsigned long event, void *callData)
 
int InvokeEvent (const char *event, void *callData)
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 
vtkCommandGetCommand (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 *)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
int InvokeEvent (unsigned long event, void *callData)
 
int InvokeEvent (const char *event, void *callData)
 
- Public Member Functions inherited from vtkObjectBase
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)
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 
int GetReferenceCount ()
 
void PrintRevisions (ostream &)
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 
int GetReferenceCount ()
 
void PrintRevisions (ostream &)
 

Static Public Member Functions

static vtkSquirtCompressorNew ()
 
static int IsTypeOf (const char *type)
 
static vtkSquirtCompressorSafeDownCast (vtkObject *o)
 
- Static Public Member Functions inherited from vtkImageCompressor
static int IsTypeOf (const char *type)
 
static vtkImageCompressorSafeDownCast (vtkObject *o)
 
- Static Public Member Functions inherited from vtkObject
static vtkObjectNew ()
 
static void BreakOnError ()
 
static void SetGlobalWarningDisplay (int val)
 
static void GlobalWarningDisplayOn ()
 
static void GlobalWarningDisplayOff ()
 
static int GetGlobalWarningDisplay ()
 
static void SetGlobalWarningDisplay (int val)
 
static void GlobalWarningDisplayOn ()
 
static void GlobalWarningDisplayOff ()
 
static int GetGlobalWarningDisplay ()
 
- Static Public Member Functions inherited from vtkObjectBase
static vtkTypeBool IsTypeOf (const char *name)
 
static vtkObjectBaseNew ()
 
static vtkObjectBaseNew ()
 

Protected Member Functions

 vtkSquirtCompressor ()
 
 ~vtkSquirtCompressor () override
 
int DecompressRGB ()
 
int DecompressRGBA ()
 
- Protected Member Functions inherited from vtkImageCompressor
virtual void SetConfiguration (const char *)
 
 vtkImageCompressor ()
 Construct with nullptr input array and empty but allocated output array. More...
 
 ~vtkImageCompressor () override
 Construct with nullptr input array and empty but allocated output array. More...
 
- Protected Member Functions inherited from vtkObject
 vtkObject ()
 
virtual ~vtkObject ()
 
void RegisterInternal (vtkObjectBase *, vtkTypeBool check) VTK_OVERRIDE
 
void UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) VTK_OVERRIDE
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL)
 
void InternalReleaseFocus ()
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL)
 
void InternalReleaseFocus ()
 
- Protected Member Functions inherited from vtkObjectBase
 vtkObjectBase ()
 
virtual ~vtkObjectBase ()
 
virtual void CollectRevisions (ostream &)
 
virtual void ReportReferences (vtkGarbageCollector *)
 
 vtkObjectBase (const vtkObjectBase &)
 
void operator= (const vtkObjectBase &)
 

Protected Attributes

int SquirtLevel
 
- Protected Attributes inherited from vtkImageCompressor
vtkUnsignedCharArrayOutput
 
vtkUnsignedCharArrayInput
 
int LossLessMode
 
char * Configuration
 
- Protected Attributes inherited from vtkObject
bool Debug
 
vtkTimeStamp MTime
 
vtkSubjectHelper * SubjectHelper
 
- Protected Attributes inherited from vtkObjectBase
vtkAtomicInt32 ReferenceCount
 
vtkWeakPointerBase ** WeakPointers
 

Detailed Description

Image compressor/decompressor using SQUIRT.

This class compresses Image data using SQUIRT a Run-Length-Encoded compression scheme. The Squirt Level controls the compression. 0 is lossless compression, 1 through 5 are lossy compression levels with 5 being maximum compression.

Squirt produces smaller compression ratio than some other popular compression algorithm. However, Squirt has a relatively high throughput compared to some other compression algorithm. Squirt's performance is optimized for RGBa images, however the class can also work with RGB images. There is no performance hit when applying the lossy comrpession levels.

Levels 1 through 5 apply a color reducing mask to the run computation, not to the pixel directly. This is clever in that no new colors are introduced to the image, and as a result one doesn't see drastic changes between the reduced color image and the original. However, when using the higher levels one may get runs that produce visual artifiacts. For example when a run starts in one actor whose reduced color matches the background the background is colored with the actor color.

The compressor uses a modified SQUIRT implementation where encode 4-bit opacity information as well. This is needed to improve background color blending for translucent renderings in ParaView.

Thanks:
Thanks to Sandia National Laboratories for this compression technique

Definition at line 44 of file vtkSquirtCompressor.h.

Member Typedef Documentation

◆ Superclass

Definition at line 48 of file vtkSquirtCompressor.h.

Constructor & Destructor Documentation

◆ vtkSquirtCompressor()

vtkSquirtCompressor::vtkSquirtCompressor ( )
protected

◆ ~vtkSquirtCompressor()

vtkSquirtCompressor::~vtkSquirtCompressor ( )
overrideprotected

Member Function Documentation

◆ New()

static vtkSquirtCompressor* vtkSquirtCompressor::New ( )
static

◆ GetClassName()

virtual const char* vtkSquirtCompressor::GetClassName ( )
virtual

Reimplemented from vtkImageCompressor.

◆ IsTypeOf()

static int vtkSquirtCompressor::IsTypeOf ( const char *  type)
static

◆ IsA()

virtual int vtkSquirtCompressor::IsA ( const char *  type)
virtual

Reimplemented from vtkImageCompressor.

◆ SafeDownCast()

static vtkSquirtCompressor* vtkSquirtCompressor::SafeDownCast ( vtkObject o)
static

◆ PrintSelf()

void vtkSquirtCompressor::PrintSelf ( ostream &  os,
vtkIndent  indent 
)
overridevirtual

Reimplemented from vtkImageCompressor.

◆ SetSquirtLevel()

virtual void vtkSquirtCompressor::SetSquirtLevel ( int  )
virtual

Set Squirt compression level.

Level 0 is lossless compression, 1 through 5 are lossy compression levels with 5 being maximum compression.

◆ GetSquirtLevel()

virtual int vtkSquirtCompressor::GetSquirtLevel ( )
virtual

Set Squirt compression level.

Level 0 is lossless compression, 1 through 5 are lossy compression levels with 5 being maximum compression.

◆ Compress()

int vtkSquirtCompressor::Compress ( )
overridevirtual

Compress/Decompress data array on the objects input with results in the objects output.

See also Set/GetInput/Output.

Implements vtkImageCompressor.

◆ Decompress()

int vtkSquirtCompressor::Decompress ( )
overridevirtual

Compress/Decompress data array on the objects input with results in the objects output.

See also Set/GetInput/Output.

Implements vtkImageCompressor.

◆ SaveConfiguration() [1/2]

void vtkSquirtCompressor::SaveConfiguration ( vtkMultiProcessStream stream)
overridevirtual

Serialize/Restore compressor configuration (but not the data) into the stream.

Reimplemented from vtkImageCompressor.

◆ RestoreConfiguration() [1/2]

bool vtkSquirtCompressor::RestoreConfiguration ( vtkMultiProcessStream stream)
overridevirtual

Serialize/Restore compressor configuration (but not the data) into the stream.

Reimplemented from vtkImageCompressor.

◆ SaveConfiguration() [2/2]

const char* vtkSquirtCompressor::SaveConfiguration ( )
overridevirtual

Serialize compressor configuration (but not the data) into the stream.

A pointer to the internally managed stream is returned (ie do not free it!).

Reimplemented from vtkImageCompressor.

◆ RestoreConfiguration() [2/2]

const char* vtkSquirtCompressor::RestoreConfiguration ( const char *  stream)
overridevirtual

Restore state from the stream, The stream format for all image compressor is: [ClassName, LossLessMode, [Derived Class Stream]].

Upon success the stream is returned otherwise 0 is returned indicating an error.

Reimplemented from vtkImageCompressor.

◆ DecompressRGB()

int vtkSquirtCompressor::DecompressRGB ( )
protected

◆ DecompressRGBA()

int vtkSquirtCompressor::DecompressRGBA ( )
protected

Member Data Documentation

◆ SquirtLevel

int vtkSquirtCompressor::SquirtLevel
protected

Definition at line 87 of file vtkSquirtCompressor.h.


The documentation for this class was generated from the following file: