Description | Example | Return message | Group

Zoom

Zoom in or out in a 2D Graphics window

Syntax

Zoom <ScenarioPath> {ZoomOption} [<Parameters>] [<WinNumber>]

Description

The Zoom command allows you to magnify a portion of a 2D Graphics window or view a larger portion of a Map that was previously zoomed.

You can optionally enter <WinNumber> which is the number of the 2D window to which the changes should be applied. If not entered then the first 2D window will used.

{ZoomOption} can be:

"<ImageFileName>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.

{ZoomOption}<Parameters><Parameters> & Description
OutN/AZoom out to view a larger portion of a previously magnified Map
AllOutN/AZoom out to the original Map view, regardless of the number of magnifications necessary to see the current Map view
InN/AZoom in on (magnify) a portion of the selected 2D Graphics window. After issuing the command, you must go to the 2D Graphics window of interest, and click and hold the left mouse button and drag it over the portion of the map you wish to magnify. Zoom as many times as needed to see the details you want.
Object<ObjectPath> <DeltaLat>Uses the current position of the object as the center of the area to be magnified.
Region<MinX> <MinY> <MaxX> <MaxY>Zoom in to enlarge a portion of a Map specified by x and y values.
LatLon<CenterLat> <CenterLon> <DeltaLat>Uses the latitude and longitude specified as the center of the area to be magnified
MapCenter<DeltaLat>Determines the center of the 2D Graphics window and magnifies that view using the <DeltaLat> value
UTM<ZoneStr> <Easting> <Northing> <DeltaLat>Determines the center of the 2D Graphics window using ZoneStr, Easting, Northing which must describe a valid UTM map grid point. Easting and Northing are distances entered in Connect distance units. This option is only available for an Earth map. Valid values for <ZoneStr> are A, B, Y, Z or ddc, where 00>dd>61 and c is C-X.
MGRS<MGRSString> <DeltaLat>Determines the center of the 2D Graphics window using the MGRSString, which must describe a valid MGRS map grid point.
ImageInlay"<ImageFileName>"Zoom to the center of the specified image. Use the Graphics ImageInlay command to add images to the map.

All <Latitude> and <Longitude> values are entered in degrees.

<DeltaLat> must be greater than 0.0.

The Zoom Region command uses the window coordinate frame instead of the typical Map coordinate frame as a reference. Unlike Map coordinates, which are real-world physical coordinates, window coordinates range from -180.0 at the left edge of the map drawing area to +180.0 at the right edge in the X direction, and -90.0 at the bottom edge of the graphics drawing area to +90.0 at the top edge in the Y direction.

If {ZoomOption} is Object or LatLon, the true latitude/longitude is used, based on the current Map projection.

Examples

To magnify the region between 0.0 and 45.0 in the X direction and between 0.0 and 90.0 in the Y direction in the second 2D Graphics window:

Zoom * Region 0.0 0.0 45.0 90.0 2

To magnify the Map view in 2D Graphics window #1 using latitude and longitude coordinates:

Zoom * LatLon 0.0 0.0 30.0 1

To magnify the Map view so that the Perth facility is used to pinpoint the magnification area:

Zoom * Object */Facility/Perth 20.0

To enable the ability to select a magnification area in the 2D Graphics window using the mouse:

Zoom * In

To zoom to the center of the specified image:

Zoom * ImageInlay "C:\Program Files\AGI\STK 9\STKData\CentralBodies\Earth\Pixmaps\Relief.bmp"

Return message

Group membership

This command belongs to the following group(s):

2D Graphics Window

Version

11.6