Action Hotspots are a special kind of hotspot that can be used to control other page objects such as cardflip, videos and page layers etc. An Action hotspot contains the name of the object and one or more actions for the object to perform when the action is triggered.
You can think of an Action hotspot as a kind of button, and when the button is tapped it will trigger the named object to perform the action. It does not have to look like a button of course, as an Action hotspot has no visual characteristics whatsoever but is simply a defined region on a page layer. Any required visual element is provided by the actual underlying page content itself.
Please refrain from applying animations or actions to transform the size of PDF's. This may result in broken content.
The Hotspot Name for an Action hotspot is as follows:
Object identifiers are a reference to some element of the current page, such as an in-page slideshow, video, widget or an individual page layer. Directives are the actions you wish the object to perform and vary depending on the type of object.
Here we have grouped together some similar types of objects under generic terms for the sake of brevity. There are several kinds of slide shows, and many kinds of widgets but each group exhibits the same actionable behaviour. Throughout the rest of this document we shall refer to the generic object type rather than the specific identifiers.
The following table contains a description of those generic terms and some examples:
|Layer||A page layer referenced by number||Layer1 (i.e. P1-1.pdf)|
|Slideshow||An in-page slide show||IPS1, VIPS1|
|Video||An in-page video||IPV1|
|Cardflip||A Cardflip object||Cardflip1|
|Widget||Any other built-in or custom widget||Flipbook1, Map1, Twitter1|
|Object||An in-page object||Object1|
Not all actions can influence all objects, and indeed there are certain combinations that are nonsensical. For example, telling a Cardflip to pause, or telling a video to go to page 6. The table below lists the available actions for each type of object.
The action directives and their syntax:
|Animation||Any built-in or custom animation||FadeOut, MoveInFromLeft|
|Size=width:height||Change the size of the object. Specify the width and height in pixels, or “original” to return to the original size||Size=200:400, Size=original|
|Position=x:y||Change the on-screen position of the object. Specify the x,y coordinates or “original” to return to the starting position. Negative values can be used to move off-screen.||Position=50:240, Position=0:-200, Position=original|
|Page=n||Tell the object to transition to a specific page (or slide) by supplying an absolute page/slide number. Use the relative terms “next”, “prev”, “first”, “last” to move without using page numbers.||Page=5, Page=next, Page=first|
|Flip||A specific action to make Cardflip turn over to it's opposite side. Note that Cardflip can be set to a specific side by using Page=1 (front) or Page=2 (back)||flip|
|Stop/Play/Pause||Actions to control media playback. Works on video v9+, support for audio was added in v21.0.0||stop, play, pause|
The visual style of some actions can be modified using an action modifier. These are additional directives that don't perform any action on their own, but influence the behaviour of a particular action. The available Action modifiers are listed in the table below:
|Transition||The Transition modifier sets the style of animation used by the Page action when transitioning between pages/slides.|
An Action hotspot typically lists multiple actions for a specific object to perform. For example we may want to have a layer animate onto the screen while simultaneously fading in. This is done by simply listing all the directives separated by commas:
But what if we wanted to influence several objects at once? This can be done by joining several distinct actions together. Each action will be performed just as if it was defined on it's own. For example, say we had three actions we wanted to perform all at once:
Action,Cardflip1,Flip Action,Layer1,FadeIn,MoveInFromLeft Action,Object1,Page=2,Size=512:512
To trigger these all at once from a single hotspot we would simply join them all together separated by commas:
View the Action Hotspot - Tabbed Reveal Tutorial video.
To view these files on your iPad click here to download Oomph Viewer onto your iPad. Once Oomph Viewer is installed download the Handy Book of Oomph in the Library section and preview all the Oomph features in one issue.
Got a question?