[QGIS Commit] r10751 - in docs/trunk/english_us: coding-compilation_guide user_guide user_guide/plugins_georeferencer_images user_guide/plugins_interpolation_images user_guide/plugins_mapserver_export_images

svn_qgis at osgeo.org svn_qgis at osgeo.org
Thu May 7 04:16:23 EDT 2009


Author: cfarmer
Date: 2009-05-07 04:16:23 -0400 (Thu, 07 May 2009)
New Revision: 10751

Modified:
   docs/trunk/english_us/coding-compilation_guide/plugins_writing_in_cpp.tex
   docs/trunk/english_us/coding-compilation_guide/preamble.tex
   docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex
   docs/trunk/english_us/user_guide/plugins_delimited_text.tex
   docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex
   docs/trunk/english_us/user_guide/plugins_georeferencer.tex
   docs/trunk/english_us/user_guide/plugins_georeferencer_images/choose_points.png
   docs/trunk/english_us/user_guide/plugins_georeferencer_images/georefplugin.png
   docs/trunk/english_us/user_guide/plugins_interpolation.tex
   docs/trunk/english_us/user_guide/plugins_interpolation_images/interpolate_idw.png
   docs/trunk/english_us/user_guide/plugins_mapserver_export.tex
   docs/trunk/english_us/user_guide/plugins_mapserver_export_images/Makefile
   docs/trunk/english_us/user_guide/plugins_ogr_converter.tex
   docs/trunk/english_us/user_guide/plugins_quick_print.tex
   docs/trunk/english_us/user_guide/preamble.tex
Log:
updates to several plugin sections, clean up screen captures... only plugin left is oracle georaster


Modified: docs/trunk/english_us/coding-compilation_guide/plugins_writing_in_cpp.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/plugins_writing_in_cpp.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/coding-compilation_guide/plugins_writing_in_cpp.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -27,25 +27,23 @@
 
 \subsection{Why C++ and what about licensing}
 
-QGIS itself is written in C++, so it also makes sense to write plugins in C++
-as well. It is an object-oriented programming (OOP) language that is viewed
-by many developers as a prefered language for creating large-scale
-applications.
+QGIS itself is written in C++, so it makes sense to write plugins in C++
+as well. It is an object-oriented programming (OOP) language that is prefered 
+by many developers for creating large-scale applications.
 
-QGIS C++ plugins use functionalities of libqgis*.so libraries. As they are
-licensed under GNU GPL, QGIS C++ plugins must be licenced under the GPL, too.
-This means you may use your plugins for any purpose and you are not forced to
+QGIS C++ plugins use the functionalities of libqgis*.so libraries. As they are
+licensed under the GNU GPL, QGIS C++ plugins must also be licenced under the GPL.
+This means that you may use your plugins for any purpose and you are not required to
 publish them. If you do publish them however, they must be published under
 the conditions of the GPL license. 
 
 \subsection{Programming a QGIS C++ Plugin in four steps}
 
-The example plugin is a point converter plugin and intentionally kept simple. 
-The plugin searches the active vector layer in QGIS, converts all vertices of
-the layer features to point features keeping the attributes and finally
-writes the point features into a delimited text file. The new layer can then
-be loaded into QGIS using the delimited text plugin (see Section
-\ref{label_dltext}).
+The C++ plugin example covered in this manual is a point converter plugin and intentionally kept simple. 
+The plugin searches the active vector layer in QGIS, converts all vertices of 
+the layer's features to point features keeping the attributes, and finally
+writes the point features to a delimited text file. The new layer can then
+be loaded into QGIS using the delimited text plugin (see User Manual).
 
 \minisec{Step 1: Make the plugin manager recognise the plugin}
 
@@ -174,7 +172,7 @@
 
 This step includes adding a pointer to the QgisInterface object in the plugin
 class. Then we create a QAction and a callback function (slot), add it to the
-QGIS GUI using QgisIface::addToolBarIcon() and QgisIface::addPluginToMenu()
+QGIS GUI using QgisInterface::addToolBarIcon() and QgisInterface::addPluginToMenu()
 and finally remove the QAction in the \method{unload()} method.
 
 \textbf{d) Open qgspointconverterplugin.h again and extend existing content to}:

Modified: docs/trunk/english_us/coding-compilation_guide/preamble.tex
===================================================================
--- docs/trunk/english_us/coding-compilation_guide/preamble.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/coding-compilation_guide/preamble.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -53,7 +53,7 @@
 \begin{tabular}{p{5cm} p{5cm} p{5cm}}
 Tim Sutton & Marco Hugentobler & Gary E. Sherman \\
 Tara Athan & Godofredo Contreras & Werner Macho \\
