Update fluid tutorial on CubeView and demo code

Format code according to the CMP, add instructions on how to copy
the code to the fluid tutorial, and update the tutorial with the
current code of test/CubeView.h and test/CubeView.cxx.
This commit is contained in:
Albrecht Schlosser 2021-05-21 19:56:11 +02:00
parent cbee4880f4
commit da4d16b59a
3 changed files with 348 additions and 298 deletions

View File

@ -211,68 +211,90 @@ CubeViewUI, generated by FLUID.
Here is the CubeView class definition, as given by its header file
"test/CubeView.h":
<br>
<!-- Code copied from test/CubeView.h -->
\code
#include <FL/Fl.H>
#include <FL/Fl_Gl_Window.H>
#include <FL/gl.h>
class CubeView : public Fl_Gl_Window {
public:
CubeView(int x, int y, int w, int h, const char *l = 0);
// this value determines the scaling factor used to draw the cube.
// This value determines the scaling factor used to draw the cube.
double size;
/* Set the rotation about the vertical (y) axis.
*
* This function is called by the horizontal roller in CubeViewUI
* and the initialize button in CubeViewUI.
* This function is called by the horizontal roller in
* CubeViewUI and the initialize button in CubeViewUI.
*/
void v_angle(float angle){vAng=angle;};
void v_angle(double angle) { vAng = angle; }
// Return the rotation about the vertical (y) axis.
float v_angle(){return vAng;};
double v_angle() const { return vAng; }
/* Set the rotation about the horizontal (x) axis.
*
* This function is called by the vertical roller in CubeViewUI
* and the initialize button in CubeViewUI.
* This function is called by the vertical roller in
* CubeViewUI and the initialize button in CubeViewUI.
*/
void h_angle(float angle){hAng=angle;};
// the rotation about the horizontal (x) axis.
float h_angle(){return hAng;};
void h_angle(double angle) { hAng = angle; }
// The rotation about the horizontal (x) axis.
double h_angle() const { return hAng; }
/* Sets the x shift of the cube view camera.
*
* This function is called by the slider in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the slider in CubeViewUI
* and the initialize button in CubeViewUI.
*/
void panx(float x){xshift=x;};
void panx(double x) { xshift = x; }
/* Sets the y shift of the cube view camera.
*
* This function is called by the slider in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the slider in CubeViewUI
* and the initialize button in CubeViewUI.
*/
void pany(float y){yshift=y;};
void pany(double y) { yshift = y; }
/* The widget class draw() override.
* The draw() function initialize Gl for another round of
* drawing then calls specialized functions for drawing each
*
* The draw() function initializes Gl for another round of
* drawing, then calls specialized functions for drawing each
* of the entities displayed in the cube view.
*/
void draw();
private:
/* Draw the cube boundaries
* Draw the faces of the cube using the boxv[] vertices, using
* GL_LINE_LOOP for the faces. The color is #defined by
* CUBECOLOR.
/* Draw the cube boundaries.
*
* Draw the faces of the cube using the boxv[] vertices,
* using GL_LINE_LOOP for the faces.
*/
void drawCube();
float vAng,hAng; float xshift,yshift;
double vAng, hAng;
double xshift, yshift;
float boxv0[3];float boxv1[3]; float boxv2[3];float boxv3[3];
float boxv4[3];float boxv5[3]; float boxv6[3];float boxv7[3];
float boxv0[3]; float boxv1[3];
float boxv2[3]; float boxv3[3];
float boxv4[3]; float boxv5[3];
float boxv6[3]; float boxv7[3];
};
\endcode
\par The CubeView Class Implementation
Here is the CubeView implementation. It is very similar to the
"cube" demo included with FLTK.
"CubeView" demo included with FLTK.
<br>
<!-- Code copied from test/CubeView.cxx -->
\code
#include "CubeView.h"
#include <math.h>
@ -280,9 +302,16 @@ Here is the CubeView implementation. It is very similar to the
CubeView::CubeView(int x, int y, int w, int h, const char *l)
: Fl_Gl_Window(x, y, w, h, l)
{
vAng = 0.0; hAng=0.0; size=10.0;
Fl::use_high_res_GL(1);
vAng = 0.0;
hAng = 0.0;
size = 10.0;
xshift = 0.0;
yshift = 0.0;
/* The cube definition. These are the vertices of a unit cube
* centered on the origin.*/
boxv0[0] = -0.5; boxv0[1] = -0.5; boxv0[2] = -0.5;
boxv1[0] = 0.5; boxv1[1] = -0.5; boxv1[2] = -0.5;
boxv2[0] = 0.5; boxv2[1] = 0.5; boxv2[2] = -0.5;
@ -291,10 +320,7 @@ CubeView::CubeView(int x,int y,int w,int h,const char *l)
boxv5[0] = 0.5; boxv5[1] = -0.5; boxv5[2] = 0.5;
boxv6[0] = 0.5; boxv6[1] = 0.5; boxv6[2] = 0.5;
boxv7[0] = -0.5; boxv7[1] = 0.5; boxv7[2] = 0.5;
};
// The color used for the edges of the bounding cube.
#define CUBECOLOR 255,255,255,255
}
void CubeView::drawCube() {
/* Draw a colored cube */
@ -377,21 +403,30 @@ void CubeView::drawCube() {
glVertex3fv(boxv3);
glVertex3fv(boxv7);
glEnd();
};//drawCube
} // drawCube
void CubeView::draw() {
if (!valid()) {
glLoadIdentity(); glViewport(0,0,w(),h());
glOrtho(-10,10,-10,10,-20000,10000); glEnable(GL_BLEND);
glLoadIdentity();
glViewport(0, 0, pixel_w(), pixel_h());
glOrtho(-10, 10, -10, 10, -20050, 10000);
glEnable(GL_BLEND);
glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
}
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
glPushMatrix(); glTranslatef(xshift, yshift, 0);
glRotatef(hAng,0,1,0); glRotatef(vAng,1,0,0);
glScalef(float(size),float(size),float(size)); drawCube();
glPushMatrix();
glTranslatef((GLfloat)xshift, (GLfloat)yshift, 0);
glRotatef((GLfloat)hAng, 0, 1, 0);
glRotatef((GLfloat)vAng, 1, 0, 0);
glScalef(float(size), float(size), float(size));
drawCube();
glPopMatrix();
};
}
\endcode
\subsection fluid_cubeview_ui The CubeViewUI Class

