xournal presentation mode

Errol Trebbin
Terms Of Use

Tuesday, June 5, 2012

Using xournal to annotate pdf presentations, i hope you find this blog enjoyable and helpful. support it with a small donation., support me and the blog with a small donation. i appreciate each one., no comments:, post a comment.

Note: Only a member of this blog may post a comment.

Xournal User's Manual

Version 0.4.8

Xournal is an application for notetaking, sketching, keeping a journal using a stylus. It is free software (GNU GPL) and runs on Linux (recent distributions) and other GTK+/Gnome platforms. It is similar to Microsoft Windows Journal or to other alternatives such as Jarnal and Gournal .

Xournal can be downloaded at http://xournal.sourceforge.net/ or http://math.berkeley.edu/~auroux/software/xournal/

Xournal aims to provide superior graphical quality (subpixel resolution) and overall functionality; however various advanced features have not been implemented yet.

Getting started, the drawing and selection tools, pages, layers, and backgrounds, configuration file, author information, license, bug-reports, version history, the file format.

Installation issues and tablet calibration issues

Xournal's user interface is (hopefully) intuitive, and if you don't run into installation or tablet calibration issues, you'll probably be able to start taking notes without referring to this manual. Here is a screenshot of the user interface (click to enlarge):

$xournal presentation mode$

Refer to the next few sections of this manual for more information about the various functionalities.

The pen is the default drawing tool in Xournal. It comes in a variety of colors (see the color toolbar buttons and the Color submenu of the Tools menu) and thicknesses (see the thickness toolbar buttons and the Pen Options submenu of the Tools menu).

Standard mode (default): the eraser deletes portions of strokes previously drawn using the pen or the highlighter. In this mode, if you erase in the middle of a stroke, the remaining portions of the stroke are automatically split into shorter strokes. The background of the page (and the lower layers) are not erased.
Whiteout: the eraser is actually a thick white pen, and simply covers whatever lies underneath, including the background of the page.
Delete strokes: whenever the eraser comes in contact with a previously drawn stroke, the entire stroke is deleted.

The highlighter

Like the pen, the highlighter comes in a variety of colors (the default is yellow) and thicknesses. Use the color and thickness toolbar buttons to change these settings.

The text tool

To insert a new text item, click at the location where the text is to be inserted on the page, then type it in or paste it using the contextual menu (note: no wrapping is performed). To modify a text item, click inside it. The font and point size can be modified using the "Text Font" command in the Tools menu (or the toolbar button). The color is the same as that currently selected for the pen (and can be modified using the toolbar buttons).

Text items can contain arbitrary Unicode characters, provided that a suitable font is installed on your system. However, languages written in a direction other than left-to-right might not be handled properly. If a journal contains some items in a font that is unavailable on your system, another one will be substituted. (Also, text items will be lost if the document is opened in a version of Xournal prior to 0.4). Finally, note that the printing and PDF export features only accept TrueType and Type 1 scalable fonts (do not use any bitmap fonts), and that the typesetting of the text may be slightly different in the printout.

The image tool

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.

The ruler is not a tool by itself, but rather a special operating mode of the pen and highlighter tools. When it is enabled, these tools paint line segments instead of curvy strokes. For simplicity, selecting the ruler when not in pen or highlighter mode automatically selects the pen.

The shape recognizer

The shape recognizer is also a special operating mode of the pen and highlighter tools. When it is enabled, Xournal attempts to recognize geometric shapes as they are drawn, and if successful will replace the drawn strokes accordingly. The shapes that can be recognized are: line segments, circles, rectangles, arrows, triangles and quadrilaterals. Polygonal shapes can be drawn in a single stroke or in a sequence of consecutive strokes.

The recognizer is set to be as unobtrusive as possible, and should not interfere too much with handwriting. (It differs in this and other ways from another shape recognizer written for Xournal by Lukasz Kaiser). As a result, it may only recognize shapes if you draw them carefully and deliberately. Specific tips for better recognition: (1) for circles, a closed curve that isn't quite round works better than a rounder curve that doesn't close; (2) for arrows, it is better to lift the pen before drawing the tip of the arrow, and make sure the tip consists of two straight line segments; (3) for very elongated rectangles, recognition tends to be better if you lift the pen between consecutive sides.

Default tools

Each tool (pen, eraser, highlighter, text) has a default setting (color, thickness, ... for the drawing tools, font and size for the text tool) associated to it. The "Default Pen", "Default Eraser", "Default Highlighter", and "Default Text" entries of the Tools menu select the appropriate tool and reset its settings to the defaults. The toolbar also includes a "Default" button which resets the currently selected tool to its default settings, and a "Default Pen" button. The "Set As Default" entry of the Tools menu takes the current settings of the currently selected tool and makes them the new default.

Thickness buttons

These three buttons control the thickness of the current drawing tool (pen, eraser, or highlighter). The thickness can also be adjusted using the appropriate sub-menu of the Tools menu.

Rectangle selection

This tool lets you select a rectangular region of the current layer. All the strokes which are entirely contained within the rectangular region are selected. The selection can be moved within its page by clicking inside the selection rectangle and dragging the cursor. If the cursor is dragged to a different page, the selection will be moved to the topmost layer of that page.

The selection can be cut, duplicated, etc. (including to a different page or to a different journal) using the copy-paste toolbar buttons or the corresponding entries of the Edit menu.

Lasso selection

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.

Vertical space

This tool lets you insert or remove vertical space within the page: all the items of the current layer which lie entirely between the cursor position and the end of the page are moved up or down.

Note that the background, and items on other layers, are not affected. Also, if you insert too much vertical space, some items may fall below the bottom of the page and become invisible. These items are not lost: to retrieve them, either use the vertical space tool again to remove the excess vertical space, or change the page height to an appropriate value (using the "Paper Size" entry in the Journal menu).

If you drag the cursor below the bottom of the page (so that the entire block being moved has become invisible), the items will be moved to the next page (topmost layer); however, any items that were already present on the next page are left unchanged. Similarly, dragging the cursor above the top of the page so that the entire block being moved becomes invisible results in the items being moved to the previous page.

This tool lets you browse the journal; dragging the cursor scrolls the view.

Undo and redo

All operations performed on the currently open journal (drawing, erasing, cut-and-paste; adding, deleting, and reformatting pages; etc.) can be undone and redone at will using the Undo and Redo toolbar buttons or the corresponding entries in the Edit menu. There is no limit to the depth of the undo/redo stack. It is cleared only when you quit the application or open a new journal.

Button mappings

Stylus buttons 2 and 3 (mouse middle and right buttons) can be mapped to different tools using the appropriate submenus in the Options menu (whereas the Tools menu and the toolbar buttons affect the primary tool assigned to button 1). The default mapping is the eraser.

Advanced configuration: if a secondary button is mapped to a drawing tool (pen, eraser, or highlighter), the default is to "dynamically link" its settings to those of the primary tool, which means that each drawing tool has common settings (color, thickness, etc.) for all buttons. Dynamic linking of brush settings can be disabled by selecting the "Copy of current brush" option in the "Button mapping" submenu. The settings of the tool for button 2 or 3 are copied from the button 1 settings at the time when you select the option, and afterwards they are no longer updated when the button 1 settings are modified, thus making it possible to assign pens of different colors or thicknesses to different buttons.

Another option that affects button mappings is the "Eraser tip" option. If this option is turned on and the XInput extensions are enabled, then the eraser tip of your tablet's stylus will automatically be remapped to the eraser tool. This behavior, which overrides all other button mappings, is most useful if your X server is configured to map the eraser tip of your tablet's stylus to button 1.

Also note the "Buttons switch mappings" option, which may be useful to users of external tablets: when this option is turned on, buttons 2 and 3 only switch the tool mapping, and drawing is still done with button 1.

A journal is composed of one or more pages, whose characteristics can be modified independently of each other. Each page consists of a background and one or more layers stacked on top of the background. All drawing operations take place within a single layer, and do not affect the background or the other layers. You can think of the layers as transparent overlays: drawing and erasing always takes place on the topmost visible overlay. Layers are a convenient mechanism to add temporary annotations on top of a journal page: because of the logical separation between layers, erasing in the top layer will not affect the contents of the other layers, and the top layer can be easily discarded.

Navigating the journal

The user interface either displays all pages in the journal below each other ("continuous mode") or a single page ("one-page mode"). You can switch between the two modes by using the "Continuous" and "One page" entries in the View menu. The default is the continuous mode, best adapted to note-taking on multiple pages. The one-page mode is more appropriate if your journal is a scrapbook in which the pages have different characteristics (in particular, if you are annotating a series of pictures of different sizes).

