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.