referencedcanvas.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDeviceCRS(org.opengis.referencing.crs.DerivedCRS)">setDeviceCRS</A></B>(DerivedCRS&nbsp;crs)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the device Coordinate Reference System for this .
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDisplayCRS(org.opengis.referencing.crs.DerivedCRS)">setDisplayCRS</A></B>(DerivedCRS&nbsp;crs)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the display Coordinate Reference System for this . </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDisplayToDeviceTransform(org.opengis.referencing.operation.Matrix)">setDisplayToDeviceTransform</A></B>(Matrix&nbsp;transform)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display</A> to <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDeviceCRS()">device</A> transform
 to the specified affine transform. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)">setObjectiveCRS</A></B>(CoordinateReferenceSystem&nbsp;crs)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the objective Coordinate Reference System for this .
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveToDisplayTransform(org.opengis.referencing.operation.MathTransform)">setObjectiveToDisplayTransform</A></B>(MathTransform&nbsp;transform)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective</A> to <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display</A>
 transform to the specified transform. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveToDisplayTransform(org.opengis.referencing.operation.Matrix)">setObjectiveToDisplayTransform</A></B>(Matrix&nbsp;transform)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective</A> to <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display</A>
 transform to the specified affine transform. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setScale(double)">setScale</A></B>(double&nbsp;scaleFactor)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the scale factor to the specified value. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/geotools/geometry/GeneralDirectPosition.html" title="class in org.geotools.geometry">GeneralDirectPosition</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#toDisplayPosition(org.opengis.spatialschema.geometry.DirectPosition)">toDisplayPosition</A></B>(DirectPosition&nbsp;coordinate)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Transforms a coordinate from an arbitrary CRS to the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display CRS</A>.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/geotools/geometry/GeneralDirectPosition.html" title="class in org.geotools.geometry">GeneralDirectPosition</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#toObjectivePosition(org.opengis.spatialschema.geometry.DirectPosition)">toObjectivePosition</A></B>(DirectPosition&nbsp;coordinate)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Transforms a coordinate from an arbitrary CRS to the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective
 CRS</A>. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_AbstractCanvas"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html" title="class in org.geotools.display.canvas">AbstractCanvas</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#addAsEditable(org.opengis.go.display.primitive.Graphic)">addAsEditable</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#addCanvasListener(org.opengis.go.display.canvas.CanvasListener)">addCanvasListener</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#addEventManager(org.opengis.go.display.event.EventManager)">addEventManager</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#dispose()">dispose</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#disposeEventManagers()">disposeEventManagers</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#enableCanvasHandler(org.opengis.go.display.canvas.CanvasHandler)">enableCanvasHandler</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#findEventManager(java.lang.Class)">findEventManager</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getActiveCanvasHandler()">getActiveCanvasHandler</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getDisplayCoordinateReferenceSystem()">getDisplayCoordinateReferenceSystem</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getFactory()">getFactory</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getGraphics()">getGraphics</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getObjectiveCoordinateReferenceSystem()">getObjectiveCoordinateReferenceSystem</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getRenderingHint(java.awt.RenderingHints.Key)">getRenderingHint</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getTitle()">getTitle</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getUID()">getUID</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#removeCanvasHandler(org.opengis.go.display.canvas.CanvasHandler)">removeCanvasHandler</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#removeCanvasListener(org.opengis.go.display.canvas.CanvasListener)">removeCanvasListener</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#setObjectiveCoordinateReferenceSystem(org.opengis.referencing.crs.CoordinateReferenceSystem)">setObjectiveCoordinateReferenceSystem</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#setObjectiveCoordinateReferenceSystem(org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.operation.MathTransform)">setObjectiveCoordinateReferenceSystem</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#setRenderingHint(java.awt.RenderingHints.Key, java.lang.Object)">setRenderingHint</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#setTitle(org.opengis.util.InternationalString)">setTitle</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#setTitle(java.lang.String)">setTitle</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#toString()">toString</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_DisplayObject"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html" title="class in org.geotools.display.canvas">DisplayObject</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#addPropertyChangeListener(java.beans.PropertyChangeListener)">addPropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)">addPropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#getImplHint(java.lang.String)">getImplHint</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#getLocale()">getLocale</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#getLogger()">getLogger</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#handleException(java.lang.String, java.lang.String, java.lang.Exception)">handleException</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#removePropertyChangeListener(java.beans.PropertyChangeListener)">removePropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)">removePropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#setImplHint(java.lang.String, java.lang.Object)">setImplHint</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Canvas"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface Canvas</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>getImplHint, setImplHint</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="ReferencedCanvas(org.opengis.go.display.DisplayFactory, int)"><!-- --></A><H3>
