NAME
       canvas - Create and manipulate canvas widgets

SYNOPSIS
       canvas pathName ?options?

STANDARD OPTIONS
       -background     -highlightthickness            -insertwidth-takefocus
       -borderwidth    -insertbackground              -relief-xscrollcommand
       -cursor         -insertborderwidth             -selectbackground-yscrollcommand
       -highlightbackground           -insertofftime  -selectborderwidth
       -highlightcolor -insertontime  -selectforeground

       See  the  options manual entry for details on the standard
       options.

WIDGET-SPECIFIC OPTIONS
       Command-Line Name:-closeenough
       Database Name:  closeEnough
       Database Class: CloseEnough

              Specifies a  floating-point  value  indicating  how
              close the mouse cursor must be to an item before it
              is considered to be ``inside'' the item.   Defaults
              to 1.0.

       Command-Line Name:-confine
       Database Name:  confine
       Database Class: Confine

              Specifies a boolean value that indicates whether or
              not it should be allowable to set the canvas's view
              outside  the  region  defined  by  the scrollRegion
              argument.  Defaults to true, which means  that  the
              view  will be constrained within the scroll region.

       Command-Line Name:-height
       Database Name:  height
       Database Class: Height

              Specifies a desired window height that  the  canvas
              widget  should  request  from its geometry manager.
              The value may be specified  in  any  of  the  forms
              described in the COORDINATES section below.

       Command-Line Name:-scrollregion
       Database Name:  scrollRegion
       Database Class: ScrollRegion

              Specifies  a  list with four coordinates describing
              the left, top, right, and bottom coordinates  of  a
              rectangular   region.   This  region  is  used  for
              scrolling purposes and  is  considered  to  be  the
              boundary of the information in the canvas.  Each of
              the coordinates may be  specified  in  any  of  the
              forms given in the COORDINATES section below.

       Command-Line Name:-width
       Database Name:  width
       Database Class: width

              Specifies  a  desired  window width that the canvas
              widget should request from  its  geometry  manager.
              The  value  may  be  specified  in any of the forms
              described in the COORDINATES section below.

       Command-Line Name:-xscrollincrement
       Database Name:  xScrollIncrement
       Database Class: ScrollIncrement

              Specifies an increment for horizontal scrolling, in
              any  of  the  usual forms permitted for screen dis-
              tances.  If the value of  this  option  is  greater
              than  zero,  the horizontal view in the window will
              be constrained so that the canvas x  coordinate  at
              the  left edge of the window is always an even mul-
              tiple of xScrollIncrement;  furthermore, the  units
              for  scrolling  (e.g.,  the change in view when the
              left and right arrows of a scrollbar are  selected)
              will  also  be  xScrollIncrement.   If the value of
              this option is less than or  equal  to  zero,  then
              horizontal scrolling is unconstrained.

       Command-Line Name:-yscrollincrement
       Database Name:  yScrollIncrement
       Database Class: ScrollIncrement

              Specifies  an  increment for vertical scrolling, in
              any of the usual forms permitted  for  screen  dis-
              tances.   If  the  value  of this option is greater
              than zero, the vertical view in the window will  be
              constrained  so that the canvas y coordinate at the
              top edge of the window is always an  even  multiple
              of  yScrollIncrement;   furthermore,  the units for
              scrolling (e.g., the change in view  when  the  top
              and bottom arrows of a scrollbar are selected) will
              also be yScrollIncrement.  If  the  value  of  this
              option is less than or equal to zero, then vertical
              scrolling is unconstrained.


INTRODUCTION
       The canvas command creates a  new  window  (given  by  the
       pathName  argument)  and  makes  it  into a canvas widget.
       Additional options, described above, may be  specified  on
       the  command  line  or in the option database to configure
       aspects of the canvas such as its colors and  3-D  relief.
       The  canvas command returns its pathName argument.  At the
       time this command is invoked, there must not exist a  win-
       dow named pathName, but pathName's parent must exist.

       Canvas  widgets  implement  structured graphics.  A canvas
       displays any number of items, which  may  be  things  like
       rectangles, circles, lines, and text.  Items may be manip-
       ulated (e.g. moved or  re-colored)  and  commands  may  be
       associated  with  items in much the same way that the bind
       command allows commands to be bound to widgets.  For exam-
       ple, a particular command may be associated with the <But-
       ton-1> event so that the command is invoked whenever  but-
       ton 1 is pressed with the mouse cursor over an item.  This
       means that items in a canvas can have behaviors defined by
       the Tcl scripts bound to them.


