VTK  9.3.20240419
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
vtkGL2PSExporter Class Reference

export a scene as a PostScript file using GL2PS. More...

#include <vtkGL2PSExporter.h>

Inheritance diagram for vtkGL2PSExporter:
[legend]
Collaboration diagram for vtkGL2PSExporter:
[legend]

Public Types

enum  OutputFormat {
  PS_FILE , EPS_FILE , PDF_FILE , TEX_FILE ,
  SVG_FILE
}
 
enum  SortScheme { NO_SORT = 0 , SIMPLE_SORT = 1 , BSP_SORT = 2 }
 
typedef vtkExporter Superclass
 
- Public Types inherited from vtkExporter
typedef vtkObject Superclass
 

Public Member Functions

virtual vtkTypeBool IsA (const char *type)
 Return 1 if this class is the same type of (or a subclass of) the named class. More...
 
vtkGL2PSExporterNewInstance () const
 
void PrintSelf (ostream &os, vtkIndent indent) override
 Methods invoked by print to print information about the object including superclasses. More...
 
 vtkSetFilePathMacro (FilePrefix)
 Specify the prefix of the files to write out. More...
 
 vtkGetFilePathMacro (FilePrefix)
 Specify the prefix of the files to write out. More...
 
virtual void SetBufferSize (int)
 The initial size of the GL2PS export buffer in bytes. More...
 
virtual int GetBufferSize ()
 The initial size of the GL2PS export buffer in bytes. More...
 
virtual void SetTitle (const char *)
 Set the title for the output, if supported. More...
 
virtual char * GetTitle ()
 Set the title for the output, if supported. More...
 
void UsePainterSettings ()
 Configure the exporter to expect a painter-ordered 2D rendering, that is, a rendering at a fixed depth where primitives are drawn from the bottom up. More...
 
virtual void SetFileFormat (int)
 Specify the format of file to write out. More...
 
virtual int GetFileFormat ()
 Specify the format of file to write out. More...
 
void SetFileFormatToPS ()
 Specify the format of file to write out. More...
 
void SetFileFormatToEPS ()
 Specify the format of file to write out. More...
 
void SetFileFormatToPDF ()
 Specify the format of file to write out. More...
 
void SetFileFormatToTeX ()
 Specify the format of file to write out. More...
 
void SetFileFormatToSVG ()
 Specify the format of file to write out. More...
 
const char * GetFileFormatAsString ()
 Specify the format of file to write out. More...
 
virtual void SetSort (int)
 Set the type of sorting algorithm to order primitives from back to front. More...
 
virtual int GetSort ()
 Set the type of sorting algorithm to order primitives from back to front. More...
 
void SetSortToOff ()
 Set the type of sorting algorithm to order primitives from back to front. More...
 
void SetSortToSimple ()
 Set the type of sorting algorithm to order primitives from back to front. More...
 
void SetSortToBSP ()
 Set the type of sorting algorithm to order primitives from back to front. More...
 
const char * GetSortAsString ()
 Set the type of sorting algorithm to order primitives from back to front. More...
 
virtual void SetCompress (vtkTypeBool)
 Turn on/off compression when generating PostScript or PDF output. More...
 
virtual vtkTypeBool GetCompress ()
 Turn on/off compression when generating PostScript or PDF output. More...
 
virtual void CompressOn ()
 Turn on/off compression when generating PostScript or PDF output. More...
 
virtual void CompressOff ()
 Turn on/off compression when generating PostScript or PDF output. More...
 
virtual void SetDrawBackground (vtkTypeBool)
 Turn on/off drawing the background frame. More...
 
virtual vtkTypeBool GetDrawBackground ()
 Turn on/off drawing the background frame. More...
 
virtual void DrawBackgroundOn ()
 Turn on/off drawing the background frame. More...
 
virtual void DrawBackgroundOff ()
 Turn on/off drawing the background frame. More...
 
virtual void SetSimpleLineOffset (vtkTypeBool)
 Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option. More...
 
virtual vtkTypeBool GetSimpleLineOffset ()
 Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option. More...
 
virtual void SimpleLineOffsetOn ()
 Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option. More...
 
virtual void SimpleLineOffsetOff ()
 Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option. More...
 
virtual void SetSilent (vtkTypeBool)
 Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT). More...
 
virtual vtkTypeBool GetSilent ()
 Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT). More...
 
virtual void SilentOn ()
 Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT). More...
 
virtual void SilentOff ()
 Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT). More...
 
virtual void SetBestRoot (vtkTypeBool)
 Turn on/off the GL2PS_BEST_ROOT option. More...
 
virtual vtkTypeBool GetBestRoot ()
 Turn on/off the GL2PS_BEST_ROOT option. More...
 
virtual void BestRootOn ()
 Turn on/off the GL2PS_BEST_ROOT option. More...
 
virtual void BestRootOff ()
 Turn on/off the GL2PS_BEST_ROOT option. More...
 
virtual void SetText (vtkTypeBool)
 Turn on/off drawing the text. More...
 
virtual vtkTypeBool GetText ()
 Turn on/off drawing the text. More...
 
virtual void TextOn ()
 Turn on/off drawing the text. More...
 
virtual void TextOff ()
 Turn on/off drawing the text. More...
 
virtual void SetLandscape (vtkTypeBool)
 Turn on/off landscape orientation. More...
 
virtual vtkTypeBool GetLandscape ()
 Turn on/off landscape orientation. More...
 
