You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by je...@apache.org on 2011/01/24 10:55:53 UTC

svn commit: r1062710 - in /xmlgraphics/fop/trunk/src/documentation: content/xdocs/faq.xml resources/images/acrobat-anti-aliasing-artifacts.png resources/images/anti-aliasing-artifacts-demo.fo

Author: jeremias
Date: Mon Jan 24 09:55:52 2011
New Revision: 1062710

URL: http://svn.apache.org/viewvc?rev=1062710&view=rev
Log:
FAQ entry for anti-aliasing artifacts in Adobe Acrobat.

Added:
    xmlgraphics/fop/trunk/src/documentation/resources/images/acrobat-anti-aliasing-artifacts.png   (with props)
    xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo   (with props)
Modified:
    xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml

Modified: xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml?rev=1062710&r1=1062709&r2=1062710&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml (original)
+++ xmlgraphics/fop/trunk/src/documentation/content/xdocs/faq.xml Mon Jan 24 09:55:52 2011
@@ -1016,6 +1016,46 @@ Can I control this?</question>
         </p>
       </answer>
     </faq>
+    <faq id="acrobat-anti-aliasing">
+      <question>How can I get rid of strange single-pixel lines inside table borders or between table cells in Adobe Acrobat?</question>
+      <answer>
+        <p>
+          Since Apache FOP supports the collapsed border model, every border segment consists
+          of two separate shapes. This is due to the fact that each side of the border
+          segment can have a different color. Now, Adobe Acrobat may display thin (1 pixel wide)
+          lines inside the border segment or sometimes even between to adjacent
+          colored rectangles making up the background of a block or table cell.
+          This effect is due to the way Adobe Acrobat does anti-aliasing. Adobe's algorithm
+          seems to cause these artifacts. Other PDF viewers don't have that problem. Or at least
+          we haven't had any reports in that direction.
+        </p>
+        <p>
+          First of all, these artifacts do not appear in print since no anti-aliasing is done
+          by Adobe Acrobat in this case (except maybe if you tell Acrobat to print the page
+          as a bitmap in which case Adobe fully composes the page itself). So, if the artifacts appear
+          on screen, it doesn't mean they have to appear in print, too.
+        </p>
+        <p>
+          To get rid of the artifacts, you can call up the "Preferences" dialog of
+          Adobe Acrobat and select the tab "Page display". Enabling "Enhance thin lines"
+          may help in some situations. Otherwise, you can disable "Smooth line art".
+          You may have to disable "Use 2D graphics acceleration", too, so you can disable
+          "Smooth line art" in the first place.
+        </p>
+        <p>
+          Here an example of how the effect can look like (left: anti-aliasing on, right: anti-aliasing off):
+        </p>
+        <figure src="images/acrobat-anti-aliasing-artifacts.png" alt="Left: anti-aliasing on, Right: off"/>
+        <p>
+          Unfortunately, it is not possible to control the above settings from within the PDF file.
+          The user has to change these settings himself. Improving FOP to avoid this kind of problem
+          would be possible although rather hard to achieve because we'd need to add a considerable
+          amount of code to combine the various line segments. Something like that has been tried already
+          years ago showing that this is a tricky task. Also, the improvement may not justify the amount
+          of effort required.
+        </p>
+      </answer>
+    </faq>
   </part>
   <part id="part-iex">
     <title>IEx specific stuff</title>

Added: xmlgraphics/fop/trunk/src/documentation/resources/images/acrobat-anti-aliasing-artifacts.png
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/resources/images/acrobat-anti-aliasing-artifacts.png?rev=1062710&view=auto
==============================================================================
Binary file - no diff available.

Propchange: xmlgraphics/fop/trunk/src/documentation/resources/images/acrobat-anti-aliasing-artifacts.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo?rev=1062710&view=auto
==============================================================================
--- xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo (added)
+++ xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo Mon Jan 24 09:55:52 2011
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
+  <fo:layout-master-set>
+    <fo:simple-page-master master-name="page" page-height="3.1cm" page-width="6cm" margin="2mm">
+      <fo:region-body/>
+    </fo:simple-page-master>
+  </fo:layout-master-set>
+  <fo:page-sequence master-reference="page">
+    <fo:flow flow-name="xsl-region-body">
+      <fo:table table-layout="fixed" inline-progression-dimension="100%">
+        <fo:table-column column-width="50%"/>
+        <fo:table-column column-width="50%"/>
+        <fo:table-body>
+          <fo:table-row>
+            <fo:table-cell border="solid 2mm darkblue">
+              <fo:block>Cell 1/1</fo:block>
+            </fo:table-cell>
+            <fo:table-cell border="solid 2mm darkblue">
+              <fo:block>Cell 2/1</fo:block>
+            </fo:table-cell>
+          </fo:table-row>
+          <fo:table-row>
+            <fo:table-cell border="solid 2mm darkblue">
+              <fo:block>Cell 1/2</fo:block>
+            </fo:table-cell>
+            <fo:table-cell border="solid 2mm darkblue">
+              <fo:block>Cell 2/2</fo:block>
+            </fo:table-cell>
+          </fo:table-row>
+        </fo:table-body>
+      </fo:table>
+
+      <fo:table table-layout="fixed" inline-progression-dimension="100%" space-before="2mm">
+        <fo:table-column column-width="50%"/>
+        <fo:table-column column-width="50%"/>
+        <fo:table-body color="white">
+          <fo:table-row>
+            <fo:table-cell background-color="darkgreen">
+              <fo:block>Cell 1/1</fo:block>
+            </fo:table-cell>
+            <fo:table-cell background-color="darkgreen">
+              <fo:block>Cell 2/1</fo:block>
+            </fo:table-cell>
+          </fo:table-row>
+          <fo:table-row>
+            <fo:table-cell background-color="darkgreen">
+              <fo:block>Cell 1/2</fo:block>
+            </fo:table-cell>
+            <fo:table-cell background-color="darkgreen">
+              <fo:block>Cell 2/2</fo:block>
+            </fo:table-cell>
+          </fo:table-row>
+        </fo:table-body>
+      </fo:table>
+    </fo:flow>
+  </fo:page-sequence>
+</fo:root>

Propchange: xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xmlgraphics/fop/trunk/src/documentation/resources/images/anti-aliasing-artifacts-demo.fo
------------------------------------------------------------------------------
    svn:keywords = Id



---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org