DISPLAY LIST
       The items in a canvas are ordered for purposes of display,
       with the first item in the display  list  being  displayed
       first,  followed  by the next item in the list, and so on.
       Items later in the display list  obscure  those  that  are
       earlier  in the display list and are sometimes referred to
       as being ``on top'' of earlier items.  When a new item  is
       created  it  is  placed at the end of the display list, on
       top of everything else.  Widget commands may  be  used  to
       re-arrange the order of the display list.

       Window  items  are  an  exception to the above rules.  The
       underlying window systems require them always to be  drawn
       on top of other items.  In addition, the stacking order of
       window items is not affected by any of the  canvas  widget
       commands;  you  must  use  the raise and lower Tk commands
       instead.


ITEM IDS AND TAGS
       Items in a canvas widget may be named  in  either  of  two
       ways: by id or by tag.  Each item has a unique identifying
       number which is assigned to that item when it is  created.
       The  id  of an item never changes and id numbers are never
       re-used within the lifetime of a canvas widget.

       Each item may also have any number of tags associated with
       it.  A tag is just a string of characters, and it may take
       any form except that of an integer.  For example, ``x123''
       is  OK  but ``123'' isn't.  The same tag may be associated
       with many different items.  This is commonly done to group
       items  in  various  interesting  ways;   for  example, all
       selected items might be given the tag ``selected''.

       The tag all is implicitly associated with  every  item  in
       the  canvas;   it  may be used to invoke operations on all
       the items in the canvas.
       The tag current is managed automatically by Tk; it applies
       to the current item, which is the topmost item whose drawn
       area covers the position of  the  mouse  cursor.   If  the
       mouse  is not in the canvas widget or is not over an item,
       then no item has the current tag.

       When specifying items in canvas widget  commands,  if  the
       specifier is an integer then it is assumed to refer to the
       single item with that id.  If  the  specifier  is  not  an
       integer,  then  it is assumed to refer to all of the items
       in the canvas that have a tag matching the specifier.  The
       symbol  tagOrId is used below to indicate that an argument
       specifies either an id that selects a single item or a tag
       that  selects  zero  or  more items.  Some widget commands
       only operate on a single item at a time;   if  tagOrId  is
       specified  in  a  way  that names multiple items, then the
       normal behavior is for the command to use the first  (low-
       est)  of  these items in the display list that is suitable
       for the command.  Exceptions are noted in the widget  com-
       mand descriptions below.


COORDINATES
       All  coordinates  related to canvases are stored as float-
       ing-point numbers.  Coordinates and distances  are  speci-
       fied  in  screen  units,  which are floating-point numbers
       optionally followed by one of several letters.  If no let-
       ter  is  supplied  then the distance is in pixels.  If the
       letter is m then the distance is  in  millimeters  on  the
       screen;  if it is c then the distance is in centimeters; i
       means inches, and p means  printers  points  (1/72  inch).
       Larger  y-coordinates refer to points lower on the screen;
       larger x-coordinates refer to points farther to the right.


TRANSFORMATIONS
       Normally  the origin of the canvas coordinate system is at
       the upper-left corner of the window containing the canvas.
       It  is possible to adjust the origin of the canvas coordi-
       nate system relative to the origin of the window using the
       xview  and  yview widget commands;  this is typically used
       for scrolling.  Canvases do not support scaling  or  rota-
       tion  of the canvas coordinate system relative to the win-
       dow coordinate system.

       Individual items may be moved or scaled using widget  com-
       mands described below, but they may not be rotated.


