[QGIS Commit] r9907 - in docs/trunk/english_us/user_guide: .
plugins_decorations_images plugins_delimited_text_images
plugins_graticule_creator_images
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Sun Dec 28 16:00:28 EST 2008
Author: dassau
Date: 2008-12-28 16:00:28 -0500 (Sun, 28 Dec 2008)
New Revision: 9907
Added:
docs/trunk/english_us/user_guide/plugins_decorations_images/copyright.png
docs/trunk/english_us/user_guide/plugins_decorations_images/north_arrow_dialog.png
docs/trunk/english_us/user_guide/plugins_decorations_images/scale_bar_dialog.png
docs/trunk/english_us/user_guide/plugins_delimited_text_images/delimited_text_dialog.png
docs/trunk/english_us/user_guide/plugins_graticule_creator_images/grid_maker_dialog.png
Modified:
docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex
docs/trunk/english_us/user_guide/plugins_decorations.tex
docs/trunk/english_us/user_guide/plugins_decorations_images/Makefile
docs/trunk/english_us/user_guide/plugins_delimited_text.tex
docs/trunk/english_us/user_guide/plugins_delimited_text_images/Makefile
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_graticule_creator.tex
docs/trunk/english_us/user_guide/plugins_graticule_creator_images/Makefile
docs/trunk/english_us/user_guide/plugins_interpolation.tex
docs/trunk/english_us/user_guide/plugins_mapserver_export.tex
docs/trunk/english_us/user_guide/plugins_ogr_converter.tex
Log:
add missing plugin figures and review
Modified: docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_coordinate_capture.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,7 +4,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
The coordinate capture plugin is easy to use and provides the
capability to display coordinates on the map canvas for two
Modified: docs/trunk/english_us/user_guide/plugins_decorations.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_decorations.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_decorations.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,29 +4,23 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
-The Decorations Plugins includes the following:
+The Decorations Plugins includes the Copyright Label Plugin, the North
+Arrow Plugin and the Scale Bar Plugin. They are used to ``decorate'' the
+map by adding cartographic elements.
-\begin{itemize}
-\item Copyright Label Plugin
-\item North Arrow Plugin
-\item Scale Bar Plugin
-\end{itemize}
-
-These ``decorate'' the map by adding cartographic elements.
-
\subsubsection{Copyright Label Plugin}
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{Copyright Label Plugin}\label{fig:copyright}\smallskip
-% \includegraphics[clip=true, width=8cm]{copyright}
-%\end{center}
-%\end{figure}
-
The title of this plugin is a bit misleading - you can add any random text to the map.
+\begin{figure}[ht]
+ \begin{center}
+ \caption{Copyright Label Plugin \nixcaption}\label{fig:copyright}\smallskip
+ \includegraphics[clip=true, width=8cm]{copyright}
+\end{center}
+\end{figure}
+
\begin{enumerate}
\item Make sure the plugin is loaded
\item Click on \mainmenuopt{Plugins} > \dropmenuopt{Decorations} > \dropmenuopttwo{copyright_label}{Copyright Label} or use the \toolbtntwo{copyright_label}{Copyright Label} button from the Toolbar.
@@ -47,18 +41,16 @@
present there is only one style available. You can adjust the angle of the
arrow or let QGIS set the direction automatically. If you choose to let
QGIS determine the direction, it makes its best guess as to how the arrow
-should be oriented.
+should be oriented. For placement of the arrow you have four options,
+corresponding to the four corners of the map canvas.
-For placement of the arrow you have four options, corresponding to the four
-corners of the map canvas.
+\begin{figure}[ht]
+ \begin{center}
+ \caption{North Arrow Plugin \nixcaption}\label{fig:north_arrow}\smallskip
+ \includegraphics[clip=true, width=8cm]{north_arrow_dialog}
+\end{center}
+\end{figure}
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{North Arrow Plugin}\label{fig:north_arrow}\smallskip
-% \includegraphics[clip=true, width=8cm]{north_arrow}
-%\end{center}
-%\end{figure}
-
\subsubsection{Scale Bar Plugin}
The Scale Bar plugin adds a simple scale bar to the map canvas. You
control the style and placement, as well as the labeling of the bar.
@@ -82,9 +74,9 @@
\item Click \button{OK}
\end{enumerate}
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{Scale Bar Plugin}\label{fig:scale_bar}\smallskip
-% \includegraphics[clip=true, width=8cm]{scale_bar}
-%\end{center}
-%\end{figure}
+\begin{figure}[ht]
+ \begin{center}
+ \caption{Scale Bar Plugin \nixcaption}\label{fig:scale_bar}\smallskip
+ \includegraphics[clip=true, width=8cm]{scale_bar_dialog}
+\end{center}
+\end{figure}
Modified: docs/trunk/english_us/user_guide/plugins_decorations_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_decorations_images/Makefile 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_decorations_images/Makefile 2008-12-28 21:00:28 UTC (rev 9907)
@@ -14,6 +14,10 @@
PNG=copyright_label.eps\
north_arrow.eps\
scale_bar.eps\
+ copyright.eps\
+ north_arrow_dialog.eps\
+ scale_bar_dialog.eps\
+
##### TARGETS #####
Added: docs/trunk/english_us/user_guide/plugins_decorations_images/copyright.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_decorations_images/copyright.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: docs/trunk/english_us/user_guide/plugins_decorations_images/north_arrow_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_decorations_images/north_arrow_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: docs/trunk/english_us/user_guide/plugins_decorations_images/scale_bar_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_decorations_images/scale_bar_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: docs/trunk/english_us/user_guide/plugins_delimited_text.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_delimited_text.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_delimited_text.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,12 +4,12 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The Delimited Text plugin allows you to load a delimited text file as a layer in QGIS.
-
-\subsubsection{Requirements}
+\minisec{Requirements}
+
To view a delimited text file as layer, the text file must contain:
\begin{enumerate}
@@ -18,33 +18,28 @@
\item The x and y coordinates must be specified as a number. The coordinate system is not important.
\end{enumerate}
-An example of a valid text file might look like this:
+As an example of a valid text file we import the elevation point data file
+\filename{elevp.csv} coming with the QGIS sample dataset (See Section~\ref{label_sampledata}):
\begin{verbatim}
-name|latdec|longdec|cell|
-196 mile creek|61.89806|-150.0775|tyonek d-1 ne|
-197 1/2 mile creek|61.89472|-150.09972|tyonek d-1 ne|
-a b mountain|59.52889|-135.28333|skagway c-1 sw|
-apw dam number 2|60.53|-145.75167|cordova c-5 sw|
-apw reservoir|60.53167|-145.75333|cordova c-5 sw|
-apw reservoir|60.53|-145.75167|cordova c-5 sw|
-aaron creek|56.37861|-131.96556|bradfield canal b-6|
-aaron island|58.43778|-134.81944|juneau b-3 ne|
-aats bay|55.905|-134.24639|craig d-7|
+X;Y;ELEV
+-300120;7689960;13
+-654360;7562040;52
+1640;7512840;3
+[...]
\end{verbatim}
-
Some items of note about the text file are:
-\begin{enumerate}
-\item The example text file uses \mbox{$|$} as delimiter. Any character can be used to delimit the fields.
-\item The first row is the header row. It contains the fields name, latdec, longdec and cell.
+\begin{enumerate}
+\item The example text file uses \mbox{$;$} as delimiter. Any character can be used to delimit the fields.
+\item The first row is the header row. It contains the fields X, Y and ELEV.
\item No quotes ({\tt{}"{}}) are used to delimit text fields.
-\item The x coordinates are contained in the {\em longdec} field.
-\item The y coordinates are contained in the {\em latdec} field.
+\item The x coordinates are contained in the {\em X} field.
+\item The y coordinates are contained in the {\em Y} field.
\end{enumerate}
-\subsubsection{Using the Plugin}
+\minisec{Using the Plugin}
To use the plugin you must have QGIS running and use the Plugin Manager to load the plugin:
Start QGIS, then open the Plugin Manager by choosing \mainmenuopt{Plugins} > \dropmenuopttwo{mActionShowPluginManager}{Plugin Manager...}
@@ -53,55 +48,23 @@
Those that are already loaded have a check mark to the left of their name.
Click on the checkbox to the left of the \checkbox{Add Delimited Text Layer} plugin and click \button{OK} to load it as described in Section \ref{sec:managing_plugins}.
-
-A new toolbar icon is now present:
-\includegraphics[width=0.7cm]{delimited_text}
-Click on the icon \toolbtntwo{delimited_text}{Add Delimited Text Layer} to open the Delimited Text dialog as shown in Figure
+Click the new toolbar icon \toolbtntwo{delimited_text}{Add Delimited Text Layer} to open the Delimited Text dialog as shown in Figure
\ref{fig:delim_text_plugin_dialog}.
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{Delimited Text
-%Dialog}\label{fig:delim_text_plugin_dialog}\smallskip
-%\includegraphics[clip=true, width=8cm]{dialog}
-% \end{center}
-%\end{figure}
+\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}
+ \end{center}
+\end{figure}
-First select the file to import by clicking on the \browsebutton .
-Select the desired text file from the file dialog.
-Once the file is selected, the plugin attempts to parse the file using the last used delimiter, in this case \mbox{$|$} (see Figure \ref{fig:delim_text_file_selected}).
-
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{File Selected}\label{fig:delim_text_file_selected}\smallskip
-%\includegraphics[clip=true, width=8cm]{file_selected}
-% \end{center}
-%\end{figure}
-
-In this case the delimiter \mbox{$|$} is not correct for the file.
-The file is actually tab delimited.
-Note that the X and Y field drop down boxes do not contain valid field names.
-
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{Fields Parsed from Text
-%File}\label{fig:delim_text_file_selected2}\smallskip
-%\includegraphics[clip=true, width=8cm]{file_selected2}
-% \end{center}
-%\end{figure}
-
-To properly parse the file, change the delimiter to tab using \mbox{$\backslash$}t (this is a regular expression for the tab character).
+First select the file \filename{qgis\_sample\_data/csv/elevp.csv} to import by clicking
+on the \button{Browse} button. Once the file is selected, the plugin attempts to parse the file
+using the last used delimiter, in this case \mbox{$;$}. To properly parse the file, it
+is important to select the correct delimiter. To change the delimiter to tab use
+\mbox{$\backslash$}t (this is a regular expression for the tab character).
After changing the delimiter, click \button{Parse}.
-The drop down boxes now contain the fields properly parsed as shown in Figure \ref{fig:delim_text_file_selected2}.
-%\begin{figure}[ht]
-% \begin{center}
-% \caption{Selecting the X and Y
-%Fields}\label{fig:delim_text_file_selected3}\smallskip
-%\includegraphics[clip=true, width=8cm]{file_selected3}
-% \end{center}
-%\end{figure}
-
-Choose the X and Y fields from the drop down boxes and enter a Layer name as shown in Figure \ref{fig:delim_text_file_selected3}.
-To add the layer to the map, click \button{Add Layer}.
-The delimited text file now behaves as any other map layer in QGIS.
+Choose the X and Y fields from the drop down boxes and enter a Layer name \filename{elevp}
+as shown in Figure \ref{fig:delim_text_plugin_dialog}. To add the layer to the map, click
+\button{Add Layer}. The delimited text file now behaves as any other map layer in QGIS.
Modified: docs/trunk/english_us/user_guide/plugins_delimited_text_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_delimited_text_images/Makefile 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_delimited_text_images/Makefile 2008-12-28 21:00:28 UTC (rev 9907)
@@ -12,13 +12,7 @@
# nextfile.eps
PNG=delimited_text.eps\
-# ellipsis.eps\
-# file_selected.eps\
-# file_selected1.eps\
-# file_selected2.eps\
-# file_selected3.eps\
-# plugin_manager.eps\
-# toolbar_icon.eps
+ delimited_text_dialog.eps\
##### TARGETS #####
Added: docs/trunk/english_us/user_guide/plugins_delimited_text_images/delimited_text_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_delimited_text_images/delimited_text_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_dxf2shape_converter.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,7 +4,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The dxf2shape converter plugin allows to convert vector data from DXF to Shapefile
format. It is very simple to handle and provides following functionality as
Modified: docs/trunk/english_us/user_guide/plugins_georeferencer.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_georeferencer.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_georeferencer.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,7 +4,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The \toolbtntwo{georeferencer}{Georeferencer} allows to generate world files for rasters.
Therefore you select points on the raster, add their coordinates, and the plugin will compute the world file parameters.
@@ -27,7 +27,7 @@
\begin{figure}[ht]
\begin{center}
\caption{Select an image to georeference \nixcaption}\label{fig:select_image}\smallskip
- \includegraphics[clip=true, width=10cm]{select_image}
+ \includegraphics[clip=true, width=12cm]{select_image}
\end{center}
\end{figure}
@@ -54,7 +54,7 @@
\begin{figure}[ht]
\begin{center}
\caption{Add points to the raster image \nixcaption}\label{fig:choose_points}\smallskip
- \includegraphics[clip=true,width=0.8\textwidth]{choose_points}
+ \includegraphics[clip=true,width=0.9\textwidth]{choose_points}
\end{center}
\end{figure}
Modified: docs/trunk/english_us/user_guide/plugins_graticule_creator.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_graticule_creator.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_graticule_creator.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,25 +4,26 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+% \updatedisclaimer
-The graticule creator allows to create a ``grid'' of points, line or polygons to cover our area of interest.
+The graticule creator allows to create a ``grid'' of points or polygons to cover our area of interest.
All units must be entered in decimal degrees.
The output is a shapefile which can be projected on the fly to match your other data.
-%\begin{figure}[ht]
-%\begin{center}
-% \caption{Create a graticule layer}\label{fig:graticule}\smallskip
-% \includegraphics[scale=0.5]{graticule}
-%\end{center}
-%\end{figure}
+\begin{figure}[ht]
+\begin{center}
+ \caption{Create a graticule layer \nixcaption}\label{fig:graticule}\smallskip
+ \includegraphics[clip=true, width=10cm]{grid_maker_dialog}
+\end{center}
+\end{figure}
Here is an example how to create a graticule:
\begin{enumerate}
-\item Make sure the plugin is loaded.
-\item Click on the \toolbtntwo{grid_maker}{Graticule Creator} tool on the plugins toolbar.
-\item Choose the type of graticule you wish to create: point, line or polygon.
+\item Start QGIS, load the Graticule Creator Plugin in the Plugin Manager (see Section
+\ref{sec:load_core_plugin}) and click on the \toolbtntwo{grid_maker}{Graticule Creator}
+icon which appears in the QGIS toolbar menu.
+\item Choose the type of graticule you wish to create: point or polygon.
\item Enter the latitude and longitude for the lower left and upper right corners of the graticule.
\item Enter the interval to be used in constructing the grid. You can enter different values for the X and Y directions (longitude, latitude)
\item Choose the name and location of the shapefile to be created.
Modified: docs/trunk/english_us/user_guide/plugins_graticule_creator_images/Makefile
===================================================================
--- docs/trunk/english_us/user_guide/plugins_graticule_creator_images/Makefile 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_graticule_creator_images/Makefile 2008-12-28 21:00:28 UTC (rev 9907)
@@ -12,6 +12,7 @@
# nextfile.eps
PNG=grid_maker.eps\
+ grid_maker_dialog.eps\
##### TARGETS #####
Added: docs/trunk/english_us/user_guide/plugins_graticule_creator_images/grid_maker_dialog.png
===================================================================
(Binary files differ)
Property changes on: docs/trunk/english_us/user_guide/plugins_graticule_creator_images/grid_maker_dialog.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: docs/trunk/english_us/user_guide/plugins_interpolation.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_interpolation.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_interpolation.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,11 +4,11 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The Interplation plugin allows to interpolate a TIN or IDW raster layer from a vector
point layer loaded in the QGIS canvas. It is very simple to handle and provides
-functionalities as shown in Figure \ref{fig:interpolate_dialog}.
+functionalities as shown in Figure \ref{fig:interpolation_dialog}.
\begin{itemize}
\item \textbf{Input vector layer}: Select vector point layer loaded in the QGIS canvas.
@@ -51,7 +51,7 @@
\begin{figure}[ht]
\begin{center}
\caption{Interpolation of elevp data using IDW method \nixcaption}\label{fig:interpolation_idw}\smallskip
- \includegraphics[clip=true, width=16cm]{interpolate_idw}
+ \includegraphics[clip=true, width=\textwidth]{interpolate_idw}
\end{center}
\end{figure}
Modified: docs/trunk/english_us/user_guide/plugins_mapserver_export.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_mapserver_export.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_mapserver_export.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,7 +4,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
You can use QGIS to ``compose'' your map by adding and arranging layers,
symbolizing them, customizing the colors and then create a map file
@@ -29,7 +29,7 @@
\begin{center}
\caption{Arrange raster and vector layers for QGIS project file \nixcaption}
\label{fig:mapserver_export_qgs}\smallskip
- \includegraphics[clip=true, width=13cm]{mapserver_export_qgs}
+ \includegraphics[clip=true, width=12cm]{mapserver_export_qgs}
\end{center}
\end{figure}
Modified: docs/trunk/english_us/user_guide/plugins_ogr_converter.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_ogr_converter.tex 2008-12-28 15:06:44 UTC (rev 9906)
+++ docs/trunk/english_us/user_guide/plugins_ogr_converter.tex 2008-12-28 21:00:28 UTC (rev 9907)
@@ -4,7 +4,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The OGR layer converter plugin allows to convert vector data from one OGR-supported
vector format to another OGR-supported vector format. It is very simple to handle and
More information about the QGIS-commit
mailing list