Class CvsViewer

This control is used to scroll and zoom on an image.

When the mouse moves over the control scrollbars will appear (if needed) inside the bottom and right-hand-side edges of the view. When the mouse is near the centre a slider will appear which can be used to change the scale.

This control also supports layers where multiple images can be layered to make the final visual.

Hierarchy

  • CvsBufferedControl
    • CvsViewer

Accessors

  • get id(): string
  • The unique identifier for this control.

    Returns string

  • get isEnabled(): boolean
  • This is true if the control can respond to UI events else false.

    Use enable() and disable() to enable and disable it.

    Returns boolean

  • get isOpaque(): boolean
  • This is true if the control background is opaque else false.

    Use opaque() and transparent() display / hide the background.

    Returns boolean

  • get isVisible(): boolean
  • This is true if the control is visible else false.

    Use hide() and show() to set visibility.

    Returns boolean

  • get type(): string
  • The type name for this control.
    (type name = class name without the Cvs prefix)

    Returns string

Methods

  • Add a child to this control using its relative position [rx, ry]. If rx and ry are not provided then it uses the values set in the child.

    Returns

    this control

    Parameters

    • c: string | CvsBaseControl

      is the actual control or its id

    • Optional rx: number
    • Optional ry: number

    Returns any

  • Adds additional images the image(s) to those already displayed in this viewer. They will be inserted at the position by the first parameter.

    All additional images will be resized to match the first (bottom) layer.

    Returns

    this control

    Parameters

    • idx: number
    • img: any

      an image or an array of images

    Returns CvsViewer

  • Appends additional image(s) to those already in this viewer. These images will appear above any pre-existing layers.

    The additional images will be resized to match the first (bottom) layer.

    Returns

    this control

    Parameters

    • img: any

      an image or an array of images

    Returns CvsViewer

  • Deletes 1 or more layers from this viewer.

    Returns

    this control

    Parameters

    • idx: number

      the starting layer to delete

    • nbr: number

      the number of layers to delete

    Returns CvsViewer

  • Disables this control.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true disable child controls

    Returns CvsBaseControl

  • Enables this control.

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true enable child controls

    Returns CvsBaseControl

  • Sets the stroke weight to use for the frame. If not provided or <0 then no frame is drawn.

    Returns

    this control

    Parameters

    • sw: number = 0

      the stroke weight for the frame

    Returns CvsViewer

  • Make this control invisible

    Returns

    this control

    Returns CvsBaseControl

  • Make a layer invisible

    Returns

    this control

    Parameters

    • n: number

      the layer number ≥0

    Returns CvsViewer

  • Sets the image(s) to be displayed in this viewer. Any pre-existing layers will be deleted.

    All images will be resized to match the first (bottom) layer.

    Returns

    this control

    Parameters

    • img: any

      an image or an array of images

    Returns CvsViewer

  • Remove this control from its parent

    Returns

    this control

    Returns CvsBaseControl

  • Move this control relative to current position.

    Returns

    this control

    Parameters

    • x: number

      horizontal distance

    • y: number

      vertical distance

    Returns CvsViewer

  • Move this control to an absolute position.

    Returns

    this control

    Parameters

    • x: number

      horizontal position

    • y: number

      vertical position

    Returns CvsViewer

  • Makes the controls background opaque. The actual color depends on the controls color scheme.

    The second parameter, alpha, is optional and controls the level of opaqueness from 0 - transparent to 255 - fully opaque (efault value).

    Returns

    this control

    Parameters

    • alpha: number = 255

      alpha value for controls background color.

    Returns CvsBaseControl

  • Adds this control to another control which becomes its parent.

    Returns

    this control

    Parameters

    • parent: string | CvsBaseControl

      is the parental control or its id

    • Optional rx: number

      x position relative to parent

    • Optional ry: number

      y position relative to parent

    Returns CvsBaseControl

  • Remove a child control from this one so that it stays in same screen position.

    Returns

    this control

    Parameters

    Returns CvsViewer

  • Sets or gets the scale and or scale limits

    If no parameters are passed the the current scale is returned. A single parameter sets the current scale and three parameter sets the current scale and the limits for the zoom slider.

    Returns

    this control or the current scale

    Parameters

    • v: number

      the scale to use

    Returns number | CvsViewer

  • Sets the existing scaler value (if there is no scaler it will be created) and limits. The initial value will be constrained to the limits.

    Returns

    this control

    Parameters

    • v: number

      the scale to use

    • l0: number

      the lowest scale allowed

    • l1: number

      the highest scale allowed

    Returns CvsViewer

  • If the name of a valid color scheme is provided then it will use it to display the control, non-existant scheme names will be ignored. In both cases this control is returned.

    If there is no parameter it returns the name of the current color scheme used by this control.

    Returns

    this control or the control's color scheme

    Parameters

    • Optional name: string

      the color scheme name e.g. 'blue'

    • Optional cascade: boolean

      if true propogate scheme to all child controls.

    Returns ColorScheme | CvsBaseControl

  • This sets the event handler to be used when this control fires an event. The parameter can take one of three forms:

    1. Arrow function definition
    2. Anonymous function definition
    3. Named function declaration

    Returns

    this control

    Parameters

    • event_handler: Function

      the function to handle this control's events.

    Returns CvsViewer

  • Make this control visible

    Returns

    this control

    Returns CvsBaseControl

  • Make a layer visible

    Returns

    this control

    Parameters

    • n: number

      the layer number ≥0

    Returns CvsViewer

  • The current status is an object with 3 fields { cX, cY, scale } where -

    • cX, cY is the position in the image that correseponds to the view center and
    • scale is the current scale used to display the image.

    Returns

    the current status

    Returns { cX: number; cY: number; scale: number }

    • cX: number
    • cY: number
    • scale: number
  • Makes the controls background fully transparent.

    Returns

    this control

    Returns CvsBaseControl

  • Sets the view of the image to be displayed. If you enter values outside the image or ar scale value outside scaler limts they will be constrained to legal action on the viewer to report back changes to the view centre and/or scale attributes.

    Parameters

    • wcx: number
    • wcy: number
    • Optional wscale: number

    Returns CvsViewer

Generated using TypeDoc