You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ju...@apache.org on 2010/03/18 16:46:10 UTC
svn commit: r924869 [10/13] - in /pdfbox/site: ./ publish/
publish/commandlineutilities/ publish/css/ publish/userguide/
publish/userguide/cookbook/ src/site/fml/userguide/ src/site/xdoc/
src/site/xdoc/commandlineutilities/ src/site/xdoc/userguide/ src...
Modified: pdfbox/site/publish/userguide/faq.html
URL: http://svn.apache.org/viewvc/pdfbox/site/publish/userguide/faq.html?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/publish/userguide/faq.html (original)
+++ pdfbox/site/publish/userguide/faq.html Thu Mar 18 15:46:08 2010
@@ -1,16 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-
-
-
-
-
-
-
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
+<!-- Generated by Apache Maven Doxia at Mar 18, 2010 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Apache PDFBox - Frequently Asked Questions</title>
@@ -20,331 +10,229 @@
@import url("../css/site.css");
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
- </head>
+ <meta name="Date-Revision-yyyymmdd" content="20100318" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
<body class="composite">
<div id="banner">
- <a href="" id="bannerLeft">
-
- <img src="../images/Logo.gif" alt="Apache PDFBox" />
-
- </a>
- <a href="http://www.apache.org/" id="bannerRight">
-
- <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
-
- </a>
+ <a href="" id="bannerLeft" title="Apache PDFBox">
+ <img src="../images/Logo.gif" alt="Apache PDFBox" />
+ </a>
+ <a href="http://www.apache.org/" id="bannerRight" title="The Apache Software Foundation">
+ <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
+ </a>
<div class="clear">
<hr/>
</div>
</div>
<div id="breadcrumbs">
-
-
-
-
-
-
-
- <div class="xright">
-
-
-
-
-
-
-
- </div>
+
+ <div class="xright">
+
+ </div>
<div class="clear">
<hr/>
</div>
</div>
<div id="leftColumn">
<div id="navcolumn">
-
-
-
-
-
-
-
-
- <h5>About</h5>
- <ul>
-
- <li class="none">
- <a href="../index.html">Welcome</a>
- </li>
-
- <li class="none">
- <a href="../download.html">Download</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink">License</a>
- </li>
-
- <li class="none">
- <a href="../mailing-list.html">Mailing Lists</a>
- </li>
-
- <li class="none">
- <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink">Issue Tracker</a>
- </li>
-
- <li class="none">
- <a href="../references.html">References</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">ASF Sponsorship Program</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">ASF Thanks</a>
- </li>
+
+
+ <h5>About</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Welcome">Welcome</a>
+ </li>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="../mailing-list.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ </li>
+ <li class="none">
+ <a href="../references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="ASF Sponsorship Program">ASF Sponsorship Program</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="ASF Thanks">ASF Thanks</a>
+ </li>
</ul>
- <h5>Command Line Utilities</h5>
- <ul>
-
- <li class="none">
- <a href="../commandlineutilities/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ConvertColorspace.html">ConvertColorspace</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Decrypt.html">Decrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Encrypt.html">Encrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ExtractText.html">ExtractText</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Overlay.html">Overlay</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PrintPDF.html">PrintPDF</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFDebugger.html">PDFDebugger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFMerger.html">PDFMerger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFReader.html">PDFReader</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFSplit.html">PDFSplit</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFToImage.html">PDFToImage</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/TextToPDF.html">TextToPDF</a>
- </li>
+ <h5>Command Line Utilities</h5>
+ <ul>
+ <li class="none">
+ <a href="../commandlineutilities/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ConvertColorspace.html" title="ConvertColorspace">ConvertColorspace</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Decrypt.html" title="Decrypt">Decrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Encrypt.html" title="Encrypt">Encrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ExtractText.html" title="ExtractText">ExtractText</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Overlay.html" title="Overlay">Overlay</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PrintPDF.html" title="PrintPDF">PrintPDF</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFDebugger.html" title="PDFDebugger">PDFDebugger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFMerger.html" title="PDFMerger">PDFMerger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFReader.html" title="PDFReader">PDFReader</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFSplit.html" title="PDFSplit">PDFSplit</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFToImage.html" title="PDFToImage">PDFToImage</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/TextToPDF.html" title="TextToPDF">TextToPDF</a>
+ </li>
</ul>
- <h5>Developers Guide</h5>
- <ul>
-
- <li class="none">
- <a href="../userguide/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../userguide/bookmarks.html">Bookmarks</a>
- </li>
-
- <li class="none">
- <a href="../userguide/building_pdfbox.html">Building PDFBox</a>
- </li>
-
- <li class="none">
- <a href="../userguide/tutorials.html">Tutorials</a>
- </li>
-
- <li class="none">
- <a href="../userguide/cookbook.html">Cookbook</a>
- </li>
-
- <li class="none">
- <strong>FAQ</strong>
- </li>
-
- <li class="none">
- <a href="../userguide/file_references.html">File References</a>
- </li>
-
- <li class="none">
- <a href="../userguide/fonts.html">Fonts</a>
- </li>
-
- <li class="none">
- <a href="../userguide/highlighting.html">Highlighting</a>
- </li>
-
- <li class="none">
- <a href="../userguide/metadata.html">Metadata</a>
- </li>
-
- <li class="none">
- <a href="../userguide/redistribution.html">Redistribution</a>
- </li>
-
- <li class="none">
- <a href="../userguide/dot_net.html">.NET Version</a>
- </li>
-
- <li class="none">
- <a href="../userguide/text_extraction.html">Text Extraction</a>
- </li>
+ <h5>Developers Guide</h5>
+ <ul>
+ <li class="none">
+ <a href="../userguide/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/bookmarks.html" title="Bookmarks">Bookmarks</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/building_pdfbox.html" title="Building PDFBox">Building PDFBox</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/tutorials.html" title="Tutorials">Tutorials</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/cookbook.html" title="Cookbook">Cookbook</a>
+ </li>
+ <li class="none">
+ <strong>FAQ</strong>
+ </li>
+ <li class="none">
+ <a href="../userguide/file_references.html" title="File References">File References</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/fonts.html" title="Fonts">Fonts</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/highlighting.html" title="Highlighting">Highlighting</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/metadata.html" title="Metadata">Metadata</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/redistribution.html" title="Redistribution">Redistribution</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/dot_net.html" title=".NET Version">.NET Version</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/text_extraction.html" title="Text Extraction">Text Extraction</a>
+ </li>
</ul>
- <h5>Project Documentation</h5>
- <ul>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <li class="collapsed">
- <a href="../project-info.html">Project Information</a>
- </li>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ </li>
</ul>
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
- </a>
-
-
-
-
-
-
-
-
- </div>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2><a name="top">Frequently Asked Questions</a></h2>
-<p><b>General Questions</b></p>
-<ol type="1"><li><a href="#next_version">
+ <!-- ! Licensed to the Apache Software Foundation (ASF) under one or more
+ ! contributor license agreements. See the NOTICE file distributed with
+ ! this work for additional information regarding copyright ownership.
+ ! The ASF licenses this file to You under the Apache License, Version 2.0
+ ! (the "License"); you may not use this file except in compliance with
+ ! the License. You may obtain a copy of the License at
+ !
+ ! http://www.apache.org/licenses/LICENSE-2.0
+ !
+ ! Unless required by applicable law or agreed to in writing, software
+ ! distributed under the License is distributed on an "AS IS" BASIS,
+ ! WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ! See the License for the specific language governing permissions and
+ ! limitations under the License.
+ ! --><div class="section"><h2><a name="top">Frequently Asked Questions</a><a name="Frequently_Asked_Questions"></a></h2><p><b>General Questions</b></p><ol style="list-style-type: decimal"><li><a href="#next_version">
When will the next version of PDFBox be released?
- </a></li>
-<li><a href="#log4j_config">
+ </a></li><li><a href="#log4j_config">
I am getting the below Log4J warning message, how do I remove it?
- </a></li>
-<li><a href="#pdfbox_threadsafe">
+ </a></li><li><a href="#pdfbox_threadsafe">
Is PDFBox thread safe?
- </a></li>
-<li><a href="#pdfbox_close_warning">
- Why do I get a "Warning: You did not close the PDF Document"?
- </a></li>
-</ol>
-<p><b>Text Extraction</b></p>
-<ol type="1"><li><a href="#no_text_extraction">
+ </a></li><li><a href="#pdfbox_close_warning">
+ Why do I get a "Warning: You did not close the PDF Document"?
+ </a></li></ol><p><b>Text Extraction</b></p><ol style="list-style-type: decimal"><li><a href="#no_text_extraction">
How come I am not getting any text from the PDF document?
- </a></li>
-<li><a href="#gibberish_text">
+ </a></li><li><a href="#gibberish_text">
How come I am getting gibberish(G38G43G36G51G5) when extracting text?
- </a></li>
-<li><a href="#cant_handle_font_width">
- What does "java.io.IOException: Can't handle font width" mean?
- </a></li>
-<li><a href="#no_permission">
- Why do I get "You do not have permission to extract text" on some documents?
- </a></li>
-<li><a href="#parse_whole_document">Can't we just extract the text without parsing the whole document or extract text as it is parsed.</a></li>
-</ol>
-</div>
-<div class="section"><h2>General Questions</h2>
-<dl><dt><a name="next_version">
+ </a></li><li><a href="#cant_handle_font_width">
+ What does "java.io.IOException: Can't handle font width" mean?
+ </a></li><li><a href="#no_permission">
+ Why do I get "You do not have permission to extract text" on some documents?
+ </a></li><li><a href="#parse_whole_document">Can't we just extract the text without parsing the whole document or extract text as it is parsed.</a></li></ol></div><div class="section"><h2>General Questions<a name="General_Questions"></a></h2><dl><dt><a name="next_version">
When will the next version of PDFBox be released?
- </a></dt>
-<dd>
+ </a></dt><dd>
As fixes are made and integrated into the repository these changes are documented in the
- <link href="../changes.html">release notes</link>. An
+ <a href="../changes.html">release notes</a>. An
estimate will be given of when
- the next version will be released. <br></br>
+ the next version will be released. <br /></br>
Of course, this is only an estimate and could change.
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="log4j_config">
+ <hr /></dd><dt><a name="log4j_config">
I am getting the below Log4J warning message, how do I remove it?
- </a></dt>
-<dd>
+ </a></dt><dd>
<div class="source"><pre>
log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
- log4j:WARN Please initialize the log4j system properly.</pre>
-</div>
-
+ log4j:WARN Please initialize the log4j system properly.</pre></div>
<p>
This message means that you need to configure the log4j logging system.
- See the <link href="http://logging.apache.org/log4j/docs/documentation.html">log4j documentation</link> for more information.
+ See the <a class="externalLink" href="http://logging.apache.org/log4j/docs/documentation.html">log4j documentation</a> for more information.
</p>
<p>
PDFBox comes with a sample log4j configuration file. To use it you set a system property like this</p>
<div class="source"><pre>java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
- </pre>
-</div>
-
+ </pre></div>
<p>If this is not working for you then you may have to specify the log4j config file using a URL path, like this:</p>
- <div class="source"><pre>log4j.configuration=file:///<path to config file></pre>
-</div>
-
- <p>Please see <a href="https://sourceforge.net/forum/forum.php?thread_id=1254229&forum_id=267205">this</a> forum thread
+ <div class="source"><pre>log4j.configuration=file:///<path to config file></pre></div>
+ <p>Please see <a class="externalLink" href="https://sourceforge.net/forum/forum.php?thread_id=1254229&forum_id=267205">this</a> forum thread
for more information.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="pdfbox_threadsafe">
+ <hr /></dd><dt><a name="pdfbox_threadsafe">
Is PDFBox thread safe?
- </a></dt>
-<dd>
+ </a></dt><dd>
<p>
No! Only one thread may access a single document at a time.
You can have multiple threads each accessing their own PDDocument object.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="pdfbox_close_warning">
- Why do I get a "Warning: You did not close the PDF Document"?
- </a></dt>
-<dd>
+ <hr /></dd><dt><a name="pdfbox_close_warning">
+ Why do I get a "Warning: You did not close the PDF Document"?
+ </a></dt><dd>
<p>
You need to call close() on the PDDocument inside the finally block, if you
don't then the document will not be closed properly. Also, you must close all
@@ -364,18 +252,11 @@
doc.close();
}
}
- </pre>
-</div>
+ </pre></div>
-
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table></dd>
-</dl>
-</div>
-<div class="section"><h2>Text Extraction</h2>
-<dl><dt><a name="no_text_extraction">
+ </dd></dl></div><div class="section"><h2>Text Extraction<a name="Text_Extraction"></a></h2><dl><dt><a name="no_text_extraction">
How come I am not getting any text from the PDF document?
- </a></dt>
-<dd>
+ </a></dt><dd>
<p>
Text extraction from a pdf document is a complicated task and there are many factors
involved that effect the possibility and accuracy of text extraction. It would be helpful
@@ -390,12 +271,9 @@
any text then it is probably an image.</li>
</ul>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="gibberish_text">
+ <hr /></dd><dt><a name="gibberish_text">
How come I am getting gibberish(G38G43G36G51G5) when extracting text?
- </a></dt>
-<dd>
+ </a></dt><dd>
<p>
This is because the characters in a PDF document can use a custom encoding
instead of unicode or ASCII. When you see gibberish text then it
@@ -403,65 +281,45 @@
only way to access the text is to use OCR. This may be a future
enhancement.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="cant_handle_font_width">
- What does "java.io.IOException: Can't handle font width" mean?
- </a></dt>
-<dd>
+ <hr /></dd><dt><a name="cant_handle_font_width">
+ What does "java.io.IOException: Can't handle font width" mean?
+ </a></dt><dd>
<p>
- This probably means that the "Resources" directory is not in your classpath. The
+ This probably means that the "Resources" directory is not in your classpath. The
Resources directory is included in the PDFBox jar so this is only a problem if you
are building PDFBox yourself and not using the binary.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="no_permission">
- Why do I get "You do not have permission to extract text" on some documents?
- </a></dt>
-<dd>
+ <hr /></dd><dt><a name="no_permission">
+ Why do I get "You do not have permission to extract text" on some documents?
+ </a></dt><dd>
<p>
PDF documents have certain security permissions that can
be applied to them and two passwords associated with them, a user password and a master password.
- If the "cannot extract text" permission bit is set then you need
+ If the "cannot extract text" permission bit is set then you need
to decrypt the document with the master password in order to extract the text.
</p>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table><hr />
-</dd>
-<dt><a name="parse_whole_document">Can't we just extract the text without parsing the whole document or extract text as it is parsed.</a></dt>
-<dd>
+ <hr /></dd><dt><a name="parse_whole_document">Can't we just extract the text without parsing the whole document or extract text as it is parsed.</a></dt><dd>
<p>
Not really, for a couple reasons.
</p>
- <ol>
+ <ol style="list-style-type: decimal">
<li>If the document is encrypted then you need to parse at least until the encryption dictionary before you can decrypt.</li>
<li>Sometimes the PDFont contains vital information needed for text extraction.</li>
- <li>Text on a page does not have to be drawn in reading order. For example; if the page said "Hello World", the pdf could
- have been written such that "World" gets drawn and then the cursor moves to the left and the word "Hello" is drawn.</li>
+ <li>Text on a page does not have to be drawn in reading order. For example; if the page said "Hello World", the pdf could
+ have been written such that "World" gets drawn and then the cursor moves to the left and the word "Hello" is drawn.</li>
</ol>
- <table border="0"><tr><td align="right"><a href="#top">[top]</a></td></tr></table></dd>
-</dl>
-</div>
-
+ </dd></dl></div>
</div>
</div>
<div class="clear">
<hr/>
</div>
<div id="footer">
- <div class="xright">©
- 2008-2010
-
- The Apache Software Foundation
-
-
-
-
-
-
-
-
- </div>
+ <div class="xright">Copyright © 2008-2010
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
<div class="clear">
<hr/>
</div>
Modified: pdfbox/site/publish/userguide/file_references.html
URL: http://svn.apache.org/viewvc/pdfbox/site/publish/userguide/file_references.html?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/publish/userguide/file_references.html (original)
+++ pdfbox/site/publish/userguide/file_references.html Thu Mar 18 15:46:08 2010
@@ -1,292 +1,216 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-
-
-
-
-
-
-
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
+<!-- Generated by Apache Maven Doxia at Mar 18, 2010 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <title>Apache PDFBox - PDFBox - PDF File References</title>
+ <title>Apache PDFBox -
+ PDFBox - PDF File References</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@import url("../css/site.css");
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
- </head>
+ <meta name="Date-Revision-yyyymmdd" content="20100318" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
<body class="composite">
<div id="banner">
- <a href="" id="bannerLeft">
-
- <img src="../images/Logo.gif" alt="Apache PDFBox" />
-
- </a>
- <a href="http://www.apache.org/" id="bannerRight">
-
- <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
-
- </a>
+ <a href="" id="bannerLeft" title="Apache PDFBox">
+ <img src="../images/Logo.gif" alt="Apache PDFBox" />
+ </a>
+ <a href="http://www.apache.org/" id="bannerRight" title="The Apache Software Foundation">
+ <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
+ </a>
<div class="clear">
<hr/>
</div>
</div>
<div id="breadcrumbs">
-
-
-
-
-
-
-
- <div class="xright">
-
-
-
-
-
-
-
- </div>
+
+ <div class="xright">
+
+ </div>
<div class="clear">
<hr/>
</div>
</div>
<div id="leftColumn">
<div id="navcolumn">
-
-
-
-
-
-
-
-
- <h5>About</h5>
- <ul>
-
- <li class="none">
- <a href="../index.html">Welcome</a>
- </li>
-
- <li class="none">
- <a href="../download.html">Download</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink">License</a>
- </li>
-
- <li class="none">
- <a href="../mailing-list.html">Mailing Lists</a>
- </li>
-
- <li class="none">
- <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink">Issue Tracker</a>
- </li>
-
- <li class="none">
- <a href="../references.html">References</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">ASF Sponsorship Program</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">ASF Thanks</a>
- </li>
+
+
+ <h5>About</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Welcome">Welcome</a>
+ </li>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="../mailing-list.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ </li>
+ <li class="none">
+ <a href="../references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="ASF Sponsorship Program">ASF Sponsorship Program</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="ASF Thanks">ASF Thanks</a>
+ </li>
</ul>
- <h5>Command Line Utilities</h5>
- <ul>
-
- <li class="none">
- <a href="../commandlineutilities/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ConvertColorspace.html">ConvertColorspace</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Decrypt.html">Decrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Encrypt.html">Encrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ExtractText.html">ExtractText</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Overlay.html">Overlay</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PrintPDF.html">PrintPDF</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFDebugger.html">PDFDebugger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFMerger.html">PDFMerger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFReader.html">PDFReader</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFSplit.html">PDFSplit</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFToImage.html">PDFToImage</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/TextToPDF.html">TextToPDF</a>
- </li>
+ <h5>Command Line Utilities</h5>
+ <ul>
+ <li class="none">
+ <a href="../commandlineutilities/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ConvertColorspace.html" title="ConvertColorspace">ConvertColorspace</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Decrypt.html" title="Decrypt">Decrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Encrypt.html" title="Encrypt">Encrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ExtractText.html" title="ExtractText">ExtractText</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Overlay.html" title="Overlay">Overlay</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PrintPDF.html" title="PrintPDF">PrintPDF</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFDebugger.html" title="PDFDebugger">PDFDebugger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFMerger.html" title="PDFMerger">PDFMerger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFReader.html" title="PDFReader">PDFReader</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFSplit.html" title="PDFSplit">PDFSplit</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFToImage.html" title="PDFToImage">PDFToImage</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/TextToPDF.html" title="TextToPDF">TextToPDF</a>
+ </li>
</ul>
- <h5>Developers Guide</h5>
- <ul>
-
- <li class="none">
- <a href="../userguide/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../userguide/bookmarks.html">Bookmarks</a>
- </li>
-
- <li class="none">
- <a href="../userguide/building_pdfbox.html">Building PDFBox</a>
- </li>
-
- <li class="none">
- <a href="../userguide/tutorials.html">Tutorials</a>
- </li>
-
- <li class="none">
- <a href="../userguide/cookbook.html">Cookbook</a>
- </li>
-
- <li class="none">
- <a href="../userguide/faq.html">FAQ</a>
- </li>
-
- <li class="none">
- <strong>File References</strong>
- </li>
-
- <li class="none">
- <a href="../userguide/fonts.html">Fonts</a>
- </li>
-
- <li class="none">
- <a href="../userguide/highlighting.html">Highlighting</a>
- </li>
-
- <li class="none">
- <a href="../userguide/metadata.html">Metadata</a>
- </li>
-
- <li class="none">
- <a href="../userguide/redistribution.html">Redistribution</a>
- </li>
-
- <li class="none">
- <a href="../userguide/dot_net.html">.NET Version</a>
- </li>
-
- <li class="none">
- <a href="../userguide/text_extraction.html">Text Extraction</a>
- </li>
+ <h5>Developers Guide</h5>
+ <ul>
+ <li class="none">
+ <a href="../userguide/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/bookmarks.html" title="Bookmarks">Bookmarks</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/building_pdfbox.html" title="Building PDFBox">Building PDFBox</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/tutorials.html" title="Tutorials">Tutorials</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/cookbook.html" title="Cookbook">Cookbook</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/faq.html" title="FAQ">FAQ</a>
+ </li>
+ <li class="none">
+ <strong>File References</strong>
+ </li>
+ <li class="none">
+ <a href="../userguide/fonts.html" title="Fonts">Fonts</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/highlighting.html" title="Highlighting">Highlighting</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/metadata.html" title="Metadata">Metadata</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/redistribution.html" title="Redistribution">Redistribution</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/dot_net.html" title=".NET Version">.NET Version</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/text_extraction.html" title="Text Extraction">Text Extraction</a>
+ </li>
</ul>
- <h5>Project Documentation</h5>
- <ul>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <li class="collapsed">
- <a href="../project-info.html">Project Information</a>
- </li>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ </li>
</ul>
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
- </a>
-
-
-
-
-
-
-
-
- </div>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2><a name="PDF_File_Specification"></a>PDF File Specification</h2>
-<p>
- See package:<a href="../apidocs/org/apache/pdfbox/pdmodel/common/filespecification/package-summary.html">org.apache.pdfbox.pdmodel.common.filespecification</a><br />
-
- See example:<a href="../apidocs/org/apache/pdfbox/examples/pdmodel/EmbeddedFiles.html">EmbeddedFiles</a></p>
-<p>
+ <!-- ! Licensed to the Apache Software Foundation (ASF) under one or more
+ ! contributor license agreements. See the NOTICE file distributed with
+ ! this work for additional information regarding copyright ownership.
+ ! The ASF licenses this file to You under the Apache License, Version 2.0
+ ! (the "License"); you may not use this file except in compliance with
+ ! the License. You may obtain a copy of the License at
+ !
+ ! http://www.apache.org/licenses/LICENSE-2.0
+ !
+ ! Unless required by applicable law or agreed to in writing, software
+ ! distributed under the License is distributed on an "AS IS" BASIS,
+ ! WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ! See the License for the specific language governing permissions and
+ ! limitations under the License.
+ ! -->
+
+ <div class="section"><h2>PDF File Specification<a name="PDF_File_Specification"></a></h2>
+ <p>
+ See package:<a href="../apidocs/org/apache/pdfbox/pdmodel/common/filespecification/package-summary.html">org.apache.pdfbox.pdmodel.common.filespecification</a> <br />
+ See example:<a href="../apidocs/org/apache/pdfbox/examples/pdmodel/EmbeddedFiles.html">EmbeddedFiles</a>
+ </p>
+ <p>
A PDF can contain references to external files via the file system or a URL to a remote location.
It is also possible to embed a binary file into a PDF document.
</p>
-<p>
+ <p>
There are two classes that can be used when referencing a file.
<a href="../apidocs/org/apache/pdfbox/examples/pdmodel/common/filespecification/PDSimpleFileSpecification.html">PDSimpleFileSpecification</a>
is a simple string reference to a file(e.g. "./movies/BigMovie.avi"). The simple file specification does not allow for any parameters to be
set. The <a href="../apidocs/org/apache/pdfbox/examples/pdmodel/common/filespecification/PDComplexFileSpecification.html">PDComplexFileSpecification</a>
is more feature rich and allows for advanced settings on the file reference.
</p>
-<p>
+
+ <p>
It is also possible to embed a file directly into a PDF. Instead of setting the file attribute of the PDComplexFileSpecification, the
EmbeddedFile attribute can be used instead.
</p>
-</div>
-<div class="section"><h2><a name="File_Attachments"></a>File Attachments</h2>
-<p>
+ </div>
+ <div class="section"><h2>File Attachments<a name="File_Attachments"></a></h2>
+ <p>
PDF documents can contain file attachments that are accessed from the Document->File Attachments menu. PDFBox allows attachments
to be added to and extracted from PDF documents. Attachments are part of the named tree that is attached to the document catalog.
</p>
-<div class="source"><pre>
+ <div class="source"><pre>
PDEmbeddedFilesNameTreeNode efTree = new PDEmbeddedFilesNameTreeNode();
//first create the file specification, which holds the embedded file
@@ -308,9 +232,9 @@
PDDocumentNameDictionary names = new PDDocumentNameDictionary( doc.getDocumentCatalog() );
names.setEmbeddedFiles( efTree );
doc.getDocumentCatalog().setNames( names );
- </pre>
-</div>
-</div>
+ </pre></div>
+ </div>
+
</div>
</div>
@@ -318,19 +242,11 @@
<hr/>
</div>
<div id="footer">
- <div class="xright">©
- 2008-2010
-
- The Apache Software Foundation
-
-
-
-
-
-
-
-
- </div>
+ <div class="xright">Copyright © 2008-2010
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
<div class="clear">
<hr/>
</div>
Modified: pdfbox/site/publish/userguide/fonts.html
URL: http://svn.apache.org/viewvc/pdfbox/site/publish/userguide/fonts.html?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/publish/userguide/fonts.html (original)
+++ pdfbox/site/publish/userguide/fonts.html Thu Mar 18 15:46:08 2010
@@ -1,325 +1,234 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-
-
-
-
-
-
-
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
+<!-- Generated by Apache Maven Doxia at Mar 18, 2010 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <title>Apache PDFBox - PDFBox - PDF Fonts</title>
+ <title>Apache PDFBox -
+ PDFBox - PDF Fonts</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@import url("../css/site.css");
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
- </head>
+ <meta name="Date-Revision-yyyymmdd" content="20100318" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
<body class="composite">
<div id="banner">
- <a href="" id="bannerLeft">
-
- <img src="../images/Logo.gif" alt="Apache PDFBox" />
-
- </a>
- <a href="http://www.apache.org/" id="bannerRight">
-
- <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
-
- </a>
+ <a href="" id="bannerLeft" title="Apache PDFBox">
+ <img src="../images/Logo.gif" alt="Apache PDFBox" />
+ </a>
+ <a href="http://www.apache.org/" id="bannerRight" title="The Apache Software Foundation">
+ <img src="http://www.apache.org/images/asf_logo.gif" alt="The Apache Software Foundation" />
+ </a>
<div class="clear">
<hr/>
</div>
</div>
<div id="breadcrumbs">
-
-
-
-
-
-
-
-
- <div class="xright">
-
-
-
-
-
-
- </div>
+
+ <div class="xright">
+
+ </div>
<div class="clear">
<hr/>
</div>
</div>
<div id="leftColumn">
<div id="navcolumn">
-
-
-
-
-
-
-
-
- <h5>About</h5>
- <ul>
-
- <li class="none">
- <a href="../index.html">Welcome</a>
- </li>
-
- <li class="none">
- <a href="../download.html">Download</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink">License</a>
- </li>
-
- <li class="none">
- <a href="../mailing-list.html">Mailing Lists</a>
- </li>
-
- <li class="none">
- <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink">Issue Tracker</a>
- </li>
-
- <li class="none">
- <a href="../references.html">References</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">ASF Sponsorship Program</a>
- </li>
-
- <li class="none">
- <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">ASF Thanks</a>
- </li>
+
+
+ <h5>About</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Welcome">Welcome</a>
+ </li>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="../mailing-list.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="https://issues.apache.org/jira/browse/PDFBOX" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ </li>
+ <li class="none">
+ <a href="../references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="ASF Sponsorship Program">ASF Sponsorship Program</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="ASF Thanks">ASF Thanks</a>
+ </li>
</ul>
- <h5>Command Line Utilities</h5>
- <ul>
-
- <li class="none">
- <a href="../commandlineutilities/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ConvertColorspace.html">ConvertColorspace</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Decrypt.html">Decrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Encrypt.html">Encrypt</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/ExtractText.html">ExtractText</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/Overlay.html">Overlay</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PrintPDF.html">PrintPDF</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFDebugger.html">PDFDebugger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFMerger.html">PDFMerger</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFReader.html">PDFReader</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFSplit.html">PDFSplit</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/PDFToImage.html">PDFToImage</a>
- </li>
-
- <li class="none">
- <a href="../commandlineutilities/TextToPDF.html">TextToPDF</a>
- </li>
+ <h5>Command Line Utilities</h5>
+ <ul>
+ <li class="none">
+ <a href="../commandlineutilities/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ConvertColorspace.html" title="ConvertColorspace">ConvertColorspace</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Decrypt.html" title="Decrypt">Decrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Encrypt.html" title="Encrypt">Encrypt</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/ExtractText.html" title="ExtractText">ExtractText</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/Overlay.html" title="Overlay">Overlay</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PrintPDF.html" title="PrintPDF">PrintPDF</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFDebugger.html" title="PDFDebugger">PDFDebugger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFMerger.html" title="PDFMerger">PDFMerger</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFReader.html" title="PDFReader">PDFReader</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFSplit.html" title="PDFSplit">PDFSplit</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/PDFToImage.html" title="PDFToImage">PDFToImage</a>
+ </li>
+ <li class="none">
+ <a href="../commandlineutilities/TextToPDF.html" title="TextToPDF">TextToPDF</a>
+ </li>
</ul>
- <h5>Developers Guide</h5>
- <ul>
-
- <li class="none">
- <a href="../userguide/index.html">Index</a>
- </li>
-
- <li class="none">
- <a href="../userguide/bookmarks.html">Bookmarks</a>
- </li>
-
- <li class="none">
- <a href="../userguide/building_pdfbox.html">Building PDFBox</a>
- </li>
-
- <li class="none">
- <a href="../userguide/tutorials.html">Tutorials</a>
- </li>
-
- <li class="none">
- <a href="../userguide/cookbook.html">Cookbook</a>
- </li>
-
- <li class="none">
- <a href="../userguide/faq.html">FAQ</a>
- </li>
-
- <li class="none">
- <a href="../userguide/file_references.html">File References</a>
- </li>
-
- <li class="none">
- <strong>Fonts</strong>
- </li>
-
- <li class="none">
- <a href="../userguide/highlighting.html">Highlighting</a>
- </li>
-
- <li class="none">
- <a href="../userguide/metadata.html">Metadata</a>
- </li>
-
- <li class="none">
- <a href="../userguide/redistribution.html">Redistribution</a>
- </li>
-
- <li class="none">
- <a href="../userguide/dot_net.html">.NET Version</a>
- </li>
-
- <li class="none">
- <a href="../userguide/text_extraction.html">Text Extraction</a>
- </li>
+ <h5>Developers Guide</h5>
+ <ul>
+ <li class="none">
+ <a href="../userguide/index.html" title="Index">Index</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/bookmarks.html" title="Bookmarks">Bookmarks</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/building_pdfbox.html" title="Building PDFBox">Building PDFBox</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/tutorials.html" title="Tutorials">Tutorials</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/cookbook.html" title="Cookbook">Cookbook</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/faq.html" title="FAQ">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/file_references.html" title="File References">File References</a>
+ </li>
+ <li class="none">
+ <strong>Fonts</strong>
+ </li>
+ <li class="none">
+ <a href="../userguide/highlighting.html" title="Highlighting">Highlighting</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/metadata.html" title="Metadata">Metadata</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/redistribution.html" title="Redistribution">Redistribution</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/dot_net.html" title=".NET Version">.NET Version</a>
+ </li>
+ <li class="none">
+ <a href="../userguide/text_extraction.html" title="Text Extraction">Text Extraction</a>
+ </li>
</ul>
- <h5>Project Documentation</h5>
- <ul>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <li class="collapsed">
- <a href="../project-info.html">Project Information</a>
- </li>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ </li>
</ul>
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
- </a>
-
-
-
-
-
-
-
-
- </div>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2><a name="Standard_14_Fonts"></a>Standard 14 Fonts</h2>
-<p>
+ <!-- ! Licensed to the Apache Software Foundation (ASF) under one or more
+ ! contributor license agreements. See the NOTICE file distributed with
+ ! this work for additional information regarding copyright ownership.
+ ! The ASF licenses this file to You under the Apache License, Version 2.0
+ ! (the "License"); you may not use this file except in compliance with
+ ! the License. You may obtain a copy of the License at
+ !
+ ! http://www.apache.org/licenses/LICENSE-2.0
+ !
+ ! Unless required by applicable law or agreed to in writing, software
+ ! distributed under the License is distributed on an "AS IS" BASIS,
+ ! WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ! See the License for the specific language governing permissions and
+ ! limitations under the License.
+ ! -->
+
+ <div class="section"><h2>Standard 14 Fonts<a name="Standard_14_Fonts"></a></h2>
+ <p>
The PDF specification states that a standard set of 14 fonts will always be available when consuming
PDF documents. In PDFBox these are defined as constants in the PDType1Font class.
</p>
-<table class="bodyTable"><tr class="a"><th>Standard Font</th>
-</tr>
-<tr class="b"><td>PDType1Font.TIMES_ROMAN</td>
-</tr>
-<tr class="a"><td>PDType1Font.TIMES_BOLD</td>
-</tr>
-<tr class="b"><td>PDType1Font.TIMES_ITALIC</td>
-</tr>
-<tr class="a"><td>PDType1Font.TIMES_BOLD_ITALIC</td>
-</tr>
-<tr class="b"><td>PDType1Font.HELVETICA</td>
-</tr>
-<tr class="a"><td>PDType1Font.HELVETICA_BOLD</td>
-</tr>
-<tr class="b"><td>PDType1Font.HELVETICA_OBLIQUE</td>
-</tr>
-<tr class="a"><td>PDType1Font.HELVETICA_BOLD_OBLIQUE</td>
-</tr>
-<tr class="b"><td>PDType1Font.COURIER</td>
-</tr>
-<tr class="a"><td>PDType1Font.COURIER_BOLD</td>
-</tr>
-<tr class="b"><td>PDType1Font.COURIER_OBLIQUE</td>
-</tr>
-<tr class="a"><td>PDType1Font.COURIER_BOLD_OBLIQUE</td>
-</tr>
-<tr class="b"><td>PDType1Font.SYMBOL</td>
-</tr>
-<tr class="a"><td>PDType1Font.ZAPF_DINGBATS</td>
-</tr>
-</table>
-</div>
-<div class="section"><h2><a name="TrueType_Fonts"></a>TrueType Fonts</h2>
-<div class="section"><h3><a name="Embedding_TrueType_Fonts"></a>Embedding TrueType Fonts</h3>
-<p>
+ <table align="center" border="1" class="bodyTable">
+ <tr class="a"><th align="left">Standard Font</th></tr>
+ <tr class="b"><td align="left">PDType1Font.TIMES_ROMAN</td></tr>
+ <tr class="a"><td align="left">PDType1Font.TIMES_BOLD</td></tr>
+ <tr class="b"><td align="left">PDType1Font.TIMES_ITALIC</td></tr>
+ <tr class="a"><td align="left">PDType1Font.TIMES_BOLD_ITALIC</td></tr>
+ <tr class="b"><td align="left">PDType1Font.HELVETICA</td></tr>
+ <tr class="a"><td align="left">PDType1Font.HELVETICA_BOLD</td></tr>
+ <tr class="b"><td align="left">PDType1Font.HELVETICA_OBLIQUE</td></tr>
+ <tr class="a"><td align="left">PDType1Font.HELVETICA_BOLD_OBLIQUE</td></tr>
+ <tr class="b"><td align="left">PDType1Font.COURIER</td></tr>
+ <tr class="a"><td align="left">PDType1Font.COURIER_BOLD</td></tr>
+ <tr class="b"><td align="left">PDType1Font.COURIER_OBLIQUE</td></tr>
+ <tr class="a"><td align="left">PDType1Font.COURIER_BOLD_OBLIQUE</td></tr>
+ <tr class="b"><td align="left">PDType1Font.SYMBOL</td></tr>
+ <tr class="a"><td align="left">PDType1Font.ZAPF_DINGBATS</td></tr>
+ </table>
+ </div>
+ <div class="section"><h2>TrueType Fonts<a name="TrueType_Fonts"></a></h2>
+ <div class="section"><h3>Embedding TrueType Fonts<a name="Embedding_TrueType_Fonts"></a></h3>
+ <p>
PDFBox supports embedding TrueType fonts. Loading a new font is easy.
</p>
-<div class="source"><pre>
+ <div class="source"><pre>
PDDocument doc = PDDocument.load( ... );
- PDFont font = PDTrueTypeFont.loadTTF( doc, new File( "SpecialFont.ttf" ) );</pre>
-</div>
-</div>
-<div class="section"><h3><a name="External_TrueType_Fonts"></a>External TrueType Fonts</h3>
-<p>
+ PDFont font = PDTrueTypeFont.loadTTF( doc, new File( "SpecialFont.ttf" ) );</pre></div>
+
+ </div>
+ <div class="section"><h3>External TrueType Fonts<a name="External_TrueType_Fonts"></a></h3>
+ <p>
While it is recommended to embed all fonts for greatest portability not all PDF producer applications
will do this. When displaying a PDF it is necessary to find an external font to use.
PDFBox will look for a mapping file to use when substituting fonts.<br />
-<br />
-
+ <br />
PDFBox will load <i>Resources/PDFBox_External_Fonts.properties</i> off of the classpath to map
font names to TTF font files. The <i>UNKNOWN_FONT</i> property in that file will tell PDFBox which font
to use when no mapping exists.
</p>
-</div>
-</div>
+ </div>
+ </div>
+
</div>
</div>
@@ -327,19 +236,11 @@
<hr/>
</div>
<div id="footer">
- <div class="xright">©
- 2008-2010
-
- The Apache Software Foundation
-
-
-
-
-
-
-
-
- </div>
+ <div class="xright">Copyright © 2008-2010
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
<div class="clear">
<hr/>
</div>