casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
GLPixelCanvas.h
Go to the documentation of this file.
1 //# GLPixelCanvas.h: Class defining OpenGL version PixelCanvas.
2 //# Copyright (C) 2001
3 //# Associated Universities, Inc. Washington DC, USA.
4 //#
5 //# This library is free software; you can redistribute it and/or modify it
6 //# under the terms of the GNU Library General Public License as published by
7 //# the Free Software Foundation; either version 2 of the License, or (at your
8 //# option) any later version.
9 //#
10 //# This library is distributed in the hope that it will be useful, but WITHOUT
11 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
13 //# License for more details.
14 //#
15 //# You should have received a copy of the GNU Library General Public License
16 //# along with this library; if not, write to the Free Software Foundation,
17 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
18 //#
19 //# Correspondence concerning AIPS++ should be addressed as follows:
20 //# Internet email: aips2-request@nrao.edu.
21 //# Postal address: AIPS++ Project Office
22 //# National Radio Astronomy Observatory
23 //# 520 Edgemont Road
24 //# Charlottesville, VA 22903-2475 USA
25 //#
26 //# $Id $
27 
28 #ifndef TRIALDISPLAY_GLPIXELCANVAS_H
29 #define TRIALDISPLAY_GLPIXELCANVAS_H
30 
31 #include <casa/aips.h>
32 #include <graphics/X11/X_enter.h>
33 #include <X11/Xlib.h>
34 #include <X11/Intrinsic.h>
35 #include <X11/Xutil.h>
36 #include <GL/gl.h>
37 #include <GL/glx.h>
38 #include <graphics/X11/X_exit.h>
39 
40 #include <display/Display/PixelCanvas.h>
41 #include <display/Display/GLPixelCanvasColorTable.h>
42 #include <display/Display/GLSupport.h>
43 
44 namespace casa { //# NAMESPACE CASA - BEGIN
45 
46  class GLPCDisplayList;
47  class GLPCDisplayListEntry;
48  class GLPCDisplayListElement;
49  class GLPCTextureParams;
50 
51 // <summary>
52 // OpenGL implementation of PixelCanvas.
53 // </summary>
54 
55 // <use visibility=export>
56 
57 // <prerequisite>
58 // <li> <linkto class="PixelCanvasColorTable">PixelCanvasColorTable</linkto>
59 // <li> <linkto class="GLPixelCanvasColorTable">GLPixelCanvasColorTable</linkto>
60 // <li> <linkto class="PixelCanvas">PixelCanvas</linkto>
61 // <li> <linkto class="X11PixelCanvas"> Knowledge of X11PixelCanvas could help</linkto>
62 // </prerequisite>
63 //
64 // <synopsis>
65 // Implementation of PixelCanvas for OpenGL. Most, but not all of the
66 // PixelCanvas functions are available. There is very little support for
67 // 3D.
68 // </synopsis>
69 // <thrown>
70 // None
71 // </thrown>
72 // <todo asof="2001/09/25">
73 //# <li>
74 // </todo>
75 
76  class GLPixelCanvas : public PixelCanvas {
77  public:
78 // <note role=caution>
79 // Drawing can not take place until the window exists!
80 // </note>
81  GLPixelCanvas(Widget parent, GLPixelCanvasColorTable * glpcctbl,
82  casacore::uInt width, casacore::uInt height);
83  virtual ~GLPixelCanvas();
84 
85  // enabling/disabling of event tracking (unimplemented)
86  // <group>
87  virtual void enableMotionEvents();
88  virtual void disableMotionEvents();
89  virtual void enablePositionEvents();
90  virtual void disablePositionEvents();
91  // </group>
92 
93  // Does this canvas support cached display lists? The user of the
94  // canvas should always check this, because undefined behaviour can
95  // result when an attempt is made to use a list on a PixelCanvas
96  // which does not support lists.
97  virtual casacore::Bool supportsLists();
98 
99  // begin caching display commands - return list ID
100  virtual casacore::uInt newList();
101  // end caching display commands
102  virtual void endList();
103  // (Cacheable) recall cached display commands
104  virtual void drawList(casacore::uInt list);
105  // translate all lists
106  virtual void translateAllLists(casacore::Int xt, casacore::Int yt);
107  // translate the list
108  virtual void translateList(casacore::uInt list, casacore::Int xt, casacore::Int yt);
109  // remove list from cache
110  virtual void deleteList(casacore::uInt list);
111  // flush all lists from the cache
112  virtual void deleteLists();
113  // return true if the list exists
114  virtual casacore::Bool validList(casacore::uInt list);
115 
116  // (Cacheable) Set the font to the recognizable font name. (unimplemented)
117  virtual casacore::Bool setFont(const casacore::String &fontName);
118  // (Cacheable) Draw text using that font aligned in some way to the
119  // position. (unimplemented)
120  virtual void drawText(casacore::Int x, casacore::Int y, const casacore::String &text,
121  Display::TextAlign alignment = Display::AlignCenter);
122 
123  // (Cacheable) Draw an array of 2D color data as a raster image for zoom = <1,1>
124  // <group>
125  virtual void drawImage(const casacore::Matrix<casacore::uInt> &data, casacore::Int x, casacore::Int y);
126  virtual void drawImage(const casacore::Matrix<casacore::Int> &data, casacore::Int x, casacore::Int y);
127  virtual void drawImage(const casacore::Matrix<casacore::uLong> &data, casacore::Int x, casacore::Int y);
128  virtual void drawImage(const casacore::Matrix<casacore::Float> &data, casacore::Int x, casacore::Int y);
129  virtual void drawImage(const casacore::Matrix<casacore::Double> &data, casacore::Int x, casacore::Int y);
130  // </group>
131  // (Cacheable) Draw an image using color indexes. If in RGB mode,
132  // the virtual colortable is used.
133  void GLPixelCanvas::drawIndexedImage( const casacore::Matrix<casacore::uInt> &data,
134  casacore::Float x=0.0, casacore::Float y=0.0, casacore::Float z=0.0,
135  casacore::Float xscl=1.0, casacore::Float yscl=1.0);
136  // (Cacheable) Draw an array of 2D color data as a raster image,
137  // taking note of the <src>casacore::Bool</src> mask.
138  // (opaqueMask ignored/unimplemented)
139  // <group>
140  virtual void drawImage(const casacore::Int &x, const casacore::Int &y,
141  const casacore::Matrix<casacore::uInt> &data,
142  const casacore::Matrix<casacore::Bool> &mask,
143  casacore::Bool opaqueMask=false);
144  // </group>
145 
146  // (Cacheable) Draw an array of 2D color data as a raster image for any positive integer zoom
147  // <group>
148  virtual void drawImage(const casacore::Matrix<casacore::uInt> &data, casacore::Int x, casacore::Int y,
149  casacore::uInt xzoom, casacore::uInt yzoom);
150  virtual void drawImage(const casacore::Matrix<casacore::Int> &data, casacore::Int x, casacore::Int y,
151  casacore::uInt xzoom, casacore::uInt yzoom);
152  virtual void drawImage(const casacore::Matrix<casacore::uLong> &data, casacore::Int x, casacore::Int y,
153  casacore::uInt xzoom, casacore::uInt yzoom);
154  virtual void drawImage(const casacore::Matrix<casacore::Float> &data, casacore::Int x, casacore::Int y,
155  casacore::uInt xzoom, casacore::uInt yzoom);
156  virtual void drawImage(const casacore::Matrix<casacore::Double> &data, casacore::Int x, casacore::Int y,
157  casacore::uInt xzoom, casacore::uInt yzoom);
158  // </group>
159 
160  // (Cacheable) Draw a component of a multi-channel image, storing it
161  // in buffers until flushComponentImages() is called.
162  virtual void drawImage(const casacore::Matrix<casacore::uInt> &data, const casacore::Int &x, const casacore::Int &y,
163  const Display::ColorComponent &colorcomponent);
164 
165  // Fill one of the channel buffers.
166  virtual void bufferComponent(const casacore::Matrix<casacore::uInt> &data,
167  const casacore::Int &x, const casacore::Int &y,
168  const Display::ColorComponent
169  &colorcomponent);
170 
171  // (NOT CACHEABLE!) Flush the component buffers.
172  virtual void flushComponentBuffers();
173 
174  // (Cacheable) Draw a single point using current color
175  // <group>
176  virtual void drawPoint(casacore::Int x1, casacore::Int y1);
177  virtual void drawPoint(casacore::Float x1, casacore::Float y1);
178  virtual void drawPoint3D(casacore::Float x1, casacore::Float y1, casacore::Float z1);
179  virtual void drawPoint(casacore::Double x1, casacore::Double y1);
180  // </group>
181 
182  // (Cacheable) Draw N points specified as a Nx2 matrix
183  // <group>
184  virtual void drawPoints(const casacore::Matrix<casacore::Int> &verts);
185  virtual void drawPoints(const casacore::Matrix<casacore::Float> &verts);
186  void drawPoints3D(const casacore::Matrix<casacore::Float> &verts);
187  virtual void drawPoints(const casacore::Matrix<casacore::Double> &verts);
188  // </group>
189 
190  // (Cacheable) Draw a bunch of points using current color
191  // <group>
192  virtual void drawPoints(const casacore::Vector<casacore::Int> &x1, const casacore::Vector<casacore::Int> &y1);
193  virtual void drawPoints(const casacore::Vector<casacore::Float> &x1,
194  const casacore::Vector<casacore::Float> &y1);
195  virtual void drawPoints3D(const casacore::Vector<casacore::Float> &x1,
196  const casacore::Vector<casacore::Float> &y1, const casacore::Vector<casacore::Float> &z1);
197  virtual void drawPoints(const casacore::Vector<casacore::Double> &x1,
198  const casacore::Vector<casacore::Double> &y1);
199  // </group>
200 // (cacheable) Change the size of the points (in pixels) drawn by drawPoints.
201  void setPointSize(const casacore::uInt pointsize);
202 
203  // (Cacheable) Draw a single line using current color
204  // <group>
205  virtual void drawLine(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
206  virtual void drawLine(casacore::Float x1, casacore::Float y1, casacore::Float x2, casacore::Float y2);
207  virtual void drawLine3D(casacore::Float x1, casacore::Float y1, casacore::Float z1,
208  casacore::Float x2, casacore::Float y2, casacore::Float z2);
209  virtual void drawLine(casacore::Double x1, casacore::Double y1, casacore::Double x2, casacore::Double y2);
210  // </group>
211 
212  // (Cacheable) Draw N/2 lines from an Nx2 matrix
213  // <group>
214  virtual void drawLines(const casacore::Matrix<casacore::Int> &verts);
215  virtual void drawLines(const casacore::Matrix<casacore::Float> &verts);
216  virtual void drawLines3D(const casacore::Matrix<casacore::Float> &verts);
217  virtual void drawLines(const casacore::Matrix<casacore::Double> &verts);
218  // </group>
219 
220  // (Cacheable) Draw a bunch of unrelated lines using current color
221  // <group>
222  virtual void drawLines(const casacore::Vector<casacore::Int> &x1, const casacore::Vector<casacore::Int> &y1,
223  const casacore::Vector<casacore::Int> &x2, const casacore::Vector<casacore::Int> &y2);
224  virtual void drawLines(const casacore::Vector<casacore::Float> &x1, const casacore::Vector<casacore::Float> &y1,
225  const casacore::Vector<casacore::Float> &x2,
226  const casacore::Vector<casacore::Float> &y2);
227  virtual void drawLines(const casacore::Vector<casacore::Double> &x1, const casacore::Vector<casacore::Double> &y1,
228  const casacore::Vector<casacore::Double> &x2,
229  const casacore::Vector<casacore::Double> &y2);
230  // </group>
231 
232  // (Cacheable) Draw a single connected line between the given points.
233  // <group>
234  virtual void drawPolyline(const casacore::Vector<casacore::Int> &x1,
235  const casacore::Vector<casacore::Int> &y1);
236  virtual void drawPolyline(const casacore::Vector<casacore::Float> &x1,
237  const casacore::Vector<casacore::Float> &y1);
238  virtual void drawPolyline3D(const casacore::Vector<casacore::Float> &x1,
239  const casacore::Vector<casacore::Float> &y1,
240  const casacore::Vector<casacore::Float> &z1);
241  virtual void drawPolyline(const casacore::Vector<casacore::Double> &x1,
242  const casacore::Vector<casacore::Double> &y1);
243  // </group>
244 
245  // (Cacheable) Draw N-1 connected lines from Nx2 matrix of vertices
246  // <group>
247  virtual void drawPolyline(const casacore::Matrix<casacore::Int> &verts);
248  virtual void drawPolyline(const casacore::Matrix<casacore::Float> &verts);
249  virtual void drawPolyline(const casacore::Matrix<casacore::Double> &verts);
250  // </group>
251 
252  // (Cacheable) Draw a closed polygon
253  // <group>
254  virtual void drawPolygon(const casacore::Vector<casacore::Int> &x1, const casacore::Vector<casacore::Int> &y1);
255  virtual void drawPolygon(const casacore::Vector<casacore::Float> &x1,
256  const casacore::Vector<casacore::Float> &y1);
257  virtual void drawPolygon3D(const casacore::Vector<casacore::Float> &x1,
258  const casacore::Vector<casacore::Float> &y1,
259  const casacore::Vector<casacore::Float> &z1);
260  virtual void drawPolygon(const casacore::Vector<casacore::Double> &x1,
261  const casacore::Vector<casacore::Double> &y1);
262  // </group>
263 
264  // (Cacheable) Draw and fill a closed polygon
265  // <group>
266  virtual void drawFilledPolygon(const casacore::Vector<casacore::Int> &x1,
267  const casacore::Vector<casacore::Int> &y1);
268  virtual void drawFilledPolygon(const casacore::Vector<casacore::Float> &x1,
269  const casacore::Vector<casacore::Float> &y1);
270  virtual void drawFilledPolygon3D(const casacore::Vector<casacore::Float> &x1,
271  const casacore::Vector<casacore::Float> &y1,
272  const casacore::Vector<casacore::Float> &z1);
273  virtual void drawFilledPolygon(const casacore::Vector<casacore::Double> &x1,
274  const casacore::Vector<casacore::Double> &y1);
275  // </group>
276 
277  // (Cacheable) Draw a closed N-sided polygon from Nx2 matrix of vertices
278  // <group>
279  virtual void drawPolygon(const casacore::Matrix<casacore::Int> &verts);
280  virtual void drawPolygon(const casacore::Matrix<casacore::Float> &verts);
281  virtual void drawPolygon3D(const casacore::Matrix<casacore::Float> &verts);
282  virtual void drawPolygon(const casacore::Matrix<casacore::Double> &verts);
283  // </group>
284 
285  // (Cacheable) Draw a rectangle
286  // <group>
287  virtual void drawRectangle(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
288  virtual void drawRectangle(casacore::Float x1, casacore::Float y1, casacore::Float x2, casacore::Float y2);
289  virtual void drawRectangle(casacore::Double x1, casacore::Double y1, casacore::Double x2, casacore::Double y2);
290  // </group>
291 
292  // (Cacheable) Draw a filled rectangle
293  // <group>
294  virtual void drawFilledRectangle(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
295  virtual void drawFilledRectangle(casacore::Float x1, casacore::Float y1, casacore::Float x2, casacore::Float y2);
296  virtual void drawFilledRectangle(casacore::Double x1, casacore::Double y1, casacore::Double x2,
297  casacore::Double y2);
298  // </group>
299 
300  // (Cacheable) Draw a set of points, specifying a color per point to be drawn.
301  // <group>
302  virtual void drawColoredPoints(const casacore::Vector<casacore::Int> &x1,
303  const casacore::Vector<casacore::Int> &y1,
304  const casacore::Vector<casacore::uInt> &colors);
305  virtual void drawColoredPoints(const casacore::Vector<casacore::Float> &x1,
306  const casacore::Vector<casacore::Float> &y1,
307  const casacore::Vector<casacore::uInt> &colors);
308  virtual void drawColoredPoints(const casacore::Vector<casacore::Double> &x1,
309  const casacore::Vector<casacore::Double> &y1,
310  const casacore::Vector<casacore::uInt> &colors);
311  virtual void drawColoredPoints(const casacore::Matrix<casacore::Int> &xy,
312  const casacore::Vector<casacore::uInt> &colors);
313  virtual void drawColoredPoints(const casacore::Matrix<casacore::Float> &xy,
314  const casacore::Vector<casacore::uInt> &colors);
315 
316  virtual void drawColoredPoints(const casacore::Matrix<casacore::Double> &xy,
317  const casacore::Vector<casacore::uInt> &colors);
318 
319  // </group>
320 
321  // (Cacheable) Draw a set of lines, specifying a color per line to be drawn.
322  // <group>
323  virtual void drawColoredLines(const casacore::Vector<casacore::Int> &x1,
324  const casacore::Vector<casacore::Int> &y1,
325  const casacore::Vector<casacore::Int> &x2,
326  const casacore::Vector<casacore::Int> &y2,
327  const casacore::Vector<casacore::uInt> &colors);
328  virtual void drawColoredLines(const casacore::Vector<casacore::Float> &x1,
329  const casacore::Vector<casacore::Float> &y1,
330  const casacore::Vector<casacore::Float> &x2,
331  const casacore::Vector<casacore::Float> &y2,
332  const casacore::Vector<casacore::uInt> &colors);
333  virtual void drawColoredLines(const casacore::Vector<casacore::Double> &x1,
334  const casacore::Vector<casacore::Double> &y1,
335  const casacore::Vector<casacore::Double> &x2,
336  const casacore::Vector<casacore::Double> &y2,
337  const casacore::Vector<casacore::uInt> &colors);
338  // </group>
339 
340  // Set Graphics Attributes
341  // Options for functions with enum argument
342  // listed in <linkto class=Display>DisplayEnums</linkto>
343  // <group>
344  virtual void setForeground(casacore::uLong color);
345  virtual void setLineWidth(casacore::Float width);
346  virtual void setLineStyle(Display::LineStyle style);
347  virtual void setFillStyle(Display::FillStyle style);
348  virtual void setDrawFunction(Display::DrawFunction function);
349  // </group>
350 
351  // Unimplemented set graphics functions.
352  // <group>
353  virtual void setBackground(casacore::uLong color);
354  virtual void setCapStyle(Display::CapStyle style);
355  virtual void setJoinStyle(Display::JoinStyle style);
356  virtual void setFillRule(Display::FillRule rule);
357  virtual void setArcMode(Display::ArcMode mode);
358  // </group>
359 
360  // Implemented get Graphics Attributes functions.
361  // <group>
362  virtual casacore::uLong getForeground() const;
363  virtual casacore::Float getLineWidth() const;
364  virtual Display::LineStyle getLineStyle() const;
365  virtual Display::FillStyle getFillStyle() const;
366  virtual Display::DrawFunction getDrawFunction() const;
367  // </group>
368  // Unimplemented get Graphics Attributes.
369  // <group>
370  virtual casacore::uLong getBackground() const;
371  virtual Display::CapStyle getCapStyle() const;
372  virtual Display::JoinStyle getJoinStyle() const;
373  virtual Display::FillRule getFillRule() const;
374  virtual Display::ArcMode getArcMode() const;
375  // </group>
376 
377  // (Cacheable) Option Control
378  // Options listed in <linkto class=Display>DisplayEnums</linkto>
379  // Only Display::ClipWindow is implemented.
380  // <group>
381  virtual casacore::Bool enable(Display::Option option);
382  virtual casacore::Bool disable(Display::Option option);
383  // </group>
384 
385  // Control the image-caching strategy. (Ignored)
386  virtual void setImageCacheStrategy(Display::ImageCacheStrategy strategy);
387  virtual Display::ImageCacheStrategy imageCacheStrategy() const;
388 
389  // (Cacheable) Setup the clip window. The clip window, when enabled, allows
390  // a user to clip all graphics output to a rectangular region on
391  // the screen.
392  // <group>
393  virtual void setClipWindow(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
394  virtual void getClipWindow(casacore::Int &x1, casacore::Int &y1, casacore::Int &x2, casacore::Int &y2);
395  // </group>
396 
397  // (Not Cacheable) Redraw the window
398  // <group>
399  void redraw() {
400  repaint(true);
401  }
402  virtual void refresh(const Display::RefreshReason &reason =
403  Display::UserCommand,
404  const casacore::Bool &explicitrequest = true);
405  // Just redraws window. (If redraw is T, the window will be redrawn. If
406  // F, it will only be redrawn if autoRefresh is T.
407  void repaint(const casacore::Bool redraw=false);
408  // </group>
409 
410  // Cause display to flush any graphics commands not yet drawn
411  virtual void flush();
412 
413  // (Cacheable) Clear the window using the background color
414  // <note role=tip> If you want to clear the window use clear(),
415  // not clear(IIII).
416  // </note>
417  // <group>
418  virtual void clear();
419  virtual void clear(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
420  // </group>
421 
422  // (Cacheable) Set the color to use for clearing the display
423  // <group>
424  virtual void setClearColor(casacore::uInt colorIndex);
425  // <note role=caution> Setting named colors for Index mode isn't implemented.
426  // </note>
427  virtual void setClearColor(const casacore::String &colorname);
428  virtual void setClearColor(float r, float g, float b);
429  // </group>
430 
431  // (Not Cacheable) Get the current color to use for clearing the display.
432  virtual casacore::uInt clearColor() const;
433  virtual void getClearColor(float &r, float &g, float &b) const;
434 
435  // Get/set the current foreground/background colors. These colors
436  // should be used when the special Strings "foreground" and "background"
437  // are given for a color.
438  // <group>
439  virtual void setDeviceForegroundColor(const casacore::String colorname);
440  virtual casacore::String deviceForegroundColor() const;
441  virtual void setDeviceBackgroundColor(const casacore::String colorname);
442  virtual casacore::String deviceBackgroundColor() const;
443  // </group>
444 
445  // Return the width of the GLPixelCanvas in pixels
446  virtual casacore::uInt width() const;
447  // Return the height of the GLPixelCanvas in pixels
448  virtual casacore::uInt height() const;
449  // Return the depth of the GLPixelCanvas in bits
450  virtual casacore::uInt depth() const;
451  // Get the pixel density (in dots per inch [dpi]) of the GLPixelCanvas
452  // <note role=tip> The X server is queried. It may or may not have the
453  // correct answer. </note>
454  virtual void pixelDensity(casacore::Float &xdpi, casacore::Float &ydpi) const;
455 
456  // (Cacheable) Set current color (works in RGB or colormap mode)
457  // <group>
458  // <note role=tip> setColor(colorIndex) when called in RGB mode gets the
459  // RGB values from the virtual color table. setForeground assumes the
460  // value is a packed pixel. </note>
461  virtual void setColor(casacore::uInt colorIndex);
462  virtual void setColor(const casacore::String &colorname);
463  // <note role=caution> Calling setRGBColor when in Index mode ignores
464  // r, g & b and uses the current index value. </note>
465  virtual void setRGBColor(float r, float g, float b);
466  // </group>
467 
468  // Get color components in range 0 to 1 without actually
469  // allocating the color. This is needed to set up other
470  // devices, for example PgPlot.
471  virtual casacore::Bool getColorComponents(const casacore::String &colorname, casacore::Float &r,
472  casacore::Float &g, casacore::Float &b);
473 
474  // (Not Cacheable) Returns the current color as a color index
475  // <note> In RGB mode, this is only valid if setColor(index) has
476  // been called. </note>
477  virtual casacore::uInt color() const;
478 
479  // (Not Cacheable) Retuns the current color as an RGB triple
480  virtual void getColor(float &r, float &g, float &b) const;
481 
482  // (Not Cacheable) Get color index value (works in RGB or colormap mode)
483  // <note role=tip> Don't bother. No existing canvas implements these.
484  // </note>
485  // <group>
486  virtual casacore::Bool getColor(casacore::Int x, casacore::Int y, casacore::uInt &color);
487  // This should be removed since no one implements it.
488  virtual casacore::Bool getRGBColor(casacore::Int x, casacore::Int y, float &r, float &g, float &b);
489  // </group>
490 
491  // (Not Cacheable) resize request. returns true if window was resized.
492  // Will refresh if doCallbacks is true.
493  virtual casacore::Bool resize(casacore::uInt reqXSize, casacore::uInt reqYSize, casacore::Bool doCallbacks = true);
494 
495  // (Not Cacheable) resize the colortable by requesting a new number of cells
496  virtual casacore::Bool resizeColorTable(casacore::uInt newSize);
497 
498  // (Not Cacheable) resize the colortable by requesting a new RGB/HSV cube
499  virtual casacore::Bool resizeColorTable(casacore::uInt nReds, casacore::uInt nGreens, casacore::uInt nBlues);
500 
501  // Need a mechanism to return the GLPixelCanvasColorTable so
502  // drawing functions within classes can operate.
503  virtual GLPixelCanvasColorTable * glpcctbl() const {
504  return glpcctbl_;
505  }
506  // Return the pixel canvas color table
507  PixelCanvasColorTable * pcctbl() const {
508  return glpcctbl_;
509  }
510 
511  void setPcctbl(PixelCanvasColorTable * pcctbl) {
512  glpcctbl_ = (GLPixelCanvasColorTable *) pcctbl;
513  }
514 
515  // save/restore the current translation. This is called pushMatrix because
516  // eventually we may want scaling or rotation to play a modest
517  // role here.
518  // <note role=tip> GLPixelCanvas uses OpenGL's push/pop matrix. </note>
519  // <group>
520  virtual void pushMatrix();
521  virtual void popMatrix();
522  // </group>
523  // zero the current translation
524  virtual void loadIdentity();
525 
526  // translation functions
527  // translate applies a relative translation to the current matrix and
528  // can be used to position graphics. Together with pushMatrix and
529  // popMatrix it can be used to build heirarchical scenes.
530  // <group>
531  virtual void translate(casacore::Int xt, casacore::Int yt);
532  // <note role=tip> get/x/yTranslation are not currently implemented. </note>
533  virtual void getTranslation(casacore::Int &xt, casacore::Int &yt) const;
534  virtual casacore::Int xTranslation() const;
535  virtual casacore::Int yTranslation() const;
536  // </group>
537 
538  // (Not cacheable) set the draw buffer
539  // <note role=caution> The draw buffer is always set to BACK if double
540  // buffered and FRONT if single buffered. </note>
541  virtual void setDrawBuffer(Display::DrawBuffer buf);
542  // buffer memory exchanges
543  // (Not cacheable)
544  // <group>
545  // <note role=caution> Of this group, only swapbuffers() works. </note>
546  static void copyBuffer(GLenum from, GLenum to,
547  GLint x, GLint y,
548  GLsizei width, GLsizei height);
549  void copyBuffer(GLenum from, GLenum to);
550  virtual void copyBackBufferToFrontBuffer();
551  virtual void copyFrontBufferToBackBuffer();
552  virtual void swapBuffers();
553  // </group>
554 
555  // partial buffer memory exchanges. (x1,y1 are blc, x2,y2 are trc)
556  // None of these are implemented.
557  // <group>
558  virtual void copyBackBufferToFrontBuffer(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
559  virtual void copyFrontBufferToBackBuffer(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
560  virtual void swapBuffers(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2);
561  // </group>
562 
563  // return true if refresh is allowed right now...
564  virtual casacore::Bool refreshAllowed() const;
565 
566  // Make this canvas's context current.
567  // <note role=caution> This must be called when switching between
568  // GLPixelCanvases or else drawing will go to the wrong canvas. It is
569  // not needed unless more than one GLPixelCanvas is active at a time.
570  // </note>
571  void makeCurrent();
572  // Wait for X or GL commands to finish. Usually not needed.
573  // <group>
574  void waitX();
575  void waitGL();
576  // </group>
577  // Print any GL error messages.
578  // if msg is non NULL, it is printed first if there is an error.
579  // nspaces is the number of spaces to indent the text.
580  // Returns the number of errors. Usually only used internally.
581  // <group>
582  int glcheck(const char *msg=NULL, casacore::uInt nspaces=0);
583  static int glCheck(const char *msg=NULL, casacore::uInt nspaces=0);
584  // </group>
585 
586  // Various ways to draw images. Used internally.
587  // <group>
588  void drawTexturedImage(GLfloat x, GLfloat y, GLfloat z,
589  GLsizei width, GLsizei height,
590  GLfloat xscale, GLfloat yscale,
591  GLenum format, const GLushort *pixels,
592  GLPCTextureParams *params = NULL);
593 
594  void drawImagePixels( GLfloat x, GLfloat y, GLfloat z,
595  GLsizei width, GLsizei height,
596  GLfloat xscale, GLfloat yscale,
597  GLenum format, const GLushort *pixels);
598 
599  static void drawPixels(GLfloat x, GLfloat y, GLfloat z,
600  GLsizei width, GLsizei height,
601  GLfloat xscale, GLfloat yscale,
602  GLenum format, GLenum type,
603  const GLvoid *pixels);
604 
605  // Calls drawImagePixels if in indexed mode or drawTexturedImage if RGB.
606  void drawGLImage(GLfloat x, GLfloat y, GLfloat z,
607  GLsizei width, GLsizei height,
608  GLfloat xscale, GLfloat yscale,
609  GLenum format, const GLushort *pixels);
610 // </group>
611 
612  void bufferZValue(const casacore::Float z=0.0) {
613  itsComponentZ_ = z;
614  }
615 
616  // Tracing support. May be useful when debugging graphics code.
617  // <group>
618  // Turn tracing on/off.
619  void trace(Boolean trace) {
620  trace_ = trace;
621  }
622  Boolean tracing()const {
623  return trace_;
624  }
625  // Set trace level. (actually a mask). default is GLTraceNormal.
626  // NOT fully implemented.
627  void traceLevel(const casacore::uLong traceLevel) {
628  traceLevel_ = traceLevel;
629  }
630  casacore::uLong traceLevel()const {
631  return traceLevel_;
632  }
633  void postToStream(casacore::Bool p=false) {
634  log_.postToStream(p);
635  }
636  void postToString(casacore::String *s=NULL) {
637  log_.postToString(s);
638  }
639  void postString() {
640  log_.postString();
641  }
642  // Add a note entry to traced output.
643  void note(const char *note);
644  // </group>
645 
646  // Normally GLPixelCanvas repaints the window when it is damaged. If
647  // the user wishes to handle this, turn off auto refreshing.
648  // <group>
649  Boolean autoRefresh()const {
650  return autoRefresh_;
651  }
652  void autoRefresh(Boolean refresh) {
653  autoRefresh_ = refresh;
654  }
655  // </group>
656 
657  // OpenGL's push/popAttrib functions
658  void pushAttrib(const GLbitfield attrib);
659  void popAttrib();
660  Boolean doubleBuffered()const {
661  return doubleBuffered_;
662  }
663  Boolean isRGB()const {
664  return isRGB_;
665  }
666  protected:
667 
668  private:
669  // Handle the X expose event. This is caught by the pixel canvas
670  // and forwarded as a refresh event only if the pixel canvas changed
671  // dimensions. If there was no size change, the pixel canvas simply
672  // copies its pixmap to the display without generating a refresh.
673  void exposeHandler();
674 
675  // Called when window is resized.
676  void resizeHandler();
677  // Event Handling
678  // <group>
679  static void handleEventsCB(Widget w, GLPixelCanvas * xpc,
680  XEvent * ev, Boolean *);
681  void handleEvents(Widget w, XEvent * ev);
682  Boolean handleResizeEvent(casacore::uInt w, casacore::uInt h);
683  // handle colorTable resize
684  static void colorTableResizeCB(PixelCanvasColorTable * pcctbl, casacore::uInt,
685  GLPixelCanvas * xpc,
686  Display::RefreshReason reason);
687 
688  // </group>
689 
690  private:
691  void initComponents();
692 
693  // Internal handling of display lists.
694  // There is a list of GLPCDisplayLists. Item 0 always exists and is used
695  // to redraw the window after expose events. Any other entries are
696  // created in response to newList() calls.
697  // <group>
698  // Return a pointer to a new GLPC display list.
699  GLPCDisplayList *createList(const char *name=NULL);
700  // Create a new display list and add to the list of lists.
701  casacore::uInt makeList(const char *name=NULL);
702  // Grow the list.
703  void resizeList();
704  // Go through the list of display lists removing any unused lists.
705  void cleanLists();
706  // Called when the window is resized or cleared. Deletes the repaint
707  // list.
708  void purgeLists();
709  // Remove a display list from list of lists. Returns true if list
710  // was removed. false if listid is invalid or list has already been removed.
711  Boolean removeList(casacore::uInt listid);
712  // Called to begin caching.
713  void beginListEntry(const char *name=NULL);
714  void beginListEntry(GLPCDisplayListElement *e);
715  // Called to end caching.
716  void endListEntry();
717  // </group>
718 
719  // Print <name> if tracing is turned on.
720  // Most user callable drawing routines call this.
721  // <group>
722  void traceCheck(const char *name, casacore::uLong traceLevel, casacore::uInt nspaces);
723  void traceCheck(const char *name, casacore::uLong traceLevel) {
724  traceCheck(name, traceLevel, nspaces_);
725  }
726  // </group>
727  // Holds both a color index and RGBA values.
728  class GLPCColorValue {
729  public:
730  GLPCColorValue() {
731  index=0;
732  red=green=blue=0.0;
733  alpha=1.0;
734  }
735  casacore::uLong index; // Index for PseudoColor, packed for RGB.
736  casacore::Float red, green, blue, alpha;
737  };
738  // Store the new value in the struct.
739  // If RGB mode, index is interpreted as a packed RGB value.
740  void storeColorValue(GLPCColorValue &v, casacore::uLong value);
741  // If RGB mode, index is interpreted as an index into the virtual CT.
742  void storeColorIndex(GLPCColorValue &v, casacore::uInt index);
743  void storeColorValue(GLPCColorValue &v, casacore::Float r, casacore::Float g, casacore::Float b);
744  void storeColorValue(GLPCColorValue &v,
745  casacore::Float r, casacore::Float g, casacore::Float b, casacore::Float a);
746  // index is always treated as an index. (In RGB mode, the virtual
747  // color table is used.
748  void setCurrentColorIndex(casacore::uInt index, const char *name=NULL);
749  void setCurrentColorValue(casacore::uLong value, const char *name=NULL);
750  void setCurrentColorValue(casacore::Float r, casacore::Float g, casacore::Float b,
751  const char *name=NULL);
752  void setCurrentColorValue(casacore::Float r, casacore::Float g, casacore::Float b, casacore::Float a,
753  const char *name=NULL);
754  void setCurrentColorValue(const GLPCColorValue &v, const char *name=NULL);
755 
756  void setClearColorIndex(casacore::uInt index, const char *name=NULL);
757  void setClearColorValue(casacore::uLong index, const char *name=NULL);
758  void setClearColorValue(casacore::Float r, casacore::Float g, casacore::Float b,
759  const char *name=NULL);
760  void setClearColorValue(casacore::Float r, casacore::Float g, casacore::Float b, casacore::Float a,
761  const char *name=NULL);
762  // Tell OpenGL to use the given color index or RGB value depending
763  // on whether we're in Index or RGB mode. If name is not NULL,
764  // wrap the call in the usual begin/endListEntry, tracecheck.
765  void setClearColorValue(const GLPCColorValue &v, const char *name=NULL);
766 
767  // Internal versions of public functions
768  void drawColoredPoints_(const char *Name, const casacore::Vector<casacore::Int> &x1,
769  const casacore::Vector<casacore::Int> &y1,
770  const casacore::Vector<casacore::uInt> &colors);
771  void drawColoredPoints_(const char *Name, const casacore::Vector<casacore::Float> &x1,
772  const casacore::Vector<casacore::Float> &y1,
773  const casacore::Vector<casacore::uInt> &colors);
774  void drawColoredPoints_(const char *Name, const casacore::Vector<casacore::Double> &x1,
775  const casacore::Vector<casacore::Double> &y1,
776  const casacore::Vector<casacore::uInt> &colors);
777  void pRWbuf(const char *str=NULL, int nspaces=0);
778  // Routines to print warnings.
779  void warn(const char *routine, const char *msg,
780  const SourceLocation *where)const;
781  void unimplemented(const char *routine, const SourceLocation *where)const;
782 
783  private:
784  ::XDisplay *display_;
785  Widget parent_;
786  Widget form_;
787  Widget drawArea_;
788  XVisualInfo *visualInfo_;
789  Visual *visual_;
790  casacore::uInt BlackPixel_;
791  // GL information.
792  casacore::Bool doubleBuffered_;
793  casacore::Bool isRGB_; // If not, it's indexed.
794  //
795  GLPixelCanvasColorTable *glpcctbl_;
796  GLXContext context_;
797  GLbitfield bufferMask_;
798  casacore::uInt width_;
799  casacore::uInt height_;
800  casacore::uInt depth_;
801  Boolean doClipping_;
802  casacore::Int clipX1_, clipY1_;
803  casacore::Int clipX2_, clipY2_;
804  casacore::String itsDeviceForegroundColor_, itsDeviceBackgroundColor_;
806  GLPCColorValue currentColor_;
807  // Clear color.
808  GLPCColorValue clearColor_;
809 
810  Display::LineStyle lineStyle_; // Store style types
811  Display::FillStyle fillStyle_; // for 'get's.
813  Boolean exposeHandlerFirstTime_;
814  // Component / multi-channel buffers etc.
815  casacore::uShort *itsComponents_; // Length = 3*width*height.
816  casacore::Float itsComponentX_, itsComponentY_, itsComponentZ_;
817  casacore::Float itsComponentScaleX_, itsComponentScaleY_;
818  casacore::uLong itsComponentWidth_, itsComponentHeight_;
819  // Display lists.
820  casacore::uInt listSize_;
821  casacore::uInt numinuse_;
822  casacore::uInt nextfree_;
823  casacore::uInt sizeincr_;
824  casacore::uInt currentListID_; // Current display list id.
825  GLPCDisplayList **dlists_; // casacore::List of display lists.
826  GLPCDisplayListElement *currentElement_; // Current caching element.
827 
828  Boolean trace_; // Print tracing info?
829  casacore::uLong traceLevel_;
830  casacore::uInt nspaces_; // # of spaces to indent trace printout.
831  mutable GLLogIO log_;
832  Boolean autoRefresh_;
833  };
834 
835 
836 } //# NAMESPACE CASA - END
837 
838 #endif
casa::GLPixelCanvas::drawColoredLines
virtual void drawColoredLines(const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1, const casacore::Vector< casacore::Int > &x2, const casacore::Vector< casacore::Int > &y2, const casacore::Vector< casacore::uInt > &colors)
(Cacheable) Draw a set of lines, specifying a color per line to be drawn.
casa::GLPixelCanvas::setLineStyle
virtual void setLineStyle(Display::LineStyle style)
casa::GLPixelCanvas::waitX
void waitX()
Wait for X or GL commands to finish.
casa::GLPixelCanvas::getDrawFunction
virtual Display::DrawFunction getDrawFunction() const
Get Graphics Attributes.
casa::GLPixelCanvas::drawImagePixels
void drawImagePixels(GLfloat x, GLfloat y, GLfloat z, GLsizei width, GLsizei height, GLfloat xscale, GLfloat yscale, GLenum format, const GLushort *pixels)
casacore::Int
int Int
Definition: aipstype.h:50
casa::GLPixelCanvas::itsDeviceForegroundColor_
casacore::String itsDeviceForegroundColor_
Definition: GLPixelCanvas.h:804
casa::GLPixelCanvas::itsDeviceBackgroundColor_
casacore::String itsDeviceBackgroundColor_
Definition: GLPixelCanvas.h:804
casa::GLPixelCanvas::bufferComponent
virtual void bufferComponent(const casacore::Matrix< casacore::uInt > &data, const casacore::Int &x, const casacore::Int &y, const Display::ColorComponent &colorcomponent)
Fill one of the channel buffers.
casa::GLPixelCanvas::setForeground
virtual void setForeground(casacore::uLong color)
Set Graphics Attributes Options for functions with enum argument listed in DisplayEnums.
casa::PixelCanvasColorTable
Abstract interface to underlying graphics library&#39;s colortable.
Definition: PixelCanvasColorTable.h:105
casa::GLPixelCanvas::setCapStyle
virtual void setCapStyle(Display::CapStyle style)
casa::GLPixelCanvas::nspaces_
casacore::uInt nspaces_
Definition: GLPixelCanvas.h:830
casa::GLPixelCanvas::tracing
Boolean tracing() const
Definition: GLPixelCanvas.h:622
casa::GLPixelCanvas::setRGBColor
virtual void setRGBColor(float r, float g, float b)
Caution: Calling setRGBColor when in Index mode ignores r, g &amp; b and uses the current index value; ...
casa::GLPixelCanvas::glcheck
int glcheck(const char *msg=NULL, casacore::uInt nspaces=0)
Print any GL error messages.
casa::GLPixelCanvas::clipX1_
casacore::Int clipX1_
Definition: GLPixelCanvas.h:802
casa::GLPixelCanvas::getColorComponents
virtual casacore::Bool getColorComponents(const casacore::String &colorname, casacore::Float &r, casacore::Float &g, casacore::Float &b)
Get color components in range 0 to 1 without actually allocating the color.
casa::GLPixelCanvas::itsComponentWidth_
casacore::uLong itsComponentWidth_
Definition: GLPixelCanvas.h:818
casa::GLLogIO::postString
void postString()
If an output string exists, copy it to an output stream if it exists.
casa::GLPixelCanvas::refresh
virtual void refresh(const Display::RefreshReason &reason=Display::UserCommand, const casacore::Bool &explicitrequest=true)
casa::GLPixelCanvas::swapBuffers
virtual void swapBuffers()
casa::GLPixelCanvas::storeColorIndex
void storeColorIndex(GLPCColorValue &v, casacore::uInt index)
If RGB mode, index is interpreted as an index into the virtual CT.
casa::GLPixelCanvas::width_
casacore::uInt width_
Definition: GLPixelCanvas.h:798
casa::GLPixelCanvas::copyFrontBufferToBackBuffer
virtual void copyFrontBufferToBackBuffer()
casa::GLPixelCanvas::endListEntry
void endListEntry()
Called to end caching.
casacore::mask
LatticeExprNode mask(const LatticeExprNode &expr)
This function returns the mask of the given expression.
casa::GLPixelCanvas::isRGB_
casacore::Bool isRGB_
Definition: GLPixelCanvas.h:793
casa::GLPixelCanvas::getArcMode
virtual Display::ArcMode getArcMode() const
casa::GLPixelCanvas::getBackground
virtual casacore::uLong getBackground() const
Unimplemented get Graphics Attributes.
casa::GLPixelCanvas::handleResizeEvent
Boolean handleResizeEvent(casacore::uInt w, casacore::uInt h)
casa::GLPixelCanvas::depth
virtual casacore::uInt depth() const
Return the depth of the GLPixelCanvas in bits.
casa::GLPixelCanvas::setPointSize
void setPointSize(const casacore::uInt pointsize)
(cacheable) Change the size of the points (in pixels) drawn by drawPoints.
casa::Display::TextAlign
TextAlign
Text Alignment.
Definition: DisplayEnums.h:181
casa::GLPixelCanvas::supportsLists
virtual casacore::Bool supportsLists()
Does this canvas support cached display lists? The user of the canvas should always check this...
casa::GLPixelCanvas::drawGLImage
void drawGLImage(GLfloat x, GLfloat y, GLfloat z, GLsizei width, GLsizei height, GLfloat xscale, GLfloat yscale, GLenum format, const GLushort *pixels)
Calls drawImagePixels if in indexed mode or drawTexturedImage if RGB.
casa::GLPixelCanvas::setCurrentColorIndex
void setCurrentColorIndex(casacore::uInt index, const char *name=NULL)
index is always treated as an index.
casa::GLPixelCanvas::redraw
void redraw()
(Not Cacheable) Redraw the window
Definition: GLPixelCanvas.h:399
casa::GLPixelCanvas::warn
void warn(const char *routine, const char *msg, const SourceLocation *where) const
Routines to print warnings.
casa::Display::Option
Option
PixelCanvas Options.
Definition: DisplayEnums.h:290
casa::GLPCTextureParams
Holds parameters for setting glTexParameteri variables. &lt;visibility=local&gt;
Definition: GLPCTexture.h:54
casa::GLPixelCanvas::traceLevel_
casacore::uLong traceLevel_
Definition: GLPixelCanvas.h:829
casa::GLPixelCanvas::height_
casacore::uInt height_
Definition: GLPixelCanvas.h:799
casa::GLPixelCanvas::traceLevel
casacore::uLong traceLevel() const
Definition: GLPixelCanvas.h:630
casa::GLPixelCanvas::drawPolygon
virtual void drawPolygon(const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1)
(Cacheable) Draw a closed polygon
casa::type
virtual Type type()
Return the type enum.
Definition: StandardVisCal.h:415
casa::GLPixelCanvas::setArcMode
virtual void setArcMode(Display::ArcMode mode)
casa::GLPixelCanvas::getFillStyle
virtual Display::FillStyle getFillStyle() const
casa::GLPixelCanvas::makeCurrent
void makeCurrent()
Make this canvas&#39;s context current.
casa::GLPixelCanvas::display_
::XDisplay * display_
Definition: GLPixelCanvas.h:784
casa::GLPixelCanvas::visualInfo_
XVisualInfo * visualInfo_
Definition: GLPixelCanvas.h:788
casa::GLPixelCanvas::clearColor_
GLPCColorValue clearColor_
Clear color.
Definition: GLPixelCanvas.h:808
casa::Display::DrawBuffer
DrawBuffer
PixelCanvas target drawing destination.
Definition: DisplayEnums.h:211
X_enter.h
casa::GLPixelCanvas::itsComponentScaleY_
casacore::Float itsComponentScaleY_
Definition: GLPixelCanvas.h:817
casa::GLPixelCanvas::trace
void trace(Boolean trace)
Tracing support.
Definition: GLPixelCanvas.h:619
casa::GLPixelCanvas::drawPixels
static void drawPixels(GLfloat x, GLfloat y, GLfloat z, GLsizei width, GLsizei height, GLfloat xscale, GLfloat yscale, GLenum format, GLenum type, const GLvoid *pixels)
casa::GLPixelCanvas::yTranslation
virtual casacore::Int yTranslation() const
casa::GLPixelCanvas::drawColoredPoints
virtual void drawColoredPoints(const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1, const casacore::Vector< casacore::uInt > &colors)
(Cacheable) Draw a set of points, specifying a color per point to be drawn.
casa::GLPixelCanvas::setImageCacheStrategy
virtual void setImageCacheStrategy(Display::ImageCacheStrategy strategy)
Control the image-caching strategy.
casa::GLPixelCanvas::drawPolyline3D
virtual void drawPolyline3D(const casacore::Vector< casacore::Float > &x1, const casacore::Vector< casacore::Float > &y1, const casacore::Vector< casacore::Float > &z1)
casa::GLPixelCanvas::copyBackBufferToFrontBuffer
virtual void copyBackBufferToFrontBuffer()
buffer memory exchanges (Not cacheable)
casa::GLPixelCanvas::setJoinStyle
virtual void setJoinStyle(Display::JoinStyle style)
casa::GLPixelCanvas::enablePositionEvents
virtual void enablePositionEvents()
casa::GLPixelCanvas::drawPoints3D
void drawPoints3D(const casacore::Matrix< casacore::Float > &verts)
casa::GLPixelCanvas::clipX2_
casacore::Int clipX2_
Definition: GLPixelCanvas.h:803
casa::GLPixelCanvas::disable
virtual casacore::Bool disable(Display::Option option)
casa::GLLogIO::postToString
static void postToString(casacore::String *str=NULL)
Post messages to str for later use.
casa::GLPixelCanvas::exposeHandler
void exposeHandler()
Handle the X expose event.
X_exit.h
casa::GLPixelCanvas::createList
GLPCDisplayList * createList(const char *name=NULL)
Internal handling of display lists.
casa::GLPixelCanvas::drawLine
virtual void drawLine(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2)
(Cacheable) Draw a single line using current color
casa::GLPixelCanvas::imageCacheStrategy
virtual Display::ImageCacheStrategy imageCacheStrategy() const
casa::GLPixelCanvas::getRGBColor
virtual casacore::Bool getRGBColor(casacore::Int x, casacore::Int y, float &r, float &g, float &b)
This should be removed since no one implements it.
casa::Display::FillRule
FillRule
Fill Rule Xlib programming guide, pg.132.
Definition: DisplayEnums.h:165
casa::GLPixelCanvas::bufferZValue
void bufferZValue(const casacore::Float z=0.0)
Definition: GLPixelCanvas.h:612
casa::GLPixelCanvas::GLPCColorValue
Holds both a color index and RGBA values.
Definition: GLPixelCanvas.h:728
casa::GLPixelCanvas::drawFilledPolygon
virtual void drawFilledPolygon(const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1)
(Cacheable) Draw and fill a closed polygon
casa::GLPixelCanvas::translateList
virtual void translateList(casacore::uInt list, casacore::Int xt, casacore::Int yt)
translate the list
casa::GLPixelCanvas::flushComponentBuffers
virtual void flushComponentBuffers()
(NOT CACHEABLE!) Flush the component buffers.
casa::GLPixelCanvas::GLPixelCanvas
GLPixelCanvas(Widget parent, GLPixelCanvasColorTable *glpcctbl, casacore::uInt width, casacore::uInt height)
Caution: Drawing can not take place until the window exists!
casa::GLPixelCanvas::translate
virtual void translate(casacore::Int xt, casacore::Int yt)
translation functions translate applies a relative translation to the current matrix and can be used ...
casa::name
ABSTRACT CLASSES Abstract class for colors Any implementation of color should be able to provide a hexadecimal form of the if a human readable name(i.e."black").In many places throughout the plotter
casa::GLPixelCanvas::storeColorValue
void storeColorValue(GLPCColorValue &v, casacore::uLong value)
Store the new value in the struct.
casa::GLPixelCanvas::setClearColor
virtual void setClearColor(casacore::uInt colorIndex)
(Cacheable) Set the color to use for clearing the display
casa::GLPixelCanvas::itsComponentHeight_
casacore::uLong itsComponentHeight_
Definition: GLPixelCanvas.h:818
casa::GLPixelCanvas::autoRefresh
Boolean autoRefresh() const
Normally GLPixelCanvas repaints the window when it is damaged.
Definition: GLPixelCanvas.h:649
casa::GLPixelCanvas::listSize_
casacore::uInt listSize_
Display lists.
Definition: GLPixelCanvas.h:820
casa::GLPCDisplayListElement
Base class for the various display list subclasses.
Definition: GLPCDisplayList.h:66
casa::GLPixelCanvas::endList
virtual void endList()
end caching display commands
casa::GLPixelCanvas::colorTableResizeCB
static void colorTableResizeCB(PixelCanvasColorTable *pcctbl, casacore::uInt, GLPixelCanvas *xpc, Display::RefreshReason reason)
handle colorTable resize
casa::GLPixelCanvas::drawPoint
virtual void drawPoint(casacore::Int x1, casacore::Int y1)
(Cacheable) Draw a single point using current color
casa::GLPixelCanvas::currentElement_
GLPCDisplayListElement * currentElement_
Definition: GLPixelCanvas.h:826
casa::GLPixelCanvas::loadIdentity
virtual void loadIdentity()
zero the current translation
casa::GLPixelCanvas::handleEvents
void handleEvents(Widget w, XEvent *ev)
casa::PixelCanvas
Base class defining interface to pixel-based output devices.
Definition: PixelCanvas.h:161
casa::GLPixelCanvas::pushMatrix
virtual void pushMatrix()
save/restore the current translation.
casa::data
ABSTRACT CLASSES Deliberately vague to be general enough to allow for many different types of data
Definition: PlotData.h:48
casa::GLPixelCanvas::deviceForegroundColor
virtual casacore::String deviceForegroundColor() const
casa::GLPixelCanvas::setClearColorIndex
void setClearColorIndex(casacore::uInt index, const char *name=NULL)
casa::Display::CapStyle
CapStyle
Controls the appearance of thick lines near their endpoints.
Definition: DisplayEnums.h:130
casa::Display::AlignCenter
reference point aligned to center of text
Definition: DisplayEnums.h:183
casa::GLPixelCanvas::setClearColorValue
void setClearColorValue(casacore::uLong index, const char *name=NULL)
casa::GLPixelCanvas::copyBuffer
static void copyBuffer(GLenum from, GLenum to, GLint x, GLint y, GLsizei width, GLsizei height)
buffer memory exchanges (Not cacheable)
casa::GLPixelCanvas::disablePositionEvents
virtual void disablePositionEvents()
casa::GLPixelCanvas::deleteList
virtual void deleteList(casacore::uInt list)
remove list from cache
casa::GLPixelCanvas::cleanLists
void cleanLists()
Go through the list of display lists removing any unused lists.
casa::Display::ColorComponent
ColorComponent
Color components.
Definition: DisplayEnums.h:84
casa::GLPixelCanvas::setDrawFunction
virtual void setDrawFunction(Display::DrawFunction function)
Set Graphics Attributes Options for functions with enum argument listed in DisplayEnums.
casa::GLPixelCanvas::drawList
virtual void drawList(casacore::uInt list)
(Cacheable) recall cached display commands
casa::GLPixelCanvas::fillStyle_
Display::FillStyle fillStyle_
Definition: GLPixelCanvas.h:811
casa::GLPixelCanvas::autoRefresh
void autoRefresh(Boolean refresh)
Definition: GLPixelCanvas.h:652
casa::GLPixelCanvas::deleteLists
virtual void deleteLists()
flush all lists from the cache
casa::GLPixelCanvas::pRWbuf
void pRWbuf(const char *str=NULL, int nspaces=0)
casa::GLPixelCanvas::doubleBuffered
Boolean doubleBuffered() const
Definition: GLPixelCanvas.h:660
casa::GLLogIO::postToStream
static void postToStream(casacore::Bool useStream=false)
Logging to standard AIPS++ disrupts trace formatting.
casa::GLPixelCanvas::exposeHandlerFirstTime_
Boolean exposeHandlerFirstTime_
Definition: GLPixelCanvas.h:813
casa::GLPixelCanvas::setDeviceForegroundColor
virtual void setDeviceForegroundColor(const casacore::String colorname)
Get/set the current foreground/background colors.
casa::GLPixelCanvas::bufferMask_
GLbitfield bufferMask_
Definition: GLPixelCanvas.h:797
casa::GLPixelCanvas::depth_
casacore::uInt depth_
Definition: GLPixelCanvas.h:800
casa::GLPixelCanvas::enableMotionEvents
virtual void enableMotionEvents()
enabling/disabling of event tracking (unimplemented)
casa::GLPixelCanvas::enable
virtual casacore::Bool enable(Display::Option option)
(Cacheable) Option Control Options listed in DisplayEnums Only Display::ClipWindow is implemented...
casa::GLPixelCanvas::drawPolyline
virtual void drawPolyline(const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1)
(Cacheable) Draw a single connected line between the given points.
casacore::Double
double Double
Definition: aipstype.h:55
casa::GLPixelCanvas::drawText
virtual void drawText(casacore::Int x, casacore::Int y, const casacore::String &text, Display::TextAlign alignment=Display::AlignCenter)
(Cacheable) Draw text using that font aligned in some way to the position.
casa::GLPixelCanvas
OpenGL implementation of PixelCanvas.
Definition: GLPixelCanvas.h:76
casa::GLPixelCanvas::refreshAllowed
virtual casacore::Bool refreshAllowed() const
return true if refresh is allowed right now...
casa::GLPixelCanvas::resize
virtual casacore::Bool resize(casacore::uInt reqXSize, casacore::uInt reqYSize, casacore::Bool doCallbacks=true)
(Not Cacheable) resize request.
casa::GLPixelCanvas::xTranslation
virtual casacore::Int xTranslation() const
casa::GLPixelCanvas::drawLine3D
virtual void drawLine3D(casacore::Float x1, casacore::Float y1, casacore::Float z1, casacore::Float x2, casacore::Float y2, casacore::Float z2)
casa::GLPixelCanvas::drawPoint3D
virtual void drawPoint3D(casacore::Float x1, casacore::Float y1, casacore::Float z1)
casa::GLPixelCanvas::setFillRule
virtual void setFillRule(Display::FillRule rule)
casa::GLPixelCanvas::getLineWidth
virtual casacore::Float getLineWidth() const
virtual casacore::uInt getLineWidth() const = 0;
casa::GLPixelCanvas::setFillStyle
virtual void setFillStyle(Display::FillStyle style)
casa::GLPixelCanvas::drawFilledRectangle
virtual void drawFilledRectangle(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2)
(Cacheable) Draw a filled rectangle
casa::GLPixelCanvas::currentColor_
GLPCColorValue currentColor_
Current color.
Definition: GLPixelCanvas.h:806
casa::GLPixelCanvas::getTranslation
virtual void getTranslation(casacore::Int &xt, casacore::Int &yt) const
Tip: get/x/yTranslation are not currently implemented;
casa::GLPixelCanvas::resizeColorTable
virtual casacore::Bool resizeColorTable(casacore::uInt newSize)
(Not Cacheable) resize the colortable by requesting a new number of cells
casa::GLPixelCanvas::currentListID_
casacore::uInt currentListID_
Definition: GLPixelCanvas.h:824
casa::GLPixelCanvas::makeList
casacore::uInt makeList(const char *name=NULL)
Create a new display list and add to the list of lists.
casa::GLPixelCanvas::isRGB
Boolean isRGB() const
Definition: GLPixelCanvas.h:663
casacore::Bool
bool Bool
Define the standard types used by Casacore.
Definition: aipstype.h:42
casa::GLPixelCanvas::translateAllLists
virtual void translateAllLists(casacore::Int xt, casacore::Int yt)
translate all lists
casa::GLPixelCanvas::nextfree_
casacore::uInt nextfree_
Definition: GLPixelCanvas.h:822
casa::GLPixelCanvas::traceLevel
void traceLevel(const casacore::uLong traceLevel)
Set trace level.
Definition: GLPixelCanvas.h:627
casa::GLPixelCanvas::getJoinStyle
virtual Display::JoinStyle getJoinStyle() const
casacore::Float
float Float
Definition: aipstype.h:54
casa::GLPixelCanvas::drawLines3D
virtual void drawLines3D(const casacore::Matrix< casacore::Float > &verts)
casa::GLPixelCanvas::setBackground
virtual void setBackground(casacore::uLong color)
Unimplemented set graphics functions.
casa::GLPixelCanvas::pixelDensity
virtual void pixelDensity(casacore::Float &xdpi, casacore::Float &ydpi) const
Get the pixel density (in dots per inch [dpi]) of the GLPixelCanvas Tip: The X server is queried; It...
casa::GLPCDisplayList
DisplayListElement that can contain lists of other DisplayListElements.
Definition: GLPCDisplayList.h:166
casa::GLPixelCanvas::doubleBuffered_
casacore::Bool doubleBuffered_
GL information.
Definition: GLPixelCanvas.h:792
casa::GLPixelCanvas::setDeviceBackgroundColor
virtual void setDeviceBackgroundColor(const casacore::String colorname)
casa::GLPixelCanvas::postToStream
void postToStream(casacore::Bool p=false)
Definition: GLPixelCanvas.h:633
casa::GLPixelCanvas::drawRectangle
virtual void drawRectangle(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2)
(Cacheable) Draw a rectangle
casa::GLPixelCanvas::purgeLists
void purgeLists()
Called when the window is resized or cleared.
casa::GLPixelCanvas::itsComponentScaleX_
casacore::Float itsComponentScaleX_
Definition: GLPixelCanvas.h:817
casa::GLPixelCanvas::validList
virtual casacore::Bool validList(casacore::uInt list)
return true if the list exists
casa::GLPixelCanvas::drawLines
virtual void drawLines(const casacore::Matrix< casacore::Int > &verts)
(Cacheable) Draw N/2 lines from an Nx2 matrix
casa::GLPixelCanvas::setClipWindow
virtual void setClipWindow(casacore::Int x1, casacore::Int y1, casacore::Int x2, casacore::Int y2)
(Cacheable) Setup the clip window.
casacore::uLong
unsigned long uLong
Definition: aipstype.h:53
casa::GLPixelCanvas::flush
virtual void flush()
Cause display to flush any graphics commands not yet drawn.
casa::GLPixelCanvas::clear
virtual void clear()
(Cacheable) Clear the window using the background color Tip: If you want to clear the window use cle...
casa::GLPixelCanvas::beginListEntry
void beginListEntry(const char *name=NULL)
Called to begin caching.
casa::GLPixelCanvas::getLineStyle
virtual Display::LineStyle getLineStyle() const
casa::GLPixelCanvas::postToString
void postToString(casacore::String *s=NULL)
Definition: GLPixelCanvas.h:636
casa::GLPixelCanvas::setPcctbl
void setPcctbl(PixelCanvasColorTable *pcctbl)
Definition: GLPixelCanvas.h:511
casa::GLPixelCanvas::popMatrix
virtual void popMatrix()
casa::GLPixelCanvas::itsComponentZ_
casacore::Float itsComponentZ_
Definition: GLPixelCanvas.h:816
casa::Display::FillStyle
FillStyle
Controls fill style.
Definition: DisplayEnums.h:152
casa::GLPixelCanvas::glpcctbl_
GLPixelCanvasColorTable * glpcctbl_
Definition: GLPixelCanvas.h:795
casa::GLPixelCanvas::drawIndexedImage
void GLPixelCanvas::drawIndexedImage(const casacore::Matrix< casacore::uInt > &data, casacore::Float x=0.0, casacore::Float y=0.0, casacore::Float z=0.0, casacore::Float xscl=1.0, casacore::Float yscl=1.0)
(Cacheable) Draw an image using color indexes.
casa::GLPixelCanvas::clipY2_
casacore::Int clipY2_
Definition: GLPixelCanvas.h:803
casa::GLPixelCanvas::getClearColor
virtual void getClearColor(float &r, float &g, float &b) const
casa::GLPixelCanvas::numinuse_
casacore::uInt numinuse_
Definition: GLPixelCanvas.h:821
casa::GLPixelCanvas::lineStyle_
Display::LineStyle lineStyle_
Definition: GLPixelCanvas.h:810
casa::Display::RefreshReason
RefreshReason
Callback reasons for PCRefreshEvent and WCRefreshEvent.
Definition: DisplayEnums.h:267
casa::GLPixelCanvas::repaint
void repaint(const casacore::Bool redraw=false)
Just redraws window.
casa::GLPixelCanvas::traceCheck
void traceCheck(const char *name, casacore::uLong traceLevel)
Definition: GLPixelCanvas.h:723
casa::GLPixelCanvas::itsComponentX_
casacore::Float itsComponentX_
Definition: GLPixelCanvas.h:816
casacore::C::e
const Double e
e and functions thereof:
casa::GLPixelCanvas::drawImage
virtual void drawImage(const casacore::Matrix< casacore::uInt > &data, casacore::Int x, casacore::Int y)
(Cacheable) Draw an array of 2D color data as a raster image for zoom = &lt;1,1&gt;
casa::GLPixelCanvas::drawPolygon3D
virtual void drawPolygon3D(const casacore::Vector< casacore::Float > &x1, const casacore::Vector< casacore::Float > &y1, const casacore::Vector< casacore::Float > &z1)
casa::GLPixelCanvas::sizeincr_
casacore::uInt sizeincr_
Definition: GLPixelCanvas.h:823
casa::GLPixelCanvas::drawColoredPoints_
void drawColoredPoints_(const char *Name, const casacore::Vector< casacore::Int > &x1, const casacore::Vector< casacore::Int > &y1, const casacore::Vector< casacore::uInt > &colors)
Internal versions of public functions.
casa::GLPixelCanvas::setCurrentColorValue
void setCurrentColorValue(casacore::uLong value, const char *name=NULL)
casa::GLPixelCanvas::getFillRule
virtual Display::FillRule getFillRule() const
casa::GLPixelCanvas::setLineWidth
virtual void setLineWidth(casacore::Float width)
virtual void setLineWidth(casacore::uInt width) = 0;
casa::GLPixelCanvas::drawFilledPolygon3D
virtual void drawFilledPolygon3D(const casacore::Vector< casacore::Float > &x1, const casacore::Vector< casacore::Float > &y1, const casacore::Vector< casacore::Float > &z1)
casa::Display::ArcMode
ArcMode
Arc Mode.
Definition: DisplayEnums.h:173
casa::GLPixelCanvas::clipY1_
casacore::Int clipY1_
Definition: GLPixelCanvas.h:802
casa::GLPixelCanvas::resizeList
void resizeList()
Grow the list.
casacore::String
String: the storage and methods of handling collections of characters.
Definition: String.h:223
casa::GLPixelCanvas::setFont
virtual casacore::Bool setFont(const casacore::String &fontName)
(Cacheable) Set the font to the recognizable font name.
casa::GLPixelCanvas::height
virtual casacore::uInt height() const
Return the height of the GLPixelCanvas in pixels.
casa::GLPixelCanvas::resizeHandler
void resizeHandler()
Called when window is resized.
casa::GLPixelCanvas::glpcctbl
virtual GLPixelCanvasColorTable * glpcctbl() const
Need a mechanism to return the GLPixelCanvasColorTable so drawing functions within classes can operat...
Definition: GLPixelCanvas.h:503
casa::Display::ImageCacheStrategy
ImageCacheStrategy
How to cache images when displaying them on client-server graphics systems.
Definition: DisplayEnums.h:297
casa::GLPixelCanvas::dlists_
GLPCDisplayList ** dlists_
Definition: GLPixelCanvas.h:825
casa::GLPixelCanvas::deviceBackgroundColor
virtual casacore::String deviceBackgroundColor() const
casa::GLPixelCanvas::~GLPixelCanvas
virtual ~GLPixelCanvas()
casa::Display::DrawFunction
DrawFunction
PixelCanvas Drawing Logical Functions.
Definition: DisplayEnums.h:227
casa::GLPixelCanvas::getCapStyle
virtual Display::CapStyle getCapStyle() const
casa::GLPixelCanvas::getColor
virtual void getColor(float &r, float &g, float &b) const
(Not Cacheable) Retuns the current color as an RGB triple
casa::GLPixelCanvas::drawTexturedImage
void drawTexturedImage(GLfloat x, GLfloat y, GLfloat z, GLsizei width, GLsizei height, GLfloat xscale, GLfloat yscale, GLenum format, const GLushort *pixels, GLPCTextureParams *params=NULL)
Various ways to draw images.
casa::GLPixelCanvas::setDrawBuffer
virtual void setDrawBuffer(Display::DrawBuffer buf)
(Not cacheable) set the draw buffer Caution: The draw buffer is always set to BACK if double buffere...
casa::GLPixelCanvas::width
virtual casacore::uInt width() const
Return the width of the GLPixelCanvas in pixels.
casa::GLPixelCanvas::note
void note(const char *note)
Add a note entry to traced output.
casa::GLLogIO
GLLogIO adds tracing support to the AIPS++ casacore::LogIO object.
Definition: GLSupport.h:55
casa::GLPixelCanvas::itsComponents_
casacore::uShort * itsComponents_
Component / multi-channel buffers etc.
Definition: GLPixelCanvas.h:815
casa::GLPixelCanvas::itsComponentY_
casacore::Float itsComponentY_
Definition: GLPixelCanvas.h:816
casa::GLPixelCanvas::pcctbl
PixelCanvasColorTable * pcctbl() const
Return the pixel canvas color table.
Definition: GLPixelCanvas.h:507
casa::GLPixelCanvas::traceCheck
void traceCheck(const char *name, casacore::uLong traceLevel, casacore::uInt nspaces)
Print &lt;name&gt; if tracing is turned on.
casa::Display::JoinStyle
JoinStyle
Controls the appearance of two joined lines.
Definition: DisplayEnums.h:142
casa::GLPixelCanvas::getForeground
virtual casacore::uLong getForeground() const
Implemented get Graphics Attributes functions.
casa::GLPixelCanvas::newList
virtual casacore::uInt newList()
begin caching display commands - return list ID
casa::GLPixelCanvas::setColor
virtual void setColor(casacore::uInt colorIndex)
(Cacheable) Set current color (works in RGB or colormap mode)
casa::GLPixelCanvas::disableMotionEvents
virtual void disableMotionEvents()
casa::GLPixelCanvas::BlackPixel_
casacore::uInt BlackPixel_
Definition: GLPixelCanvas.h:790
casa::GLPixelCanvas::drawPoints
virtual void drawPoints(const casacore::Matrix< casacore::Int > &verts)
(Cacheable) Draw N points specified as a Nx2 matrix
casa::GLPixelCanvas::clearColor
virtual casacore::uInt clearColor() const
(Not Cacheable) Get the current color to use for clearing the display.
casa::GLPixelCanvas::handleEventsCB
static void handleEventsCB(Widget w, GLPixelCanvas *xpc, XEvent *ev, Boolean *)
Event Handling.
casa::GLPixelCanvas::pushAttrib
void pushAttrib(const GLbitfield attrib)
OpenGL&#39;s push/popAttrib functions.
casacore::value
LatticeExprNode value(const LatticeExprNode &expr)
This function returns the value of the expression without a mask.
casa::GLPixelCanvas::unimplemented
void unimplemented(const char *routine, const SourceLocation *where) const
casacore::uInt
unsigned int uInt
Definition: aipstype.h:51
casa::Display::UserCommand
User told PixelCanvas to refresh via PixelCanvas refresh()
Definition: DisplayEnums.h:269
casa::GLPixelCanvas::glCheck
static int glCheck(const char *msg=NULL, casacore::uInt nspaces=0)
casa::GLPixelCanvas::removeList
Boolean removeList(casacore::uInt listid)
Remove a display list from list of lists.
casa::GLPixelCanvas::getClipWindow
virtual void getClipWindow(casacore::Int &x1, casacore::Int &y1, casacore::Int &x2, casacore::Int &y2)
casa::Display::LineStyle
LineStyle
Style of line to use.
Definition: DisplayEnums.h:119
casacore::uShort
unsigned short uShort
Definition: aipstype.h:49
casa::GLPixelCanvas::color
virtual casacore::uInt color() const
(Not Cacheable) Returns the current color as a color index Note: In RGB mode, this is only valid if ...
Generated on Sun Sep 1 2019 23:32:30 for casa by   doxygen 1.8.5