View File

@ -1,7 +1,7 @@
//
// CubeView class implementation for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2010 by Bill Spitzak and others.
// Copyright 1998-2021 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
@ -14,10 +14,15 @@
// https://www.fltk.org/bugs.php
//
// Note to editor: the following code can and should be copied
// to the fluid tutorial in 'documentation/src/fluid.dox'
// *without* '#if HAVE_GL' preprocessor statements, leaving
// only those parts where the condition is true.
// [\code in documentation/src/fluid.dox]
#include "CubeView.h"
#include <math.h>
#if HAVE_GL
CubeView::CubeView(int x, int y, int w, int h, const char *l)
: Fl_Gl_Window(x, y, w, h, l)
@ -149,11 +154,14 @@ void CubeView::draw() {
glPushMatrix();
glTranslatef((GLfloat)xshift, (GLfloat)yshift, 0);
glRotatef((GLfloat) hAng,0,1,0); glRotatef((GLfloat) vAng,1,0,0);
glRotatef((GLfloat)hAng, 0, 1, 0);
glRotatef((GLfloat)vAng, 1, 0, 0);
glScalef(float(size), float(size), float(size));
drawCube();
glPopMatrix();
}
// [\endcode in documentation/src/fluid.dox]
#endif /* HAVE_GL */

View File

@ -1,7 +1,7 @@
//
// CubeView class definitions for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2010 by Bill Spitzak and others.
// Copyright 1998-2021 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
@ -16,7 +16,15 @@
#ifndef CUBEVIEW_H
#define CUBEVIEW_H 1
#include <config.h>
// Note to editor: the following code can and should be copied
// to the fluid tutorial in 'documentation/src/fluid.dox'
// *without* '#if HAVE_GL' preprocessor statements, leaving
// only those parts where the condition is true.
// [\code in documentation/src/fluid.dox]
#include <FL/Fl.H>
#if HAVE_GL
#include <FL/Fl_Gl_Window.H>
@ -25,8 +33,6 @@
#include <FL/Fl_Box.H>
#endif /* HAVE_GL */
#include <stdlib.h>
#if HAVE_GL
class CubeView : public Fl_Gl_Window {
#else
@ -34,15 +40,15 @@ class CubeView : public Fl_Box {
#endif /* HAVE_GL */
public:
// this value determines the scaling factor used to draw the cube.
double size;
CubeView(int x, int y, int w, int h, const char *l = 0);
// This value determines the scaling factor used to draw the cube.
double size;
/* Set the rotation about the vertical (y) axis.
*
* This function is called by the horizontal roller in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the horizontal roller in
* CubeViewUI and the initialize button in CubeViewUI.
*/
void v_angle(double angle) { vAng = angle; }
@ -51,44 +57,44 @@ public:
/* Set the rotation about the horizontal (x) axis.
*
* This function is called by the vertical roller in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the vertical roller in
* CubeViewUI and the initialize button in CubeViewUI.
*/
void h_angle(double angle) { hAng = angle; }
// the rotation about the horizontal (x ) axis.
// The rotation about the horizontal (x) axis.
double h_angle() const { return hAng; }
/* Sets the x shift of the cube view camera.
*
* This function is called by the slider in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the slider in CubeViewUI
* and the initialize button in CubeViewUI.
*/
void panx(double x) { xshift = x; }
/* Sets the y shift of the cube view camera.
*
* This function is called by the slider in CubeViewUI and the
* initialize button in CubeViewUI.
* This function is called by the slider in CubeViewUI
* and the initialize button in CubeViewUI.
*/
void pany(double y) { yshift = y; }
#if HAVE_GL
/* The widget class draw() override.
*
*The draw() function initialize Gl for another round o f drawing
* then calls specialized functions for drawing each of the
* entities displayed in the cube view.
*
* The draw() function initializes Gl for another round of
* drawing, then calls specialized functions for drawing each
* of the entities displayed in the cube view.
*/
void draw();
#endif /* HAVE_GL */
private:
/* Draw the cube boundaries
private:
/* Draw the cube boundaries.
*
*Draw the faces of the cube using the boxv[] vertices, using
* GL_LINE_LOOP for the faces. The color is \#defined by CUBECOLOR.
* Draw the faces of the cube using the boxv[] vertices,
* using GL_LINE_LOOP for the faces.
*/
#if HAVE_GL
void drawCube();
@ -99,11 +105,12 @@ private:
double vAng, hAng;
double xshift, yshift;
float boxv0[3]; float boxv1[3];
float boxv2[3]; float boxv3[3];
float boxv4[3]; float boxv5[3];
float boxv6[3]; float boxv7[3];
};
#endif
// [\endcode in documentation/src/fluid.dox]
#endif // CUBEVIEW_H