Return-Path: <commits-return-9486-archive-asf-public=cust-asf.ponee.io@pdfbox.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id 49355200BE9
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Sun, 11 Dec 2016 10:04:57 +0100 (CET)
Received: by cust-asf.ponee.io (Postfix)
	id 46BB5160B07; Sun, 11 Dec 2016 09:04:57 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id 95503160B20
	for <archive-asf-public@cust-asf.ponee.io>; Sun, 11 Dec 2016 10:04:56 +0100 (CET)
Received: (qmail 43535 invoked by uid 500); 11 Dec 2016 09:04:55 -0000
Mailing-List: contact commits-help@pdfbox.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@pdfbox.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@pdfbox.apache.org>
List-Post: <mailto:commits@pdfbox.apache.org>
List-Id: <commits.pdfbox.apache.org>
Reply-To: dev@pdfbox.apache.org
Delivered-To: mailing list commits@pdfbox.apache.org
Received: (qmail 43468 invoked by uid 99); 11 Dec 2016 09:04:55 -0000
Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 11 Dec 2016 09:04:55 +0000
Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33)
	id A3FB4E97DD; Sun, 11 Dec 2016 09:04:55 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: msahyoun@apache.org
To: commits@pdfbox.apache.org
Date: Sun, 11 Dec 2016 09:04:56 -0000
Message-Id: <06f03da362134599b1d576149181f7ab@git.apache.org>
In-Reply-To: <a19c265bb28d40c4b8309373e6121927@git.apache.org>
References: <a19c265bb28d40c4b8309373e6121927@git.apache.org>
X-Mailer: ASF-Git Admin Mailer
Subject: [2/2] pdfbox-docs git commit: PDFBOX-3330: add information about text
 antialiasing for rendering
archived-at: Sun, 11 Dec 2016 09:04:57 -0000

PDFBOX-3330: add information about text antialiasing for rendering


Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/f03ca583
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/f03ca583
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/f03ca583

Branch: refs/heads/master
Commit: f03ca583e4645ba5a08c63d9edfb73005fba5f22
Parents: 7e9ff66
Author: Maruan Sahyoun <sahyoun@fileaffairs.de>
Authored: Sun Dec 11 10:04:38 2016 +0100
Committer: Maruan Sahyoun <sahyoun@fileaffairs.de>
Committed: Sun Dec 11 10:04:38 2016 +0100

----------------------------------------------------------------------
 content/2.0/faq.md | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/f03ca583/content/2.0/faq.md
----------------------------------------------------------------------
diff --git a/content/2.0/faq.md b/content/2.0/faq.md
index f1a9739..4fce7b0 100644
--- a/content/2.0/faq.md
+++ b/content/2.0/faq.md
@@ -47,7 +47,8 @@ title:   Frequently Asked Questions (FAQ)
 
 ### PDF rendering
 
- - [A drop shadow is missing or at the wrong position when rendering a page](#dropshadow)  
+ - [A drop shadow is missing or at the wrong position when rendering a page](#dropshadow)
+ - [Why are some texts in poor quality and not antialiased?](#textantialias)
 
 ## General Questions
 
@@ -131,7 +132,7 @@ Make sure that you closed your content stream before saving.
 <a name="textorder"></a>
 
 
-## Why does the extracted text appear in the wrong sequence?
+### Why does the extracted text appear in the wrong sequence?
 
 By default, text extraction is done in the same sequence as the text in the PDF page content stream.
 PDF is a graphic format, not a text format, and unlike HTML, it has no requirements that text one on page
@@ -197,4 +198,14 @@ the word "Hello" is drawn.
 
 ### A drop shadow is missing or at the wrong position when rendering a page
 
-Please attach your file in the [PDFBOX-3000](https://issues.apache.org/jira/browse/PDFBOX-3000) issue
+Please attach your file in the [PDFBOX-3000](https://issues.apache.org/jira/browse/PDFBOX-3000) issue.
+
+<a name="textantialias"></a>
+
+### Why are some texts in poor quality and not antialiased?
+
+This is because in some PDFs (e.g. the one in PDFBOX-2814 <https://issues.apache.org/jira/browse/PDFBOX-2814>), text is not
+rendered directly, but as a shaped clipping from a background. Java graphics does not support "soft clipping"
+<https://bugs.openjdk.java.net/browse/JDK-4212743>, and because of that, the edges are not looking smooth.
+Soft clipping could be achieved with some extra steps <https://community.oracle.com/blogs/campbell/2006/07/19/java-2d-trickery-soft-clipping>,
+but these would cost additional time and memory space. You can have a higher quality by rendering at a higher dpi and then downscale the image.