Changes between Initial Version and Version 1 of FDORfc66

Timestamp:

04/18/13 19:29:45 (12 years ago)

Author:

christinebao

Comment:

--

FDORfc66

@@ +1 @@
+= FDO RFC 66 - Support coordinate system transformation when serialize XML =
+
+This page contains a request for comments document (RFC) for the FDO Open Source project.  
+More FDO RFCs can be found on the [wiki:FDORfcs RFCs] page.
+
+== Status == 
+ 
+||RFC Template Version||1.1||  
+||Submission Date||April 19, 2013|| 
+||Last Modified||Christine Bao - April 19, 2013|| 
+||Author||Christine Bao|| 
+||RFC Status||Draft|| 
+||Implementation Status||Completed|| 
+||Proposed Milestone||3.9|| 
+||Assigned PSC guide(s)|||| 
+ 
+== Overview ==
+
+This proposal adds coordinate system transformation support when serialize XML using FdoXmlFeatureSerializer::XmlSerialize(...). 
+
+== Motivation ==
+
+FdoXmlFeatureSerializer is used for serializing FDO features into XML, for example it can serialize FDO features into WFS GML format. 
+
+{{{
+void FdoXmlFeatureSerializer::XmlSerialize( 
+        FdoIFeatureReader*              reader, 
+        FdoXmlFeatureWriter*            writer,
+    FdoXmlFeatureFlags*             flags)
+}}}
+
+However currently it can only reads the features and write the native data in data source coordinate system, if user request the data in another coordinate system, it fails to return the right value. For example, if the data source SDF's coordinate system is ca83, and published as WFS service. Customer can request this WFS in LL84 coordinate system. Currently the returned WFS GML still ca83, not expected as customer wants.
+
+== Proposed Solution ==
+
+FDO does not have coordinate system transformation capability. It should provide a way to let the caller to coordinate system transformation. A solution is to define a pseudo method in FDO:
+
+{{{
+class FdoCoordinateSystemTransform : public FdoDisposable
+{
+public:    
+    FDO_API  virtual FdoIDirectPosition* CoordinateSystemTransform(FdoIDirectPosition* sourceGeometry);
+};
+}}}
+
+And FdoXmlFeatureFlags adopt this if the caller wants to do coordinate system transformation. 
+
+{{{ 
+    FDO_API virtual void SetSrsName(FdoString* srsName); 
+    FDO_API virtual FdoString* GetSrsName();
+    FDO_API virtual void SetCoordinateSystemTransform(FdoCoordinateSystemTransform *transform);
+    FDO_API virtual FdoCoordinateSystemTransform* GetCoordinateSystemTransform();
+}}}
+
+This srs name and transform is called during FDO serializing XML. The default value is NULL, so if caller does not set it, it's ignored and work as before. 
+
+The caller can make a class inherit from FdoCoordinateSystemTransform and implement real CoordinateSystemTransform(...) function, set the instance to FdoXmlFeatureFlags, and the feature data is transformed.
+
+== Implications ==
+
+Existing code is not implicated. 
+
+== Test Plan ==
+
+Add unit test in FDO to do pseudo coordinate system transformation.
+Test in MapGuide to do real coordinate system transformation.
+
+== !Funding/Resources ==
+
+Autodesk