[QGIS Commit] r10003 - in docs: branches/1.0.0/german/user_guide tags/1.0.0_user_guide trunk/english_us/user_guide

svn_qgis at osgeo.org svn_qgis at osgeo.org
Thu Jan 22 02:06:00 EST 2009


Author: dassau
Date: 2009-01-22 02:06:00 -0500 (Thu, 22 Jan 2009)
New Revision: 10003

Modified:
   docs/branches/1.0.0/german/user_guide/working_with_vector.tex
   docs/tags/1.0.0_user_guide/working_with_vector.tex
   docs/trunk/english_us/user_guide/working_with_vector.tex
Log:
improved snapping and search radius description from Carlos


Modified: docs/branches/1.0.0/german/user_guide/working_with_vector.tex
===================================================================
--- docs/branches/1.0.0/german/user_guide/working_with_vector.tex	2009-01-21 15:25:38 UTC (rev 10002)
+++ docs/branches/1.0.0/german/user_guide/working_with_vector.tex	2009-01-22 07:06:00 UTC (rev 10003)
@@ -817,30 +817,34 @@
 \textbf{Note} - the procedure for editing GRASS layers is different - see
 Section \ref{grass_digitising} for details.
 
-\subsubsection{Setting the Snapping Tolerance}
+\subsubsection{Setting the Snapping Tolerance and Search Radius}
 
-Before we can edit vertices, we need to set the snapping tolerance. This is the 
-distance QGIS uses to \usertext{search} for the closest vertex and/or segment you 
-are trying to connect when you click on the map. If you aren't within the snap tolerance,
-QGIS won't find and select the vertex or/and segment for editing. Tolerance is set in map
-units so you may find you need to experiment to get it set right. If you
-specify too big of a tolerance, QGIS may snap to the wrong vertex, especially if you are 
-dealing with a large number of vertices in close proximity. Set it too small and it won't 
-find anything and it will pop up an annoying warning to that effect. 
+Before we can edit vertices, it is very important to set the snapping
+tolerance and search radius to a value that allows us an optimal editing of
+the vector layer geometries. 
 
-There are two possibilities to define the snapping tolerance. 
+\minisec{Snapping tolerance}
 
+Snapping tolerance is the distance QGIS uses to \usertext{search} for the
+closest vertex and/or segment you are trying to
+connect when you set a new vertex or move an existing vertex. If you aren't
+within the snap tolerance, QGIS will leave the vertex where you release the
+mouse button, instead of snapping it to an existing vertex and/or segment. 
+
 \begin{enumerate}
-\item A general, project wide snapping tolerance can be defined choosing \mainmenuopt{Settings} -> \dropmenuopttwo{mActionOptions}{Options} 
-In the \tab{Digitizing} tab you can select between to vertex, to segment or to vertex and segment 
-as default snap mode. You can also define a default snapping tolerance and a search radius for 
-vertex edits. Remember the tolerance is in layer units. In our digitizing project 
-(working with the Alaska dataset), the units are in feet. Your results may vary, 
-but something on the order of 300ft should be fine at a scale of 1:10 000 
-should be a reasonable setting.
-\item A layer based snapping tolerance can be defined by choosing \mainmenuopt{Settings} -> 
-\dropmenuopttwo{mActionOptions}{Project Properties\dots}. In the \tab{General} tab, section 
-\classname{Digitize} you can click on \button{Snapping options\dots} to enable and adjust snapping 
+\item A general, project wide snapping tolerance can be defined choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Options}
+In the \tab{Digitizing} tab you can select between to vertex, to segment or
+to vertex and segment as default snap mode. You can also define a default
+snapping tolerance and a search radius for vertex edits. Remember the
+tolerance is in layer units. In our digitizing project (working with the
+Alaska dataset), the units are in feet. Your results may vary, but something
+on the order of 300ft should be fine at a scale of 1:10 000 should be a
+reasonable setting.
+\item A layer based snapping tolerance can be defined by choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Project
+Properties\dots}. In the \tab{General} tab, section \classname{Digitize} you
+can click on \button{Snapping options\dots} to enable and adjust snapping
 mode and tolerance on a layer basis (see Figure~\ref{fig:snappingoptions}).
 \end{enumerate}
 
@@ -851,6 +855,23 @@
 \end{center}  
 \end{figure}
 
+\minisec{Search radius}
+
+Search radius is the distance QGIS uses to \usertext{search} for the closest
+vertex you are trying to move when you click on the
+map. If you aren't within the search radius, QGIS won't find and select
+any vertex for editing and it will pop up an annoying warning to that effect.
+Snap tolerance and search radius are set in map units so you may find you
+need to experiment to get them set right. If you specify too big of a
+tolerance, QGIS may snap to the wrong vertex, especially if you are dealing
+with a large number of vertices in close proximity. Set search radius too
+small and it won't find anything to move.
+
+The search radius for vertex edits in layer units can be defined in the
+\tab{Digitizing} tab under \mainmenuopt{Settings} >
+\dropmenuopttwo{mActionOptions}{Options}. The same place where you define the
+general, project wide snapping tolerance.
+
 \subsubsection{Topological editing}
 
 Besides layer based snapping options the \tab{General} tab in menu 
