|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.esri.arcgis.display.DisplayTransformation
public class DisplayTransformation
Display transformation class for converting from world to device units.
Manages the map to device transformation. See IDisplayTransformation for information on how to prepare a transform for use.
Each DisplayTransformation object has a spatial reference object which manages the display's current coordinate system.
The DisplayTransformation is itself owned by a Display object, typically ScreenDisplay. Obtain an IDisplayTransformation reference to a DisplayTransformation object via IDisplay::DisplayTransformation; since IScreenDisplay inherits from IDisplay, you call also use IScreenDisplay::DisplayTransformation.
Constructor Summary | |
---|---|
DisplayTransformation()
Constructs a DisplayTransformation using ArcGIS Engine. |
|
DisplayTransformation(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. DisplayTransformation theDisplayTransformation = (DisplayTransformation) obj; |
Method Summary | |
---|---|
void |
addITransformEventsListener(ITransformEvents theListener)
addITransformEventsListener. |
void |
addUserScale(double scale)
Add a new user scale. |
double |
calculateScale(IEnvelope extent)
Calculate the scale of the specified extent. |
void |
enumConnectionPoints(IEnumConnectionPoints[] ppEnum)
enumConnectionPoints |
boolean |
equals(Object o)
Compare this object with another |
void |
findConnectionPoint(GUID riid,
IConnectionPoint[] ppCP)
findConnectionPoint |
void |
fromMapPoint(IPoint mapPoint,
int[] x,
int[] y)
Calculates device coordinates corresponding to the map point. |
double |
fromPoints(double pointDistance)
Calculates a map distance corresponding to a point (1/72) distance. |
IEnvelope |
getBounds()
Full extent in world coordinates. |
static String |
getClsid()
getClsid. |
IEnvelope |
getConstrainedBounds()
Intersection of Bounds and VisibleBounds. |
tagRECT |
getDeviceFrame()
Visible extent in device coordinates. |
IEnvelope |
getFittedBounds()
Device frame in world coordinates. |
short |
getMaxColorDepth()
Maximum color depth for raster output. |
double |
getRasterRatio()
Ratio between resolution and raster resolution. |
double |
getRasterResolution()
Resolution used to output rasterized data. |
double |
getReferenceScale()
Reference scale for computing scaled symbol sizes. |
int |
getResampleRatio()
This coefficient states the scale level for the raster when it goes to output. |
double |
getResolution()
Resolution of the device in dots (pixels) per inch. |
double |
getRotation()
Rotation angle in degrees. |
double |
getScaleRatio()
Scale between FittedBounds and DeviceFrame. |
int |
getScaleSnapping()
Indicates if transform snaps the fitted bounds to a standard scale. |
ISpatialReference |
getSpatialReference()
Current spatial reference. |
int |
getUnits()
Units used by world coordinates. |
double |
getUserScale(int idx)
Get the user scales. |
int |
getUserScaleCount()
Get the number of user scales. |
IEnvelope |
getVisibleBounds()
Visible extent in world coordinates. |
int |
hashCode()
the hashcode for this object |
boolean |
isDelayEvents()
Indicates if events are delayed. |
boolean |
isSuppressEvents()
Indicates if transformation object suppresses events. |
boolean |
isZoomResolution()
Indicates if resolution is tied to visible bounds. |
void |
loadDefaultUserScales()
Initialize user scales to defaults. |
double |
nextScale(double scale)
Find the nearest standard scale with a value that is higher than the specified scale. |
double |
previousScale(double scale)
Find the nearest standard scale with a value that is lower than the specified scale. |
void |
removeAllUserScales()
Remove all the user scales. |
void |
removeITransformEventsListener(ITransformEvents theListener)
removeITransformEventsListener. |
void |
removeUserScale(double scale)
Remove a user scale. |
void |
saveDefaultUserScales()
Set the current set of user scales to be the defaults. |
void |
setBounds(IEnvelope bounds)
Full extent in world coordinates. |
void |
setDelayEvents(boolean delayEvents)
Indicates if events are delayed. |
void |
setDeviceFrame(tagRECT bounds)
Visible extent in device coordinates. |
void |
setMaxColorDepth(short bitsPerPixel)
Maximum color depth for raster output. |
void |
setRasterResolution(double dpi)
Resolution used to output rasterized data. |
void |
setReferenceScale(double scale)
Reference scale for computing scaled symbol sizes. |
void |
setResampleRatio(int pRatio)
This coefficient states the scale level for the raster when it goes to output. |
void |
setResolution(double pDpi)
Resolution of the device in dots (pixels) per inch. |
void |
setRotation(double degrees)
Rotation angle in degrees. |
void |
setScaleRatio(double scale)
Scale between FittedBounds and DeviceFrame. |
void |
setScaleRatioNoRecalc(double rhs1)
The scale without any recalculation. |
void |
setScaleSnapping(int setting)
Indicates if transform snaps the fitted bounds to a standard scale. |
void |
setSpatialReferenceByRef(ISpatialReference spatialReference)
Current spatial reference. |
void |
setSuppressEvents(boolean suppressEvents)
Indicates if transformation object suppresses events. |
void |
setUnits(int unitsCode)
Units used by world coordinates. |
void |
setVisibleBounds(IEnvelope bounds)
Visible extent in world coordinates. |
void |
setZoomResolution(boolean flag)
Indicates if resolution is tied to visible bounds. |
double |
snapScale(double scale)
Snap the specified scale to a standard scale. |
IPoint |
toMapPoint(int x,
int y)
Calculates a point in map coordinates corresponding to the device point. |
double |
toPoints(double mapDistance)
Calculates a distance in points (1/72 inch) corresponding to the map distance. |
void |
transformCoords(_WKSPoint mapPoints,
tagPOINT devPoints,
int numPoints,
int options)
Transforms a set of points or measurements from device to world space or vice versa. |
void |
transformMeasuresFF(int direction,
double[] inMeasures,
double[][] outMeasures)
Transforms floating point measures to floating point measures (or do the inverse). |
void |
transformMeasuresFF(int direction,
int cMeasures,
double[] inMeasures,
double[] outMeasures)
Transforms floating point measures to floating point measures (or do the inverse). |
void |
transformMeasuresFI(int direction,
double[] inMeasures,
int[][] outMeasures)
Transforms floating point measures to integer measures (or do the inverse). |
void |
transformMeasuresFI(int direction,
int cMeasures,
double[] inMeasures,
int[] outMeasures)
Transforms floating point measures to integer measures (or do the inverse). |
void |
transformMeasuresIF(int direction,
int[] inMeasures,
double[][] outMeasures)
Transforms integer measures to floating point measures (or do the inverse). |
void |
transformMeasuresIF(int direction,
int cMeasures,
int[] inMeasures,
double[] outMeasures)
Transforms integer measures to floating point measures (or do the inverse). |
void |
transformMeasuresII(int direction,
int[] inMeasures,
int[][] outMeasures)
Transforms integer measures to integer measures (or do the inverse). |
void |
transformMeasuresII(int direction,
int cMeasures,
int[] inMeasures,
int[] outMeasures)
Transforms integer measures to integer measures (or do the inverse). |
void |
transformPointsFF(int direction,
double[] inPoints,
double[][] outPoints)
Transforms floating point points to floating point points (or do the inverse). |
void |
transformPointsFF(int direction,
int cPoints,
double[] inPoints,
double[] outPoints)
Transforms floating point points to floating point points (or do the inverse). |
void |
transformPointsFI(int direction,
double[] inPoints,
int[][] outPoints)
Transforms floating point points to integer points (or do the inverse). |
void |
transformPointsFI(int direction,
int cPoints,
double[] inPoints,
int[] outPoints)
Transforms floating point points to integer points (or do the inverse). |
void |
transformPointsIF(int direction,
int[] inPoints,
double[][] outPoints)
Transforms integer points to floating point points (or do the inverse). |
void |
transformPointsIF(int direction,
int cPoints,
int[] inPoints,
double[] outPoints)
Transforms integer points to floating point points (or do the inverse). |
void |
transformPointsII(int direction,
int[] inPoints,
int[][] outPoints)
Transforms integer points to integer points (or do the inverse). |
void |
transformPointsII(int direction,
int cPoints,
int[] inPoints,
int[] outPoints)
Transforms integer points to integer points (or do the inverse). |
void |
transformRect(IEnvelope mapRect,
tagRECT[] devRect,
int options)
Transforms a rectangle from device to world space or vice versa. |
void |
zoomTo(IEnvelope extent,
double scale)
Zoom to the specified scale. |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef |
---|
getJintegraDispatch, release |
Constructor Detail |
---|
public DisplayTransformation() throws IOException, UnknownHostException
IOException
- if there are interop problems
UnknownHostException
- if there are interop problemspublic DisplayTransformation(Object obj) throws IOException
DisplayTransformation theDisplayTransformation = (DisplayTransformation) obj;
obj
to DisplayTransformation
.
obj
- an object returned from ArcGIS Engine or Server
IOException
- if there are interop problemsMethod Detail |
---|
public static String getClsid()
public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public void addITransformEventsListener(ITransformEvents theListener) throws IOException
theListener
- An object that implements the com.esri.arcgis.display.ITransformEvents interface.
IOException
- If there are communications problems.public void removeITransformEventsListener(ITransformEvents theListener) throws IOException
theListener
- An object that implements the com.esri.arcgis.display.ITransformEvents interface.
IOException
- If there are communications problems.public void transformMeasuresFF(int direction, double[] inMeasures, double[][] outMeasures) throws IOException, AutomationException
transformMeasuresFF
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresFI(int direction, double[] inMeasures, int[][] outMeasures) throws IOException, AutomationException
transformMeasuresFI
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresIF(int direction, int[] inMeasures, double[][] outMeasures) throws IOException, AutomationException
transformMeasuresIF
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresII(int direction, int[] inMeasures, int[][] outMeasures) throws IOException, AutomationException
transformMeasuresII
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsFF(int direction, double[] inPoints, double[][] outPoints) throws IOException, AutomationException
transformPointsFF
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsFI(int direction, double[] inPoints, int[][] outPoints) throws IOException, AutomationException
transformPointsFI
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsIF(int direction, int[] inPoints, double[][] outPoints) throws IOException, AutomationException
transformPointsIF
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsII(int direction, int[] inPoints, int[][] outPoints) throws IOException, AutomationException
transformPointsII
in interface ITransformationGEN
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in/out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setBounds(IEnvelope bounds) throws IOException, AutomationException
setBounds
in interface IDisplayTransformation
bounds
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation.getBounds()
,
IDisplayTransformation
,
IActiveView.getFullExtent()
public IEnvelope getBounds() throws IOException, AutomationException
The Bounds property controls the full extent of the display. IActiveView::FullExtent really stores its full extent here and it has two uses for this property. In data view, IActiveView calculates the full extent of all the layers and automatically recalculates it whenever the spatial reference changes and when layers are added or removed from the Map. In layout view, IActiveView stores in FullExtent, the page size (expanded some) and it recalculates this property whenever the page size changes.
Setting the Bounds also sets the VisibleBounds to the same envelope and fires the ITransformEvents::BoundsUpdated and ITransformEvents::VisibleBoundsUpdated events.
>
//IActiveView.FullExtent relates to IDisplayTransformation.Bounds.MapControl mapControl;IActiveView activeView = mapControl.getActiveView();System.out.println(activeView.getFullExtent().getEnvelope().getXMax());IDisplayTransformation pDisplayTransform = activeView.getScreenDisplay().getDisplayTransformation();System.out.println(pDisplayTransform.getBounds().getXMax());
getBounds
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation.getBounds()
,
IDisplayTransformation
,
IActiveView.getFullExtent()
public void setVisibleBounds(IEnvelope bounds) throws IOException, AutomationException
setVisibleBounds
in interface IDisplayTransformation
bounds
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IEnvelope getVisibleBounds() throws IOException, AutomationException
VisibleBounds controls the visible extent of the display. By setting this property to different extents, you will get zoom in / zoom out effects. The VisibleBounds must fit within the current Bounds.
IActiveView::Extent really stores its value in this property. In data view, the Extent (VisibleBounds) is modified whenever the spatial reference changes. Also, the Extent is set the first time a layer is added to the Map. In layout view, the Extent is initially set to the page size. In both views, zooming in or out changes the Extent. The Extent is persisted in map documents.
When the VisibleBounds is set, it is always adjusted to match the aspect ratio the DeviceFrame and this is stored as the FittedBounds.
Setting the Visible Bounds also fires the ITransformEvents::BoundsUpdated and ITransformEvents::VisibleBoundsUpdated events to notify any clients that the bounds have changed.
getVisibleBounds
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation.getVisibleBounds()
,
ITin.getExtent()
,
IActiveView.getExtent()
,
IFeatureClassManage.updateExtent()
,
IFeatureClassManage
,
IDisplayTransformation.getFittedBounds()
public IEnvelope getFittedBounds() throws IOException, AutomationException
The VisibleBounds is adjusted to match the aspect ratio of the DeviceFrame. This adjusted rectangle is stored in FittedBounds and VisibleBounds stores the actual rectangle specified by the client. In this way, the FittedBounds is the true visible extent of the display and is a read-only property.
getFittedBounds
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation.getVisibleBounds()
,
ITin.getExtent()
,
IActiveView.getExtent()
,
IFeatureClassManage.updateExtent()
,
IFeatureClassManage
,
IDisplayTransformation.getFittedBounds()
public IEnvelope getConstrainedBounds() throws IOException, AutomationException
This is usually the same as the FittedBounds unless the display is at full extent and sized so that part of the visible area falls outside of the full extent.
getConstrainedBounds
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setDeviceFrame(tagRECT bounds) throws IOException, AutomationException
setDeviceFrame
in interface IDisplayTransformation
bounds
- A Structure: com.esri.arcgis.system.tagRECT (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public tagRECT getDeviceFrame() throws IOException, AutomationException
getDeviceFrame
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setZoomResolution(boolean flag) throws IOException, AutomationException
setZoomResolution
in interface IDisplayTransformation
flag
- The flag (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isZoomResolution() throws IOException, AutomationException
ZoomResolution is a flag that tells the DisplayTransformation whether or not to automatically adjust the device resolution (pixels per inch) based on the current zoom level. This is useful when you want to define a page display. With this kind of display, graphics are drawn at their actual size, i.e., scale is 1:1. Zooming in really means magnifying the graphics when drawing them to a computer monitor. When a map page is exported or printed, the zoom level is always 100% and the extent is defined by the page. Use ZoomResolution to specify this page-style behavior. With ZoomResolution set to true, the DisplayTransformation monitors the current zoom level. When the display is zoomed to 100%, a higher effective resolution is calculated. This has the effect of automatically magnifying all drawing. The Resolution property always returns the effective resolution. ScaleRatio always returns 1:1.
Note, when ZoomResolution is true, in order to get the physical device resolution, you must temporarily set ZoomResolution to false, get the Resolution, and then restore the ZoomResolution to true.
To find the current zoom percentage, simply divide the effective resolution by the physical resolution and multiply by 100. This is what IPageLayout::ZoomPercent does.
If you don't want graphics to scale as you zoom in, set this flag to false. For example, the Map object sets its DisplayTransformation's ZoomResolution property to false so that the contents of the map are not magnified when you zoom in on them. The PageLayout sets its DisplayTransformaion's ZoomResolution property to true.
isZoomResolution
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation
,
IDisplayTransformation.getResolution()
public void setResolution(double pDpi) throws IOException, AutomationException
setResolution
in interface IDisplayTransformation
pDpi
- The pDpi (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getResolution() throws IOException, AutomationException
In layout view, when the Page is zoomed 1:1, the resolution equals the device resolution. When the Page is zoomed to > 100%, the resolution is set higher so that graphics are magnified.
In data view, the Map object always has its resolution set to that of the display. Graphics are not magnified in this view when you zoom in.
The units are always in pixels per inch.
After setting the resolution, the ITransformEvents::ResolutionUpdated event is fired.
getResolution
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IDisplayTransformation
,
IDisplayTransformation.getResolution()
public void setRotation(double degrees) throws IOException, AutomationException
setRotation
in interface IDisplayTransformation
degrees
- The degrees (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getRotation() throws IOException, AutomationException
This property controls the rotation of the display. The angle of the rotation is measured in degrees and the rotation occurs around the center of the FittedBounds.
TrackRotate automatically sets this property but if you are using RotateStart / RotateStop, you must do so yourself. RotateStop provides the final angle rotation that should be used with this property.
Setting a new rotation automatically fires the ITransformEvents::RotationUpdated event.
getRotation
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IScreenDisplay.rotateTimer()
,
IDisplayTransformation.getRotation()
,
IScreenDisplay.rotateMoveTo(com.esri.arcgis.geometry.IPoint)
,
IScreenDisplay.rotateStop()
,
IScreenDisplay.rotateStart(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint)
public int getUnits() throws IOException, AutomationException
Units is the type of esriUnits used by the DisplayTransformation. For example, the Map object stores its map units in this property and the units are based on the current coordinate system. See IMap::MapUnits for more details. Also, the PageLayout's Page object stores its units in this property and it uses inches by default. See IPage::Units for more details.
You should not change the units of your Map or Page using this property. Instead, use the related properties mentioned above. Although setting the Map's or Page's Units property will set its DisplayTransform Units property, the reverse is not always true.
Setting the Units property fires the ITransformEvents::UnitsUpdated event.
getUnits
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setUnits(int unitsCode) throws IOException, AutomationException
setUnits
in interface IDisplayTransformation
unitsCode
- A com.esri.arcgis.system.esriUnits constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getScaleRatio() throws IOException, AutomationException
Several objects that manage a DisplayTransformation, such as the Map object, use this property to control the map scale. Map scale is the relationship between the dimensions of features on a map and the geographic objects they represent on the earth, commonly expressed as a fraction or a ratio. A map scale of 1/100,000 or 1:100,000 means that one unit of measure on the map equals 100,000 of the same units on the earth. When you zoom in or out in ArcMap's data view, you are changing this property on the Map's DisplayTransformation .
The Map object has a short-cut (IMap::MapScale) directly to this property on its DisplayTransformation object.
The PageLayout object does not use this property the same way as the Map object. In ArcMap's layout view, zooming in is akin to using a magnifying glass to zoom in on the page where the map is displayed. When you zoom in, you are magnifying what is actually going to print. To get this effect, the PageLayout objects always keeps its ReferenceScale set to zero and its ScaleRatio set to 1:1 (meaning that 1 inch on the screen equals one inch on the printer).
The following java code zooms the focus map to a 1:10,000 scale.
MapControl mapControl;IActiveView pActiveView = mapControl.getActiveView();IDisplayTransformation pDisplayTransform = pActiveView.getScreenDisplay().getDisplayTransformation()pDisplayTransform.setScaleRatio(10000);pActiveView.refresh();
getScaleRatio
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setScaleRatio(double scale) throws IOException, AutomationException
setScaleRatio
in interface IDisplayTransformation
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getReferenceScale() throws IOException, AutomationException
All symbols are drawn relative to the scale value set in this property. By default this value is zero. Symbol size is true at the reference scale. When the reference scale is 0, symbols are always drawn at the same size regardless of the map scale (ScaleRatio). For example, if you set your labels to display with 10 pt font, they will appear as 10 pt text at any map scale. When the reference scale is greater than 0, symbols are drawn at a size relative to the map scale. For example, if you set your labels to display with 10 pt font and have a reference scale of 10,000, the labels will appear as 10 pt only at that map scale; as you zoom in, the size of all symbols increases because the size of the symbols is based on the smaller scale.
The Map object has a short-cut (IMap::ReferenceScale) directly to the ReferenceScale property on its DisplayTransformation object.
The PageLayout object does not use ReferenceScale and ScaleRatio the same way as the Map object. In layout view, zooming in is more like a magnifying glass looking at what is going to print. When you zoom in, you only magnify what is actually going to print. To get this effect, the ReferenceScale is always set to zero and the ScaleRatio is always set to 1:1 (i.e., 1 inch on the screen equals one inch on the printer). In data view however, zooming in or out, changes what gets printed - WYSIWYG (What You See Is What You Get).
getReferenceScale
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setReferenceScale(double scale) throws IOException, AutomationException
setReferenceScale
in interface IDisplayTransformation
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setSpatialReferenceByRef(ISpatialReference spatialReference) throws IOException, AutomationException
setSpatialReferenceByRef
in interface IDisplayTransformation
spatialReference
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public ISpatialReference getSpatialReference() throws IOException, AutomationException
Use this property to obtain a reference to the transforms coordinate system object.
getSpatialReference
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isSuppressEvents() throws IOException, AutomationException
SuppressEvents on IDisplayTransformation prevents events collected under ITransformEvents from being fired.
For example, IScreenDisplay::StartDrawing sets SuppressEvents to TRUE and FinishDrawing sets it back to FALSE, this prevents all transform events from firing during the drawing.
SuppressEvents is set to FALSE by default.
isSuppressEvents
in interface IDisplayTransformation
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setSuppressEvents(boolean suppressEvents) throws IOException, AutomationException
setSuppressEvents
in interface IDisplayTransformation
suppressEvents
- The suppressEvents (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformRect(IEnvelope mapRect, tagRECT[] devRect, int options) throws IOException, AutomationException
TransformRect converts a rectangle from map units to device units or vice versa. Multiple options can be entered to control the direction of the transformation etc by added the values of constants from esriDisplayTransformationEnum. The values in esriDisplayTransformationEnum define the accepted values that can be used in the transformation.
transformRect
in interface IDisplayTransformation
mapRect
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)devRect
- A Structure: com.esri.arcgis.system.tagRECT (in/out: use single element array)options
- The options (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformCoords(_WKSPoint mapPoints, tagPOINT devPoints, int numPoints, int options) throws IOException, AutomationException
TransformCoords converts an array of points from map units to device units or vice versa. The TRANSFORM_TOMAP and TRANSFORM_TODEVICE flags control the direction of the transformation. The TRANSFORM_SIZE and TRANSFORM_POSITION flags specify whether the points are coordinates or sizes.
transformCoords
in interface IDisplayTransformation
mapPoints
- A Structure: com.esri.arcgis.system._WKSPoint (A com.esri.arcgis.system._WKSPoint COM typedef) (in)devPoints
- A Structure: com.esri.arcgis.display.tagPOINT (in)numPoints
- The numPoints (in)options
- The options (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IPoint toMapPoint(int x, int y) throws IOException, AutomationException
ToMapPoint converts an (X,Y) location in device coordinates to real world coordinates (either map units or page units if working with ArcMap's PageLayout ).
toMapPoint
in interface IDisplayTransformation
x
- The x (in)y
- The y (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void fromMapPoint(IPoint mapPoint, int[] x, int[] y) throws IOException, AutomationException
FromMapPoint converts a point in map units to device coordinates.
fromMapPoint
in interface IDisplayTransformation
mapPoint
- A reference to a com.esri.arcgis.geometry.IPoint (in)x
- The x (out: use single element array)y
- The y (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double toPoints(double mapDistance) throws IOException, AutomationException
Converts the specified map distance into point distance (1/72 inch).
toPoints
in interface IDisplayTransformation
mapDistance
- The mapDistance (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double fromPoints(double pointDistance) throws IOException, AutomationException
Converts the point distance into map distance.
fromPoints
in interface IDisplayTransformation
pointDistance
- The pointDistance (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresFF(int direction, int cMeasures, double[] inMeasures, double[] outMeasures) throws IOException, AutomationException
transformMeasuresFF
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cMeasures
- The cMeasures (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresFI(int direction, int cMeasures, double[] inMeasures, int[] outMeasures) throws IOException, AutomationException
transformMeasuresFI
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cMeasures
- The cMeasures (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresIF(int direction, int cMeasures, int[] inMeasures, double[] outMeasures) throws IOException, AutomationException
transformMeasuresIF
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cMeasures
- The cMeasures (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformMeasuresII(int direction, int cMeasures, int[] inMeasures, int[] outMeasures) throws IOException, AutomationException
transformMeasuresII
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cMeasures
- The cMeasures (in)inMeasures
- The inMeasures (in)outMeasures
- The outMeasures (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsFF(int direction, int cPoints, double[] inPoints, double[] outPoints) throws IOException, AutomationException
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
transformPointsFF
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cPoints
- The cPoints (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsFI(int direction, int cPoints, double[] inPoints, int[] outPoints) throws IOException, AutomationException
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
transformPointsFI
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cPoints
- The cPoints (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsIF(int direction, int cPoints, int[] inPoints, double[] outPoints) throws IOException, AutomationException
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
transformPointsIF
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cPoints
- The cPoints (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void transformPointsII(int direction, int cPoints, int[] inPoints, int[] outPoints) throws IOException, AutomationException
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
transformPointsII
in interface ITransformation
direction
- A com.esri.arcgis.geometry.esriTransformDirection constant (in)cPoints
- The cPoints (in)inPoints
- The inPoints (in)outPoints
- The outPoints (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setScaleRatioNoRecalc(double rhs1) throws IOException, AutomationException
setScaleRatioNoRecalc
in interface IDisplayTransformationAdmin
rhs1
- The rhs1 (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getScaleSnapping() throws IOException, AutomationException
getScaleSnapping
in interface IDisplayTransformationScales
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setScaleSnapping(int setting) throws IOException, AutomationException
setScaleSnapping
in interface IDisplayTransformationScales
setting
- A com.esri.arcgis.display.esriScaleSnapping constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getUserScaleCount() throws IOException, AutomationException
getUserScaleCount
in interface IDisplayTransformationScales
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getUserScale(int idx) throws IOException, AutomationException
getUserScale
in interface IDisplayTransformationScales
idx
- The idx (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void addUserScale(double scale) throws IOException, AutomationException
addUserScale
in interface IDisplayTransformationScales
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void removeUserScale(double scale) throws IOException, AutomationException
removeUserScale
in interface IDisplayTransformationScales
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void removeAllUserScales() throws IOException, AutomationException
removeAllUserScales
in interface IDisplayTransformationScales
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void loadDefaultUserScales() throws IOException, AutomationException
loadDefaultUserScales
in interface IDisplayTransformationScales
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void saveDefaultUserScales() throws IOException, AutomationException
saveDefaultUserScales
in interface IDisplayTransformationScales
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double calculateScale(IEnvelope extent) throws IOException, AutomationException
calculateScale
in interface IDisplayTransformationScales
extent
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void zoomTo(IEnvelope extent, double scale) throws IOException, AutomationException
zoomTo
in interface IDisplayTransformationScales
extent
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double snapScale(double scale) throws IOException, AutomationException
snapScale
in interface IDisplayTransformationScales
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double nextScale(double scale) throws IOException, AutomationException
nextScale
in interface IDisplayTransformationScales
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double previousScale(double scale) throws IOException, AutomationException
previousScale
in interface IDisplayTransformationScales
scale
- The scale (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getRasterResolution() throws IOException, AutomationException
getRasterResolution
in interface IRasterOutputSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setRasterResolution(double dpi) throws IOException, AutomationException
setRasterResolution
in interface IRasterOutputSettings
dpi
- The dpi (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public short getMaxColorDepth() throws IOException, AutomationException
getMaxColorDepth
in interface IRasterOutputSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setMaxColorDepth(short bitsPerPixel) throws IOException, AutomationException
setMaxColorDepth
in interface IRasterOutputSettings
bitsPerPixel
- The bitsPerPixel (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getRasterRatio() throws IOException, AutomationException
getRasterRatio
in interface IRasterOutputSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getResampleRatio() throws IOException, AutomationException
getResampleRatio
in interface IOutputRasterSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setResampleRatio(int pRatio) throws IOException, AutomationException
setResampleRatio
in interface IOutputRasterSettings
pRatio
- The pRatio (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void enumConnectionPoints(IEnumConnectionPoints[] ppEnum) throws IOException, AutomationException
IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.
enumConnectionPoints
in interface IConnectionPointContainer
ppEnum
- A reference to a com.esri.arcgis.display.IEnumConnectionPoints (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void findConnectionPoint(GUID riid, IConnectionPoint[] ppCP) throws IOException, AutomationException
IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.
findConnectionPoint
in interface IConnectionPointContainer
riid
- A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)ppCP
- A reference to a com.esri.arcgis.display.IConnectionPoint (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setDelayEvents(boolean delayEvents) throws IOException, AutomationException
setDelayEvents
in interface IDelayEvents
delayEvents
- The delayEvents (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isDelayEvents() throws IOException, AutomationException
isDelayEvents
in interface IDelayEvents
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |