DynaPDF Manual - Page 224
Previous Page 223 Index Next Page 225
Page 224 of 821
const PPDF* IPDF,
// Instance pointer
// X-Coordinate of the annotation
// Y-Coordinate of the annotation
// Width of the annotation
// Height of the Annotation
const char* Author,
// Optional author
const char* Name,
// Optional annotation name
const char* U3DFile, // Required U3D or PRC file
const char* Image)
// Optional image to display the closed annotation
The function creates a 3D annotation from a U3D or PRC file. The image is used to create the default
appearance of the annotation; it is shown when the annotation is deactivated or when viewing the
file with a viewer that does not support 3D annotations. If no image file is provided the background
is filled with the current field background color (see SetFieldBackColor()). Note that the default
background color is transparent, that means no background will be drawn if the color was not
The name must be unique if defined. Make sure that no other annotation exists with the same name.
Note that DynaPDF performs no duplicate check during creation of the annotation.
A 3D annotation requires usually at least a default view that defines the rendering mode and
lighting scheme to get suitable results (see Create3DView()). Without a view the viewer application
uses default settings to display the annotation.
This function is implemented in an Ansi and Unicode compatible version.
If the function succeeds the return value is the annotation handle, a value greater or equal zero. If
the function fails the return value is a negative error code.
Previous topic: CopyChoiceValues
Next topic: Create3DBackground, Create3DGotoViewAction