From: auroux Date: Fri, 2 Oct 2009 23:24:41 +0000 (+0000) Subject: Release 0.4.5 X-Git-Url: https://git.donarmstrong.com/?p=xournal.git;a=commitdiff_plain;h=55606436ae30328c0f8230004dccd483b9e50c19 Release 0.4.5 --- diff --git a/AUTHORS b/AUTHORS index 3d78974..dc7b74d 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1,2 +1,12 @@ -- Denis Auroux (auroux@math.mit.edu) -- various patch contributors as noted in the ChangeLog +Main author: Denis Auroux (auroux@math.mit.edu, auroux@math.berkeley.edu) + +The source code includes contributions by the following people: + +Eduardo de Barros Lima, Mathieu Bouchard, Ole Joergen Broenner, +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. + +(Let me know if you are missing from this list or if your name is +mis-spelled) diff --git a/ChangeLog b/ChangeLog index a78e5bc..6c19ddb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -12,6 +12,7 @@ Version 0.4.5 (Oct 2, 2009): - 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 Version 0.4.2.1 (Mar 27, 2008): - bugfix for #1926757 (crash upon pasting variable-width stroke) diff --git a/html-doc/manual.html b/html-doc/manual.html index ce3edc1..ab24d51 100644 --- a/html-doc/manual.html +++ b/html-doc/manual.html @@ -24,7 +24,7 @@ Xournal User's Manual

- Version 0.4.2.1 + Version 0.4.5

@@ -39,13 +39,12 @@

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

Xournal aims to provide superior graphical quality (subpixel resolution) and overall - functionality; however it lacks the collaborative features of Jarnal. - Since Xournal is still in its early development stages, it may not - be fully stable, and some features have not been implemented yet. + functionality; however various advanced features have not been implemented + yet.

Table of contents

@@ -54,7 +53,7 @@ Xournal can be downloaded at

  • The drawing and selection tools
  • Pages, layers, and backgrounds
  • Printing
    • -
  • Configuration
    • +
  • Configuration file
  • Author information, license, bug-reports
  • Version history
  • The file format
    • @@ -79,7 +78,7 @@ Xournal can be downloaded at

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

    @@ -284,6 +283,11 @@ the Tools menu): 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. +

    Pages, layers, and backgrounds

    @@ -389,8 +393,9 @@ 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 many respects). +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 @@ -411,29 +416,15 @@ 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).

    -

    -Rescaling and anti-aliasing: by default, -bitmap backgrounds are rescaled and anti-aliased as needed when the zoom -level is changed, to ensure their appearance always remains acceptable. -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 bitmap backgrounds being smoothed 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 rescaled immediately upon changing the zoom level (slower but maybe more -intuitive), disable the "Progressive Backgrounds" option in the Options -menu.
    -If you are handling large bitmaps, you can save memory and CPU resources (at the -expense of quality) by disabling the "Antialiased Bitmaps" option in the Options menu. -

    PDF annotation

    Xournal can be used to annotate PDF files, by loading the pages of a PDF -file as backgrounds for a journal. This feature requires the -pdftoppm converter to be installed (this is part of the xpdf - PDF file viewer). +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 @@ -460,9 +451,10 @@ 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). However, since the backgrounds are -generated asynchronously by a separate Unix process, you can keep drawing in the journal -while the update process is still in progress. +for the updated background to appear). +

    It is strongly recommended that you do not resize PDF pages (using the @@ -478,54 +470,61 @@ 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. +

    +

    Printing

    -Xournal uses the gnome-print architecture for printing. While it is very -powerful, some aspects of the API leave to be desired. As of version 0.3, -Xournal also includes a native PDF printing feature. +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 gnome-print

    +

    Printing via gtk-print

    -The "Printer" tab of the print dialog box lets you select a printer -(either one of the printers installed on your system, or the generic -Postscript printer, or the PDF virtual printer). The "Job" tab lets you -select a range of pages to print (the default is to print the entire -journal). The "Paper" tab lets you select the paper size. Each page +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. -(minus a 5% margin all around).

    -The settings are currently not saved properly from one print job to -the next, so make sure to select the appropriate printer and verify -the paper size. When printing to a file (Postscript or PDF), Xournal -attempts to pre-fill the output file name (for the Postscript driver -this often fails due to gnome-print API issues). +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).

    -Note that the PDF virtual printer produces files that are very large -and far from optimal, so its use is not recommended. -The gnome-print architecture also forces page backgrounds (bitmaps -and PDF) to be generated as uncompressed bitmaps, which leads to gigantic -print job files. A better alternative is to export a PDF file, and -print the PDF file. +The settings are currently not saved properly from one print job to +the next, so make sure to verify the settings.

    Exporting to PDF

    -Starting with version 0.3, Xournal provides its own PDF rendering +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 resulting PDF -file is much more compact than those produced via gnome-print, and -its pages have the same size as in Xournal. Highlighter strokes +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 also includes a PDF file parser compatible with PDF format -version 1.4; the compression features of PDF 1.5 (Acrobat 6) are +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, @@ -535,10 +534,10 @@ PDF file is generated from scratch.

    -

    Configuration

    +

    Configuration file

    -Starting with version 0.3.2, Xournal's configuration settings can be -saved to a file (~user/.xournal/config) by using the "Save +Xournal's configuration settings are saved to the file +~user/.xournal/config by using the "Save Preferences" command in the Options menu. The settings saved in the configuration file include in particular: