[QGIS Commit] r9922 - in docs/trunk/english_us/user_guide: . images plugins_gps_images plugins_quick_print_images

svn_qgis at osgeo.org svn_qgis at osgeo.org
Sun Jan 4 08:22:07 EST 2009


Author: dassau
Date: 2009-01-04 08:22:07 -0500 (Sun, 04 Jan 2009)
New Revision: 9922

Added:
   docs/trunk/english_us/user_guide/images/zoom2point_icon.png
   docs/trunk/english_us/user_guide/plugins_gps_images/download.png
   docs/trunk/english_us/user_guide/plugins_gps_images/importdialog.png
   docs/trunk/english_us/user_guide/plugins_gps_images/loadgpx.png
   docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_dialog.png
   docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_result.png
Modified:
   docs/trunk/english_us/user_guide/core_plugins.tex
   docs/trunk/english_us/user_guide/external_plugins.tex
   docs/trunk/english_us/user_guide/images/Makefile
   docs/trunk/english_us/user_guide/plugins_gps.tex
   docs/trunk/english_us/user_guide/plugins_gps_images/Makefile
   docs/trunk/english_us/user_guide/plugins_quick_print.tex
   docs/trunk/english_us/user_guide/plugins_quick_print_images/Makefile
   docs/trunk/english_us/user_guide/user_guide.tex
Log:
added qucik print plugin
updated and reviewed gps section
updated external plugin section


Modified: docs/trunk/english_us/user_guide/core_plugins.tex
===================================================================
--- docs/trunk/english_us/user_guide/core_plugins.tex	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/core_plugins.tex	2009-01-04 13:22:07 UTC (rev 9922)
@@ -6,9 +6,12 @@
 % comment out the following line:
 %\updatedisclaimer
 
-QGIS currently contains 16 core plugins that can be loaded using the Plugin Manager.
-Table \ref{tab:core_plugins} lists each of the core plugins along with a description of 
-their purpose and the toolbar-icon.
+QGIS currently contains 17 core plugins that can be loaded using the Plugin Manager.
+Table \ref{tab:core_plugins} lists each of the core plugins along with a
+description of their purpose and the toolbar-icon.\footnote{The MapServer
+Export Plugin and the Plugin Installer Plugin are external Python Plugins,
+but they are part of the QGIS sources and automatically loaded and selectable 
+inside the QGIS Plugin Manager.}
 
 % minipage is needed to appear the footnote under the table
 % SH
@@ -20,52 +23,57 @@
  \begin{tabular}{|l|l|p{4in}|}
 \hline \textbf{Icon} & \textbf{Plugin} & \textbf{Description}\\
 \hline
-\includegraphics[width=0.7cm]{delimited_text}
+\includegraphics[width=0.6cm]{delimited_text}
  & Add Delimited Text Layer \index{plugins!delimited text} & Loads and displays delimited text files containing x,y coordinates\\
 \hline
-\includegraphics[width=0.7cm]{coordinate_capture}
+\includegraphics[width=0.6cm]{coordinate_capture}
  & Coordinate Capture \index{plugins!coordinate capture}& Capture mouse coordinate in different CRS\\
 \hline 
-\includegraphics[width=0.7cm]{copyright_label}
+\includegraphics[width=0.6cm]{copyright_label}
  & Copyright Label \index{plugins!copyright}& Draws a copyright label with information\\
 \hline 
-\includegraphics[width=0.7cm]{dxf2shp_converter}
+\includegraphics[width=0.6cm]{dxf2shp_converter}
  & DXF2Shape Converter \index{plugins!DXF2Shape}& Converts from DXF to SHP file format\\
 \hline
-\includegraphics[width=0.7cm]{gps_importer}
+\includegraphics[width=0.6cm]{gps_importer}
  & GPS Tools \index{plugins!gps}& Tools for loading and importing GPS data\\
 \hline
-\includegraphics[width=0.7cm]{grass}
+\includegraphics[width=0.6cm]{grass}
  & GRASS \index{plugin!grass toolbox} & Activates the mighty GRASS Toolbox\\
 \hline
-\includegraphics[width=0.7cm]{georeferencer}
+\includegraphics[width=0.6cm]{georeferencer}
  & Georeferencer \index{plugin!georeferencer} & Adding projection info to Rasterfiles\\
 \hline
-\includegraphics[width=0.7cm]{grid_maker}
+\includegraphics[width=0.6cm]{grid_maker}
  & Graticule Creator \index{plugins!graticule}& Create a latitude/longitude grid and save as a shapefile\\
 \hline
