QUICK_START

QUICK START

Description

PhotoCollageForge is an application to create collage posters from from a bunch of pictures in little time.
It is a desktop application running on PC and Mac.

Author: Markus Meier (mme68).

License

The software is free and open source, licensed under the MIT License. Copyright 2016 M. Meier, mme68 (owner of http://photocollageforge.sourceforge.net ).

All pictures (screenshots and example collages) are based on public domain pictures from Pixabay (http://pixabay.com).

Icons are from the free tango desktop project (http://tango.freedesktop.org - tango-icon-theme-0.8.90).

System Requirements

• A PC or Mac (Windows XP, 7, 8, 10, or Mac OS X, or Linux, BSD, ...).
• A Java (JRE Java Runtime Environment, Version 8.0 or higher; free download at http://java.com ).

Installation

• Download the executable JAR file PhotoCollageForge-1.0.jar from "Files"
• save it in any directory on your PC or Mac.

How to Run it

• Try to double-click the JAR-File PhotoCollageForge.jar (in your "Windows Explorer", Mac "Finder").

• Alternatively, enter on your shell (console, terminal, cmd.exe window):
  java -jar PhotoCollageForge.jar

• If both do not work, you probably do not have Java (Java Runtime Environment version 8 or higer) on your PC/Mac.
  Free download from http://java.com.

How to Use it

See: [HOW_TO_USE]

Known Issues

1. Picture file loading and resizing is relatively slow and resource intensive.
2. if the Java Runtime does not have sufficient memory, picture loading may fail.
   To add more memory, you may launch the application with the Xmx Option.
   For example, to assign 3 GB of memory, you would type in your shell (DOS prompt, Terminal, etc.):
   java -Xmx3g -jar PhotoCollageForge-1.0.1.jar

Release Notes

See: [RELEASE_NOTES]

Technical Details

• PhotoCollageForge is a Java desktop application using JavaFX
• Requires Java Standard Edition 8.0 or higher (JRE or JDK; free download from http://java.com)
• Provided as a single, executable JAR file which works on all platforms (Windows, Mac, Linux, etc.) where a Java JRE or JDK 8 or higher is installed.

TRANSLATIONS

• Translations from English to another language may be added in the file
  PhotoCollageForge-config-and-translations.txt

Project Members:

• M. Meier (admin)