[GRASS-SVN] r32037 - in grass/trunk/lib: . nviz ogsf

[svn_grass at osgeo.org]

Author: martinl
Date: 2008-07-07 04:50:29 -0400 (Mon, 07 Jul 2008)
New Revision: 32037

Added:
   grass/trunk/lib/nviz/nvizlib.dox
Modified:
   grass/trunk/lib/grasslib.dox
   grass/trunk/lib/ogsf/GS2.c
Log:
ogsflib: doxygen update
nvizlib: doxygen page added (just template)


Modified: grass/trunk/lib/grasslib.dox
===================================================================
--- grass/trunk/lib/grasslib.dox	2008-07-06 22:26:57 UTC (rev 32036)
+++ grass/trunk/lib/grasslib.dox	2008-07-07 08:50:29 UTC (rev 32037)
@@ -95,7 +95,7 @@
 <li>symbol:	Drawing symbols for %point %vector data library - \ref symbol
 <li>vask:	Cursor management library - \ref vask
 <li>%vector:	\ref Vector_Library (GRASS Vector and Direct Graph Library)
-<li>nviz:       Nviz library (used by wxGUI Nviz extension and CLI-based Nviz module)
+<li>nviz:       \ref nvizlib (used by wxGUI Nviz extension and CLI-based Nviz module)
 </ul>
 <!--<li>image3:	extra imagery library (mainly still unused) - \ref image3lib-->
 <!--<li>D:		display library - \ref d_displaylib-->

Added: grass/trunk/lib/nviz/nvizlib.dox
===================================================================
--- grass/trunk/lib/nviz/nvizlib.dox	                        (rev 0)
+++ grass/trunk/lib/nviz/nvizlib.dox	2008-07-07 08:50:29 UTC (rev 32037)
@@ -0,0 +1,8 @@
+/*! \page nvizlib GRASS Nviz Library
+
+\section nvizintro Introduction to Nviz Library
+
+This library is build on \ref ogsflib and serves as the interface for
+wxGUI Nviz extension and CLI-based Nviz module.
+
+*/


Property changes on: grass/trunk/lib/nviz/nvizlib.dox
___________________________________________________________________
Name: svn:mime-type
   + text/x-plain
Name: svn:keywords
   + Author Date Id
Name: svn:eol-style
   + native

Modified: grass/trunk/lib/ogsf/GS2.c
===================================================================
--- grass/trunk/lib/ogsf/GS2.c	2008-07-06 22:26:57 UTC (rev 32036)
+++ grass/trunk/lib/ogsf/GS2.c	2008-07-07 08:50:29 UTC (rev 32037)
@@ -2382,17 +2382,15 @@
 }
 
 /*!
-  \brief Set trans ?
+  \brief Set translation (surface position)
 
   \param id surface id
-  \param xtrans,ytrans,ztrans real trans coordinates
+  \param xtrans,ytrans,ztrans translation values
 */
 void GS_set_trans(int id, float xtrans, float ytrans, float ztrans)
 {
     geosurf *gs;
 
-    G_debug(3, "GS_set_trans");
-
     gs = gs_get_surf(id);
 
     if (gs) {
@@ -2401,21 +2399,22 @@
 	gs->z_trans = ztrans;
     }
 
+    G_debug(3, "GS_set_trans(): id=%d, x=%f, y=%f, z=%f",
+	    id, xtrans, ytrans, ztrans);
+
     return;
 }
 
 /*!
-  \brief Get trans ?
+  \brief Get translation values (surface position)
 
   \param id surface id
-  \param[out] xtrans,ytrans,ztrans real trans coordinates
+  \param[out] xtrans,ytrans,ztrans trans values
 */
 void GS_get_trans(int id, float *xtrans, float *ytrans, float *ztrans)
 {
     geosurf *gs;
 
-    G_debug(3, "GS_get_trans");
-
     gs = gs_get_surf(id);
 
     if (gs) {
@@ -2424,6 +2423,9 @@
 	*ztrans = gs->z_trans;
     }
 
+    G_debug(3, "GS_get_trans: id=%d, x=%f, y=%f, z=%f",
+	    id, *xtrans, *ytrans, *ztrans);
+
     return;
 }