How-To Guides

Customize Template

To create custom templates, you can start by copying an existing template folder. We highly recommend keeping the bundled templates and customizing your own copies with different names.
For instance, the default template files with comments can be found in [Documents>PhotoAlign>CanvasTemplate>Orthodontic Basic Photo].

Every template folders should be within the [CanvasTemplate] folder with different folder names.
Each template folder should contain [canvas.xml], [info.ini], and [thumbnail.png] files.
Additionally, files like [thumbnail_left.png] for canvas placeholders can be optionally included.

info.ini
The [info.ini] file contains essential template information and is structured as key=value pairs.
Here's what each key represents:
title: Title of the template, which will be displayed in the template list.
description: A brief description of the template, also displayed in the template list.
author: The author of the template, visible in the template list.
version: The version of the template. This will be displayed in the template list.
If you append a dot (.) and specify a language name to each key (e.g., title.korean), it will override the default language when that language is selected.
For example, title.korean will replace title if the language is selected as Korean.

canvas.xml
The [canvas.xml] file provides complete layout information for the template.
The structure is intuitive, and all numeric values are relative.
For example, value1="1" and value2="2" are the same with value1="200" and value2="400". The 'Left' and 'Top' properties are based in the upper-left corner as the origin.

The basic structure is like the below:
The attributes enclosed with [] are optional.

    <template [width="1" height="2"]>
    <board [background="#000000"]>
        <canvas
            id="1" : must be an integer. should be unique for each canvas.
            [title="Right Photo"] : human readable name of the canvas. It will be displayed on the top of the canvas.
            [description="Right Photo"] : human readable description that will be displayed in info section.
            width="1" : relative width (should be positive number).
            height="1.5" : relative height (should be positive number).
            left="0.1" : relative left (should be positive number).
            top="0.1" : relative top (should be positive number).
            [thumbnail="thumbnail_right.png"] : placeholder image filename.
            [background="#001100"] : background color (default is black).
            [reference="reference_right.jpg"] : reference photo (default is blank).
            [savename="right"] : the photo file on this canvas will be saved as this with original file extension.
            [preload="right.jpg,r.jpg"] : load the photo file on this canvas if the filename is the same with one of the preload values.
            [appointment="io_right"] : a reserved appointment name (see below).
            [shortcut="1"] : a shortcut selection number from 0 to 9.
        />
    </board>

    <extras>
        <guideline
            id="1" : must be an integer. should be unique for each guideline.
            [description="midline"] : human readable description that will be displayed in info section.
            orientation="horizontal" : horizontal or vertical guideline.
            attach="1" : target canvas id.
            top="0.5" : relative position of the guideline between 0 to 1. (if orientation is vertical, the attribute should be 'left').
        />
    </extras>
</template>