Changes between Version 19 and Version 20 of FDORfc48

Timestamp:

Jul 29, 2010, 10:48:38 PM (14 years ago)

Author:

leaf

Comment:

--

FDORfc48

@@ -231 +231 @@
     ///
     /// \param sourceVertexOrderRule
-    /// The vertex order rule of the source.
+    /// Input the vertex order rule of the source.
     /// \param sourceStrictnessRule
-    /// The vertex order strictness rule of the source.
+    /// Input the vertex order strictness rule of the source.
     /// \param targetVertexOrderRule
-    /// The vertex order rule of the target.
+    /// Input the vertex order rule of the target.
     /// \param targetStrictnessRule
-    /// The vertex order strictness rule of the target.
+    /// Input the vertex order strictness rule of the target.
     /// \param preference
-    /// The preference when fixing polygon vertex order.
+    /// Input the preference when fixing polygon vertex order.
     /// 
     /// \return
@@ -348 +348 @@
 
 If users perfer performance to correctness, method !GetFixPolygonVertexOrderAction will use table1. It guarantees that polygons in the target will have the correct vertex order if the target is enforced. If users perfer correctness to performance, method !GetFixPolygonVertexOrderAction will use table2. It guarantees that polygons in the target will have the correct vertex order if the vertex order rule of the target isn't none.
+
+Considering perfomrance, an additional paramether 'FdoBoolean checkInteriorRings' will be added for method FdoSpatialUtility::ReversePolygonVertexOrder(...). If users know the input polygon is a valid polygon, they can pass false for parameter checkInteriorRings to reverse its vertex order. Otherwise, pass true. Method FdoSpatialUtility::ReversePolygonVertexOrder(...) will check whether interior rings have the different vertex order with exterior ring and guarantee the returned polygon is a valid polygon after reversing the vertex order of the input polygon.
+
+
+{{{
+class FdoSpatialUtility
+{
+public:
+    /// \brief
+    /// Revers the vertex order of the input polygon.
+    ///
+    /// \param geometry
+    /// Input the polygon geometry to be reversed. It can be a polygon, multipolygon,
+    /// curvepolygon, or multicurvepolygon.
+    /// \param checkInteriorRings
+    /// true  - Check whether interior rings have the different vertex order with
+    ///         exterior ring and guarantee the returned polygon is a valid polygon
+    ///         after reversing the vertex order of the input polygon.
+    /// false - Reverse the vertex order of interior rings and exterior ring directly
+    ///         no matter interior rings have the different vertex order with exterior ring.
+    ///
+    /// \return
+    /// Returns the modified polygon. 
+    ///
+    FDO_SPATIAL_API static FdoIGeometry* ReversePolygonVertexOrder (
+                              FdoIGeometry * geometry,
+                              FdoBoolean checkInteriorRings = false );
+}
+}}}