diff options
Diffstat (limited to 'macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex')
| -rw-r--r-- | macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex b/macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex index dd86fcedbd..0b484da09b 100644 --- a/macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex +++ b/macros/latex/contrib/mercatormap/mercatormap.doc.drawing.tex @@ -11,7 +11,7 @@ \begin{docCommand}{mrcdrawmap}{\oarg{options}} Inside a |tikzpicture| environment, \refCom{mrcdrawmap} draws a map prepared by \refCom{mrcdefinemap}, \refCom{mrcapplymap}, or \refCom{mrcmap}. - All \meta{options} share the common prefix |/mermap/|. + All \meta{options} share the common prefix |mermap/|. This is the principal macro to draw a prepared map respectively the background of the map. The background consists of downloaded map tiles or just a color rectangle. @@ -19,10 +19,10 @@ \begin{docMrcKey}{draw}{=\meta{tile draw}}{no default, initially |auto|} \begin{itemize} - \item\docValue{auto}: Draws the map according to \refKey{/mermap/mapdef/resource}, + \item\docValue{auto}: Draws the map according to \refKey{mermap/mapdef/resource}, i.e. downloaded maps or tiles are used, if available. \item\docValue{path}: Draws the map according to the style given by - \refKey{/mermap/map path}. Existing map tiles or merged maps are ignored + \refKey{mermap/map path}. Existing map tiles or merged maps are ignored \item\docValue{tiles}: Draws the map with downloaded map tiles, if available. \item\docValue{mergedmap}: Draws the map with a merged picture, if @@ -75,24 +75,24 @@ Typically, the pixel size of a map tile is fixed and a map tile is a pixel graphics file. The actual size of such an included picture inside the document is freely selectable. Note that a very small -\refKey{/mermap/tile size} results in very small map lettering, -while a very large \refKey{/mermap/tile size} results results in +\refKey{mermap/tile size} results in very small map lettering, +while a very large \refKey{mermap/tile size} results results in very blurred images. The general idea of a \emph{flexible} tile size is to specify an aspired -tile size called \refKey{/mermap/flex tile size} and to give \LaTeX\ -the freedom to select \refKey{/mermap/tile size} in \emph{about the same size} -as \refKey{/mermap/flex tile size}. +tile size called \refKey{mermap/flex tile size} and to give \LaTeX\ +the freedom to select \refKey{mermap/tile size} in \emph{about the same size} +as \refKey{mermap/flex tile size}. This freedom is used to achieve a \emph{pseudo zoom} called -\refKey{/mermap/flex zoom} which is a nearly arbitrary rational number instead -of \refKey{/mermap/supply/zoom} which is a natural number. +\refKey{mermap/flex zoom} which is a nearly arbitrary rational number instead +of \refKey{mermap/supply/zoom} which is a natural number. This \emph{pseudo zoom} is applied by several options which share \emph{flex} in their names, e.g. -\refKey{/mermap/flex scale}, \refKey{/mermap/named flex scale}, -\refKey{/mermap/supply/flex reference scale}, -\refKey{/mermap/supply/flex area scale}, -\refKey{/mermap/supply/flex area fit}. +\refKey{mermap/flex scale}, \refKey{mermap/named flex scale}, +\refKey{mermap/supply/flex reference scale}, +\refKey{mermap/supply/flex area scale}, +\refKey{mermap/supply/flex area fit}. @@ -101,30 +101,30 @@ in their names, e.g. For standard tiles with 256 times 256 pixels a tile size of \SI{32.512}{mm} = \SI{1.28}{in} results in an approximate \SI{200}{dpi} output for the document. - For a |beamer| document, consider to use a \refKey{/mermap/tile size} of + For a |beamer| document, consider to use a \refKey{mermap/tile size} of \SI{21.333333}{mm} to get approximate 1:1 pixel input and output (depending on |beamer| settings - and used hardware). Also see \refKey{/mermap/mapdef/tile size}. + and used hardware). Also see \refKey{mermap/mapdef/tile size}. \end{docMrcKey} \begin{docMrcKey}{flex tile size}{=\meta{length}}{no default, initially |32.512mm|} Aspired width and height of a tile picture are set to \meta{length}. - This value is used while applying \refKey{/mermap/flex zoom}. + This value is used while applying \refKey{mermap/flex zoom}. \end{docMrcKey} \begin{docMrcKey}{flex zoom}{=\meta{pseudo zoom}}{style, no default} - This style sets \refKey{/mermap/supply/zoom} and \refKey{/mermap/tile size} in combination. + This style sets \refKey{mermap/supply/zoom} and \refKey{mermap/tile size} in combination. \begin{itemize} \item If \meta{pseudo zoom} is a natural number, - \refKey{/mermap/supply/zoom} is set to \meta{pseudo zoom} and - \refKey{/mermap/tile size} is set to \refKey{/mermap/flex tile size}. - \item Otherwise, \refKey{/mermap/supply/zoom} is set to the natural number - closest to \meta{pseudo zoom} and \refKey{/mermap/tile size} is such + \refKey{mermap/supply/zoom} is set to \meta{pseudo zoom} and + \refKey{mermap/tile size} is set to \refKey{mermap/flex tile size}. + \item Otherwise, \refKey{mermap/supply/zoom} is set to the natural number + closest to \meta{pseudo zoom} and \refKey{mermap/tile size} is such enlarged or reduced that the \meta{pseudo zoom} value is simulated, i.e. the \emph{impression} of a rational zoom factor is given. \end{itemize} - Note that \refKey{/mermap/flex zoom} has to be used \emph{before} + Note that \refKey{mermap/flex zoom} has to be used \emph{before} \refCom{mrcsupplymap} or \refCom{mrcmap}, because the zoom setup is adapted. \end{docMrcKey} @@ -133,12 +133,12 @@ in their names, e.g. \clearpage \begin{docMrcKey}{flex scale}{=\meta{scale denominator}:\meta{latitude}}{style, no default} For different latitude scopes, an identical zoom factor produces maps of - different scale. With \refKey{/mermap/flex scale}, a \refKey{/mermap/flex zoom} + different scale. With \refKey{mermap/flex scale}, a \refKey{mermap/flex zoom} is computed to achieve the given \meta{scale denominator} at a given \meta{latitude}. Note that this only applies to the center of a map. If the produced map is not centered at \meta{latitude}, the produced scale may differ from the intended one. - Also see \refKey{/mermap/supply/flex reference scale}. + Also see \refKey{mermap/supply/flex reference scale}. \tikzsetnextfilename{drawing_flex_scale}% \begin{dispExample} @@ -162,7 +162,7 @@ in their names, e.g. \begin{docMrcKey}{named flex scale}{=\meta{scale denominator}:\meta{name}}{style, no default} - Identical to \refKey{/mermap/flex scale}, but used the \emph{named position} + Identical to \refKey{mermap/flex scale}, but used the \emph{named position} \meta{name} to provide a \emph{latitude}, see \Fullref{sec:names_positions}. \begin{dispListing} \mrcNPdef{munich}{48.137222}{11.575556} @@ -179,12 +179,12 @@ in their names, e.g. \begin{docCommand}{mrcdrawnetwork}{\oarg{options}} Draws a geodetic network with meridians and parallels. - All \meta{options} share the common prefix |/mermap/|. + All \meta{options} share the common prefix |mermap/|. The displayed lines are selected automatically according to some tuning parameters. - The map is sliced in \emph{about} maximal \refKey{/mermap/network pieces} in each + The map is sliced in \emph{about} maximal \refKey{mermap/network pieces} in each direction. Meridians and parallels share a minimal distance of - \emph{about} \refKey{/mermap/network distance}. The algorithm is + \emph{about} \refKey{mermap/network distance}. The algorithm is allowed to violate these conditions \emph{somewhat}. Note that oversized maps are not supported, i.e. maps which are wider @@ -213,7 +213,7 @@ in their names, e.g. \begin{docMrcKey}{network pieces}{=\meta{number}}{no default, initially |8|} The map is sliced in \emph{about} maximal \meta{number} pieces in each direction. \meta{number} may be exceeded \emph{somewhat}. - It is underrun to comply with \refKey{/mermap/network distance}. + It is underrun to comply with \refKey{mermap/network distance}. \end{docMrcKey} @@ -221,7 +221,7 @@ in their names, e.g. Meridians and parallels share a minimal distance of \emph{about} \meta{mesh width}. \meta{mesh width} may be underrun \emph{somewhat}. - It is exceeded to comply with \refKey{/mermap/network pieces}. + It is exceeded to comply with \refKey{mermap/network pieces}. For parallels on small scale maps, it refers to an averaged mesh width. \end{docMrcKey} |