= !MapGuide RFC 108 - Support Watermark =

This page contains a change request (RFC) for the !MapGuide Open Source project.
More !MapGuide RFCs can be found on the [wiki:MapGuideRfcs RFCs] page.


== Status ==

||RFC Template Version||(1.0)||
||Submission Date|| July 30,2010 ||
||Last Modified|| Buddy Hu, July 30,2010 ||
||Author|| Buddy Hu||
||RFC Status|| Draft||
||Implementation Status||(pending)||
||Proposed Milestone|| 2.3 ||
||Assigned PSC guide(s)||(when determined)||
||'''Voting History'''||(vote date)||
||+1||||
||+0||||
||-0||||
||-1||||
||no vote|| ||

== Overview ==

This RFC updates MapGuide to support Watermark.

== Motivation ==

Some customers complaint that there is no standard way to add watermark to the Map definition.

== Proposed Solution ==

1.	Create a new resource type for watermark, which defines content (in the format of an inline symbol definition), appearance (rotation / transparency) and position information of watermark. The schema of watermark definition is attached below.

2.	User can add a watermark to MapDefinition or LayerDefinition by referencing corresponding watermark resource(s) in it. However, we do NOT support inline watermark in MapDefinition and LayerDefinition.

3.	When MapDefinition or LayerDefinition references a watermark resource, it can choose to override its appearance and position information to bring flexibility to the user. The override attributes defining in MapDefinition or LayerDefinition has a higher priority than that in watermark when rendering.

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. 

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.)


== Implications ==

MapGuide Mastro should update to add watermark into a Map and Layer.

== Test Plan ==

Build/Run on Windows/Linux 

== Funding / Resources ==

Supplied by Autodesk