Xournal User's Manual
</h2>
<p style="font-size: 0.95em; text-align: center; color: rgb(0,0,0)">
- Version 0.4.5
+ Version 0.4.7
</p>
<hr />
<p>
that the typesetting of the text may be slightly different in the
printout.
</p>
+<h3 class="subsub"> The image tool</h3>
+<p>
+ To insert a new image (from a file on disk), click at the location
+ where the upper-left corner is to be located. A file selection dialog
+ box pops up. Alternatively, images can be pasted directly from the
+ clipboard (without having to select the image tool). In both cases,
+ the newly inserted image is selected, and can be easily moved or resized
+ as with any selection.
+</p>
<h3 class="subsub"><img src="pixmaps/ruler.png"> The ruler</h3>
<p>
The ruler is not a tool by itself, but rather a special operating mode
or to a different journal) using the copy-paste toolbar buttons or the
corresponding entries of the Edit menu.
</p>
+<h3 class="subsub"><img src="pixmaps/lasso.png"> Lasso selection</h3>
+<p>
+ This tool lets you select an irregular shaped region of the current layer.
+ All the items which are entirely contained within the given region
+ are selected. As with the rectangle selection tool, the selection can be moved,
+ resized, copied and pasted.
+</p>
<h3 class="subsub"><img src="pixmaps/stretch.png"> Vertical space</h3>
<p>
This tool lets you insert or remove vertical space within the page:
<h2 class="subtitle">Author information, license, bug-reports</h2>
<p>
Xournal is written by Denis Auroux
-(aur<!--despam-->oux<span>@</span><span>math</span>.<span>mit.edu,
-aur<!--despam-->oux<span>@</span><span>math</span>.<span>berkeley.edu).
+(aur<!--despam-->oux<span>@</span><span>math</span>.<span>berkeley.edu).
</p>
<p>
The source code includes contributions by the following people:
-Eduardo de Barros Lima, Mathieu Bouchard, Ole Jørgen Brønner,
-Vincenzo Ciancia, Luca de Cicco, Michele Codutti,
-Robert Gerlach, Lukasz Kaiser, Danny Kukawka, Bob McElrath,
-Andy Neitzke, David Planella, Alex Ray, Jean-Baptiste Rouquier,
-Mike Ter Louw, Uwe Winter, Lu Zhihe.
+Alvaro, Kit Barnes, Eduardo de Barros Lima, Mathieu Bouchard,
+Ole Jørgen Brønner, Robert Buchholz, Vincenzo Ciancia, Luca de Cicco,
+Michele Codutti, Robert Gerlach, Daniel German, Dirk Gerrits, Simon Guest,
+Lukasz Kaiser, Ian Woo Kim, Timo Kluck, David Kolibac, Danny Kukawka,
+Stefan Lembach, Bob McElrath, Andy Neitzke, David Planella, Marco Poletti,
+Alex Ray, Jean-Baptiste Rouquier, Victor Saase, Marco Souza, Mike Ter Louw,
+Uwe Winter, Lu Zhihe.
</p>
<p style="font-size:0.9em">(Let me know if you are missing from this list or
if your name is mis-spelled)</p>
<p>
-Xournal is distributed under the GNU General Public License.
+Xournal is distributed under the GNU General Public License (version 2, or
+at your option any later version).
</p>
<p style="font-size: 0.9em; font-style: italic">
<b>Note:</b> most of the code of version 0.4.2.1
<a name="changelog"></a>
<h2 class="subtitle">Version history</h2>
<p>
+Version 0.4.7 (July 4, 2012):
+<ul>
+ <li>insert image tool (based on patches by Victor Saase and Simon Guest)
+</li><li>renamed "Journal" menu to "Page"
+</li><li>paste images and text directly from and to other applications
+</li><li>lasso tool (based on patch by Ian Woo Kim)
+</ul>
+</p>
+<p>
+Version 0.4.6 (May 22, 2012):
+<ul>
+ <li>win32 portability code (contributed by Dirk Gerrits)
+</li><li>fix bug in PDF export code on 64-bit systems (patch by Robert Buchholz)
+</li><li>fix hand tool bug when exiting canvas (#2905711)
+</li><li>Italian translation (Marco Poletti), German translation (Stefan Lembach)
+</li><li>Spanish translation (Alvaro), Brazil Portuguese translation (Marco Souza)
+</li><li>fix save bug with text boxes containing > 4095 characters
+</li><li>Czech translation (David Kolibac), Dutch translation (Timo Kluck)
+</li><li>fix crash upon unplugging input devices
+</li><li>change close dialog box default to "save" (patch by Kit Barnes)
+</li><li>option to force PDF background rendering via cairo (slower but nicer)
+</li><li>wrapper for missing GdkPixbuf rendering function in newest poppler
+</li><li>disable GTK+ XInput bugfix by default (#3429416)
+</li><li>fix linker flags (#3208984); evdev coordinate fix (#3244118) (Timo Kluck)
+</li><li>specify license version: GPL v2 or later
+</li><li>fix 1.#J coordinates from win32 xoj files
+</li>
+</ul>
+</p>
+<p>
Version 0.4.5 (Oct 2, 2009):
<ul>
<li>bugfixes for GTK+ 2.16/2.17 issues with xinput events
no extraneous whitespace should be inserted between the enclosing tags
and the text itself).
</p>
+<p>Starting with version 0.4.7, layers can also contain image items.
+The format of an image item is:
+<pre><image left="..." top="..." right="..." bottom="...">... data ...</image>
+</pre>
+The <i>left</i>, <i>top</i>, <i>right</i> and <i>bottom</i> attributes
+specify the bounding box to which the image is scaled, in page coordinates
+(measured in points from the top-left corner). The data is in base64-encoded
+PNG format (though any other base64-encoded format that can be loaded by
+gdk-pixbuf is currently accepted).
<hr />
<a name="installation"></a>
<h2 class="subtitle">Installation issues</h2>
<p>
<b>Compilation and installation in /usr/local:</b>
<pre>
-./configure
+./autogen.sh
make
(as root) make install
(as root) make desktop-install
<p>
<b>Compilation and installation in $HOME:</b>
<pre>
+./autogen.sh
./configure --prefix=$HOME
make
make install
won't be detected anymore).
</p>
<p>
-I have also had a report that one of the workarounds used by Xournal to
-bypass a calibration bug in GTK+ can actually entirely prevent strokes
-from being drawn. If you are being unsuccessful at drawing in Xournal
-with XInput enabled, try recompiling after commenting out the line
+One of the workarounds used by Xournal to
+bypass a calibration bug in old versions of GTK+ seems to be more harmful
+than helpful with modern distributions. If you miss the old behavior or
+are having XInput issues, try recompiling after uncommenting the line
<pre>#define ENABLE_XINPUT_BUGFIX</pre>
near the beginning of <tt>src/xournal.h</tt>.
-If this modification does improve things for you, and if you have a bit
-of spare time to help investigate the causes of this problem, please
-contact me.
</p>
<h3 class="subsub">On-the-fly display rotation</h3>
<p>
</pre>
<b>Note #1:</b> you should not rotate the display while Xournal is running,
otherwise the tablet calibration in Xournal may (and most likely will)
-become incorrect.
+become incorrect. (Less likely to occur with modern distributions and
+ENABLE_XINPUT_BUGFIX disabled).
Exit Xournal and restart it after the display has been rotated.
</p>
<p>