-Carson Farmer & Otto Dassau & J\"urgen E. Fischer \\
+Carson J.Q. Farmer & Otto Dassau & J\"urgen E. Fischer \\
 Davis Wills & Magnus Homann & Martin Dobias \\ 
 \end{tabular}
 

Modified: docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -13,7 +13,7 @@
 \begin{figure}[ht]
    \begin{center}
    \caption{Coordinate Cature Plugin \nixcaption}\label{fig:coordinate_capture_dialog}\smallskip
-   \includegraphics[clip=true]{coordinate_capture_dialog}
+   \includegraphics[clip=true, width=9cm]{coordinate_capture_dialog}
 \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_delimited_text.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_delimited_text.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_delimited_text.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -47,7 +47,7 @@
 \begin{figure}[ht]
    \begin{center}
    \caption{Delimited Text Dialog \nixcaption}\label{fig:delim_text_plugin_dialog}\smallskip
-   \includegraphics[clip=true, width=14cm]{delimited_text_dialog}
+   \includegraphics[clip=true, width=9cm]{delimited_text_dialog}
    \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -20,7 +20,7 @@
 \begin{figure}[ht]
    \begin{center}
    \caption{Dxf2Shape Converter Plugin \nixcaption}\label{fig:dxf2shape_dialog}\smallskip
-   \includegraphics[clip=true, width=13cm]{dxf2shape_dialog}
+   \includegraphics[clip=true, width=12cm]{dxf2shape_dialog}
 \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_georeferencer.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_georeferencer.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_georeferencer.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -19,27 +19,19 @@
 The usual procedure for georeferencing an image involves selecting multiple points on the raster, 
 specifying their coordinates, and choosing a relevant transformation type. Based on the input parameters and data, the plugin will compute the world file parameters. The more coordinates you provide, the better the result will be.
 
-For this example, we will generate a world file for a topo sheet of South Dakota from SDGS.
-It can later be visualized together with the data from the GRASS spearfish60 location.
-You can download the topo sheet here: \url{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}
+The first step is to start QGIS and load the Georeferencer Plugin (see Section 
+\ref{sec:load_core_plugin}) and click on the \toolbtntwo{georeferencer}{Georeferencer} 
+icon which appears in the QGIS toolbar menu. The Georeferencer Plugin dialog appears as 
+shown in Figure \ref{fig:georefplugin}.
+  
+For this example, we are using a topo sheet of South Dakota from SDGS. It can later be visualized 
+together with the data from the GRASS spearfish60 location. You can download the topo sheet here: 
+\url{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}
 
-As a first step we download the file and untar it.
-
-\begin{verbatim}
-wget http://grass.osgeo.org/sampledata/spearfish_toposheet.tar.gz
-tar xvzf spearfish_toposheet.tar.gz
-cd spearfish_toposheet
-\end{verbatim}
-
-The next step is to start QGIS and load the Georeferencer Plugin (see Section 
-  \ref{sec:load_core_plugin}) and click on the \toolbtntwo{georeferencer}{Georeferencer} 
-  icon which appears in the QGIS toolbar menu. The Georeferencer Plugin dialog appears as 
-  shown in Figure \ref{fig:georefplugin}.
-
 \begin{figure}[ht]
 \begin{center}
   \caption{Georeferencer Plugin Dialog \nixcaption}\label{fig:georefplugin}\smallskip
-  \includegraphics[clip=true,width=\textwidth]{georefplugin}
+  \includegraphics[clip=true, width=12cm]{georefplugin}
 \end{center}
 \end{figure}
 
@@ -60,7 +52,7 @@
 \begin{figure}[ht]
 \begin{center}
   \caption{Add points to the raster image \nixcaption}\label{fig:choose_points}\smallskip
-  \includegraphics[clip=true,width=0.9\textwidth]{choose_points}
+  \includegraphics[clip=true,width=9cm]{choose_points}
 \end{center}
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_georeferencer_images/choose_points.png
===================================================================
(Binary files differ)

Modified: docs/trunk/english_us/user_guide/plugins_georeferencer_images/georefplugin.png
===================================================================
(Binary files differ)

Modified: docs/trunk/english_us/user_guide/plugins_interpolation.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_interpolation.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_interpolation.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -54,7 +54,7 @@
 \begin{figure}[ht]
    \begin{center}
    \caption{Interpolation of elevp data using IDW method \nixcaption}\label{fig:interpolation_idw}\smallskip
-   \includegraphics[clip=true, width=\textwidth]{interpolate_idw}
+   \includegraphics[clip=true, width=12cm]{interpolate_idw}
 \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_interpolation_images/interpolate_idw.png
===================================================================
(Binary files differ)

Modified: docs/trunk/english_us/user_guide/plugins_mapserver_export.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_mapserver_export.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_mapserver_export.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -23,7 +23,7 @@
 \begin{center}
   \caption{Arrange raster and vector layers for QGIS project file \nixcaption}
   \label{fig:mapserver_export_qgs}\smallskip
