printoxx User Guide v.1.6
printoxx is a free open source Linux program for printing one or more image files on a user-defined page layout. Text titles and notes can be added with variable size and font.

License and Warranty
printoxx is licensed under the GNU General Public License V2 (Free Software Foundation). printoxx is not warranted for any purpose, but if you find a bug, I will try to fix it.

Origin and Contact
printoxx originates from the author's web site at  http://kornelix.squarespace.com/printoxx
Other web sites may offer it for download. Modifications may have been made.
If you have questions, suggestions, or a bug to report, contact  kornelix@yahoo.de

Using printoxx
Start printoxx by clicking the desktop launcher or with the command  printoxx. The window will show a blank print layout. Use the [setup] button to select paper format, portrait or landscape orientation, and printer (or leave as default). The blank print layout will change to match the printer setup.

Use the button [+image] to choose images files to place on the layout. In the file selection dialog, double-click an image file, then click somewhere on the layout. The image is depositied on the layout. Drag the image to the desired position. Drag any corner of the image to make it bigger or smaller. To rotate the image, use the [rotate] button. Repeat clicking on files and depositing on the layout until done. Move the images around to make the final arrangement. 


Use the button [+text] to add text titles or notes to the layout. Enter text, then click on an empty spot on the layout. The text is deposited on the layout. Drag the text into final position. Drag from either end of the text to change its size. Move the text and images around and change their sizes as desired. If "transparent" is selected when the text is deposited, the text background will be transparent (for writing on top of an image).

Use the [print] button to print the completed layout. Use the [save] button to save the layout as a JPEG image file, which you can print later or with another program.

Thumbnail Index
The button [index] shows a thumbnail index window with images in the current directory. You can click on a thumbnail image and then click on the layout window to add the image to the layout. The navigation buttons in the thumbnail window can be used to move around in your image library.


Further Tips
1. Images may overlap: those added later will cover those added earlier. Clicking on an image that is partly covered will bring it to the top.
2. Text strings are actually images of text, and are handled the same as images.
3. An image or text can be deleted by right-clicking on it.
4. The [rotate] button applies to the last image or text inserted, clicked, or moved.
5. For the CUPS printing system (the usual case with Linux), the print command $ lp will print JPEG images directly, and printoxx relies on this capability. I don't know about other printing systems. If printing does not work, save the layout with the [save] button and print the resulting JPEG file with some other program, e.g. gimp.
6. The dialogs for adding images and text may be open at the same time, so you can alternate between adding images and adding text without closing either dialog.
7. My testing has been limited to Ubuntu with CUPS and an HP printer. Paper formats US letter, A4, A5, and A6 seem to work OK, but formats smaller than A6 revert to A4. This may be a limitation of my printer.

Translations
See the text file TRANSLATIONS ( /usr/local/share/doc/printoxx/ ) for guidance on how to modify an existing translation or make a new one for a new language.