virtual void LandscapeOn ()
 Turn on/off landscape orientation. More...
 
virtual void LandscapeOff ()
 Turn on/off landscape orientation. More...
 
virtual void SetPS3Shading (vtkTypeBool)
 Turn on/off the GL2PS_PS3_SHADING option. More...
 
virtual vtkTypeBool GetPS3Shading ()
 Turn on/off the GL2PS_PS3_SHADING option. More...
 
virtual void PS3ShadingOn ()
 Turn on/off the GL2PS_PS3_SHADING option. More...
 
virtual void PS3ShadingOff ()
 Turn on/off the GL2PS_PS3_SHADING option. More...
 
virtual void SetOcclusionCull (vtkTypeBool)
 Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL). More...
 
virtual vtkTypeBool GetOcclusionCull ()
 Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL). More...
 
virtual void OcclusionCullOn ()
 Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL). More...
 
virtual void OcclusionCullOff ()
 Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL). More...
 
virtual void SetWrite3DPropsAsRasterImage (vtkTypeBool)
 Turn on/off writing 3D props as raster images. More...
 
virtual vtkTypeBool GetWrite3DPropsAsRasterImage ()
 Turn on/off writing 3D props as raster images. More...
 
virtual void Write3DPropsAsRasterImageOn ()
 Turn on/off writing 3D props as raster images. More...
 
virtual void Write3DPropsAsRasterImageOff ()
 Turn on/off writing 3D props as raster images. More...
 
virtual void SetTextAsPath (bool)
 Turn on/off exporting text as path information, rather than character data. More...
 
virtual bool GetTextAsPath ()
 Turn on/off exporting text as path information, rather than character data. More...
 
virtual void TextAsPathOn ()
 Turn on/off exporting text as path information, rather than character data. More...
 
virtual void TextAsPathOff ()
 Turn on/off exporting text as path information, rather than character data. More...
 
void SetRasterExclusions (vtkPropCollection *)
 Collection of props to exclude from rasterization. More...
 
virtual vtkPropCollectionGetRasterExclusions ()
 Collection of props to exclude from rasterization. More...
 
virtual void SetPointSizeFactor (float)
 Set the ratio between the OpenGL PointSize and that used by GL2PS to generate PostScript. More...
 
virtual float GetPointSizeFactor ()
 Set the ratio between the OpenGL PointSize and that used by GL2PS to generate PostScript. More...
 
virtual void SetLineWidthFactor (float)
 Set the ratio between the OpenGL LineWidth and that used by GL2PS to generate PostScript. More...
 
virtual float GetLineWidthFactor ()
 Set the ratio between the OpenGL LineWidth and that used by GL2PS to generate PostScript. More...
 
- Public Member Functions inherited from vtkExporter
vtkExporterNewInstance () const
 
virtual void Write ()
 Write data to output. More...
 
void Update ()
 Convenient alias for Write() method. More...
 
void SetStartWrite (void(*f)(void *), void *arg)
 Specify a function to be called before data is written. More...
 
void SetEndWrite (void(*f)(void *), void *arg)
 Specify a function to be called after data is written. More...
 
void SetStartWriteArgDelete (void(*f)(void *))
 Set the arg delete method. More...
 
void SetEndWriteArgDelete (void(*f)(void *))
 Set the arg delete method. More...
 
vtkMTimeType GetMTime () override
 Returns the MTime also considering the RenderWindow. More...
 
virtual void SetRenderWindow (vtkRenderWindow *)
 Set/Get the rendering window that contains the scene to be written. More...
 
virtual vtkRenderWindowGetRenderWindow ()
 Set/Get the rendering window that contains the scene to be written. More...
 
virtual void SetActiveRenderer (vtkRenderer *)
 Set/Get the renderer that contains actors to be written. More...
 
virtual vtkRendererGetActiveRenderer ()
 Set/Get the renderer that contains actors to be written. More...
 
void SetInput (vtkRenderWindow *renWin)
 These methods are provided for backward compatibility. More...
 
vtkRenderWindowGetInput ()
 These methods are provided for backward compatibility. More...
 
- Public Member Functions inherited from vtkObject
 vtkBaseTypeMacro (vtkObject, vtkObjectBase)
 
virtual void DebugOn ()
 Turn debugging output on. More...
 
virtual void DebugOff ()
 Turn debugging output off. More...
 
bool GetDebug ()
 Get the value of the debug flag. More...
 
void SetDebug (bool debugFlag)
 Set the value of the debug flag. More...
 
virtual void Modified ()
 Update the modification time for this object. More...
 
void RemoveObserver (unsigned long tag)
 
void RemoveObservers (unsigned long event)
 
void RemoveObservers (const char *event)
 
void RemoveAllObservers ()
 
vtkTypeBool HasObserver (unsigned long event)
 
vtkTypeBool HasObserver (const char *event)
 
vtkTypeBool InvokeEvent (unsigned long event)
 
vtkTypeBool InvokeEvent (const char *event)
 
