source: git/src/gla.h @ 36da3f6

stereo
Last change on this file since 36da3f6 was 36da3f6, checked in by Olly Betts <olly@…>, 6 years ago

Merge branch 'master' into stereo
  • Property mode set to 100644
File size: 8.2 KB
Line 
1//
2//  gla.h
3//
4//  Header file for the GLA abstraction layer.
5//
6//  Copyright (C) 2002 Mark R. Shinwell.
7//  Copyright (C) 2003,2004,2005,2006,2007,2011,2012,2014,2017,2018 Olly Betts
8//
9//  This program is free software; you can redistribute it and/or modify
10//  it under the terms of the GNU General Public License as published by
11//  the Free Software Foundation; either version 2 of the License, or
12//  (at your option) any later version.
13//
14//  This program is distributed in the hope that it will be useful,
15//  but WITHOUT ANY WARRANTY; without even the implied warranty of
16//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17//  GNU General Public License for more details.
18//
19//  You should have received a copy of the GNU General Public License
20//  along with this program; if not, write to the Free Software
21//  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
22//
23
24#ifndef gla_h
25#define gla_h
26
27#include <string>
28#include <vector>
29
30using namespace std;
31
32#include "wx.h"
33#include "aventypes.h"
34#include "vector3.h"
35
36#include "glbitmapfont.h"
37
38class GfxCore;
39
40string GetGLSystemDescription();
41
42// #define GLA_DEBUG
43
44typedef Double glaCoord;
45
46typedef GLfloat glaTexCoord;
47
48// Colours for drawing.  Don't reorder these!
49enum gla_colour {
50    col_BLACK = 0,
51    col_GREY,
52    col_LIGHT_GREY,
53    col_LIGHT_GREY_2,
54    col_DARK_GREY,
55    col_WHITE,
56    col_TURQUOISE,
57    col_GREEN,
58    col_INDICATOR_1,
59    col_INDICATOR_2,
60    col_YELLOW,
61    col_RED,
62    col_BLUE,
63    col_LAST // must be the last entry here
64};
65
66class GLAPen {
67    friend class GLACanvas; // allow direct access to components
68
69    double components[3]; // red, green, blue
70
71public:
72    GLAPen();
73
74    void SetColour(double red, double green, double blue); // arguments in range 0 to 1.0
75    void Interpolate(const GLAPen&, double how_far);
76
77    double GetRed() const;
78    double GetGreen() const;
79    double GetBlue() const;
80};
81
82class GLAList {
83    GLuint gl_list;
84    unsigned int flags;
85  public:
86    GLAList() : gl_list(0), flags(0) { }
87    GLAList(GLuint gl_list_, unsigned int flags_)
88        : gl_list(gl_list_), flags(flags_) { }
89    operator bool() { return gl_list != 0; }
90    bool need_to_generate();
91    void finalise(unsigned int list_flags);
92    bool DrawList() const;
93    void invalidate_if(unsigned int mask) {
94        // If flags == NEVER_CACHE, the list won't be invalidated (unless
95        // mask is 0, which isn't a normal thing to pass).
96        if (flags & mask)
97            flags = 0;
98    }
99};
100
101class GLACanvas : public wxGLCanvas {
102    friend class GLAList; // For flag values.
103
104    wxGLContext ctx;
105
106#ifdef GLA_DEBUG
107    int m_Vertices;
108#endif
109
110    GLdouble modelview_matrix[16];
111    GLdouble projection_matrix[16];
112    GLint viewport[4];
113
114    // Viewing volume diameter:
115    glaCoord m_VolumeDiameter;
116
117    // Parameters for plotting data:
118    Double m_Pan, m_Tilt;
119    Double m_Scale;
120    Vector3 m_Translation;
121
122    BitmapFont m_Font;
123
124    GLUquadric* m_Quadric;
125
126    GLuint m_Texture;
127    GLuint m_BlobTexture;
128    GLuint m_CrossTexture;
129
130    Double alpha;
131
132    bool m_SmoothShading;
133    bool m_Textured;
134    bool m_Perspective;
135    bool m_Fog;
136    bool m_AntiAlias;
137    bool save_hints;
138    enum { UNKNOWN = 0, POINT = 'P', LINES = 'L', SPRITE = 'S' };
139    int blob_method;
140    int cross_method;
141
142    int x_size;
143    int y_size;
144
145    vector<GLAList> drawing_lists;
146
147    enum {
148        INVALIDATE_ON_SCALE = 1,
149        INVALIDATE_ON_X_RESIZE = 2,
150        INVALIDATE_ON_Y_RESIZE = 4,
151        NEVER_CACHE = 8,
152        CACHED = 16
153    };
154    mutable unsigned int list_flags;
155
156    wxString vendor, renderer;
157
158    bool CheckVisualFidelity(const unsigned char * target) const;
159
160protected:
161    int m_Eye;
162
163public:
164    GLACanvas(wxWindow* parent, int id);
165    ~GLACanvas();
166
167    static bool check_visual();
168
169    void FirstShow();
170
171    void Clear();
172    void StartDrawing();
173    void FinishDrawing();
174
175    void SetVolumeDiameter(glaCoord diameter);
176    void SetDataTransform();
177    void SetIndicatorTransform();
178
179    void DrawList(unsigned int l);
180    void DrawListZPrepass(unsigned int l);
181    void DrawList2D(unsigned int l, glaCoord x, glaCoord y, Double rotation);
182    void InvalidateList(unsigned int l) {
183        if (l < drawing_lists.size()) {
184            // Invalidate any existing cached list.
185            drawing_lists[l].invalidate_if(CACHED);
186        }
187    }
188
189    virtual void GenerateList(unsigned int l) = 0;
190
191    void SetColour(const GLAPen& pen, double rgb_scale);
192    void SetColour(const GLAPen& pen);
193    void SetColour(gla_colour colour, double rgb_scale);
194    void SetColour(gla_colour colour);
195    void SetAlpha(double new_alpha) { alpha = new_alpha; }
196
197    void DrawText(glaCoord x, glaCoord y, glaCoord z, const wxString& str);
198    void DrawIndicatorText(int x, int y, const wxString& str);
199    void GetTextExtent(const wxString& str, int * x_ext, int * y_ext) const;
200
201    void BeginQuadrilaterals();
202    void EndQuadrilaterals();
203    void BeginLines();
204    void EndLines();
205    void BeginTriangleStrip();
206    void EndTriangleStrip();
207    void BeginTriangles();
208    void EndTriangles();
209    void BeginPolyline();
210    void EndPolyline();
211    void BeginPolygon();
212    void EndPolygon();
213    void BeginBlobs();
214    void EndBlobs();
215    void BeginCrosses();
216    void EndCrosses();
217
218    void DrawRectangle(gla_colour fill, gla_colour edge,
219                       glaCoord x0, glaCoord y0, glaCoord w, glaCoord h);
220    void DrawShadedRectangle(const GLAPen & fill_bot, const GLAPen & fill_top,
221                             glaCoord x0, glaCoord y0, glaCoord w, glaCoord h);
222    void DrawCircle(gla_colour edge, gla_colour fill, glaCoord cx, glaCoord cy, glaCoord radius);
223    void DrawSemicircle(gla_colour edge, gla_colour fill, glaCoord cx, glaCoord cy, glaCoord radius, glaCoord start);
224    void DrawTriangle(gla_colour edge, gla_colour fill,
225                      const Vector3 &p0, const Vector3 &p1, const Vector3 &p2);
226
227    void DrawBlob(glaCoord x, glaCoord y, glaCoord z);
228    void DrawBlob(glaCoord x, glaCoord y);
229    void DrawCross(glaCoord x, glaCoord y, glaCoord z);
230    void DrawRing(glaCoord x, glaCoord y);
231
232    void PlaceVertex(const Vector3 & v, glaTexCoord tex_x, glaTexCoord tex_y) {
233        PlaceVertex(v.GetX(), v.GetY(), v.GetZ(), tex_x, tex_y);
234    }
235    void PlaceVertex(const Vector3 & v) {
236        PlaceVertex(v.GetX(), v.GetY(), v.GetZ());
237    }
238    void PlaceVertex(glaCoord x, glaCoord y, glaCoord z);
239    void PlaceVertex(glaCoord x, glaCoord y, glaCoord z,
240                     glaTexCoord tex_x, glaTexCoord tex_y);
241    void PlaceIndicatorVertex(glaCoord x, glaCoord y);
242
243    void PlaceNormal(const Vector3 &v);
244
245    void EnableDashedLines();
246    void DisableDashedLines();
247
248    void EnableSmoothPolygons(bool filled);
249    void DisableSmoothPolygons();
250
251    void SetRotation(double pan, double tilt) {
252        m_Pan = pan;
253        m_Tilt = tilt;
254    }
255    void SetScale(Double);
256    void SetTranslation(const Vector3 &v) {
257        m_Translation = v;
258    }
259    void AddTranslation(const Vector3 &v) {
260        m_Translation += v;
261    }
262    const Vector3 & GetTranslation() const {
263        return m_Translation;
264    }
265    void AddTranslationScreenCoordinates(int dx, int dy);
266
267    bool Transform(const Vector3 & v, double* x_out, double* y_out, double* z_out) const;
268    void ReverseTransform(Double x, Double y, double* x_out, double* y_out, double* z_out) const;
269
270    int GetFontSize() const { return m_Font.get_font_size(); }
271
272    void ToggleSmoothShading();
273    bool GetSmoothShading() const { return m_SmoothShading; }
274
275    Double SurveyUnitsAcrossViewport() const;
276
277    void ToggleTextured();
278    bool GetTextured() const { return m_Textured; }
279
280    void TogglePerspective() { m_Perspective = !m_Perspective; }
281    bool GetPerspective() const { return m_Perspective; }
282
283    void ToggleFog() { m_Fog = !m_Fog; }
284    bool GetFog() const { return m_Fog; }
285
286    void ToggleAntiAlias() { m_AntiAlias = !m_AntiAlias; }
287    bool GetAntiAlias() const { return m_AntiAlias; }
288
289    bool SaveScreenshot(const wxString & fnm, wxBitmapType type) const;
290
291    void ReadPixels(int width, int height, unsigned char * buf) const;
292
293    void PolygonOffset(bool on) const;
294
295    int GetXSize() const { list_flags |= INVALIDATE_ON_X_RESIZE; return x_size; }
296    int GetYSize() const { list_flags |= INVALIDATE_ON_Y_RESIZE; return y_size; }
297
298    void OnSize(wxSizeEvent & event);
299
300    glaCoord GetVolumeDiameter() const { return m_VolumeDiameter; }
301
302private:
303    DECLARE_EVENT_TABLE()
304};
305
306#endif
Note: See TracBrowser for help on using the repository browser.