<< Click to Display Table of Contents >> Navigation:  PDF Export > VpeAddColorProfile

[VPE Professional Edition and above]

Adds a Color Profile to the exported PDF document. A Color Profile is required when exporting to the PDF/A document format for long-term archival

void VpeAddColorProfile(

VpeHandle hDoc,

LPCSTR Subtype,

LPCSTR OutputCondition,

LPCSTR OutputConditionIdentifier,

LPCSTR RegistryName,

LPCSTR Info,

LPCSTR FileName

)

VpeHandle hDoc

Document Handle

LPCSTR Subtype

the sub-type of the color profile. See the PDF specification for details.

LPCSTR OutputCondition

the output condition for the color profile. Use "GTS_PDFA1", see the PDF specification for details.

LPCSTR OutputConditionIdentifier

the output condition identifier of the color profile. Use "Custom", see the PDF specification for details.

LPCSTR RegistryName

the registry name of the color profile. See the PDF specification for details.

LPCSTR Info

the info dictionary entry of the color profile. See the PDF specification for details.

LPCSTR FileName

the path and file name of the color profile file. VPE reads this file from hard disk end embeds it into the PDF document. VPE does not verify or convert the given file.

 

For convenience, VPE provides two built-in color profiles:

"sRGB_IEC61966-2-1" and "AdobeRGB1998"

If you specify either of both strings as FileName parameter, VPE will embed this profile from its internal memory. No external files are required.

Remarks:

VPE does not convert images to the given Color Profile. When adding images to a VPE document, you need to ensure that they match the Color Profile. Special care must be taken when using JPEG images: VPE embeds JPEG images in their original binary file format into PDF streams. That means, JPEG images in the CMYK format are embedded as CMYK into the document. Make sure they are converted to the given Color Profile, before importing them into a VPE document.

Example:

VpeSetPDFALevel(hDoc, VPE_PDF_A_LEVEL_1B);

VpeAddColorProfile(hDoc,

 "GTS_PDFA1",

 "sRGB_IEC61966-2-1",

 "Custom",

 "http://www.color.org",

 "sRGB_IEC61966-2-1",

 "sRGB_IEC61966-2-1");

VpeWriteDoc(hDoc, "test.pdf");