-\includegraphics[width=0.7cm]{interpolation}
+\includegraphics[width=0.6cm]{interpolation}
 & Interpolation plugin \index{plugins!Interpolation}& Interpolation on base of vertices of a vector layer\\
 \hline
-\includegraphics[width=0.7cm]{mapserver_export}
+\includegraphics[width=0.6cm]{mapserver_export}
 & MapServer Export Plugin \index{plugins!MapServer Export}& Export a saved QGIS project file to a MapServer map file \\
 \hline
-\includegraphics[width=0.7cm]{north_arrow}
+\includegraphics[width=0.6cm]{north_arrow}
 & North Arrow \index{plugins!north arrow}& Displays a north arrow overlayed onto the map\\
 \hline
-\includegraphics[width=0.7cm]{ogr_converter}
- & OGR Layer Converter \index{plugins!OGR converter} & Translate vector layers between formats supported by OGR-Library\\
+\includegraphics[width=0.6cm]{ogr_converter}
+ & OGR Layer Converter \index{plugins!OGR converter} & Translate vector
+layers between OGR suported formats\\
 \hline
-\includegraphics[width=0.7cm]{plugin_installer}
+\includegraphics[width=0.6cm]{plugin_installer}
  & Plugin Installer \index{plugins!Plugin Installer} & Downloads and installs QGIS python plugins\\
 \hline
-\includegraphics[width=0.7cm]{icon_buffer}
+\includegraphics[width=0.6cm]{spiticon}
  & SPIT \index{plugins!spit}& Shapefile to PostgreSQL/PostGIS Import Tool \\
 \hline
-\includegraphics[width=0.7cm]{scale_bar}
+\includegraphics[width=0.6cm]{quick_print}
+ & Qucik Print \index{plugins!quick print}& Quickly print a map with minimal
+effort \\
+\hline
+\includegraphics[width=0.6cm]{scale_bar}
  & Scalebar \index{plugins!scalebar}& Draws a scale bar\\
 \hline
-\includegraphics[width=0.7cm]{mIconAddWfsLayer}
+\includegraphics[width=0.6cm]{mIconAddWfsLayer}
  & WFS & Load and display WFS layer \\
 \hline
 \end{tabular}

Modified: docs/trunk/english_us/user_guide/external_plugins.tex
===================================================================
--- docs/trunk/english_us/user_guide/external_plugins.tex	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/external_plugins.tex	2009-01-04 13:22:07 UTC (rev 9922)
@@ -6,13 +6,23 @@
 % comment out the following line:
 \updatedisclaimer
 
-External QGIS plugins are all written in python. They are stored in 
+External QGIS plugins are written in python. They are stored in 
 an official, moderated repository and maintained by the individual 
 author. Table \ref{tab:external_plugins} shows a list of plugins 
-currently available. All these plugins are descibed in this manual.
-Also updates of core plugins may be available in this repository as 
-external overlays.
+currently available with a short description.\footnote{Also updates of 
+core plugins may be available in this repository as external overlays.} 
+\footnote{The Python Plugin Installer is also an external Python Plugin, but 
+it is part of the QGIS sources and automatically loaded and selectable inside
+the QGIS Plugin Manager (see Section~\ref{sec:load_external_plugin}).}
+An up-to-date list of moderated external plugins is available in the 
+QGIS Official Repository of the
+\dropmenuopttwo{plugin_installer}{Fetch Python Plugins...}) and at 
+\url{http://qgis.osgeo.org/download/plugins.html}. 
 
+A detailed documentation about the usage, the author and other important
+information are provided with the external plugin itself and not part of this
+manual. 
+
 \begin{table}[H]
 \centering
 \caption{QGIS moderated external Plugins}\label{tab:external_plugins}\medskip
@@ -20,16 +30,11 @@
  \begin{tabular}{|l|l|p{4in}|}
 \hline \textbf{Icon} & \textbf{external Plugin} & \textbf{Description}\\
 \hline
-\includegraphics[width=0.7cm]{ftoolslogo}
- & fTools \index{plugins!fTools} & Vector analysis and data management tools\\
+\includegraphics[width=0.7cm]{zoom2point_icon}
+ & Zoom To Point \index{plugins!Zoom To Point} & Zooms to a coordinate 
+  specified in the input dialog. You can specify the zoom level as well to 
+  control the view extent.\\
 \hline
-%\includegraphics[width=0.7cm]{tableManagerIcon}
-% & Table Manager \index{plugins!Table Manager}& Manage attribute tables \\
-%\hline
-%\includegraphics[width=0.7cm]{ftoolslogo}
-% & Raster Algebra \index{plugins!Raster Algebra}& Basic raster algebra 
-%for GDAL supported raster layer\\
-%\hline
 \end{tabular}
 \end{table}
 
@@ -57,6 +62,3 @@
 }
 \end{Tip}
 
