[Gzz-commits] gzz ./Makefile ./TODO Documentation/Manuscripts...

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/gzz
Module name:    gzz
Changes by:     Tuomas J. Lukka <address@hidden>        02/10/25 04:20:23

Modified files:
        .              : Makefile TODO 
        Documentation/Manuscripts: gzigzag.bib 
        gzz/vob        : TextVob.java 
Added files:
        Documentation/TechReports/GzzTech: gzztech.rst 

Log message:
        Start gzz technologies techreport

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Makefile.diff?tr1=1.197&tr2=1.198&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/TODO.diff?tr1=1.322&tr2=1.323&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/Manuscripts/gzigzag.bib.diff?tr1=1.50&tr2=1.51&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/Documentation/TechReports/GzzTech/gzztech.rst?rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/gzz/vob/TextVob.java.diff?tr1=1.42&tr2=1.43&r1=text&r2=text

Patches:
Index: gzz/Documentation/Manuscripts/gzigzag.bib
diff -u gzz/Documentation/Manuscripts/gzigzag.bib:1.50 
gzz/Documentation/Manuscripts/gzigzag.bib:1.51
--- gzz/Documentation/Manuscripts/gzigzag.bib:1.50      Fri Aug  9 05:32:38 2002
+++ gzz/Documentation/Manuscripts/gzigzag.bib   Fri Oct 25 04:20:22 2002
@@ -6,7 +6,7 @@
 @Misc{gzz,
   author =       {Tuomas J. Lukka and others},
   title =        {{G}zz},
-  howpublished = {\url{http://www.gzz.info/}, 
\url{http://savannah.gnu.org/projects/gzz}}
+  howpublished = {\url{http://gzz.info/}, 
\url{http://savannah.gnu.org/projects/gzz}}
 }
 
 @Misc{gzigzag,
Index: gzz/Makefile
diff -u gzz/Makefile:1.197 gzz/Makefile:1.198
--- gzz/Makefile:1.197  Mon Oct 21 16:49:47 2002
+++ gzz/Makefile        Fri Oct 25 04:20:22 2002
@@ -298,7 +298,7 @@
         
 pegs:
        # should be $(JYTHON), but doesn't work somehow
-       python metacode/pegboard.py
+       PYTHONPATH=../depends: python2.1 metacode/pegboard.py
        # $(JYTHON) metacode/pegboard.py
 
 lavadoc::
Index: gzz/TODO
diff -u gzz/TODO:1.322 gzz/TODO:1.323
--- gzz/TODO:1.322      Thu Oct 24 22:57:17 2002
+++ gzz/TODO    Fri Oct 25 04:20:22 2002
@@ -12,13 +12,17 @@
 0.8alpha4: Cleanup release after crucial demos; make it possible for anyone to
            get *THE* demo up and running
     jvk:
+       - make callgl complain on broken stuff such as 
+         the string "%(texid)s" in place of a number !!!!
+         ARGH ARGH ARGH 
        + [GI03] update NV20/NV25 version of libpaper. Need HILO offset 
textures.
        + [GI03] libpaper NV2x combined passes
        + [GI03] think about modeling textures
-       - script to save 100 textures every day
+       + script to save 100 textures every day
     jvk,marke: 
        + [GI03] paper experiments
     tjl, jvk:
+       - paper: small high-frequency components
        + [GI03] standard GL implementation of irregu
          [GI03]  - one-pass edge impl
          [GI03]  - think more about shape
@@ -35,10 +39,7 @@
                - report on #gzz
                - run tests (and report if introduces failures)
                - build docs in himalia
-       - unit tests for libcoords:
-           - a general test that transform() and performGL() do the same thing
-               - draw white pixel at some point, check that transform gives 
same pixel
-       - see (with ibid and buildbot) how we could run all tests nightly
+       + see (with ibid and buildbot) how we could run all tests nightly
          on 
            - pure software Mesa
            - G400
@@ -51,12 +52,12 @@
          are affected by the cards for now.
          Also, make it possible to trigger these tests by daytime
          (e.g. after having changed something relevant)
-       - benchmarking framework: running benchmarks on different machines
+       + benchmarking framework: running benchmarks on different machines
          and different VMs automatically as well, reporting
          results graphically on web. Need to see when there
          are important changes to speed, what caused them
          etc.
-       - speed up tests: currently too much execfile().. could
+       + speed up tests: currently too much execfile().. could
          pre-compile and exec compiled in the same globals().
     tuukkah:
        - clean, rename and document Makefile targets 
@@ -94,20 +95,19 @@
          createPaperQuad, since that's the most flexible approach.
        - porting: make sure all demos etc. work with plain mesa
     humppake:
-       - Nokia demo [deadline 24.10]
-           - culling of coordsys: coordsys may, at setparams time,
-             decide not to be shown.
-               - tests: a Vob that doesn't use coordsys but draws something
-                 somewhere if it's drawn at all would help.
-                   - can also use transformPoints_interp, see 
-                     glvobcoorder.test
-       - more about PEG1018 - generalizin VobVanishingClient
-       - new PEG from bubbleview, with some sketches
-        - rethink interfaces between PlainVanishing and VobScene
+       - culling of coordsys: coordsys may, at setparams time,
+         decide not to be shown.
+           - tests: a Vob that doesn't use coordsys but draws something
+             somewhere if it's drawn at all would help.
+               - can also use transformPoints_interp, see 
+                 glvobcoorder.test
+       + more about PEG1018 - generalizin VobVanishingClient
+       + new PEG from bubbleview, with some sketches
+        + rethink interfaces between PlainVanishing and VobScene
            - new PEG, UML
            - correct implementation of LollipopCellVobFactor needs
               to change connections' coordsys through Box
-       - port Mind* views from 0.6
+       + port Mind* views from 0.6
            - learn Box and make LollipopCellVobFactory use fixed dimensions
              for ball
        + fix the way nonlinearity of coordsys is handled.
@@ -124,69 +124,62 @@
            - fillets without the original object
                - normal direction as data
                - dicing only when needed
-               - don't
+               - fill with fading color
            - soft shadows
        - PP [deadline 5.11]
            - refactor
            - make it work again
                - bindings
+               - mouse click coordinates
            - nadir
            - fix directory geometry
            - HOME button
+           - proper enter
            - background texture - ?
            - speedups 
            - saving
            - soft shadows
            + merge !!!
-       - gzz.info: xupdf demo movie clearly accessible
-       + [GI03] irregu animations
-       + [GI03] paper animations?
-       - motion: grab & drag, not click & slide
-           - but paint for select?
-           - GRABBING BUOYS ?!!!
-       + new PEG about current PEG writing customs
-           - include restructuredtext rules (or link them from somewhere)
         - overall document about the goals and visions for the project
        - Main zz view:
             - Clipping in awt
            - text size in OpenGL
-       - xupdf: distorted multi-page PDF view with xu links
-           - larger structure 
-           - adjust dicing [from frame rate???]
-           - adjustable zoom / distortion area by mouse
+       - gzz.info: xupdf demo movie clearly accessible
+       + motion: grab & drag, not click & slide
+           - but paint for select?
+           - GRABBING BUOYS ?!!!
+       + [GI03] irregu animations
+       + [GI03] paper animations?
+       + xupdf: distorted multi-page PDF view with xu links
+           + larger structure 
+           + adjust dicing [from frame rate???]
+           + adjustable zoom / distortion area by mouse
            + discard high-rez images (500kB/image) ?
                (imagecache)
-           - faster loading of pagespan images
+           + faster loading of pagespan images
                - use lower resolution first, lazily load better
                    - deetsay's imagecache code?
-           - frame rate 
-               - paperquad texture binding LOD?
-                   - only when certain that texture memory
-                     bandwidth is the problem.
-                       - with CulledPQ, should not be.
-           - multiple instances of same cell visible as a buoy --> keys?
+           + multiple instances of same cell visible as a buoy --> keys?
                - special matcher? or pp/VobKeyer?
                - really USE hierarchical keys
            + joystick?
-       - demo movie script
-       - docxx new additions to gfx/
-       - clean GzzGL-jni
-       - javadoc TextVob specs
+       - demo movies
+       + docxx new additions to gfx/
+       + clean GzzGL-jni
+       + complete "Gzz technologies" white paper
     anybody:
-       - make callgl complain on broken stuff such as 
-         the string "%(texid)s" in place of a number !!!!
-         ARGH ARGH ARGH 
-       - test using pagespanview.ContentView as a CellContentView;
+       - test/ using pagespanview.ContentView as a CellContentView;
          currently broken.
+       + convert all documentation into RST format. Note: talk to Tjl
+         about how UML stuff should be done!
        + ZZ vanishingview cell size for pagespans and linebroken
          paragraphs, as well as libpaper backgrounds
-       - implement PEG 1007
+       + implement PEG 1007
            - javadoc gzz.vob.Vob* interfaces TOTALLY, including semantics of
              coordinate systems!
-       - IndexManager xuindexer semantics: fix behaviour of 
SimpleVStreamCellTexter
        + move *DebugVar* from GL into a new class, same on JNI side. (cleanup)
        + proper icons and names for the windows, both AWT and GL
-       - Synch!!!
+       + Synch!!!
        - unit tests that check that Gzz.py really starts
          the client.
          FOR BOTH AWT AND GL.
@@ -201,19 +194,12 @@
            - clean up OpenGL demos and views and document, list
              so easy to look at.
        - fix fillet demo last two screens
-       + if there are problems with performance, edit libcoords to use
-         boost::object_pool for making allocations much faster
        + make GLVobCoorder's all coordsys types
          work like affineCoordsys and setAffineParams, so
          that we can set the params from outside easier.
-       - Gzz.py client
+       + Gzz.py client
             + reload button  (key to reload jython code! All views (e.g. 
pagespanview,
              xubuoy))
-       + if performance problems, redesign coordsys to allow
-         concatenation, reading only parameters and template
-         compilation of renderables.
-           - statistics of what coordinate systems used inside
-             each other how much ==> which to templatize
        + fillet implementation handling all connections from a node
          simultaneously.
        + filleting en edge as a coordinate trasformation
@@ -223,6 +209,8 @@
          with "make clean" (try "cvs update; make clean; cvs update")
        + implement getCachedTexture in gzz/gfx/gl/GLCache.java
          (current implementation is in gfx/libpaper/texcache.py)
+       + for Documentation/TechReports/GzzTech, figure out how we can
+         use our bibtex file (in Documentation/Manuscripts) for citations.
 
 0.8alpha5: saving, loading etc. with mediaserver useful; tests
     deetsay:
@@ -259,7 +247,11 @@
     tuukkah:
        - document our UML software (metacode/uml*,
          used by doc/uml/*)
+    tjl:
+       - shape transformation & dicing framework
     anybody:
+       - IndexManager xuindexer semantics: fix behaviour of 
SimpleVStreamCellTexter
+         somehow
        - TOTAL UML documentation for all classes involved in
          the save/load stuff, collaboration diagrams etc.
          The path from structure to bytes and bytes to structure
@@ -442,8 +434,17 @@
 vegai: 0.6->0.8 data conversion tool
 
 anybody:
+    + if there are problems with performance, edit libcoords to use
+      boost::object_pool for making allocations much faster
+    + if performance problems, redesign coordsys to allow
+      concatenation, reading only parameters and template
+      compilation of renderables.
+       - statistics of what coordinate systems used inside
+         each other how much ==> which to templatize
+
     - OpenGL window size handling; whole-screen mode;
       detecting and adapting to window size.
+      Test syncing to vblank!
 
     - bulges:
         - try to find good grid size based on x0,y0,x1,y1
Index: gzz/gzz/vob/TextVob.java
diff -u gzz/gzz/vob/TextVob.java:1.42 gzz/gzz/vob/TextVob.java:1.43
--- gzz/gzz/vob/TextVob.java:1.42       Mon Oct 21 04:39:35 2002
+++ gzz/gzz/vob/TextVob.java    Fri Oct 25 04:20:23 2002
@@ -41,7 +41,7 @@
  * XXX Diagram!
  */
 public class TextVob extends HBox.VobHBox {
-String rcsid = "$Id: TextVob.java,v 1.42 2002/10/21 08:39:35 tjl Exp $";
+String rcsid = "$Id: TextVob.java,v 1.43 2002/10/25 08:20:23 tjl Exp $";
     public static boolean dbg = false;
     private static void pa(String s) { System.err.println(s); }
 
@@ -51,6 +51,13 @@
 
     protected Object key;
 
+    /** Create a new TextVob.
+     * @param style The textstyle to use.
+     * @param text The text that the Vob should show
+     * @param baselined If true, the baseline of the text will be at 
+     *                         the bottom of the unit square of the coordinate 
system.
+     *                         If false, the text will be comfortably within 
the box.
+     */
     public TextVob(TextStyle style, String text, boolean baselined) {
        super();
        this.style = style;
@@ -58,6 +65,8 @@
        this.text = text;
     }
 
+    /** Create a non-baselined text vob.
+     */
     public TextVob(TextStyle style, String text) {
        this(style, text, false);
     }