@@ -1271,7 +1292,7 @@
 \begin{figure}[ht]
   \begin{center}
     \caption{Query Builder \nixcaption}\label{fig:query_builder}\smallskip
-    \includegraphics[clip=true, width=14cm]{queryBuilder}
+    \includegraphics[clip=true, width=11.5cm]{queryBuilder}
   \end{center}  
 \end{figure}
 

Modified: docs/tags/1.0.0_user_guide/working_with_vector.tex
===================================================================
--- docs/tags/1.0.0_user_guide/working_with_vector.tex	2009-01-21 15:25:38 UTC (rev 10002)
+++ docs/tags/1.0.0_user_guide/working_with_vector.tex	2009-01-22 07:06:00 UTC (rev 10003)
@@ -817,30 +817,34 @@
 \textbf{Note} - the procedure for editing GRASS layers is different - see
 Section \ref{grass_digitising} for details.
 
-\subsubsection{Setting the Snapping Tolerance}
+\subsubsection{Setting the Snapping Tolerance and Search Radius}
 
-Before we can edit vertices, we need to set the snapping tolerance. This is the 
-distance QGIS uses to \usertext{search} for the closest vertex and/or segment you 
-are trying to connect when you click on the map. If you aren't within the snap tolerance,
-QGIS won't find and select the vertex or/and segment for editing. Tolerance is set in map
-units so you may find you need to experiment to get it set right. If you
-specify too big of a tolerance, QGIS may snap to the wrong vertex, especially if you are 
-dealing with a large number of vertices in close proximity. Set it too small and it won't 
-find anything and it will pop up an annoying warning to that effect. 
+Before we can edit vertices, it is very important to set the snapping
+tolerance and search radius to a value that allows us an optimal editing of
+the vector layer geometries. 
 
-There are two possibilities to define the snapping tolerance. 
+\minisec{Snapping tolerance}
 
+Snapping tolerance is the distance QGIS uses to \usertext{search} for the
+closest vertex and/or segment you are trying to
+connect when you set a new vertex or move an existing vertex. If you aren't
+within the snap tolerance, QGIS will leave the vertex where you release the
+mouse button, instead of snapping it to an existing vertex and/or segment. 
+
 \begin{enumerate}
-\item A general, project wide snapping tolerance can be defined choosing \mainmenuopt{Settings} -> \dropmenuopttwo{mActionOptions}{Options} 
-In the \tab{Digitizing} tab you can select between to vertex, to segment or to vertex and segment 
-as default snap mode. You can also define a default snapping tolerance and a search radius for 
-vertex edits. Remember the tolerance is in layer units. In our digitizing project 
-(working with the Alaska dataset), the units are in feet. Your results may vary, 
-but something on the order of 300ft should be fine at a scale of 1:10 000 
-should be a reasonable setting.
-\item A layer based snapping tolerance can be defined by choosing \mainmenuopt{Settings} -> 
-\dropmenuopttwo{mActionOptions}{Project Properties\dots}. In the \tab{General} tab, section 
-\classname{Digitize} you can click on \button{Snapping options\dots} to enable and adjust snapping 
+\item A general, project wide snapping tolerance can be defined choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Options}
+In the \tab{Digitizing} tab you can select between to vertex, to segment or
+to vertex and segment as default snap mode. You can also define a default
+snapping tolerance and a search radius for vertex edits. Remember the
+tolerance is in layer units. In our digitizing project (working with the
+Alaska dataset), the units are in feet. Your results may vary, but something
+on the order of 300ft should be fine at a scale of 1:10 000 should be a
+reasonable setting.
+\item A layer based snapping tolerance can be defined by choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Project
+Properties\dots}. In the \tab{General} tab, section \classname{Digitize} you
+can click on \button{Snapping options\dots} to enable and adjust snapping
 mode and tolerance on a layer basis (see Figure~\ref{fig:snappingoptions}).
 \end{enumerate}
 
@@ -851,6 +855,23 @@
 \end{center}  
 \end{figure}
 
+\minisec{Search radius}
+
+Search radius is the distance QGIS uses to \usertext{search} for the closest
+vertex you are trying to move when you click on the
+map. If you aren't within the search radius, QGIS won't find and select
+any vertex for editing and it will pop up an annoying warning to that effect.
+Snap tolerance and search radius are set in map units so you may find you
+need to experiment to get them set right. If you specify too big of a
+tolerance, QGIS may snap to the wrong vertex, especially if you are dealing
+with a large number of vertices in close proximity. Set search radius too
+small and it won't find anything to move.
+
+The search radius for vertex edits in layer units can be defined in the
+\tab{Digitizing} tab under \mainmenuopt{Settings} >
+\dropmenuopttwo{mActionOptions}{Options}. The same place where you define the
+general, project wide snapping tolerance.
+
 \subsubsection{Topological editing}
 
 Besides layer based snapping options the \tab{General} tab in menu 
@@ -1271,7 +1292,7 @@
 \begin{figure}[ht]
   \begin{center}
     \caption{Query Builder \nixcaption}\label{fig:query_builder}\smallskip
