Image annotation

Rationale

The image annotation component allows users to select an image and annotate it. Both the original image users select and the image with the annotation are saved as part of the data.

Browser support

This component uses wPaint, which requires support for the HTML5 canvas in the web browser. Most browsers have support for the canvas, but note that Internet Explorer IE9 or later is required (this feature will not work with IE7 and IE8).

Configuration

[SINCE Orbeon Forms 2023.1] You can change the start stroke color with the following property:

<property 
    as="xs:string"  
    name="oxf.xforms.xbl.fr.wpaint.start-stroke-color.*.*"      
    value="#FF8C00"/>

In Form Builder

To add this component to your form, in the toolbar, in the Attachments section, choose Image annotation.

In XForms

When using this component in your own XForms (rather than through Form Builder), you must bind it to an element that is either empty, or contains two elements <image> and <annotation>. If the element is empty, the two elements <image> and <annotation> are automatically added by the component.