SAOTk Reference Manual
Table of Contents

SAOTk Frame Crosshair Commands

commands

  • crosshair
  • crosshair begin motion
  • crosshair motion
  • crosshair warp
  • get crosshair
  • get crosshair status
  • crosshair

    Turn crosshairs on or off or set the current crosshair location
    Syntax:  crosshair yes no # control crosshairs
                   crosshair coordinate canvas coordinate system # set current position
    Example: crosshair on
             crosshair 22 58 fk5

    crosshair begin motion

    Begin interactive crosshair motion. Bind this command to a mouse down event. Crosshairs become active, if currently inactive
    Syntax:  crosshair begin motion numeric numeric canvas coordinate system
    Example: crosshair begin motion 10 20 canvas

    crosshair motion

    Current crosshair motion command. Bind this command to mouse down motion events
    Syntax:  crosshair motion numeric numeric canvas coordinate system
    Example: crosshair motion 20 20 canvas

    crosshair warp

    Moves the crosshairs by specified amount in pixels. Crosshairs become active, if currently inactive
    Syntax:  crosshair warp integer integer
    Example: crosshair warp 1 1

    get crosshair

    Returns the current crosshair coordinates
    Syntax:  get crosshair   # return canvas coords at default precision
                    get crosshair canvas coordinate system precision # return specified coord system
    Example: get crosshair physical default

    get crosshair status

    Returns 1 if crosshairs are active, 0 if inactive
    Syntax:  get crosshair status
    Example: get crosshair status