CARIS HPD : Portrayal : Drawing Instructions : Instruction Sets
 

Instruction Sets

This chapter describes the XSLT elements that can be employed to display dynamic cartography through instruction sets. For an overview of dynamic cartography, see Dynamic Cartography.

The following diagram shows how instruction sets relate to dynamic cartography. The LIGHTS geographic feature and the sector cartographic object are linked through dynamic cartography to generate instruction sets that display a light sector (see Sector Lights).

From the above diagram:

• The cartographic feature (sector) is linked to the LIGHTS feature.

• Drawing rules are read from the DCLIGHTS.xsl file in C:\Program Files\CARIS\HPD\<version>\system\PCEConfig\xslconfig\dynamicSample.

• Feature attributes and XSLT rules are combined into an instruction set that contains drawing instruction for components of the sector light feature (annulus, rays, arcs, and text)

• The sector feature is displayed in a chart according to the instruction set.

Drawing parameters for dynamic cartography features are stored in memory as instruction sets. These instruction sets are read by an HPD editor when the feature is displayed.Instruction sets can be viewed in the output_from_xslt.xml file by setting the uslXdebug_symbolization environment variable. For more information on setting this variable, see Input-Output Files.

An example of an instruction set for sector lights is shown below.

<InstructionSet priority="290" featureReference="1">

  <Annulus reverseBearing="true" innerRadius="30" outerRadius="33" sectorStart="225" sectorEnd="325">

    <Fill transparency="0.75" colour="Lights_Sectors_Red"/>

    <LineStyle styleRef="SOLIDLINE"/>

    <Distance parameter="innerRadius" attribute="bandir" max="38"/>

    <Distance parameter="outerRadius" attribute="bandor" max="40"/>

  </Annulus>

  <Ray reverseBearing="true" direction="225" length="40" crs="PortrayalCRS">

    <LineStyle styleRef="NALTSL"/>

    <Distance attribute="lenone" max="40"/>

  </Ray>

  <Ray reverseBearing="true" direction="325" length="40" crs="PortrayalCRS">

    <LineStyle styleRef="NALTSL"/>

    <Distance attribute="lentwo" max="40"/>

  </Ray>

  <ArcByRadius reverseBearing="true" radius="40" sectorStart="225" sectorEnd="325">

    <LineStyle styleRef="NALTSLARCAR"/>

    <Distance attribute="arcdis" max="40"/>

  </ArcByRadius>

  <ArcByRadius reverseBearing="true" radius="42" sectorStart="225" sectorEnd="325">

    <CurveText xPlacement="Middle" yPlacement="Middle" xOffset="0" yOffset="0">

      <Style font="Arial" colour="Black" size="7">

        <String>R</String>

      </Style>

    </CurveText>

    <Distance attribute="anndis" max="43"/>

  </ArcByRadius>

  <Symbol name="NPL1N" rotation="135"/>

</InstructionSet>

The <instructionSet> tag contains common attributes. See below

<InstructionSet priority="299" featureReference="697" maskRule="Symbols">

Attribute

Description

featureReference

Feature identifier on which instructions are to be applied.

priority

Drawing priority of the instruction in the set. Priority 1 draws first and n + 1 draws on top.

maskRule

The vector masking rule that applied to the instruction set. For more information on

The following sections describes the different graphical elements and editing controls that are required to apply dynamic cartography.