Table 299 – Entries in a 3D activation dictionary

Key

Type

Value

A

name

(Optional) A name specifying the circumstances under which the annotation shall be activated. Valid values are:

PO The annotation shall be activated as soon as the page containing the annotation is opened.

PV The annotation shall be activated as soon as any part of the page containing the annotation becomes visible.

XA The annotation shall remain inactive until explicitly activated by a script or user action.

NOTE 1 At any one time, only a single page shall be considered open in a conforming reader, even though more than one page may be visible, depending on the page layout.

Default value: XA.

NOTE 2 For performance reasons, documents intended for viewing in a web browser should use explicit activation (XA). In non-interactive applications, such as printing systems or aggregating conforming reader, PO and PV indicate that the annotation shall be activated when the page is printed or placed; XA indicates that the annotation shall never be activated and the normal appearance shall be used.

AIS

name

(Optional) A name specifying the state of the artwork instance upon activation of the annotation. Valid values are:

IThe artwork shall be instantiated, but real-time script-driven animations shall be disabled.

L Real-time script-driven animations shall be enabled if present; if not, the artwork shall be instantiated.

Default value: L.

NOTE 3 In non-interactive conforming readers, the artwork shall be instantiated and scripts shall be disabled.

D

name

(Optional) A name specifying the circumstances under which the annotation shall be deactivated. Valid values are:

PC The annotation shall be deactivated as soon as the page is closed.

PI The annotation shall be deactivated as soon as the page containing the annotation becomes invisible.

XD The annotation shall remain active until explicitly deactivated by a script or user action.

NOTE 4 At any one time, only a single page shall be considered open in the conforming reader, even though more than one page may be visible, depending on the page layout.

Default value: PI.

DIS

name

(Optional) A name specifying the state of the artwork instance upon deactivation of the annotation. Valid values are U (uninstantiated), I(instantiated), and L (live). Default value: U.

NOTE 5 If the value of this entry is L, uninstantiation of instantiated artwork is necessary unless it has been modified. Uninstantiation is never required in non-interactive conforming readers.

TB

boolean

(Optional; PDF 1.7) A flag indicating the default behavior of an interactive toolbar associated with this annotation. If true, a toolbar shall be displayed by default when the annotation is activated and given focus. If false, a toolbar shall not be displayed by default.

NOTE 6 Typically, a toolbar is positioned in proximity to the 3D annotation.

Default value: true.

NP

boolean

(Optional; PDF 1.7) A flag indicating the default behavior of the user interface for viewing or managing information about the 3D artwork. Such user interfaces can enable navigation to different views or can depict the hierarchy of the objects in the artwork (the model tree). If true, the user interface should be made visible when the annotation is activated. If false, the user interface should not be made visible by default.

Default value: false