SECTION 9.5
791
3D Artwork
9.5.1 3D Annotations
3D annotations (PDF
1.6)
are the means by which 3D artwork is represented in a
PDF document. Table 9.33 shows the entries specific to a 3D annotation dictio-
nary. Table 8.15 on page 606 describes the entries common to all annotation dic-
tionaries.
In addition to these entries, a 3D annotation is required to provide an appearance
stream in its
AP
entry (see Table 8.15 on page 606) that has a normal appearance
(the
N
entry in Table 8.19 on page 614). This appearance can be used by applica-
tions that do not support 3D annotations and by all applications for the initial
display of the annotation.
TABLE 9.33 Additional entries specific to a 3D annotation
KEY
TYPE
VALUE
Subtype
name
stream or
dictionary
(various)
(Required)
The type of annotation that this dictionary describes; must be
3D
for
a 3D annotation.
(Required)
A 3D stream (see Section 9.5.2, “3D Streams”) or 3D reference dictio-
nary (see “3D Reference Dictionaries” on page 801) that specifies the 3D art-
work to be shown.
(Optional)
An object that specifies the default initial view of the 3D artwork that
should be used when the annotation is activated. It can be either a 3D view dic-
tionary (see Section 9.5.3, “3D Views”) or one of the following types specifying
an element in the
VA
array in the 3D stream (see Table 9.35):
3DD
3DV
•
An integer specifying an index into the
VA
array.
•
A text string matching the
IN
entry in one of the views in the
VA
array.
•
A name that indicates the first (
F
), last (
L
), or default (
D
) entries in the
VA
ar-
ray.
Default value: the default view in the 3D stream object specified by
3DD
.
3DA
dictionary
(Optional)
An
activation dictionary
(see Table 9.34) that defines the times at
which the annotation should be activated and deactivated and the state of the 3D
artwork instance at those times. Default value: an activation dictionary contain-
ing default values for all its entries.