-
-
-

Modified: docs/trunk/english_us/user_guide/images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/images/Makefile	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/images/Makefile	2009-01-04 13:22:07 UTC (rev 9922)
@@ -122,7 +122,8 @@
   mActionMoveItemsToTop.eps \
   mActionRaiseItems.eps \
   mActionMoveItemsToBottom.eps \
-  		
+  zoom2point_icon.eps\
+ 		
 ##### TARGETS #####
 
 all: $(PNG) $(JPG)

Added: docs/trunk/english_us/user_guide/images/zoom2point_icon.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/images/zoom2point_icon.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: docs/trunk/english_us/user_guide/plugins_gps.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_gps.tex	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/plugins_gps.tex	2009-01-04 13:22:07 UTC (rev 9922)
@@ -4,7 +4,7 @@
 
 % when the revision of a section has been finalized, 
 % comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
 
 \subsubsection{What is GPS?}\label{whatsgps}
 
@@ -21,20 +21,31 @@
 The format that QGIS uses is called GPX (GPS eXchange format), which is a standard interchange format that can contain any number of waypoints, routes and tracks in the same file.
 
 To load a GPX file you first need to load the plugin.
-\mainmenuopt{Plugins} > \dropmenuopttwo{mActionShowPluginManager}{Plugin Manager...} > \checkbox{GPS Tools}
+\mainmenuopt{Plugins} > \dropmenuopttwo{mActionShowPluginManager}{Plugin
+Manager...} > \checkbox{GPS Tools}. When this plugin is loaded a button with a 
+small handheld GPS device will show up in the toolbar. An example GPX file is 
+available in the QGIS sample dataset:
+\filename{/qgis\_sample\_data/gps/national\_monuments.gpx}. See
+Section~\ref{label_sampledata} for more information about the sample data.
 
-When this plugin is loaded a button with a small handheld GPS device will show up in the toolbar.
-Clicking on this button \toolbtntwo{gps_importer}{GPS Tools} will open the GPS Tools dialog (see figure \ref{gpxloader}).
+\begin{enumerate}
+\item Click on the \toolbtntwo{gps_importer}{GPS Tools} icon and open the
+\tab{Load GPX file} tab.
+\item \button{Browse} to the folder \filename{qgis\_sample\_data/gps/},
+select the GPX file \filename{national\_monuments.gpx} and click \button{Open}.
+\end{enumerate}
 
-%\begin{figure}[ht]
-%   \begin{center}
-%\caption{\label{gpxloader}The \emph{GPS Tools} dialog window}
-%\includegraphics[clip=true, width=12cm]{loadgpx}
-%\end{center}
-%\end{figure}
+\begin{figure}[ht]
+   \begin{center}
+\caption{\label{gpxloader}The \emph{GPS Tools} dialog window \nixcaption}
+\includegraphics[clip=true, width=12cm]{loadgpx}
+\end{center}
+\end{figure}
 
-Use the browse button \browsebutton to select the GPX file, then use the checkboxes to select the feature types you want to load from that GPX file.
+Use the browse button \browsebutton to select the GPX file, then use the
+checkboxes to select the feature types you want to load from that GPX file.
 Each feature type will be loaded in a separate layer when you click \button{OK}.
+The file \filename{national\_monuments.gpx} only includes waypoints.
 
 \subsubsection{GPSBabel}
 
@@ -52,16 +63,16 @@
 To import GPS data from a file that is not a GPX file, you use the tool \tab{Import other file} in the GPS Tools dialog.
 Here you select the file that you want to import, which feature type you want to import from it, where you want to store the converted GPX file and what the name of the new layer should be.
 
-When you select the file to import you must also select the format of that file by using the menu in the file selection dialog (see figure \ref{figure importdialog}).
-All formats do not support all three feature types, so for many formats you will only be able to choose between one or two types.
+When you select the file to import you must also select the format of that file by using the menu in the file selection dialog (see figure \ref{figure importdialog}). All formats do not support all three feature types, so for many formats 
+you will only be able to choose between one or two types. 
 
-%\begin{figure}[ht]
-%   \begin{center}
-%\caption{\label{figure importdialog}File selection dialog for the import
-%tool}
-%\includegraphics[clip=true, width=12cm]{importdialog}
-%   \end{center}
-%\end{figure}
+\begin{figure}[ht]
+   \begin{center}
+\caption{\label{figure importdialog}File selection dialog for the import
+tool \nixcaption}
+\includegraphics[clip=true, width=12cm]{importdialog}
+   \end{center}
+\end{figure}
 
 \subsubsection{Downloading GPS data from a device}
 
