📄 transformeddirectposition.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.4.2_13) on Tue Jun 05 11:36:21 GMT-05:00 2007 --><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><TITLE>TransformedDirectPosition (Geotools 2.3.x 2.3.2 API)</TITLE><META NAME="keywords" CONTENT="org.geotools.geometry.TransformedDirectPosition class"><META NAME="keywords" CONTENT="setCoordinateReferenceSystem()"><META NAME="keywords" CONTENT="transform()"><META NAME="keywords" CONTENT="inverseTransform()"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="TransformedDirectPosition (Geotools 2.3.x 2.3.2 API)";}</SCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="Skip navigation links"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/TransformedDirectPosition.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../org/geotools/geometry/JTS.ReferencedEnvelope.html" title="class in org.geotools.geometry"><B>PREV CLASS</B></A> NEXT CLASS</FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="TransformedDirectPosition.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#fields_inherited_from_class_GeneralDirectPosition">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">org.geotools.geometry</FONT><BR>Class TransformedDirectPosition</H2><PRE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../org/geotools/geometry/GeneralDirectPosition.html" title="class in org.geotools.geometry">GeneralDirectPosition</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><B>TransformedDirectPosition</B></PRE><DL><DT><B>All Implemented Interfaces:</B> <DD>Cloneable, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A>, DirectPosition, Position, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DD></DL><HR><DL><DT>public class <B>TransformedDirectPosition</B><DT>extends <A HREF="../../../org/geotools/geometry/GeneralDirectPosition.html" title="class in org.geotools.geometry">GeneralDirectPosition</A></DL><P>A direct position capable to <A HREF="../../../org/geotools/geometry/TransformedDirectPosition.html#transform(org.opengis.spatialschema.geometry.DirectPosition)">transform</A> a point between an arbitrary CRS and <A HREF="../../../org/geotools/geometry/GeneralDirectPosition.html#getCoordinateReferenceSystem()">its own CRS</A>. This class caches the last transform used in order to improve the performances when the source and target CRS don't change often. Using this class is faster than invoking <code>CoordinateOperationFactory.createOperation(sourceCRS, targetCRS)</code> for every points. <ul> <li><p><strong>Note 1:</strong> This class is advantageous on a performance point of view only if the same instance of is used for transforming many points between arbitrary CRS and this <A HREF="../../../org/geotools/geometry/GeneralDirectPosition.html#getCoordinateReferenceSystem()">position CRS</A>.</p></li> <li><p><strong>Note 2:</strong> This convenience class is useful when the source and target CRS are <em>not likely</em> to change often. If you are <em>sure</em> that the source and target CRS will not change at all for a given set of positions, then using <CODE>CoordinateOperation</CODE> directly gives better performances. This is because checks if the CRS changed before every transformations, which may be costly.</p></li> <li><p><strong>Note 3:</strong> This class is called <cite>Transformed</cite> Direct Position because it is more commonly used for transforming many points from arbitrary CRS to a common CRS (using the <A HREF="../../../org/geotools/geometry/TransformedDirectPosition.html#transform(org.opengis.spatialschema.geometry.DirectPosition)"><CODE>transform(DirectPosition)</CODE></A> method) than the other way around.</li></p> </ul> This class usually don't appears in a public API. It is more typicaly used as a helper private field in some more complex class. For example suppose that needs to perform its internal working in some particular CRS, but we want robust API that adjusts itself to whatever CRS the client happen to use. could be written as below: <blockquote><pre> public class MyClass { private static final CoordinateReferenceSystem PUBLIC_CRS = ... private static final CoordinateReferenceSystem INTERNAL_CRS = ... private final TransformedDirectPosition myPosition = new TransformedDirectPosition(PUBLIC_CRS, INTERNAL_CRS, null); public void setPosition(DirectPosition position) throws TransformException { // The position CRS is usually PUBLIC_CRS, but code below will work even if it is not. myPosition.transform(position); } public DirectPosition getPosition() throws TransformException { return myPosition.inverseTransform(PUBLIC_CRS); } } </pre></blockquote><P><P><DL><DT><B>Since:</B></DT> <DD>2.2</DD><DT><B>Author:</B></DT> <DD>Martin Desruisseaux</DD><DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html#org.geotools.geometry.TransformedDirectPosition">Serialized Form</A><DT><B>Module:</B></DT><DD><CODE><B>module/referencing</B></CODE> (<A HREF="http://maven.geotools.fr/repository/org/geotools/gt2-referencing/"><CODE>gt2-referencing.jar</CODE></A>) (<A HREF="http://maven.geotools.fr/reports/referencing/index.html">Maven report</A>) (<A HREF="http://svn.geotools.org/geotools/tags/2.3.2/module/referencing/src/org/geotools/geometry/TransformedDirectPosition.java">SVN head</A>)</DD></DL><HR><P><!-- ======== NESTED CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><A NAME="field_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Field Summary</B></FONT></TD></TR></TABLE> <A NAME="fields_inherited_from_class_GeneralDirectPosition"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Fields inherited from class <A HREF="../../../org/geotools/geometry/GeneralDirectPosition.html" title="class in org.geotools.geometry">GeneralDirectPosition</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -