VTK  9.0.1
vtkOpenGLContextDevice2D.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkOpenGLContextDevice2D.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
15 
30 #ifndef vtkOpenGLContextDevice2D_h
31 #define vtkOpenGLContextDevice2D_h
32 
33 #include "vtkContextDevice2D.h"
34 #include "vtkRenderingContextOpenGL2Module.h" // For export macro
35 
36 #include <list> // for std::list
37 #include <vector> // STL Header
38 
39 class vtkMatrix4x4;
40 class vtkOpenGLExtensionManager;
41 class vtkOpenGLHelper;
43 class vtkPath;
44 class vtkRenderer;
45 class vtkShaderProgram;
46 class vtkStringToImage;
47 class vtkTransform;
48 class vtkViewport;
49 class vtkWindow;
50 
51 class VTKRENDERINGCONTEXTOPENGL2_EXPORT vtkOpenGLContextDevice2D : public vtkContextDevice2D
52 {
53 public:
55  void PrintSelf(ostream& os, vtkIndent indent) override;
56 
61 
67  void DrawPoly(float* f, int n, unsigned char* colors = nullptr, int nc_comps = 0) override;
68 
75  void DrawLines(float* f, int n, unsigned char* colors = nullptr, int nc_comps = 0) override;
76 
82  void DrawPoints(float* points, int n, unsigned char* colors = nullptr, int nc_comps = 0) override;
83 
90  void DrawPointSprites(vtkImageData* sprite, float* points, int n, unsigned char* colors = nullptr,
91  int nc_comps = 0) override;
92 
104  void DrawMarkers(int shape, bool highlight, float* points, int n, unsigned char* colors = nullptr,
105  int nc_comps = 0) override;
106 
108 
113  vtkSetMacro(MaximumMarkerCacheSize, int);
114  vtkGetMacro(MaximumMarkerCacheSize, int);
116 
120  void DrawQuad(float* points, int n) override;
121 
125  void DrawQuadStrip(float* points, int n) override;
126 
130  void DrawPolygon(float*, int) override;
132  float* points, int numPoints, unsigned char* colors = nullptr, int nc_comps = 0) override;
133 
145  void DrawEllipseWedge(float x, float y, float outRx, float outRy, float inRx, float inRy,
146  float startAngle, float stopAngle) override;
147 
155  float x, float y, float rX, float rY, float startAngle, float stopAngle) override;
156 
160  void DrawString(float* point, const vtkStdString& string) override;
161 
170  void ComputeStringBounds(const vtkStdString& string, float bounds[4]) override;
171 
175  void DrawString(float* point, const vtkUnicodeString& string) override;
176 
185  void ComputeStringBounds(const vtkUnicodeString& string, float bounds[4]) override;
186 
192  void ComputeJustifiedStringBounds(const char* string, float bounds[4]) override;
193 
198  void DrawMathTextString(float point[2], const vtkStdString& string) override;
199 
204  void DrawImage(float p[2], float scale, vtkImageData* image) override;
205 
211  void DrawImage(const vtkRectf& pos, vtkImageData* image) override;
212 
217  void DrawPolyData(float p[2], float scale, vtkPolyData* polyData, vtkUnsignedCharArray* colors,
218  int scalarMode) override;
219 
223  void SetColor4(unsigned char color[4]) override;
224 
228  virtual void SetColor(unsigned char color[3]);
229 
233  void SetTexture(vtkImageData* image, int properties = 0) override;
234 
238  void SetPointSize(float size) override;
239 
243  void SetLineWidth(float width) override;
244 
248  void SetLineType(int type) override;
249 
253  void MultiplyMatrix(vtkMatrix3x3* m) override;
254 
258  void SetMatrix(vtkMatrix3x3* m) override;
259 
263  void GetMatrix(vtkMatrix3x3* m) override;
264 
268  void PushMatrix() override;
269 
273  void PopMatrix() override;
274 
275  /*
276  * Supply an int array of length 4 with x1, y1, width, height specifying
277  * clipping region for the device in pixels.
278  */
279  void SetClipping(int* x) override;
280 
284  void EnableClipping(bool enable) override;
285 
289  void Begin(vtkViewport* viewport) override;
290 
294  void End() override;
295 
304 
312  void BufferIdModeEnd() override;
313 
320 
326 
330  bool HasGLSL();
331 
333 
336  vtkGetObjectMacro(RenderWindow, vtkOpenGLRenderWindow);
338 
344  virtual void ReleaseGraphicsResources(vtkWindow* window);
345 
347 
353 
354 protected:
357 
365  int GetNumberOfArcIterations(float rX, float rY, float startAngle, float stopAngle);
366 
371 
375  bool InRender;
376 
378 
381  class Private;
383 
384  class CellArrayHelper;
387 
392 
393  vtkOpenGLHelper* LinesCBO; // vertex + color
397  vtkOpenGLHelper* VCBO; // vertex + color
399  vtkOpenGLHelper* VBO; // vertex
401  vtkOpenGLHelper* VTBO; // vertex + tcoord
403  vtkOpenGLHelper* SCBO; // sprite + color
405  vtkOpenGLHelper* SBO; // sprite
407 
409  void BuildVBO(
410  vtkOpenGLHelper* cbo, float* v, int nv, unsigned char* coolors, int nc, float* tcoords);
412  std::vector<float>& tverts, unsigned char* colors = nullptr, int numComp = 0);
413  // used for stipples
414  unsigned short LinePattern;
415 
417 
422  int shape, bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
424  bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
426  bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
428  bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
430  bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
432  bool highlight, float* points, int n, unsigned char* colors, int nc_comps);
434 
436 
439  void DrawImageGL2PS(float p[2], vtkImageData* image);
440  void DrawImageGL2PS(float p[2], float scale, vtkImageData* image);
443 
445 
448  void DrawCircleGL2PS(float x, float y, float rX, float rY);
449  void DrawWedgeGL2PS(float x, float y, float outRx, float outRy, float inRx, float inRy);
451 
455  void AddEllipseToPath(vtkPath* path, float x, float y, float rx, float ry, bool reverse);
456 
460  void TransformPath(vtkPath* path) const;
461 
465  void TransformPoint(float& x, float& y) const;
466 
470  void TransformSize(float& dx, float& dy) const;
471 
472 private:
474  void operator=(const vtkOpenGLContextDevice2D&) = delete;
475 
482  vtkImageData* GetMarker(int shape, int size, bool highlight);
483 
484  class vtkMarkerCacheObject
485  {
486  public:
487  vtkTypeUInt64 Key;
488  vtkImageData* Value;
489  bool operator==(vtkTypeUInt64 key) { return this->Key == key; }
490  };
491 
492  void ComputeStringBoundsInternal(const vtkUnicodeString& string, float bounds[4]);
493 
494  vtkTransform* ProjectionMatrix;
495  vtkTransform* ModelMatrix;
496 
497  std::list<vtkMarkerCacheObject> MarkerCache;
498  int MaximumMarkerCacheSize;
499 
504  vtkImageData* GenerateMarker(int shape, int size, bool highlight);
505 };
506 
507 #endif // vtkOpenGLContextDevice2D_h
vtkOpenGLContextDevice2D::ReadyLinesCBOProgram
void ReadyLinesCBOProgram()
vtkOpenGLContextDevice2D::Private
Definition: vtkOpenGLContextDevice2DPrivate.h:270
vtkOpenGLContextDevice2D::ReadySBOProgram
void ReadySBOProgram()
vtkOpenGLContextDevice2D::ReadyVCBOProgram
void ReadyVCBOProgram()
vtkOpenGLContextDevice2D::BufferIdModeEnd
void BufferIdModeEnd() override
Finalize BufferId creation Mode.
vtkOpenGLContextDevice2D::SBO
vtkOpenGLHelper * SBO
Definition: vtkOpenGLContextDevice2D.h:405
vtkOpenGLContextDevice2D::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkOpenGLContextDevice2D::DrawPoints
void DrawPoints(float *points, int n, unsigned char *colors=nullptr, int nc_comps=0) override
Draw a series of points - fastest code path due to memory layout of the coordinates.
vtkOpenGLContextDevice2D::DrawPointSprites
void DrawPointSprites(vtkImageData *sprite, float *points, int n, unsigned char *colors=nullptr, int nc_comps=0) override
Draw a series of point sprites, images centred at the points supplied.
vtkOpenGLContextDevice2D::DrawPolyData
void DrawPolyData(float p[2], float scale, vtkPolyData *polyData, vtkUnsignedCharArray *colors, int scalarMode) override
Draw the supplied PolyData at the given x, y (p[0], p[1]) (bottom corner), scaled by scale (1....
vtkOpenGLContextDevice2D::GetModelMatrix
vtkMatrix4x4 * GetModelMatrix()
vtkX3D::scale
@ scale
Definition: vtkX3D.h:235
vtkOpenGLContextDevice2D::VTBO
vtkOpenGLHelper * VTBO
Definition: vtkOpenGLContextDevice2D.h:401
vtkOpenGLContextDevice2D::PolyDataImpl
CellArrayHelper * PolyDataImpl
Definition: vtkOpenGLContextDevice2D.h:384
vtkOpenGLContextDevice2D::LinePattern
unsigned short LinePattern
Definition: vtkOpenGLContextDevice2D.h:414
vtkOpenGLContextDevice2D::DrawImage
void DrawImage(float p[2], float scale, vtkImageData *image) override
Draw the supplied image at the given x, y (p[0], p[1]) (bottom corner), scaled by scale (1....
vtkX3D::type
@ type
Definition: vtkX3D.h:522
vtkOpenGLContextDevice2D::~vtkOpenGLContextDevice2D
~vtkOpenGLContextDevice2D() override
vtkOpenGLContextDevice2D::ReadyVBOProgram
void ReadyVBOProgram()
vtkOpenGLContextDevice2D::SetMatrix
void SetMatrix(vtkMatrix3x3 *m) override
Set the model view matrix for the display.
vtkOpenGLContextDevice2D::EnableClipping
void EnableClipping(bool enable) override
Disable clipping of the display.
vtkOpenGLContextDevice2D::LinesCBO
vtkOpenGLHelper * LinesCBO
Definition: vtkOpenGLContextDevice2D.h:393
vtkOpenGLContextDevice2D::SetColor4
void SetColor4(unsigned char color[4]) override
Set the color for the device using unsigned char of length 4, RGBA.
vtkOpenGLContextDevice2D::DrawString
void DrawString(float *point, const vtkUnicodeString &string) override
Draw some text to the screen.
vtkX3D::key
@ key
Definition: vtkX3D.h:263
vtkOpenGLContextDevice2D::DrawLines
void DrawLines(float *f, int n, unsigned char *colors=nullptr, int nc_comps=0) override
Draw lines using the points - memory layout is as follows: l1p1,l1p2,l2p1,l2p2...
vtkX3D::image
@ image
Definition: vtkX3D.h:380
vtkOpenGLContextDevice2D::DrawPlusMarkersGL2PS
void DrawPlusMarkersGL2PS(bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
vtkPath
concrete dataset representing a path defined by Bezier curves.
Definition: vtkPath.h:33
vtkUnsignedCharArray
dynamic, self-adjusting array of unsigned char
Definition: vtkUnsignedCharArray.h:36
vtkOpenGLContextDevice2D::CoreDrawTriangles
void CoreDrawTriangles(std::vector< float > &tverts, unsigned char *colors=nullptr, int numComp=0)
vtkOpenGLContextDevice2D::HasGLSL
bool HasGLSL()
Check whether the current context device has support for GLSL.
vtkOpenGLContextDevice2D::DrawCircleMarkersGL2PS
void DrawCircleMarkersGL2PS(bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
vtkStringToImage
base class for classes that render supplied text to an image.
Definition: vtkStringToImage.h:38
vtkOpenGLContextDevice2D::DrawImageGL2PS
void DrawImageGL2PS(float p[2], vtkImageData *image)
Embed an RGBA image in the GL2PS output at the supplied point.
vtkOpenGLContextDevice2D::PushMatrix
void PushMatrix() override
Push the current matrix onto the stack.
vtkOpenGLContextDevice2D::PopMatrix
void PopMatrix() override
Pop the current matrix off of the stack.
vtkOpenGLContextDevice2D::GetNumberOfArcIterations
int GetNumberOfArcIterations(float rX, float rY, float startAngle, float stopAngle)
Factorized code called by DrawEllipseWedge() and DrawEllipticArc() to figure out the number of iterat...
vtkTransform
describes linear transformations via a 4x4 matrix
Definition: vtkTransform.h:55
vtkMatrix3x3
represent and manipulate 3x3 transformation matrices
Definition: vtkMatrix3x3.h:34
vtkOpenGLContextDevice2D::VCBO
vtkOpenGLHelper * VCBO
Definition: vtkOpenGLContextDevice2D.h:397
vtkOpenGLContextDevice2D::ComputeJustifiedStringBounds
void ComputeJustifiedStringBounds(const char *string, float bounds[4]) override
Compute the bounds of the supplied string while taking into account the justification of the currentl...
vtkOpenGLContextDevice2D::DrawEllipseWedge
void DrawEllipseWedge(float x, float y, float outRx, float outRy, float inRx, float inRy, float startAngle, float stopAngle) override
Draw an elliptic wedge with center at x, y, outer radii outRx, outRy, inner radii inRx,...
vtkWindow
window superclass for vtkRenderWindow
Definition: vtkWindow.h:35
vtkOpenGLContextDevice2D::DrawMathTextString
void DrawMathTextString(float point[2], const vtkStdString &string) override
Draw text using MathText markup for mathematical equations.
vtkOpenGLContextDevice2D::BuildVBO
void BuildVBO(vtkOpenGLHelper *cbo, float *v, int nv, unsigned char *coolors, int nc, float *tcoords)
vtkOpenGLContextDevice2D::DrawMarkersGL2PS
void DrawMarkersGL2PS(int shape, bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
Draw the markers as paths/polydata instead of sprites for detailed GL2PS capture.
vtkAbstractContextBufferId
2D array of ids, used for picking.
Definition: vtkAbstractContextBufferId.h:47
vtkOpenGLContextDevice2D::BufferIdModeBegin
void BufferIdModeBegin(vtkAbstractContextBufferId *bufferId) override
Start BufferId creation Mode.
vtkX3D::color
@ color
Definition: vtkX3D.h:227
vtkOpenGLContextDevice2D::DrawImageGL2PS
void DrawImageGL2PS(float p[2], float scale, vtkImageData *image)
vtkX3D::points
@ points
Definition: vtkX3D.h:452
vtkOpenGLContextDevice2D::DrawCircleGL2PS
void DrawCircleGL2PS(float x, float y, float rX, float rY)
Inject smooth primitives into the GL2PS stream.
vtkX3D::point
@ point
Definition: vtkX3D.h:242
vtkOpenGLContextDevice2D::DrawImageGL2PS
void DrawImageGL2PS(const vtkRectf &rect, vtkImageData *image)
vtkOpenGLContextDevice2D::vtkOpenGLContextDevice2D
vtkOpenGLContextDevice2D()
vtkOpenGLContextDevice2D::DrawCrossMarkersGL2PS
void DrawCrossMarkersGL2PS(bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
vtkOpenGLContextDevice2D::ComputeStringBounds
void ComputeStringBounds(const vtkUnicodeString &string, float bounds[4]) override
Compute the bounds of the supplied string.
vtkOpenGLContextDevice2D::DrawMarkers
void DrawMarkers(int shape, bool highlight, float *points, int n, unsigned char *colors=nullptr, int nc_comps=0) override
Draw a series of markers centered at the points supplied.
vtkOpenGLContextDevice2D
Class for drawing 2D primitives using OpenGL 1.1+.
Definition: vtkOpenGLContextDevice2D.h:52
vtkOpenGLContextDevice2D::SCBO
vtkOpenGLHelper * SCBO
Definition: vtkOpenGLContextDevice2D.h:403
vtkOpenGLContextDevice2D::CellArrayHelper
Definition: vtkOpenGLContextDevice2DPrivate.h:528
vtkShaderProgram
The ShaderProgram uses one or more Shader objects.
Definition: vtkShaderProgram.h:45
vtkOpenGLContextDevice2D::SetMatrices
void SetMatrices(vtkShaderProgram *prog)
vtkOpenGLContextDevice2D::SetTexture
void SetTexture(vtkImageData *image, int properties=0) override
Set the texture for the device, it is used to fill the polygons.
vtkOpenGLHelper
Definition: vtkOpenGLHelper.h:31
vtkImageData
topologically and geometrically regular array of data
Definition: vtkImageData.h:42
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:34
vtkMatrix4x4
represent and manipulate 4x4 transformation matrices
Definition: vtkMatrix4x4.h:36
vtkUnicodeString
String class that stores Unicode text.
Definition: vtkUnicodeString.h:70
vtkOpenGLContextDevice2D::SetLineWidth
void SetLineWidth(float width) override
Set the line width for glyphs/sprites.
vtkOpenGLContextDevice2D::SetStringRendererToQt
bool SetStringRendererToQt()
Force the use of the Qt based string render strategy.
vtkOpenGLContextDevice2D::ComputeStringBounds
void ComputeStringBounds(const vtkStdString &string, float bounds[4]) override
Compute the bounds of the supplied string.
vtkOpenGLContextDevice2D::DrawDiamondMarkersGL2PS
void DrawDiamondMarkersGL2PS(bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
vtkX3D::size
@ size
Definition: vtkX3D.h:259
vtkOpenGLContextDevice2D::SetColor
virtual void SetColor(unsigned char color[3])
Set the color for the device using unsigned char of length 3, RGB.
vtkOpenGLContextDevice2D::Begin
void Begin(vtkViewport *viewport) override
Begin drawing, pass in the viewport to set up the view.
vtkOpenGLContextDevice2D::ReadySCBOProgram
void ReadySCBOProgram()
vtkOpenGLContextDevice2D::DrawPoly
void DrawPoly(float *f, int n, unsigned char *colors=nullptr, int nc_comps=0) override
Draw a poly line using the points - fastest code path due to memory layout of the coordinates.
vtkOpenGLContextDevice2D::DrawQuadStrip
void DrawQuadStrip(float *points, int n) override
Draws a rectangle.
vtkX3D::startAngle
@ startAngle
Definition: vtkX3D.h:492
operator==
VTKCOMMONCORE_EXPORT bool operator==(const vtkUnicodeString &lhs, const vtkUnicodeString &rhs)
vtkViewport
abstract specification for Viewports
Definition: vtkViewport.h:45
vtkOpenGLContextDevice2D::MultiplyMatrix
void MultiplyMatrix(vtkMatrix3x3 *m) override
Multiply the current model view matrix by the supplied one.
vtkOpenGLContextDevice2D::SetLineType
void SetLineType(int type) override
Set the line type type (using anonymous enum in vtkPen).
vtkOpenGLContextDevice2D::GetMatrix
void GetMatrix(vtkMatrix3x3 *m) override
Set the model view matrix for the display.
vtkContextDevice2D
Abstract class for drawing 2D primitives.
Definition: vtkContextDevice2D.h:51
vtkOpenGLContextDevice2D::DrawColoredPolygon
void DrawColoredPolygon(float *points, int numPoints, unsigned char *colors=nullptr, int nc_comps=0) override
Draw a polygon using the specified number of points.
vtkOpenGLContextDevice2D::ReadyVTBOProgram
void ReadyVTBOProgram()
vtkOpenGLContextDevice2D::DrawImage
void DrawImage(const vtkRectf &pos, vtkImageData *image) override
Draw the supplied image at the given position.
vtkOpenGLContextDevice2D::Renderer
vtkRenderer * Renderer
We need to store a pointer to the renderer for the text rendering.
Definition: vtkOpenGLContextDevice2D.h:370
vtkOpenGLContextDevice2D::SetPointSize
void SetPointSize(float size) override
Set the point size for glyphs/sprites.
vtkOpenGLContextDevice2D::DrawWedgeGL2PS
void DrawWedgeGL2PS(float x, float y, float outRx, float outRy, float inRx, float inRy)
vtkOpenGLContextDevice2D::ReleaseGraphicsResources
virtual void ReleaseGraphicsResources(vtkWindow *window)
Release any graphics resources that are being consumed by this device.
vtkOpenGLContextDevice2D::TransformSize
void TransformSize(float &dx, float &dy) const
Transform the width and height from pixels to data units.
vtkOpenGLContextDevice2D::Storage
Private * Storage
Definition: vtkOpenGLContextDevice2D.h:381
vtkOpenGLContextDevice2D::SetStringRendererToFreeType
bool SetStringRendererToFreeType()
Force the use of the freetype based render strategy.
vtkOpenGLContextDevice2D::LinesBO
vtkOpenGLHelper * LinesBO
Definition: vtkOpenGLContextDevice2D.h:395
vtkOpenGLContextDevice2D::SetClipping
void SetClipping(int *x) override
Supply an int array of length 4 with x1, y1, width, height specifying clipping region for the device ...
vtkRenderer
abstract specification for renderers
Definition: vtkRenderer.h:59
vtkOpenGLContextDevice2D::VBO
vtkOpenGLHelper * VBO
Definition: vtkOpenGLContextDevice2D.h:399
vtkPolyData
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:85
vtkOpenGLContextDevice2D::New
static vtkOpenGLContextDevice2D * New()
Creates a 2D Painter object.
vtkOpenGLContextDevice2D::DrawSquareMarkersGL2PS
void DrawSquareMarkersGL2PS(bool highlight, float *points, int n, unsigned char *colors, int nc_comps)
vtkOpenGLContextDevice2D::DrawString
void DrawString(float *point, const vtkStdString &string) override
Draw some text to the screen!
vtkOpenGLRenderWindow
OpenGL rendering window.
Definition: vtkOpenGLRenderWindow.h:52
vtkOpenGLContextDevice2D::DrawEllipticArc
void DrawEllipticArc(float x, float y, float rX, float rY, float startAngle, float stopAngle) override
Draw an elliptic arc with center at x,y with radii rX and rY between angles startAngle and stopAngle ...
vtkOpenGLContextDevice2D::InRender
bool InRender
Is the device currently rendering? Prevent multiple End() calls.
Definition: vtkOpenGLContextDevice2D.h:375
vtkOpenGLContextDevice2D::DrawPolygon
void DrawPolygon(float *, int) override
Draw a polygon using the specified number of points.
vtkStdString
Wrapper around std::string to keep symbols short.
Definition: vtkStdString.h:35
vtkOpenGLContextDevice2D::AddEllipseToPath
void AddEllipseToPath(vtkPath *path, float x, float y, float rx, float ry, bool reverse)
Add an ellipse to a vtkPath.
vtkOpenGLContextDevice2D::RenderWindow
vtkOpenGLRenderWindow * RenderWindow
The OpenGL render window being used by the device.
Definition: vtkOpenGLContextDevice2D.h:391
vtkOpenGLContextDevice2D::TransformPoint
void TransformPoint(float &x, float &y) const
Transform the 2D point using the current modelview matrix.
vtkRectf
Definition: vtkRect.h:327
vtkOpenGLContextDevice2D::GetProjectionMatrix
vtkMatrix4x4 * GetProjectionMatrix()
Get the projection matrix this is needed.
vtkOpenGLContextDevice2D::TransformPath
void TransformPath(vtkPath *path) const
Transform the path using the current modelview matrix.
vtkOpenGLContextDevice2D::End
void End() override
End drawing, clean up the view.
vtkOpenGLContextDevice2D::DrawQuad
void DrawQuad(float *points, int n) override
Draws a rectangle.
vtkContextDevice2D.h
vtkOpenGLContextDevice2D::ReadyLinesBOProgram
void ReadyLinesBOProgram()