ReferencedCanvas</H3>
<PRE>
protected <B>ReferencedCanvas</B>(DisplayFactory&nbsp;factory,
                           int&nbsp;dimension)
                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>Creates an initially empty canvas with a default CRS of the specified number of dimensions.
<P>
<DT><B>Parameters:</B><DD><CODE>factory</CODE> - The display factory associated with this canvas, or  if none.<DD><CODE>dimension</CODE> - The number of dimensions, which must be 2 or 3.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the specified number of dimensions is not supported.</DL>
<HR>

<A NAME="ReferencedCanvas(org.opengis.go.display.DisplayFactory, org.opengis.referencing.crs.CoordinateReferenceSystem, org.geotools.factory.Hints)"><!-- --></A><H3>
ReferencedCanvas</H3>
<PRE>
protected <B>ReferencedCanvas</B>(DisplayFactory&nbsp;factory,
                           CoordinateReferenceSystem&nbsp;objectiveCRS,
                           <A HREF="../../../../org/geotools/factory/Hints.html" title="class in org.geotools.factory">Hints</A>&nbsp;hints)</PRE>
<DL>
<DD>Creates an initially empty canvas with the specified objective CRS.
<P>
<DT><B>Parameters:</B><DD><CODE>factory</CODE> - The display factory associated with this canvas, or  if none.<DD><CODE>objectiveCRS</CODE> - The initial objective CRS.<DD><CODE>hints</CODE> - The initial set of hints, or  if none.</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getEnvelope()"><!-- --></A><H3>
getEnvelope</H3>
<PRE>
public Envelope <B>getEnvelope</B>()</PRE>
<DL>
<DD>Returns an envelope that completly encloses all <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getEnvelope()">graphic envelopes</A> managed by this canvas. Note that there is no guarantee that the returned
 envelope is the smallest bounding box that encloses the canvas, only that the canvas lies
 entirely within the indicated envelope.
 <p>
 This envelope is different from
 <A HREF="../../../../org/geotools/display/canvas/map/DefaultMapState.html#getEnvelope()"><CODE>DefaultMapState.getEnvelope()</CODE></A>, since the later returns
 an envelope that encloses only the <em>visible</em> canvas area and is scale-dependent. This
  method is scale-independent. Both envelopes are equal
 if the scale is choosen in such a way that all graphics fit exactly in the canvas visible
 area.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>The envelope for this canvas in terms of <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective CRS</A>.<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/map/DefaultMapState.html#getEnvelope()"><CODE>DefaultMapState.getEnvelope()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#getEnvelope2D()"><CODE>ReferencedCanvas2D.getEnvelope2D()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getState()"><!-- --></A><H3>
getState</H3>
<PRE>
public CanvasState <B>getState</B>()</PRE>
<DL>
<DD>Returns a copy of the current state of this . The default implementation
 returns a <A HREF="../../../../org/geotools/display/canvas/DefaultCanvasState.html" title="class in org.geotools.display.canvas"><CODE>DefaultCanvasState</CODE></A> with a center position inferred from the canvas
 envelope.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTypicalCellDimension(org.opengis.spatialschema.geometry.DirectPosition)"><!-- --></A><H3>
getTypicalCellDimension</H3>
<PRE>
public double[] <B>getTypicalCellDimension</B>(DirectPosition&nbsp;position)</PRE>
<DL>
<DD>Returns a typical cell dimension in terms of <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective CRS</A>.
 For images, a cell is usually a pixel. For other kind of graphics, "cell dimension" shall
 be understood as some dimension representative of the graphic resolution. The default