| 1 |
<?xml version="1.0" encoding="UTF-8"?> |
| 2 |
<!-- |
| 3 |
/****************************************************************************** |
| 4 |
* Project: GDAL/OGR |
| 5 |
* Purpose: XML Schema for GDAL PDF driver composition files. |
| 6 |
* Author: Even Rouault, <even dot rouault at spatialys dot com> |
| 7 |
* |
| 8 |
********************************************************************** |
| 9 |
* Copyright (c) 2019, Even Rouault |
| 10 |
* |
| 11 |
* SPDX-License-Identifier: MIT |
| 12 |
****************************************************************************/ |
| 13 |
--> |
| 14 |
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" version="1.0"> |
| 15 |
<xs:element name="PDFComposition"> |
| 16 |
<xs:annotation><xs:documentation> |
| 17 |
Root element defining a composition of one or several pages. |
| 18 |
</xs:documentation></xs:annotation> |
| 19 |
<xs:complexType> |
| 20 |
<xs:sequence> |
| 21 |
<xs:element name="JPEG2000Driver" type="xs:string" minOccurs="0"/> |
| 22 |
<xs:element name="Metadata" type="MetadataType" minOccurs="0"/> |
| 23 |
<xs:element name="Javascript" type="xs:string" minOccurs="0"/> |
| 24 |
<xs:element name="LayerTree" type="LayerTreeType" minOccurs="0"/> |
| 25 |
<xs:element name="Page" type="PageType" maxOccurs="unbounded"> |
| 26 |
<xs:keyref name="georeferencedIdRef" refer="georeferencingId"> |
| 27 |
<xs:selector xpath=".//*"/> |
| 28 |
<xs:field xpath="@georeferencingId"/> |
| 29 |
</xs:keyref> |
| 30 |
<xs:unique name="georeferencingId"> |
| 31 |
<xs:selector xpath=".//Georeferencing"/> |
| 32 |
<xs:field xpath="@id"/> |
| 33 |
</xs:unique> |
| 34 |
</xs:element> |
| 35 |
<xs:element name="Outline" type="OutlineType" minOccurs="0"> |
| 36 |
</xs:element> |
| 37 |
</xs:sequence> |
| 38 |
</xs:complexType> |
| 39 |
|
| 40 |
<!-- unicity constraints on Layer.id, and validy check of references --> |
| 41 |
<!-- to them --> |
| 42 |
<xs:keyref name="layerIdRef" refer="layerId"> |
| 43 |
<xs:selector xpath=".//IfLayerOn|.//SetLayerStateAction"/> |
| 44 |
<xs:field xpath="@layerId"/> |
| 45 |
</xs:keyref> |
| 46 |
<xs:key name="layerId"> |
| 47 |
<xs:selector xpath=".//Layer"/> |
| 48 |
<xs:field xpath="@id"/> |
| 49 |
</xs:key> |
| 50 |
|
| 51 |
<!-- unicity constraints on Page.id, and validy check of references --> |
| 52 |
<!-- to them --> |
| 53 |
<xs:keyref name="pageIdRef" refer="pageId"> |
| 54 |
<xs:selector xpath=".//OutlineItem"/> |
| 55 |
<xs:field xpath="@pageId"/> |
| 56 |
</xs:keyref> |
| 57 |
<xs:unique name="pageId"> |
| 58 |
<xs:selector xpath=".//Page"/> |
| 59 |
<xs:field xpath="@id"/> |
| 60 |
</xs:unique> |
| 61 |
</xs:element> |
| 62 |
|
| 63 |
<xs:complexType name="OutlineType"> |
| 64 |
<xs:annotation><xs:documentation> |
| 65 |
Define the outline / bookmarks of the document, typically the |
| 66 |
structure of pages. But bookmarks may also point to particular |
| 67 |
elements in a page. |
| 68 |
Recursive list of OutlineItem. |
| 69 |
</xs:documentation></xs:annotation> |
| 70 |
<xs:sequence> |
| 71 |
<xs:element name="OutlineItem" type="OutlineItemType" minOccurs="0" maxOccurs="unbounded"/> |
| 72 |
</xs:sequence> |
| 73 |
</xs:complexType> |
| 74 |
|
| 75 |
<xs:complexType name="OutlineItemType"> |
| 76 |
<xs:annotation><xs:documentation> |
| 77 |
An OutlineItem may be final or a parent of child OutlineItem. |
| 78 |
If the OutlineItem has children, the open attribute controls whether |
| 79 |
the children list must be folded or not. |
| 80 |
An OutlineItem may have zero, one or several acssociated actions. |
| 81 |
</xs:documentation></xs:annotation> |
| 82 |
<xs:sequence> |
| 83 |
<xs:element name="Actions" minOccurs="0"> |
| 84 |
<xs:complexType> |
| 85 |
<xs:sequence> |
| 86 |
<xs:element ref="AbstractAction" minOccurs="0" maxOccurs="unbounded"/> |
| 87 |
</xs:sequence> |
| 88 |
</xs:complexType> |
| 89 |
</xs:element> |
| 90 |
<xs:element name="OutlineItem" type="OutlineItemType" minOccurs="0" maxOccurs="unbounded"/> |
| 91 |
</xs:sequence> |
| 92 |
<xs:attribute name="name" type="xs:string" use="required"> |
| 93 |
<xs:annotation><xs:documentation> |
| 94 |
User visible name of the outline item. |
| 95 |
</xs:documentation></xs:annotation> |
| 96 |
</xs:attribute> |
| 97 |
<xs:attribute name="open" type="xs:boolean" default="true"> |
| 98 |
<xs:annotation><xs:documentation> |
| 99 |
Whether children outline items should be unfolded. |
| 100 |
</xs:documentation></xs:annotation> |
| 101 |
</xs:attribute> |
| 102 |
<xs:attribute name="italic" type="xs:boolean" default="false"/> |
| 103 |
<xs:attribute name="bold" type="xs:boolean" default="false"/> |
| 104 |
</xs:complexType> |
| 105 |
|
| 106 |
<xs:complexType name="AbstractionActionType" abstract="true"> |
| 107 |
<xs:annotation><xs:documentation> |
| 108 |
Abstract action element type |
| 109 |
</xs:documentation></xs:annotation> |
| 110 |
</xs:complexType> |
| 111 |
|
| 112 |
<xs:element name="AbstractAction" type="AbstractionActionType" abstract="true"> |
| 113 |
<xs:annotation><xs:documentation> |
| 114 |
Abstract action element |
| 115 |
</xs:documentation></xs:annotation> |
| 116 |
</xs:element> |
| 117 |
|
| 118 |
<xs:element name="GotoPageAction" substitutionGroup="AbstractAction"> |
| 119 |
<xs:annotation><xs:documentation> |
| 120 |
Goto a destination page. |
| 121 |
The x1, y1, x2, y2 attributes |
| 122 |
may also be defined to zoom-in on a particular area of the page. |
| 123 |
</xs:documentation></xs:annotation> |
| 124 |
<xs:complexType> |
| 125 |
<xs:complexContent> |
| 126 |
<xs:extension base="AbstractionActionType"> |
| 127 |
<xs:attribute name="pageId" type="xs:string" use="required"/> |
| 128 |
<xs:attribute name="x1" type="pdfCoordinateType"/> |
| 129 |
<xs:attribute name="y1" type="pdfCoordinateType"/> |
| 130 |
<xs:attribute name="x2" type="pdfCoordinateType"/> |
| 131 |
<xs:attribute name="y2" type="pdfCoordinateType"/> |
| 132 |
</xs:extension> |
| 133 |
</xs:complexContent> |
| 134 |
</xs:complexType> |
| 135 |
</xs:element> |
| 136 |
|
| 137 |
<xs:element name="SetAllLayersStateAction" substitutionGroup="AbstractAction"> |
| 138 |
<xs:annotation><xs:documentation> |
| 139 |
Turn all layers on or off. |
| 140 |
Later SetAllLayersStateAction/SetLayerStateAction might change this state. |
| 141 |
</xs:documentation></xs:annotation> |
| 142 |
<xs:complexType> |
| 143 |
<xs:complexContent> |
| 144 |
<xs:extension base="AbstractionActionType"> |
| 145 |
<xs:attribute name="visible" type="xs:boolean" use="required"/> |
| 146 |
</xs:extension> |
| 147 |
</xs:complexContent> |
| 148 |
</xs:complexType> |
| 149 |
</xs:element> |
| 150 |
|
| 151 |
<xs:element name="SetLayerStateAction" substitutionGroup="AbstractAction"> |
| 152 |
<xs:annotation><xs:documentation> |
| 153 |
Turn a specific layer on off. |
| 154 |
Later SetAllLayersStateAction/SetLayerStateAction might change this state. |
| 155 |
</xs:documentation></xs:annotation> |
| 156 |
<xs:complexType> |
| 157 |
<xs:complexContent> |
| 158 |
<xs:extension base="AbstractionActionType"> |
| 159 |
<xs:attribute name="layerId" type="xs:string" use="required"/> |
| 160 |
<xs:attribute name="visible" type="xs:boolean" use="required"/> |
| 161 |
</xs:extension> |
| 162 |
</xs:complexContent> |
| 163 |
</xs:complexType> |
| 164 |
</xs:element> |
| 165 |
|
| 166 |
<xs:element name="JavascriptAction" substitutionGroup="AbstractAction"> |
| 167 |
<xs:annotation><xs:documentation> |
| 168 |
Execute a Javascript action. |
| 169 |
See https://www.adobe.com/content/dam/acom/en/devnet/acrobat/pdfs/js_api_reference.pdf |
| 170 |
The script must be put as the content of the element. |
| 171 |
</xs:documentation></xs:annotation> |
| 172 |
<xs:complexType mixed="true"> |
| 173 |
<xs:complexContent> |
| 174 |
<xs:extension base="AbstractionActionType"/> |
| 175 |
</xs:complexContent> |
| 176 |
</xs:complexType> |
| 177 |
</xs:element> |
| 178 |
|
| 179 |
<xs:complexType name="MetadataType"> |
| 180 |
<xs:sequence> |
| 181 |
<xs:element name="Author" type="xs:string" minOccurs="0"/> |
| 182 |
<xs:element name="Producer" type="xs:string" minOccurs="0"/> |
| 183 |
<xs:element name="Creator" type="xs:string" minOccurs="0"/> |
| 184 |
<xs:element name="CreationDate" type="xs:string" minOccurs="0"/> |
| 185 |
<xs:element name="Subject" type="xs:string" minOccurs="0"/> |
| 186 |
<xs:element name="Title" type="xs:string" minOccurs="0"/> |
| 187 |
<xs:element name="Keywords" type="xs:string" minOccurs="0"/> |
| 188 |
<xs:element name="XMP" type="xs:string" minOccurs="0"> |
| 189 |
<xs:annotation><xs:documentation> |
| 190 |
The XMP payload must be serialized in a XML-escaped way |
| 191 |
</xs:documentation></xs:annotation> |
| 192 |
</xs:element> |
| 193 |
</xs:sequence> |
| 194 |
</xs:complexType> |
| 195 |
|
| 196 |
<xs:complexType name="LayerTreeType"> |
| 197 |
<xs:annotation><xs:documentation> |
| 198 |
Hierarchical definition of layers ("Optional Content Group" in PDF parlance) |
| 199 |
Common to all pages, but their visibility in the layer tree can |
| 200 |
be controlled with the displayOnlyOnVisiblePages attribute. |
| 201 |
</xs:documentation></xs:annotation> |
| 202 |
<xs:sequence> |
| 203 |
<xs:element name="Layer" type="LayerType" minOccurs="0" maxOccurs="unbounded"/> |
| 204 |
</xs:sequence> |
| 205 |
<xs:attribute name="displayOnlyOnVisiblePages" type="xs:boolean" default="false"> |
| 206 |
<xs:annotation><xs:documentation> |
| 207 |
Whether to list, in the layer tree, layers that are referenced |
| 208 |
by at at least one currently visible page(s). |
| 209 |
Default is false, that is the layers are always listed. |
| 210 |
</xs:documentation></xs:annotation> |
| 211 |
</xs:attribute> |
| 212 |
</xs:complexType> |
| 213 |
|
| 214 |
<xs:complexType name="LayerType"> |
| 215 |
<xs:annotation><xs:documentation> |
| 216 |
Define a Layer ("Optional Content Group" in PDF parlance) |
| 217 |
</xs:documentation></xs:annotation> |
| 218 |
<xs:sequence> |
| 219 |
<xs:element name="Layer" type="LayerType" minOccurs="0" maxOccurs="unbounded"/> |
| 220 |
</xs:sequence> |
| 221 |
<xs:attribute name="id" type="xs:string" use="required"> |
| 222 |
<xs:annotation><xs:documentation> |
| 223 |
Arbitrary id, unique to the layer. Will be cross-referenced by |
| 224 |
IfLayerOnType#layerId to define conditional visibility. |
| 225 |
</xs:documentation></xs:annotation> |
| 226 |
</xs:attribute> |
| 227 |
<xs:attribute name="name" type="xs:string" use="required"> |
| 228 |
<xs:annotation><xs:documentation> |
| 229 |
User visible name |
| 230 |
</xs:documentation></xs:annotation> |
| 231 |
</xs:attribute> |
| 232 |
<xs:attribute name="initiallyVisible" type="xs:boolean" default="true"/> |
| 233 |
<xs:attribute name="mutuallyExclusiveGroupId" type="xs:string"> |
| 234 |
<xs:annotation><xs:documentation> |
| 235 |
Arbitrary id defining a group of mutually exclusive layers. |
| 236 |
Layers referencing to the same #mutuallyExclusiveGroupId value |
| 237 |
will be mutually exclusive. |
| 238 |
</xs:documentation></xs:annotation> |
| 239 |
</xs:attribute> |
| 240 |
</xs:complexType> |
| 241 |
|
| 242 |
<xs:complexType name="PageType"> |
| 243 |
<xs:sequence> |
| 244 |
<xs:element name="DPI" type="positiveDouble" minOccurs="0" default="72"/> |
| 245 |
<xs:element name="Width" type="pdfCoordinateType"/> |
| 246 |
<xs:element name="Height" type="pdfCoordinateType"/> |
| 247 |
<xs:element name="Georeferencing" type="GeoreferencingType" minOccurs="0" maxOccurs="unbounded"/> |
| 248 |
<xs:element name="Content" type="ContentType"/> |
| 249 |
</xs:sequence> |
| 250 |
<xs:attribute name="id" type="xs:string"> |
| 251 |
<xs:annotation><xs:documentation> |
| 252 |
Arbitrary id, unique to the page. Required if the page must |
| 253 |
be referenced by a OutlineItem. |
| 254 |
</xs:documentation></xs:annotation> |
| 255 |
</xs:attribute> |
| 256 |
</xs:complexType> |
| 257 |
|
| 258 |
<xs:simpleType name="positiveDouble"> |
| 259 |
<xs:restriction base="xs:double"> |
| 260 |
<xs:minExclusive value="0"/> |
| 261 |
</xs:restriction> |
| 262 |
</xs:simpleType> |
| 263 |
|
| 264 |
<xs:simpleType name="pdfCoordinateType"> |
| 265 |
<xs:restriction base="xs:double"> |
| 266 |
<xs:minInclusive value="0"/> |
| 267 |
<xs:maxInclusive value="14400"/> |
| 268 |
</xs:restriction> |
| 269 |
</xs:simpleType> |
| 270 |
|
| 271 |
<xs:complexType name="GeoreferencingType"> |
| 272 |
<xs:sequence> |
| 273 |
<xs:element name="SRS" type="SRSType"> |
| 274 |
<xs:annotation><xs:documentation> |
| 275 |
CRS WKT string, or EPSG:XXXX code. |
| 276 |
</xs:documentation></xs:annotation> |
| 277 |
</xs:element> |
| 278 |
<xs:element name="BoundingBox" type="BoundingBoxType" minOccurs="0"> |
| 279 |
<xs:annotation><xs:documentation> |
| 280 |
Define the viewport where georeferenced coordinates are |
| 281 |
available. |
| 282 |
If not specified, the extent of BoundingPolygon will be used instead. |
| 283 |
If none of BoundingBox and BoundingPolygon are specified, |
| 284 |
the whole PDF page will be assumed to be georeferenced. |
| 285 |
</xs:documentation></xs:annotation> |
| 286 |
</xs:element> |
| 287 |
<xs:element name="BoundingPolygon" type="xs:string" minOccurs="0"> |
| 288 |
<xs:annotation><xs:documentation> |
| 289 |
Define a polygon / neatline in PDF units into which the |
| 290 |
Measure tool will display coordinates. |
| 291 |
If not specified, BoundingBox will be used instead. |
| 292 |
If none of BoundingBox and BoundingPolygon are specified, |
| 293 |
the whole PDF page will be assumed to be georeferenced. |
| 294 |
</xs:documentation></xs:annotation> |
| 295 |
</xs:element> |
| 296 |
<xs:element name="ControlPoint" type="ControlPointType" minOccurs="4" maxOccurs="unbounded"> |
| 297 |
<xs:annotation><xs:documentation> |
| 298 |
Those points define the mapping from PDF coordinates to |
| 299 |
georeferenced coordinates. At least 4 of them must be |
| 300 |
provided. They do not need to form a rectangle neither in |
| 301 |
PDF coordinate space nor in georeferenced coordinate space. |
| 302 |
However if the georeferenced area is referenced to by content, |
| 303 |
they must be evaluated to a geotransform, without rotation |
| 304 |
or shearing. |
| 305 |
</xs:documentation></xs:annotation> |
| 306 |
</xs:element> |
| 307 |
</xs:sequence> |
| 308 |
<xs:attribute name="id" type="xs:string"> |
| 309 |
<xs:annotation><xs:documentation> |
| 310 |
ID that can be referred to to automatically place content. |
| 311 |
The georeferencing area ca be referenced to, only if the |
| 312 |
control points define an affine geotransform, without rotation |
| 313 |
or shearing, from PDF coordinate space to georeferenced |
| 314 |
coordinate space. |
| 315 |
</xs:documentation></xs:annotation> |
| 316 |
</xs:attribute> |
| 317 |
<xs:attribute name="ISO32000ExtensionFormat" type="xs:boolean" default="true"> |
| 318 |
<xs:annotation><xs:documentation> |
| 319 |
ISO-32000 extension format is the georeferencing format |
| 320 |
recognized by the Measure / Geographic location tool of Acrobat reader. |
| 321 |
</xs:documentation></xs:annotation> |
| 322 |
</xs:attribute> |
| 323 |
<xs:attribute name="OGCBestPracticeFormat" type="xs:boolean" default="false"> |
| 324 |
<xs:annotation><xs:documentation> |
| 325 |
OGC Best Practice format is the georeferencing format |
| 326 |
recognized by the Terrago Toolbar. |
| 327 |
It seems that within a PDF file, |
| 328 |
there should be only georeferenced areas encoded with the |
| 329 |
OGC Best Practice so that the Terrago Toolbar accepts to |
| 330 |
read them. |
| 331 |
</xs:documentation></xs:annotation> |
| 332 |
</xs:attribute> |
| 333 |
</xs:complexType> |
| 334 |
|
| 335 |
<xs:complexType name="SRSType"> |
| 336 |
<xs:simpleContent> |
| 337 |
<xs:extension base="xs:string"> |
| 338 |
<xs:attribute name="dataAxisToSRSAxisMapping" type="xs:string"> |
| 339 |
<xs:annotation><xs:documentation> |
| 340 |
Defines the data axis to SRS axis mapping. List of |
| 341 |
comma-separated axis number (starting at 1). |
| 342 |
Used to interpret the GeoX and GeoY attribute meaning. |
| 343 |
If not specified, the traditional GIS order is assumed. |
| 344 |
</xs:documentation></xs:annotation> |
| 345 |
</xs:attribute> |
| 346 |
</xs:extension> |
| 347 |
</xs:simpleContent> |
| 348 |
</xs:complexType> |
| 349 |
|
| 350 |
<xs:complexType name="BoundingBoxType"> |
| 351 |
<xs:annotation><xs:documentation> |
| 352 |
x2 must be > x1 and y2 > y1 |
| 353 |
</xs:documentation></xs:annotation> |
| 354 |
<xs:attribute name="x1" type="pdfCoordinateType" use="required"/> |
| 355 |
<xs:attribute name="y1" type="pdfCoordinateType" use="required"/> |
| 356 |
<xs:attribute name="x2" type="pdfCoordinateType" use="required"/> |
| 357 |
<xs:attribute name="y2" type="pdfCoordinateType" use="required"/> |
| 358 |
</xs:complexType> |
| 359 |
|
| 360 |
<xs:complexType name="ControlPointType"> |
| 361 |
<xs:attribute name="x" type="pdfCoordinateType" use="required"/> |
| 362 |
<xs:attribute name="y" type="pdfCoordinateType" use="required"/> |
| 363 |
<xs:attribute name="GeoX" type="xs:double" use="required"> |
| 364 |
<xs:annotation><xs:documentation> |
| 365 |
X value of the control point expressed in the SRS |
| 366 |
</xs:documentation></xs:annotation> |
| 367 |
</xs:attribute> |
| 368 |
<xs:attribute name="GeoY" type="xs:double" use="required"> |
| 369 |
<xs:annotation><xs:documentation> |
| 370 |
Y value of the control point expressed in the SRS |
| 371 |
</xs:documentation></xs:annotation> |
| 372 |
</xs:attribute> |
| 373 |
</xs:complexType> |
| 374 |
|
| 375 |
<xs:complexType name="ResursiveContentType"> |
| 376 |
<xs:annotation><xs:documentation> |
| 377 |
Sequence of raster, vector, labels, content from other PDF document, |
| 378 |
or conditionalized content of any of the above types. |
| 379 |
The content is drawn in the order it is mentioned, that is the |
| 380 |
first mentioned item is drawn first, and the last mentioned item |
| 381 |
is drawn last. |
| 382 |
</xs:documentation></xs:annotation> |
| 383 |
<xs:sequence> |
| 384 |
<xs:choice minOccurs="0" maxOccurs="unbounded"> |
| 385 |
<xs:element name="Raster" type="RasterType"/> |
| 386 |
<xs:element name="Vector" type="VectorType"/> |
| 387 |
<xs:element name="VectorLabel" type="VectorLabelType"/> |
| 388 |
<xs:element name="PDF" type="PDFType"/> |
| 389 |
<xs:element name="IfLayerOn" type="IfLayerOnType"/> |
| 390 |
</xs:choice> |
| 391 |
</xs:sequence> |
| 392 |
</xs:complexType> |
| 393 |
|
| 394 |
<xs:complexType name="ContentType"> |
| 395 |
<xs:complexContent> |
| 396 |
<xs:extension base="ResursiveContentType"> |
| 397 |
<xs:attribute name="streamCompression" type="StreamCompressionType" default="DEFLATE"/> |
| 398 |
</xs:extension> |
| 399 |
</xs:complexContent> |
| 400 |
</xs:complexType> |
| 401 |
|
| 402 |
<xs:simpleType name="StreamCompressionType"> |
| 403 |
<xs:restriction base="xs:string"> |
| 404 |
<xs:enumeration value="NONE"/> |
| 405 |
<xs:enumeration value="DEFLATE"/> |
| 406 |
</xs:restriction> |
| 407 |
</xs:simpleType> |
| 408 |
|
| 409 |
<xs:complexType name="PDFType"> |
| 410 |
<xs:annotation><xs:documentation> |
| 411 |
Insert the content stream of the (first page of the) PDF, together with |
| 412 |
its resources, without any extra rasterization. |
| 413 |
Optional content groups or georeferencing potentially found in the |
| 414 |
PDF to insert are ignored. |
| 415 |
The dimensions of the inserted PDF are assumed to be the same |
| 416 |
as the PDF where it is inserted. |
| 417 |
</xs:documentation></xs:annotation> |
| 418 |
<xs:sequence> |
| 419 |
<xs:element name="Blending" type="BlendingType" minOccurs="0"/> |
| 420 |
</xs:sequence> |
| 421 |
<xs:attribute name="dataset" type="xs:string" use="required"/> |
| 422 |
</xs:complexType> |
| 423 |
|
| 424 |
<xs:complexType name="RasterType"> |
| 425 |
<xs:annotation><xs:documentation> |
| 426 |
Insert raster (or rasterized) content from a GDAL dataset. |
| 427 |
|
| 428 |
There are two modes: |
| 429 |
|
| 430 |
- one where the raster potential georeferencing is completely ignored, |
| 431 |
and the image is put at the specified PDF coordinates. |
| 432 |
I which case , x1, y1, x2, y2 are in PDF coordinate units and represent the |
| 433 |
area where the image will be stretched. If not specified, |
| 434 |
the whole PDF page is occupied. |
| 435 |
x2 must be > x1 and y2 > y1. |
| 436 |
|
| 437 |
- another one, when the georeferencingId attribute is defined, and |
| 438 |
reference a georeferenced area. In that case, the raster geotransform |
| 439 |
will be used to correctly place it in the georeferenced area. |
| 440 |
</xs:documentation></xs:annotation> |
| 441 |
<xs:sequence> |
| 442 |
<xs:element name="Compression" type="RasterCompressionType" minOccurs="0"/> |
| 443 |
<xs:element name="Blending" type="BlendingType" minOccurs="0"/> |
| 444 |
</xs:sequence> |
| 445 |
<xs:attribute name="dataset" type="xs:string" use="required"> |
| 446 |
<xs:annotation><xs:documentation> |
| 447 |
GDAL dataset name |
| 448 |
</xs:documentation></xs:annotation> |
| 449 |
</xs:attribute> |
| 450 |
<xs:attribute name="x1" type="pdfCoordinateType"/> |
| 451 |
<xs:attribute name="y1" type="pdfCoordinateType"/> |
| 452 |
<xs:attribute name="x2" type="pdfCoordinateType"/> |
| 453 |
<xs:attribute name="y2" type="pdfCoordinateType"/> |
| 454 |
<xs:attribute name="georeferencingId" type="xs:string"> |
| 455 |
<xs:annotation><xs:documentation> |
| 456 |
References a georeferenced area in the same page |
| 457 |
through its Georeferencing#id |
| 458 |
</xs:documentation></xs:annotation> |
| 459 |
</xs:attribute> |
| 460 |
<xs:attribute name="tileSize" type="xs:integer" default="256"/> |
| 461 |
</xs:complexType> |
| 462 |
|
| 463 |
<xs:complexType name="RasterCompressionType"> |
| 464 |
<xs:attribute name="method" type="RasterCompressionMethodType" default="DEFLATE"/> |
| 465 |
<xs:attribute name="quality" type="JPEGQualityType"> |
| 466 |
<xs:annotation><xs:documentation> |
| 467 |
Only applies when method=JPEG. |
| 468 |
If not specified, if the source raster is a JPEG file, its |
| 469 |
codestream will be used directly. Otherwise, the image will |
| 470 |
be compressed with a quality of 75%. |
| 471 |
</xs:documentation></xs:annotation> |
| 472 |
</xs:attribute> |
| 473 |
<xs:attribute name="predictor" type="xs:boolean" default="false"> |
| 474 |
<xs:annotation><xs:documentation> |
| 475 |
Only applies when method=DEFALTE |
| 476 |
</xs:documentation></xs:annotation> |
| 477 |
</xs:attribute> |
| 478 |
</xs:complexType> |
| 479 |
|
| 480 |
<xs:simpleType name="JPEGQualityType"> |
| 481 |
<xs:restriction base="xs:int"> |
| 482 |
<xs:minInclusive value="1"/> |
| 483 |
<xs:maxInclusive value="100"/> |
| 484 |
</xs:restriction> |
| 485 |
</xs:simpleType> |
| 486 |
|
| 487 |
<xs:simpleType name="RasterCompressionMethodType"> |
| 488 |
<xs:restriction base="xs:string"> |
| 489 |
<xs:enumeration value="DEFLATE"/> |
| 490 |
<xs:enumeration value="JPEG"/> |
| 491 |
<xs:enumeration value="JPEG2000"/> |
| 492 |
</xs:restriction> |
| 493 |
</xs:simpleType> |
| 494 |
|
| 495 |
<xs:complexType name="VectorType"> |
| 496 |
<xs:annotation><xs:documentation> |
| 497 |
Insert vector content from a OGR dataset. |
| 498 |
|
| 499 |
There are two modes: |
| 500 |
- The coordinates of the vector features must be in PDF coordinate units. |
| 501 |
This is when the georeferencingId attributes is not set. |
| 502 |
|
| 503 |
- another one, when the georeferencingId attribute is defined, and |
| 504 |
reference a georeferenced area. In that case, the vector georeferenced |
| 505 |
coordinates will be used to correctly place it in the georeferenced area. |
| 506 |
|
| 507 |
Note: OGR Feature Style strings containing a LABEL tool will not work with |
| 508 |
this element, to display labels use a VectorLabel element instead. |
| 509 |
</xs:documentation></xs:annotation> |
| 510 |
<xs:sequence> |
| 511 |
<xs:element name="Blending" type="BlendingType" minOccurs="0"/> |
| 512 |
<xs:element name="LogicalStructure" type="LogicalStructureType" minOccurs="0"/> |
| 513 |
</xs:sequence> |
| 514 |
<xs:attribute name="dataset" type="xs:string" use="required"> |
| 515 |
<xs:annotation><xs:documentation> |
| 516 |
OGR dataset name |
| 517 |
</xs:documentation></xs:annotation> |
| 518 |
</xs:attribute> |
| 519 |
<xs:attribute name="layer" type="xs:string" use="required"> |
| 520 |
<xs:annotation><xs:documentation> |
| 521 |
OGR layer name |
| 522 |
</xs:documentation></xs:annotation> |
| 523 |
</xs:attribute> |
| 524 |
<xs:attribute name="georeferencingId" type="xs:string"> |
| 525 |
<xs:annotation><xs:documentation> |
| 526 |
References a georeferenced area in the same page |
| 527 |
through its Georeferencing#id |
| 528 |
</xs:documentation></xs:annotation> |
| 529 |
</xs:attribute> |
| 530 |
<xs:attribute name="visible" type="xs:boolean" default="true"> |
| 531 |
<xs:annotation><xs:documentation> |
| 532 |
Whether objects should be drawn or not |
| 533 |
</xs:documentation></xs:annotation> |
| 534 |
</xs:attribute> |
| 535 |
<xs:attribute name="linkAttribute" type="xs:string"> |
| 536 |
<xs:annotation><xs:documentation> |
| 537 |
Name of the attribute whose value is used to create a hyperlink |
| 538 |
</xs:documentation></xs:annotation> |
| 539 |
</xs:attribute> |
| 540 |
<xs:attribute name="ogrStyleString" type="xs:string"> |
| 541 |
<xs:annotation><xs:documentation> |
| 542 |
String overriding per-feature style |
| 543 |
</xs:documentation></xs:annotation> |
| 544 |
</xs:attribute> |
| 545 |
</xs:complexType> |
| 546 |
|
| 547 |
<xs:complexType name="LogicalStructureType"> |
| 548 |
<xs:annotation><xs:documentation> |
| 549 |
The LogicalStructure element should be put when the features |
| 550 |
of the layer should be written in the logical structure of the |
| 551 |
document, and thus visible in the "Model Tree" of Acrobat reader. |
| 552 |
By default, all OGR fields are included. |
| 553 |
</xs:documentation></xs:annotation> |
| 554 |
<xs:sequence> |
| 555 |
<xs:choice minOccurs="0"> |
| 556 |
<xs:sequence> |
| 557 |
<xs:element name="ExcludeAllFields" type="xs:boolean" minOccurs="0" fixed="true"> |
| 558 |
<xs:annotation><xs:documentation> |
| 559 |
Whether all fields should be excluded, but the one(s) |
| 560 |
potentially mentioned in IncludeField. |
| 561 |
</xs:documentation></xs:annotation> |
| 562 |
</xs:element> |
| 563 |
<xs:element name="IncludeField" type="xs:string" minOccurs="0" maxOccurs="unbounded"> |
| 564 |
<xs:annotation><xs:documentation> |
| 565 |
Name of OGR field to include. |
| 566 |
</xs:documentation></xs:annotation> |
| 567 |
</xs:element> |
| 568 |
</xs:sequence> |
| 569 |
<xs:sequence> |
| 570 |
<xs:element name="IncludeAllFields" type="xs:boolean" minOccurs="0" fixed="true"> |
| 571 |
<xs:annotation><xs:documentation> |
| 572 |
Whether all fields should be included, but the one(s) |
| 573 |
potentially mentioned in ExcludeField. |
| 574 |
</xs:documentation></xs:annotation> |
| 575 |
</xs:element> |
| 576 |
<xs:element name="ExcludeField" type="xs:string" minOccurs="0" maxOccurs="unbounded"> |
| 577 |
<xs:annotation><xs:documentation> |
| 578 |
Name of OGR field to exclude. |
| 579 |
</xs:documentation></xs:annotation> |
| 580 |
</xs:element> |
| 581 |
</xs:sequence> |
| 582 |
</xs:choice> |
| 583 |
</xs:sequence> |
| 584 |
<xs:attribute name="displayLayerName" type="xs:string"> |
| 585 |
<xs:annotation><xs:documentation> |
| 586 |
Name of the layer that will appear in the PDF reader. |
| 587 |
If not specified, this will be the OGR layer name. |
| 588 |
</xs:documentation></xs:annotation> |
| 589 |
</xs:attribute> |
| 590 |
<xs:attribute name="fieldToDisplay" type="xs:string"> |
| 591 |
<xs:annotation><xs:documentation> |
| 592 |
Name of the OGR field whose value should be display for each |
| 593 |
feature in feature tree of the PDF reader. |
| 594 |
If not specified, this will "feature{FID}". |
| 595 |
</xs:documentation></xs:annotation> |
| 596 |
</xs:attribute> |
| 597 |
</xs:complexType> |
| 598 |
|
| 599 |
<xs:complexType name="VectorLabelType"> |
| 600 |
<xs:annotation><xs:documentation> |
| 601 |
Insert text labels for features from a OGR dataset. |
| 602 |
|
| 603 |
The features must be associated with a OGR Feature Style string with |
| 604 |
a LABEL tool. |
| 605 |
Only LATIN-1 characters will be correctly output. |
| 606 |
|
| 607 |
There are two modes: |
| 608 |
- The coordinates of the vector features must be in PDF coordinate units. |
| 609 |
This is when the georeferencingId attributes is not set. |
| 610 |
|
| 611 |
- another one, when the georeferencingId attribute is defined, and |
| 612 |
reference a georeferenced area. In that case, the vector georeferenced |
| 613 |
coordinates will be used to correctly place it in the georeferenced area. |
| 614 |
</xs:documentation></xs:annotation> |
| 615 |
<xs:sequence> |
| 616 |
<xs:element name="Blending" type="BlendingType" minOccurs="0"/> |
| 617 |
</xs:sequence> |
| 618 |
<xs:attribute name="dataset" type="xs:string" use="required"> |
| 619 |
<xs:annotation><xs:documentation> |
| 620 |
OGR dataset name |
| 621 |
</xs:documentation></xs:annotation> |
| 622 |
</xs:attribute> |
| 623 |
<xs:attribute name="layer" type="xs:string" use="required"> |
| 624 |
<xs:annotation><xs:documentation> |
| 625 |
OGR layer name |
| 626 |
</xs:documentation></xs:annotation> |
| 627 |
</xs:attribute> |
| 628 |
<xs:attribute name="georeferencingId" type="xs:string"> |
| 629 |
<xs:annotation><xs:documentation> |
| 630 |
References a georeferenced area in the same page |
| 631 |
through its Georeferencing#id |
| 632 |
</xs:documentation></xs:annotation> |
| 633 |
</xs:attribute> |
| 634 |
<xs:attribute name="ogrStyleString" type="xs:string"> |
| 635 |
<xs:annotation><xs:documentation> |
| 636 |
String overriding per-feature style |
| 637 |
</xs:documentation></xs:annotation> |
| 638 |
</xs:attribute> |
| 639 |
</xs:complexType> |
| 640 |
|
| 641 |
<xs:complexType name="BlendingType"> |
| 642 |
<xs:attribute name="function" type="BlendingFunctionType" default="Normal"/> |
| 643 |
<xs:attribute name="opacity" type="OpacityType" default="1"/> |
| 644 |
</xs:complexType> |
| 645 |
|
| 646 |
<xs:simpleType name="BlendingFunctionType"> |
| 647 |
<xs:annotation><xs:documentation> |
| 648 |
Blend mode as defined in PDF reference version 1.7 |
| 649 |
page 520, Table 7.2 "Standard separable blend modes". |
| 650 |
</xs:documentation></xs:annotation> |
| 651 |
<xs:restriction base="xs:string"> |
| 652 |
<xs:enumeration value="Normal"/> |
| 653 |
<xs:enumeration value="Multiply"/> |
| 654 |
<xs:enumeration value="Screen"/> |
| 655 |
<xs:enumeration value="Overlay"/> |
| 656 |
<xs:enumeration value="Darken"/> |
| 657 |
<xs:enumeration value="Lighten"/> |
| 658 |
<xs:enumeration value="ColorDodge"/> |
| 659 |
<xs:enumeration value="ColorBurn"/> |
| 660 |
<xs:enumeration value="HardLight"/> |
| 661 |
<xs:enumeration value="SoftLight"/> |
| 662 |
<xs:enumeration value="Difference"/> |
| 663 |
<xs:enumeration value="Exclusion"/> |
| 664 |
</xs:restriction> |
| 665 |
</xs:simpleType> |
| 666 |
|
| 667 |
<xs:simpleType name="OpacityType"> |
| 668 |
<xs:restriction base="xs:double"> |
| 669 |
<xs:minInclusive value="0"/> |
| 670 |
<xs:maxInclusive value="1"/> |
| 671 |
</xs:restriction> |
| 672 |
</xs:simpleType> |
| 673 |
|
| 674 |
<xs:complexType name="IfLayerOnType"> |
| 675 |
<xs:annotation><xs:documentation> |
| 676 |
Conditionalize content display to the On status of a layer. |
| 677 |
IfLayerOn elements can be nested. And in general, the nesting used |
| 678 |
to define the layers should be used to define the conditional |
| 679 |
content too, because toggling off a upper-level layer in Acrobat |
| 680 |
does not change the state of its children. |
| 681 |
|
| 682 |
For example: |
| 683 |
<Layer id="A" name="A"> |
| 684 |
<Layer id="A.1" name="A.1""></Layer> |
| 685 |
</Layer> |
| 686 |
|
| 687 |
<IfLayerOnType layerId="A"> |
| 688 |
<IfLayerOnType layerId="A.1"> |
| 689 |
.... |
| 690 |
</IfLayerOnType> |
| 691 |
</IfLayerOnType> |
| 692 |
</xs:documentation></xs:annotation> |
| 693 |
<xs:complexContent> |
| 694 |
<xs:extension base="ResursiveContentType"> |
| 695 |
<xs:attribute name="layerId" type="xs:string" use="required"> |
| 696 |
<xs:annotation><xs:documentation> |
| 697 |
Should reference a Layer#id attribute. |
| 698 |
</xs:documentation></xs:annotation> |
| 699 |
</xs:attribute> |
| 700 |
</xs:extension> |
| 701 |
</xs:complexContent> |
| 702 |
</xs:complexType> |
| 703 |
</xs:schema> |