std::string GetObjectDescription () const override
 The object description printed in messages and PrintSelf output. More...
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkCommandGetCommand (unsigned long tag)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObserver (vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObservers (unsigned long event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
void RemoveObservers (const char *event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkTypeBool HasObserver (unsigned long event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
vtkTypeBool HasObserver (const char *event, vtkCommand *)
 Allow people to add/remove/invoke observers (callbacks) to any VTK object. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 Overloads to AddObserver that allow developers to add class member functions as callbacks for events. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 Overloads to AddObserver that allow developers to add class member functions as callbacks for events. More...
 
template<class U , class T >
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 Allow user to set the AbortFlagOn() with the return value of the callback method. More...
 
vtkTypeBool InvokeEvent (unsigned long event, void *callData)
 This method invokes an event and return whether the event was aborted or not. More...
 
vtkTypeBool InvokeEvent (const char *event, void *callData)
 This method invokes an event and return whether the event was aborted or not. More...
 
virtual void SetObjectName (const std::string &objectName)
 Set/get the name of this object for reporting purposes. More...
 
virtual std::string GetObjectName () const
 Set/get the name of this object for reporting purposes. More...
 
- Public Member Functions inherited from vtkObjectBase
const char * GetClassName () const
 Return the class name as a string. More...
 
virtual vtkIdType GetNumberOfGenerationsFromBase (const char *name)
 Given the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class). More...
 
virtual void Delete ()
 Delete a VTK object. More...
 
virtual void FastDelete ()
 Delete a reference to this object. More...
 
void InitializeObjectBase ()
 
void Print (ostream &os)
 Print an object to an ostream. More...
 
void Register (vtkObjectBase *o)
 Increase the reference count (mark as used by another object). More...
 
virtual void UnRegister (vtkObjectBase *o)
 Decrease the reference count (release by another object). More...
 
int GetReferenceCount ()
 Return the current reference count of this object. More...
 
void SetReferenceCount (int)
 Sets the reference count. More...
 
bool GetIsInMemkind () const
 A local state flag that remembers whether this object lives in the normal or extended memory space. More...
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 Methods invoked by print to print information about the object including superclasses. More...
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 Methods invoked by print to print information about the object including superclasses. More...
 
virtual bool UsesGarbageCollector () const
 Indicate whether the class uses vtkGarbageCollector or not. More...
 

Static Public Member Functions

static vtkGL2PSExporterNew ()
 
static vtkTypeBool IsTypeOf (const char *type)
 
static vtkGL2PSExporterSafeDownCast (vtkObjectBase *o)
 
- Static Public Member Functions inherited from vtkExporter
static vtkTypeBool IsTypeOf (const char *type)
 
static vtkExporterSafeDownCast (vtkObjectBase *o)
 
- Static Public Member Functions inherited from vtkObject
static vtkObjectNew ()
 Create an object with Debug turned off, modified time initialized to zero, and reference counting on. More...
 
static void BreakOnError ()
 This method is called when vtkErrorMacro executes. More...
 
static void SetGlobalWarningDisplay (vtkTypeBool val)
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static void GlobalWarningDisplayOn ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static void GlobalWarningDisplayOff ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
static vtkTypeBool GetGlobalWarningDisplay ()
 This is a global flag that controls whether any debug, warning or error messages are displayed. More...
 
- Static Public Member Functions inherited from vtkObjectBase
static vtkTypeBool IsTypeOf (const char *name)
 Return 1 if this class type is the same type of (or a subclass of) the named class. More...
 
static vtkIdType GetNumberOfGenerationsFromBaseType (const char *name)
 Given a the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class). More...
 
static vtkObjectBaseNew ()
 Create an object with Debug turned off, modified time initialized to zero, and reference counting on. More...
 
static void SetMemkindDirectory (const char *directoryname)
 The name of a directory, ideally mounted -o dax, to memory map an extended memory space within. More...
 
static bool GetUsingMemkind ()
 A global state flag that controls whether vtkObjects are constructed in the usual way (the default) or within the extended memory space. More...
 

Protected Member Functions

virtual vtkObjectBaseNewInstanceInternal () const
 
 vtkGL2PSExporter ()
 
 ~vtkGL2PSExporter () override
 
int GetGL2PSOptions ()
 
int GetGL2PSSort ()
 
int GetGL2PSFormat ()
 
const char * GetFileExtension ()
 
- Protected Member Functions inherited from vtkExporter
 vtkExporter ()
 
 ~vtkExporter () override
 
virtual void WriteData ()=0
 
- Protected Member Functions inherited from vtkObject
 vtkObject ()
 
 ~vtkObject () override
 
void RegisterInternal (vtkObjectBase *, vtkTypeBool check) override
 
void UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) override
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=nullptr)
 These methods allow a command to exclusively grab all events. More...
 
void InternalReleaseFocus ()
 These methods allow a command to exclusively grab all events. More...
 
- Protected Member Functions inherited from vtkObjectBase
 vtkObjectBase ()
 
virtual ~vtkObjectBase ()
 
virtual void ReportReferences (vtkGarbageCollector *)
 
 vtkObjectBase (const vtkObjectBase &)
 
void operator= (const vtkObjectBase &)
 

Protected Attributes

vtkPropCollectionRasterExclusions
 
char * FilePrefix
 
char * Title
 
int FileFormat
 
int BufferSize
 
int Sort
 
vtkTypeBool Compress
 
vtkTypeBool DrawBackground
 
vtkTypeBool SimpleLineOffset
 
vtkTypeBool Silent
 
vtkTypeBool BestRoot
 
vtkTypeBool Text
 
vtkTypeBool Landscape
 
vtkTypeBool PS3Shading
 
vtkTypeBool OcclusionCull
 
vtkTypeBool Write3DPropsAsRasterImage
 
bool TextAsPath
 
float PointSizeFactor
 
float LineWidthFactor
 
