Differences

This shows you the differences between two versions of the page.

--- contrib:externalviewers [2019/06/22 22:28] – [For PDF files] xpdf brucemutton
+++ contrib:externalviewers [2024/11/15 21:31] (current) – [For PDF files] Alpha sort, and add Okular brucemutton
@@ Line 13: / Line 13: @@
 MacOSX Acrobat Pro (full & Reader) - lock files, there is feature to one-click refresh file if only one file is opened. You may switch on in preferences "Restore last view settings when reopening documents".
+**Evince** http://projects.gnome.org/evince/ \\
+If a file is open while Therion updates the file, it automatically reloads the file.  Changes to layer selections often require the user to resize the window to force a redraw.
+On my Windows machine most large Therion generated files do not display, they are forever 'reloading'. It is very slow and makes many errors drawing areas (patterns are not clipped) - Bruce. However Martin B gets best results with Evince, especially regarding the rendering of transparency groups.
 **Foxit** http://www.foxitsoftware.com/pdf/reader/ \\
@@ Line 23: / Line 28: @@
 //**Foxit and MacOSX:**// According to a press release from the Foxit Corporation, hackers have disguised versions of the Jahlav Trojan horse as a pirated version of Foxit Reader for Mac. Any user foolish enough to download a version of "Foxit Reader for Mac" from a source other than the official Foxit website at http://www.foxitsoftware.com is, therefore, risking infecting their iMac or MacBook.
-**Evince** http://projects.gnome.org/evince/ \\
-If a file is open while Therion updates the file, it automatically reloads the file.  Changes to layer selections often require the user to resize the window to force a redraw.
-On my Windows machine most large Therion generated files do not display, they are forever 'reloading'. It is very slow and makes many errors drawing areas (patterns are not clipped) - Bruce. However Martin B gets best results with Evince, especially regarding the rendering of transparency groups.
-**SumatraPDF** http://blog.kowalczyk.info/software/sumatrapdf/download-free-pdf-viewer.html \\
-If a file is open while Therion updates the file, it automatically reloads the file. Zoom and rendering of all details works very well too. The rendered PDF looks the same as Foxit Reader (See example screenshots in the next section below).
-As a Windows user I find non-file locking readers very useful for drawing new scraps, because if you set up a map to just render the few scraps you are working on so that the overall survey is not too large then you can keep the PDF open in Evince/SumatraPDF and recompile your project to immediately see the changes. The problems with clipping area fills in Evince means you cannot preview these, but walls, lines and point symbols are fine. SumatraPDF does a good job of both rendering and automatically displaying changes when the PDF is regenerated. This workflow is great for refining scrap joins as you can adjust the positions of line ends and immediately see the effect with the Evince viewer open alongside your Therion editor window, and for checking that area fills are working as planned. - Footleg
-Works well and is fairly fast to render large maps with Windows 10. Great for monitoring drawings while editing, but you don't want this as your only viewer. Is not always good at printing. - Bruce
 **MacOSX: Quick Look**
