notes

Occurrence

optional, single

Attributes

Description

Inside <notes> additional information, for example remarks (text), links to photos, audio files, and video files can be given.

Elements inside <notes> are: <audio>, <video>, <image>, and <text>. The first three elements can appear any times, but <text> may appear only once. If text shall be formatted, <para> must be used inside <text>. If images, audio, and video files are to be formatted inside the text, the <text> must be given as the last statement inside <notes>.

For future versions of UDDF it is desirable to incorporate a <docbook> element inside <text> for enhanced formatting capabilities.

Parent Elements

<body>, <boots>, <buddy>, <buoyancycontroldevice>, <camera>, <cave>, <compass>, <compressor>, <divebase>, <divecomputer>, <fins>, <flash>, <generator>, <gloves>, <housing>, <knife>, <indoor>, <insurance>, <lead>, <lake>, <lens>, <light>, <mask>, <mix>, <observations>, <operator>, <owner>, <permit>, <rebreather>, <regulator>, <river>, <scooter>, <shop>, <shore>, <site>, <suit>, <tank>, <trip>, <variouspieces>, <vessel>, <videocamera>, <watch>, <wreck>

Child Elements

<audio>, <image>, <text>, <video>

See Also

the elements listed under parent elements

Examples

(see also the elements listed under parent elements)

<!-- In this first example it's the job of the executing program to format and display -->
<!-- the information given inside <notes> (i.e. formatting of the text, ordering -->
<!-- of the text and other media files etc.) -->
<notes>
    <text>
        <para>
            This is text in-between the text element. Using this, it's not possible
            to further format the text. The executing program formats the text.
        </para>
    </text>
    <!-- It is not possible to insert further text hereafter! -->
    <image id="image_1">
        <objectname>image_1.jpg</objectname>
        <!-- for this image no further information is available -->
    </image>
    <image id="image_2" height="3000" width="2000" format="jpg">
        <!-- absolute path (Unix world) -->
        <objectname>/home/kai/diving/image_2.jpg</objectname>
        <imagedata>
            <date>
                <year>2007</year><month>1</month><day>6</day>
            </date>
            <time>
                <hour>10</hour><minute>17</minute>
            <time>
            <aperture>2.8</aperture>
            <!-- exposure compensation -1 aperture -->
            <exposurecompensation>-1.0</exposurecompensation>
            <filmspeed>400</filmspeed>
            <shutterspeed>0.002</shutterspeed>         <!-- 1/500 s -->
            <focallength>0.035</focallength>           <!-- 35 mm -->
            <focusingdistance>1.3</focusingdistance>   <!-- 1,3 m -->
            <meteringmethod>spot</meteringmethod>
        </imagedata>
    </image>
    <!-- here more images can be inserted  -->
    <audio id="audio_1">
        <objectname>my_diving-jubilee-talk.wav</objectname>
    </audio>
    <!-- here more audio files can be inserted -->
    <video id="video_1">
        <objectname>my_1111_dive.avi</objectname>
    </video>
    <!-- here more video files can be inserted -->
</notes>
                
<!-- In this second example the audio, video, and image files - compulsory listed -->
<!-- BEFORE - are integrated into the text part. The text itself is divided in -->
<!-- several paragraphs. -->
<notes>
    <image height="3000" width="2000" format="jpg" id="a-picture">
        <!-- absolute path (Unix world) -->
        <objectname>/home/kai/diving/image_2.jpg</objectname>
        <imagedata>
            <date>
                <year>2007</year><month>1</month><day>6</day>
            </date>
            <time>
                <hour>10</hour><minute>17</minute>
            <time>
            <aperture>2.8</aperture>
            <!-- exposure compensation -1 aperture -->
            <exposurecompensation>-1.0</exposurecompensation>
            <filmspeed>400</filmspeed>
            <shutterspeed>0.002</shutterspeed>         <!-- 1/500 s -->
            <focallength>0.035</focallength>           <!-- 35 mm -->
            <focusingdistance>1.3</focusingdistance>   <!-- 1,3 m -->
            <meteringmethod>spot</meteringmethod>
        </imagedata>
    </image>
    <!-- here more images can be inserted  -->
    <audio id="audiodata_1">
        <objectname>my_diving-jubilee-talk.wav</objectname>
    </audio>
    <!-- here more audio files can be inserted -->
    <video id="video_1">
        <objectname>my_1111_dive.avi</objectname>
    </video>
    <!-- here more audio files can be inserted -->
    <!-- formatted text: -->
    <text>
        <para>
            This is a first paragraph of a logbook entry.
        </para>
        <!-- between the first two paragraphs this image shall be inserted... -->
        <imageref ref="a-picture"/>
        <!-- ... and also this .wav file -->
        <audioref ref="audiodata_1"/>
        <para>
            This is the second paragraph. Before it the executing program inserts the
            image "image_2.jpg" (with id "a-picture"), and the audio file
            "my_diving-jubilee-talk.wav" (with id "audiodata_1").
        </para>
        <!-- now the video shall be inserted before the third paragraph -->
        <videoref ref="video_1"/>
        <para>
            This is the third paragraph. In this manner it's possible the easy way to
            format logbook entries in UDDF!
        </para>
    </text>
    <!-- It is not possible to insert further text hereafter! -->
</notes>