- Protected Attributes inherited from vtkExporter
vtkRenderWindowRenderWindow
 
vtkRendererActiveRenderer
 
void(* StartWrite )(void *)
 
void(* StartWriteArgDelete )(void *)
 
void * StartWriteArg
 
void(* EndWrite )(void *)
 
void(* EndWriteArgDelete )(void *)
 
void * EndWriteArg
 
- Protected Attributes inherited from vtkObject
bool Debug
 
vtkTimeStamp MTime
 
vtkSubjectHelper * SubjectHelper
 
std::string ObjectName
 
- Protected Attributes inherited from vtkObjectBase
std::atomic< int32_t > ReferenceCount
 
vtkWeakPointerBase ** WeakPointers
 

Additional Inherited Members

- Static Protected Member Functions inherited from vtkObjectBase
static vtkMallocingFunction GetCurrentMallocFunction ()
 
static vtkReallocingFunction GetCurrentReallocFunction ()
 
static vtkFreeingFunction GetCurrentFreeFunction ()
 
static vtkFreeingFunction GetAlternateFreeFunction ()
 

Detailed Description

export a scene as a PostScript file using GL2PS.

vtkGL2PSExporter is a concrete subclass of vtkExporter that writes high quality vector PostScript (PS/EPS), PDF or SVG files by using GL2PS. GL2PS can be obtained at: http://www.geuz.org/gl2ps/. This can be very useful when one requires publication quality pictures. This class works best with simple 3D scenes and most 2D plots. Please note that GL2PS has its limitations since PostScript is not an ideal language to represent complex 3D scenes. However, this class does allow one to write mixed vector/raster files by using the Write3DPropsAsRasterImage ivar. Please do read the caveats section of this documentation.

By default vtkGL2PSExporter generates Encapsulated PostScript (EPS) output along with the text in portrait orientation with the background color of the window being drawn. The generated output is also compressed using zlib. The various other options are set to sensible defaults.

The output file format (FileFormat) can be either PostScript (PS), Encapsulated PostScript (EPS), PDF, SVG or TeX. The file extension is generated automatically depending on the FileFormat. The default is EPS. When TeX output is chosen, only the text strings in the plot are generated and put into a picture environment. One can turn on and off the text when generating PS/EPS/PDF/SVG files by using the Text boolean variable. By default the text is drawn. The background color of the renderwindow is drawn by default. To make the background white instead use the DrawBackgroundOff function. Landscape figures can be generated by using the LandscapeOn function. Portrait orientation is used by default. Several of the GL2PS options can be set. The names of the ivars for these options are similar to the ones that GL2PS provides. Compress, SimpleLineOffset, Silent, BestRoot, PS3Shading and OcclusionCull are similar to the options provided by GL2PS. Please read the function documentation or the GL2PS documentation for more details. The ivar Write3DPropsAsRasterImage allows one to generate mixed vector/raster images. All the 3D props in the scene will be written as a raster image and all 2D actors will be written as vector graphic primitives. This makes it possible to handle transparency and complex 3D scenes. This ivar is set to Off by default. Specific 3D props can be excluded from the rasterization process by adding them to the RasterExclusions ivar. Props in this collection will be rendered as 2D vector primitives instead.

Warning
By default (with Write3DPropsAsRasterImage set to Off) exporting complex 3D scenes can take a long while and result in huge output files. Generating correct vector graphics output for scenes with transparency is almost impossible. However, one can set Write3DPropsAsRasterImageOn and generate mixed vector/raster files. This should work fine with complex scenes along with transparent actors.
See also
vtkExporter
Thanks:
Thanks to Goodwin Lawlor and Prabhu Ramachandran for this class.
Tests:
vtkGL2PSExporter (Tests)

Definition at line 79 of file vtkGL2PSExporter.h.

Member Typedef Documentation

◆ Superclass

Definition at line 83 of file vtkGL2PSExporter.h.

Member Enumeration Documentation

◆ OutputFormat

Enumerator
PS_FILE 
EPS_FILE 
PDF_FILE 
TEX_FILE 
SVG_FILE 

Definition at line 118 of file vtkGL2PSExporter.h.

◆ SortScheme

Enumerator
NO_SORT 
SIMPLE_SORT 
BSP_SORT 

Definition at line 159 of file vtkGL2PSExporter.h.

Constructor & Destructor Documentation

◆ vtkGL2PSExporter()

vtkGL2PSExporter::vtkGL2PSExporter ( )
protected

◆ ~vtkGL2PSExporter()

vtkGL2PSExporter::~vtkGL2PSExporter ( )
overrideprotected

Member Function Documentation

◆ New()

static vtkGL2PSExporter* vtkGL2PSExporter::New ( )
static

◆ IsTypeOf()

static vtkTypeBool vtkGL2PSExporter::IsTypeOf ( const char *  type)
static

◆ IsA()

virtual vtkTypeBool vtkGL2PSExporter::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 vtkExporter.

Reimplemented in vtkOpenGLGL2PSExporter.

◆ SafeDownCast()

static vtkGL2PSExporter* vtkGL2PSExporter::SafeDownCast ( vtkObjectBase o)
static

◆ NewInstanceInternal()

virtual vtkObjectBase* vtkGL2PSExporter::NewInstanceInternal ( ) const
protectedvirtual

Reimplemented from vtkExporter.

Reimplemented in vtkOpenGLGL2PSExporter.

◆ NewInstance()

vtkGL2PSExporter* vtkGL2PSExporter::NewInstance ( ) const

◆ PrintSelf()

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

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 vtkExporter.

Reimplemented in vtkOpenGLGL2PSExporter.

◆ vtkSetFilePathMacro()

vtkGL2PSExporter::vtkSetFilePathMacro ( FilePrefix  )

Specify the prefix of the files to write out.

The resulting filenames will have .ps or .eps or .tex appended to them depending on the other options chosen.

◆ vtkGetFilePathMacro()

vtkGL2PSExporter::vtkGetFilePathMacro ( FilePrefix  )

Specify the prefix of the files to write out.

The resulting filenames will have .ps or .eps or .tex appended to them depending on the other options chosen.

◆ SetBufferSize()

virtual void vtkGL2PSExporter::SetBufferSize ( int  )
virtual

The initial size of the GL2PS export buffer in bytes.

The buffer is used to store the exported image prior to writing to file. If the buffer is too small, the exporter will enlarge the buffer and rerender until the export is successful. Setting a larger value here can reduce the time needed to export a complex scene by reducing the number of iterations required. The default initial size is 4 MB.

◆ GetBufferSize()

virtual int vtkGL2PSExporter::GetBufferSize ( )
virtual

The initial size of the GL2PS export buffer in bytes.

The buffer is used to store the exported image prior to writing to file. If the buffer is too small, the exporter will enlarge the buffer and rerender until the export is successful. Setting a larger value here can reduce the time needed to export a complex scene by reducing the number of iterations required. The default initial size is 4 MB.

◆ SetTitle()

virtual void vtkGL2PSExporter::SetTitle ( const char *  )
virtual

Set the title for the output, if supported.

If nullptr, "VTK GL2PS Export" is used.

◆ GetTitle()

virtual char* vtkGL2PSExporter::GetTitle ( )
virtual

Set the title for the output, if supported.

If nullptr, "VTK GL2PS Export" is used.

◆ UsePainterSettings()

void vtkGL2PSExporter::UsePainterSettings ( )
inline

Configure the exporter to expect a painter-ordered 2D rendering, that is, a rendering at a fixed depth where primitives are drawn from the bottom up.

This disables sorting, which will break the painter ordering, and turns off the simple line offset, which can cause line primitives to be drawn on top of all other geometry.

Definition at line 135 of file vtkGL2PSExporter.h.

◆ SetFileFormat()

virtual void vtkGL2PSExporter::SetFileFormat ( int  )
virtual

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

◆ GetFileFormat()

virtual int vtkGL2PSExporter::GetFileFormat ( )
virtual

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

◆ SetFileFormatToPS()

void vtkGL2PSExporter::SetFileFormatToPS ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 151 of file vtkGL2PSExporter.h.

◆ SetFileFormatToEPS()

void vtkGL2PSExporter::SetFileFormatToEPS ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 152 of file vtkGL2PSExporter.h.

◆ SetFileFormatToPDF()

void vtkGL2PSExporter::SetFileFormatToPDF ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 153 of file vtkGL2PSExporter.h.

◆ SetFileFormatToTeX()

void vtkGL2PSExporter::SetFileFormatToTeX ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 154 of file vtkGL2PSExporter.h.

◆ SetFileFormatToSVG()

void vtkGL2PSExporter::SetFileFormatToSVG ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 155 of file vtkGL2PSExporter.h.

◆ GetFileFormatAsString()

const char * vtkGL2PSExporter::GetFileFormatAsString ( )
inline

Specify the format of file to write out.

This can be one of: PS_FILE, EPS_FILE, PDF_FILE, TEX_FILE. Defaults to EPS_FILE. Depending on the option chosen it generates the appropriate file (with correct extension) when the Write function is called.

Definition at line 384 of file vtkGL2PSExporter.h.

◆ SetSort()

virtual void vtkGL2PSExporter::SetSort ( int  )
virtual

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

◆ GetSort()

virtual int vtkGL2PSExporter::GetSort ( )
virtual

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

◆ SetSortToOff()

void vtkGL2PSExporter::SetSortToOff ( )
inline

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

Definition at line 174 of file vtkGL2PSExporter.h.

◆ SetSortToSimple()

void vtkGL2PSExporter::SetSortToSimple ( )
inline

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

Definition at line 175 of file vtkGL2PSExporter.h.

◆ SetSortToBSP()

void vtkGL2PSExporter::SetSortToBSP ( )
inline

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

Definition at line 176 of file vtkGL2PSExporter.h.

◆ GetSortAsString()

const char * vtkGL2PSExporter::GetSortAsString ( )
inline

Set the type of sorting algorithm to order primitives from back to front.

Successive algorithms are more memory intensive. Simple is the default but BSP is perhaps the best.

Definition at line 368 of file vtkGL2PSExporter.h.

◆ SetCompress()

virtual void vtkGL2PSExporter::SetCompress ( vtkTypeBool  )
virtual

Turn on/off compression when generating PostScript or PDF output.

By default compression is on.

◆ GetCompress()

virtual vtkTypeBool vtkGL2PSExporter::GetCompress ( )
virtual

Turn on/off compression when generating PostScript or PDF output.

By default compression is on.

◆ CompressOn()

virtual void vtkGL2PSExporter::CompressOn ( )
virtual

Turn on/off compression when generating PostScript or PDF output.

By default compression is on.

◆ CompressOff()

virtual void vtkGL2PSExporter::CompressOff ( )
virtual

