geography/fGIS/man/fgisRasterColorImage.n.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.4, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>palette(n) manual page</TITLE>
   7 </HEAD>
   8 <BODY>
   9 <A HREF="#toc">Table of Contents</A><P>
  10 <P>
  11
  12 <H2><A NAME="sect0" HREF="#toc0">NAME </A></H2>
  13 fgisRasterColorImage, fgisRasterBWImage - render raster object into
  14 planchet item <P>
  15
  16 <H2><A NAME="sect1" HREF="#toc1">SYNOPSIS </A></H2>
  17 <B>fgisRasterColorImage<I> raster planchet item </I></B> ?<I>option
  18 </I>? <P>
  19  <B>fgisRasterBWImage<I> raster planchet item </I></B> ?<I>option </I>? <P>
  20
  21 <H2><A NAME="sect2" HREF="#toc2">DESCRIPTION </A></H2>
  22 <P>
  23  These
  24 commands perform visualisation of fGIS raster objects in fGIS planchet
  25 (essentially same as Tk canvas). They work on platform independent manner,
  26 creating visible representation of layer in Tk image object, which should
  27 be previously created.  <P>
  28  User (and even application writer) seldom accesses
  29 this commands directly. Raser layer objects and planchet subcommands should
  30 be used to visualize raster layers. <P>
  31  These commands controls all attributes
  32 of layer appearance, which have no semantic meaning. I.e. raster file class
  33 to palette index correspondence is part of raster object, becouse it also
  34 used for access legend and GIS operation, while palette itself appear
  35 only in call to this command, becouse it used only to visualisation. <P>
  36
  37
  38 <H2><A NAME="sect3" HREF="#toc3">ARGUMENTS </A></H2>
  39 <P>
  40
  41 <DL>
  42
  43 <DT><I>raster </I> -  </DT>
  44 <DD>name of fGIS raster object (see <B><A HREF="raster.n.html">raster </B>(n)</A>
  45 ). </DD>
  46 </DL>
  47 <P>
  48
  49 <DL>
  50
  51 <DT><I>planchet
  52 </I> -  </DT>
  53 <DD>name of fGIS planchet widget. Planchet should be mapped and have coordinate
  54 system already defined. </DD>
  55 </DL>
  56 <P>
  57
  58 <DL>
  59
  60 <DT><I>item </I> -  </DT>
  61 <DD>ID of planchet item to render raster in.
  62 It should exist, be of type image and contain valid image (photo for <B>fgisRasterColorImage
  63 </B> and bitmap for <B>fgisRasterBWImage </B>) in its -image atribute. </DD>
  64 </DL>
  65 <P>
  66
  67 <H2><A NAME="sect4" HREF="#toc4">OPTIONS </A></H2>
  68
  69 <DL>
  70
  71 <DT><B>-border<I>
  72 option </I></B> -  </DT>
  73 <DD>specifies whether borders between raster object classes or base
  74 file classes (polygon borders) should be drawn. <I>Option </I> can be one of <B>none
  75 </B>, <B>yes </B>, <B>base </B>. Abbreviations are not allowed (bug?). <B>yes </B> means that borders
  76 are drawn only between distinct classes of current raster object, <B>base
  77 </B> means that borders should be drawn if base file classes are distinct,
  78 even if they are reclassed into same value. Useful for choropleth plots.
  79 </DD>
  80 </DL>
  81 <P>
  82  For symbol plots option is ignored. Defaults to <B>none </B> for color images
  83 and <B>yes </B> for BW images.
  84 <DL>
  85
  86 <DT><B>-color<I> color </I></B>   </DT>
  87 <DD>- specifies color to plot borders
  88 in color mode or for entire image in pattern or symbol mode. <I>color </I> can
  89 be any form of color specification, acceptable by Tk. Defaults to "black".
  90 </DD>
  91
  92 <DT><B>-map<I> option </I></B> -  </DT>
  93 <DD>specifies how to deal with map classes, which exceed palette
  94 or pattern range (0-255). Option is one of <B>wrap </B> - use symbol (color) <I>class%255
  95 </I> for classes which exceeds 255, <B>none </B> - use symbol (color) 255 for all
  96 these clases and <I>number </I> - map range 0-<I>max class </I> to range 0-<I>number </I>. Defaults
  97 to <B>wrap </B>. </DD>
  98
  99 <DT><B>-palette <I>palettename </I></B> (color only) -  </DT>
 100 <DD>specifies fGIS palette object
 101 to use for coloring of map classes. Defaults to <B>defaultpalette </B>. </DD>
 102
 103 <DT><B>-patterns
 104 <I>patternname </I></B> (BW only) -  </DT>
 105 <DD>sets plotting mode to pattern and specifies pattern
 106 set to plot. In pattern mode patterns are clipped by polygon boundaries,
 107 and thus any border modes are allowed. Defaults to {} (empty pattern). This
 108 mode is default for  <B>fgisRasterBWImage </B> </DD>
 109
 110 <DT><B>-symbols <I>patternname </I></B> (BW only)
 111 -  </DT>
 112 <DD>sets plotting mode to symbol and specifies pattern set to plot. In symbol
 113 mode patterns can be drawn only at whole, so if central point of pattern
 114 belongs to certain class, pattern for this class would be drawn on entire
 115 rectangle. Borders are never plotted in this mode No defaults, becouse
 116 this mode must be turned on explicitely. </DD>
 117
 118 <DT><B>-update <I>{x1 y1 x2 y2} </I></B>  </DT>
 119 <DD>- Specifies,
 120 that only part of image should be replotted. Useful for raster editing
 121 application. Rectangle to update is given in map coordinates. It is clipped
 122 by image boundaries. </DD>
 123 </DL>
 124 <P>
 125
 126 <H2><A NAME="sect5" HREF="#toc5">SEE ALSO </A></H2>
 127 <B><A HREF="raster.n.html">raster</B>(n)</A>
 128 ,<B><A HREF="planchet.n.html">planchet</B>(n)</A>
 129 ,<B><A HREF="palette.n.html">palette</B>(n)</A>
 130 ,<B></B> <B><A HREF="patterns.n.html">patterns</B>(n)</A>
 131
 132 <P>
 133
 134 <HR><P>
 135 <A NAME="toc"><B>Table of Contents</B></A><P>
 136 <UL>
 137 <LI><A NAME="toc0" HREF="#sect0">NAME</A></LI>
 138 <LI><A NAME="toc1" HREF="#sect1">SYNOPSIS</A></LI>
 139 <LI><A NAME="toc2" HREF="#sect2">DESCRIPTION</A></LI>
 140 <LI><A NAME="toc3" HREF="#sect3">ARGUMENTS</A></LI>
 141 <LI><A NAME="toc4" HREF="#sect4">OPTIONS</A></LI>
 142 <LI><A NAME="toc5" HREF="#sect5">SEE ALSO</A></LI>
 143 </UL>
 144 </BODY></HTML>