PopplerAction: Poppler Reference Manual

PopplerAction

PopplerAction — Action links

Functions

PopplerAction *	poppler_action_copy ()
void	poppler_action_free ()
PopplerDest *	poppler_dest_copy ()
void	poppler_dest_free ()

Types and Values

	PopplerAction
	PopplerDest
struct	PopplerActionAny
struct	PopplerActionGotoDest
struct	PopplerActionGotoRemote
struct	PopplerActionLaunch
struct	PopplerActionUri
struct	PopplerActionNamed
struct	PopplerActionMovie
struct	PopplerActionRendition
struct	PopplerActionOCGState
struct	PopplerActionJavascript
enum	PopplerActionType
enum	PopplerDestType
enum	PopplerActionMovieOperation
	PopplerActionLayer
enum	PopplerActionLayerAction

Includes

#include <poppler.h>

Description

Functions

poppler_action_copy ()

PopplerAction *
poppler_action_copy (PopplerAction *action);

Copies action , creating an identical PopplerAction.

Parameters

action

a PopplerAction

Returns

a new action identical to action

poppler_action_free ()

void
poppler_action_free (PopplerAction *action);

Frees action

Parameters

action

a PopplerAction

poppler_dest_copy ()

PopplerDest *
poppler_dest_copy (PopplerDest *dest);

Copies dest , creating an identical PopplerDest.

Parameters

dest

a PopplerDest

Returns

a new destination identical to dest

poppler_dest_free ()

void
poppler_dest_free (PopplerDest *dest);

Frees dest

Parameters

dest

a PopplerDest

Types and Values

PopplerAction

A data structure for holding actions

PopplerDest

typedef struct {
	PopplerDestType type;

	int page_num;
	double left;
	double bottom;
	double right;
	double top;
	double zoom;
	gchar *named_dest;
	guint change_left : 1;
	guint change_top : 1;
	guint change_zoom : 1;
} PopplerDest;

Data structure for holding a destination

Members

PopplerDestType `type`;	type of destination
int `page_num`;	page number
double `left`;	left coordinate
double `bottom`;	bottom coordinate
double `right`;	right coordinate
double `top`;	top coordinate
double `zoom`;	scale factor
gchar *`named_dest`;	name of the destination (POPPLER_DEST_NAMED only)
guint `change_left` : 1;	whether left coordinate should be changed
guint `change_top` : 1;	whether top coordinate should be changed
guint `change_zoom` : 1;	whether scale factor should be changed

struct PopplerActionAny

struct PopplerActionAny {
	PopplerActionType type;
	gchar *title;
};

struct PopplerActionGotoDest

struct PopplerActionGotoDest {
	PopplerActionType type;
	gchar *title;

	PopplerDest *dest;
};

struct PopplerActionGotoRemote

struct PopplerActionGotoRemote {
	PopplerActionType type;
	gchar *title;

	gchar *file_name;
	PopplerDest *dest;
};

struct PopplerActionLaunch

struct PopplerActionLaunch {
	PopplerActionType type;
	gchar *title;

	gchar *file_name;
	gchar *params;
};

struct PopplerActionUri

struct PopplerActionUri {
	PopplerActionType type;
	gchar *title;

	char *uri;
};

struct PopplerActionNamed

struct PopplerActionNamed {
	PopplerActionType type;
	gchar *title;

	gchar *named_dest;
};

struct PopplerActionMovie

struct PopplerActionMovie {
        PopplerActionType           type;
        gchar                      *title;

        PopplerActionMovieOperation operation;
	PopplerMovie               *movie;
};

struct PopplerActionRendition

struct PopplerActionRendition {
	PopplerActionType type;
	gchar            *title;

	gint               op;
	PopplerMedia      *media;
};

struct PopplerActionOCGState

struct PopplerActionOCGState {
	PopplerActionType type;
	gchar            *title;

	GList            *state_list;
};

struct PopplerActionJavascript

struct PopplerActionJavascript {
	PopplerActionType  type;
	gchar 		  *title;

	gchar		  *script;
};

enum PopplerActionType

Action types

Members

POPPLER_ACTION_UNKNOWN	unknown action
POPPLER_ACTION_NONE	no action specified
POPPLER_ACTION_GOTO_DEST	go to destination
POPPLER_ACTION_GOTO_REMOTE	go to destination in another document
POPPLER_ACTION_LAUNCH	launch app (or open document
POPPLER_ACTION_URI	URI
POPPLER_ACTION_NAMED	predefined action
POPPLER_ACTION_MOVIE	play movies. Since 0.14
POPPLER_ACTION_RENDITION	play multimedia content. Since 0.14
POPPLER_ACTION_OCG_STATE	state of layer. Since 0.14
POPPLER_ACTION_JAVASCRIPT	Javascript. Since 0.18

enum PopplerDestType

Destination types

Members

POPPLER_DEST_UNKNOWN	unknown destination
POPPLER_DEST_XYZ	go to page with coordinates (left, top) positioned at the upper-left corner of the window and the contents of the page magnified by the factor zoom
POPPLER_DEST_FIT	go to page with its contents magnified just enough to fit the entire page within the window both horizontally and vertically
POPPLER_DEST_FITH	go to page with the vertical coordinate top positioned at the top edge of the window and the contents of the page magnified just enough to fit the entire width of the page within the window
POPPLER_DEST_FITV	go to page with the horizontal coordinate left positioned at the left edge of the window and the contents of the page magnified just enough to fit the entire height of the page within the window
POPPLER_DEST_FITR	go to page with its contents magnified just enough to fit the rectangle specified by the coordinates left, bottom, right, and top entirely within the window both horizontally and vertically
POPPLER_DEST_FITB	go to page with its contents magnified just enough to fit its bounding box entirely within the window both horizontally and vertically
POPPLER_DEST_FITBH	go to page with the vertical coordinate top positioned at the top edge of the window and the contents of the page magnified just enough to fit the entire width of its bounding box within the window
POPPLER_DEST_FITBV	go to page with the horizontal coordinate left positioned at the left edge of the window and the contents of the page magnified just enough to fit the entire height of its bounding box within the window
POPPLER_DEST_NAMED	got to page specified by a name. See `poppler_document_find_dest()`

enum PopplerActionMovieOperation

Movie operations

Members

POPPLER_ACTION_MOVIE_PLAY	play movie
POPPLER_ACTION_MOVIE_PAUSE	pause playing movie
POPPLER_ACTION_MOVIE_RESUME	resume paused movie
POPPLER_ACTION_MOVIE_STOP	stop playing movie

Since: 0.14

PopplerActionLayer

typedef struct {
	PopplerActionLayerAction action;
	GList *layers;
} PopplerActionLayer;

Action to perform over a list of layers

Members

PopplerActionLayerAction `action`;	a PopplerActionLayerAction
GList *`layers`;	list of PopplerLayers

enum PopplerActionLayerAction

Layer actions

Members

POPPLER_ACTION_LAYER_ON	set layer visibility on
POPPLER_ACTION_LAYER_OFF	set layer visibility off
POPPLER_ACTION_LAYER_TOGGLE	reverse the layer visibility state

Since: 0.14