Debian Codegraph @

frmts/pdf/data/pdfcomposition.xsd

raw
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 &gt; x1 and y2 &gt; 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 &gt; x1 and y2 &gt; 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 &lt;Layer id="A" name="A"&gt;
684 &lt;Layer id="A.1" name="A.1""&gt;&lt;/Layer&gt;
685 &lt;/Layer&gt;
686
687 &lt;IfLayerOnType layerId="A"&gt;
688 &lt;IfLayerOnType layerId="A.1"&gt;
689 ....
690 &lt;/IfLayerOnType&gt;
691 &lt;/IfLayerOnType&gt;
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>