Clippings

The "clippings" element in the XML graphics definition File regroup definition of clippings. They will be used for all widgets which uses a mask (clip) index (the A661_MASK_CONTAINER widget). Each (clip) has the following attributes:

• "index": the index of the clip which is the value which will represent the clip in Definition files
• "name" the name of the clip which can also represent the clip in DFs

There are several ways to define a clip:

• by specifying one shape
• by specifying a list of Shape (in that case the clip is constituted by a constructive geometry of all the specified clip shapes

Structure for a clip specified with one shape

The "path" attribute specifies the Shape. For example:

      <clip name="RoundRectangle" index="4" path="round2000,3000,3000,4000,500,200" />

Structure for a clip specified with several shapes

In that case, we use constructive geometry to specify the Shape as the inclusion or exclusion of several Shapes. For example:

      <clip name="Rectangle2" index="2" >
         <clipPath path="r4000,4000,4000,3000" />
         <clipPath path="r1000,1000,2000,1000" />
      </clip>

Note that each "clipPath" element is by default added to the general Shape, but it is possible to eclude it from the Sape by specifying its "excluded" attribute to true.

Syntax for a path

The "path" attribute of a clip uses a syntax where each part of the path can be:

• x0,y0 x1,y1 ... xn,yn: denotes a path specified with its vertices. Each (xi, yi) pair correspond to one vertex
• rx,y,width,height": denotes a rectangle, specified with its position and width and height
• roundx,y,width,height,arcWidth,arcHeight": denotes a round rectangle, specified with its position, width and height, and arc width and height of the rounded borders
• ax,y,radius,angleStart,angleEnd: denotes an arc circle

Path examples

• 5000,5000 8000,5000 8000,8000 5000,8000 denotes a rectangle clip
• r5000,5000,3000,3000 denotes the same rectangle clip, explicitly defined as a rectangle.
• round5000,5000,3000,3000,100,100 denotes a round rectangle clip
• a5000,5000,3000,0,360 denotes a clip which is a circle
• a-5000,-5000,3000,0,360 denotes another clip which is a circle

Example

   <clippings>
      <clip name="Rectangle" index="1" path="r1000,1000,2000,2000" />
      <clip name="Rectangle2" index="2" >
         <clipPath path="r4000,4000,4000,3000" />
         <clipPath path="r1000,1000,2000,1000" />
      </clip>
      <clip name="Circle" index="3" path="a5000,3000,3000,45,135" />
      <clip name="RoundRectangle" index="4" path="round2000,3000,3000,4000,500,200" />
      <clip name="Triangle" index="5" path="1000,0 4000,1000 3000,2000" />
   </clippings>