Changes between Version 15 and Version 16 of MapGuideRfc108

Timestamp:

Aug 17, 2010, 2:44:39 AM (14 years ago)

Author:

sparkliu

Comment:

--

MapGuideRfc108

@@ -41 +41 @@
         Sometimes users may want to move watermark a little (or change opacity) when using it in map / layer but don't want to change watermark in other maps referencing it. This often happens when user have two watermarks on the same map and there are some overlapping between these two watermarks. At that time, user can use this "override" mechanism to only change watermark a little in this map / layer.
 
-4.      When being rendered, the watermark group of an !MgMap is actually the collection of the watermarks referenced in its !MapDefinition and the watermarks referenced in the !LayerDefinition in it. 
+4.      When being rendered, the watermark group of an !MgMap is actually the collection of the watermarks referenced in its !MapDefinition and the watermarks referenced in the !LayerDefinition in it, no matter if the MgMap is used in AJAX / Fusion viewer or in WMS service. Client(Maestro or other ones) should be responsible for copying / moving watermark references if needed (for example, when "Publishing WMS"), while server / web extension will not do any related work automatically.
 
 5.      When using watermark in !LayerDefinition, user can decide in what situation the watermark is visible during rendering by defining “Usage” properties. For example, a watermark of a WMS layer is only visible when the value of its “Usage” properties is “WMS” or “ALL”. (There is no such problem when using watermark in !MapDefinition, because it will never be used in WMS.)
         Currently, the value of "Usage" can be "WMS" (WMS only), "Viewer" (AJAX /Fusion Viewer only) and "ALL".
 
+6. About the position of watermark: there are two types of position in watermark: XY position and tile position. Tile position means the watermark will repeat itself in the map image (it has nothing to do with tile service).
+                I)  The offset for tile position is the offset of watermark within tile (repeat unit), not map image.
+                II) The alignment base of offset is different depending on the alignment way. For horizontal alignment: 
+                        i) If the alignment is left, then the offset means the distance between left edge of watermark and that of map image / tile. 
+                        ii) If the alignment is center, then the offset means the distance between center of X-axis of watermark and that of map image / tile. 
+                        iii) If the alignment is right, then the offset means the distance between right edge of watermark and that of map image / tile.
+                      For vertical alignment: 
+                        i) If the alignment is top, then the offset means the distance between top edge of watermark and that of map image / tile. 
+                        ii) If the alignment is center, then the offset means the distance between center of Y-axis of watermark and that of map image / tile. 
+                        iii) If the alignment is bottom, then the offset means the distance between bottom edge of watermark and that of map image / tile.
 
+            Here are several examples:
+                a)  XY position: X-Offset: 10 pixels from right, Y-Offset: 20 pixels from bottom. Watermark is a 40 * 30 pixel image. Map image size 400*300 pixels. Then the position of watermark is:
+                        The left edge of watermark is 400 - 10 - 40 = 350 pixels (ImageWidth - XOffset - WatermarkWidth) from left edge of map image.
+                        The top edge of watermark is 300 - 20 - 30 = 250 pixels (ImageHeight - YOffset - WatermarkHeight) from top edge of map image.
+                b) Tile position: X-Offset: 10 pixels from right, Y-Offset: 20 pixels from bottom. Tile width: 210 pixels, tile height: 170px. Watermark is a 40 * 30 pixel image. Map image size 400*300 pixels. There will be four watermarks in map:
+                        i) Left: 210 - 10 - 40 = 160, Top: 170 - 20 - 30 = 120
+                        ii) Left: 2*210 - 10 - 40 = 370, Top: 170 - 20 - 30 = 120 (part of watermark is not visible for out of map image bound). 
+                        iii) Left: 2*210 - 10 - 40 = 370, Top: 170*2 - 20 - 30 = 290 (part of watermark is visible for out of map image bound). 
+                        iv) Left: 210 - 10 - 40 = 160, Top: 170*2 - 20 - 30 = 290 (part of watermark is visible for out of map image bound).
+        The unit of watermark position is the unit of "paper length", not the "actual length in map". So it will not align with the existing unit list in layer definition.
 == Implications ==