Turn on/off compression when generating PostScript or PDF output.

By default compression is on.

◆ SetDrawBackground()

virtual void vtkGL2PSExporter::SetDrawBackground ( vtkTypeBool  )
virtual

Turn on/off drawing the background frame.

If off the background is treated as white. By default the background is drawn. On the OpenGL2 backend, the background is always drawn.

◆ GetDrawBackground()

virtual vtkTypeBool vtkGL2PSExporter::GetDrawBackground ( )
virtual

Turn on/off drawing the background frame.

If off the background is treated as white. By default the background is drawn. On the OpenGL2 backend, the background is always drawn.

◆ DrawBackgroundOn()

virtual void vtkGL2PSExporter::DrawBackgroundOn ( )
virtual

Turn on/off drawing the background frame.

If off the background is treated as white. By default the background is drawn. On the OpenGL2 backend, the background is always drawn.

◆ DrawBackgroundOff()

virtual void vtkGL2PSExporter::DrawBackgroundOff ( )
virtual

Turn on/off drawing the background frame.

If off the background is treated as white. By default the background is drawn. On the OpenGL2 backend, the background is always drawn.

◆ SetSimpleLineOffset()

virtual void vtkGL2PSExporter::SetSimpleLineOffset ( vtkTypeBool  )
virtual

Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option.

When enabled a small offset is added in the z-buffer to all the lines in the plot. This results in an anti-aliasing like solution. Defaults to on.

◆ GetSimpleLineOffset()

virtual vtkTypeBool vtkGL2PSExporter::GetSimpleLineOffset ( )
virtual

Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option.

When enabled a small offset is added in the z-buffer to all the lines in the plot. This results in an anti-aliasing like solution. Defaults to on.

◆ SimpleLineOffsetOn()

virtual void vtkGL2PSExporter::SimpleLineOffsetOn ( )
virtual

Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option.

When enabled a small offset is added in the z-buffer to all the lines in the plot. This results in an anti-aliasing like solution. Defaults to on.

◆ SimpleLineOffsetOff()

virtual void vtkGL2PSExporter::SimpleLineOffsetOff ( )
virtual

Turn on/off the GL2PS_SIMPLE_LINE_OFFSET option.

When enabled a small offset is added in the z-buffer to all the lines in the plot. This results in an anti-aliasing like solution. Defaults to on.

◆ SetSilent()

virtual void vtkGL2PSExporter::SetSilent ( vtkTypeBool  )
virtual

Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT).

When enabled GL2PS messages are suppressed. Defaults to off.

◆ GetSilent()

virtual vtkTypeBool vtkGL2PSExporter::GetSilent ( )
virtual

Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT).

When enabled GL2PS messages are suppressed. Defaults to off.

◆ SilentOn()

virtual void vtkGL2PSExporter::SilentOn ( )
virtual

Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT).

When enabled GL2PS messages are suppressed. Defaults to off.

◆ SilentOff()

virtual void vtkGL2PSExporter::SilentOff ( )
virtual

Turn on/off GL2PS messages sent to stderr (GL2PS_SILENT).

When enabled GL2PS messages are suppressed. Defaults to off.

◆ SetBestRoot()

virtual void vtkGL2PSExporter::SetBestRoot ( vtkTypeBool  )
virtual

Turn on/off the GL2PS_BEST_ROOT option.

When enabled the construction of the BSP tree is optimized by choosing the root primitives leading to the minimum number of splits. Defaults to on.

◆ GetBestRoot()

virtual vtkTypeBool vtkGL2PSExporter::GetBestRoot ( )
virtual

Turn on/off the GL2PS_BEST_ROOT option.

When enabled the construction of the BSP tree is optimized by choosing the root primitives leading to the minimum number of splits. Defaults to on.

◆ BestRootOn()

virtual void vtkGL2PSExporter::BestRootOn ( )
virtual

Turn on/off the GL2PS_BEST_ROOT option.

When enabled the construction of the BSP tree is optimized by choosing the root primitives leading to the minimum number of splits. Defaults to on.

◆ BestRootOff()

virtual void vtkGL2PSExporter::BestRootOff ( )
virtual

Turn on/off the GL2PS_BEST_ROOT option.

When enabled the construction of the BSP tree is optimized by choosing the root primitives leading to the minimum number of splits. Defaults to on.

◆ SetText()

virtual void vtkGL2PSExporter::SetText ( vtkTypeBool  )
virtual

Turn on/off drawing the text.

If on (default) the text is drawn. If the FileFormat is set to TeX output then a LaTeX picture is generated with the text strings. If off text output is suppressed.

◆ GetText()

virtual vtkTypeBool vtkGL2PSExporter::GetText ( )
virtual

Turn on/off drawing the text.

If on (default) the text is drawn. If the FileFormat is set to TeX output then a LaTeX picture is generated with the text strings. If off text output is suppressed.

◆ TextOn()

virtual void vtkGL2PSExporter::TextOn ( )
virtual

Turn on/off drawing the text.

If on (default) the text is drawn. If the FileFormat is set to TeX output then a LaTeX picture is generated with the text strings. If off text output is suppressed.

◆ TextOff()

virtual void vtkGL2PSExporter::TextOff ( )
virtual

Turn on/off drawing the text.

If on (default) the text is drawn. If the FileFormat is set to TeX output then a LaTeX picture is generated with the text strings. If off text output is suppressed.

◆ SetLandscape()

