[Gzz-commits] libvob/include/vob/vobs Trivial.hxx

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/libvob
Module name:    libvob
Branch:         
Changes by:     Tuomas J. Lukka <address@hidden>        03/08/13 09:16:23

Modified files:
        include/vob/vobs: Trivial.hxx 

Log message:
        Document problem for humppake

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/libvob/libvob/include/vob/vobs/Trivial.hxx.diff?tr1=1.19&tr2=1.20&r1=text&r2=text

Patches:
Index: libvob/include/vob/vobs/Trivial.hxx
diff -u libvob/include/vob/vobs/Trivial.hxx:1.19 
libvob/include/vob/vobs/Trivial.hxx:1.20
--- libvob/include/vob/vobs/Trivial.hxx:1.19    Fri May 23 04:52:34 2003
+++ libvob/include/vob/vobs/Trivial.hxx Wed Aug 13 09:16:23 2003
@@ -47,7 +47,8 @@
 
 using namespace Vob::VecGL;
 
-/** A line drawn between the centers of two coordinate systems.
+/** A line (in screen space)
+ * drawn between the centers of two coordinate systems.
  */
 struct LineConnector {
     enum { NTrans = 2 };
@@ -121,6 +122,8 @@
 
 VOB_DEFINED(PinStub);
 
+/** Call the given display list.
+ */
 struct CallList {
     enum { NTrans = 0 };
 
@@ -139,6 +142,15 @@
 
 VOB_DEFINED(CallList);
 
+/** Call the given display list, with the GL transformation
+ * matrix set from the given transformation.
+ * This Vob cannot be used in non-glperformable transformations,
+ * so for example any nonlinear transformations cause an error.
+ * This is because we cannot make OpenGL map the coordinates properly,
+ * especially if the nonlinearity would require dicing.
+ * <p>
+ * There are solutions for this - see, e.g. liblines and paperquad.
+ */
 struct CallListCoorded : public CallList {
     enum { NTrans = 1 };
     template<class T> void render(const T &t) const {
@@ -156,6 +168,20 @@
 };
 VOB_DEFINED(CallListCoorded);
 
+/** Call the given display list, with the GL transformation
+ * matrix set from the given transformation's box.
+ * This has the same effect as using CallListCoorded with
+ * the coordinate system unitSq() on top of the coordinate
+ * system given to this vob..
+ * <p>
+ * This Vob cannot be used in non-glperformable transformations,
+ * so for example any nonlinear transformations cause an error.
+ * This is because we cannot make OpenGL map the coordinates properly,
+ * especially if the nonlinearity would require dicing.
+ * <p>
+ * There are solutions for this - see, e.g. liblines and paperquad.
+ *
+ */
 struct CallListBoxCoorded : public CallList {
     enum { NTrans = 1 };
     template<class T> void render(const T &t) const {