@@ Line 43: / Line 37: @@
 **MacOSX: Skim (free)**
 It looks very promising (only short test). It is possible to set it to automatic refresh. It preserves zoom and position. [[http://sourceforge.net/projects/skim-app/ |Skim]]. The rendering is the same as Foxit.
+**Okular** https://okular.kde.org/
+Multi-platform viewer of multiple file types.
+On Linux, if a file is open while Therion updates the file, it automatically reloads the file.  But not on Windows.
+On Windows, similar speed to SumatraPDF, but poorer rendering quality - although there are many settings that may mitigate this...
+**SumatraPDF** http://blog.kowalczyk.info/software/sumatrapdf/download-free-pdf-viewer.html \\
+If a file is open while Therion updates the file, it automatically reloads the file. Zoom and rendering of all details works very well too. The rendered PDF looks the same as Foxit Reader (See example screenshots in the next section below).
+As a Windows user I find non-file locking readers very useful for drawing new scraps, because if you set up a map to just render the few scraps you are working on so that the overall survey is not too large then you can keep the PDF open in Evince/SumatraPDF and recompile your project to immediately see the changes. The problems with clipping area fills in Evince means you cannot preview these, but walls, lines and point symbols are fine. SumatraPDF does a good job of both rendering and automatically displaying changes when the PDF is regenerated. This workflow is great for refining scrap joins as you can adjust the positions of line ends and immediately see the effect with the Evince viewer open alongside your Therion editor window, and for checking that area fills are working as planned. - Footleg
+Works well and is fairly fast to render large maps with Windows 10. Great for monitoring drawings while editing, but you don't want this as your only viewer. Is not always good at printing. - Bruce
 **Xpdf** https://www.xpdfreader.com/
@@ Line 51: / Line 57: @@
 **A comment...**
-The transparency of areas with filled backgrounds in pdfs is quite different when viewed with Adobe and Foxit Readers. The reason is the library used to render PDFs (up to early 2013 on ongoing...) //If viewer is based on PDF Kit from Apple the rendering is incorrect. There is the bug in PDF Kit evidently - it ignores command "transparency knockout group".//
+The transparency of areas with filled backgrounds in pdfs is quite different when viewed with Adobe and Foxit Readers. The reason is the library used to render PDFs (up to early 2013 on ongoing...) //If viewer is based on PDFKit from Apple the rendering is incorrect. There is the bug in PDF Kit evidently - it ignores command "transparency knockout group".//
-Adobe renders them opaque, and Foxit renders them translucent (except for area u:) and except for objects that explicitly have //–place bottom// set and except for my custom area water and area sump.  This difference in behaviour persists through to the printed documents as well.
+Adobe uses PDFToolkit and renders them opaque, and Foxit renders them translucent (except for area u:) and except for objects that explicitly have //–place bottom// set and except for my custom area water and area sump.  This difference in behaviour persists through to the printed documents as well.
 Objects with //–place bottom// are always completely obscured by areas with default placement regardless of the viewer.
@@ Line 59: / Line 65: @@
 Objects with //–place top// render the same as objects with default placement over areas with default placement in both viewers.
-The Foxit behaviour is preferable I think, although, with some symbol sets, you can never get a rock that looks like it is definitively ‘high and dry above the water’, unless you say, draw two rocks, one directly above the other.
+The Foxit behaviour is preferable I think, although, with some symbol sets, you can never get a rock that looks like it is definitively ‘high and dry above the water’, unless you say, draw two rocks, one directly above the other.\\ (Note: Anyway, Foxit ignores [[https://www.pdfa.org/what-does-%C2%93support-pdf%C2%94-really-mean/?highlight=knockout|official definition of PDF]], Sluka)
 Some further information here [[:tips#drawing_order_how_to_draw_symbols_over_or_under_an_area]]
+**What it means "transparency knockout"**\\
+Transparency knockout is part of PDF definition which Adobe applications as Illustrator, InDesign, Photoshop, etc. use. It means, that there is possibility to switch off transparency for a particular group of objects (sublayer) when transparency of superior layer is on. The explanation you may find [[https://helpx.adobe.com/illustrator/using/transparency-blending-modes.html|here]].\\
+In case of Therion it means that you didn't want rocks to be transparent, but rocks in position above another passage should be partially transparent to show details from underlaying passage.
+See attached examples of preview in program using PDFToolkit (transparency knockout rendered) and PDFKit (transparency knockout ignored).\\
+{{:contrib:pdftoolkit.png|300px|}}{{:contrib:pdfkit.png|300px|}}
 =====Examples of Rendering Differences Between PDF Viewers=====
 Each of the PDF readers renders Therion generated PDFs differently. Here are some examples from Windows versions of the PDF readers.
@@ Line 91: / Line 102: @@
 **xpdf** \\
-Correct rendering of overlap objects. On MacOSX it is possible to install it by homebrew installer. xpdf should antialias vectors, but not in this case, so rendering is quite coarse.
+Correct rendering of overlap objects. On MacOSX it is possible to install it by homebrew installer. xpdf should antialias vectors, but not in this case, so rendering is quite coarse. The reason is when transparency knockout is used, the antialiasing in layers is not rendered. It should be corrected in next version of xpdf - current version is 4.
 {{:contrib:xpdf.png|}}