X-Git-Url: http://wagner.pp.ru/gitweb/?a=blobdiff_plain;f=geography%2FfGIS%2Fman%2Fplanchet.n.html;fp=geography%2FfGIS%2Fman%2Fplanchet.n.html;h=542b3d5ff5518997bdc0f8a2504b3a09b7aa1d5e;hb=e8890a31f945acef02c617264aa041a6ace03366;hp=0000000000000000000000000000000000000000;hpb=9766a16a9d842ad56bfda8c0444ffa96e14cfe37;p=sites%2Fhome_page.git
diff --git a/geography/fGIS/man/planchet.n.html b/geography/fGIS/man/planchet.n.html
new file mode 100644
index 0000000..542b3d5
--- /dev/null
+++ b/geography/fGIS/man/planchet.n.html
@@ -0,0 +1,617 @@
+
+
+
+
+
+planchet(n) manual page
+
+
+Table of Contents
+
+
+
+
+planchet - Create and manipulate planchet widgets
+
+planchet pathName ?options ?
+
+
+
+ -background -insertwidth -state
+
+ -insertbackground -relief -tile
+ -cursor -insertborderwidth -selectbackground -takefocus
+
+ -highlightbackground -insertofftime -selectborderwidth -xscrollcommand
+ -highlightcolor -insertontime -selectforeground -yscrollcommand
+
+
+See the options manual entry for details on the standard options.
+Note:
+ Standard optiosn -highlightthickness and -bordewidth are ignored by planchet,
+and set to 0. Therefore -relief options have no effect.
+
+
+
+Command-Line Name: -coordformat
+ Database Name: coordFormat
+ Database
+Class: CoordFormat
+
+
+
+- Specifies format string to display current map coordinates,
+if no projection
+- defined. Defaults to "X=%0.8g Y=%0.8g"
+
+
+
+Command-Line Name: -orient
+
+ Database Name: orient
+ Database Class: Orient
+
+
+
+- Specifies printing orientation
+for this planchet. May be either portrait
+- or landscape. Defaults to landscape
+
+
+
+
+Command-Line Name: -lookwidth
+ Database Name: lookWidth
+ Database Class: LookWidth
+
+
+
+
+- Wraplength of text in popup look window. Defaults to 200.
+
+
+
+
+Command-Line
+Name: -shiftfactor
+ Database Name: shiftFactor
+ Database Class: ShiftFactor
+
+
+
+
+- Specifies share of window size to move on shift widget command.
+- Defaults
+to 0.75
+
+
+
+Command-Line Name: -resizable
+ Database Name: resizable
+ Database
+Class: Resizable
+
+
+
+- Specifies a boolean value that indicates whether or
+not should planchet
+- adjust its width/height ratio, when coordinate limits
+are first defined.
+
+
+
+Command-Line Name: -rulerpos
+ Database Name: rulerPos
+
+ Database Class: RulerPos
+
+
+
+- Indicates position of scale ruler in planchet.
+(its left end). Should be
+- list of two coordinates in any form, acceptable
+by Tk. Positive values are measured from top and left and negative from
+lower and right side of planchet
+
+
+
+Command-Line Name: -scalevar
+ Database
+Name: scaleVar
+ Database Class: Variable
+
+
+
+- Specifies the name of variable.
+Current scale of map would be stored in
+- this variable automatically upon
+each change of scale in form 1:denominator. If variable doesn't exist in
+global scope, it would be created.
+
+
+
+Command-Line Name: -statusline
+ Database
+Name: statusLine
+ Database Class: none
+
+
+
+- Specifies name of label widget
+which would be used for displaying status
+- information of planchet (i.e.
+current mouse pointer coordinates). Widget should exist before creating
+planchet or before passing it to planchet configure command.
+
+
+
+Command-Line
+Name: -legbox
+ Database Name: legBox
+ Database Class: none
+
+
+
+- Specifies
+name of canvas widget which would display scrollable legend of
+- base
+layer. Note, that scrollable legend is not printed automatically by print
+command. All contents of this widget would be erased each time base layer
+changed in planchet.
+
+
+
+Command-Line Name: -zoombutton
+ Database Name: zoomButton
+
+ Database Class: none
+
+
+
+- Specifies name of button, which is used to initiate
+zoom operation on
+- canvas. (usially via zoom ) widget command. Planchet
+controls its state, disabling it, if coordinate system is not defined.
+It should exist before it passed to planchet.
+
+
+
+Command-Line Name: -unzoombuttons
+
+ Database Name: unzoomButtons
+ Database Class: none
+
+
+
+- Specifies list
+of buttons, which are used to perform various unzoom operations
+- (like
+unzoom or limits default widget commands). Planchet controls their state,
+disabling them if such operations are impossible.
+
+
+
+Command-Line Name: -shiftbuttons
+
+ Database Name: shiftButtons
+ Database Class: none
+
+
+
+- Specifies list of
+four buttons for perform shift operation on planchet.
+- Buttons are specified
+in following order left(west) down(south) up(north)
+ and right(west),
+the same way as vi cursor movement keys are situated on keyboard.
+
+
+
+Command-Line
+Name: -zoombutton
+ Database Name: zoomButton
+ Database Class: none
+
+
+
+- Specifies
+name of button, which is used to initiate zoom operation on
+- canvas. (usially
+via zoom ) widget command. Planchet controls its state, disabling it, if
+coordinate system is not defined. It should exist before it passed to planchet.
+
+
+
+
+Command-Line Name: -unzoombuttons
+ Database Name: unzoomButtons
+ Database
+Class: none
+
+
+
+- Specifies list of buttons, which are used to perform various
+unzoom operations
+- (like unzoom or limits default widget commands). Planchet
+controls their state, disabling them if such operations are impossible.
+
+
+
+
+Command-Line Name: -shiftbuttons
+ Database Name: shiftButtons
+ Database
+Class: none
+
+
+
+- Specifies list of four buttons for perform shift operation
+on planchet.
+- Buttons are specified in following order left(west) down(south)
+up(north)
+ and right(west), the same way as vi cursor movement keys are
+situated on keyboard. This buttons should be either all be specified or
+all be empty, in which case list of four empty elements should be passed.
+Planchet not only controls state of buttons, but also redefines their
+commands.
+
+
+
+Command-Line Name: -projection
+ Database Name: projection
+ Database
+Class: none
+
+
+
+- Specifies Fgis projection object which is used to convert
+chartographic
+- coordinates of planchet into geographic (latitude and
+longitude) and vice versa.
+
+
+
+In addition to these all options of canvas
+ widget are supported.
+
+
+The planchet command creates a new
+window (given by the pathName argument and makes it into planchet widget.
+
+ Additional options, described above, can be given to control its behavoir.
+Currently they could be specified only in command line, not in option
+database, but it shoudl change in future.
+ planchet command returns its
+pathName argument. At the time this command is invoked, there must not
+exist a window, named pathName , but pathName 's parent must exist. planchet
+ command also creates new Tcl command named pathName which can be used
+to control widget.
+
+ Planchet widget have all behavoir supported by Tk
+canvas widget, but, in addition it could have chartographic coordinate
+system and able to visualize and manipulate maps.
+
+
+
+
+Planchet coordinate system is real-world coordinate system. Its coordinates
+should be in meters of earth surface, not in pixels, millimeters or other
+map sheet or screen-related units. It can be defined either explicitely
+via limits widget command, or implicitely, when first map is shown in
+planchet.
+ There are special commands which allow to recalculate from map
+(realword) coordinates to screen coordinates. Screen coordinate system
+of planchet is same as of canvas.
+
+Planchet can visualize maps,
+which are represented as Fgis layer objects. There are two ways of display
+layer - as base layer or as ovelay.
+Base layers are opaque, they are typically
+raster layers, shown by colors. There can be only one base layer in plachet
+in given time. If legbox helper widget is defined, and legend for base
+layer is drawable, it would be displayed in this widget. Several layer
+types couldn't be displayed as base layers.
+
+Overlay layers are transparent,
+although visible. There can be several overlay layers in planchet at given
+time. Any layer can be displayed as overlay.
+When first layer is displayed
+in planchet, with undefined coordinate system, coordinate system limits
+for planchet are got from limits of layer. If layer cannot provide this
+information, it causes an error.
+
+
+
+ Planchet can be accompanied
+with several other widgets, which are used to interact with user. If this
+widgets are passed to planchet via commandline options (or via widget
+configure ) command, it can control them automatically and disable them,
+if corresponding action is impossible. See OPTIONS ABOVE .
+
+
+
+ There are two traditional ways of scale indication - numerical and graphical.
+As numerical indication, -scalevar option of planchet widget allows to
+specfy Tcl global variable, which would always hold current value of map
+scale.
+As graphical representation of scale, planchet can display scale
+ruler which shows how some realword distance is visible in planchet.
+
+
+
+
+ Planchet allows to collect information from several layers
+in given point. By default it pops up window with this information on right
+button click. Set of layers which included in this information is called
+look list .
+
+
+
+
+ The planchet command creates a new Tcl command
+whose name is pathName . This command can be used to invoke various operaitons
+on the widget. It has following general form:
+ pathName option ?arg arg
+.. ?
+
+ Option and the arg s determine the exact behavior of the command.
+Planchet supports all widget commands, defined for canvas widget and
+following special commands, specific to planchet:
+
+
+- pathName clear
+- Removes
+all layers from planchet, and from look list and unsets coordinate system
+
+
+- pathName cget option
+- Returns value of specified configuration option.
+In addition to standard options and widget specific options, supports
+all options of canvas widget. Several internal variables can also be obtained
+this way, but it is dirty and undocumented hack.
+
+- pathName configure option
+arg ?option arg ...?
+- Allows to change value of one or more options.
+
+- pathName
+fit x y
+- Returns 1 if point, given in real world coordinates is inside
+current planchet limits, and 0 otherwise.
+
+- pathName hide pattern ?pattern...?
+
+- Removes all layers which matches pattern from planchet.
+
+- pathName layers
+ ?pattern ?
+- Return list of all visible layers, either base or overlays,
+which match given pattern. By default - all layers.
+
+- pathName limits
+- Used
+to control limits of realword coordinate system. Can have one of following
+form
+
+- limits
+- Without any arguments return list of four double values,
+representing real world coordinates of window sides. They are given in
+folowing order:
+ XLeft YBottom XRight YTop
+
+
+
+
+
+
+- limits list
+
+
+- limits xleft
+ybottom xright ytop
+- Given list of four double values or four double
+values as separate arguments, sets planchet limits for this value. If -resizable
+ option is true and no coordinate system was defined before, adjusts width/height
+ratio of planchet to reflect this ratio of given limits. Otherwise expands
+given limits to have same width/height ratio as widget.
+
+
+ If directions
+of axes of given limits doesn't match those of currently defined coordinate
+system, silently reverts them. Therefore order of coordinates in insignificant,
+once coordinate system is defined.
+ If coordinate system was defined, assumes
+that zooming operation is performed and stores old limits in zoom stack
+for subsequent unzoom operation. If scale of given limits is smaller, then
+of some limits in zoom stack, discards all elements with scale larger
+than given for unzoom operation shouldn't increase scale. Nevertheless initial
+limits are never discarded this way.
+
+
+- limits default
+- Clears zoom stack
+and restores coordinate limits to their initial values.
+
+
+
+
+
+- pathName look
+
+- Controls LOOK FEATURE of planchet. Can have one of following forms
+
+
+- look add layer
+- adds layer to look list.
+
+- look list ?pattern ?
+- Returns
+list of layers in look list, which match pattern. By default all layers
+
+
+- look remove pattern
+- removes layers which match pattern from look list
+
+
+- look remove all
+- clears look list entirely
+
+- look x y ?-titled|-list|-raw ?
+
+- return list of information for all layers in look list at given point.
+If -titled option is specified, each element in list is formatted string.
+Otherwise it is two element list which first element - layer title, and
+second - layer value. -raw option returns only values, without layer title
+information.
+
+
+ Length of this list not neccesary matches length of look
+list, becouse if some layers are undefined in given point, they do not
+create list element.
+
+
+
+- pathName mapx x
+
+
+- pathName mapy
+- Given screen coordinate
+in any form, acceptable by Tk, returns realword coordinate.
+
+- pathName print
+ ?option arg ...?
+- Wrapper around postscript command. Uses default Fgis font
+mapping and print system, also widget default orientation. By default,
+send output to default Fgis printer using command, defined in fgis configuration
+file.
+
+
+ Following options are supported:
-colormode mode Same as colormode
+ option in canvas postscript command.
+
+
+- -file filename
+- Write postscript
+representation of planchet into given file, instead of piping it to print
+command.
+
+- -fontmap variable
+- array used to map screen fonts to postscript
+fonts. See canvas postscript command for more information.
+
+- -printer printername
+
+- Overrides default printer, specified in fgis.rc file.
+
+
+
+
+
+- pathName ruler
+?on|off?
+- Controls scale ruler.
+
+- pathName scale ?denominator ?
+- With no
+arguments returns current scale denominator. If denominator is given,
+adjust coordinate limits so that scale would be as specified and center
+point of widget would have same realworld coordinates as before.
+
+
+ If any
+other arguments are specified, behaves as canvas widget scale command.
+
+
+
+
+- pathName scrx x
+
+
+- pathName scry y
+- Given realworld coordinate, returns
+screen coordinate in pixels.
+
+- pathName setstatus
+- Displays message if -statusline
+ helper widget, if defined, otherwise does nothing. Can have one of two
+form:
+
+- setstatus message
+- displays message as specified
+
+- setstatus x y
+
+- Displays given coordinates. If no projection defined, they would be displayed
+using Tcl format command with value of -coordformat option as first argument.
+Otherwise they would be displayed using format object command of current
+projection.
+
+
+
+
+
+- pathName shift direction
+- Changes current coordinate limits
+so that current view shifts in specified direction by share of corresponding
+widget size, specified by -shiftfactor option.
+
+- pathName show layer ?-base
+|-overlay ?
+- Displays specified layer. If neither -base nor -overlay is specifed,
+shows layer as base if no base layer currently present and layer can be
+displayed as base. Otherwise displays it as overlay.
+
+- pathName unzoom
+- Pops
+last coordinate limits from zoom stack
+
+- pathName zoom ? x y ? x y ??
+
+- Initiates interactive zoom operation. If no coordinates are specified,
+prompts user to pick both corners of rectangle to display. If one pair
+is specified, prompts only for second pair. With two pairs just converts
+values from canvas to realworld coordinates and performs limits command
+on them.
+ pathName zoom cancel
+
+
+
+ can be used to abort interactive zoom
+operation currently in progress.
+ pathName zoom cancel
+
+ can be used
+to abort interactive zoom operation currently in progress.
+
+layer(n)
+
+
+
+No care taken to do something useful if interactive zoom operation
+is performed on two planchets simulateously.
+
+
+
+
+
+
+Table of Contents
+
+