INDICES
       Text  items support the notion of an index for identifying
       particular positions within the item.   Indices  are  used
       for  commands  such as inserting text, deleting a range of
       characters, and setting the insertion cursor position.  An
       index  may  be  specified  in any of a number of ways, and
       different types of items may support different  forms  for
       specifying  indices.   Text  items  support  the following
       forms for an index;  if you define new types of  text-like
       items,  it  would be advisable to support as many of these
       forms as practical.  Note that it is possible to refer  to
       the  character  just  after the last one in the text item;
       this is necessary for such tasks as inserting new text  at
       the end of the item.

       number    A  decimal  number  giving  the  position of the
                 desired  character  within  the  text  item.   0
                 refers  to  the  first  character, 1 to the next
                 character, and so on.  A number less than  0  is
                 treated as if it were zero, and a number greater
                 than the length of the text item is  treated  as
                 if it were equal to the length of the text item.

       end       Refers to the character just after the last  one
                 in the item (same as the number of characters in
                 the item).

       insert    Refers to the character just  before  which  the
                 insertion cursor is drawn in this item.

       sel.first Refers  to  the  first selected character in the
                 item.  If the selection isn't in this item  then
                 this form is illegal.

       sel.last  Refers  to  the  last  selected character in the
                 item.  If the selection isn't in this item  then
                 this form is illegal.

       @x,y      Refers  to the character at the point given by x
                 and y, where x and y are specified in the  coor-
                 dinate  system  of  the  canvas.  If x and y lie
                 outside the  coordinates  covered  by  the  text
                 item, then they refer to the first or last char-
                 acter in the line that is closest to  the  given
                 point.


