iPDFdev Tips & Tricks for PDF development

// By default a black color is created.
IFXPDFRgbColor* rgbColor = [[IFXPDFRgbColor alloc] init];
// Change the color properties to red.
rgbColor.red = 1;
rgbColor.green = 0;
rgbColor.blue = 0;
// ...
[rgbColor release];
//
// or
//
IFXPDFRgbColor* redColor = [[IFXPDFRgbColor alloc] initWithRed: 1 green: 0 blue: 0];
// ...
[redColor release];
// 
// or get an autoreleased color
// 
IFXPDFRgbColor* blueColor = [IFXPDFRgbColor rgbColorWithRed: 0 green: 0 blue: 1];
//
// or use one of the predefined colors
//
IFXPDFRgbColor* greenColor = [IFXPDFRgbColor greenColor];

// By default a black color is created.
IFXPDFCmykColor* cmykColor = [[IFXPDFCmykColor alloc] init];
// Change the color properties to cyan.
cmykColor.c = 1;
cmykColor.m = 0;
cmykColor.y = 0;
cmykColor.k = 0; 
// ...
[cmykColor release];
//
// or
//
IFXPDFCmykColor* cyanColor = [[IFXPDFCmykColor alloc] initWithC: 1 m: 0 y: 0 k: 0];
// ...
[cyanColor release];
// 
// or get an autoreleased color
// 
IFXPDFCmykColor* magentaColor = [IFXPDFCmykColor cmykColorWithC: 0 m: 1 y: 0 k: 0];

// By default a black color is created.
IFXPDFGrayColor* grayColor = [[IFXPDFGrayColor alloc] init];
// Change the color properties to medium gray.
grayColor.g = 0.5;
// ...
[grayColor release];
//
// or
//
IFXPDFGrayColor* mediumGrayColor = [[IFXPDFGrayColor alloc] initWithG: 0.5];
// ...
mediumGrayColor release];
// 
// or get an autoreleased color
// 
IFXPDFGrayColor* lightGrayColor = [IFXPDFGrayColor grayColorWithG: 0.75];

// class method calGrayColorSpace creates a default CalGray colorspace
IFXPDFCalGrayColorSpace* calGrayColorSpace = [IFXPDFCalGrayColorSpace calGrayColorSpace];
 
// CalGray colors can be created using a convenient class method that returns an autoreleased object
IFXPDFCalGrayColor* calGrayLightGrayColor = [IFXPDFCalGrayColor calGrayColorWithColorSpace: calGrayColorSpace andGray: 0.9];
// or using the designated class initializer
IFXPDFCalGrayColor* calGrayDarkGrayColor = [[IFXPDFCalGrayColor alloc] initWithCalGrayColorSpace: calGrayColorSpace];
calGrayDarkGrayColor.gray = 0.3;
// ...
[calGrayDarkGrayColor release];

// class method calRGBColorSpace creates a default CalRGB colorspace
IFXPDFCalRGBColorSpace* calRgbColorSpace = [IFXPDFCalRGBColorSpace calRGBColorSpace];
 
// CalRGB colors can be created using a convenient class method that returns an autoreleased object
IFXPDFCalRGBColor* calRgbRedColor =
    [IFXPDFCalRGBColor calRGBColorWithColorSpace: calRgbColorSpace andRed: 1 green: 0 blue:0];
// or using the designated class initializer
IFXPDFCalRGBColor* calRgbGreenColor = [[IFXPDFCalGrayColor alloc] initWithCalRGBColorSpace: calRgbColorSpace];
calRgbGreenColor.red = 0;
calRgbGreenColor.green = 0.9;
calRgbGreenColor.blue = 0;
// ...
[calRgbGreenColor release];

// class method indexedColorSpace creates a default indexed colorspace
IFXPDFIndexedColorSpace* indexedColorSpace = [IFXPDFIndexedColorSpace indexedColorSpace];
// the colorspace defines only 2 colors based on RGB colorspace (3 bytes per color)
Byte colorTable[] = { 255, 0, 0, 192, 0, 192 };
indexedColorSpace.colorTable = [NSData dataWithBytes: colorTable length: sizeof(colorTable)];
// maxIndex for colors defined on this colorspace is number of colors - 1.
indexedColorSpace.maxIndex = 1;
// the color samples in the colorTable are defined in the RGB colorspace.
indexedColorSpace.baseColorSpace = [IFXPDFRgbColorSpace rgbColorSpace];
// a color can be created like this
IFXPDFIndexedColor* redColor = [IFXPDFIndexedColor indexedColorWithColorSpace: indexedColorSpace andColorIndex: 0];
// or like this
IFXPDFIndexedColor* violetColor = [[IFXPDFIndexedColor alloc] initWithIndexedColorSpace: indexedColorSpace];
violetColor.colorIndex = 1;
// use the color
// ...
[violetColor release];

