← Back to branch summary

~ubuntu-branches/debian/sid/gdal/sid

« back to all changes in this revision

Viewing changes to frmts/pdf/frmt_pdf.html

  • Committer: Package Import Robot
  • Author(s): Francesco Paolo Lovergine
  • Date: 2012-05-07 15:04:42 UTC
  • mfrom: (5.5.16 experimental)
  • Revision ID: package-import@ubuntu.com-20120507150442-2eks97loeh6rq005
Tags: 1.9.0-1
* Ready for sid, starting transition.
* All symfiles updated to latest builds.
* Added dh_numpy call in debian/rules to depend on numpy ABI.
* Policy bumped to 3.9.3, no changes required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
frmts/pdf/frmt_pdf.html
 
1
<html>
 
2
<head>
 
3
<title>Geospatial PDF</title>
 
4
</head>
 
5
 
 
6
<body bgcolor="#ffffff">
 
7
 
 
8
<h1>Geospatial PDF</h1>
 
9
 
 
10
(Available for GDAL >= 1.8.0)
 
11
<p>
 
12
GDAL supports reading Geospatial PDF documents, by extracting georeferencing information and rasterizing the data.
 
13
Non-geospatial PDF documents will also be recognized by the driver.
 
14
<p>
 
15
GDAL must be compiled with libpoppler support (GPL-licensed), and libpoppler itself must have been configured with
 
16
--enable-xpdf-headers so that the xpdf C++ headers are available. Note: the poppler C++ API isn't
 
17
stable, so the driver compilation may fail with too old or too recent poppler versions.
 
18
Successfully tested versions are poppler &gt;= 0.12.X and &lt;= 0.18.0.
 
19
<p>
 
20
Starting with GDAL 1.9.0, as an alternative, the PDF driver can be compiled against libpodofo (LGPL-licensed)
 
21
to avoid the libpoppler dependency. This is sufficient to get the georeferencing information. However, for
 
22
getting the imagery, the pdftoppm utility that comes with the poppler distribution must be available in the system PATH.
 
23
A temporary file will be generated in a directory determined by the following configuration options : CPL_TMPDIR,
 
24
TMPDIR or TEMP (in that order). If none are defined, the current directory will be used.
 
25
Successfully tested versions are libpodofo 0.8.4 and 0.9.1.
 
26
<p>
 
27
The driver supports reading georeferencing encoded in either of the 2 current existing ways : according to the OGC
 
28
encoding best practice, or according to the Adobe Supplement to ISO 32000.
 
29
<p>
 
30
The dimensions of the raster can be controlled by specifying the DPI of the rasterization with the
 
31
<i>GDAL_PDF_DPI</i> configuration option. Its default value is 150.
 
32
<p>
 
33
Multipage documents are exposed as subdatasets, one subdataset par page of the document.
 
34
<p>
 
35
The neatline (for OGC best practice) or the bounding box (Adobe style) will be reported as a NEATLINE metadata item,
 
36
so that it can be later used as a cutline for the warping algorithm.
 
37
<p>
 
38
Starting with GDAL 1.9.0, XMP metadata can be extracted from the file, and will be
 
39
stored as XML raw content in the xml:XMP metadata domain.
 
40
<p>
 
41
 
 
42
<h2>Restrictions</h2>
 
43
 
 
44
The opening of a PDF document (to get the georeferencing) is fast, but at the first access to a raster block,
 
45
the whole page will be rasterized, which can be a slow operation.
 
46
<p>
 
47
Only a few of the possible Datums available in the OGC best practice spec have been currently mapped
 
48
in the driver. Unrecognized datums will be considered as being based on the WGS84 ellipsoid.
 
49
<p>
 
50
For documents that contain several neatlines in a page (insets), the georeferencing will be
 
51
extracted from the inset that has the largest area (in term of screen points).
 
52
<p>
 
53
There is currently no support for selective layer rendering.
 
54
<p>
 
55
 
 
56
<h2>See also</h2>
 
57
 
 
58
<ul>
 
59
<li><a href="http://portal.opengeospatial.org/files/?artifact_id=33332">OGC GeoPDF Encoding Best Practice Version 2.2</a></li>
 
60
<li><a href="http://www.adobe.com/devnet/acrobat/pdfs/adobe_supplement_iso32000.pdf">Adobe Supplement to ISO 32000</a></li>
 
61
<li><a href="http://poppler.freedesktop.org/">Poppler homepage</a></li>
 
62
<li><a href="http://acrobatusers.com/gallery/geospatial">A few Geospatial PDF samples</a></li>
 
63
<li><a href="http://www.agc.army.mil/geopdf_gallery.html">Another set of Geospatial PDF samples</a></li>
 
64
</ul>
 
65
 
 
66
</body>
 
67
</html>