virtual void vtkGL2PSExporter::SetLandscape ( vtkTypeBool  )
virtual

Turn on/off landscape orientation.

If off (default) the orientation is set to portrait.

◆ GetLandscape()

virtual vtkTypeBool vtkGL2PSExporter::GetLandscape ( )
virtual

Turn on/off landscape orientation.

If off (default) the orientation is set to portrait.

◆ LandscapeOn()

virtual void vtkGL2PSExporter::LandscapeOn ( )
virtual

Turn on/off landscape orientation.

If off (default) the orientation is set to portrait.

◆ LandscapeOff()

virtual void vtkGL2PSExporter::LandscapeOff ( )
virtual

Turn on/off landscape orientation.

If off (default) the orientation is set to portrait.

◆ SetPS3Shading()

virtual void vtkGL2PSExporter::SetPS3Shading ( vtkTypeBool  )
virtual

Turn on/off the GL2PS_PS3_SHADING option.

When enabled the shfill PostScript level 3 operator is used. Read the GL2PS documentation for more details. Defaults to on.

◆ GetPS3Shading()

virtual vtkTypeBool vtkGL2PSExporter::GetPS3Shading ( )
virtual

Turn on/off the GL2PS_PS3_SHADING option.

When enabled the shfill PostScript level 3 operator is used. Read the GL2PS documentation for more details. Defaults to on.

◆ PS3ShadingOn()

virtual void vtkGL2PSExporter::PS3ShadingOn ( )
virtual

Turn on/off the GL2PS_PS3_SHADING option.

When enabled the shfill PostScript level 3 operator is used. Read the GL2PS documentation for more details. Defaults to on.

◆ PS3ShadingOff()

virtual void vtkGL2PSExporter::PS3ShadingOff ( )
virtual

Turn on/off the GL2PS_PS3_SHADING option.

When enabled the shfill PostScript level 3 operator is used. Read the GL2PS documentation for more details. Defaults to on.

◆ SetOcclusionCull()

virtual void vtkGL2PSExporter::SetOcclusionCull ( vtkTypeBool  )
virtual

Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL).

When enabled hidden polygons are removed. This reduces file size considerably. Defaults to on.

◆ GetOcclusionCull()

virtual vtkTypeBool vtkGL2PSExporter::GetOcclusionCull ( )
virtual

Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL).

When enabled hidden polygons are removed. This reduces file size considerably. Defaults to on.

◆ OcclusionCullOn()

virtual void vtkGL2PSExporter::OcclusionCullOn ( )
virtual

Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL).

When enabled hidden polygons are removed. This reduces file size considerably. Defaults to on.

◆ OcclusionCullOff()

virtual void vtkGL2PSExporter::OcclusionCullOff ( )
virtual

Turn on/off culling of occluded polygons (GL2PS_OCCLUSION_CULL).

When enabled hidden polygons are removed. This reduces file size considerably. Defaults to on.

◆ SetWrite3DPropsAsRasterImage()

virtual void vtkGL2PSExporter::SetWrite3DPropsAsRasterImage ( vtkTypeBool  )
virtual

Turn on/off writing 3D props as raster images.

2D props are rendered using vector graphics primitives. If you have hi-res actors and are using transparency you probably need to turn this on. Defaults to Off. This option has no effect when the OpenGL2 backend is in use, as all 3D props (excluding vtkTextActor3D) are rasterized into the background.

◆ GetWrite3DPropsAsRasterImage()

virtual vtkTypeBool vtkGL2PSExporter::GetWrite3DPropsAsRasterImage ( )
virtual

Turn on/off writing 3D props as raster images.

2D props are rendered using vector graphics primitives. If you have hi-res actors and are using transparency you probably need to turn this on. Defaults to Off. This option has no effect when the OpenGL2 backend is in use, as all 3D props (excluding vtkTextActor3D) are rasterized into the background.

◆ Write3DPropsAsRasterImageOn()

virtual void vtkGL2PSExporter::Write3DPropsAsRasterImageOn ( )
virtual

Turn on/off writing 3D props as raster images.

2D props are rendered using vector graphics primitives. If you have hi-res actors and are using transparency you probably need to turn this on. Defaults to Off. This option has no effect when the OpenGL2 backend is in use, as all 3D props (excluding vtkTextActor3D) are rasterized into the background.

◆ Write3DPropsAsRasterImageOff()

virtual void vtkGL2PSExporter::Write3DPropsAsRasterImageOff ( )
virtual

Turn on/off writing 3D props as raster images.

2D props are rendered using vector graphics primitives. If you have hi-res actors and are using transparency you probably need to turn this on. Defaults to Off. This option has no effect when the OpenGL2 backend is in use, as all 3D props (excluding vtkTextActor3D) are rasterized into the background.

◆ SetTextAsPath()

virtual void vtkGL2PSExporter::SetTextAsPath ( bool  )
virtual

Turn on/off exporting text as path information, rather than character data.

This is useful for the PDF backend, which does not properly support aligned text otherwise. Defaults to Off.

◆ GetTextAsPath()

virtual bool vtkGL2PSExporter::GetTextAsPath ( )
virtual

Turn on/off exporting text as path information, rather than character data.

This is useful for the PDF backend, which does not properly support aligned text otherwise. Defaults to Off.

◆ TextAsPathOn()

virtual void vtkGL2PSExporter::TextAsPathOn ( )
virtual

Turn on/off exporting text as path information, rather than character data.

