Zoom in or out in a 2D Graphics window
Zoom <ScenarioPath> {ZoomOption} [<Parameters>] [<WinNumber>]
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:
| {ZoomOption} | <Parameters> | <Parameters> & Description |
|---|---|---|
| Out | N/A | Zoom out to view a larger portion of a previously magnified Map |
| AllOut | N/A | Zoom out to the original Map view, regardless of the number of magnifications necessary to see the current Map view |
| In | N/A | Zoom 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.
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"
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1