SetCapturedPageTransparencyGroup

Content Streams and Optional Content Groups, Page layout

Description

Sets a transparency group dictionary on a captured page XObject. Use it after CapturePage or CapturePageEx and before drawing the captured page when the captured content must be composited as a transparency group.

PDF version behavior: captured page transparency groups use the PDF 1.4 /Group transparency model. If the current document version is lower and the save version is not locked, SetCapturedPageTransparencyGroup automatically raises the document to PDF 1.4 and records transparency group in AutoBumpedFeatures. If the caller locks a lower save version, the compatibility gate rejects the save with LastErrorCode 602.

Syntax

Delphi

function TPDFlib.SetCapturedPageTransparencyGroup(CaptureID, CS, Isolate, Knockout: Integer): Integer;

ActiveX

Function PDFlib::SetCapturedPageTransparencyGroup(CaptureID As Long, CS As Long, Isolate As Long, Knockout As Long) As Long

DLL

int DLSetCapturedPageTransparencyGroup(int InstanceID, int CaptureID, int CS, int Isolate, int Knockout);

Parameters

CaptureID	The ID returned by CapturePage or CapturePageEx.
CS	The blending color space: 1 = `DeviceRGB`, 2 = `DeviceCMYK`.
Isolate	Set to 1 to isolate the transparency group from the backdrop; set to 0 for a non-isolated group.
Knockout	Set to 1 to enable knockout behavior inside the group; set to 0 for normal compositing.

Return values

0	The capture ID or color-space selector is invalid, or the current PDF/A mode forbids the transparency group.
1	The captured page transparency group was set successfully.