-    \includegraphics[clip=true, width=14cm]{queryBuilder}
+    \includegraphics[clip=true, width=11.5cm]{queryBuilder}
   \end{center}  
 \end{figure}
 

Modified: docs/trunk/english_us/user_guide/working_with_vector.tex
===================================================================
--- docs/trunk/english_us/user_guide/working_with_vector.tex	2009-01-21 15:25:38 UTC (rev 10002)
+++ docs/trunk/english_us/user_guide/working_with_vector.tex	2009-01-22 07:06:00 UTC (rev 10003)
@@ -817,30 +817,34 @@
 \textbf{Note} - the procedure for editing GRASS layers is different - see
 Section \ref{grass_digitising} for details.
 
-\subsubsection{Setting the Snapping Tolerance}
+\subsubsection{Setting the Snapping Tolerance and Search Radius}
 
-Before we can edit vertices, we need to set the snapping tolerance. This is the 
-distance QGIS uses to \usertext{search} for the closest vertex and/or segment you 
-are trying to connect when you click on the map. If you aren't within the snap tolerance,
-QGIS won't find and select the vertex or/and segment for editing. Tolerance is set in map
-units so you may find you need to experiment to get it set right. If you
-specify too big of a tolerance, QGIS may snap to the wrong vertex, especially if you are 
-dealing with a large number of vertices in close proximity. Set it too small and it won't 
-find anything and it will pop up an annoying warning to that effect. 
+Before we can edit vertices, it is very important to set the snapping
+tolerance and search radius to a value that allows us an optimal editing of
+the vector layer geometries. 
 
-There are two possibilities to define the snapping tolerance. 
+\minisec{Snapping tolerance}
 
+Snapping tolerance is the distance QGIS uses to \usertext{search} for the
+closest vertex and/or segment you are trying to
+connect when you set a new vertex or move an existing vertex. If you aren't
+within the snap tolerance, QGIS will leave the vertex where you release the
+mouse button, instead of snapping it to an existing vertex and/or segment. 
+
 \begin{enumerate}
-\item A general, project wide snapping tolerance can be defined choosing \mainmenuopt{Settings} -> \dropmenuopttwo{mActionOptions}{Options} 
-In the \tab{Digitizing} tab you can select between to vertex, to segment or to vertex and segment 
-as default snap mode. You can also define a default snapping tolerance and a search radius for 
-vertex edits. Remember the tolerance is in layer units. In our digitizing project 
-(working with the Alaska dataset), the units are in feet. Your results may vary, 
-but something on the order of 300ft should be fine at a scale of 1:10 000 
-should be a reasonable setting.
-\item A layer based snapping tolerance can be defined by choosing \mainmenuopt{Settings} -> 
-\dropmenuopttwo{mActionOptions}{Project Properties\dots}. In the \tab{General} tab, section 
-\classname{Digitize} you can click on \button{Snapping options\dots} to enable and adjust snapping 
+\item A general, project wide snapping tolerance can be defined choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Options}
+In the \tab{Digitizing} tab you can select between to vertex, to segment or
+to vertex and segment as default snap mode. You can also define a default
+snapping tolerance and a search radius for vertex edits. Remember the
+tolerance is in layer units. In our digitizing project (working with the
+Alaska dataset), the units are in feet. Your results may vary, but something
+on the order of 300ft should be fine at a scale of 1:10 000 should be a
+reasonable setting.
+\item A layer based snapping tolerance can be defined by choosing
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Project
+Properties\dots}. In the \tab{General} tab, section \classname{Digitize} you
+can click on \button{Snapping options\dots} to enable and adjust snapping
 mode and tolerance on a layer basis (see Figure~\ref{fig:snappingoptions}).
 \end{enumerate}
 
@@ -851,6 +855,23 @@
 \end{center}  
 \end{figure}
 
+\minisec{Search radius}
+
+Search radius is the distance QGIS uses to \usertext{search} for the closest
+vertex you are trying to move when you click on the
+map. If you aren't within the search radius, QGIS won't find and select
+any vertex for editing and it will pop up an annoying warning to that effect.
+Snap tolerance and search radius are set in map units so you may find you
+need to experiment to get them set right. If you specify too big of a
+tolerance, QGIS may snap to the wrong vertex, especially if you are dealing
+with a large number of vertices in close proximity. Set search radius too
+small and it won't find anything to move.
+
+The search radius for vertex edits in layer units can be defined in the
+\tab{Digitizing} tab under \mainmenuopt{Settings} >
+\dropmenuopttwo{mActionOptions}{Options}. The same place where you define the
+general, project wide snapping tolerance.
+
 \subsubsection{Topological editing}
 
 Besides layer based snapping options the \tab{General} tab in menu 
@@ -1271,7 +1292,7 @@
 \begin{figure}[ht]
   \begin{center}
     \caption{Query Builder \nixcaption}\label{fig:query_builder}\smallskip
-    \includegraphics[clip=true, width=14cm]{queryBuilder}
+    \includegraphics[clip=true, width=11.5cm]{queryBuilder}
   \end{center}  
 \end{figure}
 



More information about the QGIS-commit mailing list