referencedcanvas2d.html

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

<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/ReferencedCanvas2D.html#updateNormalizationFactor(org.opengis.referencing.crs.CoordinateReferenceSystem)">updateNormalizationFactor</A></B>(CoordinateReferenceSystem&nbsp;crs)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Updates <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#normalizeToDots"><CODE>normalizeToDots</CODE></A> affine transform for the specified
 <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective coordinate reference system</A>.
 </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/ReferencedCanvas2D.html#zoomChanged(java.awt.geom.AffineTransform)">zoomChanged</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/geom/AffineTransform.html" title="class or interface in java.awt.geom">AffineTransform</A>&nbsp;change)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Notifies all listeners that the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#objectiveToDisplay"><CODE>objectiveToDisplay</CODE></A> transform changed. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_ReferencedCanvas"><!-- --></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/ReferencedCanvas.html" title="class in org.geotools.display.canvas">ReferencedCanvas</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#add(org.opengis.go.display.primitive.Graphic)">add</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#clearCache()">clearCache</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDeviceCRS()">getDeviceCRS</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">getDisplayCRS</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayToObjectiveTransform()">getDisplayToObjectiveTransform</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getEnvelope()">getEnvelope</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getGraphicsAt(org.opengis.spatialschema.geometry.DirectPosition)">getGraphicsAt</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getGraphicsIn(org.opengis.spatialschema.geometry.Envelope)">getGraphicsIn</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">getObjectiveCRS</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveToDisplayTransform()">getObjectiveToDisplayTransform</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getScale()">getScale</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getState()">getState</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getTopGraphicAt(org.opengis.spatialschema.geometry.DirectPosition)">getTopGraphicAt</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getTypicalCellDimension(org.opengis.spatialschema.geometry.DirectPosition)">getTypicalCellDimension</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#graphicPropertyChanged(org.geotools.display.canvas.AbstractGraphic, java.beans.PropertyChangeEvent)">graphicPropertyChanged</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#remove(org.opengis.go.display.primitive.Graphic)">remove</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#removeAll()">removeAll</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDeviceCRS(org.opengis.referencing.crs.DerivedCRS)">setDeviceCRS</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDisplayCRS(org.opengis.referencing.crs.DerivedCRS)">setDisplayCRS</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDisplayToDeviceTransform(org.opengis.referencing.operation.Matrix)">setDisplayToDeviceTransform</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveToDisplayTransform(org.opengis.referencing.operation.MathTransform)">setObjectiveToDisplayTransform</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveToDisplayTransform(org.opengis.referencing.operation.Matrix)">setObjectiveToDisplayTransform</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setScale(double)">setScale</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#toDisplayPosition(org.opengis.spatialschema.geometry.DirectPosition)">toDisplayPosition</A>, <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#toObjectivePosition(org.opengis.spatialschema.geometry.DirectPosition)">toObjectivePosition</A></CODE></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 =========== -->

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

<A NAME="objectiveToDisplay"><!-- --></A><H3>
objectiveToDisplay</H3>
<PRE>
protected final <A HREF="../../../../org/geotools/referencing/operation/matrix/AffineTransform2D.html" title="class in org.geotools.referencing.operation.matrix">AffineTransform2D</A> <B>objectiveToDisplay</B></PRE>
<DL>
<DD>The affine transform from the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective CRS</A> to the
 <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display CRS</A>. This transform is zoom dependent, but device
 independent.
 <p>
 If a subclass changes the values provided in this matrix, then it should invokes
 <code><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setObjectiveToDisplayTransform(org.opengis.referencing.operation.Matrix)">setObjectiveToDisplayTransform</A>(objectiveToDisplay)</code> in order to reflect those changes
 into this canvas CRS, and <code><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#zoomChanged(java.awt.geom.AffineTransform)">zoomChanged</A>(change)</code> in
 order to notify listeners.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()"><CODE>ReferencedCanvas.getObjectiveCRS()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()"><CODE>ReferencedCanvas.getDisplayCRS()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveToDisplayTransform()"><CODE>ReferencedCanvas.getObjectiveToDisplayTransform()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#zoomChanged(java.awt.geom.AffineTransform)"><CODE>zoomChanged(java.awt.geom.AffineTransform)</CODE></A></DL>
</DL>
<HR>

<A NAME="displayToDevice"><!-- --></A><H3>
displayToDevice</H3>
<PRE>
protected final <A HREF="../../../../org/geotools/referencing/operation/matrix/AffineTransform2D.html" title="class in org.geotools.referencing.operation.matrix">AffineTransform2D</A> <B>displayToDevice</B></PRE>
<DL>
<DD>The affine transform from the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()">display CRS</A> to the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDeviceCRS()">device CRS</A>. This transform is set as if no clipping were performed by
 <cite>Swing</cite>. When the output device is the screen, this transform contains
 only <var>x</var> and <var>y</var> translation terms, which are the <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Rectangle.html#x" title="class or interface in java.awt"><CODE>Rectangle.x</CODE></A>
 and <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Rectangle.html#y" title="class or interface in java.awt"><CODE>Rectangle.y</CODE></A> values of the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#getDisplayBounds()">display bounds</A>
 respectively. This transform is often the identity transform.
 <p>
 If a subclass changes the values provided in this matrix, then it should invokes
 <code><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#setDisplayToDeviceTransform(org.opengis.referencing.operation.Matrix)">setDisplayToDeviceTransform</A>(displayToDevice)</code> in order to reflect those changes
 into this canvas CRS.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDisplayCRS()"><CODE>ReferencedCanvas.getDisplayCRS()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getDeviceCRS()"><CODE>ReferencedCanvas.getDeviceCRS()</CODE></A></DL>
</DL>
<HR>

<A NAME="normalizeToDots"><!-- --></A><H3>
normalizeToDots</H3>
<PRE>
protected final <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/geom/AffineTransform.html" title="class or interface in java.awt.geom">AffineTransform</A> <B>normalizeToDots</B></PRE>
<DL>
<DD>The affine transform from the units used in the <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getObjectiveCRS()">objective CRS</A>
 to "dots" units. A dots is equals to 1/72 of inch. This transform is basically nothing else
 than an unit conversion; This transform is used as a convenient step in the computation of a
 realistic <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas.html#getScale()">scale factor</A>.
 <p>
 This affine transform is computed automatically when <A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><CODE>setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)</CODE></A> is invoked.
 Users don't need to change its value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/ReferencedCanvas2D.html#updateNormalizationFactor(org.opengis.referencing.crs.CoordinateReferenceSystem)"><CODE>updateNormalizationFactor(org.opengis.referencing.crs.CoordinateReferenceSystem)</CODE></A></DL>
</DL>

<!-- ========= 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="ReferencedCanvas2D(org.opengis.go.display.DisplayFactory)"><!-- --></A><H3>
ReferencedCanvas2D</H3>
<PRE>
protected <B>ReferencedCanvas2D</B>(DisplayFactory&nbsp;factory)</PRE>
<DL>
<DD>Creates an initially empty canvas with a default CRS.
<P>
<DT><B>Parameters:</B><DD><CODE>factory</CODE> - The display factory associated with this canvas, 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="setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
setObjectiveCRS</H3>
<PRE>
public void <B>setObjectiveCRS</B>(CoordinateReferenceSystem&nbsp;crs)
                     throws TransformException</PRE>
<DL>
<DD>Sets the objective Coordinate Reference System for this .