Changes between Version 8 and Version 9 of MapGuideRfc170

Timestamp:

May 25, 2019, 3:37:32 AM (5 years ago)

Author:

jng

Comment:

--

MapGuideRfc170

@@ -7 +7 @@
 
 ||RFC Template Version||(1.0)||
-||Submission Date||||
-||Last Modified||22 May 2019||
+||Submission Date||22 May 2019||
+||Last Modified||25 May 2019||
 ||Author||Jackie Ng||
 ||RFC Status||Ready for review||
 ||Implementation Status||sandbox in progress||
-||Proposed Milestone||3.3||
+||Proposed Milestone||4.0||
 ||Assigned PSC guide(s)||(when determined)||
 ||'''Voting History'''||(vote date)||
-||+1||||
+||+1||Jackie,Gordon,Crispin,Martin||
 ||+0||||
 ||-0||||
 ||-1||||
-||no vote|| ||
+||no vote||Haris,Reno,Trevor||
 
 == Overview ==
@@ -207 +207 @@
 If applications do take advantage of these new overloads, it is expected they will always pass a {{{metaTilingFactor}}} of {{{0}}} when calling these new overloads or they know how to process and sub-divide the raw image frame buffer back into tile images of the original tile size.
 
+The new `MgMetatile` class is a semi-opaque handle from the perspective of MapGuide applications and its only purpose is really only to be fed to the {{{RenderTileFromMetaTile}}} method.
+
+The class is shown below for reference:
+
+{{{
+/////////////////////////////////////////////////////////////////
+/// \brief
+/// Defines a raw image frame buffer from the result of a meta-tile
+/// rendering operation
+///
+/// \since 3.3
+class MG_MAPGUIDE_API MgMetatile : public MgSerializable
+{
+    MG_DECL_DYNCREATE()
+    DECLARE_CLASSNAME(MgMetatile)
+
+EXTERNAL_API:
+
+    /// \brief
+    /// Gets the meta-tile content. If no meta-tiling is performed, this is the tile image. Otherwise,
+    /// it is the raw image frame buffer (for sub-dividing into originally requested tile images)
+    MgByteReader* GetImage();
+
+    /// \brief
+    /// Gets the originally requested width of this tile
+    INT32 GetRequestedWidth();
+
+    /// \brief
+    /// Gets the originally requested height of this tile
+    INT32 GetRequestedHeight();
+
+    /// \brief
+    /// Gets the width of this metatile
+    INT32 GetWidth();
+
+    /// \brief
+    /// Gets the height of this metatile
+    
+    INT32 GetHeight();
+
+    /// \brief
+    /// Gets the meta-tiling factor.
+    INT32 GetMetaTilingFactor();
+
+    /// \brief
+    /// Gets the originally requested tile image format
+    STRING GetTileImageFormat();
+
+...
+};
+}}}
+
 Meta-tiling support will be surfaced via new tile set definition parameters: