>  Docs Center  >  Libraries  >  Motley  >  MGH_DEST_USQUARE

MGH_DEST_USQUARE

MGH_DEST_USQUARE

Name


  MGH_DEST_USQUARE

Purpose


  For a specified view & destination object, return the physical
  dimensions of a square on the view plane measuring 1 x 1
  normalised coordinates

Category


  Object Graphics.

Positional Parameters


  oview (input, scalar object reference)
    Reference to an Object Graphics view object. This object will be
    queried for its UNITS, DIMENSIONS, LOCATION and VIEWPLANE_RECT
    properties.
  odest (input, scalar object reference)
    Reference to an Object Graphics destination object. This object
    may be queried for its UNITS, DIMENSIONS, RESOLUTION and
    SCREEN_DIMENSIONS properties. If the view has non-zero
    DIMENSIONS and UNITS equal to 0, 1 or 2, and the view units
    match the units required for the result, then the destination
    object reference is not required.

Keywords


    UNITS (input, scalar integer)
      This keyword specified the units of the result (0 = pixels, 1 =
      inches, 2 = cm). Default is 0.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History


  Mark Hadfield, 1998-05:
    Written as MGH_NORM_DIMENSIONS.
  Mark Hadfield, 1999-10:
    I finally found a use for this, viz. code for manipulating
    objects with the mouse. I added a UNITS keyword and
    generalised the code accordingly.
  Mark Hadfield, 2001-07:
    Renamed MGH_DEST_USQUARE. Logic made simpler and more robust (I
    hope). This function shares a lot of its code with the new
    MGH_DEST_POSITION and I may merge them in future.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us