Work with the Drawing Tool

    Overview

    The Drawing Tool enables you and your users to draw on the entire screen or within the bounds of specific images. While performing this free drawing you can change your brush width and color, enabling your drawings to contain a mix of different strokes.

    Additionally, on Windows PCs, the resulting marked-up scene or image can be saved to a snapshot that can then attached to an email, saved to the local file system or saved to a USB drive.

    NOTE: IntuiFace does not differentiate between a finger and a stylus. They are treated equally.

    Annotations.gif

    Turning on the Drawing Tool feature

    The drawing tool can be associated with any Scene or Image asset. There are two ways to make the drawing tool available in a running experience:

    1) Select the Show drawing tools property in the Properties panel (Tools Section) for the desired Scene or image:

    • The advantage of this option is that the drawing tool is always available at runtime, accessed by pressing a visible drawing tool button. This button's location is configurable for the scene, predefined for the image.
    • The disadvantage is that the drawing tool button is always visible.

    2) Trigger the Turn drawing mode on action for the desired scene or image (click to zoom):

    • The advantage of this option is that the drawing mode can be turned on by any action, (such as a button press) and will work without displaying the drawing tool button or toolbar.
    • The disadvantage is that you are limited to one brush stroke. The stroke (width and color) can be changed through use of the Change stroke action but this still requires the design of buttons, etc. that will trigger the stroke change.
      drawingmodeaction.PNG

    Drawing Tool properties

    The following applies to both the Scene and Image asset except where noted.

    • Show drawing tools   if true, a button will be displayed in the image at runtime (or preview) so that the user will be able to open the drawing tools.
    • Available colors   add, delete, reorder and modify the colors that will be available in the drawing palette at runtime.
    • Available widths   add, delete, reorder and modify the stroke widths that will be available in the drawing palette at runtime. You are limited to a maximum of 4 widths in the drawing tool.
    • Show drawing grid   if selected, a grid will be displayed when the drawing mode is activated
    • Show drawing mode label   if selected, text will be displayed on the upper left corner of the image while in drawing mode.
    • Drawing mode label text   text that will be displayed in the upper left corner of the image, while in drawing mode, if the previous option is selected.
    • Erase All label text   confirmation text displayed after the user presses the Erase all button in the drawing palette while in drawing mode.
    • Drawing mode mask   set color and transparency of the overlay displayed while in drawing mode
    • Drawing tool location, X   (only for the Scene) defines the X coordinate for the upper-left corner of the Drawing Tools button and panel
    • Drawing tool location, Y   (only for the Scene) defines the Y coordinate for the upper-left corner of the Drawing Tools button and panel
    • Drawing tool icon width   (only for the Scene) defines the width of the Drawing Tools button
    • Drawing tool icon height   (only for the Scene) defines the height of the Drawing Tools button

    Drawing Tool actions

    The following is found in the Drawing actions category for both the Space and Image asset. For more about triggers and actions, see this page.

    • Change stroke   select one brush width and color from the list of brush widths and colors predefined in the More Properties panel for this space or image
    • Turn Drawing Mode on   all touches on the target space or image will now result in a drawing. The stroke color and width will be the first brush color and width found in the More Properties panel for this space or image - unless the Change Stroke action has been used. See above.
    • Turn Drawing Mode off   turns off Drawing Mode
    • Turn Erase Mode on   all touches on the target space or image will erase the portion of existing drawings that are touched
    • Turn Erase Mode off   turns off Erase Mode
    • Erase all drawings   erases all drawings in the space or image

    NOTE: When using the action Turn Drawing Mode on with a space whose Show drawing tools property is not selected in the Properties panel, there is no touch-related method for turning off Drawing Mode. The entire screen will be covered by the drawing mask. In this scenario, the only way to exit out of Drawing Mode is through the use of an inactivity or simple timer to call the action Turn Drawing Mode off. To avoid this issue, make sure the space's Show drawing tools property is selected in the Properties panel. This will ensure the drawing tool palette is visible while in Drawing Mode.

    Saving a drawing for use outside of IntuiFace

    To save a drawing, take a snapshot of the drawing and then use the "Snapshot is taken" trigger to do any of the following:

    See this article for details about use of the "Snapshot is taken" trigger.