// Load theICC profile from the rgb.icc file
NSString *iccFile = [[NSBundle mainBundle] pathForResource:@"rgb" ofType:@"icc"];
NSData *iccData = [NSData dataWithContentsOfFile: iccFile];
 
// Get a default ICC colorspace
IFXPDFIccColorSpace* iccColorSpace = [IFXPDFIccColorSpace iccColorSpace];
// Set the profile data. The color components are interpreted in the context of the ICC profile.
iccColorSpace.profileData = iccData;
// Set the alternate colorspace, it acts as a fallback colorspace for applications that do not support the ICC profile.
// Must be compatible with the profile (if ICC profile is RGB based do not set CMYK as alternate colorspace)
iccColorSpace.alternateColorSpace = [IFXPDFRgbColorSpace rgbColorSpace];
// Set that number of components that represent a color in the ICC colorspace
iccColorSpace.colorComponentsCount = 3;
 
// Create an ICC color and set its components.
// For an RGB based ICC colorspace the first 3 elements in the colorComponents array are set.
IFXPDFIccColor* redColor = [IFXPDFIccColor iccColorWithColorSpace: iccColorSpace];
// The values must be in 0 - 1 range or the output will be undefined.
redColor.colorComponents[0] = 1;
redColor.colorComponents[1] = 0;
redColor.colorComponents[2] = 0;
IFXPDFIccColor* blueColor = [IFXPDFIccColor iccColorWithColorSpace: iccColorSpace];
blueColor.colorComponents[0] = 0;
blueColor.colorComponents[1] = 0;
blueColor.colorComponents[2] = 0.75;

// Create a default Lab colorspace
IFXPDFLabColorSpace* labColorSpace = [IFXPDFLabColorSpace labColorSpace];
// Create some autoreleased colors
IFXPDFLabColor* color1 = [IFXPDFLabColor labColorWithColorSpace: labColorSpace andL: 90 a: 20 b:-10];
IFXPDFLabColor* color2 = [IFXPDFLabColor labColorWithColorSpace: labColorSpace andL: 10 a: 70 b: -50];
// or
IFXPDFLabColor* color3 = [[IFXPDFLabColor alloc] initWithLabColorSpace: labColorSpace];
color3.L = 90;
color3.a = 20;
color3.b = -10;
// ...
[color3 release];

// Setup the tint transform function, it maps a tint value to 4 CMYK colour components.
IFXPDFExponentialFunction* orangeTintTransform = [[IFXPDFExponentialFunction alloc] init];
double domain[] = { 0, 1 };
orangeTintTransform.domain = [IFXPDFNumberArray arrayWithDoubles: domain length: 2];
double range[] = { 0, 1, 0, 1, 0, 1, 0, 1 };
orangeTintTransform.range = [IFXPDFNumberArray arrayWithDoubles: range length: 8];
orangeTintTransform.exponent = 1;
double c0[] = { 0, 0, 0, 0 };
orangeTintTransform.c0 = [IFXPDFNumberArray arrayWithDoubles: c0 length: 4];
double orangeC1[] = { 0, 0.53, 1, 0 };
orangeTintTransform.c1 = [IFXPDFNumberArray arrayWithDoubles: orangeC1 length: 4];
// Create an empty separation colour space. By default the alternateColorSpace is set to CMYK
IFXPDFSeparationColorSpace* orangeColorSpace = [IFXPDFSeparationColorSpace separationColorSpace];
// Set the name of the colorant represented by the colorspace
orangeColorSpace.colorant = @"PANTONE Orange 021 C";
// Set the tint transform
orangeColorSpace.tintTransform = orangeTintTransform;
[orangeTintTransform release];
// Create the separation color.
IFXPDFSeparationColor* darkOrangeColor = [IFXPDFSeparationColor separationColorWithColorSpace: orangeColorSpace andTint: 0.9];
// or
IFXPDFSeparationColor* lightOrangeColor = [[IFXPDFSeparationColor alloc] initWithSeparationColorSpace: orangeColorSpace];
lightOrangeColor.tint = 0.2;
// ...
[lightOrangeColor release];