using the navigation toolbar buttons (or the corresponding entries in the View menu) to go back or forward one page, or to jump to the first or last page of the journal;
in continuous mode, scrolling down to the desired page;
entering a value or using the +/- buttons in the page selection box at the lower-left corner of the Xournal window.

Note: jumping to a page automatically selects the top-most layer in that page.

To navigate the layers of a page, either use the layer selection box at the bottom of the Xournal window, or use the "Show Layer" and "Hide Layer" entries in the View menu. The basic rule to remember is that the display shows all the layers underneath the currently select one, and while those above it are hidden.

Note: the background layer cannot be drawn on; any attempt to draw on the background will generate an error message and switch back to the first layer.

Managing pages and layers

Pages can be added to the journal by using the "New Page ..." entries in the Journal menu. The newly created page has the same format and background as the current page (for the "New Page Before" and "New Page After" commands), or as the last page of the journal (for "New Page At End"). Additionally, jumping to the next page when already on the last page creates a new page at the end of the journal.

The "Delete Page" entry in the Journal menu removes the current page from the journal. (Remember that you can always undo this operation if you deleted a page by accident).

The "New Layer" entry in the Journal menu creates a new layer immediately above the current one, while "Delete Layer" removes the current layer and its contents (if you attempt to delete the only layer of a page, a new empty layer will be automatically created).

Paper formats and backgrounds

The size of the current page can be modified using the "Paper Size" entry in the Journal menu. Standard and custom sizes are available.

The background is either one of several kinds of standard paper types, or a bitmap image, or a page of a PDF file.

To select a standard paper type as background for the current page, use the "Paper Style" submenu of the Journal menu. The paper color can also be changed using the "Paper Color" submenu of the Journal menu.

To use a PDF file as the background for a journal, see the paragraph on PDF annotation below.

To load a bitmap image file for use as background for the current page, use the "Load Background" entry of the Journal menu. This automatically resizes the current page according to the size of the bitmap image, and resets the zoom level to 100%. If ghostscript is installed on your system, you can also use this method to import a fixed-resolution bitmap version of a Postscript or PDF file; in that case, all pages will be imported sequentially as backgrounds into consecutive pages (this is not the recommended method; PDF annotation is better in every respect).

To capture a screenshot of a window or the entire screen and make it the background of the current page, use the "Background Screenshot" entry of the Journal menu. This will iconify the Xournal window; click in any window (after ensuring it is fully visible) to capture its contents, or click on the desktop (or screen background) to capture the entire screen.

Important note: by default, bitmap images loaded using the "Load Background" command will not be saved with the journal; instead, the journal file will contain a reference to the absolute location of the image file. This means that the background will become unavailable if the image file is moved or deleted. To avoid this, check the option "Attach file to the journal" at the bottom of the file selection dialog box. This option only applies to bitmap image files loaded from disk; screenshot backgrounds (and bitmaps converted from PS/PDF files using ghostscript) are automatically "attached" to the journal file: when the journal is saved, they will be saved (in PNG format) along with it (using file names of the form *.xoj.bg_*.png).

PDF annotation

Xournal can be used to annotate PDF files, by loading the pages of a PDF file as backgrounds for a journal. As of version 0.4.5 this is done using the poppler library (previous versions used the pdftoppm converter, which is part of the xpdf utilities or the poppler utilities depending on distributions).

The "Annotate PDF" command in the File menu can be used to load a PDF file into a new (empty) journal. The page backgrounds and page sizes correspond to the contents of the PDF file. (Most unencrypted PDF files should be supported).

Upon zooming, the page backgrounds are asynchronously updated to fit the current display resolution. Since this process is quite slow and memory-intensive, the pages are normally updated only as needed, when they become visible on the screen (unless you disable the "Progressive Backgrounds" option in the Options menu). This means that you will occasionally notice the page backgrounds being updated while you are scrolling inside the document (at large zoom levels, it can take a while for the updated background to appear).

It is strongly recommended that you do not resize PDF pages (using the "Paper Size" command). This will result in extremely ugly rendering, as the PDF converter is unable to render bitmaps with non-standard aspect ratios.

While you can perform all sorts of page operations on a journal file that was created from a PDF file (such as duplicating or deleting pages, inserting pages with blank or bitmapped backgrounds, ...), it is not possible to include pages from more than one PDF file into a single journal document. If you need to annotate two or more PDF files inside a same journal document, please consider using an external utility for merging PDF files (for example pdfmerge ).

Note: the PDF backgrounds are rescaled and/or regenerated as needed when the zoom level is changed. Because this consumes a lot of memory and CPU resources, by default this rescaling is performed on-demand as each page becomes visible. This means that you will occasionally notice backgrounds being generated while you are scrolling inside the document (at large zoom levels, this can slow down the screen refresh rate noticeably). If you'd prefer all backgrounds to be loaded in advance and rescaled immediately upon changing the zoom level, disable the "Progressive Backgrounds" option in the Options menu. Be aware that this increases the memory consumption and will cause out-of-memory crashes when viewing long documents.

As of version 0.4.5, Xournal uses the gtk-print architecture for printing (previous versions used gnome-print). Xournal also includes a native PDF printing feature.

Printing via gtk-print

The print dialog box lets you select a printer (either one of the printers installed on your system, or the "Print to File" virtual printer), and a range of pages to print (the default is to print the entire journal). Each page of the journal is automatically rescaled so as to fit the paper size.

Unlike the older gnome-print architecture, gtk-print and poppler make it possible to efficiently print files that annotate PDF backgrounds. (Prior to version 0.4.5, PDF backgrounds had to be converted to bitmaps upon printing, resulting in huge print jobs and low printout quality).

The settings are currently not saved properly from one print job to the next, so make sure to verify the settings.

Exporting to PDF

As of version 0.4.8, the "Export to PDF" command uses the poppler and cairo libraries to produce a PDF version of the currently loaded document. The pages of the resulting PDF file have the same size as in Xournal. Highlighter strokes are rendered in a partially transparent manner. Text items are rendered by embedding TrueType subsets or Type 1 fonts into the PDF document as appropriate.

Xournal still provides its own PDF rendering engine, which was the default up to version 0.4.7 and continues to be used if "Legacy PDF Export" is checked in the Options menu. This code includes a PDF file parser compatible with PDF format version 1.4; the compression features of PDF 1.5 are not supported. When exporting a document that uses PDF backgrounds, Xournal attempts to preserve most of the structure of the original PDF file (however, auxiliary data such as thumbnails, hyperlinks, and annotations are lost). If Xournal is unable to parse the PDF file, the poppler/cairo renderer is used instead to generate a new PDF file from scratch.

general display preferences: zoom level, window size, ...
default paper settings (as set by the "Set As Default" command in the Journal menu)
default settings for the pen, eraser, highlighter, and text tools (as set by the "Set As Default" command in the Tools menu)
mappings for buttons 2 and 3
the various preferences set in the Options menu
display_dpi: the display resolution in pixels per inch
initial_zoom: the initial zoom level, in percent
window_maximize: whether to start with a maximized window
window_fullscreen: whether to start in fullscreen mode
window_width, window_height: the preferred window size (if not maximized)
zoom_step_factor: the (multiplicative) factor by which the zoom in/zoom out buttons change the zoom level
view_continuous: whether to start in continuous or single-page view mode (see also View menu)
highlighter_opacity: the opacity level of highlighter strokes (from 0 to 1; 1 is fully opaque). Note that .xoj files do not store the opacity level of strokes, so if you change from the default value of 0.5 your files will look different when opened on another machine.
autosave_prefs: whether to automatically save preferences upon exiting Xournal.
interface_order: the position of the various toolbars relative to the drawing area, from top to bottom. The default order is: menu main_toolbar pen_toolbar drawarea statusbar . Switching elements around rearranges the interface. Removing elements from the list hides them.
interface_fullscreen: the same thing, but in fullscreen mode. For example, drawarea main_toolbar pen_toolbar would position the toolbars below the drawing area, and hide the menu and status bar. interface.
shorten_menus: whether to hide some little-used menu or toolbar items (see also "Shorten Menus" in Options menu)
shorten_menu_items: the list of interface items to hide when shorten_menus is enabled. Virtually everything in the interface can be hidden. A complete list of interface item ID names can be obtained by running the command grep id= xournal.glade in the base directory of the source code distribution.
default_path: the default path for the open/save dialog boxes (leave blank to use the current directory)
autoload_pdf_xoj: whether to load filename.pdf.xoj (if it exists) when the user opens filename.pdf (see also "Autoload .pdf.xoj" in Options menu)
use_xinput: whether to enable XInput extensions for high-resolution tablet input (see also "Use XInput" in Options menu)
discard_corepointer: whether to discard Core events when XInput extensions are enabled. Setting this to "false" should be safe.
use_erasertip: whether to always map the eraser tip of a stylus to the eraser (see also "Eraser Tip" in Options menu)
buttons_switch_mappings: whether to have buttons 2 and 3 switch the tool mapping instead of actually drawing (useful with some external tablets; see also "Buttons Switch Mappings" in Options menu)
pressure_sensitivity: whether to use stylus pressure to control stroke width (see also "Pressure Sensitivity" in Options menu)
width_minimum_multiplier, width_maximum_multiplier: the minimum and maximum width multipliers for pressure-sensitive strokes
width, height: the default paper size, in points (1 point = 1/72 in = 0.353 mm)
color: the default paper color (named color or #rrggbbaa)
style: the default paper style (plain, lined, ruled, or graph)
apply_all: whether paper style changes get applied to all pages (see also "Apply to all pages" in Journal menu)
print_ruling: whether to include the paper ruling lines when printing (see also "Print Paper Ruling" in Options menu)
progressive_bg: whether to generate PDF backgrounds just-in-time as pages become visible (rather than immediately upon opening the document or changing the zoom level, which is more memory-intensive); see also "Progressive Backgrounds" in Options menu
gs_bitmap_dpi: resolution (in dpi) of bitmap backgrounds generated from PS/PDF files when using "Load Background" in Journal menu; higher values mean higher quality but larger memory usage
pdftoppm_printing_dpi: resolution (in dpi) of bitmaps generated from PDF backgrounds when exporting to PDF (only used if the PDF parser is unable to process the background PDF file); higher values mean higher quality but larger output files
startup_tool: the tool selected at startup (one of: pen, eraser, highlighter, selectrect, vertspace, hand)
pen_color, pen_thickness, pen_ruler, pen_recognizer: the default pen settings: color (a named color or #rrggbbaa), thickness (fine = 1, medium = 2, thick = 3), ruler mode, recognizer mode
highlighter_color, highlighter_thickness, highlighter_ruler, highlighter_recognizer: the default highlighter settings
eraser_thickness, eraser_mode: the default eraser settings: thickness (fine = 1, medium = 2, thick = 3) and operating mode (standard = 0, whiteout = 1, delete strokes = 2)
btn2_tool, btn3_tool: the tools mapped to buttons 2 and 3 (can be: pen, eraser, highlighter, selectrect, vertspace, hand)
btn2_linked, btn3_linked: whether the settings of the tools for buttons 2 and 3 are linked to those of the corresponding primary tools
btn2_color, btn2_thickness, btn2_ruler, btn2_recognizer, btn2_erasermode: if the settings are not linked to the primary tool ( btn2_linked is false), the settings of the tool mapped to button 2. Not all entries are applicable, depending on the value of btn2_tool .
btn3_color, btn3_thickness, btn3_ruler, btn3_recognizer, btn3_erasermode: similarly for the button 3 tool.
pen_thicknesses, eraser_thicknesses, highlighter_thicknesses: the widths in points (1 pt = 1/72 in = 0.353 mm) of the various pens (5 values from 'very fine' to 'very thick'), erasers (3 values from 'fine' to 'thick') and highlighters (3 values from 'fine' to 'thick')
default_font, default_font_size: the name and point size of the default text font.

Xournal is written by Denis Auroux (aur oux @ math . berkeley.edu).

The source code includes contributions by the following people: Alvaro, Kit Barnes, Eduardo de Barros Lima, Mathieu Bouchard, Ole Jørgen Brønner, Robert Buchholz, William Chao, Vincenzo Ciancia, Luca de Cicco, Michele Codutti, Robert Gerlach, Daniel German, Dirk Gerrits, Simon Guest, Andreas Huettel, Lukasz Kaiser, Ian Woo Kim, Timo Kluck, David Kolibac, Danny Kukawka, Stefan Lembach, Bob McElrath, Mutse, Andy Neitzke, David Planella, Marco Poletti, Alex Ray, Jean-Baptiste Rouquier, Victor Saase, Hiroshi Saito, Luciano Siqueira, Marco Souza, Mike Ter Louw, Mis Uszatek, Uwe Winter, Edward Z. Yang, Lu Zhihe.

(Let me know if you are missing from this list or if your name is mis-spelled)

Xournal is distributed under the GNU General Public License (version 2, or at your option any later version).

Note: most of the code of version 0.4.2.1 (excluding graphics and a few portions of the code) has also been released under the MIT License. Please contact the main developer if you need an MIT License version of the 0.4.2.1 code. Later versions are not available under MIT License.

Feel free to contact me with bug reports and suggestions; I apologize in advance if I am unable to respond properly to some requests. If you find a sequence of operations which crashes Xournal in a reproducible manner, please send detailed instructions on how to reproduce the crash. A core file may also be helpful.

Bug reports and suggestions can also be submitted on Xournal's SourceForge page.

pen and touchscreen input handling bugfixes (bug #136 and others)
fix a minor bug with save file paths in Windows (D. German)
use GDK macros (not WIN32) to disable X11-specific code (T. Schoonjans)
export to PDF and printing: fix resolution loss on some pdf backgrounds
disable xinput during modal dialog boxes (bug #159)
avoid data corruption when exporting to overwrite a PDF
fix path search order for toolbar bitmaps
text and image tools activate on button release instead of button press to avoid subsequent confusion between clicks in toolbar and drawing area
fix "pen disable touch" when touchscreen sends prox events (A. Kittenberger)
fix crash when pasting text or images via xclip (bug #171)
updated Italian translation (Marco Ciampa)
add space and shift-space bindings to page down/up (D. German)
add A5 paper (D. German)
config option to export successive layers to separate PDF pages
config option to create new file when trying to open non-existent .xoj
option to auto-save documents and recover auto-saves (after Edward Yang, Aiwarrior, Timo Kluck)
new Export to PDF code using cairo (and config option to enable legacy code)
horizontal view mode
improved touchscreen handling
pencil cursor option (patch by Luciano Siqueira)
added "new pages duplicate background" option (new default is false)
updated Windows build and packaging instructions
ignore events from non-drawing devices by default (ignore_other_devices)
"touchscreen as hand tool" option (after Rumen Zarev and Daniel German)
"pen disables touchscreen" option; dialog box to designate touch device
tweaks to xinput event processing for touchscreens
generate cursors from pixbufs (fixes a Win32 bug)
work around Win32 bug: refuse paste if mismatched format
fix configure.in for automake-1.13 (Florian Bruhin, Andreas Huettel)
smoother icons for eraser and shapes buttons (by Colin Macdonald)
fix a cross-platform g_basename() issue (after Daniel German)
bugfix for file paths with non-English characters in Win32
add some margin around lasso selection rectangle (after Niklas Beisert)
warn for fontconfig cache generation in Win32
Chinese (simplified) translation (by Mutse)
updated German translation (Stefan Holtzhauer)
Polish translation (by Mis Uszatek)
Chinese (traditional) translation (William Chao)
Japanese translation (by Hiroshi Saito)
insert image tool (based on patches by Victor Saase and Simon Guest)
renamed "Journal" menu to "Page"
paste images and text directly from and to other applications
win32 portability code (contributed by Dirk Gerrits)
fix bug in PDF export code on 64-bit systems (patch by Robert Buchholz)
fix hand tool bug when exiting canvas (#2905711)
Italian translation (Marco Poletti), German translation (Stefan Lembach)
Spanish translation (Alvaro), Brazil Portuguese translation (Marco Souza)
fix save bug with text boxes containing > 4095 characters
Czech translation (David Kolibac), Dutch translation (Timo Kluck)
fix crash upon unplugging input devices
change close dialog box default to "save" (patch by Kit Barnes)
option to force PDF background rendering via cairo (slower but nicer)
wrapper for missing GdkPixbuf rendering function in newest poppler
disable GTK+ XInput bugfix by default (#3429416)
fix linker flags (#3208984); evdev coordinate fix (#3244118) (Timo Kluck)
specify license version: GPL v2 or later
fix 1.#J coordinates from win32 xoj files
bugfixes for GTK+ 2.16/2.17 issues with xinput events
various minor UI bugfixes
gettext internationalization (contributed by David Planella)
Catalan translation (by David Planella), French translation
use poppler instead of pdftoppm to render PDF backgrounds (after patches by Mike Ter Louw and Bob McElrath)
various improvements to UI and to key bindings (including patches by Bob McElrath and Lu Zhihe)
use gtk-print instead of libgnomeprint for printing
custom color chooser (patch contributed by Alex Ray)
option to have tablet buttons toggle the mapping rather than draw
paper color chooser (after a patch by Ole Joergen Broenner)
remove binary installer (due to binary incompatibilities)
UPDATED DEPENDENCIES: need gtk+ 2.10, poppler-glib 0.5.4
bugfix for #1926757 (crash upon pasting variable-width stroke)
bugfix: set ruler/recognizer setting to default upon switching tools
bugfixes for X.org 7.3; allow XInput and core events in reverse order
resize selection (patch contributed by Andy Neitzke)
pressure sensitive pen (variable stroke width) (patch by Andy Neitzke)
geometric shape recognizer (after an idea by Lukasz Kaiser) (see here )
clean up compiler warnings (patch contributed by Danny Kukawka)
bugfix: compatibility with new versions of pdftoppm (thanks to Vincenzo Ciancia)
GTK+ 2.11 event processing bugfix
minor bugfixes: hand tool, handling of filenames containing '&'
desktop and MIME files (thanks to Mathieu Bouchard) + updated installer
config options: left-handed scrollbar (contributed by Uwe Winter), hide some menu items (customizable in config file), auto-save preferences
bugfixes for GTK+ 2.11 behavior (thanks to everyone who reported bugs)
text tool (handles most TrueType and Type1 fonts)
font selection dialog and button
keyboard mappings (arrow keys)
menu mnemonics and shortcuts (suggestions by Jean-Baptiste Rouquier)
more responsive hand tool
bugfix for GTK+ 2.11 XInput behavior (thanks to Robert Gerlach)
various minor bugfixes and enhancements
bugfix: upon loading a new file, zoom is set to default startup zoom
config option to allow input from a mouse or other core pointer device
config file entry to specify a default location for open/save (patch contributed by Andy Neitzke)
config file entries to customize visibility and position of toolbars
icon (thanks to Michele Codutti)
preferences file and Save Preferences command
extra customization (via preferences file)
minor UI changes (patch contributed by Eduardo de Barros Lima)
hand tool (partially contributed by Vincenzo Ciancia)
a few bugfixes in rendering of bitmap backgrounds
fixed a file format bug on systems with non-standard numeric locale (bug reported by Gert Renckens)
new PDF rendering engine: export to PDF generates optimized files (smaller and more accurate)
export to PDF handles PDF backgrounds (up to PDF-1.4) natively (without conversion to bitmap)
default thickness of erasers and highlighters slightly increased
zoom dialog box with input box and "fit to page height" option
file format documentation added to the user's manual
mapping of tools to stylus buttons (the options menu has new entries to allow the mapping of buttons 2 and 3 to arbitrary tools; the tools menu and toolbar affect the settings for button 1) (see here )
moving selection by drag-and-drop works across page boundaries
vertical space tool can move items to next page (only when the entire block being moved has crossed the page boundary; items on the new page are not moved)
"apply to all pages" is now a toggle button affecting the behavior of paper size, color, and style commands
change in the behavior of the selection upon switching between tools
recently used files listed in file menu
can change color or thickness of pen strokes in selection
function to apply paper style to all pages
can specify on command line a PDF file to annotate
suggest a derived file name for PDF annotation
speed up switching between pages
fixed a bug in XInput initialization (thanks to Luca de Cicco)
fixed a bug in print ranges (thanks to Mathieu Bouchard)
fixed a refresh bug in rescaling bitmap backgrounds
PDF file annotation using xpdf's pdftoppm (PDF backgrounds updated asynchronously at all resolutions)
PS/PDF backgrounds (as bitmaps at fixed resolution) using ghostscript
option to antialias and filter bitmap backgrounds when zooming
option to emulate eraser tip with right mouse button
binary installer allows non-root installation without compiling
full-screen mode (patch contributed by Luca De Cicco)
two bugfixes
backward compatibility with GTK+ 2.4

Version 0.1 (January 2, 2006): initial release.

Overall structure

Xournal stores its data in gzipped XML-like files. The gzipped data consists of a succession of XML tags describing the document. By convention, the file header and trailer look like this: <?xml version="1.0" standalone="no"?> <xournal version="..."> <title>Xournal document - see http://math.mit.edu/~auroux/software/xournal/</title> ... sequence of pages ... </xournal> The <title> and <xournal> tags may only appear within the file header (not within the pages of the document). The version attribute of the <xournal> tag indicates which version of Xournal was used to create the document; it is currently ignored, but may be used in a later release if the file format changes in an incompatible manner. (Following a suggestion of Matteo Abrate, starting with version 0.4 the <xournal> tag is the document's root tag, and encloses all other tags).

The rest of the file is a sequence of pages, specified by a <page> tag, whose attributes width and height specify the physical size of the page in points (1/72 in). The width and height parameters are floating point values. The format of a page is therefore: <page width="..." height="..."> ... page contents ... </page>

Page background

Solid background: <background type="solid" color="..." style="..." /> The color attribute takes one of the standard values "white", "yellow", "pink", "orange", "blue", "green", or can specify a hexadecimal RGBA value in the format "#rrggbbaa". The style attribute takes one of the standard values "plain", "lined", "ruled", or "graph".

Bitmap background: <background type="pixmap" domain="..." filename="..." /> The domain attribute takes one of the standard values "absolute", "attach", or "clone". A value of "absolute" indicates that the bitmap is found in the file specified by filename . The bitmap can be in any format recognized by the gdk-pixbuf library; this includes most of the common bitmap formats (JPEG, PNG, BMP, GIF, PCX, PNM, TIFF, ...). A value of "attach" indicates that the bitmap is an attachment to the Xournal file. The bitmap is in PNG format, and resides in a file whose name is derived from that of the main Xournal file by appending to it a dot and the contents of the filename attribute. For example, if the Xournal file is in file.xoj and the filename attribute is "bg_1.png" then the bitmap file is file.xoj.bg_1.png (Xournal saves attached bitmaps sequentially in files ...bg_1.png, ...bg_2.png, etc.) A value of "clone" indicates that the bitmap is identical to the background of a previous page of the journal; the filename attribute then specifies the page number, starting with 0 for the first page. For example, if a filename value of "1" indicates that the background bitmap is identical to that of the second page.

PDF background: <background type="pdf" domain="..." filename="..." pageno="..." /> or <background type="pdf" pageno="..." /> The domain and filename attributes must be specified for the first page of the journal that uses a PDF background, and must be omitted subsequently for every other page that uses a PDF background. The domain attribute takes one of the standard values "absolute" and "attach"; the PDF document is to be found in the file specified by filename (if domain is "absolute"), or in the file whose name is obtained by appending a dot and the contents of the filename attribute to the name of the main Xournal file (if domain is "attach"). The pageno attribute specifies which page of the PDF file is used as background, starting with 1 for the first page of the PDF file.

Layers and strokes

After the line specifying the background, the remainder of a <page> section is occupied by one or more layer sections <layer> ... </layer> describing the various items within a layer. Every page must contain at least one layer; a layer may be empty. The successive layers are listed in their stacking order, from bottom to top.

A layer consists of a collection of items, listed in the order in which they should be drawn (from bottom-most to top-most). Up to version 0.3.3, the only legal contents within a layer are strokes. The format of a stroke is: <stroke tool="..." color="..." width="..."> ... list of coordinates ... </stroke> The tool attribute can take the values "pen", "highlighter", or "eraser" depending on the tool used to create the stroke (pen, highlighter, or whiteout eraser); a value of "highlighter" indicates that the stroke should be painted in a partially transparent manner (Xournal uses an alpha coefficient of 0.5).

The color attribute can take one of the standard values "black", "blue", "red", "green", "gray", "lightblue", "lightgreen", "magenta", "orange", "yellow", "white", or can specify a hexadecimal RGBA value in the format "#rrggbbaa".

The width attribute is a floating-point number (or a sequence of floating-point numbers starting with version 0.4.2), and specifies the width of the stroke in points (1/72 in). (For a variable-width stroke, the width attribute contains a whitespace-separated succession of floating-point values: first the nominal brush width, and then the width of each successive segment forming the stroke.)

The list of coordinates is simply a succession of floating-point values, separated by whitespace. The number of given values must be even; consecutive pairs of values give the x and y coordinates of each point along the stroke. These values are expressed in points (1/72 in). The coordinates (0,0) represent the top-left corner of the page: hence x is measured from the left of the page, and y is measured from the top of the page.

Every stroke must contain at least two points (four floating point values). Moreover, two consecutive points on the stroke should be spaced no more than 5 units apart or so; longer line segments should be subdivided as appropriate (otherwise the eraser tool will not interact properly with the stroke). The default precision used by Xournal for the x,y coordinates is 0.01 unit (1/7200 in).

Starting with version 0.4, layers also contain text items. The format of a text item is: <text font="..." size="..." x="..." y="..." color="...">... text ...</text> The font attribute contains the font name, for example "Serif Bold Italic"; if the font is not available, another font will be substituted. The size attribute specifies the font size in points. The x and y attributes specify the coordinates of the top-left corner of the text box in page coordinates (measured in points from the top-left corner of the page). Finally, the color attribute contains either the name of a standard color or a hexadecimal RGBA value (see above).

The contents of the text are encoded in UTF-8, with the characters '&', '<', '>' replaced by &, <, > . Whitespace and linefeeds are preserved (in particular, no extraneous whitespace should be inserted between the enclosing tags and the text itself).

Installation issues

Dependencies.

the gtk+ libraries, version 2.10 or later (package gtk2 and dependencies)
libgnomecanvas version 2.4 or later (package libgnomecanvas and dependencies)
poppler-glib version 0.5.4 or later (package poppler-glib and dependencies)
ghostscript (optional: used to import PS/PDF files as bitmap backgrounds)

To compile Xournal, you also need the development packages for the above libraries (packages gtk2-devel, libgnomecanvas-devel, poppler-glib-devel, and dependencies), as well as autoconf and automake .

Compilation and installation procedure

Download the Xournal distribution tar.gz file, and any needed dependencies.

Compilation and installation in /usr/local: ./autogen.sh make (as root) make install (as root) make desktop-install

Compilation and installation in $HOME: ./autogen.sh ./configure --prefix=$HOME make make install make home-desktop-install

Configure error message: If configure generates the error message configure: error: Package requirements (gtk+-2.0 >= 2.10.0 libgnomecanvas-2.0 >= 2.4.0 poppler-glib >= 0.5.4) not met even though you have sufficiently recent versions of these libraries on your system, then you need to install some missing development packages.

Tablet calibration issues

Configuring the tablet devices properly is unfortunately not as simple as it ought to be. This is a subject worthy of a detailed how-to document; meanwhile, here are some hints about how to configure your tablet.

Xournal uses the XInput extension to obtain high-resolution coordinates for strokes drawn using the stylus. If you decide that getting just the right XInput configuration isn't worth the effort, you can disable XInput features by unsetting the "Use XInput" option in the Options menu. The price to pay is a lower graphics quality, as the resolution of all strokes then drops to 1 pixel (instead of the native resolution of the tablet device, which can be higher by several orders of magnitude).

The configuration of tablet devices is controlled in the X server's configuration file (usually /etc/X11/xorg.conf depending on your distribution). The latest X servers can detect a tablet automatically and do not require the presence of xorg.conf to work properly; so recent distributions typically no longer includde such a file. However, if auto-configuration fails, you can always create a xorg.conf that explicitly specifies tablet devices.

Assuming you do have a xorg.conf, the ServerLayout section should contain lines like: Section "ServerLayout" ... InputDevice "cursor" "SendCoreEvents" InputDevice "stylus" "SendCoreEvents" InputDevice "eraser" "SendCoreEvents" EndSection (the last one only if your stylus has an eraser tip), and your configuration file should include sections such as Section "InputDevice" Identifier "cursor" Driver "wacom" Option "Device" "/dev/ttyS0" Option "Type" "cursor" Option "ForceDevice" "ISDV4" Option "BottomX" "28800" Option "BottomY" "21760" Option "Mode" "absolute" EndSection Section "InputDevice" Identifier "stylus" Driver "wacom" Option "Device" "/dev/ttyS0" Option "Type" "stylus" Option "ForceDevice" "ISDV4" Option "BottomX" "28800" Option "BottomY" "21760" Option "Mode" "absolute" EndSection Section "InputDevice" Identifier "eraser" Driver "wacom" Option "Device" "/dev/ttyS0" Option "Type" "eraser" Option "ForceDevice" "ISDV4" Option "BottomX" "28800" Option "BottomY" "21760" Option "Mode" "absolute" EndSection The actual settings will depend on your hardware; look on the web for Linux installation instructions specific to your model: for example, the "Device" settings above correspond to a serial port protocol, many tablets use USB instead; the BottomX and BottomY values correspond to the physical resolution of the tablet and will vary from one model to another.

For historical reasons, most X servers do not allow the input device designated as the "core pointer" in the X server's configuration file to be used as an XInput extension device. Thus, your tablet input devices should not be designated as the core pointer device. Instead, they should be configured with the "SendCoreEvents" option, which enables them to simultaneously generate XInput extension events and move the cursor on the screen.

If you have a newer X server and no xorg.conf file, the input devices can be configured using the xinput command.

Note: with older X servers, only tablet devices are XInput devices, while a built-in pointing device or an external mouse would only act as the core pointer. In newer X servers, all devices are handled through XInput (even though without advanced capabilities), though mice and touchpads typically send invalid event data. Xournal tries to work around the most common bugs in input device drivers and GTK+ input event processing.

The cursor doesn't appear in the right place...

If the mouse pointer does not follow accurately the position of the stylus, this is an indication that your tablet is not properly calibrated. If you have the linuxwacom package, you can try modifying the tablet calibration using xsetwacom . The relevant parameters are named TopX, BottomX, TopY, BottomY, and need to be set separately for the stylus and for the eraser. For example: xsetwacom set stylus TopX 270 xsetwacom set stylus BottomX 28510 ... (the TopX and TopY parameters default to 0 if you haven't set them in your X server's configuration file). Experiment with these parameters until you find the right calibration settings for your tablet (i.e., the mouse pointer appears right under the tip of the stylus).

Once you have found the perfect settings for your tablet, update your X server's configuration file or startup scripts.

Important: on older systems, the TopX and TopY values should always be kept at 0 to avoid calibration bugs.

The cursor is in the right place, but strokes aren't drawn under the cursor...

If you don't have a tablet, simply disable "Use XInput" in the Options menu, this is the fastest way of fixing the problem.
Upgrade to a recent version of Xournal (0.4.5 or later). Older versions of Xournal are not compatible with the event handling code of recent X server and GTK+ library versions.
Check that the "Discard Core Events" option is disabled ( discard_corepointer should be set to false in ~/.xournal/config).
If you are using an obsolete version of the linuxwacom driver (before 0.7.6) or of GTK+, please upgrade your system.
If you are using GTK+ 2.17 or newer, please upgrade to Xournal 0.4.5 or later. The input event processing behavior of GTK+ has changed and is no longer compatible with older versions of Xournal.
The display geometry might have changed since the beginning of your session in Xournal (resolution changed, external monitor connected, display rotated, etc.). You need to exit Xournal and re-start it each time your display configuration changes.
Your tablet devices might be incorrectly calibrated or configured.

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 #define ENABLE_XINPUT_BUGFIX near the beginning of src/xournal.h .

On-the-fly display rotation

You need an X server that supports the RANDR extension, and a sufficiently recent (0.7.6 or later) version of the linuxwacom driver to support on-the-fly rotation.

To set the tablet in portrait mode: xrandr -o 3 xsetwacom set stylus Rotate cw To return to landscape mode: xrandr -o 0 xsetwacom set stylus Rotate none Note #1: you should not rotate the display while Xournal is running, otherwise the tablet calibration in Xournal may (and most likely will) 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.

Xournal User's Manual

Version 0.4.7

Xournal can be downloaded at http://xournal.sourceforge.net/ or http://math.berkeley.edu/~auroux/software/xournal/

Xournal aims to provide superior graphical quality (subpixel resolution) and overall functionality; however various advanced features have not been implemented yet.

Getting started, the drawing and selection tools, pages, layers, and backgrounds, configuration file, author information, license, bug-reports, version history, the file format.

Installation issues and tablet calibration issues

$xournal presentation mode$

Refer to the next few sections of this manual for more information about the various functionalities.

Standard mode (default): the eraser deletes portions of strokes previously drawn using the pen or the highlighter. In this mode, if you erase in the middle of a stroke, the remaining portions of the stroke are automatically split into shorter strokes. The background of the page (and the lower layers) are not erased.
Whiteout: the eraser is actually a thick white pen, and simply covers whatever lies underneath, including the background of the page.
Delete strokes: whenever the eraser comes in contact with a previously drawn stroke, the entire stroke is deleted.

The highlighter

Like the pen, the highlighter comes in a variety of colors (the default is yellow) and thicknesses. Use the color and thickness toolbar buttons to change these settings.

The text tool

The image tool

The shape recognizer

Default tools

Thickness buttons

These three buttons control the thickness of the current drawing tool (pen, eraser, or highlighter). The thickness can also be adjusted using the appropriate sub-menu of the Tools menu.

Rectangle selection

The selection can be cut, duplicated, etc. (including to a different page or to a different journal) using the copy-paste toolbar buttons or the corresponding entries of the Edit menu.

Lasso selection

Vertical space

This tool lets you insert or remove vertical space within the page: all the items of the current layer which lie entirely between the cursor position and the end of the page are moved up or down.

This tool lets you browse the journal; dragging the cursor scrolls the view.

Undo and redo

Button mappings

Navigating the journal

using the navigation toolbar buttons (or the corresponding entries in the View menu) to go back or forward one page, or to jump to the first or last page of the journal;
in continuous mode, scrolling down to the desired page;
entering a value or using the +/- buttons in the page selection box at the lower-left corner of the Xournal window.

Note: jumping to a page automatically selects the top-most layer in that page.

Note: the background layer cannot be drawn on; any attempt to draw on the background will generate an error message and switch back to the first layer.

Managing pages and layers

The "Delete Page" entry in the Journal menu removes the current page from the journal. (Remember that you can always undo this operation if you deleted a page by accident).

Paper formats and backgrounds

The size of the current page can be modified using the "Paper Size" entry in the Journal menu. Standard and custom sizes are available.

The background is either one of several kinds of standard paper types, or a bitmap image, or a page of a PDF file.

To use a PDF file as the background for a journal, see the paragraph on PDF annotation below.

PDF annotation

As of version 0.4.5, Xournal uses the gtk-print architecture for printing (previous versions used gnome-print). Xournal also includes a native PDF printing feature.

Printing via gtk-print

The settings are currently not saved properly from one print job to the next, so make sure to verify the settings.

Exporting to PDF

Xournal also provides its own PDF rendering engine. The "Export to PDF" command (in the File menu) produces a PDF-1.4 file from the currently loaded document. The pages of the resulting PDF file have the same size as in Xournal. Highlighter strokes are rendered in a partially transparent manner (note however that applications such as xpdf and ghostview do not always handle PDF transparency properly). Text items are rendered by embedding TrueType subsets or Type 1 fonts into the PDF document as appropriate.

Xournal includes a PDF file parser compatible with PDF format version 1.4; the compression features of PDF 1.5 are not supported. When exporting a document that uses PDF backgrounds, Xournal attempts to preserve most of the structure of the original PDF file (however, auxiliary data such as thumbnails, hyperlinks, and annotations are lost). If Xournal is unable to parse the PDF file, the backgrounds are converted to (compressed) bitmaps and a new PDF file is generated from scratch.

general display preferences: zoom level, window size, ...
default paper settings (as set by the "Set As Default" command in the Journal menu)
default settings for the pen, eraser, highlighter, and text tools (as set by the "Set As Default" command in the Tools menu)
mappings for buttons 2 and 3
the various preferences set in the Options menu
display_dpi: the display resolution in pixels per inch
initial_zoom: the initial zoom level, in percent
window_maximize: whether to start with a maximized window
window_fullscreen: whether to start in fullscreen mode
window_width, window_height: the preferred window size (if not maximized)
zoom_step_factor: the (multiplicative) factor by which the zoom in/zoom out buttons change the zoom level
view_continuous: whether to start in continuous or single-page view mode (see also View menu)
highlighter_opacity: the opacity level of highlighter strokes (from 0 to 1; 1 is fully opaque). Note that .xoj files do not store the opacity level of strokes, so if you change from the default value of 0.5 your files will look different when opened on another machine.
autosave_prefs: whether to automatically save preferences upon exiting Xournal.
interface_order: the position of the various toolbars relative to the drawing area, from top to bottom. The default order is: menu main_toolbar pen_toolbar drawarea statusbar . Switching elements around rearranges the interface. Removing elements from the list hides them.
interface_fullscreen: the same thing, but in fullscreen mode. For example, drawarea main_toolbar pen_toolbar would position the toolbars below the drawing area, and hide the menu and status bar. interface.
shorten_menus: whether to hide some little-used menu or toolbar items (see also "Shorten Menus" in Options menu)
shorten_menu_items: the list of interface items to hide when shorten_menus is enabled. Virtually everything in the interface can be hidden. A complete list of interface item ID names can be obtained by running the command grep id= xournal.glade in the base directory of the source code distribution.
default_path: the default path for the open/save dialog boxes (leave blank to use the current directory)
autoload_pdf_xoj: whether to load filename.pdf.xoj (if it exists) when the user opens filename.pdf (see also "Autoload .pdf.xoj" in Options menu)
use_xinput: whether to enable XInput extensions for high-resolution tablet input (see also "Use XInput" in Options menu)
discard_corepointer: whether to discard Core events when XInput extensions are enabled. Setting this to "false" should be safe.
use_erasertip: whether to always map the eraser tip of a stylus to the eraser (see also "Eraser Tip" in Options menu)
buttons_switch_mappings: whether to have buttons 2 and 3 switch the tool mapping instead of actually drawing (useful with some external tablets; see also "Buttons Switch Mappings" in Options menu)
pressure_sensitivity: whether to use stylus pressure to control stroke width (see also "Pressure Sensitivity" in Options menu)
width_minimum_multiplier, width_maximum_multiplier: the minimum and maximum width multipliers for pressure-sensitive strokes
width, height: the default paper size, in points (1 point = 1/72 in = 0.353 mm)
color: the default paper color (named color or #rrggbbaa)
style: the default paper style (plain, lined, ruled, or graph)
apply_all: whether paper style changes get applied to all pages (see also "Apply to all pages" in Journal menu)
print_ruling: whether to include the paper ruling lines when printing (see also "Print Paper Ruling" in Options menu)
progressive_bg: whether to generate PDF backgrounds just-in-time as pages become visible (rather than immediately upon opening the document or changing the zoom level, which is more memory-intensive); see also "Progressive Backgrounds" in Options menu
gs_bitmap_dpi: resolution (in dpi) of bitmap backgrounds generated from PS/PDF files when using "Load Background" in Journal menu; higher values mean higher quality but larger memory usage
pdftoppm_printing_dpi: resolution (in dpi) of bitmaps generated from PDF backgrounds when exporting to PDF (only used if the PDF parser is unable to process the background PDF file); higher values mean higher quality but larger output files
startup_tool: the tool selected at startup (one of: pen, eraser, highlighter, selectrect, vertspace, hand)
pen_color, pen_thickness, pen_ruler, pen_recognizer: the default pen settings: color (a named color or #rrggbbaa), thickness (fine = 1, medium = 2, thick = 3), ruler mode, recognizer mode
highlighter_color, highlighter_thickness, highlighter_ruler, highlighter_recognizer: the default highlighter settings
eraser_thickness, eraser_mode: the default eraser settings: thickness (fine = 1, medium = 2, thick = 3) and operating mode (standard = 0, whiteout = 1, delete strokes = 2)
btn2_tool, btn3_tool: the tools mapped to buttons 2 and 3 (can be: pen, eraser, highlighter, selectrect, vertspace, hand)
btn2_linked, btn3_linked: whether the settings of the tools for buttons 2 and 3 are linked to those of the corresponding primary tools
btn2_color, btn2_thickness, btn2_ruler, btn2_recognizer, btn2_erasermode: if the settings are not linked to the primary tool ( btn2_linked is false), the settings of the tool mapped to button 2. Not all entries are applicable, depending on the value of btn2_tool .
btn3_color, btn3_thickness, btn3_ruler, btn3_recognizer, btn3_erasermode: similarly for the button 3 tool.
pen_thicknesses, eraser_thicknesses, highlighter_thicknesses: the widths in points (1 pt = 1/72 in = 0.353 mm) of the various pens (5 values from 'very fine' to 'very thick'), erasers (3 values from 'fine' to 'thick') and highlighters (3 values from 'fine' to 'thick')
default_font, default_font_size: the name and point size of the default text font.

Xournal is written by Denis Auroux (aur oux @ math . berkeley.edu).

The source code includes contributions by the following people: 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.

(Let me know if you are missing from this list or if your name is mis-spelled)

Xournal is distributed under the GNU General Public License (version 2, or at your option any later version).

Bug reports and suggestions can also be submitted on Xournal's SourceForge page.

insert image tool (based on patches by Victor Saase and Simon Guest)
renamed "Journal" menu to "Page"
paste images and text directly from and to other applications
win32 portability code (contributed by Dirk Gerrits)
fix bug in PDF export code on 64-bit systems (patch by Robert Buchholz)
fix hand tool bug when exiting canvas (#2905711)
Italian translation (Marco Poletti), German translation (Stefan Lembach)
Spanish translation (Alvaro), Brazil Portuguese translation (Marco Souza)
fix save bug with text boxes containing > 4095 characters
Czech translation (David Kolibac), Dutch translation (Timo Kluck)
fix crash upon unplugging input devices
change close dialog box default to "save" (patch by Kit Barnes)
option to force PDF background rendering via cairo (slower but nicer)
wrapper for missing GdkPixbuf rendering function in newest poppler
disable GTK+ XInput bugfix by default (#3429416)
fix linker flags (#3208984); evdev coordinate fix (#3244118) (Timo Kluck)
specify license version: GPL v2 or later
fix 1.#J coordinates from win32 xoj files
bugfixes for GTK+ 2.16/2.17 issues with xinput events
various minor UI bugfixes
gettext internationalization (contributed by David Planella)
Catalan translation (by David Planella), French translation
use poppler instead of pdftoppm to render PDF backgrounds (after patches by Mike Ter Louw and Bob McElrath)
various improvements to UI and to key bindings (including patches by Bob McElrath and Lu Zhihe)
use gtk-print instead of libgnomeprint for printing
custom color chooser (patch contributed by Alex Ray)
option to have tablet buttons toggle the mapping rather than draw
paper color chooser (after a patch by Ole Joergen Broenner)
remove binary installer (due to binary incompatibilities)
UPDATED DEPENDENCIES: need gtk+ 2.10, poppler-glib 0.5.4
bugfix for #1926757 (crash upon pasting variable-width stroke)
bugfix: set ruler/recognizer setting to default upon switching tools
bugfixes for X.org 7.3; allow XInput and core events in reverse order
resize selection (patch contributed by Andy Neitzke)
pressure sensitive pen (variable stroke width) (patch by Andy Neitzke)
geometric shape recognizer (after an idea by Lukasz Kaiser) (see here )
clean up compiler warnings (patch contributed by Danny Kukawka)
bugfix: compatibility with new versions of pdftoppm (thanks to Vincenzo Ciancia)
GTK+ 2.11 event processing bugfix
minor bugfixes: hand tool, handling of filenames containing '&'
desktop and MIME files (thanks to Mathieu Bouchard) + updated installer
config options: left-handed scrollbar (contributed by Uwe Winter), hide some menu items (customizable in config file), auto-save preferences
bugfixes for GTK+ 2.11 behavior (thanks to everyone who reported bugs)
text tool (handles most TrueType and Type1 fonts)
font selection dialog and button
keyboard mappings (arrow keys)
menu mnemonics and shortcuts (suggestions by Jean-Baptiste Rouquier)
more responsive hand tool
bugfix for GTK+ 2.11 XInput behavior (thanks to Robert Gerlach)
various minor bugfixes and enhancements
bugfix: upon loading a new file, zoom is set to default startup zoom
config option to allow input from a mouse or other core pointer device
config file entry to specify a default location for open/save (patch contributed by Andy Neitzke)
config file entries to customize visibility and position of toolbars
icon (thanks to Michele Codutti)
preferences file and Save Preferences command
extra customization (via preferences file)
minor UI changes (patch contributed by Eduardo de Barros Lima)
hand tool (partially contributed by Vincenzo Ciancia)
a few bugfixes in rendering of bitmap backgrounds
fixed a file format bug on systems with non-standard numeric locale (bug reported by Gert Renckens)
new PDF rendering engine: export to PDF generates optimized files (smaller and more accurate)
export to PDF handles PDF backgrounds (up to PDF-1.4) natively (without conversion to bitmap)
default thickness of erasers and highlighters slightly increased
zoom dialog box with input box and "fit to page height" option
file format documentation added to the user's manual
mapping of tools to stylus buttons (the options menu has new entries to allow the mapping of buttons 2 and 3 to arbitrary tools; the tools menu and toolbar affect the settings for button 1) (see here )
moving selection by drag-and-drop works across page boundaries
vertical space tool can move items to next page (only when the entire block being moved has crossed the page boundary; items on the new page are not moved)
"apply to all pages" is now a toggle button affecting the behavior of paper size, color, and style commands
change in the behavior of the selection upon switching between tools
recently used files listed in file menu
can change color or thickness of pen strokes in selection
function to apply paper style to all pages
can specify on command line a PDF file to annotate
suggest a derived file name for PDF annotation
speed up switching between pages
fixed a bug in XInput initialization (thanks to Luca de Cicco)
fixed a bug in print ranges (thanks to Mathieu Bouchard)
fixed a refresh bug in rescaling bitmap backgrounds
PDF file annotation using xpdf's pdftoppm (PDF backgrounds updated asynchronously at all resolutions)
PS/PDF backgrounds (as bitmaps at fixed resolution) using ghostscript
option to antialias and filter bitmap backgrounds when zooming
option to emulate eraser tip with right mouse button
binary installer allows non-root installation without compiling
full-screen mode (patch contributed by Luca De Cicco)
two bugfixes
backward compatibility with GTK+ 2.4

Version 0.1 (January 2, 2006): initial release.

Overall structure

Page background

Layers and strokes

Installation issues

Dependencies.

the gtk+ libraries, version 2.10 or later (package gtk2 and dependencies)
libgnomecanvas version 2.4 or later (package libgnomecanvas and dependencies)
poppler-glib version 0.5.4 or later (package poppler-glib and dependencies)
ghostscript (optional: used to import PS/PDF files as bitmap backgrounds)

Compilation and installation procedure

Download the Xournal distribution tar.gz file, and any needed dependencies.

Compilation and installation in /usr/local: ./autogen.sh make (as root) make install (as root) make desktop-install

Compilation and installation in $HOME: ./autogen.sh ./configure --prefix=$HOME make make install make home-desktop-install

Tablet calibration issues

If you have a newer X server and no xorg.conf file, the input devices can be configured using the xinput command.

The cursor doesn't appear in the right place...

Once you have found the perfect settings for your tablet, update your X server's configuration file or startup scripts.

Important: on older systems, the TopX and TopY values should always be kept at 0 to avoid calibration bugs.

The cursor is in the right place, but strokes aren't drawn under the cursor...

If you don't have a tablet, simply disable "Use XInput" in the Options menu, this is the fastest way of fixing the problem.
Upgrade to a recent version of Xournal (0.4.5 or later). Older versions of Xournal are not compatible with the event handling code of recent X server and GTK+ library versions.
Check that the "Discard Core Events" option is disabled ( discard_corepointer should be set to false in ~/.xournal/config).
If you are using an obsolete version of the linuxwacom driver (before 0.7.6) or of GTK+, please upgrade your system.
If you are using GTK+ 2.17 or newer, please upgrade to Xournal 0.4.5 or later. The input event processing behavior of GTK+ has changed and is no longer compatible with older versions of Xournal.
The display geometry might have changed since the beginning of your session in Xournal (resolution changed, external monitor connected, display rotated, etc.). You need to exit Xournal and re-start it each time your display configuration changes.
Your tablet devices might be incorrectly calibrated or configured.

On-the-fly display rotation

You need an X server that supports the RANDR extension, and a sufficiently recent (0.7.6 or later) version of the linuxwacom driver to support on-the-fly rotation.

Apps & Updates

Photon Camera

Photon studio is a new pro tool to streamline image presentation and management.

Developer LateNiteSoft launched its pro photography app for iPhone in 2023 called Photon Camera and has been upgrading it regularly . Now a new companion app has arrived for professionals who want a seamless solution for image display and management.

LateNiteSoft launched and detailed the new app on its blog today :

Photon Studio is more than just another app – it’s a game-changer for photographers seeking quick and efficient image management. Built specifically for users of Photon Camera on iOS devices, it bridges the gap between capturing stunning photos and displaying them with ease. Let’s delve into what makes Photon Studio a must-have addition to your photography toolkit.

Photon Studio works with iPad, Apple Silicon Macs, and external displays to immediately show what you’re capturing with Photon Camera.

LateNiteSoft says you get the ability to zoom in, view the histogram, favorite images, and even delete shots with Photon Studio.

One Apple device running Photon Camera can even send images to multiple devices running Photon Studio if you need a more robust and dynamic setup.

For those who have already purchased or are subscribed to Photon Camera, Photon Studio is a free download .

Check out more details in the announcement post .

FTC: We use income earning auto affiliate links. More.

Check out 9to5Mac on YouTube for more Apple news:

Michael is an editor for 9to5Mac. Since joining in 2016 he has written more than 3,000 articles including breaking news, reviews, and detailed comparisons and tutorials.

Michael Potuck's favorite gear

Satechi USB-C Charger (4 ports)

Really useful USB-C + USB-A charger for home/work and travel.

Apple Leather MagSafe Wallet

My slim wallet of choice for iPhone 12

Manage push notifications

Working With PDF Files
File Locations
Report a bug

Choose Your Version

(Recommended)

Suits most users with its focus on stability.

Get new features as soon as they're implemented, in exchange for stability.

Installing Xournal++ is really easy

Unzip archive which should be named something like xournalpp-{version}-windows.zip
Run the setup program contained in xournalpp-{version}-windows.zip
Follow the installation steps

As a free and open-source software, Xournal++ can also be compiled from source. If you prefer to do so, follow this guide in our Github page.

Saved searches

Use saved searches to filter your results more quickly.

To see all available qualifiers, see our documentation .

Notifications

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement . We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Presentation Mode not really working #671

andreasb242 commented Jan 1, 2019

👍 1 reaction

Successfully merging a pull request may close this issue.

COMMENTS

Allow pages to be 100% fullscreen in presentation mode #2025
By setting XOURNAL_PADDING and XOURNAL_PADDING_BETWEEN to 0 and removing the + 14.0 in ZoomControl.cpp, most of the extra space is gone. This is almost a fix, but: XOURNAL_PADDING is obviously used in the other modes, so setting it to zero should be conditional on being in presentation mode.
Using Xournal to Annotate PDF Presentations
Adding diagrams and notes to a PDF document while doing a presentation can be difficult. This tutorial shows how to configure and use Xournal to annotate PDF...
Overview
User Guide. This is a guide for learning how to use Xournal++. If you're a beginner, see the Whirlwind Tour. If you're looking for information on specific topics, look for your topic in the sidebar or use the search bar at the top of the page. Previous Linux.
Annotating a PDF presentation with a Wacom graphics tablet in Linux
There are two more answers to this question: Use the Full Screen mode of Xournal: View--> Full Screen.In addition, turn on One Page view: View--> One Page.. If you want to get rid of the toolbars, you have to manually edit ~/.xournal/config (in case it is not existing, simply save your configuration from within Xournal: Options--> Save Preferences).Look for the following line:
Using Xournal to Annotate PDF Presentations
Using a combination of Xournal and PDF documents you can streamline the process. Have your presentation done before hand, if you feel the need to clarify a concept or add other relevant notes you can do that while you're presenting, at the end save the file and upload it to the internet. This allows people viewing your presentation to focus on ...
How to annotate PDF presentation using Xournal
How to annotate Beamer presentation using XournalHow to take notes while displaying PDF presentation and save the annotated pdf presentation...
Preferences
By default, Xournal++ will guess the "class" of each physical input device that is recognized by your computer. Sometimes the guess will be wrong (e.g., if your stylus is detected as a touchscreen), in which case you may need to manually override device class in the Input Devices section. (guessed device type), one per line.
Working With PDF Files
Attach mode¶. If you use File > Annotate PDF to create a new journal, you can check the Attach file to the journal checkbox to enable "attach mode". When attach mode is enabled for a journal, the PDF file will always be copied to the same directory as the .xopp file when saving, even if the .xopp file is moved. Futhermore, the journal file will store a relative path to the PDF file.
Xournal / Feature Requests / #224 Simple Presentation Mode
Private: No. Currently, Xournal only has a fullscreen mode. This is not really suitable for presentations. For example, pressing F11 doesn't switch to "single page" mode, i.e., one may scroll through the pages and see half of one page and half of the other. Also, the page is not zoomed to the right degree. Pressing F11 keeps whatever the zoom ...
User Manual · xournalpp/xournalpp Wiki · GitHub
Introduction. Xournal++ is a notetaking and PDF annotation tool that is based on Xournal but written from scratch in C++, using GTK3 instead of GTK2. It supports pressure sensitive pens (e.g. Wacom), text input, image input, LaTeX formula entry as well as a number of other useful features such as shape recognition and layers.
Xournal User's manual
Xournal is an application for notetaking, sketching, keeping a journal using a stylus. It is free software (GNU GPL) and runs on Linux (recent distributions) and other GTK+/Gnome platforms. ... In this mode, if you erase in the middle of a stroke, the remaining portions of the stroke are automatically split into shorter strokes. The background ...
Xournal / Discussion / Open Discussion: "Presentation Mode" PDF export
Right now Xournal creates one PDF page per Xournal page when exporting to PDF - what I would call "Handout Mode". If instead it created one PDF page per layer , then you would get something more approximating a powerpoint presentation - what I am proposing to call "Presentation Mode".
Xournal++
From solving a physics problem to making travel diaries. Xournal++ (/ˌzɚnl̟ˌplʌsˈplʌs/) is an open-source and cross-platform note-taking software that is fast, flexible, and functional. A modern rewrite and a more feature-rich version of the wonderful Xournal program.
Xournal / Feature Requests / #37 "presentation mode"
Next Page = Left instead of Crtl+Left, so that you can flip to next page/slide with cursor keys, if you do a presentation. This way it is also possible to use cursor keys in tablet mode. The menu bars should be configurable, resizeable, movable. So that there will be more space for the slide. Thank you, Very nice tool! Jens
Xournal++
View source. View history. Xournal++ is an open source handwriting app written in C++ supporting annotation of PDF files, it is a rewrite of Xournal to be more efficient and to enhance the functionality, while remaining backwards compatible with Xournal and is able to read and edit Xournal files ( .xoj ).
Xournal User's manual
Xournal is an application for notetaking, sketching, keeping a journal using a stylus. It is free software (GNU GPL) and runs on Linux (recent distributions) and other GTK+/Gnome platforms. ... In this mode, if you erase in the middle of a stroke, the remaining portions of the stroke are automatically split into shorter strokes. The background ...
Xournal / Feature Requests / #75 Presentation mode
I wouldn't necessarily recommend using xournal as a presentation viewer, as it's not particularly suited for that purpose -- its emphasis is on annotation, not on navigation, and its PDF features are rudimentary (in fact it relies on poppler, which is the same PDF renderer used by evince and xpdf).
Photon Studio is a new pro tool to streamline image presentation and
LateNiteSoft launched and detailed the new app on its blog today: Photon Studio is more than just another app - it's a game-changer for photographers seeking quick and efficient image ...
Windows Installation
Installing Xournal++ is really easy. Unzip archive which should be named something like xournalpp-{version}-windows.zip. Run the setup program contained in xournalpp-{version}-windows.zip. Follow the installation steps. Success! As a free and open-source software, Xournal++ can also be compiled from source. If you prefer to do so, follow this ...
Presentation Mode not really working #671
Zoom working strange - should be always 100% I think Toolbar should be selectable in the settings Create a Presentation toolbar, and select as default. ... Presentation Mode not really working #671. Closed andreasb242 opened this issue Jan 1, 2019 · 0 comments · Fixed by #1022. Closed

Tuesday, June 5, 2012

Xournal User's Manual

Table of contents

The highlighter

The text tool

The image tool

The shape recognizer

Default tools

Thickness buttons

Rectangle selection

Lasso selection

Vertical space

Undo and redo

Button mappings

Navigating the journal

Managing pages and layers

Paper formats and backgrounds

PDF annotation

Printing via gtk-print

Exporting to PDF

Overall structure

Page background

Layers and strokes

Installation issues

Compilation and installation procedure

Tablet calibration issues

The cursor doesn't appear in the right place...

The cursor is in the right place, but strokes aren't drawn under the cursor...

On-the-fly display rotation

Xournal User's Manual

Table of contents

The highlighter

The text tool

The image tool

The shape recognizer

Default tools

Thickness buttons

Rectangle selection

Lasso selection

Vertical space

Undo and redo

Button mappings

Navigating the journal

Managing pages and layers

Paper formats and backgrounds

PDF annotation

Printing via gtk-print

Exporting to PDF

Overall structure

Page background

Layers and strokes

Installation issues

Compilation and installation procedure

Tablet calibration issues

The cursor doesn't appear in the right place...

The cursor is in the right place, but strokes aren't drawn under the cursor...

On-the-fly display rotation

Photon Camera

Michael Potuck's favorite gear

Satechi USB-C Charger (4 ports)

Apple Leather MagSafe Wallet

Choose Your Version

Navigation Menu

Saved searches

Presentation Mode not really working #671

andreasb242 commented Jan 1, 2019

COMMENTS