-  \includegraphics[clip=true, width=12cm]{mapserver_export_qgs}
+  \includegraphics[clip=true, width=12cm]{mapserver_export_qgis}
 \end{center}
 \end{figure}
 
@@ -38,7 +38,7 @@
 \filename{airports.shp} from the QGIS sample dataset clicking on the 
 \toolbtntwo{mActionAddNonDbLayer}{Add Vector Layer} icon.
 \item Change the colors and symbolize the data as you like (For example see 
-Figure~\ref{fig:mapserver_export_qgs})
+Figure~\ref{fig:mapserver_export_qgis})
 \item Save a new project named \filename{mapserverproject.qgs} using 
 \mainmenuopt{File} > \dropmenuopttwo{mActionFileSave}{Save Project}.
 \end{enumerate} 
@@ -53,7 +53,7 @@
 \begin{center}
   \caption{Export to MapServer Dialog \nixcaption}
   \label{fig:mapserver_export_dialog}\smallskip
-  \includegraphics[clip=true, width=10cm]{mapserver_export_dialog}
+  \includegraphics[clip=true, width=9cm]{mapserver_export_dialog}
 \end{center}
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_mapserver_export_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_mapserver_export_images/Makefile	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_mapserver_export_images/Makefile	2009-05-07 08:16:23 UTC (rev 10751)
@@ -11,9 +11,9 @@
 # JPG=qgis_icon_new_verylarge.eps\
 
 PNG=mapserver_export.eps\
-mapserver_export_qgis.eps\
-mapserver_export_test.eps\
-mapserver_export_dialog.eps\
+	mapserver_export_qgis.eps\
+	mapserver_export_test.eps\
+	mapserver_export_dialog.eps\
 			
 ##### TARGETS #####
 

Modified: docs/trunk/english_us/user_guide/plugins_ogr_converter.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_ogr_converter.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_ogr_converter.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -19,8 +19,8 @@
 
 \begin{figure}[ht]
    \begin{center}
-   \caption{OGR Layer Converter Plugin \nixcaption}\label{fig:ogrconverter_dialog}\smallskip
-   \includegraphics[clip=true, width=9cm]{ogrconverter_dialog}
+   \caption{OGR Layer Converter Plugin \nixcaption}\label{fig:ogr_converter_dialog}\smallskip
+   \includegraphics[clip=true, width=9cm]{ogr_converter_dialog}
 \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/plugins_quick_print.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_quick_print.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/plugins_quick_print.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -9,6 +9,9 @@
 The \toolbtntwo{quick_print}{Quick Print} Plugin makes it possible to export the current 
 map canvas to PDF format quickly and easily, with minimal effort. The only parameters that 
 need to be specified are a Map Title, a Map Name, and the Paper Size (See Figure~\ref{fig:quickprint}). 
+If you require additional control over the map layout, 
+please use the print composer plugin, described in Section~\ref{label_printcomposer}.  
+
 \begin{figure}[ht]
    \begin{center}
    \caption{Quick Print Dialog \nixcaption}\label{fig:quickprint}\smallskip
@@ -16,13 +19,9 @@
 \end{center}
 \end{figure}
 
-Figure~\ref{fig:quickprint_result} below shows a DIN A4 Quick Print result 
-using the alaska sample dataset. If you require additional control over the map layout, 
-please use the print composer plugin, described in Section~\ref{label_printcomposer}.  
-
 \begin{figure}[ht]
    \begin{center}
-   \caption{Quick Print result as DIN A4 PDF\nixcaption}\label{fig:quickprint_result}\smallskip
+   \caption{Quick Print result as DIN A4 PDF using the alaska sample dataset\nixcaption}\label{fig:quickprint_result}\smallskip
    \includegraphics[clip=true, width=11cm]{quick_print_result}
 \end{center}
 \end{figure}

Modified: docs/trunk/english_us/user_guide/preamble.tex
===================================================================
--- docs/trunk/english_us/user_guide/preamble.tex	2009-05-06 22:49:48 UTC (rev 10750)
+++ docs/trunk/english_us/user_guide/preamble.tex	2009-05-07 08:16:23 UTC (rev 10751)
@@ -66,7 +66,7 @@
 Stephan Holl & Marco Hugentobler & Magnus Homann \\ 
 Lars Luthman & Gavin Macaulay & Werner Macho \\
 Tyler Mitchell & Brendan Morely & Gary E. Sherman \\ 
-Tim Sutton & David Willis &  \\
+Tim Sutton & David Willis & Carson J.Q. Farmer\\
 \end{tabular}
 
 \vspace{0.5cm}



More information about the QGIS-commit mailing list