portrait

Поиск



[software] [catdoc] [tcl] [geography] [old things]
Table of Contents

NAME

fgisRasterColorImage, fgisRasterBWImage - render raster object into planchet item

SYNOPSIS

fgisRasterColorImage raster planchet item ?option ?

fgisRasterBWImage raster planchet item ?option ?

DESCRIPTION

These commands perform visualisation of fGIS raster objects in fGIS planchet (essentially same as Tk canvas). They work on platform independent manner, creating visible representation of layer in Tk image object, which should be previously created.

User (and even application writer) seldom accesses this commands directly. Raser layer objects and planchet subcommands should be used to visualize raster layers.

These commands controls all attributes of layer appearance, which have no semantic meaning. I.e. raster file class to palette index correspondence is part of raster object, becouse it also used for access legend and GIS operation, while palette itself appear only in call to this command, becouse it used only to visualisation.

ARGUMENTS

raster -
name of fGIS raster object (see raster (n) ).

planchet -
name of fGIS planchet widget. Planchet should be mapped and have coordinate system already defined.

item -
ID of planchet item to render raster in. It should exist, be of type image and contain valid image (photo for fgisRasterColorImage and bitmap for fgisRasterBWImage ) in its -image atribute.

OPTIONS

-border option -
specifies whether borders between raster object classes or base file classes (polygon borders) should be drawn. Option can be one of none , yes , base . Abbreviations are not allowed (bug?). yes means that borders are drawn only between distinct classes of current raster object, base means that borders should be drawn if base file classes are distinct, even if they are reclassed into same value. Useful for choropleth plots.

For symbol plots option is ignored. Defaults to none for color images and yes for BW images.

-color color
- specifies color to plot borders in color mode or for entire image in pattern or symbol mode. color can be any form of color specification, acceptable by Tk. Defaults to "black".
-map option -
specifies how to deal with map classes, which exceed palette or pattern range (0-255). Option is one of wrap - use symbol (color) class%255 for classes which exceeds 255, none - use symbol (color) 255 for all these clases and number - map range 0-max class to range 0-number . Defaults to wrap .
-palette palettename (color only) -
specifies fGIS palette object to use for coloring of map classes. Defaults to defaultpalette .
-patterns patternname (BW only) -
sets plotting mode to pattern and specifies pattern set to plot. In pattern mode patterns are clipped by polygon boundaries, and thus any border modes are allowed. Defaults to {} (empty pattern). This mode is default for fgisRasterBWImage
-symbols patternname (BW only) -
sets plotting mode to symbol and specifies pattern set to plot. In symbol mode patterns can be drawn only at whole, so if central point of pattern belongs to certain class, pattern for this class would be drawn on entire rectangle. Borders are never plotted in this mode No defaults, becouse this mode must be turned on explicitely.
-update {x1 y1 x2 y2}
- Specifies, that only part of image should be replotted. Useful for raster editing application. Rectangle to update is given in map coordinates. It is clipped by image boundaries.

SEE ALSO

raster(n) ,planchet(n) ,palette(n) , patterns(n)


Table of Contents