This is useful for the PDF backend, which does not properly support aligned text otherwise. Defaults to Off.

◆ TextAsPathOff()

virtual void vtkGL2PSExporter::TextAsPathOff ( )
virtual

Turn on/off exporting text as path information, rather than character data.

This is useful for the PDF backend, which does not properly support aligned text otherwise. Defaults to Off.

◆ SetRasterExclusions()

void vtkGL2PSExporter::SetRasterExclusions ( vtkPropCollection )

Collection of props to exclude from rasterization.

These will be rendered as 2D vector primitives in the output. This setting is ignored if Write3DPropsAsRasterImage is false. Behind the scenes, these props are treated as 2D props during the vector output generation.

◆ GetRasterExclusions()

virtual vtkPropCollection* vtkGL2PSExporter::GetRasterExclusions ( )
virtual

Collection of props to exclude from rasterization.

These will be rendered as 2D vector primitives in the output. This setting is ignored if Write3DPropsAsRasterImage is false. Behind the scenes, these props are treated as 2D props during the vector output generation.

◆ SetPointSizeFactor()

virtual void vtkGL2PSExporter::SetPointSizeFactor ( float  )
virtual

Set the ratio between the OpenGL PointSize and that used by GL2PS to generate PostScript.

Defaults to a ratio of 5/7.

◆ GetPointSizeFactor()

virtual float vtkGL2PSExporter::GetPointSizeFactor ( )
virtual

Set the ratio between the OpenGL PointSize and that used by GL2PS to generate PostScript.

Defaults to a ratio of 5/7.

◆ SetLineWidthFactor()

virtual void vtkGL2PSExporter::SetLineWidthFactor ( float  )
virtual

Set the ratio between the OpenGL LineWidth and that used by GL2PS to generate PostScript.

Defaults to a ratio of 5/7.

◆ GetLineWidthFactor()

virtual float vtkGL2PSExporter::GetLineWidthFactor ( )
virtual

Set the ratio between the OpenGL LineWidth and that used by GL2PS to generate PostScript.

Defaults to a ratio of 5/7.

◆ GetGL2PSOptions()

int vtkGL2PSExporter::GetGL2PSOptions ( )
protected

◆ GetGL2PSSort()

int vtkGL2PSExporter::GetGL2PSSort ( )
protected

◆ GetGL2PSFormat()

int vtkGL2PSExporter::GetGL2PSFormat ( )
protected

◆ GetFileExtension()

const char* vtkGL2PSExporter::GetFileExtension ( )
protected

Member Data Documentation

◆ RasterExclusions

vtkPropCollection* vtkGL2PSExporter::RasterExclusions
protected

Definition at line 342 of file vtkGL2PSExporter.h.

◆ FilePrefix

char* vtkGL2PSExporter::FilePrefix
protected

Definition at line 344 of file vtkGL2PSExporter.h.

◆ Title

char* vtkGL2PSExporter::Title
protected

Definition at line 345 of file vtkGL2PSExporter.h.

◆ FileFormat

int vtkGL2PSExporter::FileFormat
protected

Definition at line 346 of file vtkGL2PSExporter.h.

◆ BufferSize

int vtkGL2PSExporter::BufferSize
protected

Definition at line 347 of file vtkGL2PSExporter.h.

◆ Sort

int vtkGL2PSExporter::Sort
protected

Definition at line 348 of file vtkGL2PSExporter.h.

◆ Compress

vtkTypeBool vtkGL2PSExporter::Compress
protected

Definition at line 349 of file vtkGL2PSExporter.h.

◆ DrawBackground

vtkTypeBool vtkGL2PSExporter::DrawBackground
protected

Definition at line 350 of file vtkGL2PSExporter.h.

◆ SimpleLineOffset

vtkTypeBool vtkGL2PSExporter::SimpleLineOffset
protected

Definition at line 351 of file vtkGL2PSExporter.h.

◆ Silent

vtkTypeBool vtkGL2PSExporter::Silent
protected

Definition at line 352 of file vtkGL2PSExporter.h.

◆ BestRoot

vtkTypeBool vtkGL2PSExporter::BestRoot
protected

Definition at line 353 of file vtkGL2PSExporter.h.

◆ Text

vtkTypeBool vtkGL2PSExporter::Text
protected

Definition at line 354 of file vtkGL2PSExporter.h.

◆ Landscape

vtkTypeBool vtkGL2PSExporter::Landscape
protected

Definition at line 355 of file vtkGL2PSExporter.h.

◆ PS3Shading

vtkTypeBool vtkGL2PSExporter::PS3Shading
protected

Definition at line 356 of file vtkGL2PSExporter.h.

◆ OcclusionCull

vtkTypeBool vtkGL2PSExporter::OcclusionCull
protected

Definition at line 357 of file vtkGL2PSExporter.h.

◆ Write3DPropsAsRasterImage

vtkTypeBool vtkGL2PSExporter::Write3DPropsAsRasterImage
protected

Definition at line 358 of file vtkGL2PSExporter.h.

◆ TextAsPath

bool vtkGL2PSExporter::TextAsPath
protected

Definition at line 359 of file vtkGL2PSExporter.h.

◆ PointSizeFactor

float vtkGL2PSExporter::PointSizeFactor
protected

Definition at line 360 of file vtkGL2PSExporter.h.

◆ LineWidthFactor

float vtkGL2PSExporter::LineWidthFactor
protected

Definition at line 361 of file vtkGL2PSExporter.h.


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