README.rst

pibooth-picture-template

pibooth-picture-template is a plugin for the pibooth application.

It permits to define the captures/texts positions and sizes using a template. The template file (XML based on mxGraphModel definition) can be easily created/edited using the free online diagram software Flowchart Maker.

A set of templates can be found on GitHub.

The fancy.xml template is automatically installed by this plugin in ~/.config/pibooth/picture_template.xml.

Below are the pictures generated with this one (learn here how to Create a template):

Install

$ pip3 install pibooth-picture-template

Configuration

Here below the new configuration options available in the pibooth configuration. The keys and their default values are automatically added to your configuration after first pibooth restart.

[PICTURE]

# Pictures template path, it should contain 8 pages (4 capture numbers and 2 orientations)
template = picture_template.xml

Note

Edit the configuration by running the command pibooth --config.

Picture orientation

A TemplateParserError is raised if the requested orientation for the selected captures number can not be found in the template file.

If [PICTURE][orientation] = auto the best orientation is chosen following these rules:

• find a template with the correct number of captures and placeholders with same orientation than the captures.
• find a template with the correct number of captures.
• find a template with portrait orientation

Create a template

The steps below will show how to create a basic template file from scratch using the Flowchart Maker application.

This file may contain several templates to define the picture layout for 1 / 2 / 3 / 4 captures and portrait / landscape orientations.

Step 1: create a new file

	Click on Create New Diagram.
	Choose a blank diagram. Modify the name of the diagram, it will be the name of the exported file. Click on Create.
	Select the appropriated paper size. A custom one can be defined in inches.

Note

It could be easier to start from an existing file. Click on Open Existing Diagram to load the default template file located in ~/.config/pibooth/picture_template.xml

Step 2: placeholder for captures

	Choose a rectangle to define a capture placeholder. Other shapes have no effect and will be considered as rectangles.
	Resize the rectangle to fit the desired size. The rectangle can overflow the border of the page to make design effects. Up to 4 rectangles can be drawn.

Step 3: placeholder for texts

	Choose a text box to represent a text placeholder.
	Resize the text box to fit the desired size. Up to 2 text boxes can be drawn depending on the pibooth configuration.

Step 4: picture resolution

	Extra properties can be set to the template. Click on the button Edit Data (close to the paper size settings). Type dpi in the entry box and click on Add Property.
	By default a resolution of 600 DPI is used. It means that the picture size will be 2400x3600 pixels for a resolution of 4x6 inches. Set it to the desired value and click on Apply.

Step 5: add new a template

	Once the template is created. A new one can be defined for an other captures number or other orientation. Click on + to add a new page.
	The captures/texts placeholders shall be numbered to define the captures/texts to be placed inside. Colored shapes give a better overview of the layout but they are not rendered on the final picture.

Note

The same picture can be used several times in the template to allows a symmetric template for example (one copy for you, one for your guests).

Step 6: save the template file

	Generate the XML file by clicking File, Export as, XML....
	Click on Export (unselect Compressed if you want to edit the file manually later).

Note

Instead of running pibooth each time you want to test the result of your template, use the command pibooth-regen. It will regenerate the existing pictures present in ~/Pictures/pibooth using the new template.