DynaPDF Manual - Page 233

Previous Page 232   Index   Next Page 234

Function Reference
Page 233 of 839
Create3DBackground
Syntax:
LBOOL pdfCreate3DBackground(
const PPDF* IPDF,
// Instance pointer
const void* IView, // 3D View handle
UI32 BackColor);
// RGB background color
The function creates a background dictionary for a 3D annotation that is used to change the
annotation’s background color. The background color must be defined in RGB color space.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
Create3DGotoViewAction
Syntax:
SI32 pdfCreate3DGotoViewAction(
const PPDF* IPDF,
// Instance pointer
UI32 Base3DAnnot,
// 3D Annotation handle
const void* IView,
// 3D View handle or
T3DNamedAction Named) // Named 3D action
typedef enum
{
naDefault,
naFirst,
naLast,
naNext,
naPrevious
}T3DNamedAction;
A GoTo3DView action can be used to dynamically change the view of a 3D annotation. If the
parameter IView is not NULL the created action opens explicitly the defined view. The parameter
Named is ignored in this case. If IView is NULL, the named action is used instead.
A GoTo3DView action can be used like any other action. The action can be added with
AddActionToObj() to a bookmark, page link, or interactive form field, e.g. a button field.
Remarks:
Due to certain bugs in the 3D rendering engine of Adobe’s Acrobat Reader versions prior to 7.0.9, go
to 3D view actions do not properly work in these Acrobat Reader versions. The bugs were solved in
Acrobat Reader 7.0.9. Make sure that your customers use the latest version.
Return values:
If the function succeeds the return value is the action handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
 

Previous topic: Create3DAnnot

Next topic: Create3DProjection, Perspective projection