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

[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

method void VPE.AddColorProfile(

string Subtype,

string OutputCondition,

string OutputConditionIdentifier,

string RegistryName,

string Info,

string FileName

)

string Subtype

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

string OutputCondition

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

string OutputConditionIdentifier

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

string RegistryName

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

string Info

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

string 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:

Doc.PDFALevel = VPE_PDF_A_LEVEL_1B

Doc.AddColorProfile(

 "GTS_PDFA1",

 "sRGB_IEC61966-2-1",

 "Custom",

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

 "sRGB_IEC61966-2-1",

 "sRGB_IEC61966-2-1")

Doc.WriteDoc("test.pdf")