[GRASS-SVN] r31669 - grass/branches/develbranch_6/lib/ogsf

[svn_grass at osgeo.org]

Author: martinl
Date: 2008-06-10 09:42:09 -0400 (Tue, 10 Jun 2008)
New Revision: 31669

Modified:
   grass/branches/develbranch_6/lib/ogsf/GS2.c
   grass/branches/develbranch_6/lib/ogsf/gsd_views.c
Log:
ogsflib: doxygen docs updated (cosmetics)


Modified: grass/branches/develbranch_6/lib/ogsf/GS2.c
===================================================================
--- grass/branches/develbranch_6/lib/ogsf/GS2.c	2008-06-10 13:39:02 UTC (rev 31668)
+++ grass/branches/develbranch_6/lib/ogsf/GS2.c	2008-06-10 13:42:09 UTC (rev 31669)
@@ -2611,9 +2611,9 @@
 }
 
 /*!
-  \brief Move to position
+  \brief Move viewpoint 
 
-  \param pt point model coordinates
+  \param pt 'from' model coordinates
 */
 void GS_moveto(float *pt)
 {
@@ -2718,7 +2718,7 @@
 }
 
 /*!
-  \brief Get 'from' position
+  \brief Get viewpoint 'from' position
 
   \param[out] fr from model coordinates
 */
@@ -2732,7 +2732,7 @@
 }
 
 /*!
-  \brief Get 'from' real coordinates
+  \brief Get viewpoint 'from' real coordinates
 
   \param[out] fr 'from' real coordinates
 */
@@ -2867,7 +2867,7 @@
 }
 
 /*!
-  \brief Set twist value
+  \brief Set viewpoint twist value
 
   10ths of degrees off twelve o'clock
   
@@ -3165,7 +3165,7 @@
 }
 
 /*!
-  \brief Get scale
+  \brief Get axis scale
 
   \param sx,sy,sz x/y/z scale values
   \param doexag use vertical exaggeration
@@ -3269,7 +3269,7 @@
 ************************************************************************/
 
 /*!
-  \brief Init view
+  \brief Init viewpoint
 
   \todo allow to set center?
 */
@@ -3380,8 +3380,6 @@
     int left, right, bottom, top;
     GLint tmp[4];
 
-    G_debug(3, "GS_get_aspect");
-
     /* OGLXXX
      * get GL_VIEWPORT:
      * You can probably do better than this.
@@ -3392,6 +3390,9 @@
     bottom = tmp[1];
     top = tmp[1] + tmp[3] - 1;
 
+    G_debug(3, "GS_get_aspect(): left=%d, right=%d, top=%d, bottom=%d",
+	    left, right, top, bottom);
+
     return ((double) (right - left) / (top - bottom));
 }
 

Modified: grass/branches/develbranch_6/lib/ogsf/gsd_views.c
===================================================================
--- grass/branches/develbranch_6/lib/ogsf/gsd_views.c	2008-06-10 13:39:02 UTC (rev 31668)
+++ grass/branches/develbranch_6/lib/ogsf/gsd_views.c	2008-06-10 13:42:09 UTC (rev 31669)
@@ -159,10 +159,10 @@
 }
 
 /*!
-  \brief ADD
+  \brief Get z-up vector (z-direction)
 
   \param gv view (geoview)
-  \param up
+  \param up up vector
 */
 void gsd_get_zup(geoview * gv, double *up)
 {
@@ -316,7 +316,7 @@
 /*!
   \brief Convert model to real coordinates
 
-  \param point[in,out] 3d point (Point3)
+  \param point[in,out] 3d point (x,y,z)
 */
 void gsd_model2real(Point3 point)
 {