Changes between Version 14 and Version 15 of MapGuideRfc108


Ignore:
Timestamp:
08/16/10 09:40:14 (14 years ago)
Author:
tomfukushima
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MapGuideRfc108

    v14 v15  
    2424== Overview ==
    2525
    26 This RFC updates MapGuide to support Watermark.
     26This RFC updates !MapGuide to support Watermarks.
    2727
    2828== Motivation ==
    2929
    30 Some customers complaint that there is no standard way to add watermark to the Map definition.
     30Provide a standard way to add watermarks to the Map definition.
    3131
    3232== Proposed Solution ==
     
    3535        Referencing another symbol definition resource as content is not supported. There are three main reasons for this: 1) Usually, content of watermark is usually very simple (maybe just text / image). 2) The biggest reason of referencing symbol definition as a outer resource is for reusing. However, the concept of watermark already supports reuse. 3) Supports both inline and referencing outer resource is a complex idea and bring confusion to the end user (like "Which part of watermark is defined in the referenced symbol definition and which is defined in watermark definition itself?"). Using inline symbol definition will treat the watermark definition as a whole concept to the end user.
    3636
    37 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.
     372.      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.
    3838        The inline-and/or-reference problem also shows here. Not supporting both mode is to reduce the complexity of watermark concept. As we need to support watermark as a separate resource so that user can reuse it very easily, inline watermark is not supported.
    3939
    40 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.
     403.      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.
    4141        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.
    4242
    43 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.
     434.      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.
    4444
    45 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.)
     455.      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.)
    4646        Currently, the value of "Usage" can be "WMS" (WMS only), "Viewer" (AJAX /Fusion Viewer only) and "ALL".
    4747
     
    4949== Implications ==
    5050
    51 MapGuide Mastro should update to add watermark into a Map and Layer.
     51Maestro will need to be updated to add watermark support.  There are changes to the !MapDefinition, !LayerDefinition, and there is a new !WatermarkDefinition resource.
    5252
    5353== Test Plan ==
    5454
    55 Build/Run on Windows/Linux
     55!Build/Run on !Windows/Linux
    5656
    5757== Funding / Resources ==