AddPRCAnnotationFromFile

3D, annotations, engineering documents, PDF 2.0

Description

Embeds a PRC model from a file as a printable 3D annotation on the current page

Syntax

Delphi

Function TPDFlib.AddPRCAnnotationFromFile(Left, Top, Width, Height: Double; Const FileName, Title, ViewName: WideString; Activation: TPDFlibRichMediaActivation; Deactivation: TPDFlibRichMediaDeactivation; Options: Integer): Integer;

DLL

int DLAddPRCAnnotationFromFile(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t *FileName, const wchar_t *Title, const wchar_t *ViewName, int Activation, int Deactivation, int Options);

ActiveX

Function PDFlib::AddPRCAnnotationFromFile(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, Title As String, ViewName As String, Activation As Long, Deactivation As Long, Options As Long) As Long

Parameters

Left, Top	Position of the upper-left corner of the annotation rectangle
Width, Height	Positive dimensions of the annotation rectangle
FileName	Path to a non-empty PRC model
Title	Accessible annotation description
ViewName	Name of the default 3D view
Activation	`rmaExplicit`, `rmaPageOpened`, or `rmaPageVisible`
Deactivation	`rmdExplicit`, `rmdPageClosed`, or `rmdPageInvisible`
Options	`0` hides the 3D artwork initially and `1` displays it initially

Return values

Returns 1 on success or 0 on invalid input or an unreadable file

Remarks

The method promotes ordinary output to PDF 2.0 and supports PDF/A-4e but rejects other PDF/A profiles

The generated graph includes the PRC data stream, a named default view, activation and deactivation settings, printable flags, and a normal appearance