forked from roelj/inklingreader
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
136 lines (105 loc) · 3.49 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
GNU InklingReader
=================
This GNU project is an attempt to create a GNU/Linux-friendly version of the
Wacom Inkling SketchManager. Instead of integrating with proprietary programs,
this program aims to be compatible with free software alternatives like Inkscape.
The program can:
* Display WPI files
* Merge WPI files (command-line only)
* Export to Inkscape SVG (preserving layers), PDF, PNG and JSON
* Convert all WPI files in a directory to SVG
* Automatically assign colors upon pressing the "new layer" multiple times
* Give control over stroke pressure
* Export timing information in JSON
* Interact with the timeline of your drawing
* Use the Wacom Inkling as a mouse device
Integration with Inkscape
-------------------------
There's an Inkscape extension available that allows you to open WPI files with
Inkscape "directly". The extension uses InklingReader to convert the WPI format
to SVG in the background.
Installing the extension is quite easy. Copy the files in res/inkscape-extension
to your Inkscape extension directory. On GNU/Linux that is:
<pre>~/.config/inkscape/extensions/</pre>
Online-mode
-----------
The online-mode feature (use the Wacom Inkling as a mouse device) is in a rough
shape at the moment. It only works for GNU/Linux because it uses the uinput
kernel module. To enable it, you need super user rights (root) to be able to
activate the online-mode of the device and to create a virtual mouse device.
Enabling it can be done with the following commands:
<pre>
su - # Become a super user
modprobe uinput # Make sure the uinput kernel module is loaded.
./inklingreader -j # Start the program with the option to enable online-mode.
</pre>
Screenshot
----------
Dependencies
------------
Make sure you have the following libraries, development packages and build
tools installed:
* GCC or CLANG
* Automake
* Autoconf
* Make
* GTK+ (3.10 or later)
* librsvg-2.0
* libusb 1.0
Build instructions
------------------
When you have resolved the dependencies listed above you can build
the program by running:
<pre>
autoreconf -i
./configure
make
</pre>
To compile with CLANG:
<pre>
autoreconf -i
./configure CC=clang
make
</pre>
Additionally you can add compiler flags:
<pre>
autoreconf -i
./configure CFLAGS="-Wall -O2 -march=native"
make
</pre>
Optionally you can generate developer documentation using Doxygen.
<pre>
cd doc/
doxygen
</pre>
Tested distributions
--------------------
The software is known to run on:
* Debian 7.x
* CrunchBang Linux 11
* Fedora 20 or later
* Mageia 4
* Ubuntu 14.04 or later
* Mac OS X 10.7.5, clang (based on LLVM 3.1svn)
* Windows 8.1 (with MinGW and GTK 32-bit all-in-one bundle)
Since the program uses only widely available libraries it should run OK
on almost every GNU/Linux distribution. If you have problems getting it
to work on yours, let us know.
Contributing
------------
InklingReader can use help! If you're interested in helping, here's a list
of things you could do:
* Package InklingReader for any distribution
* Request and/or implement features
Contact
-------
You can join the [bug-inklingreader -at- gnu.org](https://lists.gnu.org/mailman/listinfo/bug-inklingreader)
mailing list to report bugs.
For general discussion, use the
[inklingreader-discuss -at- gnu.org](https://lists.gnu.org/mailman/listinfo/inklingreader-discuss)
mailing list.
License
-------
This project's code and the graphics in the "res/" folder are licensed under
the GPLv3 or any later version.