1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkMathTextUtilities.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
// .NAME vtkMathTextUtilities - Abstract interface to equation rendering.
// .SECTION Description
// vtkMathTextUtilities defines an interface for equation rendering. Intended
// for use with the python matplotlib.mathtext module (implemented in the
// vtkMatplotlib module).
#ifndef __vtkMathTextUtilities_h
#define __vtkMathTypeUtilities_h
#include "vtkRenderingFreeTypeModule.h" // For export macro
#include "vtkObject.h"
class vtkImageData;
class vtkPath;
class vtkTextProperty;
class vtkTextActor;
class vtkViewport;
//----------------------------------------------------------------------------
// Singleton cleanup
class VTKRENDERINGFREETYPE_EXPORT vtkMathTextUtilitiesCleanup
{
public:
vtkMathTextUtilitiesCleanup();
~vtkMathTextUtilitiesCleanup();
};
class VTKRENDERINGFREETYPE_EXPORT vtkMathTextUtilities : public vtkObject
{
public:
vtkTypeMacro(vtkMathTextUtilities, vtkObject);
void PrintSelf(ostream& os, vtkIndent indent);
// Description:
// This is a singleton pattern New. There will be only ONE reference
// to a vtkMathTextUtilities object per process. Clients that
// call this method must use Delete() on the object so that reference
// counting will work. The single instance will be unreferenced when
// the program exits. You should just use the static GetInstance() method
// anyway to get the singleton.
static vtkMathTextUtilities *New();
// Description:
// Return the singleton instance with no reference counting.
static vtkMathTextUtilities* GetInstance();
// Description:
// Supply a user defined instance. Call Delete() on the supplied
// instance after setting it to fix the reference count.
static void SetInstance(vtkMathTextUtilities *instance);
// Description:
// Determine the dimensions of the image that RenderString will produce for
// a given str, tprop, and dpi
virtual bool GetBoundingBox(vtkTextProperty *tprop, const char *str,
unsigned int dpi, int bbox[4]) = 0;
// Description:
// Render the given string @a str into the vtkImageData @a data with a
// resolution of @a dpi. textDims, will be overwritten by the pixel width and
// height of the rendered string. This is useful when ScaleToPowerOfTwo is
// set to true, and the image dimensions may not match the dimensions of the
// rendered text.
virtual bool RenderString(const char *str, vtkImageData *data,
vtkTextProperty *tprop,
unsigned int dpi, int textDims[2] = NULL) = 0;
// Description:
// Parse the MathText expression in str and fill path with a contour of the
// glyphs.
virtual bool StringToPath(const char *str, vtkPath *path,
vtkTextProperty *tprop) = 0;
// Description:
// This function returns the font size (in points) required to fit the string
// in the target rectangle. The font size of tprop is updated to the computed
// value as well. If an error occurs (e.g. an improperly formatted MathText
// string), -1 is returned.
virtual int GetConstrainedFontSize(const char *str,
vtkTextProperty *tprop,
int targetWidth, int targetHeight,
unsigned int dpi);
// Description:
// Set to true if the graphics implmentation requires texture image dimensions
// to be a power of two. Default is true, but this member will be set
// appropriately when GL is inited.
virtual bool GetScaleToPowerOfTwo() = 0;
virtual void SetScaleToPowerOfTwo(bool scale) = 0;
protected:
vtkMathTextUtilities();
virtual ~vtkMathTextUtilities();
private:
vtkMathTextUtilities(const vtkMathTextUtilities&); // Not implemented.
void operator=(const vtkMathTextUtilities&); // Not implemented.
// Description:
// The singleton instance and the singleton cleanup instance
static vtkMathTextUtilities* Instance;
static vtkMathTextUtilitiesCleanup Cleanup;
};
#endif
|