@@ -69,12 +80,12 @@
 For this you use the tool \tab{Download from GPS} (see Figure \ref{figure_download}), where you select your type
 of GPS device, the port that it is connected to, the feature type that you want to download, the GPX file where the data should be stored, and the name of the new layer.
 
-%\begin{figure}[ht]
-%   \begin{center}
-%\caption{\label{figure_download}The download tool}
-%\includegraphics[clip=true, width=12cm]{download}
-%   \end{center}
-%\end{figure}
+\begin{figure}[ht]
+   \begin{center}
+\caption{\label{figure_download}The download tool \nixcaption}
+\includegraphics[clip=true, width=12cm]{download}
+   \end{center}
+\end{figure}
 
 
 The device type you select in the GPS device menu determines how GPSBabel tries to communicate with the device.

Modified: docs/trunk/english_us/user_guide/plugins_gps_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_gps_images/Makefile	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/plugins_gps_images/Makefile	2009-01-04 13:22:07 UTC (rev 9922)
@@ -12,8 +12,10 @@
 #	nextfile.eps
 
 PNG=gps_importer.eps\
+    download.eps\
+    importdialog.eps\
+    loadgpx.eps\
 	
-	
 ##### TARGETS #####
 
 all: $(PNG) $(JPG)

Added: docs/trunk/english_us/user_guide/plugins_gps_images/download.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/plugins_gps_images/download.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: docs/trunk/english_us/user_guide/plugins_gps_images/importdialog.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/plugins_gps_images/importdialog.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: docs/trunk/english_us/user_guide/plugins_gps_images/loadgpx.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/plugins_gps_images/loadgpx.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: docs/trunk/english_us/user_guide/plugins_quick_print.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_quick_print.tex	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/plugins_quick_print.tex	2009-01-04 13:22:07 UTC (rev 9922)
@@ -1,14 +1,31 @@
 % vim: set textwidth=78 autoindent:
 
-\subsection{Using the Quick Print Plugin}
+\subsection{Quick Print Plugin}
 
 % when the revision of a section has been finalized, 
 % comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
 
+The \toolbtntwo{quick_print}{Quick Print} Plugin allows to print the current 
+map canvas with minimal effort into PDF format. All the user needs to add 
+is a Map Title, a Map Name and the Paper Size (See Figure~\ref{fig:quickprint}). 
+\begin{figure}[ht]
+   \begin{center}
+   \caption{Quick Print Dialog \nixcaption}\label{fig:quickprint}\smallskip
+   \includegraphics[clip=true, width=6cm]{quick_print_dialog}
+\end{center}
+\end{figure}
 
+Figure~\ref{fig:quickprint_result} below shows a DIN A4 quick print result 
+from the alaska sample dataset. If you want more control over the map layout, 
+please use the print composer plugin, described in 
+Section~\ref{label_printcomposer}.  
 
-\newpage
+\begin{figure}[ht]
+   \begin{center}
+   \caption{Quick Print result as DIN A4 PDF\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/plugins_quick_print_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_quick_print_images/Makefile	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/plugins_quick_print_images/Makefile	2009-01-04 13:22:07 UTC (rev 9922)
@@ -12,6 +12,8 @@
 #	nextfile.eps
 
 PNG=quick_print.eps\
+    quick_print_dialog.eps\
+    quick_print_result.eps\
 	
 ##### TARGETS #####
 

Added: docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_dialog.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_dialog.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_result.png
===================================================================
(Binary files differ)


Property changes on: docs/trunk/english_us/user_guide/plugins_quick_print_images/quick_print_result.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: docs/trunk/english_us/user_guide/user_guide.tex
===================================================================
--- docs/trunk/english_us/user_guide/user_guide.tex	2009-01-04 11:00:55 UTC (rev 9921)
+++ docs/trunk/english_us/user_guide/user_guide.tex	2009-01-04 13:22:07 UTC (rev 9922)
@@ -31,13 +31,14 @@
 \include{plugins_delimited_text}
 \include{plugins_dxf2shape_converter}
 \include{plugins_georeferencer}
+\include{plugins_quick_print}
 \include{plugins_gps}
 \include{plugins_graticule_creator}
 \include{plugins_interpolation}
 \include{plugins_mapserver_export}
 \include{plugins_ogr_converter}
 \include{external_plugins}
-\include{plugins_ftools}
+%\include{plugins_ftools}
 %\include{plugins_table_manager}
 %\include{plugins_raster_algebra}
 \include{plugins_writing_in_cpp}



More information about the QGIS-commit mailing list