CHAPTER 8
668
Interactive Features
When a set-OCG-state action is performed, the
State
array is processed from left
to right. Each name is applied to subsequent groups in the array until the next
name is encountered, as shown in the following example.
Example 8.13
<< /S /SetOCGState
/State [/OFF 2 0 R 3 0 R /Toggle 16 0 R 19 0 R /ON 5 0 R]
>>
A group can appear more than once in the
State
array; its state is set each time it
is encountered, based on the most recent name. For example, if the array con-
tained
[/OFF 1 0 R /Toggle 1 0 R]
, the group’s state would be
ON
after the action was
performed.
ON
,
OFF
and
Toggle
sequences have no required order. More than
one sequence in the array may contain the same name.
Note:
While the specification allows a group to appear more than once in the
State
array, this is not intended to implement animation or any other sequential drawing
operations. PDF processing applications are free to accumulate all state changes and
apply only the net changes simultaneously to all affected groups before redrawing.
Rendition Actions
A
rendition action (PDF 1.5)
controls the playing of multimedia content (see Sec-
•
To begin the playing of a rendition object (see Section 9.1.2, “Renditions”), as-
sociating it with a screen annotation (see “Screen Annotations” on page 639).
The screen annotation specifies where the rendition is played unless otherwise
specified.
•
To stop, pause, or resume a playing rendition.
•
To trigger the execution of a JavaScript script that may perform custom opera-
tions.