5.41. Path (media-object)

5.41.1. Attributes

5.41.2. Description

This element defines a path made of one or more Bezier curves. It is used either as an autonomous geometrical component in a scene, or as a path in a path transformation. The integer value size of the size attribute defines the number of Bezier curves that build the path.

The float value of the width attribute defines the width of the path; it must be set to 0 for an invisible path. The integer value of the segments attribute is the number of steps that will be used to build the mesh of the path when rendering it.

This element can have elements in its scope that define the properties of the path: color, material, materialRaytrace, shader, texture, or video. In addition to these optional elements, it must have size Bezier child elements that define the geometry of the path (its size Bezier curves).

5.41.3. Expected children

The following elements must occur in path: as many Beziers as the value of the size attribute, and, possibly, color, material, materialRaytrace, shader, texture, or video.

5.41.4. Example

The example below defines a green path made of two Bezier curves. The path is 0.03 units wide.

<node id="main_path">
  <path id="twoCurvePath" size="2" width="0.03000">
    <color id="green" r="0." g="1." b="0."/>
    <bezier size="4" location="1"
        x1="-1.00" y1="0.00" z1="0.00"
        x2="-0.50" y2="0.00" z2="0.00"
        x3="-0.50" y3="0.00" z3="0.60"
        x4="0.00"  y4="0.00" z4="0.60" />
    <bezier size="4" location="2"
        x1="0.00" y1="0.00" z1="0.60"
        x2="0.50" y2="0.00" z2="0.60"
        x3="0.50" y3="0.00" z3="0.00"
        x4="1.00" y4="0.00" z4="0.00" />
  </path>
</node>