Changes between Version 6 and Version 7 of FDORfc10

Timestamp:

08/31/07 01:26:48 (18 years ago)

Author:

klain

Comment:

--

FDORfc10

@@ -50 +50 @@
 WMS Override API will accept a string instead of the enumeration for image format. It will only accept server defined format strings that contain ‘png’, ‘tiff’, ‘jpeg’ or ‘gif’ in their definitions. 
 
+For example, by calling SetImageFormat("image/png; PhotometricInterpretation=PaletteColor"), WMS Provider will return raster stream in palette model. And by calling SetImageFormat("image/png; PhotometricInterpretation=RGB"), the raster stream will be returned in RGB model. In this way, WMS Provider could fully make use of the server capability to support different bit-depth. These additional parameters will go into the configuration file like:
+
+<RasterDefinition name="Image">
+  <Format>image/png;PhotometricInterpretation=PaletteColor</Format> 
+  ...
+</RasterDefinition>
+
+However, still only four image file formats are supported: png, tiff, jpeg, and gif. If the user passed a string that contains other image formats like "bmp", "wbmp", etc, an exception will be thrown. 
+
 This section outlines the necessary code changes in the unmanaged and managed code.
 
@@ -71 +80 @@
     /// 
     /// \return
-    /// Returns the WMS format type.
+    /// Returns the WMS image format.
     /// 
-    FDOWMS_API FdoString* GetFormatType(void) const;
+    FDOWMS_API FdoString* GetImageFormat(void) const;
 
     /// \brief
@@ -87 +96 @@
     /// Returns nothing.
     /// 
-    FDOWMS_API void SetFormatType(FdoString* value);
+    FDOWMS_API void SetImageFormat(FdoString* value);
 ...
 }
@@ -107 +116 @@
     /// as Portable Network Graphics (PNG), Joint Photographics Expert Group (JPEG) 
     /// and file types such as Tagged Image File Format (TIFF).</remarks> 
-    __property System::String* get_FormatType();
+    __property System::String* get_ImageFormat();
 
     /// <summary>Sets the format type in which the WMS image will be generated.</summary>
@@ -115 +124 @@
     /// as Portable Network Graphics (PNG), Joint Photographics Expert Group (JPEG) 
     /// and file types such as Tagged Image File Format (TIFF).</remarks> 
-    __property System::Void set_FormatType(System::String* value);
+    __property System::Void set_ImageFormat(System::String* value);
 ...
 }
@@ -123 +132 @@
 == Implications ==
 
-This change will break the backwards compatibility. For example, configuration files created with this change won't be able to be used in previous version. This is a problem because currently WMS override API will do a strict check on parsing <Image> ... </Image> in the configuration file. E.g. it could only recognize png, jpg, Gif, or tif. They are hard-coded in the code: 
+•   The change is backwards compatible with existing config files. Existing config files will be readable by the updated WMS provider.
+
+•   The change is not forwards compatible. New config files created by the updated provider are not readable by earlier versions of the WMS provider.
+This is a problem because earlier versions of the WMS override API will do a strict check on parsing <Image> ... </Image> in the configuration file. It could only recognize "png", "jpg", "Gif", or "tif", as they are hard-coded in the code: 
 {{{
     static FdoString* g_WmsImageFormatPng                   = L"PNG";
@@ -130 +142 @@
     static FdoString* g_WmsImageFormatGif                   = L"GIF";
 }}} 
-There is no problem with forwards compatibility for old version of configuration files will also work with this change. 
 
 == Test Plan ==