SAOTk Reference Manual
Table of Contents

SAOTk Frame Pan Zoom Rotate Orient Commands

commands

  • center
  • get pan
  • get orient
  • get rotate
  • get wcs align
  • get wcs zoom
  • get zoom
  • orient
  • pan
  • pan bbox
  • pan motion begin
  • pan motion
  • pan motion end
  • pan to
  • rotate
  • rotate to
  • rotate motion begin
  • rotate motion
  • rotate motion end
  • wcs align
  • wcs zoom
  • zoom
  • zoom about
  • zoom to
  • zoom to about
  • zoom to fit

    • center

    Center the current image in the frame. The center is determined by FITS keywords, or data type if the keywords are not available.
    Syntax:  center
    Example: center

    get pan

    Return the current pan position in the specified coordinate system and precision
    Syntax:  get pan coordinate system precision
    Example: get pan fk5 default

    get orient

    Returns the current orientation.
    Syntax:  get orient
    Example: get orient

    get rotate

    Returns the current image rotation
    Syntax:  get rotate precision
    Example: get rotate fixed

    get wcs align

    Returns 1 or 0 if the current image is aligned based on wcs
    Syntax:  get wcs align
    Example: get wcs align

    get wcs zoom

    Returns the cdelt scale factor of the wcs if available
    Syntax:  get wcs zoom precision
    Example: get wcs zoom default

    get zoom

    Returns the current zoom factor
    Syntax:  get zoom precision
    Example: get wcs zoom fixed

    orient

    Orient the current image
    Syntax:  orient orientation
    Example: orient xy

    pan

    Pan by the specified value or coordinate
    Syntax:
    pan coordinate    # move current postion by values in reference coordinates
    pan coordinate coordinate # start and stop canvas coordinates. Bind this command to a button up event
    pan  coordinate coordinate system # move current postion by specified values in specified coordinate system
    Example: pan 10 20
             pan 10 10 20 20
             pan 1.5 2.5 fk5

    pan bbox

    Pan the current image to the specified bounding box. Use this command in conjuction with the Panner widget. The bound box is in panner coordinates. Set the precision parameter to INTEGER to force alignment on pixel boundaries.
    Syntax:  pan bbox coordinate coordinate precision
    Example: pan bbox 10 10 20 20 integer

    pan motion begin

    Start an interactive pan operation. Values are in canvas coordinates. Bind this command to a Button Down event.
    Syntax:  pan motion begin coordinate
    Example: pan motion begin 10 10

    pan motion

    Continue an interactive pan operation. Values are in canvas coordinates. Bind this command to a Button Motion event.
    Syntax:  pan motion coordinate
    Example: pan motion 10 10

    pan motion end

    Endan interactive pan operation. Values are in canvas coordinates. Bind this command to a Button Release event.
    Syntax:  pan motion end coordinate
    Example: pan motion end 10 10

    pan to

    Pan to specified position or coordinate.
    Syntax:
    pan to coordinate # pan to position in canvas coordinates
    pan to coordinate coordinate system # pan to coordinates in coordinate system
    Example: pan to 10 10
             pan to 20 58 fk5

    rotate

    Add to the current rotation value. The value is in degrees.
    Syntax:  rotate numeric
    Example: rotate 10.5

    rotate to

    Rotate to the specified value. The value is in degrees.
    Syntax:  rotate to numeric
    Example: rotate to 45

    rotate motion begin

    Start interactive rotation. Bind this command to a Mouse Button Down Event.
    Syntax:  rotate motion begin
    Example: rotate motion begin

    rotate motion

    Continue interactive rotation. The value in the angle in degrees to be added to the current value. Bind this command to a Mouse Motion Event.
    Syntax:  rotate motion numeric
    Example: rotate motion 3.5

    rotate motion end

    End interactive rotation. Bind this command to a Mouse Button Release Event.
    Syntax:  rotate motion end
    Example: rotate motion end

    wcs align

    Activate or deactivate the wcs alignment function.
    Syntax:  wcs align yes no
    Example: wcs align on

    wcs zoom

    Set the wcs zoom factor. 1 is the default value. Use this command to scale the current image to match the wcs of another image.
    Syntax:  wcs zoom numeric
    Example: wcs zoom .5

    zoom

    Increase (or decrease) the current zoom factor.
    Syntax:  zoom numeric
    Example: zoom .5 # zoom in by factor of 2

    zoom about

    Increase (or decrease) the current zoom factor about the specified position in canvas coordinates.
    Syntax:  zoom about numeric coordinate
    Example: zoom about .5 25 25

    zoom to

    Zoom to specified value.
    Syntax:  zoom to numeric
    Example: zoom .5 # set zoom factor to .5

    zoom to about

    Set the current zoom factor about the specified position in the specified coordinate system.
    Syntax:  zoom to numeric about coordinate
    Example: zoom to .5 about 40 58 fk5

    zoom to fit

    Set the current zoom factor that fills the current frame size.
    Syntax:  zoom to fit
    Example: zoom to fit