Changes between Version 29 and Version 30 of MapGuideRfc14

Timestamp:

02/07/07 11:18:56 (18 years ago)

Author:

traianstanev

Comment:

--

MapGuideRfc14

@@ -281 +281 @@
 The upper / lower dashing has zero start offset, whereas the cross tick has a 28 mm offset.  This horizontally positions the first cross tick at the center of the first long dash in the second cycle of upper / lower dashing.
 
+== Theming and Localization of Symbols ==
+
+Most properties in the !SymbolDefinition can be parametrized. This means that an expression can be provided that references attributes in the layer feature source for which the !SymbolDefinition is used. An example of a parametrized value would be:
+
+{{{
+<LineWeight>%1%</LineWeight>
+}}}
+
+This means that the parameter named 1 can be set to an expression in the Layer Definition, based on style choice made by the map author. Optionally the !SymbolDefinition can contain an element that describes what that theming does and also provides a default value for the parameter. For example, here is a !SymbolDefinition with this optional !ParameterDefinition element:
+
+{{{
+<SimpleSymbolDefinition>
+  <Name>ThickRail</Name>
+  <Description>This is a railroad symbol</Description>
+  <Graphics>
+    <Path>
+      <Geometry>
+        M 0.0, 0.0 L 5.0,0.0
+        M 2.5,-2.5 L 2.5,2.5
+      </Geometry>
+      <LineWeight>%LINE_WEIGHT%</LineWeight>
+      <LineCap>Round</LineCap>
+      <LineJoin>Round</LineJoin>
+    </Path>
+  </Graphics>
+  <LineUsage>
+    <VertexControl>OverlapWrap</VertexControl>
+    <Repeat>5.0</Repeat>
+  </LineUsage>
+  <ParameterDefintion>
+     <Parameter>
+        <Identifier>%LINE_WEIGHT%</Identifier>
+        <DefaultValue>1mm</DefaultValue>
+        <DisplayName>Line Weight:<DisplayName>
+        <Description>This is a sample</Description>
+        <ValueList>1mm 2mm 3mm 4mm</ValueList>
+     </Parameter>
+  </ParameterDefintion>
+</SimpleSymbolDefinition>
+}}}
+
+
+For translation of this symbol into another language, our solution is to create a translated parameter section and attach that to the !SymbolDefinition resource in the !MapGuide repository. The name of the attached resource will contain the locale of the translation. For example if the original symbol is called Symbol.xml, the German translated section would be called Symbol.xml.de. Here is what it would look like:
+
+{{{
+<SimpleSymbolDefinition>
+  <Name>DickeEisenBahnShiene</Name>
+  <Description>Das ist ein Eisenbahnschienen Symbol.</Description>
+  <ParameterDefintion>
+     <Parameter>
+        <Identifier>%LINE_WEIGHT%</Identifier>
+        <DefaultValue>0.0393700787in</DefaultValue>
+        <DisplayName>Linien Dicke:<DisplayName>
+        <Description>Das is nur Beispiel.</Description>
+        <ValueList>0.0393700787in 1in 2in 3in 4in</ValueList>
+     </Parameter>
+  </ParameterDefintion>
+</SimpleSymbolDefinition>
+}}}
+
+
 == Implications ==