File	Date	Author	Commit
.settings	2018-12-05	Luca Mini	[662d0a] fix for libopencv_imgcodecs.so.3.2: error addin...
Debug	2018-12-10	Luca Mini	[03c42a] fix linux key codes
src	2018-12-10	Luca Mini	[03c42a] fix linux key codes
win32_bin	2017-03-15	Luca Mini	[0f563b] new windows installer
.cproject	2018-12-05	Luca Mini	[662d0a] fix for libopencv_imgcodecs.so.3.2: error addin...
.gitignore	unknown
.project	unknown
Makefile	unknown
README	2017-01-26	Antonio Pirro	[72ab58] added README file
lucidchamber-paint.pro	2017-01-21	Antonio	[50d455] added packages for windows, icon and removed un...
url	2018-12-10	Luca Mini	[03c42a] fix linux key codes

Read Me

==========================================
LINUX
==========================================

DEPENDS
--------
to compile and use, you need the following package:
qmakev (qt5-base)
glib-2.0
gtk-x11-2.0
gdk-x11-2.0
gobject-2.0
dl
rt

most of these you should already have.
obviously you need a g++ compiler and libc.
In Ubuntu and derivatives
$ sudo apt install build-essential

COMPILE
--------
this one file source code, can be compiled with gcc as follows (in the source folder):

$ qmake lucidchamber-paint.pro
$ make

this produces the executable that you can move to /usr/bin to have it available in every folder.

==========================================
WINDOWS
==========================================
Thanks to my friend Antonio Pirro, now is available a Windows installer

LucidChamber Paint 1.0 setup.exe

in files section
Simply run it!

COMPILE
--------
In order to compile it in Windows OS, use the QT project lucidchamber-paint.pro
It is only needed to install a QT5 x86 release (mingw version is recommended).
The compilation process may be run both on commandline or QT Creator IDE.
On commandline, the following commands will compile the program:
/> qmake lucidchamber-paint.pro
/> make

After compiling, the program will refuse to work due to some dll libraries are missing.
To solve the issue the are 2 ways:
1. add to the system PATH both mingw and qt library folders
2. get the portable package from win32_bin folder, unpack it. There are all the needed dll's (put them in system folder or same folder of the main exe). 

==========================================
RUN (win and linux)
==========================================
The application can be executed without parameters (or with wrong parameters) and a main window permits 
to select the webcam to use and its settings then, the picture to paint. Press GO!
Now the main window shows camera and picture plus, an help window that shows all the
available commands.

RUN  from command line, mostly for linux users :)
-------------------------------------------------
$ lucid <webcam_number> <rotation> <m|n> <picture_to_paint>

where 
<webcam_number>
is the webcam number 0 is the first one; 1 the second ...
if you have only a webcam, it will be the 0, if you have a laptop and you use an external webcam it will 
be the 1 and so on.

<rotation>
this rotate the webcam image
0  =  0 deg
1  =  90 deg
2  =  180 deg
3  =  270 deg
use the right one for your webcam support and position

<m|n> can be m to mirror webcam, n for normal

Please run the executable from command line to see help on the useful keyboard shortcuts!

-------------------------------------------
Enjoy yourself and good drawing!

Luca