WIDGET COMMAND
       The canvas command creates a new Tcl command whose name is
       pathName.  This command may  be  used  to  invoke  various
       operations  on  the  widget.  It has the following general
       form:
              pathName option ?arg arg ...?
       Option and the args determine the exact  behavior  of  the
       command.   The  following widget commands are possible for
       canvas widgets:

       pathName addtag tag searchSpec ?arg arg ...?
              For each item that meets the constraints  specified
              by  searchSpec and the args, add tag to the list of
              tags associated with the item if it  isn't  already
              present on that list.  It is possible that no items
              will satisfy the constraints  given  by  searchSpec
              and  args, in which case the command has no effect.
              This command returns an  empty  string  as  result.
              SearchSpec  and arg's may take any of the following
              forms:

              above tagOrId
                     Selects the item just after (above) the  one
                     given  by  tagOrId  in the display list.  If
                     tagOrId denotes more than one item, then the
                     last (topmost) of these items in the display
                     list is used.

              all    Selects all the items in the canvas.

              below tagOrId
                     Selects the item just before (below) the one
                     given  by  tagOrId  in the display list.  If
                     tagOrId denotes more than one item, then the
                     first (lowest) of these items in the display
                     list is used.

              closest x y ?halo? ?start?
                     Selects the item closest to the point  given
                     by x and y.  If more than one item is at the
                     same closest distance (e.g. two items  over-
                     lap  the  point), then the top-most of these
                     items (the last one in the display list)  is
                     used.  If halo is specified, then it must be
                     a non-negative value.  Any item closer  than
                     halo  to  the point is considered to overlap
                     it.  The start argument may be used to  step
                     circularly  through  all  the closest items.
                     If start is  specified,  it  names  an  item
                     using a tag or id (if by tag, it selects the
                     first item in  the  display  list  with  the
                     given  tag).   Instead of selecting the top-
                     most closest item, this form will select the
                     topmost  closest item that is below start in
                     the display list;  if no such  item  exists,
                     then  the  selection behaves as if the start
                     argument had not been specified.

              enclosed x1 y1 x2 y2
                     Selects all the  items  completely  enclosed
                     within  the  rectangular region given by x1,
                     y1, x2, and y2.  X1 must be no greater  then
                     x2 and y1 must be no greater than y2.

              overlapping x1 y1 x2 y2
                     Selects  all  the  items that overlap or are
                     enclosed within the rectangular region given
                     by  x1,  y1,  x2,  and  y2.   X1  must be no
                     greater then x2 and y1 must  be  no  greater
                     than y2.

              withtag tagOrId
                     Selects all the items given by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
              invoked first, followed by one binding for each  of
              the  item's  tags (in order), followed by a binding
              associated with the item's id.  If there are multi-
              ple  matching  bindings for a single tag, then only
              the most specific binding is invoked.   A  continue
              command in a binding script terminates that script,
              and a break  command  terminates  that  script  and
              skips  any remaining scripts for the event, just as
              for the bind command.

              If bindings have been created for a  canvas  window
              using  the  bind  command, then they are invoked in
              addition to bindings created for the canvas's items
              using  the  bind  widget command.  The bindings for
              items will be invoked before any  of  the  bindings
              for the window as a whole.

       pathName canvasx screenx ?gridspacing?
              Given  a window x-coordinate in the canvas screenx,
              this command returns the canvas  x-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName canvasy screeny ?gridspacing?
              Given  a  window y-coordinate in the canvas screeny
              this command returns the canvas  y-coordinate  that
              is  displayed  at that location.  If gridspacing is
              specified, then the canvas coordinate is rounded to
              the nearest multiple of gridspacing units.

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the canvas command.

       pathName configure ?option? ?value? ?option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing   all   of  the  available  options  for
              pathName (see Tk_ConfigureInfo for  information  on
              the  format  of this list).  If option is specified
              with no value, then  the  command  returns  a  list
              describing  the one named option (this list will be
              identical to the corresponding sublist of the value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the canvas command.

       pathName coords tagOrId ?x0 y0 ...?
              Query or modify  the  coordinates  that  define  an
              item.   If  no coordinates are specified, this com-
              mand returns a list whose elements are the  coordi-
              nates of the item named by tagOrId.  If coordinates
              are specified, then they replace the current  coor-
              dinates  for  the named item.  If tagOrId refers to
              multiple items, then the first one in  the  display
              list is used.

       pathName create type x y ?x y ...? ?option value ...?
              Create  a  new  item in pathName of type type.  The
              exact format of the arguments after type depends on
              type,  but  usually they consist of the coordinates
              for one or more points, followed by  specifications
              for zero or more item options.  See the subsections
              on individual item types below for more on the syn-
              tax  of  this command.  This command returns the id
              for the new item.

       pathName dchars tagOrId first ?last?
              For each item given by tagOrId, delete the  charac-
              ters  in  the range given by first and last, inclu-
              sive.  If some of the items given by tagOrId  don't
              support  text  operations,  then  they are ignored.
              First and last are indices of characters within the
              item(s)  as described in INDICES above.  If last is
              omitted,  it  defaults  to  first.   This   command
              returns an empty string.iven by tagOrId.

       pathName bbox tagOrId ?tagOrId tagOrId ...?
              Returns a list with four elements giving an approx-
              imate bounding box for all the items named  by  the
              tagOrId  arguments.   The list has the form ``x1 y1
              x2 y2'' such that the drawn areas of all the  named
              elements are within the region bounded by x1 on the
              left, x2 on the right, y1 on the top, and y2 on the
              bottom.   The  return  value  may  overestimate the
              actual bounding box by a few pixels.  If  no  items
              match any of the tagOrId arguments or if the match-
              ing items have empty bounding boxes (i.e. they have
              nothing   to  display)  then  an  empty  string  is
              returned.

       pathName bind tagOrId ?sequence? ?command?
              This command associates command with all the  items
              given  by  tagOrId  such  that  whenever  the event
              sequence given by sequence occurs for  one  of  the
              items  the  command  will  be invoked.  This widget
              command is similar to the bind command except  that
              it operates on items in a canvas rather than entire
              widgets.  See the bind manual  entry  for  complete
              details on the syntax of sequence and the substitu-
              tions performed on command before invoking it.   If
              all  arguments  are specified then a new binding is
              created, replacing any  existing  binding  for  the
              same  sequence  and tagOrId (if the first character
              of command is ``+'' then command augments an exist-
              ing  binding  rather  than  replacing it).  In this
              case the return value is an empty string.  If  com-
              mand  is  omitted then the command returns the com-
              mand associated with tagOrId and sequence (an error
              occurs  if there is no such binding).  If both com-
              mand and sequence  are  omitted  then  the  command
              returns a list of all the sequences for which bind-
              ings have been defined for tagOrId.

              The only events for which bindings may be specified
              are  those  related to the mouse and keyboard (such
              as Enter, Leave, ButtonPress, Motion, and KeyPress)
              or  virtual events.  The handling of events in can-
              vases uses the current item defined in ITEM IDS AND
              TAGS  above.  Enter and Leave events trigger for an
              item when it becomes the current item or ceases  to
              be  the  current  item;  note that these events are
              different than Enter and Leave events for  windows.
              Mouse-related  events  are  directed to the current
              item, if any.  Keyboard-related events are directed
              to  the  focus  item,  if any (see the focus widget
              command below for more  on  this).   If  a  virtual
              event  is used in a binding, that binding can trig-
              ger only if the virtual  event  is  defined  by  an
              underlying mouse-related or keyboard-related event.

              It is possible for multiple  bindings  to  match  a
              particular  event.   This could occur, for example,
              if one binding is associated with the item's id and
              another  is associated with one of the item's tags.
              When this occurs, all of the matching bindings  are
              invoked.   A binding associated with the all tag is
        