BasicDrawing

A python version of the BasicDrawing example in the book “Programming with Quartz”. This shows how to use most of the core API’s in Quartz/CoreGraphics.

Sources

AppDrawing.py

from Quartz import *

import Utilities
import UIHandling
import Images
import ImageMasking
import BitmapContext
import EPSPrinting
import CoordinateSystem
import PathDrawing
import ColorAndGState
import QuartzTextDrawing
import PatternDrawing
import ShadowsAndTransparencyLayers
import Shadings
import DrawingBasics


# Defines
kCatPDF          = "Kitty.pdf"
kPDFForBlendMode = "blendmode.pdf"

kOurJPEG          = "Poot.jpg"
kQTImage          = "ptlobos.tif"
kOurSubstituteJPG = "LyingOnDeckNoProfile.JPG"
kOurEPS           = "imageturkey.eps"

RAW_IMAGE_WIDTH   = 400
RAW_IMAGE_HEIGHT  = 300
kRawColorImage    = "image-400x300x24.raw"
kOtherColorImage  = "otherimage-400x300x24.raw"

MASKING_IMAGE_WIDTH  = 400
MASKING_IMAGE_HEIGHT = 259
kMaskingImage        = "400x259x8.bw.raw"

noOffScreen     = 0
bitmapOffScreen = 1
layerOffScreen  = 2

# Cache info for GetURL
_mainBundle = None
_urlMap = {}

def GetURL(name):
    """
    Returns the CFURLRef for an embeded resource, or None of that cannot be found.
    """

    global _mainBundle
    if _mainBundle is None:
        _mainBundle = Utilities.getAppBundle()

    mainBundle = _mainBundle
    if mainBundle is not None:
        if name in _urlMap:
            return _urlMap[name]

        url = CFBundleCopyResourceURL(mainBundle, name, None, None)
        _urlMap[name] = url
    else:
        print >>sys.stderr, "Can't get the app bundle!"
        return

    if url is None:
        print >>sys.stderr, "Couldn't get URL for %r"%(name,)

    return url

#
# Helper functions for drawing
#

def callPDFDrawProc(context, proc, pdfFile):
    ourPDFurl = GetURL(pdfFile)

    if ourPDFurl:
        proc(context, ourPDFurl)

def doDrawJPEGFile(context):
    ourJPEGurl = GetURL(kOurJPEG)

    if ourJPEGurl is not None:
        Images.drawJPEGImage(context, ourJPEGurl)


def doRawImageFileWithURL(context):
    url = GetURL(kRawColorImage)

    if url is not None:
        Images.drawImageFromURL(context, url,
            RAW_IMAGE_WIDTH, RAW_IMAGE_HEIGHT,
            8, True);   # 8 bits per component, isColor = True


def doRawImageFileWithCallbacks(context):
    url = GetURL(kRawColorImage)

    if url is not None:
        Images.doImageWithCallbacksCreatedFromURL(context, url,
                RAW_IMAGE_WIDTH, RAW_IMAGE_HEIGHT,
                8, True);   # 8 bits per component, isColor = True


def doDrawImageWithCGImageSource(context):
    url = GetURL(kOurJPEG)
    if url is not None:
        Images.drawImageWithCGImageDataSource(context, url)

def doIncrementalImage(context):
    url = GetURL(kOurJPEG)

    if url is not None:
        Images.doIncrementalImageWithURL(context, url)

def doQTImage(context):
    url = GetURL(kQTImage)

    if url is not None:
        Images.drawQTImageWithQuartz(context, url)


def doJPEGDocumentWithMultipleProfiles(context):
    url = GetURL(kOurSubstituteJPG)

    if url is not None:
        Images.drawJPEGDocumentWithMultipleProfiles(context, url)

def doMaskImageWithMask(context):
    theImageToMaskURL = GetURL(kOtherColorImage)
    theMaskingImageURL = GetURL(kMaskingImage)

    if theImageToMaskURL is not None and  theMaskingImageURL is not None:
        ImageMasking.doMaskImageWithMaskFromURL(context, theImageToMaskURL, RAW_IMAGE_WIDTH,
                            RAW_IMAGE_HEIGHT, 8, theMaskingImageURL, MASKING_IMAGE_WIDTH,
                            MASKING_IMAGE_HEIGHT)

def doMaskImageWithGrayImage(context):
    theImageToMaskURL = GetURL(kOtherColorImage)
    theMaskingImageURL = GetURL(kMaskingImage)

    if theImageToMaskURL is not None and theMaskingImageURL is not None:
        ImageMasking.doMaskImageWithGrayImageFromURL(context, theImageToMaskURL, RAW_IMAGE_WIDTH,
                            RAW_IMAGE_HEIGHT, 8, theMaskingImageURL, MASKING_IMAGE_WIDTH,
                            MASKING_IMAGE_HEIGHT)

def doImageMaskedWithColor(context):
    url = GetURL(kOtherColorImage)

    if url is not None:
        ImageMasking.doMaskImageWithColorFromURL(context, url,
                        RAW_IMAGE_WIDTH, RAW_IMAGE_HEIGHT,
                        True)

def exportImageMaskedWithImage(context):
    theImageToMaskURL = GetURL(kOtherColorImage)
    theMaskingImageURL = GetURL(kMaskingImage)

    if theImageToMaskURL is not None and theMaskingImageURL is not None:
        ImageMasking.exportImageWithMaskFromURLWithDestination(
                context, theImageToMaskURL, RAW_IMAGE_WIDTH,
                RAW_IMAGE_HEIGHT, 8, theMaskingImageURL,
                MASKING_IMAGE_WIDTH, MASKING_IMAGE_HEIGHT)

def doClipMask(context):
    theMaskingImageURL = GetURL(kMaskingImage)

    if theMaskingImageURL is not None:
        ImageMasking.drawWithClippingMask(context,
            theMaskingImageURL, MASKING_IMAGE_WIDTH, MASKING_IMAGE_HEIGHT)

def tilePDFDocument(context, offscreenType):
    url = GetURL(kCatPDF)

    if url is not None:
        if offscreenType == noOffScreen:
            BitmapContext.TilePDFNoBuffer(context, url)
        elif offscreenType == bitmapOffScreen:
            BitmapContext.TilePDFWithOffscreenBitmap(context, url)
        else:
            BitmapContext.TilePDFWithCGLayer(context, url)

def doCompatibleEPSDrawing(context):
    ourEPSurl = GetURL(kOurEPS)

    if ourEPSurl is not None:
        EPSPrinting.drawEPSDataImage(context, ourEPSurl)


def DispatchDrawing(context, drawingType):
    """ Drawing dispatcher """
    if drawingType == UIHandling.kHICommandSimpleRect:
        DrawingBasics.doSimpleRect(context)

    elif drawingType == UIHandling.kHICommandStrokedRect:
        DrawingBasics.doStrokedRect(context)

    elif drawingType == UIHandling.kHICommandStrokedAndFilledRect:
        DrawingBasics.doStrokedAndFilledRect(context)

    elif drawingType == UIHandling.kHICommandPathRects:
        DrawingBasics.doPathRects(context)

    elif drawingType == UIHandling.kHICommandAlphaRects:
        DrawingBasics.doAlphaRects(context)

    elif drawingType == UIHandling.kHICommandDashed:
        DrawingBasics.doDashedLines(context)

    elif drawingType == UIHandling.kHICommandSimpleClip:
        DrawingBasics.doClippedCircle(context)

    elif drawingType == UIHandling.kHICommandPDFDoc:
        callPDFDrawProc(context, DrawingBasics.doPDFDocument, kCatPDF)

    elif drawingType == UIHandling.kHICommandRotatedEllipses:
        CoordinateSystem.doRotatedEllipses(context)

    elif drawingType == UIHandling.kHICommandDrawSkewCoordinates:
        CoordinateSystem.drawSkewedCoordinateSystem(context)

    elif drawingType == UIHandling.kHICommandBezierEgg:
        PathDrawing.doEgg(context)

    elif drawingType == UIHandling.kHICommandRoundedRects:
        PathDrawing.doRoundedRects(context)

    elif drawingType == UIHandling.kHICommandStrokeWithCTM:
        PathDrawing.doStrokeWithCTM(context)

    elif drawingType == UIHandling.kHICommandRotatedEllipsesWithCGPath:
        PathDrawing.doRotatedEllipsesWithCGPath(context)

    elif drawingType == UIHandling.kHICommandPixelAligned:
        PathDrawing.doPixelAlignedFillAndStroke(context)

    elif drawingType == UIHandling.kHICommandDeviceFillAndStrokeColor:
        ColorAndGState.doColorSpaceFillAndStroke(context)

    elif drawingType == UIHandling.kHICommandCLUTDrawGraphics:
        ColorAndGState.doIndexedColorDrawGraphics(context)

    elif drawingType == UIHandling.kHICommandDrawWithGlobalAlpha:
        ColorAndGState.drawWithGlobalAlpha(context)

    elif drawingType == UIHandling.kHICommandDrawWithBlendMode:
        callPDFDrawProc(context, ColorAndGState.drawWithColorBlendMode, kPDFForBlendMode)

    elif drawingType == UIHandling.kHICommandDrawWithColorRefs:
        ColorAndGState.drawWithColorRefs(context)

    elif drawingType == UIHandling.kHICommandFunctionsHaveOwnGSave:
        ColorAndGState.doClippedEllipse(context)

    elif drawingType == UIHandling.kHICommandDrawJPEGImage:
        doDrawJPEGFile(context)

    elif drawingType == UIHandling.kHICommandColorImageFromFile:
        doRawImageFileWithURL(context)

    elif drawingType == UIHandling.kHICommandColorImageFromData:
        Images.doColorRampImage(context)

    elif drawingType == UIHandling.kHICommandColorImageFromCallbacks:
        doRawImageFileWithCallbacks(context)

    elif drawingType == UIHandling.kHICommandGrayRamp:
        Images.doGrayRamp(context)

    elif drawingType == UIHandling.kHICommandDrawWithCGImageSource:
        doDrawImageWithCGImageSource(context)

    elif drawingType == UIHandling.kHICommandDrawWithCGImageSourceIncremental:
        doIncrementalImage(context)

    elif drawingType == UIHandling.kHICommandDrawWithQuickTime:
        doQTImage(context)

    elif drawingType == UIHandling.kHICommandSubstituteImageProfile:
        doJPEGDocumentWithMultipleProfiles(context)

    elif drawingType == UIHandling.kHICommandDoSubImage:
        Images.doColorRampSubImage(context)

    elif drawingType == UIHandling.kHICommandExportWithQuickTime:
        Images.exportColorRampImageWithQT(context)

    elif drawingType == UIHandling.kHICommandMaskTurkeyImage:
        ImageMasking.doOneBitMaskImages(context)

    elif drawingType == UIHandling.kHICommandImageMaskedWithMask:
        doMaskImageWithMask(context)

    elif drawingType == UIHandling.kHICommandImageMaskedWithGrayImage:
        doMaskImageWithGrayImage(context)

    elif drawingType == UIHandling.kHICommandMaskImageWithColor:
        doImageMaskedWithColor(context)

    elif drawingType == UIHandling.kHICommandClipToMask:
        doClipMask(context)

    elif drawingType == UIHandling.kHICommandExportWithCGImageDestination:
        exportImageMaskedWithImage(context)

    elif drawingType == UIHandling.kHICommandSimpleCGLayer:
        BitmapContext.doSimpleCGLayer(context)

    elif drawingType == UIHandling.kHICommandAlphaOnlyContext:
        BitmapContext.doAlphaOnlyContext(context)

    elif drawingType == UIHandling.kHICommandDrawNoOffScreenImage:
        tilePDFDocument(context, noOffScreen)

    elif drawingType == UIHandling.kHICommandDrawOffScreenImage:
        tilePDFDocument(context, bitmapOffScreen)

    elif drawingType == UIHandling.kHICommandDrawWithLayer:
        tilePDFDocument(context, layerOffScreen)

    elif drawingType == UIHandling.kHICommandQuartzRomanText:
        QuartzTextDrawing.drawQuartzRomanText(context)

    elif drawingType == UIHandling.kHICommandQuartzTextModes:
        QuartzTextDrawing.drawQuartzTextWithTextModes(context)

    elif drawingType == UIHandling.kHICommandQuartzTextMatrix:
        QuartzTextDrawing.drawQuartzTextWithTextMatrix(context)

    elif drawingType == UIHandling.kHICommandSimplePattern:
        PatternDrawing.doRedBlackCheckerboard(context)

    elif drawingType == UIHandling.kHICommandPatternPhase:
        PatternDrawing.doPatternPhase(context)

    elif drawingType == UIHandling.kHICommandPatternMatrix:
        PatternDrawing.doPatternMatrix(context)

    elif drawingType == UIHandling.kHICommandUncoloredPattern:
        PatternDrawing.doStencilPattern(context)

    elif drawingType == UIHandling.kHICommandDrawWithPDFPattern:
        callPDFDrawProc(context, PatternDrawing.drawWithPDFPattern, kCatPDF)

    elif drawingType == UIHandling.kHICommandSimpleShadow:
        ShadowsAndTransparencyLayers.drawSimpleShadow(context)

    elif drawingType == UIHandling.kHICommandShadowScaling:
        ShadowsAndTransparencyLayers.doShadowScaling(context)

    elif drawingType == UIHandling.kHICommandShadowProblems:
        ShadowsAndTransparencyLayers.showComplexShadowIssues(context)

    elif drawingType == UIHandling.kHICommandComplexShadow:
        ShadowsAndTransparencyLayers.showComplexShadow(context)

    elif drawingType == UIHandling.kHICommandMultipleShapeComposite:
        ShadowsAndTransparencyLayers.doLayerCompositing(context)

    elif drawingType == UIHandling.kHICommandFillAndStrokeWithShadow:
        ShadowsAndTransparencyLayers.drawFillAndStrokeWithShadow(context)

    elif drawingType == UIHandling.kHICommandPDFDocumentShadow:
        callPDFDrawProc(context, ShadowsAndTransparencyLayers.shadowPDFDocument, kCatPDF)

    elif drawingType == UIHandling.kHICommandSimpleAxialShading:
        Shadings.doSimpleAxialShading(context)

    elif drawingType == UIHandling.kHICommandExampleAxialShadings:
        Shadings.doExampleAxialShading(context)

    elif drawingType == UIHandling.kHICommandSimpleRadialShading:
        Shadings.doSimpleRadialShading(context)

    elif drawingType == UIHandling.kHICommandExampleRadialShadings:
        Shadings.doExampleRadialShadings(context)

    elif drawingType == UIHandling.kHICommandEllipseShading:
        Shadings.doEllipseShading(context)

    elif drawingType == UIHandling.kHICommandDoCompatibleEPS:
        doCompatibleEPSDrawing(context)

BitmapContext.py

import sys

import objc

from Quartz import *
import Quartz

from LaunchServices import * # kUTType* constants

import Utilities
import DrawingBasics
import AppDrawing

#import Carbon.QT


BEST_BYTE_ALIGNMENT = 16
def COMPUTE_BEST_BYTES_PER_ROW(bpr):
    return ((int(bpr) + BEST_BYTE_ALIGNMENT-1) & ~(BEST_BYTE_ALIGNMENT-1))

# We need to ensure that the raster data stays alive until we clean up
# the context, store it here.
_rasterDataForContext = {}

def createRGBBitmapContext(width, height, wantDisplayColorSpace, needsTransparentBitmap):
    # This routine allocates data for a pixel array that contains width*height
    # pixels where each pixel is 4 bytes. The format is 8-bit ARGB or XRGB, depending on
    # whether needsTransparentBitmap is true. In order to get the recommended
    # pixel alignment, the bytesPerRow is rounded up to the nearest multiple
    # of BEST_BYTE_ALIGNMENT bytes.

    # Minimum bytes per row is 4 bytes per sample * number of samples.
    bytesPerRow = width*4;
    # Round to nearest multiple of BEST_BYTE_ALIGNMENT.
    bytesPerRow = COMPUTE_BEST_BYTES_PER_ROW(bytesPerRow);

    # Allocate the data for the raster. The total amount of data is bytesPerRow
    # times the number of rows. The function 'calloc' is used so that the
    # memory is initialized to 0.
    try:
        rasterData = objc.allocateBuffer(int(bytesPerRow * height))
    except  MemoryError:
        return None

    # The wantDisplayColorSpace argument passed to the function determines
    # whether or not to use the display color space or the generic calibrated
    # RGB color space. The needsTransparentBitmap argument determines whether
    # create a context that records alpha or not.
    if wantDisplayColorSpace:
        cs = Utilities.getTheDisplayColorSpace()
    else:
        cs = Utilities.getTheCalibratedRGBColorSpace()

    if needsTransparentBitmap:
        transparency = kCGImageAlphaPremultipliedFirst
    else:
        transparency = kCGImageAlphaPremultipliedFirst

    context = CGBitmapContextCreate(rasterData, width, height, 8, bytesPerRow,
            cs, transparency)
    if context is None:
        return None

    _rasterDataForContext[context] = rasterData

    # Either clear the rect or paint with opaque white, depending on
    # the needs of the caller.
    if needsTransparentBitmap:
        # Clear the context bits so they are transparent.
        CGContextClearRect(context, CGRectMake(0, 0, width, height))

    else:
        # Since the drawing destination is opaque, first paint
        # the context bits to white.
        CGContextSaveGState(context)
        CGContextSetFillColorWithColor(context, Utilities.getRGBOpaqueWhiteColor())
        CGContextFillRect(context, CGRectMake(0, 0, width, height))
        CGContextRestoreGState(context)

    return context

def myCGContextGetBitmapInfo(c):
    if hasattr(Quartz, 'CGBitmapContextGetBitmapInfo'):
        return CGBitmapContextGetBitmapInfo(c)
    else:
        return CGBitmapContextGetAlphaInfo(c)

# createImageFromBitmapContext creates a CGImageRef
# from a bitmap context. Calling this routine
# transfers 'ownership' of the raster data
# in the bitmap context, to the image. If the
# image can't be created, this routine frees
# the memory associated with the raster.
def createImageFromBitmapContext(c):
    rasterData = _rasterDataForContext[c]
    # We own the data, hence remove from the mapping
    del _rasterDataForContext[c]

    imageDataSize = CGBitmapContextGetBytesPerRow(c)*CGBitmapContextGetHeight(c)

    if rasterData is None:
        fprintf(stderr, "Context is not a bitmap context!")

    # Create the data provider from the image data
    dataProvider = CGDataProviderCreateWithData(None,
                                rasterData,
                                imageDataSize,
                                None)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create data provider!"
        return None

    # Now create the image. The parameters for the image closely match
    # the parameters of the bitmap context. This code uses a NULL
    # decode array and shouldInterpolate is true.
    image = CGImageCreate(
                CGBitmapContextGetWidth(c),
                CGBitmapContextGetHeight(c),
                CGBitmapContextGetBitsPerComponent(c),
                CGBitmapContextGetBitsPerPixel(c),
                CGBitmapContextGetBytesPerRow(c),
                CGBitmapContextGetColorSpace(c),
                myCGContextGetBitmapInfo(c),
                dataProvider,
                None,
                True,
                kCGRenderingIntentDefault)

    if image is None:
        print >>sys.stderr, "Couldn't create image!"
        return None
    return image


def exportCGImageToFileWithQT(image, url, outputFormat, dpi):
    """
    Export an image using QuickTime API's.

    This function can't possibly work, as the relevant APIs aren't available
    through MacPython. The code below is mostly there in case someone fixes
    the MacPython QuickTime bindings.
    """
    return

    if outputFormat.lower() == kUTTypeTIFF.lower():
        imageExportType = kQTFileTypeTIFF;

    elif outputFormat.lower() == kUTTypePNG.lower():
        imageExportType = kQTFileTypePNG;

    elif outputFormat.lower() == kUTTypeJPEG.lower():
        imageExportType = kQTFileTypeJPEG;

    else:
        print >>sys.stderr, "Requested image export format %@s unsupported"%(outputFormat,)
        return

        result, dataRef, dataRefType = QTNewDataReferenceFromCFURL(url, 0,  None, None)
        if result == 0:
            result, graphicsExporter = OpenADefaultComponent(GraphicsExporterComponentType,
                                    imageExportType, graphicsExporter)
            if result == 0:
                result = GraphicsExportSetInputCGImage(graphicsExporter, image)
                if result == 0:
                    result = GraphicsExportSetResolution(graphicsExporter,
                                            FloatToFixed(dpi), FloatToFixed(dpi));
                if result == 0:
                    result = GraphicsExportSetOutputDataReference(
                                            graphicsExporter, dataRef, dataRefType);
                if result == 0:
                    result, sizeWritten = GraphicsExportDoExport(
                                            graphicsExporter, None)
                CloseComponent(graphicsExporter);

        if dataRef:
            DisposeHandle(dataRef);

        if result:
            print >>sys.stderr, "QT export got bad result = %d!"%(result,)


def exportCGImageToFileWithDestination(image, url, outputFormat, dpi):
    # Create an image destination at the supplied URL that
    # corresponds to the output image format. The destination will
    # only contain 1 image.
    imageDestination = CGImageDestinationCreateWithURL(url, outputFormat, 1, None)

    if imageDestination is None:
        print >>sys.stderr, "Couldn't create image destination!"
        return

    # Create an options dictionary with the X&Y resolution of the image
    options = {
        kCGImagePropertyDPIWidth: dpi,
        kCGImagePropertyDPIHeight: dpi,
    }

    # Add the image with the options dictionary to the destination.
    CGImageDestinationAddImage(imageDestination, image, options);

    # When all the images are added to the destination, finalize it.
    CGImageDestinationFinalize(imageDestination);

def MakeImageDocument(url, imageType, exportInfo):
    # First make a bitmap context for a US Letter size
    # raster at the requested resolution.
    dpi = exportInfo.dpi;
    width = int(8.5*dpi)
    height = int(11*dpi)

    # For JPEG output type the bitmap should not be transparent. If other types are added that
    # do not support transparency, this code should be updated to check for those types as well.
    needTransparentBitmap = (imageType.lower() != kUTTypeJPEG.lower())

    # Create an RGB Bitmap context using the generic calibrated RGB color space
    # instead of the display color space.
    useDisplayColorSpace = False;
    c = createRGBBitmapContext(width, height, useDisplayColorSpace, needTransparentBitmap)

    if c is None:
        print >>sys.stderr, "Couldn't make destination bitmap context"
        return memFullErr;

    # Scale the coordinate system based on the resolution in dots per inch.
    CGContextScaleCTM(c, dpi/72, dpi/72);

    # Set the font smoothing parameter to false since it's better to
    # draw any text without special LCD text rendering when creating
    # rendered data for export.
    if hasattr(Quartz, 'CGContextSetShouldSmoothFonts'):
        CGContextSetShouldSmoothFonts(c, False)

    # Set the scaling factor for shadows. This is a hack so that
    # drawing code that needs to know the scaling factor can
    # obtain it. Better would be that DispatchDrawing and the code
    # it calls would take this scaling factor as a parameter.
    Utilities.setScalingFactor(dpi/72)

    # Draw into that raster...
    AppDrawing.DispatchDrawing(c, exportInfo.command)

    # Set the scaling factor back to 1.0.
    Utilities.setScalingFactor(1.0)

    # Create an image from the raster data. Calling
    # createImageFromBitmapContext gives up ownership
    # of the raster data used by the context.
    image = createImageFromBitmapContext(c);

    # Release the context now that the image is created.
    del c

    if image is None:
        # Users of this code should update this to be an error code they find useful.
        return memFullErr

    # Now export the image.
    if exportInfo.useQTForExport:
        exportCGImageToFileWithQT(image, url, imageType, exportInfo.dpi)
    else:
        exportCGImageToFileWithDestination(image, url, imageType, exportInfo.dpi)


def MakeTIFFDocument(url, exportInfo):
    return MakeImageDocument(url, kUTTypeTIFF, exportInfo)

def MakePNGDocument(url, exportInfo):
    return MakeImageDocument(url, kUTTypePNG, exportInfo)

def MakeJPEGDocument(url, exportInfo):
    return MakeImageDocument(url, kUTTypeJPEG, exportInfo)

def createCGLayerForDrawing(c):
    rect = CGRectMake(0, 0, 50, 50)

    # Make the layer the size of the rectangle that
    # this code draws into the layer.
    layerSize = rect.size

    # Create the layer to draw into.
    layer = CGLayerCreateWithContext(c, layerSize, None);
    if layer is None:
        return None

    # Get the context corresponding to the layer.
    layerContext = CGLayerGetContext(layer)
    if layerContext is None:
        return None

    #$ Set the fill color to opaque black.
    CGContextSetFillColorWithColor(layerContext, Utilities.getRGBOpaqueBlackColor())

    # Draw the content into the layer.
    CGContextFillRect(layerContext, rect)

    # Now the layer has the contents needed.
    return layer

def doSimpleCGLayer(context):
    # Create the layer.
    layer = createCGLayerForDrawing(context)

    if layer is None:
        print >>sys.stderr, "Couldn't create layer!"
        return

    # Get the size of the layer created.
    s = CGLayerGetSize(layer)

    # Clip to a rect that corresponds to
    # a grid of 8x8 layer objects.
    CGContextClipToRect(context, CGRectMake(0, 0, 8*s.width, 8*s.height))

    # Paint 8 rows of layer objects.
    for j in range(8):
        CGContextSaveGState(context)
        # Paint 4 columns of layer objects, moving
        # across the drawing canvas by skipping a
        # square on the grid each time across.
        for i in range(4):
            # Draw the layer at the current origin.
            CGContextDrawLayerAtPoint(context,
                    CGPointZero,
                    layer);
            # Translate across two layer widths.
            CGContextTranslateCTM(context, 2*s.width, 0);

        CGContextRestoreGState(context)
        # Translate to the left one layer width on
        # even loop counts and to the right one
        # layer width on odd loop counts. Each
        # time through the outer loop, translate up
        # one layer height.
        if j % 2:
            CGContextTranslateCTM(context,
                s.width, s.height)
        else:
            CGContextTranslateCTM(context,
                -s.width, s.height)

def createAlphaOnlyContext(width, height):
    # This routine allocates data for a pixel array that contains
    # width*height pixels, each pixel is 1 byte. The format is
    # 8 bits per pixel, where the data is the alpha value of the pixel.

    # Minimum bytes per row is 1 byte per sample * number of samples.
    bytesPerRow = width;
    # Round to nearest multiple of BEST_BYTE_ALIGNMENT.
    bytesPerRow = COMPUTE_BEST_BYTES_PER_ROW(bytesPerRow);

    # Allocate the data for the raster. The total amount of data is bytesPerRow
    #// times the number of rows. The function 'calloc' is used so that the
    #// memory is initialized to 0.
    try:
        rasterData = objc.allocateBuffer(bytesPerRow * height);
    except MemoryError:
        return None

    # This type of context is only available in Panther and later, otherwise
    # this fails and returns a NULL context. The color space for an alpha
    #// only context is NULL and the BitmapInfo value is kCGImageAlphaOnly.
    context = CGBitmapContextCreate(rasterData, width, height, 8, bytesPerRow,
                                        None, kCGImageAlphaOnly);
    if context is None:
        print >>sys.stderr, "Couldn't create the context!"
        return None

    _rasterDataForContext[context] = rasterData

    # Clear the context bits so they are initially transparent.
    CGContextClearRect(context, CGRectMake(0, 0, width, height))

    return context;

# createMaskFromAlphaOnlyContext creates a CGImageRef
# from an alpha-only bitmap context. Calling this routine
# transfers 'ownership' of the raster data in the bitmap
# context, to the image. If the image can't be created, this
# routine frees the memory associated with the raster.

def createMaskFromAlphaOnlyContext(alphaContext):
    rasterData = _rasterDataForContext[alphaContext]
    # We own the data, hence remove from the mapping
    del _rasterDataForContext[alphaContext]

    imageDataSize = CGBitmapContextGetBytesPerRow(alphaContext) * CGBitmapContextGetHeight(alphaContext)
    invertDecode = [ 1.0, 0.0 ]

    # Create the data provider from the image data.
    dataProvider = CGDataProviderCreateWithData(None,
                                            rasterData,
                                            imageDataSize,
                                            None)

    if dataProvider is None:
        print >>sys.stderr, "Couldn't create data provider!"
        return None

    mask = CGImageMaskCreate(CGBitmapContextGetWidth(alphaContext),
                          CGBitmapContextGetHeight(alphaContext),
                          CGBitmapContextGetBitsPerComponent(alphaContext),
                          CGBitmapContextGetBitsPerPixel(alphaContext),
                          CGBitmapContextGetBytesPerRow(alphaContext),
                          dataProvider,
                          # The decode is an inverted decode since a mask has the opposite
                          # sense than alpha, i.e. 0 in a mask paints 100% and 1 in a mask
                          # paints nothing.
                          invertDecode,
                          True)

    if mask is None:
        print >>sys.stderr, "Couldn't create image mask!"
        return None

    return mask

def doAlphaOnlyContext(context):
    # This code is going to capture the alpha coverage
    # of the drawing done by the doAlphaRects routine.
    # The value passed here as the width and height is
    # the size of the bounding rectangle of that drawing.
    width = 520
    height = 400
    alphaContext = createAlphaOnlyContext(width, height);
    if context is None:
        print >>sys.stderr, "Couldn't create the alpha-only context!"
        return

    # Draw the content to the alpha-only context, capturing
    # the alpha coverage. The doAlphaRects routine paints
    # a series of translucent red rectangles.
    DrawingBasics.doAlphaRects(alphaContext)

    # Finished drawing to the context and now the raster contains
    # the alpha data captured from the drawing. Create
    # the mask from the data in the context.
    mask = createMaskFromAlphaOnlyContext(alphaContext);
    # This code is now finshed with the context so it can
    # release it.
    del alphaContext

    if mask is None:
        return

    # Set the fill color space.
    CGContextSetFillColorSpace(context, Utilities.getTheCalibratedRGBColorSpace());
    opaqueBlue = ( 0.11, 0.208, 0.451, 1.0 )
    # Set the painting color to opaque blue.
    CGContextSetFillColor(context, opaqueBlue);
    # Draw the mask, painting the mask with blue. This colorizes
    # the image to blue and it is as if we painted the
    # alpha rects with blue instead of red.
    CGContextDrawImage(context, CGRectMake(0, 0, width, height), mask);

_pdfDoc = None
_pdfURL = None
_width = 0
_height = 0
def getThePDFDoc(url):
    """
    This function caches a CGPDFDocumentRef for
    the most recently requested PDF document.
    """
    global _pdfDoc, _pdfURL, _width, _height

    if url is None:
        return None, 0, 0

    # See whether to update the cached PDF document.
    if _pdfDoc is None or url != _pdfURL:
        # Release any cached document or URL.
        _pdfDoc = CGPDFDocumentCreateWithURL(url);
        if _pdfDoc is not None:
            pdfMediaRect = CGPDFDocumentGetMediaBox(_pdfDoc, 1)
            _width = pdfMediaRect.size.width;
            _height = pdfMediaRect.size.height;
            # Keep the URL of the PDF file being cached.
            _pdfURL = url

        else:
            _pdfURL = None

    if _pdfDoc is not None:
        return _pdfDoc, _width, _height

    else:
        return None, 0, 0

# Defining this scales the content down by 1/3.
DOSCALING=True

def TilePDFNoBuffer(context, url):
    # The amount of area to tile should really be based on the
    # window/document. Here it is hard coded to a US Letter
    # size document. This may draw too many or too few tiles
    # for the area actually being filled.
    fillwidth = 612.0
    fillheight = 792.0
    extraOffset = 6.0
    pdfDoc, tileX, tileY = getThePDFDoc(url)
    if pdfDoc is None:
        print >>sys.stderr, "Couldn't get the PDF document!"
        return

    if DOSCALING:
        # Make the tiles 1/3 the size of the PDF document.
        tileX /= 3
        tileY /= 3
        extraOffset /= 3

    # Space the tiles by the tile width and height
    # plus extraOffset units in each dimension.
    tileOffsetX = extraOffset + tileX;
    tileOffsetY = extraOffset + tileY;

    # Tile the PDF document.
    for h in range(0, int(fillheight), int(tileOffsetY)):
        for w in range(0, int(fillwidth), int(tileOffsetX)):
            CGContextDrawPDFDocument(context,
                CGRectMake(w, h, tileX, tileY), pdfDoc, 1);

def TilePDFWithOffscreenBitmap(context, url):
    # Again this should really be computed based on
    # the area intended to be tiled.
    fillwidth = 612.0
    fillheight = 792.0
    extraOffset = 6.0

    pdfDoc, tileX, tileY = getThePDFDoc(url)
    if pdfDoc is None:
        print >>sys.stderr, "Couldn't get the PDF document"
        return

    if DOSCALING:
        # Make the tiles 1/3 the size of the PDF document.
        tileX /= 3
        tileY /= 3
        extraOffset /= 3

    # Space the tiles by the tile width and height
    # plus extraOffset units in each dimension.
    tileOffsetX = extraOffset + tileX;
    tileOffsetY = extraOffset + tileY;

    # Since the bitmap context is for use with the display
    # and should capture alpha, these are the values
    # to pass to createRGBBitmapContext.
    useDisplayColorSpace = True;
    needTransparentBitmap = True;
    bitmapContext = createRGBBitmapContext(tileX, tileY,
                                        useDisplayColorSpace,
                                        needTransparentBitmap);
    if bitmapContext is None:
        print >>sys.stderr, "Couldn't create bitmap context!"
        return

    # Draw the PDF document one time into the bitmap context.
    CGContextDrawPDFDocument(bitmapContext,
                    CGRectMake(0, 0, tileX, tileY), pdfDoc, 1);

    # Create an image from the raster data. Calling
    # createImageFromBitmapContext gives up ownership
    # of the raster data used by the context.
    image = createImageFromBitmapContext(bitmapContext);

    # Release the context now that the image is created.
    del bitmapContext

    if image is None:
        return

    # Now tile the image.
    for h in range(0, int(fillheight), int(tileOffsetY)):
        for w in range(0, int(fillwidth), int(tileOffsetX)):
            CGContextDrawImage(context, CGRectMake(w, h, tileX, tileY), image)


def createLayerWithImageForContext(c, url):
    layerSize = CGSize()
    pdfDoc, layerSize.width, layerSize.height = getThePDFDoc(url)
    if pdfDoc is None:
        return None

    if DOSCALING:
        # Make the layer 1/3 the size of the PDF document.
        layerSize.width /= 3
        layerSize.height /= 3

    # Create the layer to draw into.
    layer = CGLayerCreateWithContext(c, layerSize, None)
    if layer is None:
        return NULL

    # Get the context corresponding to the layer. Note
    # that this is a 'Get' function so the code must
    # not release the context.
    layerContext = CGLayerGetContext(layer)
    if layerContext is None:
        return None

    # Draw the PDF document into the layer.
    CGContextDrawPDFDocument(layerContext,
        CGRectMake(0, 0, layerSize.width, layerSize.height), pdfDoc, 1);

    # Now the layer has the contents needed.
    return layer

def TilePDFWithCGLayer(context, url):
    # Again this should really be computed based on
    # the area intended to be tiled.
    fillwidth = 612.0
    fillheight = 792.0
    layer = createLayerWithImageForContext(context, url)
    if layer is None:
        print >>sys.stderr, "Couldn't create the layer!"
        return

    # Compute the tile size and offset.
    s = CGLayerGetSize(layer);
    tileX = s.width
    tileY = s.height

    if DOSCALING:
        # Space the tiles by the tile width and height
        # plus an extra 2 units in each dimension.
        tileOffsetX = 2.0 + tileX;
        tileOffsetY = 2.0 + tileY;
    else:
        # Add 6 units to the offset in each direction
        # if there is no scaling of the source PDF document.
        tileOffsetX = 6. + tileX;
        tileOffsetY = 6. + tileY;

    # Now draw the contents of the layer to the context.
    # The layer is drawn at its true size (the size of
    # the tile) with its origin located at the corner
    # of each tile.
    for h in range(0, int(fillheight), int(tileOffsetY)):
        for w in range(0, int(fillwidth), int(tileOffsetX)):
            CGContextDrawLayerAtPoint(context, CGPointMake(w, h), layer)

ColorAndGState.py

import sys

from Quartz import *

import Utilities
import array

def doColorSpaceFillAndStroke(context):
    theColorSpace = Utilities.getTheCalibratedRGBColorSpace()
    opaqueRed = ( 0.663, 0.0, 0.031, 1.0 ) # red,green,blue,alpha
    aBlue = ( 0.482, 0.62, 0.871, 1.0 )     # red,green,blue,alpha

    # Set the fill color space to be the generic calibrated RGB color space.
    CGContextSetFillColorSpace(context, theColorSpace)
    # Set the fill color to opaque red. The number of elements in the
    # array passed to this function must be the number of color
    # components in the current fill color space plus 1 for alpha.
    CGContextSetFillColor(context, opaqueRed)

    # Set the stroke color space to be the generic calibrated RGB color space.
    CGContextSetStrokeColorSpace(context, theColorSpace)
    # Set the stroke color to opaque blue. The number of elements
    # in the array passed to this function must be the number of color
    # components in the current stroke color space plus 1 for alpha.
    CGContextSetStrokeColor(context, aBlue)

    CGContextSetLineWidth(context, 8.0)
    # Rectangle 1.
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(20.0, 20.0, 100.0, 100.0))
    CGContextDrawPath(context, kCGPathFillStroke)

    # Continue to use the stroke colorspace already set
    # but change the stroke alpha value to a semitransparent blue.
    aBlue = list(aBlue)
    aBlue[3] = 0.5
    CGContextSetStrokeColor(context, aBlue)
    # Rectangle 2.
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(140.0, 20.0, 100.0, 100.0))
    CGContextDrawPath(context, kCGPathFillStroke)

    # Don't release the color space since this routine
    # didn't create it.

_opaqueRedColor = None
_opaqueBlueColor = None
_transparentBlueColor = None

def drawWithColorRefs(context):
    global _opaqueRedColor
    global _opaqueBlueColor
    global _transparentBlueColor

    # Initialize the CGColorRefs if necessary
    if _opaqueRedColor is None:
        # Initialize the color array to an opaque red
        # in the generic calibrated RGB color space.
        color = (0.663, 0.0, 0.031, 1.0)
        theColorSpace = Utilities.getTheCalibratedRGBColorSpace()
        # Create a CGColorRef for opaque red.
        _opaqueRedColor = CGColorCreate(theColorSpace, color)
        # Make the color array correspond to an opaque blue color.
        color = (0.482, 0.62, 0.87, 1.0)
        # Create another CGColorRef for opaque blue.
        _opaqueBlueColor = CGColorCreate(theColorSpace, color)
        # Create a new CGColorRef from the opaqueBlue CGColorRef
        # but with a different alpha value.
        _transparentBlueColor = CGColorCreateCopyWithAlpha(
                _opaqueBlueColor, 0.5)
        if _opaqueRedColor is None or _opaqueBlueColor is None or _transparentBlueColor is None:
            print >>sys.stderr, "Couldn't create one of the CGColorRefs!!!"
            return

    # Set the fill color to the opaque red CGColor object.
    CGContextSetFillColorWithColor(context, _opaqueRedColor)
    # Set the stroke color to the opaque blue CGColor object.
    CGContextSetStrokeColorWithColor(context, _opaqueBlueColor)

    CGContextSetLineWidth(context, 8.0)
    # Draw the first rectangle.
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(20.0, 20.0, 100.0, 100.0))
    CGContextDrawPath(context, kCGPathFillStroke)

    # Set the stroke color to be that of the transparent blue
    # CGColor object.
    CGContextSetStrokeColorWithColor(context, _transparentBlueColor)
    # Draw a second rectangle to the right of the first one.
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(140.0, 20.0, 100.0, 100.0))
    CGContextDrawPath(context, kCGPathFillStroke)

def doIndexedColorDrawGraphics(context):
    theBaseRGBSpace = Utilities.getTheCalibratedRGBColorSpace()
    lookupTable = array.array('B', (0,)*6)
    opaqueRed = (0, 1) # index, alpha
    aBlue = (1, 1)     # index, alpha

    # Set the first 3 values in the lookup table to a red of
    # 169/255 = 0.663, no green, and blue = 8/255 = 0.031. This makes
    # the first entry in the lookup table a shade of red.
    lookupTable[0] = 169; lookupTable[1] = 0; lookupTable[2] = 8

    # Set the second 3 values in the lookup table to a red value
    # of 123/255 = 0.482, a green value of 158/255 = 0.62, and
    # a blue value of 222/255 = 0.871. This makes the second entry
    # in the lookup table a shade of blue.
    lookupTable[3] = 123; lookupTable[4] = 158; lookupTable[5] = 222

    # Create the indexed color space with this color lookup table,
    # using the RGB color space as the base color space and a 2 element
    # color lookup table to characterize the indexed color space.
    theIndexedSpace = CGColorSpaceCreateIndexed(theBaseRGBSpace, 1, lookupTable)
    if theIndexedSpace is not None:
        CGContextSetStrokeColorSpace(context, theIndexedSpace)
        CGContextSetFillColorSpace(context, theIndexedSpace)

        # Set the stroke color to an opaque blue.
        CGContextSetStrokeColor(context, aBlue)
        # Set the fill color to an opaque red.
        CGContextSetFillColor(context, opaqueRed)

        CGContextSetLineWidth(context, 8.0)
        # Draw the first rectangle.
        CGContextBeginPath(context)
        CGContextAddRect(context, CGRectMake(20.0, 20.0, 100.0, 100.0))
        CGContextDrawPath(context, kCGPathFillStroke)

        # Continue to use the stroke colorspace already set
        # but change the stroke alpha value to a semitransparent value
        # while leaving the index value unchanged.
        aBlue = list(aBlue)
        aBlue[1] = 0.5
        CGContextSetStrokeColor(context, aBlue)
        # Draw another rectangle to the right of the first one.
        CGContextBeginPath(context)
        CGContextAddRect(context, CGRectMake(140.0, 20.0, 100.0, 100.0))
        CGContextDrawPath(context, kCGPathFillStroke)
    else:
        print >>sys.stderr, "Couldn't make the indexed color space!"

def drawWithGlobalAlpha(context):
    rect = CGRectMake(40.0, 210.0, 100.0, 100.0)
    color = [1.0, 0.0, 0.0, 1.0] # opaque red
    # Set the fill color space to that returned by getTheCalibratedRGBColorSpace.
    CGContextSetFillColorSpace(context, Utilities.getTheCalibratedRGBColorSpace())

    CGContextSetFillColor(context, color)
    for i in range(2):
        CGContextSaveGState(context)
        # Paint the leftmost rect on this row with 100% opaque red.
        CGContextFillRect(context, rect)

        CGContextTranslateCTM(context, rect.size.width + 70.0, 0.0)
        # Set the alpha value of this rgba color to 0.5.
        color[3] = 0.5
        # Use the new color as the fill color in the graphics state.
        CGContextSetFillColor(context, color)
        # Paint the center rect on this row with 50% opaque red.
        CGContextFillRect(context, rect)

        CGContextTranslateCTM(context, rect.size.width + 70.0, 0.0)
        # Set the alpha value of this rgba color to 0.25.
        color[3] = 0.25
        # Use the new color as the fill color in the graphics state.
        CGContextSetFillColor(context, color)
        # Paint the rightmost rect on this row with 25% opaque red.
        CGContextFillRect(context, rect)
        CGContextRestoreGState(context)
        # After restoring the graphics state, the fill color is set to
        # that prior to calling CGContextSaveGState, that is, opaque
        # red. The coordinate system is also restored.

        # Now set the context global alpha value to 50% opaque.
        CGContextSetAlpha(context, 0.5)
        # Translate down for a second row of rectangles.
        CGContextTranslateCTM(context, 0.0, -(rect.size.height + 70.0))
        # Reset the alpha value of the color array to fully opaque.
        color[3] = 1.0

def drawWithColorBlendMode(context, url):
    # A pleasant green color.
    green = [0.584, 0.871, 0.318, 1.0]

    # Create a CGPDFDocument object from the URL.
    pdfDoc = CGPDFDocumentCreateWithURL(url)
    if pdfDoc is None:
        print >>sys.stderr, "Couldn't create CGPDFDocument from URL!"
        return

    # Obtain the media box for page 1 of the PDF document.
    pdfRect = CGPDFDocumentGetMediaBox(pdfDoc, 1)
    # Set the origin of the rectangle to (0,0).
    pdfRect.origin.x = pdfRect.origin.y = 0

    # Graphic 1, the left portion of the figure.
    CGContextTranslateCTM(context, 20, 10 + CGRectGetHeight(pdfRect)/2)

    # Draw the PDF document.
    CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

    # Set the fill color space to that returned by getTheCalibratedRGBColorSpace.
    CGContextSetFillColorSpace(context, Utilities.getTheCalibratedRGBColorSpace())
    # Set the fill color to green.
    CGContextSetFillColor(context, green)

    # Graphic 2, the top-right portion of the figure.
    CGContextTranslateCTM(context, CGRectGetWidth(pdfRect) + 10,
                                    CGRectGetHeight(pdfRect)/2 + 10)

    # Draw the PDF document again.
    CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

    # Make a fill rectangle that is the same size as the PDF document
    # but inset each side by 80 units in x and 20 units in y.
    insetRect = CGRectInset(pdfRect, 80, 20)
    # Fill the rectangle with green. Because the fill color is opaque and
    # the blend mode is Normal, this obscures the drawing underneath.
    CGContextFillRect(context, insetRect)

    # Graphic 3, the bottom-right portion of the figure.
    CGContextTranslateCTM(context, 0, -(10 + CGRectGetHeight(pdfRect)))

    # Draw the PDF document again.
    CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

    # Set the blend mode to kCGBlendModeColor which will
    # colorize the destination with subsequent drawing.
    CGContextSetBlendMode(context, kCGBlendModeColor)
    # Draw the rectangle on top of the PDF document. The portion of the
    # background that is covered by the rectangle is colorized
    # with the fill color.
    CGContextFillRect(context, insetRect)


def createEllipsePath(context, center, ellipseSize):
    CGContextSaveGState(context)
    # Translate the coordinate origin to the center point.
    CGContextTranslateCTM(context, center.x, center.y)
    # Scale the coordinate system to half the width and height
    # of the ellipse.
    CGContextScaleCTM(context, ellipseSize.width/2, ellipseSize.height/2)
    CGContextBeginPath(context)
    # Add a circular arc to the path, centered at the origin and
    # with a radius of 1.0. This radius, together with the
    # scaling above for the width and height, produces an ellipse
    # of the correct size.
    CGContextAddArc(context, 0.0, 0.0, 1.0, 0.0, Utilities.DEGREES_TO_RADIANS(360.0), 0.0)
    # Close the path so that this path is suitable for stroking,
    # should that be desired.
    CGContextClosePath(context)
    CGContextRestoreGState(context)

_opaqueBrownColor = None
_opaqueOrangeColor = None
def doClippedEllipse(context):
    global _opaqueBrownColor, _opaqueOrangeColor

    theCenterPoint = CGPoint(120.0, 120.0)
    theEllipseSize = CGSize(100.0, 200.0)
    dash = [ 2.0 ]

    # Initialize the CGColorRefs if necessary.
    if _opaqueBrownColor is None:
        # The initial value of the color array is an
        # opaque brown in an RGB color space.
        color = [0.325, 0.208, 0.157, 1.0]
        theColorSpace = Utilities.getTheCalibratedRGBColorSpace()
        # Create a CGColorRef for opaque brown.
        _opaqueBrownColor = CGColorCreate(theColorSpace, color)
        # Make the color array correspond to an opaque orange.
        color = [0.965, 0.584, 0.059, 1.0 ]
        # Create another CGColorRef for opaque orange.
        _opaqueOrangeColor = CGColorCreate(theColorSpace, color)

    # Draw two ellipses centered about the same point, one
    # rotated 45 degrees from the other.
    CGContextSaveGState(context)
    # Ellipse 1
    createEllipsePath(context, theCenterPoint, theEllipseSize)
    CGContextSetFillColorWithColor(context, _opaqueBrownColor)
    CGContextFillPath(context)
    # Translate and rotate about the center point of the ellipse.
    CGContextTranslateCTM(context, theCenterPoint.x, theCenterPoint.y)
    # Rotate by 45 degrees.
    CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45))
    # Ellipse 2
    # CGPointZero is a pre-defined Quartz point corresponding to
    # the coordinate (0,0).
    createEllipsePath(context, CGPointZero, theEllipseSize)
    CGContextSetFillColorWithColor(context, _opaqueOrangeColor)
    CGContextFillPath(context)
    CGContextRestoreGState(context)

    CGContextTranslateCTM(context, 170.0, 0.0)
    # Now use the first ellipse as a clipping area prior to
    # painting the second ellipse.
    CGContextSaveGState(context)
    # Ellipse 3
    createEllipsePath(context, theCenterPoint, theEllipseSize)
    CGContextSetStrokeColorWithColor(context, _opaqueBrownColor)
    CGContextSetLineDash(context, 0, dash, 1)
    # Stroke the path with a dash.
    CGContextStrokePath(context)
    # Ellipse 4
    createEllipsePath(context, theCenterPoint, theEllipseSize)
    # Clip to the elliptical path.
    CGContextClip(context)
    CGContextTranslateCTM(context, theCenterPoint.x, theCenterPoint.y)
    # Rotate by 45 degrees.
    CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45))
    # Ellipse 5
    createEllipsePath(context, CGPointZero, theEllipseSize)
    CGContextSetFillColorWithColor(context, _opaqueOrangeColor)
    CGContextFillPath(context)
    CGContextRestoreGState(context)

CoordinateSystem.py

from Quartz import *
import math
import Utilities

def doRotatedEllipses(context):
    totreps = 144
    tint = 1.0
    tintIncrement = 1.0/totreps
    # Create a new transform consisting of a 45 degrees rotation.
    theTransform = CGAffineTransformMakeRotation(math.pi/4)
    # Apply a scale to the transform just created.
    theTransform = CGAffineTransformScale(theTransform, 1, 2)
    # Place the first ellipse at a good location.
    CGContextTranslateCTM(context, 100.0, 100.0)

    for i in range(totreps):
        # Make a snapshot the coordinate system.
        CGContextSaveGState(context)
        # Set up the coordinate system for the rotated ellipse.
        CGContextConcatCTM(context, theTransform)
        CGContextBeginPath(context)
        CGContextAddArc(context, 0.0, 0.0, 45.0, 0.0, 2*math.pi, 0);
        # Set the fill color for this instance of the ellipse.
        CGContextSetRGBFillColor(context, tint, 0.0, 0.0, 1.0)
        CGContextDrawPath(context, kCGPathFill)
        # Restore the coordinate system to that of the snapshot.
        CGContextRestoreGState(context)
        # Compute the next tint color.
        tint -= tintIncrement
        # Move over by 1 unit in x for the next ellipse.
        CGContextTranslateCTM(context, 1.0, 0.0)

def drawSkewedCoordinateSystem(context):
    # alpha is 22.5 degrees and beta is 15 degrees.
    alpha = math.pi/8
    beta = math.pi/12
    # Create a rectangle that is 72 units on a side
    # with its origin at (0,0).
    r = CGRectMake(0, 0, 72, 72)

    CGContextTranslateCTM(context, 144, 144)
    # Draw the coordinate axes untransformed.
    Utilities.drawCoordinateAxes(context)
    # Fill the rectangle.
    CGContextFillRect(context, r)

    # Create an affine transform that skews the coordinate system,
    # skewing the x-axis by alpha radians and the y-axis by beta radians.
    skew = CGAffineTransformMake(1, math.tan(alpha), math.tan(beta), 1, 0, 0)
    # Apply that transform to the context coordinate system.
    CGContextConcatCTM(context, skew)

    # Set the fill and stroke color to a dark blue.
    CGContextSetRGBStrokeColor(context, 0.11, 0.208, 0.451, 1)
    CGContextSetRGBFillColor(context, 0.11, 0.208, 0.451, 1)

    # Draw the coordinate axes again, now transformed.
    Utilities.drawCoordinateAxes(context)
    # Set the fill color again but with a partially transparent alpha.
    CGContextSetRGBFillColor(context, 0.11, 0.208, 0.451, 0.7)
    # Fill the rectangle in the transformed coordinate system.
    CGContextFillRect(context, r)

DataProvidersAndConsumers.py

import os, sys

from Quartz import *
import Quartz

import objc

def createDataProviderFromPathName (path):
    # Create a CFURL for the supplied file system path.
    url = CFURLCreateWithFileSystemPath(None, path, kCFURLPOSIXPathStyle, False)
    if url is None:
        print >>sys.stderr, "Couldn't create url!"
        return None

    # Create a Quartz data provider for the URL.
    dataProvider = CGDataProviderCreateWithURL(url)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create data provider!"
        return None

    return dataProvider

def createRGBRampDataProvider():
    width = 256
    height = 256
    imageDataSize = width*height*3

    dataP = objc.allocateBuffer(imageDataSize)

    #    Build an image that is RGB 24 bits per sample. This is a ramp
    #    where the red component value increases in red from left to
    #    right and the green component increases from top to bottom.
    #
    idx=0
    for g in xrange(height):
        for r in xrange(width):
            dataP[idx] = chr(r)
            dataP[idx+1] = chr(g)
            dataP[idx+2] = '\0'
            idx += 3

    # Once this data provider is created, the data associated
    # with dataP MUST be available until Quartz calls the data
    # releaser function 'rgbReleaseRampData'.
    dataProvider = CGDataProviderCreateWithData(
            None, dataP, imageDataSize, None)
    return dataProvider

class MyImageDataInfo (object):
    fp = None
    totalBytesRead = 0
    skippedBytes = 0
    numRewinds = 0

def getBytesSequentialAccessDP(data, buffer, count):
    buf = data.fp.read(count)
    buffer[:len(buf)] = buf
    data.totalBytesRead += len(buf)
    return len(buf), buffer

def skipBytesSequentialAccessDP(data, count):
    try:
        data.fp.seek(count, os.SEEK_CUR)
        data.skippedBytes += count

    except IOError, msg:
        print >>sys.stderr, "Couldn't seek %d bytes because of %s"%(count, msg)


def rewindSequentialAccessDP(data):
    # Rewind the beginning of the data.
    data.fp.seek(0, 0)
    data.numRewinds += 1

def releaseSequentialAccessDP(data):
    if data is not None:
        print >>sys.stderr, "read %d bytes, skipped %d bytes, rewind called %d times"%(
                    data.totalBytesRead, data.skippedBytes,
                    data.numRewinds)
        data.fp.close()

def createSequentialAccessDPForURL(url):
    success, pathString = CFURLGetFileSystemRepresentation(url, True, None, 1024)
    pathString = pathString.rstrip('\0')
    if not success:
        print >>sys.stderr, "Couldn't get the path name C string!"
        return None

    fp = open(pathString, "rb")
    if fp is None:
        print >>sys.stderr, "Couldn't open path to file %s!"%(pathString,)
        return None

    imageDataInfoP = MyImageDataInfo()
    imageDataInfoP.fp = fp

    provider = CGDataProviderCreate(imageDataInfoP, (
        getBytesSequentialAccessDP,
        skipBytesSequentialAccessDP,
        rewindSequentialAccessDP,
        releaseSequentialAccessDP))
    if provider is None:
        print >>sys.stderr, "Couldn't create data provider!"
        # Release the info data and cleanup.
        releaseSequentialAccessDP(imageDataInfoP)
        return None

    return provider


def getBytesGrayRampDirectAccess(info, buffer, offset, count):
        # This computes a linear gray ramp that is 256 samples wide and
        # 1 sample high. The ith byte in the image is the sample
        # value i. This produces a gray ramp that goes from 0 (black) to
        # FF (white).
    idx = 0

    # This data provider provides 256 bytes total. If Quartz
    # requests more data than is available, only return
    # the available data.
    if (offset + count) > 256:
        count = 256 - offset

    for i in range(offset, offset+count):
        buffer[idx] = chr(i)
        idx+=1

    return count, buffer

def  createGrayRampDirectAccessDP():
    provider = CGDataProviderCreateDirectAccess(None, 256, (
        None,
        None,
        getBytesGrayRampDirectAccess,
        None))
    if provider is None:
        print >>sys.stderr, "Couldn't create data provider!"
        return None

    return provider

# This only builds on Tiger and later.
def myCGDataProviderCreateWithCFData(data):
    # If the CFData object passed in is None, this code returns
    # a None data provider.
    if data is None:
        return None

    # Test to see if the Quartz version is available and if so, use it.

    #XXX: force the replacment code to be used
    #if hasattr(Quartz, 'CGDataProviderCreateWithCFData'):
    #    return CGDataProviderCreateWithCFData(data)

    dataSize = CFDataGetLength(data)
    provider = CGDataProviderCreateWithData(data, buffer(data), dataSize, None)
    return provider

def createDataConsumerFromPathName(path):
    # Create a CFURL for the supplied file system path.
    url = CFURLCreateWithFileSystemPath (None, path, kCFURLPOSIXPathStyle, False)
    if url is None:
        print >>sys.stderr, "Couldn't create url!"
        return None
    # Create a Quartz data provider for the URL.
    dataConsumer = CGDataConsumerCreateWithURL(url)
    if dataConsumer is None:
        print >>sys.stderr, "Couldn't create data consumer!"
        return None

    return dataConsumer

def myCFDataConsumerPutBytes(data, buffer, count):
    # Append 'count' bytes from 'buffer' to the CFData
    # object 'data'.
    CFDataAppendBytes(data, buffer, count)
    return count

# This only builds on Tiger and later.
def myCGDataConsumerCreateWithCFData(data):
    # If the CFData object passed in is None, this code returns
    # a None data consumer.
    if data is None:
        return None

    # Test to see if the Quartz version is available.

    # XXX: force the replacement code to be used:
    #if hasattr(Quartz, 'CGDataConsumerCreateWithCFData'):
    #    return CGDataConsumerCreateWithCFData(data)

    consumer = CGDataConsumerCreate(data, (
        myCFDataConsumerPutBytes, None))
    return consumer

DrawingBasics.py

import math, sys

from Quartz import *
import Quartz


def doSimpleRect(context):
    # Set the fill color to opaque red.
    CGContextSetRGBFillColor(context, 1.0, 0.0, 0.0, 1.0)
    # Set up the rectangle for drawing.
    ourRect = CGRectMake(20.0, 20.0, 130.0, 100.0)
    # Draw the filled rectangle.
    CGContextFillRect(context, ourRect)

def doStrokedRect(context):
    # Set the stroke color to a light opaque blue.
    CGContextSetRGBStrokeColor(context, 0.482, 0.62, 0.871, 1.0)
    # Set up the rectangle for drawing.
    ourRect = CGRectMake(20.0, 20.0, 130.0, 100.0)
    # Draw the stroked rectangle with a line width of 3.
    CGContextStrokeRectWithWidth(context, ourRect, 3.0)

def doStrokedAndFilledRect(context):
    # Define a rectangle to use for drawing.
    ourRect = CGRectMake(20.0, 220.0, 130.0, 100.0)

    # ***** Rectangle 1 *****
    # Set the fill color to a light opaque blue.
    CGContextSetRGBFillColor(context, 0.482, 0.62, 0.871, 1.0)
    # Set the stroke color to an opaque green.
    CGContextSetRGBStrokeColor(context, 0.404, 0.808, 0.239, 1.0)
    # Fill the rect.
    CGContextFillRect(context, ourRect)
    # ***** Rectangle 2 *****
    # Move the rectangle's origin to the right by 200 units.
    ourRect.origin.x += 200.0
    # Stroke the rectangle with a line width of 10.
    CGContextStrokeRectWithWidth(context, ourRect, 10.0)
    # ***** Rectangle 3 *****
    # Move the rectangle's origin to the left by 200 units
    # and down by 200 units.
    ourRect.origin.x -= 200.0
    ourRect.origin.y -= 200.0
    # Fill then stroke the rect with a line width of 10.
    CGContextFillRect(context, ourRect)
    CGContextStrokeRectWithWidth(context, ourRect, 10.0)
    # ***** Rectangle 4 *****
    # Move the rectangle's origin to the right by 200 units.
    ourRect.origin.x += 200.0
    # Stroke then fill the rect.
    CGContextStrokeRectWithWidth(context, ourRect, 10.0)
    CGContextFillRect(context, ourRect)

def createRectPath(context, rect):
    # Create a path using the coordinates of the rect passed in.
    CGContextBeginPath(context)
    CGContextMoveToPoint(context, rect.origin.x, rect.origin.y)
    # ***** Segment 1 *****
    CGContextAddLineToPoint(context, rect.origin.x + rect.size.width,
                                rect.origin.y)
    # ***** Segment 2 *****
    CGContextAddLineToPoint(context, rect.origin.x + rect.size.width,
                                rect.origin.y + rect.size.height)
    # ***** Segment 3 *****
    CGContextAddLineToPoint(context, rect.origin.x,
                                rect.origin.y + rect.size.height)
    # ***** Segment 4 is created by closing the path *****
    CGContextClosePath(context)

def doPathRects(context):
    # Define a rectangle to use for drawing.
    ourRect = CGRectMake(20.0, 20.0, 130.0, 100.0)

    # ***** Rectangle 1 *****
    # Create the rect path.
    createRectPath (context, ourRect)
    # Set the fill color to a light opaque blue.
    CGContextSetRGBFillColor(context, 0.482, 0.62, 0.871, 1.0)
    # Fill the path.
    CGContextDrawPath (context, kCGPathFill) # Clears the path.
    # ***** Rectangle 2 *****
    # Translate the coordinate system 200 units to the right.
    CGContextTranslateCTM(context, 200.0, 0.0)
    # Set the stroke color to an opaque green.
    CGContextSetRGBStrokeColor(context, 0.404, 0.808, 0.239, 1.0)
    createRectPath (context, ourRect)
    # Set the line width to 10 units.
    CGContextSetLineWidth (context, 10.0)
    # Stroke the path.
    CGContextDrawPath (context, kCGPathStroke)  # Clears the path.
    # ***** Rectangle 3 *****
    # Translate the coordinate system
    # 200 units to the left and 200 units down.
    CGContextTranslateCTM(context, -200.0, -200.0)
    createRectPath (context, ourRect)
    #CGContextSetLineWidth(context, 10.0)       # This is redundant.
    # Fill, then stroke the path.
    CGContextDrawPath (context, kCGPathFillStroke)  # Clears the path.
    # ***** Rectangle 4 *****
    # Translate the coordinate system 200 units to the right.
    CGContextTranslateCTM(context, 200.0, 0.0)
    createRectPath (context, ourRect)
    # Stroke the path.
    CGContextDrawPath (context, kCGPathStroke)  # Clears the path.
    # Create the path again.
    createRectPath (context, ourRect)
    # Fill the path.
    CGContextDrawPath (context, kCGPathFill) # Clears the path.

def doAlphaRects(context):
    # ***** Part 1 *****
    ourRect = CGRectMake(0.0, 0.0, 130.0, 100.0)
    numRects = 6
    rotateAngle = 2*math.pi/numRects
    tintAdjust = 1.0/numRects

    # ***** Part 2 *****
    CGContextTranslateCTM(context, 2*ourRect.size.width,
                                    2*ourRect.size.height)

    # ***** Part 3 *****
    tint = 1.0
    for i in range(numRects):
        CGContextSetRGBFillColor (context, tint, 0.0, 0.0, tint)
        CGContextFillRect(context, ourRect)
        # These transformations are cummulative.
        CGContextRotateCTM(context, rotateAngle)
        tint -= tintAdjust

def drawStrokedLine(context, start, end):
    CGContextBeginPath(context)
    CGContextMoveToPoint(context, start.x, start.y)
    CGContextAddLineToPoint(context, end.x, end.y)
    CGContextDrawPath(context, kCGPathStroke)

def doDashedLines(context):
    lengths = ( 12.0, 6.0, 5.0, 6.0, 5.0, 6.0 )

    start = CGPoint(20.0, 270.0)
    end = CGPoint(300.0, 270.0)
    # ***** Line 1 solid line *****
    CGContextSetLineWidth(context, 5.0)
    drawStrokedLine(context, start, end)
    # ***** Line 2 long dashes *****
    CGContextTranslateCTM(context, 0.0, -50.0)
    CGContextSetLineDash(context, 0.0, lengths, 2)
    drawStrokedLine(context, start, end)
    # ***** Line 3 long short pattern *****
    CGContextTranslateCTM(context, 0.0, -50.0)
    CGContextSetLineDash(context, 0.0, lengths, 4)
    drawStrokedLine(context, start, end)
    # ***** Line 4 long short short pattern *****
    CGContextTranslateCTM(context, 0.0, -50.0)
    CGContextSetLineDash(context, 0.0, lengths, 6)
    drawStrokedLine(context, start, end)
    # ***** Line 5 short short long pattern *****
    CGContextTranslateCTM(context, 0.0, -50.0)
    CGContextSetLineDash(context, lengths[0]+lengths[1], lengths, 6)
    drawStrokedLine(context, start, end)
    # ***** Line 6 solid line *****
    CGContextTranslateCTM(context, 0.0, -50.0)
    # Reset dash to solid line.
    CGContextSetLineDash(context, 0, None, 0)
    drawStrokedLine(context, start, end)

def doClippedCircle(context):
    circleCenter = CGPoint(150.0, 150.0)
    circleRadius = 100.0
    startingAngle = 0.0
    endingAngle = 2*math.pi
    ourRect = CGRectMake(65.0, 65.0, 170.0, 170.0)

    # ***** Filled Circle *****
    CGContextSetRGBFillColor(context, 0.663, 0., 0.031, 1.0)
    CGContextBeginPath(context)
    # Construct the circle path counterclockwise.
    CGContextAddArc(context, circleCenter.x,
                            circleCenter.y, circleRadius,
                            startingAngle, endingAngle, 0)
    CGContextDrawPath(context, kCGPathFill)

    # ***** Stroked Square *****
    CGContextStrokeRect(context, ourRect)

    # Translate so that the next drawing doesn't overlap what
    # has already been drawn.
    CGContextTranslateCTM(context, ourRect.size.width + circleRadius + 5.0, 0)
    # Create a rectangular path and clip to that path.
    CGContextBeginPath(context)
    CGContextAddRect(context, ourRect)
    CGContextClip(context)

    # ***** Clipped Circle *****
    CGContextBeginPath(context)
    # Construct the circle path counterclockwise.
    CGContextAddArc (context, circleCenter.x,
                            circleCenter.y, circleRadius,
                            startingAngle, endingAngle, 0)
    CGContextDrawPath(context, kCGPathFill)


def doPDFDocument(context, url):

    pdfDoc = CGPDFDocumentCreateWithURL(url)
    if pdfDoc is not None:
        CGContextScaleCTM(context, .5, .5)
        # The media box is the bounding box of the PDF document.
        pdfRect = CGPDFDocumentGetMediaBox(pdfDoc, 1) # page 1
        # Set the destination rect origin to the Quartz origin.
        pdfRect.origin.x = pdfRect.origin.y = 0.
        # Draw page 1 of the PDF document.
        CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

        CGContextTranslateCTM(context, pdfRect.size.width*1.2, 0)
        # Scale non-uniformly making the y coordinate scale 1.5 times
        # the x coordinate scale.
        CGContextScaleCTM(context, 1, 1.5)
        CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

        CGContextTranslateCTM(context, pdfRect.size.width*1.2, pdfRect.size.height)
        # Flip the y coordinate axis horizontally about the x axis.
        CGContextScaleCTM(context, 1, -1)
        CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1)

    else:
        print >>sys.stderr, "Can't create PDF document for URL!"

EPSPrinting.py

from Quartz import *
import Quartz
import objc

import Utilities
import BitmapContext

import sys

# We're using a function that isn't made available through a wrapper, just
# load it manually:
if not hasattr(Quartz, 'PMCGImageCreateWithEPSDataProvider'):
    functions = [
        ('PMCGImageCreateWithEPSDataProvider', '@@@'),
    ]
    import AppKit
    d = {}
    objc.loadBundleFunctions(AppKit.__bundle__, d, functions)

    if 'PMCGImageCreateWithEPSDataProvider' in d:
        PMCGImageCreateWithEPSDataProvider=d['PMCGImageCreateWithEPSDataProvider']
    else:
        print >>sys.stderr, "PMCGImageCreateWithEPSDataProvider doesn't exist"

def getEPSBBox(epspath):
    try:
        fp = open(epspath, 'rU')
    except IOError, msg:
        return CGRectZero

    try:
        #  This is a VERY poor man's EPS DSC parser, here just so that
        #  this sample code can handle simple EPS files. It is
        #  simple but very inefficient. In addition it does not ensure
        #  that the DSC comments are at the beginning of a line,
        #  nor does it handle (atend) style comments at all.
        #  It will simply find the first occurance of a
        #  %%BoundingBox comment and if it is of the typical
        # form, it will obtain the bounding box data.
        #
        for ln in fp:
            if ln.startswith("%%BoundingBox:"):
                fields = ln.split()[1:]
                if len(fields) >= 4:
                    llx = int(fields[0])
                    lly = int(fields[1])
                    urx = int(fields[2])
                    ury = int(fields[3])
                    return CGRectMake(llx, lly, urx - llx, ury - lly)
    finally:
        fp.close()

    return CGRectZero

def createEPSPreviewImage(url):
    # The CGImage used as the preview needs to have the
    # same width and height as the EPS data it will
    # be associated with. This sample code doesn't attempt
    # to use any preview image associated with the EPS
    # data but instead simply draws a box of an appropriate
    # size. Your code would most likely create an image
    # that reflects a PICT or TIFF preview present in the
    # EPS data.
    result, path = CFURLGetFileSystemRepresentation(url, True, None, 1024)
    if not result:
        print >>sys.stderr, "Couldn't get the path for EPS file!"
        return None

    path = path.rstrip('\0')

    epsRect = getEPSBBox(path)
    # Check whether the EPS bounding box is empty.
    if epsRect == CGRectZero:
        print >>sys.stderr, "Couldn't find BoundingBox comment!"
        return None

    wantDisplayColorSpace = False
    needsTransparentBitmap = True
    # Create a bitmap context to draw to in order to
    # create the preview image. Use the routine
    # createRGBBitmapContext from the earlier chapter.
    bitmapContext = BitmapContext.createRGBBitmapContext(
                                    epsRect.size.width,
                                    epsRect.size.height,
                                    wantDisplayColorSpace,
                                    needsTransparentBitmap)
    if bitmapContext is None:
        print >>sys.stderr, "Couldn't create bitmap context"
        return None

    epsRect.origin.x = epsRect.origin.y = 0
    # Draw the contents of the preview. The preview consists
    # of two lines and a stroke around the bounding box. One
    # of the two lines is drawn from the lower-left corner to
    # the upper-right corner of the bounding box and the other
    # line is from the lower-right corner to the upper-left
    # corner of the bounding box.
    CGContextBeginPath(bitmapContext)
    CGContextMoveToPoint(bitmapContext, 0, 0)
    CGContextAddLineToPoint(bitmapContext, epsRect.size.width, epsRect.size.height)
    CGContextMoveToPoint(bitmapContext, epsRect.size.width, 0)
    CGContextAddLineToPoint(bitmapContext, 0, epsRect.size.height)
    CGContextStrokePath(bitmapContext)
    # Stroke the bounding rectangle, inset so that the stroke is
    # completely contained in the EPS bounding rect.
    CGContextStrokeRect(bitmapContext, CGRectInset(epsRect, 0.5, 0.5))

    # Now create an image from the bitmap raster data. This image
    # has a data provider that releases the image raster data when
    # the image is released. Use the createImageFromBitmapContext
    # from Chapter 12. Calling createImageFromBitmapContext
    # gives up ownership of the raster data used by the context.
    epsPreviewImage = BitmapContext.createImageFromBitmapContext(bitmapContext)

    if epsPreviewImage is None:
        print >>sys.stderr, "Couldn't create preview image!"
        return None

    return epsPreviewImage

# This technique of handling EPS data is available in
# Mac OS X v10.1 and later and is one alternative method
# of supporting EPS data during printing as compared to
# converting EPS data to PDF data using CGPSConverter which
# is only available in Panther and later.
def createCGEPSImage(url):
    previewImage = createEPSPreviewImage(url)
    if previewImage is None:
        print >>sys.stderr, "Couldn't create EPS preview!"
        return None

    # It is important that the data provider supplying the
    # EPS data conform to the Quartz guidelines for data providers
    # and is able to provide the data until the data releaser function
    # is called. If you have a custom data provider, you need
    # to follow these guidelines since your data provider
    # is not necessarily called before you release the image
    # that uses the provider.
    epsDataProvider = CGDataProviderCreateWithURL(url)
    if epsDataProvider is None:
        print >>sys.stderr, "Couldn't create EPS data provider!"
        return None

    # Create the hybrid CGImage that contains the preview image
    # and the EPS data. Note that the data provider isn't
    # called during image creation but at some later point in time.


    epsImage = PMCGImageCreateWithEPSDataProvider(epsDataProvider, previewImage)
    # The preview image and data provider are no longer needed
    # because Quartz retains them and this code doesn't
    # require them further.
    del previewImage
    del epsDataProvider

    if epsImage is None:
        print >>sys.stderr, "Couldn't create EPS hybrid image!"
        return None

    return epsImage

def drawEPSDataImage(context, url):
    # Create the a CGImage that has EPS data associated with it.
    epsDataImage = createCGEPSImage(url)
    if epsDataImage is None:
        return

    # Create a destination rectangle at the location
    # to draw the EPS document. The size of the rect is scaled
    # down to 1/2 the size of the EPS graphic.
    destinationRect = CGRectMake(100, 100,
                        CGImageGetWidth(epsDataImage),
                        CGImageGetHeight(epsDataImage))
    # Draw the image to the destination. When the EPS
    # data associated with the image is sent to a PostScript
    # printer, the EPS bounding box is mapped to this
    # destination rectangle, translated and scaled as necessary.
    CGContextDrawImage(context, destinationRect, epsDataImage)

    # Draw the image a second time. This time the image is
    # rotated by 45 degrees and scaled by an additional scaling factor
    # of 0.5 in the x dimension. The center point of this image coincides
    # with the center point of the earlier drawing.
    CGContextTranslateCTM(context,
            destinationRect.origin.x + destinationRect.size.width/2,
            destinationRect.origin.y + destinationRect.size.height/2)
    CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45))
    CGContextScaleCTM(context, 0.5, 1)
    CGContextTranslateCTM(context,
            -(destinationRect.origin.x + destinationRect.size.width/2),
            -(destinationRect.origin.y + destinationRect.size.height/2) )
    CGContextDrawImage(context, destinationRect, epsDataImage)

FrameworkTextDrawing.py

from Quartz import *
from Cocoa import *
import Utilities
import QuartzTextDrawing

import sys
import objc

def getTextString():
    # These unicode values are the characters: Q, u, a, r, t, z,
    # eighthnote, floral heart, black chess queen, and two CJK characters.
    # Note: Create an NSString, because we'll use NSString-specific API's, otherwise
    # we could just have used a python unicode object
    return NSString.stringWithString_(u'\u0051\u0075\u0061\u0072\u0074\u007A\u266A\u2766\u265B\u3042\u304E')

doPointDrawing=1

def drawNSStringWithAttributes():
    textString = getTextString()
    if doPointDrawing:
        context = NSGraphicsContext.currentContext().graphicsPort()

    # Text Line 1. Draw with default attributes.
    p = NSMakePoint(20.0, 400.0)

    # Draw text with default text attributes. The point supplied is
    # not the text baseline but rather the lower-left corner of the box
    # which bounds the text.
    textString.drawAtPoint_withAttributes_(p, None)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    # Text Line 2. Draw with a specific font and color.

    # Position the text 50 units below the previous text.
    p.y -= 50

    # Set attributes to use when drawing the string.
    stringAttributes = {
        # Use the font with the PostScript name "Times-Roman" at 40 point.
        NSFontAttributeName: NSFont.fontWithName_size_("Times-Roman", 40),

        # Set the color attribute to an opaque red.
        NSForegroundColorAttributeName: NSColor.colorWithCalibratedRed_green_blue_alpha_(0.663, 0, 0.031, 1.0)
    }

    # Draw the text.
    textString.drawAtPoint_withAttributes_(p, stringAttributes)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    # Text Line 3. Draw stroked text.

    # Position the text 50 units below the previous text.
    p.y -= 50

    # Panther and later support stroke attributes. A positive value
    # of the stroke width attribute produces text that is stroked rather
    # than filled.
    stringAttributes[NSStrokeWidthAttributeName] = 3.0
    textString.drawAtPoint_withAttributes_(p, stringAttributes)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    # Text Line 4. Draw with fill and stroke.

    p.y -= 50

    # Panther and later support stroke attributes. A negative value
    # of the stroke width attribute results in text that is both filled
    # and stroked.
    stringAttributes[NSStrokeWidthAttributeName] = -3.0
    # Set the stroke color attribute to black.
    stringAttributes[NSStrokeColorAttributeName] = NSColor.colorWithCalibratedRed_green_blue_alpha_(0, 0, 0, 1.0)

    textString.drawAtPoint_withAttributes_(p, stringAttributes)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    # Text Line 5. Draw at baseline.
    # Tiger and later support the drawWithRect method which allows
    # string text drawing from a point on the text baseline.
    p.y -= 50
    rect = NSRect(
            origin=p,
            size=NSSize(0,0),
        )
    textString.drawWithRect_options_attributes_(
            rect, NSStringDrawingDisableScreenFontSubstitution,
            stringAttributes)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

_myLayout = None
_textStorage = None
_myTextRange = None
def drawWithNSLayout():
    global _myLayout, _textStorage, _myTextRange

    if _myLayout is None:
        # Initialize the text storage with the string to draw.
        _textStorage = NSTextStorage.alloc().initWithString_(getTextString())
        # Initialize the layout manager to use with the text storage.
        _myLayout = NSLayoutManager.alloc().init()
        # Allocate and initialize a text container object.
        textContainer = NSTextContainer.alloc().init()
        # Add the text container to the layout.
        _myLayout.addTextContainer_(textContainer)
        # Release the text container since the layout retains it and
        # this code no longer needs it.
        del textContainer
        # Add the layout to the text storage.
        _textStorage.addLayoutManager_(_myLayout)

        # Set attributes to use when drawing the string.
        stringAttributes = {
            # Use the font with the PostScript name "Times-Roman" at 40 point.
            NSFontAttributeName: NSFont.fontWithName_size_("Times-Roman", 40),

            # Set the text color attribute to an opaque red.
            NSForegroundColorAttributeName:  NSColor.colorWithCalibratedRed_green_blue_alpha_(0.663, 0, 0.031, 1.0),
        }

        # Create the range of text for the entire length of text
        # in the textStorage object.
        _myTextRange = NSMakeRange(0, _textStorage.length())
        # Set the attributes on the entire range of text.
        _textStorage.setAttributes_range_(stringAttributes, _myTextRange)

    # Set the point for drawing the layout.
    p = NSMakePoint(20.0, 400.0)

    # Draw the text range at the point.
    _myLayout.drawGlyphsForGlyphRange_atPoint_(_myTextRange, p)

    if doPointDrawing:
        context = NSGraphicsContext.currentContext().graphicsPort()
        Utilities.drawPoint(context, p)

# The interface to the NSLayoutManager subclass.
class MyNSLayoutManager (NSLayoutManager):
    # The extra instance variables for this subclass.
    _textMode = objc.ivar()
    _fColor = objc.ivar()
    _sColor = objc.ivar()
    _yStartPosition = objc.ivar()
    _lineWidth = objc.ivar()
    _clippingDrawProc = objc.ivar()
    _clippingInfo = objc.ivar()

    # Public methods to set the special attributes
    # of the MyNSLayoutManager instance.
    def setTextMode_(self, textMode):
        self._textMode = textMode

    def setFillColor_(self, color):
        self._fColor = color

    def setStrokeColor_(self, color):
        self._sColor = color

    def setTextLineWidth_(self, width):
        self._lineWidth = width

    def setClippingDrawProc_withInfo_(self, clippingDrawProc, info):
        self._clippingDrawProc = clippingDrawProc
        self._clippingInfo = info

    def init(self):
        self = super(MyNSLayoutManager, self).init()
        if self is None:
            return None


        # Initialize the custom instance variables.
        self._textMode = kCGTextFill
        self._fColor = None
        self._sColor = None
        self._yStartPosition = 0
        self._lineWidth = 1
        self._clippingDrawProc = None
        self._clippingInfo = None
        return self

    # This code overrides this method to record the y coordinate
    # to use as the True baseline for the text drawing.
    def drawGlyphsForGlyphRange_atPoint_(self, glyphsToShow, origin):
        self._yStartPosition = origin.y
        super(MyNSLayoutManager, self).drawGlyphsForGlyphRange_atPoint_(glyphsToShow, origin)

    # This is the rendering method of NSLayoutManager that the
    # code overrides to perform its custom rendering.
    def showPackedGlyphs_length_glyphRange_atPoint_font_color_printAdjustment_(
            self, glyphs, glyphLen, glyphRange, point, font, color, printingAdjustment):

       # Obtain the destination drawing context.
        context = NSGraphicsContext.currentContext().graphicsPort()

        # Adjust start position y value based on the adjusted y coordinate.
        # This ensures the text baseline is at the starting position
        # passed to drawGlyphsForGlyphRange. This technique won't work
        # for super, subscripts, or underlines but that's OK for this example.
        point.y = _yStartPosition

        # The Quartz graphics state should be preserved by showPackedGlyphs.
        CGContextSaveGState(context)

        # Set the desired text drawing mode.
        CGContextSetTextDrawingMode(context, self._textMode)

        # Set the fill color if needed.
        if (self._textMode == kCGTextFill or _self.textMode == kCGTextFillStroke or
                self._textMode == kCGTextFillClip or _textMode == kCGTextFillStrokeClip):
            if self._fColor is not None:
                CGContextSetFillColorWithColor(context, self._fColor)

        # Set the  line width and the stroke color if needed.
        if (self._textMode == kCGTextStroke or self._textMode == kCGTextFillStroke or
                self._textMode == kCGTextStrokeClip or self._textMode == kCGTextFillStrokeClip):
            CGContextSetLineWidth(context, self._lineWidth)
            if self._sColor is not None:
                CGContextSetStrokeColorWithColor(context, self._sColor)

        # Now draw the text. Check whether to adjust for printing widths
        # and if needed adjust extra character spacing accordingly.
        if printingAdjustment.width != 0.0:
            # If printingAdjustment width is non-zero then the text
            # needs to be adjusted. printingAdjustment is the per character
            # adjustment required for this piece of text. Because
            # the Quartz text character spacing set is transformed by
            # the text matrix, this code needs to factor out that effect
            # prior to setting it. Cocoa sets the text matrix to account
            # for the point size of the font so we factor that out of the
            # per character width supplied here.
            charAdjust = printingAdjustment.width / font.pointSize()
            CGContextSetCharacterSpacing(context, charAdjust)
        else:
            CGContextSetCharacterSpacing(context, 0.0)

        # Draw the glyphs. The total number of glyphs is the length
        # of the glyphs string passed to showPackedGlyphs, divided by 2
        # since there are two bytes per glyph.
        CGContextShowGlyphsAtPoint(context, point.x, point.y, glyphs, glyphLen/2)

        # If the text drawing mode requires clipping and there is
        # a custom clipping proc, call it. This allows drawing through
        # clipped text before the graphics state is restored.
        if (self._textMode == kCGTextClip or self._textMode == kCGTextFillClip or
                self._textMode == kCGTextStrokeClip or
                self._textMode == kCGTextFillStrokeClip) and self._clippingDrawProc is not None:

            self._clippingDrawProc(context, point.x, point.y, self._clippingInfo)

        CGContextRestoreGState(context)

def MyClipProc(c, x, y, info):
    CGContextTranslateCTM(c, x, y)
    CGContextSetStrokeColorWithColor(c, Utilities.getRGBOpaqueBlackColor())
    # Draw a grid of lines through the clip.
    QuartzTextDrawing.drawGridLines(c);

_myLayout = None
_textStorage = None
_myTextRange = None
def drawWithCustomNSLayout():
    global _myLayout, _textStorage, _myTextRange

    if _myLayout is None:
        textContainer = NSTextContainer.alloc().init()

        _textStorage = NSTextStorage.alloc().initWithString_(getTextString())
        # Create an instance of the MyNSLayoutManager subclass of NSLayoutManager.
        _myLayout = MyNSLayoutManager.alloc().init()
        _myLayout.addTextContainer_(textContainer)
        # The layout retains the text container so this code can release it.
        del textContainer
        _textStorage.addLayoutManager_(_myLayout)

        # Set attributes to use when drawing the string.
        stringAttributes = {
            # Use the font with the PostScript name "Times-Roman" at 40 point.
            NSFontAttributeName: NSFont.fontWithName_size_("Times-Roman", 40),
        }

        # Create the range.
        _myTextRange = NSMakeRange(0, _textStorage.length())
        # Set the attributes on the entire range of text.
        _textStorage.setAttributes_range_(stringAttributes, _myTextRange)

    p = NSMakePoint(20.0, 400.0)

    # Set the custom attributes of the layout subclass so that
    # the text will be filled with black.
    _myLayout.setTextMode_(kCGTextFill)
    _myLayout.setFillColor_(Utilities.getRGBOpaqueBlackColor())

    # Draw text line 1.
    _myLayout.drawGlyphsForGlyphRange_atPoint_(_myTextRange, p)

    if doPointDrawing:
        context = NSGraphicsContext.currentContext().graphicsPort()
        Utilities.drawPoint(context, p)

    # Set the custom attributes of the layout subclass so that
    # the text will be stroked with black.
    _myLayout.setTextMode_(kCGTextStroke)
    _myLayout.setStrokeColor_(Utilities.getRGBOpaqueBlackColor())
    _myLayout.setTextLineWidth_(2)

    # Draw text line 2.
    p.y -= 50;
    _myLayout.drawGlyphsForGlyphRange_atPoint_(_myTextRange, p)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    p.y -= 50;

    # Set the custom attributes of the layout subclass so that
    # the text will be filled and stroked and the fill color
    # will be red. Since the stroke color hasn't changed it
    # will be stroked with black.
    _myLayout.setTextMode_(kCGTextFillStroke)
    _myLayout.setFillColor_(Utilities.getRGBOpaqueRedColor())
    # Draw text line 3.
    _myLayout.drawGlyphsForGlyphRange_atPoint_(_myTextRange, p)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    p.y -= 50;

    # Set the custom attributes of the layout subclass so that
    # the text will be filled, stroked, then clipped.
    _myLayout.setTextMode_(kCGTextFillStrokeClip)

    # Set the clipping proc to MyClipProc which requires
    # no info data.
    _myLayout.setClippingDrawProc_withInfo_(MyClipProc, None)

    # Draw text line 4.
    _myLayout.drawGlyphsForGlyphRange_atPoint_(_myTextRange, p)

    if doPointDrawing:
        Utilities.drawPoint(context, p)

    # Set the clipping proc to None for future drawing.
    _myLayout.setClippingDrawProc_withInfo_(None, None)

FrameworkUtilities.py

from Cocoa import *
from Quartz import *

import AppDrawing

def myCreatePDFDataFromPasteBoard():
    # Obtain the pasteboard to examine.
    pboard = NSPasteboard.generalPasteboard()

    # Scan the types of data on the pasteboard and return the first type available that is
    # listed in the array supplied. Here the array of requested types contains only one type,
    # that of PDF data. If your application could handle more types, you would list them in
    # the creation of this array.
    type = pboard.availableTypeFromArray_([NSPDFPboardType])

    # If the string is non-nil, there was data of one of our requested types
        # on the pasteboard that can be obtained.
    if type is not None:
        # Test that the type is the PDF data type. This code is not strictly necessary
        # for this example since we only said we could handle PDF data, but is appropriate
        # if you can handle more types than just PDF.
        if type == NSPDFPboardType:
            # Get the PDF data from the pasteboard.
            pdfData = pboard.dataForType_(type)
            if pdfData is not None:
                return pdfData
            else:
                NSLog("Couldn't get PDF data from pasteboard!")
    else:
        NSLog("Pasteboard doesn't contain PDF data!")
    return None

def addPDFDataToPasteBoard(command):
    pdfData = cfDataCreatePDFDocumentFromCommand(command)
    if pdfData is not None:
        pboard = NSPasteboard.generalPasteboard()
        pboard.declareTypes_owner_(NSPDFPboardType, None)
        pboard.setData_forType_(pdfData, NSPDFPboardType)

ImageMasking.h

#ifndef __ImageMasking__
#define __ImageMasking__

#include <ApplicationServices/ApplicationServices.h>

void doOneBitMaskImages(CGContextRef context);

void doMaskImageWithMaskFromURL(CGContextRef context,
                                    CFURLRef imageURL, size_t imagewidth,
                                size_t imageheight, size_t bitsPerComponent,
                                CFURLRef theMaskingImageURL, size_t maskwidth,
                                size_t maskheight);

void doMaskImageWithColorFromURL(CGContextRef context, CFURLRef url,
                                    size_t width, size_t height,
                                    Boolean isColor);

void exportImageWithMaskFromURLWithDestination(CGContextRef context,
                                CFURLRef imageURL, size_t imagewidth,
                                size_t imageheight, size_t bitsPerComponent,
                                CFURLRef theMaskingImageURL, size_t maskwidth,
                                size_t maskheight);

void doMaskImageWithGrayImageFromURL(CGContextRef context, CFURLRef imageURL, size_t imagewidth,
                                size_t imageheight, size_t bitsPerComponent,
                                CFURLRef theMaskingImageURL, size_t maskwidth,
                                size_t maskheight);

void drawWithClippingMask(CGContextRef context,
                            CFURLRef theMaskingImageURL,  size_t maskwidth,
                            size_t maskheight);


#endif      // __ImageMasking__

ImageMasking.py

from Quartz import *

import Images
import DataProvidersAndConsumers
import Utilities

import sys

def exportImageWithMaskFromURLWithDestination(context, imageURL,
        imagewidth, imageheight, bitsPerComponent,
        theMaskingImageURL, maskwidth, maskheight):

    imageBitsPerPixel = bitsPerComponent * 3
    bytesPerRow = ((imagewidth * imageBitsPerPixel) + 7)/8
    shouldInterpolate = True
    imageDataProvider = CGDataProviderCreateWithURL(imageURL)
    if imageDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    colorspace = Utilities.getTheCalibratedRGBColorSpace()
    image = CGImageCreate(imagewidth, imageheight, bitsPerComponent,
                        imageBitsPerPixel, bytesPerRow, colorspace,
                        kCGImageAlphaNone, imageDataProvider,
                        None, shouldInterpolate,
                        kCGRenderingIntentDefault)
    del imageDataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(0.0,imageheight, imagewidth, imageheight)
    # Draw the image.
    CGContextDrawImage(context, imageRect, image)

    # Now the mask.
    maskDataProvider = CGDataProviderCreateWithURL(theMaskingImageURL)
    if maskDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    mask = CGImageMaskCreate(maskwidth, maskheight, bitsPerComponent,
                            bitsPerComponent, maskwidth,
                            maskDataProvider, None, shouldInterpolate)
    del maskDataProvider
    if mask is None:
        print >>sys.stderr, "Couldn't create CGImageRef for mask data!"
        return

    # Draw the mask below the image.
    maskRect = CGRectMake(0.0, 0.0, maskwidth, maskheight)
    CGContextDrawImage(context, maskRect, mask)

    # Create a new CGImage object, the image, masked with mask.
    imageMaskedWithImage = CGImageCreateWithMask(image, mask)
    # Once the new image is created, we can release the image
    # and the mask which make it up. Quartz retains what it needs
    # for the new masked image.
    del image
    del mask

    if imageMaskedWithImage is None:
        print >>sys.stderr, "Couldn't create image masked with mask!"
        return

    imageRect = CGRectMake(imagewidth, imageheight/2, imagewidth, imageheight)
    # Draw the masked image to the right of the image and its mask.
    CGContextDrawImage(context, imageRect, imageMaskedWithImage)

    # Of course this is a total hack.
    outPath = "/tmp/imageout.png"
    exportURL = CFURLCreateFromFileSystemRepresentation(None,
                                    outPath, len(outPath), False)

    if exportURL is not None:
        Images.exportCGImageToPNGFileWithDestination(imageMaskedWithImage, exportURL)

_data = ''.join(map(chr, (
        0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xFE, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x00, 0x03, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0xF8, 0xE7, 0xFF, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x00, 0x40, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xC0,
        0x00, 0x00, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00,
        0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x00,
        0x00, 0x00, 0x00, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x00, 0x00, 0x00,
        0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0x80, 0x00,
        0x00, 0x00, 0x00, 0x00, 0x00, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
        0x00, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x07, 0xFF, 0xFF,
        0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x06, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00,
        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
        0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F, 0xFF,
        0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFE, 0x00, 0x00,
        0x00, 0x00, 0x01, 0xC0, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x0F, 0xF8,
        0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x0F, 0xFF, 0xF8, 0x00, 0x00, 0x7F, 0xFF,
        0xFF, 0xFE, 0x00, 0x00, 0x00, 0x1F, 0xFF, 0xFC, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFE, 0x00, 0x00,
        0x00, 0x7F, 0xFF, 0xFC, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFC,
        0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x03, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0xFF, 0xFF,
        0xFF, 0xF0, 0x00, 0x00, 0x03, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xF8, 0x00, 0x00,
        0x0F, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x0F, 0xFF, 0xFF, 0xFF,
        0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0xFF, 0xFF,
        0xFF, 0xE0, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0x80, 0x01, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00,
        0x7F, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x1F, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFF,
        0x80, 0x00, 0x1F, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x1F, 0xFF,
        0xFF, 0xF8, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x1F, 0xFF, 0xFF, 0xF8, 0x00, 0x00,
        0x7F, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x1F, 0xFF, 0xFF, 0xFC, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFE,
        0x40, 0x00, 0x0F, 0xFF, 0xFF, 0xFC, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x1F, 0xFF,
        0xFF, 0xFC, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xFC, 0x00, 0x01,
        0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFC, 0x00, 0x05, 0xEF, 0xFF, 0xFE, 0x00,
        0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xF0, 0x00, 0x3F, 0x00, 0x03, 0xFC, 0x00, 0x00, 0x00, 0x3F, 0xFF,
        0xFF, 0xE0, 0x00, 0x7C, 0x00, 0x00, 0x78, 0x1F, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xC0, 0x00, 0x38,
        0x00, 0x00, 0x78, 0x3C, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x78, 0x00, 0x00, 0x70, 0x18,
        0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x78, 0x1F, 0x00, 0x30, 0x00, 0x00, 0x01, 0xFF, 0xFF,
        0xFF, 0xFE, 0x00, 0x7C, 0x3F, 0x00, 0x18, 0x00, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00,
        0x00, 0x00, 0x38, 0x00, 0x00, 0x03, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x80, 0x00, 0x3C, 0x00,
        0x0C, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x3C, 0x20, 0x1C, 0x03, 0xFF, 0xFF,
        0xFF, 0xFF, 0x00, 0x00, 0x04, 0x00, 0x3C, 0x00, 0x3C, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x70,
        0xBF, 0x86, 0x3C, 0x1F, 0xFC, 0x0B, 0xFF, 0xFF, 0xFF, 0xFF, 0xA0, 0x11, 0xF0, 0x0E, 0x3C, 0x1F,
        0xFE, 0x8B, 0xFF, 0xFF, 0xFF, 0xFF, 0xA0, 0x19, 0xF0, 0x0C, 0x3C, 0x0F, 0xFF, 0x0B, 0xFF, 0xFF,
        0xFF, 0xFF, 0xB0, 0x1D, 0xFE, 0x1C, 0x7E, 0x0F, 0xFF, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0xB8, 0x1C,
        0xFF, 0x3C, 0xFE, 0x03, 0xFE, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x1E, 0x7F, 0xF8, 0xDE, 0x00,
        0x7C, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x1E, 0x7F, 0xF1, 0xDF, 0x30, 0x03, 0x83, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFE, 0x1F, 0x3F, 0xE3, 0x9F, 0x10, 0x3F, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x0F,
        0xFF, 0x83, 0xDF, 0x80, 0x1F, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x03, 0xFC, 0x03, 0xDF, 0x81,
        0x8F, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x07, 0xFE, 0x1F, 0x8F, 0x00, 0x07, 0x83, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0x07, 0xFE, 0x3C, 0x06, 0x00, 0x01, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x03,
        0xFC, 0x7C, 0x00, 0x00, 0x01, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x01, 0xF8, 0x7F, 0x00, 0x00,
        0x01, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x01, 0xF8, 0xFF, 0xE0, 0x30, 0x01, 0x83, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0x00, 0xF1, 0xEF, 0xF9, 0xE0, 0x03, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x80,
        0xF1, 0xFF, 0xFF, 0x80, 0x0F, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x03, 0xE2, 0xFF, 0xFE, 0x00,
        0x1F, 0x87, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x83, 0xF0, 0x00, 0x00, 0x1C, 0x3F, 0x87, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xC3, 0xF0, 0x00, 0x01, 0xF8, 0x0F, 0x87, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xC3,
        0xF0, 0x03, 0xFF, 0xF0, 0x5F, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xC1, 0xFF, 0xC7, 0xFF, 0xE0,
        0x7F, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE1, 0xFF, 0xF1, 0xFF, 0x80, 0x2F, 0x0F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xE1, 0xFF, 0xF8, 0x0F, 0xC0, 0x06, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF4,
        0xFF, 0xFE, 0x0F, 0xF8, 0x44, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF4, 0xFF, 0xFF, 0xFF, 0xF8,
        0x64, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF9, 0xFF, 0xFF, 0xFF, 0x3C, 0xE4, 0x7F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFD, 0x9F, 0xFF, 0xFC, 0x1F, 0xC0, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFD,
        0x1F, 0xFF, 0xFC, 0x03, 0xC0, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x01, 0xFF, 0xFF, 0xFF,
        0xC0, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0xFF, 0xFF, 0xFF, 0x00, 0x7F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0xFF, 0xFF, 0xFF, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE,
        0x80, 0x7F, 0xFF, 0xFF, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x80, 0x1F, 0xFF, 0xFF,
        0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0xC0, 0x0F, 0xFF, 0xFF, 0x00, 0x1F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x07, 0xFF, 0xFF, 0x00, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xF0, 0x03, 0xFF, 0xFF, 0x00, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x70, 0x01, 0xFF, 0xFC,
        0x00, 0x17, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x78, 0x00, 0x7F, 0xF0, 0x00, 0x07, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xF0, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x03,
        0xFE, 0x00, 0x00, 0x00, 0x00, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x1F, 0xFF, 0x80, 0x00, 0x00,
        0x00, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x7F, 0x7F, 0xC0, 0x00, 0x00, 0x00, 0x07, 0xFF, 0xFF
    )))

def getMaskData1():
    return _data

_data2 = ''.join(map(chr, (
        0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x00, 0x1F,
        0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xFF, 0x00, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x00, 0x00, 0x00,
        0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x00, 0x03, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xE0, 0x00, 0x00, 0x00, 0x01, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x00,
        0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE,
        0x00, 0x00, 0x00, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00,
        0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8,
        0x00, 0x00, 0x00, 0x00, 0x00, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x00, 0x01,
        0x80, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x00, 0x03, 0xC0, 0x07, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x00, 0x0B, 0xE0, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0,
        0x00, 0x00, 0x00, 0x07, 0xF0, 0x03, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0x00, 0x1F,
        0xF4, 0x83, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x00, 0x3F, 0xE4, 0x03, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x00, 0x3F, 0xE4, 0x43, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x80,
        0x00, 0x00, 0x00, 0x3F, 0xE4, 0x4B, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x00, 0x02, 0xFF,
        0xE4, 0x5B, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x02, 0xFF, 0xE0, 0x5B, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x07, 0xC1, 0xFF, 0xE0, 0x59, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x18,
        0x00, 0x7F, 0xF0, 0xFE, 0x00, 0x79, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x18, 0x00, 0x78, 0x0F, 0xFE,
        0x04, 0xE1, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x18, 0x00, 0xB0, 0x47, 0xFF, 0xFF, 0xE1, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFE, 0x10, 0x00, 0xC4, 0x69, 0xFF, 0xFF, 0xC3, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0x10,
        0x01, 0xFF, 0xE1, 0xFC, 0x07, 0xC1, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x00, 0x01, 0xFF, 0xF8, 0x78,
        0x01, 0xC5, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x04, 0x01, 0xFF, 0xF0, 0x78, 0x01, 0xC5, 0xFF, 0xFF,
        0xFF, 0xFF, 0xFC, 0x0C, 0x00, 0xFF, 0xF8, 0x7E, 0x3F, 0xC1, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x0C,
        0x00, 0x7F, 0xF0, 0x18, 0xFF, 0xC3, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x07, 0x00, 0x7F, 0xF4, 0x1F,
        0xFF, 0xE3, 0xFF, 0xFF, 0xFF, 0xFF, 0xFC, 0x23, 0x00, 0x7F, 0xE0, 0x3E, 0xFF, 0xE3, 0xFF, 0xFF,
        0xFF, 0xFF, 0xF8, 0x11, 0x00, 0x7F, 0xEC, 0x5F, 0xBF, 0xE3, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x01,
        0x00, 0x3F, 0xCE, 0x7E, 0x3F, 0xE3, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x08, 0x00, 0x7F, 0x80, 0x2E,
        0x3F, 0xE3, 0xFF, 0xFF, 0xFF, 0xFF, 0xF8, 0x06, 0x00, 0x7F, 0x00, 0x6E, 0x3F, 0xEB, 0xFF, 0xFF,
        0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x7E, 0x0D, 0xFE, 0xFF, 0xEB, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00,
        0x00, 0x3C, 0x00, 0xFE, 0x3F, 0xEB, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x50, 0x00, 0xFE,
        0x3F, 0xCB, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0x01, 0x98, 0xFF, 0x3F, 0xCB, 0xFF, 0xFF,
        0xFF, 0xFF, 0xF0, 0x00, 0x00, 0xC7, 0xE1, 0xFF, 0x3F, 0x8B, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00,
        0x00, 0x40, 0xFF, 0xFF, 0xBF, 0x8B, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0xE0, 0x1F, 0xFF,
        0xDF, 0x0B, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00, 0x00, 0xE8, 0x63, 0xFF, 0xDF, 0x0F, 0xFF, 0xFF,
        0xFF, 0xFF, 0xF0, 0x00, 0x02, 0xFC, 0xF9, 0xFF, 0xEF, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xF0, 0x00,
        0x03, 0xFE, 0x7F, 0xF8, 0x1E, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x03, 0x7E, 0x0F, 0xF9,
        0xBE, 0x05, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x01, 0x7F, 0xC1, 0xF3, 0xFC, 0x05, 0xFF, 0xFF,
        0xFF, 0xFF, 0xE0, 0x00, 0x01, 0x3D, 0xF8, 0x0F, 0x7C, 0x05, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00,
        0x01, 0xBC, 0x7F, 0xFF, 0xF8, 0x02, 0xFF, 0xFF, 0xFF, 0xFF, 0xE0, 0x00, 0x00, 0xBE, 0xFF, 0xFF,
        0xF8, 0x02, 0xFF, 0xFF, 0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x1D, 0xFF, 0xFF, 0xF0, 0x00, 0xFF, 0xFF,
        0xFF, 0xFF, 0xC0, 0x00, 0x00, 0x0F, 0xF7, 0xFF, 0xE0, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0xC0, 0x00,
        0x00, 0x0F, 0xF3, 0xFF, 0xE0, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x00, 0x03, 0xF3, 0xFF,
        0xC0, 0x00, 0x7F, 0xFF, 0xFF, 0xFF, 0x80, 0x00, 0x00, 0x01, 0xF7, 0xFF, 0x80, 0x00, 0x3F, 0xFF,
        0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x3F, 0xFF, 0x00, 0x00, 0x3F, 0xFF, 0xFF, 0xFF, 0x00, 0x00,
        0x00, 0x00, 0x1F, 0xFF, 0x00, 0x20, 0x3F, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x1F, 0xFF,
        0x00, 0x10, 0x3F, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x1F, 0xFF, 0x00, 0x10, 0x3F, 0xFF,
        0xFF, 0xFC, 0x00, 0x00, 0x02, 0x00, 0x0F, 0xFF, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xFC, 0x00, 0x00,
        0x04, 0x00, 0x1F, 0xFE, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x07, 0x81, 0x7F, 0xFE,
        0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xF8, 0x00, 0x00, 0x03, 0xDF, 0xFF, 0xFE, 0x00, 0x00, 0x1F, 0xFF,
        0xFF, 0xF8, 0x00, 0x00, 0x07, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xF0, 0x00, 0x00,
        0x07, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x1F, 0xFF, 0xFF, 0xF0, 0x00, 0x40, 0x07, 0xFF, 0xFF, 0xFE,
        0x00, 0x00, 0x0F, 0xFF, 0xFF, 0xF0, 0x00, 0xC0, 0x03, 0xFF, 0xFF, 0xFE, 0x00, 0x00, 0x0F, 0xFF,
        0xFF, 0xE0, 0x00, 0xE0, 0x07, 0xFF, 0xFF, 0xFE, 0x81, 0x00, 0x07, 0xFF, 0xFF, 0xC0, 0x01, 0xE0,
        0x07, 0xFF, 0xFF, 0xFE, 0x01, 0x00, 0x07, 0xFF, 0xFF, 0x80, 0x0F, 0xF0, 0x03, 0xFF, 0xFF, 0xFE,
        0x83, 0x80, 0x03, 0xFF, 0xFF, 0x00, 0x1F, 0xF0, 0x13, 0xFF, 0xFF, 0xFE, 0x03, 0xE0, 0x01, 0xFF,
        0xFC, 0x03, 0x3F, 0xF0, 0x21, 0xFF, 0xFF, 0xFE, 0x03, 0xFC, 0x00, 0x3F, 0xF0, 0x3F, 0x3F, 0xF8,
        0x3B, 0xFF, 0xFF, 0xFE, 0x03, 0xFE, 0xC0, 0x0F, 0xE3, 0xFB, 0x7F, 0xF8, 0x3B, 0xFF, 0xFF, 0xFF,
        0x07, 0xFF, 0xFF, 0x07, 0x9F, 0xFB, 0x7F, 0xFC, 0x79, 0xFF, 0xFF, 0xFF, 0x07, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0x7F, 0xFC, 0x39, 0xFF, 0xFF, 0xFF, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFE,
        0x3F, 0xFF, 0xFF, 0xFE, 0x07, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFE, 0x1F, 0xFF, 0xFF, 0xFE,
        0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFE, 0x1F, 0x7F, 0xFF, 0xFE, 0x0F, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0x7F, 0xFF, 0x1F, 0xFE, 0xFF, 0xFC, 0x0F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0x0F, 0xFF, 0xFF, 0xFF, 0x1F, 0xFF, 0xEF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x87, 0xFF, 0xFF, 0xFE,
        0x1F, 0xFF, 0xEF, 0xFF, 0xFF, 0xFF, 0xBF, 0xFF, 0x82, 0xFF, 0xFF, 0xFC, 0x3F, 0xFF, 0xFF, 0xFF,
        0xFF, 0xFF, 0xBF, 0xFF, 0x83, 0xFF, 0xFF, 0xFC, 0x3F, 0xFF, 0xBF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
        0xC1, 0xFF, 0xFF, 0xF8, 0x7F, 0xFF, 0xBF, 0xFF, 0xFF, 0xFF, 0xBF, 0xFF, 0xE0, 0xFF, 0xFF, 0xF0,
        0xFF, 0xFF, 0xBF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF
    )))
def getMaskData2():
    return _data2


def doOneBitMaskImages(context):
    bitsPerComponent = 1
    bitsPerPixel = 1
    width = 96
    height = 96
    bytesPerRow = 12

    imageDataSize = bytesPerRow*height
    shouldInterpolate = True
    lightBlue = [0.482, 0.62, 0.871, 1.0]
    black = [0.0, 0.0, 0.0, 1.0]
    darkRed = [0.663, 0., 0.031, 1.0]
    darkGreen = [0.404, 0.808, 0.239, 1.0]
    darkBlue = [0.11, 0.208, 0.451, 1.0]
    purple = [0.69, 0.486, 0.722, 1.0]
    darkOrange = [0.965, 0.584, 0.059, 1.0]

    # A decode array contains two elements for each component. In this
    # case, an image mask has one component so the array consists of
    # two values. When using this decode array, a sample value of 0
    # is mapped into the value 1, and the maximum sample value is
    # mapped into the value 0. This inverts the sense of the mask data.
    decode = (1 , 0)

    # Create a Quartz data provider for the image data. Because this
    # data is static data, we don't need to release it so the data
    # release function is None.
    data = getMaskData1()
    dataProvider = CGDataProviderCreateWithData(None, data, imageDataSize, None)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Mask1 Data provider!"
        return

    # Create a mask from the data.
    mask1 = CGImageMaskCreate(width, height, bitsPerComponent,
                                    bitsPerPixel, bytesPerRow, dataProvider,
                                    None, shouldInterpolate)
    # Create the same mask but with a decode array that
    # inverts the sense of the mask.
    invertedmask1 = CGImageMaskCreate(width, height,
                                    bitsPerComponent, bitsPerPixel, bytesPerRow,
                                    dataProvider, decode, shouldInterpolate)
    # Release the data provider now that this code no longer needs it.
    del dataProvider

    if mask1 is None or invertedmask1 is None:
        if mask1 is None:
            print >>sys.stderr, "Couldn't create CGImageRef for the mask data 1!"

        if invertedmask1 is None:
            print >>sys.stderr, "Couldn't create CGImageRef for the inverted mask data 1!"
        return

    # Get the pointer to the data for the second mask.
    data = getMaskData2()
    dataProvider = CGDataProviderCreateWithData(None, data, imageDataSize, None)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Mask2 Data provider!"
        return

    mask2 = CGImageMaskCreate(width, height, bitsPerComponent,
                                bitsPerPixel, bytesPerRow, dataProvider,
                                None, shouldInterpolate)
    # Create the same mask but with a decode array that
    # inverts the sense of the mask.
    invertedmask2 = CGImageMaskCreate(width, height,
                                    bitsPerComponent, bitsPerPixel, bytesPerRow,
                                    dataProvider, decode, shouldInterpolate)
    # Release the data provider now that this code no longer needs it.
    del dataProvider
    if mask2 is None or invertedmask2 is None:
        if mask2 is None:
            print >>sys.stderr, "Couldn't create CGImageRef for the mask data 2!"

        if invertedmask2 is None:
            print >>sys.stderr, "Couldn't create CGImageRef for the inverted mask data 2!"

        return

    CGContextScaleCTM(context, 1.5, 1.5)
    colorSpace = Utilities.getTheCalibratedRGBColorSpace()
    CGContextSetFillColorSpace(context, colorSpace);

    # Set the fill color to a light blue.
    CGContextSetFillColor(context, lightBlue)
    # Paint part of the background.
    backRect = CGRectMake(width/2, height/2, width*3, height)
    CGContextFillRect(context, backRect)

    imageRect = CGRectMake(0., height, width, height)
    CGContextSaveGState(context)
    # Set the fill color to opaque black.
    CGContextSetFillColor(context, black)
    # Mask 1.
    CGContextDrawImage(context, imageRect, mask1)

    CGContextTranslateCTM(context, width, 0)
    # Set the fill color to opaque red.
    CGContextSetFillColor(context, darkRed);
    # Mask 2.
    CGContextDrawImage(context, imageRect, mask2)
    CGContextTranslateCTM(context, width, 0)
    # Set the fill color to dark orange.
    CGContextSetFillColor(context, darkOrange)
    # Mask 3.
    CGContextDrawImage(context, imageRect, mask1)

    CGContextTranslateCTM(context, width, 0)
    # Make the orange 50% transparent.
    darkOrange[3] = 0.5
    CGContextSetFillColor(context, darkOrange)
    # Mask 4.
    CGContextDrawImage(context, imageRect, mask2)
    CGContextRestoreGState(context)

    # Translate down the page. The cast is necessary
    # since height is typed as size_t which is unsigned.
    CGContextTranslateCTM(context, 0, -height)

    # Set the fill color to an opaque green.
    CGContextSetFillColor(context, darkGreen)
    # Mask 5.
    CGContextDrawImage(context, imageRect, invertedmask2)

    CGContextTranslateCTM(context, width, 0)
    # Set the fill color to a dark blue.
    CGContextSetFillColor(context, darkBlue)
    # Mask 6.
    CGContextDrawImage(context, imageRect, invertedmask1)
    CGContextTranslateCTM(context, width, 0)
    # Set the fill color to purple.
    CGContextSetFillColor(context, purple)
    # Mask 7.
    CGContextDrawImage(context, imageRect, invertedmask2)
    CGContextTranslateCTM(context, width, 0)

    # Make the purple 50% transparent.
    purple[3] = 0.5
    CGContextSetFillColor(context, purple)
    # Mask 8.
    CGContextDrawImage(context, imageRect, invertedmask1)

def doMaskImageWithMaskFromURL(context, imageURL,
        imagewidth, imageheight, bitsPerComponent,
        theMaskingImageURL, maskwidth, maskheight):

    imageBitsPerPixel = bitsPerComponent * 3
    bytesPerRow = ((imagewidth * imageBitsPerPixel) + 7)/8
    shouldInterpolate = True
    imageDataProvider = CGDataProviderCreateWithURL(imageURL)
    if imageDataProvider is None:
        print >>sys.stderr,  "Couldn't create Image Data provider!"
        return

    colorspace = Utilities.getTheCalibratedRGBColorSpace()
    image = CGImageCreate(imagewidth, imageheight, bitsPerComponent,
                            imageBitsPerPixel, bytesPerRow, colorspace,
                            kCGImageAlphaNone, imageDataProvider,
                            None, shouldInterpolate,
                            kCGRenderingIntentDefault)
    del imageDataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(0.0,imageheight, imagewidth, imageheight)
    # Draw the image.
    CGContextDrawImage(context, imageRect, image)

    # Now the mask.
    maskDataProvider = CGDataProviderCreateWithURL(theMaskingImageURL)
    if maskDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    mask = CGImageMaskCreate(maskwidth, maskheight, bitsPerComponent,
                            bitsPerComponent, maskwidth,
                            maskDataProvider, None, shouldInterpolate)
    del maskDataProvider
    if mask is None:
        print >>sys.stderr, "Couldn't create CGImageRef for mask data!"
        return

    # Draw the mask below the image. The current fill color (black)
    # is painted through the mask.
    maskRect = CGRectMake(0.0, 0.0, maskwidth, maskheight)
    CGContextDrawImage(context, maskRect, mask)

    # Create a new CGImage object, the image, masked with mask.
    imageMaskedWithImage = CGImageCreateWithMask(image, mask)
    # Once the new image is created, the code can release the image
    # and the mask which make it up. Quartz retains what it needs
    # for the new masked image 'imageMaskedWithImage'.
    del image
    del mask
    if imageMaskedWithImage is None:
        print >>sys.stderr, "Couldn't create image masked with mask!"
        return

    imageRect = CGRectMake(imagewidth + 10, imageheight/2, imagewidth, imageheight)
    # Draw the masked image to the right of the image and its mask.
    CGContextDrawImage(context, imageRect, imageMaskedWithImage)

def doMaskImageWithGrayImageFromURL(context, imageURL, imagewidth, imageheight, bitsPerComponent,
        theMaskingImageURL, maskwidth, maskheight):

    imageBitsPerPixel = bitsPerComponent * 3
    bytesPerRow = ( (imagewidth * imageBitsPerPixel) + 7)/8
    shouldInterpolate = True

    imageDataProvider = CGDataProviderCreateWithURL(imageURL)
    if imageDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    colorspace = Utilities.getTheCalibratedRGBColorSpace()
    image = CGImageCreate(imagewidth, imageheight, bitsPerComponent,
                            imageBitsPerPixel, bytesPerRow, colorspace,
                            kCGImageAlphaNone, imageDataProvider,
                            None, shouldInterpolate,
                            kCGRenderingIntentDefault)
    del imageDataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(0.,imageheight, imagewidth, imageheight)
    # Draw the image.
    CGContextDrawImage(context, imageRect, image)

    # Now the mask.
    maskDataProvider = CGDataProviderCreateWithURL(theMaskingImageURL)
    if maskDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    # The color space for the image MUST be DeviceGray for it to
    # be used as a masking image with CGImageCreateWithMask.
    deviceGraySpace = CGColorSpaceCreateDeviceGray();
    mask = CGImageCreate(maskwidth, maskheight, bitsPerComponent,
                            bitsPerComponent, maskwidth,
                            deviceGraySpace,
                            kCGImageAlphaNone, maskDataProvider,
                            None, shouldInterpolate,
                            kCGRenderingIntentDefault)
    # Release the color space since it is no longer needed.
    del deviceGraySpace
    del maskDataProvider

    if mask is None:
        print >>sys.stderr, "Couldn't create CGImageRef for gray image data!"
        return

    # Draw the mask below the image. The current fill color (black)
    # is painted through the mask.
    maskRect = CGRectMake(0., 0., maskwidth, maskheight)
    CGContextDrawImage(context, maskRect, mask)

    # Create a new CGImage object, the image, masked with mask.
    imageMaskedWithImage = CGImageCreateWithMask(image, mask)

    # Once the new image is created, the code can release the image
    # and the mask which make it up. Quartz retains what it needs
    # for the new masked image 'imageMaskedWithImage'.
    del image
    del mask

    if imageMaskedWithImage is None:
        print >>sys.stderr, "Couldn't create image masked with mask!"
        return

    imageRect = CGRectMake(imagewidth + 10, imageheight/2,
                                                    imagewidth, imageheight)
    # Draw the masked image to the right of the image and its mask.
    CGContextDrawImage(context, imageRect, imageMaskedWithImage)
    # Be sure and release the masked image.
    del imageMaskedWithImage

def doMaskImageWithColorFromURL(context, url,
        width, height, isColor):

    # This routine treats color images as RGB.
    bitsPerComponent = 8
    if isColor:
        bitsPerPixel = bitsPerComponent * 3
    else:
        bitsPerPixel = bitsPerComponent

    bytesPerRow = ( (width * bitsPerPixel) + 7)/8
    shouldInterpolate = True

    # This is a range of dark gray to black colors for an 8 bit per component
    # image in a gray or RGB color space. The entries are image sample
    # values of 0-0x1F for the first color component, 0-0x1F for the
    # second color component, and so on. For image sample values where
    # all components fall within the ranges in maskingColors, the sample
    # value is masked and therefore unpainted.
    maskingColors = (0x00, 0x1F, 0x00, 0x1F, 0x00, 0x1F)
    backColor = (1., 0., 0., 1.) # Opaque red.

    # Create a Quartz data provider from the supplied URL.
    dataProvider = CGDataProviderCreateWithURL(url)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Image data provider!"
        return

    # Create an image of the specified width, height and bits per pixel
    # from the URL.
    if isColor:
        colorspace = Utilities.getTheCalibratedRGBColorSpace()
    else:
        colorspace = Utilities.getTheCalibratedGrayColorSpace()

    image = CGImageCreate(width, height, bitsPerComponent, bitsPerPixel,
                                    bytesPerRow, colorspace, kCGImageAlphaNone,
                                    dataProvider, None, shouldInterpolate,
                                    kCGRenderingIntentDefault)
    del dataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(10., 10., width, height)
    #CGContextScaleCTM(context, 0.33, 0.33)
    # Set the color space and the color, then
    # paint a red rectangle behind the image.
    CGContextSetFillColorSpace(context, colorspace)
    CGContextSetFillColor(context, backColor)
    CGContextFillRect(context, imageRect)
    # Draw the image into the rectangle.
    CGContextDrawImage(context, imageRect, image)
    # Create a new image from the original one, masking out a range
    # of the blackest sample values.
    imageMaskedWithColor = CGImageCreateWithMaskingColors(image, maskingColors)
    # Release the original image; it is no longer needed.
    del image
    if imageMaskedWithColor is None:
        print >>sys.stderr, "Couldn't create CGImageRef for masking color!"
        return

    # Paint the rectangle behind the next image with red.
    imageRect = CGRectMake(30. + width, 10., width, height)
    CGContextFillRect(context, imageRect)
    # Draw the image. Image sample values in the range of
    # the masking color are unpainted, allowing the background
    # to show through.
    CGContextDrawImage(context, imageRect, imageMaskedWithColor)


if 1:   # Set to 1 for code in the book.

    def drawWithClippingMask(context, theMaskingImageURL, imagewidth, imageheight):
        # An array of CGColor objects.
        colors = ( Utilities.getRGBOpaqueDarkGreenColor(), Utilities.getRGBOpaqueDarkBlueColor(),
                Utilities.getRGBOpaqueBlueColor(), Utilities.getRGBOpaqueRedColor() )

        imageBitsPerComponent = 8
        bytesPerRow = imagewidth
        shouldInterpolate = True
        decode = (1, 0)

        # Create the data.
        dataProvider =  CGDataProviderCreateWithURL(theMaskingImageURL)
        if dataProvider is None:
            print >>sys.stderr, "Couldn't create Image data provider!"
            return

        cs = CGColorSpaceCreateDeviceGray()
        image = CGImageCreate(imagewidth, imageheight,
                        imageBitsPerComponent, imageBitsPerComponent,
                        bytesPerRow, cs, kCGImageAlphaNone, dataProvider, decode,
                        shouldInterpolate, kCGRenderingIntentDefault)
        del cs
        del dataProvider

        if image is None:
            print >>sys.stderr, "Couldn't create Image!"
            return

        imageRect = CGRectMake(0, 0, imagewidth*2/3, imageheight*2/3)

        # Position for drawing the image at the left side of the figure.
        CGContextTranslateCTM(context, 50, 50 )

        # Draw the image.
        CGContextDrawImage(context, imageRect, image)

        # Position to the right of the image just painted.
        CGContextTranslateCTM(context, CGRectGetWidth(imageRect) + 25,  0)

        # Clip to the image.
        CGContextClipToMask(context, imageRect, image)
        # Release the image since this code no longer needs it.
        del image

        # Make a rect that has a width and height 1/3 that of the image.
        rect = CGRectMake(0, 0, CGRectGetWidth(imageRect)/3, CGRectGetHeight(imageRect)/3)

        CGContextTranslateCTM(context, 0, 2*CGRectGetHeight(rect))

        # Draw a 3 x 3 grid of rectangles, setting the color for each rectangle
        # by cycling through the array of CGColor objects in the 'colors' array.
        for j in range(3):
            CGContextSaveGState(context)
            for i in range(3):
                # Draw a row of rectangles.
                # Set the fill color using one of the CGColor objects in the
                # colors array.
                CGContextSetFillColorWithColor(context, colors[(i+j) % 4])
                CGContextFillRect(context, rect)
                CGContextTranslateCTM(context, CGRectGetWidth(rect), 0)

            CGContextRestoreGState(context)
            # Position to draw the next row.
            CGContextTranslateCTM(context, 0, -CGRectGetHeight(rect))

else:
    # This code works just fine to screen but when drawing to a PDF
    # or printing context the masked drawing is completely masked out
    # due to a bug in Quartz prior to Tiger 10.4.3.
    def drawWithClippingMask(context, theMaskingImageURL, maskwidth, maskheight):
        # An array of CGColor objects.
        colors = (
                Utilities.getRGBOpaqueDarkGreenColor(),
                Utilities.getRGBOpaqueDarkBlueColor(),
                Utilities.getRGBOpaqueBlueColor(),
                Utilities.getRGBOpaqueRedColor())
        maskBitsPerComponent = 8
        bytesPerRow = ( (maskwidth * maskBitsPerComponent) + 7)/8
        shouldInterpolate = True
        maskDataProvider = CGDataProviderCreateWithURL(theMaskingImageURL)

        if maskDataProvider is None:
            print >>sys.stderr, "Couldn't create Image Mask provider!"
            return
        mask = CGImageMaskCreate(maskwidth, maskheight, maskBitsPerComponent,
                                        maskBitsPerComponent, maskwidth,
                                        maskDataProvider, None, shouldInterpolate)
        del maskDataProvider

        if mask is None:
            print >>sys.stderr, "Couldn't create Image Mask!"
            return

        maskRect = CGRectMake(0, 0, maskwidth/3, maskheight/3)

        # Position for drawing the mask at the left side of the figure.
        CGContextTranslateCTM(context, 50, 50 )
        # Set the context fill color to a CGColor object that is black.
        CGContextSetFillColorWithColor(context, getRGBOpaqueBlackColor())
        # Draw the mask. It is painted with with the black fill color.
        CGContextDrawImage(context, maskRect, mask)

        # Position to the right of the mask just painted.
        CGContextTranslateCTM(context, CGRectGetWidth(maskRect) + 25,  0)

        # Clip to the mask.
        CGContextClipToMask(context, maskRect, mask)
        # Release the mask since this code no longer needs it.
        del mask

        # Make a rect that has a width and height 1/3 that of the image mask.
        rect = CGRectMake(0, 0, CGRectGetWidth(maskRect)/3, CGRectGetHeight(maskRect)/3)

        CGContextTranslateCTM(context, 0, 2*CGRectGetHeight(rect))

        # Draw a 3 x 3 grid of rectangles, setting the color for each rectangle
        # by cycling through the array of CGColor objects in the 'colors' array.
        for j in range(3):
            CGContextSaveGState(context)
            for i in range(3):
                # Draw a row of rectangles.
                # Set the fill color using one of the CGColor objects in the
                # colors array.
                CGContextSetFillColorWithColor(context, colors[(i+j) % 4])
                CGContextFillRect(context, rect)
                CGContextTranslateCTM(context, CGRectGetWidth(rect), 0)
            CGContextRestoreGState(context)
            # Position to draw the next row.
            CGContextTranslateCTM(context, 0, -CGRectGetHeight(rect))

Images.py

import sys

import DataProvidersAndConsumers
import Utilities

from Quartz import *
import Quartz

from LaunchServices import * # kUTType* constants


def drawJPEGImage(context, url):
    # Create a Quartz data provider for the supplied URL.
    jpgProvider = CGDataProviderCreateWithURL(url)
    if jpgProvider is None:
        print >>sys.stderr, "Couldn't create JPEG Data provider!"
        return

    # Create the CGImageRef for the JPEG image from the data provider.
    jpgImage = CGImageCreateWithJPEGDataProvider(jpgProvider, None,
                            True, kCGRenderingIntentDefault)

    # CGImageCreateWithJPEGDataProvider retains the data provider.
    # Since this code created the data provider and this code no
    # longer needs it, it must release it.
    del jpgProvider

    if jpgImage is None:
        print >>sys.stderr, "Couldn't create CGImageRef for JPEG data!"
        return

    # Make a rectangle that has its origin at (0,0) and
    # has a width and height that is 1/4 the native width
    # and height of the image.
    jpgRect = CGRectMake(0.0, 0.0,
            CGImageGetWidth(jpgImage)/4, CGImageGetHeight(jpgImage)/4)


    # Draw the image into the rectangle.
    # This is Image 1.
    CGContextDrawImage(context, jpgRect, jpgImage)

    CGContextSaveGState(context)

    # Translate to the top-right corner of the image just drawn.
    CGContextTranslateCTM(context, jpgRect.size.width,
                                        jpgRect.size.height)
    # Rotate by -90 degrees.
    CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(-90))
    # Translate in -x by the width of the drawing.
    CGContextTranslateCTM(context, -jpgRect.size.width, 0)

    # Draw the image into the same rectangle as before.
    # This is Image 2.
    CGContextDrawImage(context, jpgRect, jpgImage)
    CGContextRestoreGState(context)

    CGContextSaveGState(context)

    # Translate so that the next drawing of the image appears
    # below and to the right of the image just drawn.
    CGContextTranslateCTM(context,
        jpgRect.size.width+jpgRect.size.height, jpgRect.size.height)
    # Scale the y axis by a negative value and flip the image.
    CGContextScaleCTM(context, 0.75, -1.0)
    # This is Image 3.
    CGContextDrawImage(context, jpgRect, jpgImage)
    CGContextRestoreGState(context)

    # Adjust the position of the rectangle so that its origin is
    # to the right and above where Image 3 was drawn. Adjust the
    # size of the rectangle so that it is 1/4 the image width
    # and 1/6 the image height.
    jpgRect = CGRectMake( 1.75*jpgRect.size.width + jpgRect.size.height,
                            jpgRect.size.height,
                            CGImageGetWidth(jpgImage)/4,
                            CGImageGetHeight(jpgImage)/6)
    # This is Image 4.
    CGContextDrawImage(context, jpgRect, jpgImage)

def drawImageFromURL(context, url, width, height, bitsPerComponent, isRGB):
    # This routine treats color images as RGB
    if isRGB:
        bitsPerPixel = bitsPerComponent * 3
    else:
        bitsPerPixel = bitsPerComponent

    bytesPerRow = (width * bitsPerPixel + 7)/8
    shouldInterpolate = True

    # Create a Quartz data provider from the supplied URL.
    dataProvider = CGDataProviderCreateWithURL(url)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Image data provider!"
        return

    # Get a Quartz color space object appropriate for the image type.
    if isRGB:
        colorspace = Utilities.getTheCalibratedRGBColorSpace()
    else:
        colorspace = Utilities.getTheCalibratedGrayColorSpace()

    # Create an image of the width, height, and bitsPerComponent with
    # no alpha data, the default decode array, with interpolation,
    # and the default rendering intent for images. This code is
    # intended for Gray images of the format GGGGG... or RGB images
    # of the format RGBRGBRGB... .
    image = CGImageCreate(width, height, bitsPerComponent,
                            bitsPerPixel, bytesPerRow, colorspace,
                            kCGImageAlphaNone, dataProvider, None,
                            shouldInterpolate, kCGRenderingIntentDefault)
    # Quartz retains the data provider with the image and since this
    # code does not create any more images with the data provider, it
    # can release it.
    del dataProvider
    if image is None:
        print >>sys.stderr,  "Couldn't create CGImageRef for this data!"
        return

    # Create a rectangle into which the code will draw the image.
    imageRect = CGRectMake(0.0, 0.0, width, height)

    # Draw the image into the rectangle.
    CGContextDrawImage(context, imageRect, image)

def doColorRampImage(context):
    width = 256
    height = 256
    bitsPerComponent = 8
    bitsPerPixel = 24
    bytesPerRow = width * 3
    shouldInterpolate = True

    imageDataProvider = DataProvidersAndConsumers.createRGBRampDataProvider()
    if imageDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    colorspace = Utilities.getTheCalibratedRGBColorSpace()
    image = CGImageCreate(width, height, bitsPerComponent,
                bitsPerPixel, bytesPerRow, colorspace, kCGImageAlphaNone,
                imageDataProvider, None, shouldInterpolate,
                kCGRenderingIntentDefault)
    # No longer need the data provider.
    del imageDataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(0.0, 0.0, width, height)
    # Draw the image.
    CGContextDrawImage(context, imageRect, image)

def doImageWithCallbacksCreatedFromURL(context, url, width, height,
        bitsPerComponent, isRGB):

    if isRGB:
        bitsPerPixel = bitsPerComponent * 3
    else:
        bitsPerPixel = bitsPerComponent

    bytesPerRow = ((width * bitsPerPixel) + 7)/8
    shouldInterpolate = True

    dataProvider = DataProvidersAndConsumers.createSequentialAccessDPForURL(url)
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    # Create a Quartz color space object appropriate for the image type.
    # These user written functions create the color space object
    # and that reference must be released by this code.
    if isRGB:
        colorspace = Utilities.getTheCalibratedRGBColorSpace()
    else:
        colorspace = Utilities.getTheCalibratedGrayColorSpace()

    image = CGImageCreate(width, height, bitsPerComponent,
                    bitsPerPixel, bytesPerRow, colorspace,
                    kCGImageAlphaNone, dataProvider, None, shouldInterpolate,
                    kCGRenderingIntentDefault)
    del dataProvider
    if image is None:
        print >>sys.stder, "Couldn't create CGImageRef for this data!"
        return

    imageRect = CGRectMake(0.0, 0.0, width, height)

    # Draw the image into the rectangle.
    CGContextDrawImage(context, imageRect, image)

def doGrayRamp(context):
    width = 256
    height = 1
    bitsPerComponent = 8
    bitsPerPixel = 8
    bytesPerRow = width
    shouldInterpolate = True

    dataProvider = DataProvidersAndConsumers.createGrayRampDirectAccessDP()
    if dataProvider is None:
        print >>sys.stderr, "Couldn't create Gray Ramp provider!"
        return

    colorspace = Utilities.getTheCalibratedGrayColorSpace()
    image = CGImageCreate(width, height, bitsPerComponent, bitsPerPixel,
                bytesPerRow, colorspace, kCGImageAlphaNone, dataProvider,
                None, shouldInterpolate, kCGRenderingIntentDefault)
    del dataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for image data!"
        return

    imageRect = CGRectMake(0.0, 0.0, 256, 256)
    # Drawing the image that is 256 samples wide and
    # 1 scanline high into a rectangle that is 256 x 256 units
    # on a side causes Quartz to stretch the image to fill
    # the destination rectangle.
    CGContextDrawImage(context, imageRect, image)

# This routine examines the CGImageSource at index 0 to
# determine if the first image is a floating point image and
# if it is, it returns an options dictionary suitable for
# passing to CGImageSourceCreateImageAtIndex in order to create
# a CGImageRef that contains full dynamic range floating point data.
def createFloatingPointImageOptions(imageSource):
    # Allow the image to be a floating point image.
    # Without this, Quartz would return integer pixel data, even for
    # floating point images. Typically you don't need floating point data
    # but in some special cases you might want it.
    options = {
        kCGImageSourceShouldAllowFloat: True
    }
    isFloat = False

    # Obtain the properties for the first image
    # in the image source. This is a 'Copy' function
    # so the code owns a reference to the
    # dictionary returned.
    properties = CGImageSourceCopyPropertiesAtIndex(imageSource,
                                                        0, options)
    if properties is not None:
    # Get the value for the kCGImagePropertyIsFloat if it exists
    # and if the value is a CFBoolean then get the corresponding
    # Boolean result.
        if kCGImagePropertyIsFloat in properties:
            isFloat = bool(properties[kCGImagePropertyIsFloat])

    if not isFloat:
        return None

    return options

def myCreateImageUsingImageSource(url):
    # Set to zero, indicating the property was unavailable.
    xdpi = ydpi = 0

    # Create the image source from the URL.
    imageSource = CGImageSourceCreateWithURL(url, None)
    if imageSource is None:
        print >>sys.stderr,  "Couldn't create image source from URL!"
        return (None, xdpi, ydpi)

    if False:
        options = createFloatingPointImageOptions(imageSource)
        if options is not None:
            print >>sys.stderr, "image IS a floating point image"
        else:
            print >>sys.stderr, "image IS NOT a floating point image"
    else:
        options = None

    # Obtain the properties dictionary for the first image
    # in the image source. This is a copy function so this
    # code owns the reference returned and must
    # must release it.
    properties = CGImageSourceCopyPropertiesAtIndex(
                    imageSource, 0, options)
    if properties is not None:
        # Check for the x and y resolution of the image.
        xdpi = properties[kCGImagePropertyDPIWidth]
        ydpi = properties[kCGImagePropertyDPIHeight]

    # Create a CGImageRef from the first image in the CGImageSource.
    image = CGImageSourceCreateImageAtIndex(imageSource, 0, options)
    # Release the CGImageSource object since it is no longer needed
    # and this code created it. This code uses CFRelease since a
    # CGImageSource object is a CoreFoundation object.
    del imageSource
    del options

    if image is None:
        print >>sys.stderr, "Couldn't create image from image source!"
        return None

    return (image, xdpi, ydpi)

def myCreateThumbnailFromImageSource(url):
    maxThumbSize = 160

    # Create the image source from the URL.
    imageSource = CGImageSourceCreateWithURL(url, None)
    if imageSource is None:
        print >>sys.stderr, "Couldn't create image source from URL!"
        return None

    options = {
        # Specify 160 pixels as the maximum width and height of
        # the thumbnail for Quartz to create.
        kCGImageSourceThumbnailMaxPixelSize: maxThumbSize,

        # Request that Quartz create a thumbnail image if
        # thumbnail data isn't present in the file.
        kCGImageSourceCreateThumbnailFromImageIfAbsent: True,
    }

    # Create the thumbnail image for the first image in the
    # image source, that at index 0, using the options
    # dictionary that the code just created.
    thumb = CGImageSourceCreateThumbnailAtIndex(imageSource, 0, options)

    # Release the options dictionary.
    del options
    # Release the image source the code created.
    del imageSource

    if thumb is None:
        print >>sys.stderr, "Couldn't create thumbnail from image source!"
        return None

    return thumb

def imageHasFloatingPointSamples(image):
    if hasattr(Quartz, CGImageGetBitmapInfo):
        return (kCGBitmapFloatComponents & CGImageGetBitmapInfo(image)) != 0
    return False


def drawImageWithCGImageDataSource(context, url):
    # This code would be better if it created the image source
    # once and used the same image source to create the image and its
    # thumbnail, but the point here is to simply test the routines
    # myCreateImageUsingImageSource and myCreateThumbnailFromImageSource.

    image, xdpi, ydpi = myCreateImageUsingImageSource(url)
    if image is None:
        print >>sys.stderr,  "myCreateImageFromImageSource didn't create a CGImage!"
        return

    print "xdpi = %2.f, ydpi = %2.f"%(xdpi, ydpi)
    imageRect = CGRectMake(0.0, 0.0,
            CGImageGetWidth(image)/3, CGImageGetHeight(image)/3)
    CGContextDrawImage(context, imageRect, image)

    if 0:
        isFloatingImage = imageHasFloatingPointSamples(image)
        if isFloatingImage:
            print "First image IS a floating point image"
        else:
            print "First image IS NOT a floating point image"

    del image

    image = myCreateThumbnailFromImageSource(url)
    if image is None:
        print >>sys.stderr, "myCreateThumbnailFromImageSource didn't create a CGImage!"
        return

    imageRect = CGRectMake(400.0, 0.0,
            CGImageGetWidth(image), CGImageGetHeight(image))
    CGContextDrawImage(context, imageRect, image)

    del image


class MyIncrementalData (object):
    data = None
    dataSize = 0
    repCount = 0
    chunkSize = 0

# This is a dummy data accumulation routine used to demonstrate incremental
# loading of an image.
def myCreateAccumulatedDataSoFar(myDataP):
    myDataP.repCount += 1
    sizeToReturn = myDataP.chunkSize*myDataP.repCount

    if sizeToReturn > myDataP.dataSize:
        sizeToReturn = myDataP.dataSize

    done = (sizeToReturn == myDataP.dataSize)
    data = CFDataCreate(None, myDataP.data, sizeToReturn)
    return data, done


def MyDrawIncrementalImage(context, image,  fullHeight):
    # Obtain the width and height of the image that has been
    # accumulated so far.
    width = CGImageGetWidth(image)
    height = CGImageGetHeight(image)
    # Adjust the location of the imageRect so that the origin is
    # such that the full image would be located at 0,0 and the partial
    # image top-left corner does not move as the image is filled in.
    # This is only needed for views where the y axis points up the
    # drawing canvas.
    imageRect = CGRectMake(0, fullHeight-height, width, height)
    CGContextDrawImage(context, imageRect, image)


def myDrawFirstImageIncrementally(context, myDataP):
    height = -1
    # Create an incremental image source.
    imageSource = CGImageSourceCreateIncremental(None)
    if imageSource is None:
        print >>sys.stderr, "Couldn't create incremental imagesource!"
        return


    # Loop, gathering the necessary data to find the True
    # height of the image.
    while 1:
        # Fetch the data. The CFData object returned by
        # myCreateAccumulatedDataSoFar is used to update the
        # image source. When the data is complete, the code
        # passes True in the 'done' parameter passed to
        # CGImageSourceUpdateData. Once the data is passed
        # to CGImageSourceUpdateData, the code can release
        # its reference to the data.

        # Accumulate the data.
        data, done = myCreateAccumulatedDataSoFar(myDataP)
        CGImageSourceUpdateData(imageSource, data, done)

        # Release the data since Quartz retains it and this code
        # no longer needs it.
        del data

        if height < 0:
            # Determine the height of the full image. This is needed in order
            # to adjust the location of the drawing of the partial image in
            # a context where the y axis has the default Quartz orientation
            # pointing up the drawing canvas.
            properties = CGImageSourceCopyPropertiesAtIndex(
                                            imageSource, 0, None)
            if properties is not None:
                if kCGImagePropertyPixelHeight in properties:
                    height = properties[kCGImagePropertyPixelHeight]
            del properties

        # Once the height is obtained, go ahead and see if Quartz
        # has enough data to create a CGImage object.
        if height > 0:
            # Now create the CGImageRef from the image source for the
            # first image.
            image = CGImageSourceCreateImageAtIndex(
                                                imageSource, 0, None)
            if image is not None:
                # Draw the image using the height of the full image
                # to adjust the location where the image is drawn.
                MyDrawIncrementalImage(context, image, height)
                # Release the partial image once you've drawn it.
                del image
                # Potentially you would want to flush the context so
                # that drawing to a window would appear, even inside
                # this loop. Of course this flush should really be
                # done on a timer so that the flush only occurs at
                # most every 60th of a second. See Chapter 17 regarding
                # timing your usage of CGContextFlush.
                CGContextFlush(context)

        # Obtain the status for the image source for the first image.
        status = CGImageSourceGetStatusAtIndex(imageSource, 0)

        if done or status  == kCGImageStatusComplete:
            break

def createMyIncrementalDataFromURL(url, myDataP):
    myDataP.data = None
    myDataP.dataSize = 0
    myDataP.repCount = 0

    success, pathString = CFURLGetFileSystemRepresentation(url, True, None, 1024)
    pathString = pathString.rstrip('\0')


    if success and len(pathString):
        fp = open(pathString, 'rb')
        myDataP.data = fp.read()
        fp.close()
        myDataP.dataSize = len(myDataP.data)

    if myDataP.dataSize > 0:
        myDataP.chunkSize = myDataP.dataSize/10  # 10 chunks

def doIncrementalImageWithURL(context, url):
    myData = MyIncrementalData()
    createMyIncrementalDataFromURL(url, myData)
    if myData.data is None:
        print >>sys.stderr,  "couldn't read data from URL!"

    myDrawFirstImageIncrementally(context, myData)
    del myData

# This code requires QuickTime.framework.
# from Carbon import Qt
def createCGImageWithQuickTimeFromURL(url):
    """
    Note: this function doesn't actually worked because the APIs used in here
    aren't properly wrapped (yet).
    """
    return None




    imageRef = None

    err = noErr
    result, dataRef, dataRefType = QTNewDataReferenceFromCFURL(url, 0, None, None)
    if dataRef is not None:
        err, gi = GetGraphicsImporterForDataRefWithFlags(dataRef,
                                            dataRefType, None, 0)
        if not err and gi:
            # Tell the graphics importer that it shouldn't perform
            # gamma correction and it should create an image in
            # the original source color space rather than matching it to
            # a generic calibrated color space.
            result = GraphicsImportSetFlags(gi,
                            (kGraphicsImporterDontDoGammaCorrection +
                            kGraphicsImporterDontUseColorMatching)
            )
            if result == 0:
                result, imageRef = GraphicsImportCreateCGImage(gi,None,0)
                if result != 0:
                    print >>sys.stderr, "got a bad result = %d!"%(result,)
            DisposeHandle(dataRef)
            CloseComponent(gi)

    return imageRef

def drawQTImageWithQuartz(context, url):
    image = createCGImageWithQuickTimeFromURL(url)
    if image is None:
        print >>sys.stderr, "createCGImageWithQuickTimeFromURL didn't create a CGImage!"
        return

    imageRect = CGRectMake(0.0, 0.0,
            CGImageGetWidth(image), CGImageGetHeight(image))
    CGContextDrawImage(context, imageRect, image)

def drawJPEGDocumentWithMultipleProfiles(context, url):
    isDeviceRGBImage = False

    # Create a Quartz data provider for the supplied URL.
    jpgProvider = CGDataProviderCreateWithURL(url)
    if jpgProvider is None:
        print >>sys.stderr, "Couldn't create JPEG Data provider!"
        return

    # Create the CGImageRef for the JPEG image from the data provider.
    jpgImage = CGImageCreateWithJPEGDataProvider(
            jpgProvider, None, True, kCGRenderingIntentDefault)
    del jpgProvider
    if jpgImage is None:
        print >>sys.stderr, "Couldn't create CGImageRef for JPEG data!"
        return

    # Get the color space characterizing the image. This is a
    # function with 'Get' semantics so the code doesn't own a reference
    # to the color space returned and must not release it.
    originalColorSpace = CGImageGetColorSpace(jpgImage)
    if originalColorSpace is None:
        print >>sys.stderr, "image is a masking image, not an image with color!"
        return

    if CGColorSpaceGetNumberOfComponents(originalColorSpace) != 3:
        print >>sys.stderr, "This example only works with 3 component JPEG images"
        return

    # Determine if the original color space is DeviceRGB. If that is
    # not the case then bail.
    comparisonColorSpace = CGColorSpaceCreateDeviceRGB()

    # Note that this comparison of color spaces works only on
    # Jaguar and later where a CGColorSpaceRef is a
    # CoreFoundation object. Otherwise this will crash!
    isDeviceRGBImage = (comparisonColorSpace == originalColorSpace)

    # This code created 'comparisonColorSpace' so it must release it.
    del comparisonColorSpace

    if not isDeviceRGBImage:
        print >>sys.stderr, "The color space for the JPEG image is not DeviceRGB!"
        return

    # Might need to adjust this based on the size of the original image.
    CGContextScaleCTM(context, 0.5, 0.5)

    imageRect = CGRectMake(0.0, CGImageGetHeight(jpgImage)/2,
                    CGImageGetWidth(jpgImage), CGImageGetHeight(jpgImage))

    # Draw the original image to the left of the other two.
    CGContextDrawImage(context, imageRect, jpgImage)

    # Recharacterize the original image with the generic Calibrated RGB
    # color space.
    updatedImage1 = CGImageCreateCopyWithColorSpace(jpgImage,
                                    Utilities.getTheCalibratedRGBColorSpace())
    # Release the original image since this code is done with it.
    del jpgImage
    if updatedImage1 is None:
        print >>sys.stderr, "There is no updated image to draw!"
        return

    # Draw the image characterized by the Generic profile
    # to the right of the other image.
    imageRect = CGRectOffset(imageRect, CGRectGetWidth(imageRect) + 10, 0)
    CGContextDrawImage(context, imageRect, updatedImage1)

    # Recharacterize the image but now with a color space
    # created with the sRGB profile.
    updatedImage2 = CGImageCreateCopyWithColorSpace(updatedImage1,
                                            Utilities.getTheSRGBColorSpace())
    # Release updatedImage1 since this code is done with it.
    del updatedImage1
    if updatedImage2 is None:
        print >>sys.stderr, "There is no second updated image to draw!"
        return

    # Draw the image characterized by the sRGB profile to the right of
    # the image characterized by the generic RGB profile.
    imageRect = CGRectOffset(imageRect, CGRectGetWidth(imageRect) + 10, 0)
    CGContextDrawImage(context, imageRect, updatedImage2)

def createRedGreenRampImageData(width, height, size):
    try:
        dataP = objc.allocateBuffer(size)
    except MemoryError:
        return None

    idx = 0
    # Build an image that is RGB 24 bits per sample. This is a ramp
    # where the red component value increases in red from left to
    # right and the green component increases from top to bottom.
    for g in xrange(height):
        for r in xrange(width):
            dataP[idx+0] = r
            dataP[idx+1] = g
            dataP[idx+2] = 0
            idx+=3

    return dataP

def createRGBRampSubDataProvider(subRect):
    bytesPerSample = 3
    width = 256
    height = 256
    bytesPerRow = width*bytesPerSample
    startOffsetX = subRect.origin.x
    startOffsetY = subRect.origin.y
    imageDataSize = bytesPerRow*height

    # The first image sample is at
    # (startOffsetY*bytesPerRow + startOffsetX*bytesPerSample)
    # bytes into the RGB ramp data.
    firstByteOffset = startOffsetY*bytesPerRow + startOffsetX*bytesPerSample

    # The actual size of the image data provided is the full image size
    # minus the amount skipped at the beginning. This is more than the
    # total amount of data that is needed for the subimage but it is
    # valid and easy to calculate.
    totalBytesProvided = imageDataSize - firstByteOffset

    # Create the full color ramp.
    dataP = createRedGreenRampImageData(width, height, imageDataSize)
    if dataP is None:
        print >>sys.stderr, "Couldn't create image data!"
        return None

    # Use the pointer to the first byte as the info parameter since
    # that is the pointer to the block to free when done.
    dataProvider = CGDataProviderCreateWithData(dataP,
                        buffer(dataP, firstByteOffset),
                        totalBytesProvided, None)

    if dataProvider is None:
        return None

    return dataProvider

def doColorRampSubImage(context):
    # Start 4 scanlines from the top and 16 pixels from the left edge,
    # skip the last 40 scanlines of the image and the right
    # most 64 pixels.
    insetLeft = 16
    insetTop = 4
    insetRight = 64
    insetBottom = 40

    fullImageWidth = 256
    fullImageHeight = 256
    subImageWidth = fullImageWidth-insetLeft-insetRight
    subImageHeight = fullImageHeight-insetTop-insetBottom
    bitsPerComponent = 8
    bitsPerPixel = 24
    bytesPerRow = fullImageWidth * 3
    shouldInterpolate = True

    imageSubRect = CGRectMake(
            insetLeft, insetTop, subImageWidth, subImageHeight)
    colorspace = Utilities.getTheCalibratedRGBColorSpace()

    if hasattr(Quartz, 'CGImageCreateWithImageInRect'):
        imageDataProvider = DataProvidersAndConsumers.createRGBRampDataProvider()
        if imageDataProvider is None:
            print >>sys.stderr, "Couldn't create Image Data provider!"
            return

        fullImage = CGImageCreate(fullImageWidth, fullImageHeight,
                        bitsPerComponent, bitsPerPixel,
                        bytesPerRow, colorspace, kCGImageAlphaNone,
                        imageDataProvider, None, shouldInterpolate,
                        kCGRenderingIntentDefault)
        if fullImage is not None:
            image = CGImageCreateWithImageInRect(fullImage, imageSubRect)
            # release the full image since it is no longer required.
            del fullImage

    # If the image hasn't been created yet, this code uses the
    # customized data provider to do so.
    if image is None:
        imageDataProvider = createRGBRampSubDataProvider(imageSubRect)
        if imageDataProvider is None:
            print >>sys.stderr, "Couldn't create Image Data provider!"
            return

        # By supplying bytesPerRow, the extra data at the end of
        # each scanline and the beginning of the next is properly skipped.
        image = CGImageCreate(subImageWidth, subImageHeight,
                            bitsPerComponent, bitsPerPixel,
                            bytesPerRow, colorspace, kCGImageAlphaNone,
                            imageDataProvider, None, shouldInterpolate,
                            kCGRenderingIntentDefault)

    # This code no longer needs the data provider.
    del imageDataProvider

    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    # Draw the subimage.
    rect = CGRectMake(0, 0, subImageWidth, subImageHeight)
    CGContextDrawImage(context, rect, image)

def exportCGImageToPNGFileWithDestination(image, url):
    resolution = 144.

    # Create an image destination at the supplied URL that
    # corresponds to the PNG image format.
    imageDestination = CGImageDestinationCreateWithURL(url, kUTTypePNG, 1, None)

    if imageDestination is None:
        print >>sys.stderr, "couldn't create image destination!"
        return

    # Set the keys to be the x and y resolution of the image.
    options = {
        kCGImagePropertyDPIWidth: resolution,
        kCGImagePropertyDPIHeight: resolution,
    }

    # Add the image with the options dictionary to the destination.
    CGImageDestinationAddImage(imageDestination, image, options)

    # Release the options dictionary this code created.
    del options

    # When all the images are added to the destination, finalize it.
    CGImageDestinationFinalize(imageDestination)

    # Release the destination when done with it.
    del imageDestination


# This code requires QuickTime.framework
#   include <QuickTime/QuickTime.h>
def exportCGImageToJPEGFile(imageRef, url):
    # This doesn't actually work due to lame Python Quicktime bindings...
    return

    result, dataRef, dataRefType = QTNewDataReferenceFromCFURL(
            url, 0, None, None)
    if result == 0:
        result, graphicsExporter = OpenADefaultComponent(GraphicsExporterComponentType,
                            kQTFileTypeJPEG)
        if result == 0:
            result = GraphicsExportSetInputCGImage(graphicsExporter,
                                            imageRef)
            if result == 0:
                result = GraphicsExportSetOutputDataReference(
                            graphicsExporter, dataRef, dataRefType)
            if result == 0:
                result, sizeWritten = GraphicsExportDoExport(
                        graphicsExporter, None)

            CloseComponent(graphicsExporter)

    if dataRef is not None:
        DisposeHandle(dataRef)

    if result != 0:
        print >>sys.stderr, "Exporting QT image got bad result = %d!"%(result,)

def exportColorRampImageWithQT(context):
    width = 256
    height = 256
    bitsPerComponent = 8
    bitsPerPixel = 24
    bytesPerRow = width * 3
    shouldInterpolate = True

    imageDataProvider = DataProvidersAndConsumers.createRGBRampDataProvider()
    if imageDataProvider is None:
        print >>sys.stderr, "Couldn't create Image Data provider!"
        return

    colorspace = Utilities.getTheCalibratedRGBColorSpace()
    image = CGImageCreate(width, height, bitsPerComponent,
                            bitsPerPixel, bytesPerRow, colorspace,
                            kCGImageAlphaNone, imageDataProvider,
                            None, shouldInterpolate, kCGRenderingIntentDefault)
    del imageDataProvider
    if image is None:
        print >>sys.stderr, "Couldn't create CGImageRef for this data!"
        return

    rect = CGRectMake(0.0, 0.0, width, height)
    CGContextDrawImage(context, rect, image)

    # Of course this is a total hack.
    outPath = "/tmp/imageout.jpg"
    exportURL = CFURLCreateFromFileSystemRepresentation(None,
                                outPath, len(outPath), False)
    if exportURL:
        exportCGImageToJPEGFile(image, exportURL)

MyAppController.py

from Cocoa import *
import objc

import PDFHandling
import BitmapContext
import Utilities

# Initial defaults
_dpi = 144
_useQT = False

def getURLToExport(suffix):
    savePanel = NSSavePanel.savePanel()

    initialFileName = "BasicDrawing.%s"%(suffix,)

    if savePanel.runModalForDirectory_file_(None, initialFileName) == NSFileHandlingPanelOKButton:
        return savePanel.URL()

    return None


class MyAppController (NSObject):
    theView = objc.IBOutlet()
    currentDPIMenuItem  = objc.IBOutlet()
    currentExportStyleMenuItem  = objc.IBOutlet()

    @objc.IBAction
    def print_(self, sender):
        self.theView.print_(sender)

    def updateDPIMenu_(self, sender):
        if self.currentDPIMenuItem is not sender:
            # Uncheck the previous item.
            if self.currentDPIMenuItem is not None:
                self.currentDPIMenuItem.setState_(NSOffState)
            # Update to the current item.
            self.currentDPIMenuItem = sender
            # Check new menu item.
            self.currentDPIMenuItem.setState_(NSOnState)

    def updateExportStyleMenu_(self, sender):
        if self.currentExportStyleMenuItem is not sender:
            # Uncheck the previous item.
            if self.currentExportStyleMenuItem is not None:
                self.currentExportStyleMenuItem.setState_(NSOffState)
            # Update to the current item.
            self.currentExportStyleMenuItem = sender
            # Check new menu item.
            self.currentExportStyleMenuItem.setState_(NSOnState)

    @objc.IBAction
    def setExportResolution_(self, sender):
        global _dpi
        _dpi = sender.tag()
        self.updateDPIMenu_(sender)

    @objc.IBAction
    def setUseQT_(self, sender):
        global _useQT
        _useQT = True
        self.updateExportStyleMenu_(sender)

    @objc.IBAction
    def setUseCGImageSource_(self, sender):
        global _useQT
        _useQT = False
        self.updateExportStyleMenu_(sender)

    def setupExportInfo_(self, exportInfoP):
        # Use the printable version of the current command. This produces
        # the best results for exporting.
        exportInfoP.command = self.theView.currentPrintableCommand()
        exportInfoP.fileType = '    '   # unused
        exportInfoP.useQTForExport = _useQT
        exportInfoP.dpi = _dpi

    @objc.IBAction
    def exportAsPDF_(self, sender):
        url = getURLToExport("pdf")
        if url is not None:
            exportInfo = Utilities.ExportInfo()
            self.setupExportInfo_(exportInfo)
            PDFHandling.MakePDFDocument(url, exportInfo)

    @objc.IBAction
    def exportAsPNG_(self, sender):
        url = getURLToExport("png")
        if url is not None:
            exportInfo = Utilities.ExportInfo()
            self.setupExportInfo_(exportInfo)
            BitmapContext.MakePNGDocument(url, exportInfo)

    @objc.IBAction
    def exportAsTIFF_(self, sender):
        url = getURLToExport("tif")
        if url is not None:
            exportInfo = Utilities.ExportInfo()
            self.setupExportInfo_(exportInfo)
            BitmapContext.MakeTIFFDocument(url, exportInfo)


    @objc.IBAction
    def exportAsJPEG_(self, sender):
        url = getURLToExport("jpg")
        if url is not None:
            exportInfo = Utilities.ExportInfo()
            self.setupExportInfo_(exportInfo)
            BitmapContext.MakeJPEGDocument(url, exportInfo)

    def validateMenuItem_(self, menuItem):
        if menuItem.tag == _dpi:
            currentDPIMenuItem = menuItem
            menuItem.setState_(True)
        elif menuItem.action() == 'setUseQT:':
            if _useQT:
                self.currentDPIMenuItem = menuItem
                menuItem.setState_(True)
            else:
                menuItem.setState_(False)

        elif menuItem.action() == 'setUseCGImageSource:':
            if _useQT:
                currentDPIMenuItem = menuItem
                menuItem.setState_(True)
            else:
                menuItem.setState_(False)

        return True

MyView.py

from Cocoa import *

import UIHandling
import AppDrawing
import FrameworkTextDrawing

import objc

# XXX: Why are these global?
_drawingCommand = UIHandling.kHICommandSimpleRect
_pdfDocument = None

class MyView (NSView):
    currentMenuItem = objc.IBOutlet()

    def initWithFrame_(self, frameRect):
        self = super(MyView, self).initWithFrame_(frameRect)
        if self is None:
            return None

        global _pdfDocument
        _pdfDocument = None
        return self


    if False:
        def isFlipped(self):
            return True


    def drawRect_(self, rect):
        context = NSGraphicsContext.currentContext().graphicsPort()

        if _pdfDocument is None:
            if  _drawingCommand in (UIHandling.kHICommandDrawNSString,
                    UIHandling.kHICommandDrawNSLayoutMgr, UIHandling.kHICommandDrawCustomNSLayoutMgr):

                if _drawingCommand == UIHandling.kHICommandDrawNSString:
                    FrameworkTextDrawing.drawNSStringWithAttributes()

                elif _drawingCommand == UIHandling.kHICommandDrawNSLayoutMgr:
                    FrameworkTextDrawing.drawWithNSLayout()

                else:
                    FrameworkTextDrawing.drawWithCustomNSLayout()
            else:
                AppDrawing.DispatchDrawing(context, _drawingCommand)

        else:
            mediaRect = CGPDFDocumentGetMediaBox(_pdfDocument, 1)
            mediaRect.origin.x = mediaRect.origin.y = 0
            CGContextDrawPDFDocument(context, mediaRect, _pdfDocument, 1)

    @objc.IBAction
    def setDrawCommand_(self, sender):
        global _drawingCommand, _pdfDocument

        newCommand = sender.tag()
        if _drawingCommand != newCommand:
            _drawingCommand = newCommand
            # The view needs to be redisplayed since there is a new drawing command.
            self.setNeedsDisplay_(True)

            # Disable previous menu item.
            if self.currentMenuItem is not None:
                self.currentMenuItem.setState_(NSOffState)

            # Update the current item.
            self.currentMenuItem = sender

            # Enable new menu item.
            self.currentMenuItem.setState_(NSOnState)

            # If we were showing a pasted document, let's get rid of it.
            if _pdfDocument:
                _pdfDocument = None

    def currentPrintableCommand(self):
        # The best representation for printing or exporting
        # when the current command caches using a bitmap context
        # or a layer is to not do any caching.
        if _drawingCommand in (UIHandling.kHICommandDrawOffScreenImage,
                UIHandling.kHICommandDrawWithLayer):
            return UIHandling.kHICommandDrawNoOffScreenImage

        return _drawingCommand


    def print_(self, sender):
        global _drawingCommand

        savedDrawingCommand = _drawingCommand
        # Set the drawing command to be one that is printable.
        _drawingCommand = self.currentPrintableCommand()
        # Do the printing operation on the view.
        NSPrintOperation.printOperationWithView_(self).runOperation()
        # Restore that before the printing operation.
        _drawingCommand = savedDrawingCommand

    def acceptsFirstResponder(self):
        return True


    @objc.IBAction
    def copy_(self, sender):
        addPDFDataToPasteBoard(_drawingCommand)

    @objc.IBAction
    def paste_(self, sender):
        global _pdfDocument

        newPDFDocument = createNewPDFRefFromPasteBoard()
        if newPDFDocument is not None:
            _pdfDocument = newPDFDocument
            # The view needs to be redisplayed since there is
            # a new PDF document.
            self.setNeedsDisplay_(True)


    # Return the number of pages available for printing. For this
    # application it is always 1.
    def knowsPageRange_(self):
        return True, NSRange(1, 1)

    # Return the drawing rectangle for a particular page number.
    # For this application it is always the page width and height.
    def rectForPage_(self, page):
        pi = NSPrintOperation.currentOperation().printInfo()

        # Calculate the page height in points.
        paperSize = pi.paperSize()
        return NSMakeRect(0, 0, paperSize.width, paperSize.height)

    def validateMenuItem_(self, menuItem):
        if menuItem.tag() == _drawingCommand:
            self.currentMenuItem = menuItem
            menuItem.setState_(True)
        else:
            menuItem.setState_(False)

        return True

PDFHandling.py

import AppDrawing
import FrameworkUtilities
import Utilities
import DataProvidersAndConsumers

from Quartz import *
import Quartz

import sys

def createNewPDFRefFromPasteBoard():
    # Create a reference to the PDF data on the pasteboard.
    # The implementation of myCreatePDFDataFromPasteBoard depends
    # on the application framework you are using for your application.
    #
    # myCreatePDFDataFromPasteBoard creates a reference that is owned
    # by the calling application.
    pasteBoardData = FrameworkUtilities.myCreatePDFDataFromPasteBoard()

    if pasteBoardData is None:
        print >>sys.stderr, "There is no PDF data on pasteboard!"
        return None

    # Create a data provider from the pasteboard data.
    dataProvider = myCGDataProviderCreateWithCFData(pasteBoardData)
    # Release the pasteboard data since the data provider retains
    # it and this code owns a reference but no longer requires it.
    del pasteBoardData

    if dataProvider is None:
        print >>sys.stderr, "Couldn't create data provider."
        return None

    pasteBoardPDFDocument = CGPDFDocumentCreateWithProvider(dataProvider)
    # Release the data provider now that the code is done with it.
    del dataProvider

    if pasteBoardPDFDocument is None:
        print >>sys.stderr, "Couldn't create PDF document from pasteboard data provider."
        return None
    return pasteBoardPDFDocument

_pdfDoc = None
def getPasteBoardPDFDoc(reset):
    global _pdfDoc
    if reset:
        # Release any existing document.
        _pdfDoc = createNewPDFRefFromPasteBoard()
    else:
        # If there isn't already one, create it fresh.
        if _pdfDoc is None:
            _pdfDoc = createNewPDFRefFromPasteBoard()
    return _pdfDoc


def drawPasteBoardPDF(context):
    pdfDoc = getPasteBoardPDFDoc(False)   # Obtain the existing one.
    if pdfDoc is None:
        print >>sys.stderr, "Quartz couldn't create CGPDFDocumentRef from pasteboard."
        return

    # The media box is the bounding box of the PDF document.
    pdfRect = CGPDFDocumentGetMediaBox(pdfDoc , 1);   # page 1
    # Make the destination rect origin at the Quartz origin.
    pdfRect.origin.x = pdfRect.origin.y = 0.;
    CGContextDrawPDFDocument(context, pdfRect, pdfDoc, 1);  # page 1

def cfDataCreatePDFDocumentFromCommand( command):
    # Media rect for the drawing. In a real application this
    # should be the bounding rectangle of the graphics
    # that will be the PDF content.
    mediaRect = CGRectMake(0, 0, 612, 792)

    # Create a dictionary to hold the optional information describing the PDF data.
    dict = {}

    # Add the creator and title information to the PDF content.
    dict[kCGPDFContextTitle] = "Pasted From Sample Quartz Application"
    dict[kCGPDFContextCreator] = "Sample Quartz Application"

    # Create a mutable CFData object with unlimited capacity.
    data = CFDataCreateMutable(None, 0)
    if data is None:
        print >>sys.stderr, "Couldn't make CFData!"
        return None

    # Create the data consumer to capture the PDF data.
    consumer = DataProvidersAndConsumers.myCGDataConsumerCreateWithCFData(data)
    if consumer is None:
        print >>sys.stderr, "Couldn't create data consumer!"
        return None

    pdfContext, mediaRect = CGPDFContextCreate(consumer, None, dict)
    del consumer
    del dict

    if pdfContext is None:
        print >>sys.stderr, "Couldn't create pdf context!"
        return None

    mediaRect = CGContextBeginPage(pdfContext)
    if 1:
        CGContextSaveGState(pdfContext)
        if 1:
            CGContextClipToRect(pdfContext, mediaRect)
            AppDrawing.DispatchDrawing(pdfContext, command)
        CGContextRestoreGState(pdfContext)
    CGContextEndPage(pdfContext)

    return data

def MakePDFDocument(url, exportInfo):
    # Use this as the media box for the document.
    # In a real application this should be the bounding
    # rectangle of the graphics that will be the PDF content.
    mediaRect = CGRectMake(0, 0, 612, 792)

    info = {
        # Add the title information for this document.
        kCGPDFContextTitle: "BasicDrawing Sample Graphics",

        # Add the author information for this document. This is typically
        # the user creating the document.
        kCGPDFContextAuthor: "David Gelphman and Bunny Laden",

        # The creator is the application creating the document.
        kCGPDFContextCreator: "BasicDrawing Application",
    }

    if 0:
        # Before using the kCGPDFContextCropBox key, check to ensure that it
        # is available.
        if hasattr(Quartz, 'kCFPDFContextCropBox'):
            # Prepare the crop box entry. Use this rectangle as the crop box for
            # this example.

            # XXX:fixme: need to encode as CFData!!!
            info[kCGPDFContextCropBox] = CGRectMake(100, 100, 200, 200)

    if url is not None:
        pdfContext = CGPDFContextCreateWithURL(url, mediaRect, info)
        if pdfContext is not None:
            CGContextBeginPage(pdfContext, mediaRect)
            if 1:
                CGContextSaveGState(pdfContext)
                if 1:
                    CGContextClipToRect(pdfContext, mediaRect)
                    AppDrawing.DispatchDrawing(pdfContext, exportInfo.command)
                CGContextRestoreGState(pdfContext)
            CGContextEndPage(pdfContext)
            del pdfContext
        else:
            print >>sys.stderr, "Can't create PDF document!"

PathDrawing.py

from Quartz import *
import math

def doEgg(context):
    p0 = CGPoint(0, 0)
    p1 = CGPoint(0, 200)
    c1 = CGPoint(140, 5)
    c2 = CGPoint(80, 198)

    CGContextTranslateCTM(context, 100, 5)
    CGContextBeginPath(context)

    CGContextMoveToPoint(context, p0.x, p0.y)
    # Create the Bezier path segment for the right side of the egg.
    CGContextAddCurveToPoint(context, c1.x, c1.y, c2.x, c2.y, p1.x, p1.y)
    # Create the Bezier path segment for the left side of the egg.
    CGContextAddCurveToPoint(context, -c2.x, c2.y, -c1.x, c1.y, p0.x, p0.y)
    CGContextClosePath(context)
    CGContextSetLineWidth(context, 2)
    CGContextDrawPath(context, kCGPathStroke)

def addRoundedRectToPath(context, rect, ovalWidth, ovalHeight):
    # If either ovalWidth or ovalHeight is 0, draw a regular rectangle.
    if ovalWidth == 0 or ovalHeight == 0:
        CGContextAddRect(context, rect)
    else:
        CGContextSaveGState(context)
        if 1:
            # Translate to lower-left corner of rectangle.
            CGContextTranslateCTM(context,
                    CGRectGetMinX(rect), CGRectGetMinY(rect))
            # Scale by the oval width and height so that
            # each rounded corner is 0.5 units in radius.
            CGContextScaleCTM(context, ovalWidth, ovalHeight)
            # Unscale the rectangle width by the amount of the X scaling.
            fw = CGRectGetWidth(rect) / ovalWidth
            # Unscale the rectangle height by the amount of the Y scaling.
            fh = CGRectGetHeight(rect) / ovalHeight
            # Start at the right edge of the rect, at the midpoint in Y.
            CGContextMoveToPoint(context, fw, fh/2)
            # Segment 1
            CGContextAddArcToPoint(context, fw, fh, fw/2, fh, 0.5)
            # Segment 2
            CGContextAddArcToPoint(context, 0, fh, 0, fh/2, 0.5)
            # Segment 3
            CGContextAddArcToPoint(context, 0, 0, fw/2, 0, 0.5)
            # Segment 4
            CGContextAddArcToPoint(context, fw, 0, fw, fh/2, 0.5)
            # Closing the path adds the last segment.
            CGContextClosePath(context)
        CGContextRestoreGState(context)

def doRoundedRects(context):
    rect = CGRectMake(10, 10, 210, 150)
    ovalWidth = 100
    ovalHeight = 100
    CGContextSetLineWidth(context, 2.)
    CGContextBeginPath(context)
    addRoundedRectToPath(context, rect, ovalWidth, ovalHeight)
    CGContextSetRGBStrokeColor(context, 1, 0, 0, 1)
    CGContextDrawPath(context, kCGPathStroke)

def doStrokeWithCTM(context):
    CGContextTranslateCTM(context, 150., 180.)
    CGContextSetLineWidth(context, 10)
    # Draw ellipse 1 with a uniform stroke.
    CGContextSaveGState(context)
    if 1:
        # Scale the CTM so the circular arc will be elliptical.
        CGContextScaleCTM(context, 2, 1)
        CGContextBeginPath(context)
        # Create an arc that is a circle.
        CGContextAddArc(context, 0., 0., 45., 0., 2*math.pi, 0)
        # Restore the context parameters prior to stroking the path.
        # CGContextRestoreGState does not affect the path in the context.
    CGContextRestoreGState(context)
    CGContextStrokePath(context)

    # *** was 0, -120
    CGContextTranslateCTM(context, 220., 0.)
    # Draw ellipse 2 with non-uniform stroke.
    CGContextSaveGState(context)
    if 1:
        # Scale the CTM so the circular arc will be elliptical.
        CGContextScaleCTM(context, 2, 1)
        CGContextBeginPath(context)
        # Create an arc that is a circle.
        CGContextAddArc(context, 0., 0., 45., 0., 2*math.pi, 0)
        # Stroke the path with the scaled coordinate system in effect.
        CGContextStrokePath(context)
    CGContextRestoreGState(context)

def doRotatedEllipsesWithCGPath(context):
    totreps = 144
    tint = 1.0
    tintIncrement = 1.0/totreps

    # Create a new transform consisting of a 45 degree rotation.
    theTransform = CGAffineTransformMakeRotation(math.pi/4)
    # Apply a scaling transformation to the transform just created.
    theTransform = CGAffineTransformScale(theTransform, 1, 2)
    # Create a mutable CGPath object.
    path = CGPathCreateMutable()
    if path is None:
        print >>sys.stderr, "Couldn't create path!"
        return

    # Add a circular arc to the CGPath object, transformed
    # by an affine transform.
    CGPathAddArc(path, theTransform, 0., 0., 45., 0., 2*math.pi, False);
    # Close the CGPath object.
    CGPathCloseSubpath(path)

    # Place the first ellipse at a good location.
    CGContextTranslateCTM(context, 100, 100)
    for i in range(totreps):
        CGContextBeginPath(context)
        # Add the CGPath object to the current path in the context.
        CGContextAddPath(context, path)

        # Set the fill color for this instance of the ellipse.
        CGContextSetRGBFillColor(context, tint, 0., 0., 1.)
        # Filling the path implicitly closes it.
        CGContextFillPath(context)
        # Compute the next tint color.
        tint -= tintIncrement
        # Move over for the next ellipse.
        CGContextTranslateCTM(context, 1, 0.)

def alignPointToUserSpace(context, p):
    # Compute the coordinates of the point in device space.
    p = CGContextConvertPointToDeviceSpace(context, p)
    # Ensure that coordinates are at exactly the corner
    # of a device pixel.
    p.x = math.floor(p.x)
    p.y = math.floor(p.y)
    # Convert the device aligned coordinate back to user space.
    return CGContextConvertPointToUserSpace(context, p)

def alignSizeToUserSpace(context, s):
    # Compute the size in device space.
    s = CGContextConvertSizeToDeviceSpace(context, s)
    # Ensure that size is an integer multiple of device pixels.
    s.width = math.floor(s.width)
    s.height = math.floor(s.height)
    # Convert back to user space.
    return CGContextConvertSizeToUserSpace(context, s)

def alignRectToUserSpace(context, r):
    # Compute the coordinates of the rectangle in device space.
    r = CGContextConvertRectToDeviceSpace(context, r)
    # Ensure that the x and y coordinates are at a pixel corner.
    r.origin.x = math.floor(r.origin.x)
    r.origin.y = math.floor(r.origin.y)
    # Ensure that the width and height are an integer number of
    # device pixels. Note that this produces a width and height
    # that is less than or equal to the original width. Another
    # approach is to use ceil to ensure that the new rectangle
    # encloses the original one.
    r.size.width = math.floor(r.size.width)
    r.size.height = math.floor(r.size.height)

    # Convert back to user space.
    return CGContextConvertRectToUserSpace(context, r)

def doPixelAlignedFillAndStroke(context):
    p1 = CGPointMake(16.7, 17.8)
    p2 = CGPointMake(116.7, 17.8)
    r = CGRectMake(16.7, 20.8, 100.6, 100.6)

    CGContextSetLineWidth(context, 2)
    CGContextSetRGBFillColor(context, 1., 0., 0., 1.)
    CGContextSetRGBStrokeColor(context, 1., 0., 0., 1.)

    # Unaligned drawing.
    CGContextBeginPath(context)
    CGContextMoveToPoint(context, p1.x, p1.y)
    CGContextAddLineToPoint(context, p2.x, p2.y)
    CGContextStrokePath(context)
    CGContextFillRect(context, r)

    # Translate to the right before drawing along
    # aligned coordinates.
    CGContextTranslateCTM(context, 106, 0)

    # Aligned drawing.

    # Compute the length of the line in user space.
    s = CGSizeMake(p2.x - p1.x, p2.y - p1.y)

    CGContextBeginPath(context)
    # Align the starting point to a device
    # pixel boundary.
    p1 = alignPointToUserSpace(context, p1)
    # Establish the starting point of the line.
    CGContextMoveToPoint(context, p1.x, p1.y)
    # Compute the line length as an integer
    # number of device pixels.
    s = alignSizeToUserSpace(context, s)
    CGContextAddLineToPoint(context,
                                p1.x + s.width,
                                p1.y + s.height)
    CGContextStrokePath(context)
    # Compute a rect that is aligned to device
    # space with a width that is an integer
    # number of device pixels.
    r = alignRectToUserSpace(context, r)
    CGContextFillRect(context, r)

PatternDrawing.py

from Quartz import *
import Utilities

import sys

def scalePatternPhase(phase):
    # Adjust the pattern phase if scaling to export as bits. This is equivalent to scaling base
    # space by the scaling factor.
    patternScaling = Utilities.getScalingFactor()
    if patternScaling != 1.0:
        phase = CGSizeApplyAffineTransform(phase,
            CGAffineTransformMakeScale(patternScaling, patternScaling))

    return phase

def scalePatternMatrix(patternTransform):
    # Scale the pattern by the scaling factor when exporting to bits. This is equivalent to
    # scaling base space by the scaling factor.
    patternScaling = Utilities.getScalingFactor()
    if patternScaling != 1.0:
        patternTransform = CGAffineTransformConcat(patternTransform,
                CGAffineTransformMakeScale(patternScaling, patternScaling))

    return patternTransform


def myDrawRedBlackCheckerBoardPattern(info, patternCellContext):
    # This pattern proc draws a red and a black rectangle
    # patch representing the minimum cell needed to paint a
    # checkerboard with that pattern.
    #
    # Each 'cell' of the checkerboard is 2 units on a side.
    #
    # This code uses CGColorRefs which are available in Panther
    # and later only. Patterns are available in all versions of
    # Mac OS X but this code uses CGColorRefs for convenience
    # and efficiency.

    # Paint a black checkerboard box.
    CGContextSetFillColorWithColor(patternCellContext,
            Utilities.getRGBOpaqueBlackColor())
    # This is a 1x1 unit rect whose origin is at 0,0 in pattern space.
    CGContextFillRect(patternCellContext, CGRectMake(0.0, 0.0, 1.0, 1.0))
    # This is a 1x1 unit rect whose origin is at 1,1 in pattern space.
    CGContextFillRect(patternCellContext, CGRectMake(1.0, 1.0, 1.0, 1.0))

    # Paint a red checkerboard box.
    CGContextSetFillColorWithColor(patternCellContext,
            Utilities.getRGBOpaqueRedColor())
    # This is a 1x1 unit rect whose origin is at 1,0 in pattern space,
    # that is, immediately to the right of first black checkerboard box.
    CGContextFillRect(patternCellContext, CGRectMake(1.0, 0.0, 1.0, 1.0))
    # This is a 1x1 unit rect whose origin is at 0,1 in pattern space,
    # that is, immediately above the first black checkerboard box.
    CGContextFillRect(patternCellContext, CGRectMake(0.0, 1.0, 1.0, 1.0))

def createRedBlackCheckerBoardPattern(patternTransform):
    pattern = CGPatternCreate(None,
        # The pattern cell origin is at (0,0) with a
        # width of 2 units and a height of 2 units.
        CGRectMake(0, 0, 2, 2),
        # Use the pattern transform supplied to this routine.
        scalePatternMatrix(patternTransform),
        # In pattern space the xStep is 2 units to the next cell in x
        # and the yStep is 2 units to the next row of cells in y.
        2, 2,
        # This value is a good choice for this type of pattern and it
        # avoids seams between tiles.
        kCGPatternTilingConstantSpacingMinimalDistortion,
        # This pattern has intrinsic color.
        True,
        (
            myDrawRedBlackCheckerBoardPattern,
            None
        ))
    return pattern

def doRedBlackCheckerboard(context):
    dash = [4]
    pattern = createRedBlackCheckerBoardPattern(
                            CGAffineTransformMakeScale(20, 20))
    if pattern is None:
        print >>sys.stderr, "Couldn't create pattern!"
        return

    # Create the pattern color space. Since the pattern
    # itself has intrinsic color, the 'baseColorSpace' parameter
    # to CGColorSpaceCreatePattern must be None.
    patternColorSpace = CGColorSpaceCreatePattern(None)
    CGContextSetFillColorSpace(context, patternColorSpace)

    # The pattern has intrinsic color so the color components array
    # passed to CGContextSetFillPattern is just the alpha value used
    # to composite the pattern cell.

    # Paint the pattern with alpha = 1.
    color = [1.0]

    # Set the fill color to the checkerboard pattern.
    CGContextSetFillPattern(context, pattern, color)

    # Fill a 100x100 unit rect at (20,20).
    CGContextFillRect(context, CGRectMake(20, 20, 100, 100))

    # Save the graphics state before changing the stroke color.
    CGContextSaveGState(context)
    if 1:
        # Set the stroke color space and color to the pattern.
        CGContextSetStrokeColorSpace(context, patternColorSpace)
        CGContextSetStrokePattern(context, pattern, color)

        # Stroke an ellipse with the pattern.
        CGContextSetLineWidth(context, 8)
        CGContextBeginPath(context)
        Utilities.myCGContextAddEllipseInRect(context, CGRectMake(120, 20, 50, 100))
        CGContextStrokePath(context)

    # Restore to the graphics state without the
    # pattern stroke color.
    CGContextRestoreGState(context)

    # Now draw text.
    CGContextSetTextMatrix(context, CGAffineTransformIdentity)
    # Choose the font with the PostScript name "Times-Roman",
    # size 80 points, with the encoding MacRoman encoding.
    CGContextSelectFont(context, "Times-Roman", 80, kCGEncodingMacRoman)

    # Using the fill text drawing mode.
    CGContextSetTextDrawingMode(context, kCGTextFill)

    # Draw text with the pattern.
    CGContextShowTextAtPoint(context, 20, 120, "Text", 4)

    # Rectangle 1, filled.
    CGContextFillRect(context, CGRectMake(200, 20, 90, 90))

    # Rectangle 2, filled and stroked with a dash.
    CGContextSetLineWidth(context, 2)
    CGContextSetLineDash(context, 0, dash, 1)
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(200, 70, 90, 90))
    CGContextDrawPath(context, kCGPathFillStroke)

def doPatternMatrix(context):
    basePatternMatrix = CGAffineTransformMakeScale(20, 20)
    pattern = createRedBlackCheckerBoardPattern(basePatternMatrix)
    if pattern is None:
        print >>sys.stderr, "Couldn't create pattern!"
        return

    # Create the pattern color space. Since the pattern
    # itself has intrinsic color, the 'baseColorSpace' parameter
    # to CGColorSpaceCreatePattern must be None.
    patternColorSpace = CGColorSpaceCreatePattern(None)

    CGContextSetFillColorSpace(context, patternColorSpace)
    del patternColorSpace

    CGContextTranslateCTM(context, 40, 40)
    CGContextSetPatternPhase(context, scalePatternPhase(CGSize(40, 40)))

    # The pattern has intrinsic color so the color components array
    # passed to CGContextSetFillPattern is the alpha value used
    # to composite the pattern cell.

    # Paint the pattern first with alpha = 1.
    color = [1]
    CGContextSetFillPattern(context, pattern, color)

    # Rectangle 1.
    CGContextFillRect(context, CGRectMake(0, 0, 100, 100))

    CGContextSaveGState(context)
    if 1:
        # Rectangle 2.
        # Paint the pattern with 65% alpha.
        color = [0.65]
        CGContextSetFillPattern(context, pattern, color)
        # Rotate 45 degrees about the point (150, 50).
        CGContextTranslateCTM(context, 150.0, 50.0)
        CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45.0))
        CGContextTranslateCTM(context, -50.0, -50.0)
        # Rectangle 2. Patterns do not translate, scale or
        # rotate with the CTM. You can see that the pattern
        # tile of this filled rectangle is that of Rectangle
        # 1.
        CGContextFillRect(context, CGRectMake(0, 0, 100, 100))
        # Release the pattern.
        del pattern
    CGContextRestoreGState(context)

    CGContextSaveGState(context)
    if 1:
        # Rectangle 3. The pattern is rotated with the object.
        # Rotate 45 degrees about the point 250, 50.
        t = CGAffineTransformMakeTranslation(250.0, 50.0)
        t = CGAffineTransformRotate(t, Utilities.DEGREES_TO_RADIANS(45.0))
        # Translate back to -50, -50.
        t = CGAffineTransformTranslate(t, -50.0, -50.0)
        CGContextConcatCTM(context, t)
        # Make a new pattern that is equivalent to
        # the old pattern but transformed to current user
        # space. The order of transformations is crucial.
        # This ordering is equivalent to using the same pattern
        # matrix as before but transforming base space by t.
        patTransform = CGAffineTransformConcat(basePatternMatrix, t)
        pattern = createRedBlackCheckerBoardPattern(patTransform)
        color = [1]
        CGContextSetFillPattern(context, pattern, color)
        # Release the pattern.
        del pattern
        CGContextFillRect(context, CGRectMake(0, 0, 100, 100))
    CGContextRestoreGState(context)

    CGContextSaveGState(context)
    if 1:
        # Rectangle 4. The pattern is scaled with the object.
        # Translate and scale.
        t = CGAffineTransformMakeTranslation(320, 0)
        t = CGAffineTransformScale(t, 2, 2)
        CGContextConcatCTM(context, t)
        # Make a new pattern that is equivalent to
        # the old pattern but transformed to current user
        # space. The order of transformations is crucial.
        # This ordering is equivalent to using the same pattern
        # matrix as before but transforming base space by t.
        patTransform = CGAffineTransformConcat(basePatternMatrix, t)
        pattern = createRedBlackCheckerBoardPattern(patTransform)
        color = [1]
        CGContextSetFillPattern(context, pattern, color)
        # Release the pattern.
        del pattern
        CGContextFillRect(context, CGRectMake(0, 0, 100, 100))
    CGContextRestoreGState(context)


def doPatternPhase(context):
    pattern = createRedBlackCheckerBoardPattern(
                            CGAffineTransformMakeScale(20, 20))
    if pattern is None:
        print >>sys.stderr, "Couldn't create pattern!"
        return

    # Create the pattern color space for a colored pattern.
    patternColorSpace = CGColorSpaceCreatePattern(None)
    CGContextSetFillColorSpace(context, patternColorSpace)

    # Paint the pattern with alpha = 1.
    color = (1,)
    CGContextSetFillPattern(context, pattern, color)

    # Rectangle 1
    CGContextFillRect(context, CGRectMake(20, 150, 100, 100))

    # Rectangle 2
    CGContextFillRect(context, CGRectMake(130, 150, 100, 100))

    # Rectangle 3
    # Set the pattern phase so that the pattern origin
    # is at the lower-left of the shape.
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(20, 20) ))
    CGContextFillRect(context, CGRectMake(20, 20, 100, 100))

    # Rectangle 4
    # Set the pattern phase so that the pattern origin
    # is at the lower-left corner of the shape.
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(130, 20) ))
    CGContextTranslateCTM(context, 130, 20)
    CGContextFillRect(context, CGRectMake(0, 0, 100, 100))

def drawRotatedRect(c, p):
    r = CGRectMake(0, 0, 1, 1)
    CGContextSaveGState(c)
    if 1:
        CGContextTranslateCTM(c, p.x, p.y)
        CGContextRotateCTM(c, Utilities.DEGREES_TO_RADIANS(45))
        CGContextTranslateCTM(c, -r.size.width/2, -r.size.height/2)
        CGContextFillRect(c, r)
    CGContextRestoreGState(c)

def myStencilPatternProc(info, patternCellContext):
    drawRotatedRect(patternCellContext, CGPointMake(1, 1))
    drawRotatedRect(patternCellContext, CGPointMake(1.75, 1))

def createStencilPattern(patternTransform):
    pattern = CGPatternCreate(None,
                # The pattern cell origin is at (0,0) with a
                # width of 2.5 units and a height of 2 units. This
                # pattern cell has transparent areas since
                # the pattern proc only marks a portion of the cell.
                CGRectMake(0, 0, 2.5, 2),
                # Use the pattern transform supplied to this routine.
                scalePatternMatrix(patternTransform),
                # Use the width and height of the pattern cell for
                # the xStep and yStep.
                2.5, 2,
                # This value is a good choice for this type of pattern and it
                # avoids seams between tiles.
                kCGPatternTilingConstantSpacingMinimalDistortion,
                # This pattern does not have intrinsic color.
                False,   # Must be False for a stencil pattern.
                (
                    myStencilPatternProc,
                    None,
                ))
    return pattern

def doStencilPattern(context):
    pattern = createStencilPattern(CGAffineTransformMakeScale(20, 20))
    if pattern is None:
        print >>sys.stderr, "Couldn't create pattern!"
        return

    # Create the pattern color space. This pattern is a stencil
    # pattern so when the code sets the pattern it also sets the
    # color it will paint the pattern with. In order to
    # set the pattern color space in this case we also have
    # to say what underlying color space should be used when
    # the pattern proc is called.
    baseColorSpace = Utilities.getTheCalibratedRGBColorSpace()
    patternColorSpace = CGColorSpaceCreatePattern(baseColorSpace)

    CGContextSetFillColorSpace(context, patternColorSpace)
    # This code is finished with the pattern color space and can release
    # it because Quartz retains it while it is the current color space.
    del patternColorSpace

    # The pattern has no intrinsic color so the color components array
    # passed to CGContextSetFillPattern contains the colors to paint
    # the pattern with in the baseColorSpace. In the case here,
    # first paint the pattern with opaque blue.
    color = (0.11, 0.208, 0.451, 1.0)
    CGContextSetFillPattern(context, pattern, color)

    # Rectangle 1.
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(20, 160) ))
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(20, 160, 105, 80))
    CGContextDrawPath(context, kCGPathFillStroke)

    # Rectangle 2.
    # Set the pattern color so the stencil pattern
    # is painted in a yellow shade.
    color = (1.0, 0.816, 0.0, 1.0)
    CGContextSetFillPattern(context, pattern, color)
    # Set the pattern phase to the origin of the next object.
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(140, 160) ))
    CGContextBeginPath(context)
    CGContextAddRect(context, CGRectMake(140, 160, 105, 80))
    CGContextDrawPath(context, kCGPathFillStroke)

    CGContextSaveGState(context)
    if 1:
        CGContextSetFillColorWithColor(context,
                Utilities.getRGBOpaqueBlueColor())
        # Fill color is now blue. Paint two blue rectangles
        # that will be underneath the drawing which follows.
        CGContextFillRect(context, CGRectMake(20, 40, 105, 80))
        CGContextFillRect(context, CGRectMake(140, 40, 105, 80))
    CGContextRestoreGState(context)

    # The fill color is again the stencil pattern with
    # the underlying fill color an opaque yellow.

    # Rectangle 3.
    # This paints over the blue rect just painted at 20,40
    # and the blue underneath is visible where the pattern has
    # transparent areas.
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(20, 40) ))
    CGContextFillRect(context, CGRectMake(20, 40, 105, 80))

    # Rectangle 4.
    # Change the alpha value of the underlying color used
    # to paint the stencil pattern.
    color = list(color)
    color[3] = 0.75
    CGContextSetFillPattern(context, pattern, color)
    CGContextSetPatternPhase(context, scalePatternPhase( CGSizeMake(140, 40) ))
    CGContextFillRect(context, CGRectMake(140, 40, 105, 80))

class MyPDFPatternInfo (object):
    rect = None
    pdfDoc = None

def myDrawPDFPattern(info, patternCellContext):
    # This pattern proc draws the first page of a PDF document to
    # a destination rect.
    CGContextSaveGState(patternCellContext)
    CGContextClipToRect(patternCellContext, info.rect)
    CGContextDrawPDFDocument(patternCellContext, info.rect, info.pdfDoc, 1)
    CGContextRestoreGState(patternCellContext)

# Versions of Tiger prior to 10.4.3 have a bug such that use of an xStep that
# doesn't match the width of pattern bounding box or a yStep that doesn't match the
# height of the pattern bounding box produces incorrect results when drawn
# to a bit-based context. Setting TIGERSTEPWORKAROUND works around this bug.


TIGERSTEPWORKAROUND=1
SCALEPATTERN=1
OPTIMIZEDPERF=0


def createPDFPatternPattern(additionalTransformP, url):
    patternInfoP = MyPDFPatternInfo()

    patternInfoP.pdfDoc = CGPDFDocumentCreateWithURL(url)
    if patternInfoP.pdfDoc is None:
        print >>sys.stderr, "Couldn't create PDF document reference!"
        return

    patternInfoP.rect = CGPDFDocumentGetMediaBox(patternInfoP.pdfDoc, 1)
    # Set the origin of the media rect for the PDF document to (0,0).
    patternInfoP.rect.origin = CGPointZero

    if additionalTransformP is not None:
        patternTransform = additionalTransformP
    else:
        patternTransform = CGAffineTransformIdentity

    # To emulate the example from the bitmap context drawing chapter,
    # the tile offset in each dimension is the tile size in that
    # dimension, plus 6 units.
    if SCALEPATTERN:
        tileOffsetX = 6. + patternInfoP.rect.size.width
        tileOffsetY = 6. + patternInfoP.rect.size.height
    else:
        tileOffsetX = 2. + patternInfoP.rect.size.width
        tileOffsetY = 2. + patternInfoP.rect.size.height

    # Tiger versions 10.4.0 - 10.4.2 have a bug such that the bounds
    # width and height is incorrectly used as the xstep,ystep.
    # To workaround this bug, we can make the bounds rect incorporate
    # the xstep,ystep since xstep,ystep are larger than the bounds.
    if OPTIMIZEDPERF or TIGERSTEPWORKAROUND:
        patternRect = CGRectMake(0, 0, tileOffsetX, tileOffsetY)
    else:
        patternRect = patternInfoP.rect

    if OPTIMIZEDPERF:
        # Produces best performance if bbox == xstep/ystep
        spacing = kCGPatternTilingConstantSpacing
    else:
        spacing = kCGPatternTilingConstantSpacingMinimalDistortion

    pattern = CGPatternCreate(patternInfoP,
            # The pattern cell size is the size
            # of the media rect of the PDF document.
            patternRect,
            scalePatternMatrix(patternTransform),
            tileOffsetX, tileOffsetY,
            # This value is a good choice for this type of pattern and
            #  it avoids seams between tiles.
            spacing,
            # This pattern has intrinsic color.
            True,
            (
                myDrawPDFPattern,
                None,
            ))
    # If the pattern can't be created then release the
    # pattern resources and info parameter.
    if pattern is None:
        patternInfoP = None

    return pattern


def drawWithPDFPattern(context, url):
    if SCALEPATTERN:
        patternMatrix = CGAffineTransformMakeScale(1.0/3, 1.0/3)
    else:
        patternMatrix = CGAffineTransformMakeScale(1, 1)

    # Scale the PDF pattern down to 1/3 its original size.
    pdfPattern = createPDFPatternPattern(patternMatrix, url)
    if pdfPattern is None:
        print >>sys.stderr, "Couldn't create pattern!"
        return

    # Create the pattern color space. Since the pattern
    # itself has intrinsic color, the 'baseColorSpace' parameter
    # to CGColorSpaceCreatePattern must be None.
    patternColorSpace = CGColorSpaceCreatePattern(None)
    CGContextSetFillColorSpace(context, patternColorSpace)
    # Quartz retains the color space so this code
    # can now release it since it no longer needs it.
    del patternColorSpace

    # Paint the pattern with an alpha of 1.
    color = (1,)
    CGContextSetFillPattern(context, pdfPattern, color)
    # Quartz retains the pattern so this code
    # can now release it since it no longer needs it.
    del pdfPattern

    # Fill a US Letter size rect with the pattern.
    CGContextFillRect(context, CGRectMake(0, 0, 612, 792))

QuartzTextDrawing.py

from Quartz import *
import Quartz

import Utilities

import sys

def drawQuartzRomanText(context):
    text = "Quartz"
    textlen = len(text)
    fontSize = 60

    opaqueBlack = [0.0, 0.0, 0.0, 1.0]
    opaqueRed   = [0.663, 0.0, 0.031, 1.0]

    # Set the fill color space. This sets the
    # fill painting color to opaque black.
    CGContextSetFillColorSpace(context,
        Utilities.getTheCalibratedRGBColorSpace())

    # The Cocoa framework calls the draw method with an undefined
    # value of the text matrix. It's best to set it to what is needed by
    # this code: the identity transform.
    CGContextSetTextMatrix(context, CGAffineTransformIdentity)

    # Set the font with the PostScript name "Times-Roman", at
    # fontSize points, with the MacRoman encoding.
    CGContextSelectFont(context, "Times-Roman", fontSize, kCGEncodingMacRoman)

    # The default text drawing mode is fill. Draw the text at (70, 400).
    CGContextShowTextAtPoint(context, 70, 400, text, textlen)

    # Set the fill color to red.
    CGContextSetFillColor(context, opaqueRed)

    # Draw the next piece of text where the previous one left off.
    CGContextShowText(context, text, textlen)

    for i in range(3):
        # Get the current text pen position.
        p = CGContextGetTextPosition(context)
        # Translate to the current text pen position.
        CGContextTranslateCTM(context, p.x, p.y)

        # Rotate clockwise by 90 degrees for the next
        # piece of text.
        CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(-90))
        # Draw the next piece of text in blac at the origin.
        CGContextSetFillColor(context, opaqueBlack)
        CGContextShowTextAtPoint(context, 0, 0, text, textlen)
        # Draw the next piece of text where the previous piece
        # left off and paint it with red.
        CGContextSetFillColor(context, opaqueRed)
        CGContextShowText(context, text, textlen)


def myCGContextStrokeLineSegments(context, s, count):
    # CGContextStrokeLineSegments is available only on Tiger and later
    # so if it isn't available, use an emulation of
    # CGContextStrokeLineSegments. It is better to use the
    # built-in CGContextStrokeLineSegments since it has significant
    # performance optimizations on some hardware.
    if hasattr(Quartz, 'CGContextStrokeLineSegments'):
        CGContextStrokeLineSegments(context, s, count)
    else:
        CGContextBeginPath(context)
        for k in xrange(0, count, 2):
            CGContextMoveToPoint(context, s[k].x, s[k].y)
            CGContextAddLineToPoint(context, s[k+1].x, s[k+1].y)
        CGContextStrokePath(context)

_gridLines = []
def drawGridLines(context):
    numlines = 60

    if not _gridLines:
        stepsize = 4.0
        val = 0
        for i in xrange(0, 2*numlines, 2):
            _gridLines.append(CGPointMake(val, -60))
            _gridLines.append(CGPointMake(val, 200))
            val += stepsize

        val = -20
        for i in xrange(2*numlines, 4*numlines, 2):
            _gridLines.append(CGPointMake(0, val))
            _gridLines.append(CGPointMake(400, val))
            val += stepsize

    myCGContextStrokeLineSegments(context, _gridLines,  len(_gridLines))

def drawQuartzTextWithTextModes(context):
    fillText = "Fill "
    strokeText = "Stroke "
    fillAndStrokeText = "FillStroke "
    invisibleText = "Invisible "
    clipText = "ClipText "
    fillStrokeClipText = "FillStrokeClip "
    fontSize = 40.0
    extraLeading = 5.0
    dash = (1,1)
    opaqueRed = (1.0, 0.0, 0.0, 1.0)

    # Set the fill and stroke color space. This sets the
    # fill and stroke painting color to opaque black.
    CGContextSetFillColorSpace(context,
            Utilities.getTheCalibratedRGBColorSpace())
    CGContextSetStrokeColorSpace(context,
            Utilities.getTheCalibratedRGBColorSpace())

    # The Cocoa framework calls the draw method with an undefined
    # value of the text matrix. It's best to set it to what is needed by
    # this code: the identity transform.
    CGContextSetTextMatrix(context, CGAffineTransformIdentity)

    # Set the font with the PostScript name "Times-Roman", at
    # fontSize points, with the MacRoman encoding.
    CGContextSelectFont(context, "Times-Roman", fontSize, kCGEncodingMacRoman)

    # ----  Text Line 1 ----

    # Default text drawing mode is fill. Draw the text at (10, 400).
    CGContextShowTextAtPoint(context, 10, 400, fillText, len(fillText))

    # Set the fill color to red.
    CGContextSetFillColor(context, opaqueRed)

    CGContextSetTextPosition(context, 180, 400)
    CGContextShowText(context, fillText, len(fillText))

    # Translate down for the next line of text.
    CGContextTranslateCTM(context, 0, -(fontSize + extraLeading))

    # ----  Text Line 2 ----

    # Now stroke the text by setting the text drawing mode
    # to kCGTextStroke. When stroking text, Quartz uses the stroke
    # color in the graphics state.
    CGContextSetTextDrawingMode(context, kCGTextStroke)
    CGContextShowTextAtPoint(context, 10, 400, strokeText, len(strokeText))

    # When stroking text, the line width and other gstate parameters
    # that affect stroking affect text stroking as well.
    CGContextSetLineWidth(context, 2)
    CGContextSetLineDash(context, 0, dash, 2)

    CGContextSetTextPosition(context, 180, 400)
    CGContextShowText(context, strokeText, len(strokeText))

    # Reset the line dash and line width to their defaults.
    CGContextSetLineDash(context, 0, None, 0)
    CGContextSetLineWidth(context, 1)

    # Translate down for the next line of text.
    CGContextTranslateCTM(context, 0, -(fontSize + extraLeading))

    # ----  Text Line 3 ----

    # Set the text drawing mode so that text is both filled and
    # stroked. This produces text that is filled with the fill
    # color and stroked with the stroke color.
    CGContextSetTextDrawingMode(context, kCGTextFillStroke)
    CGContextShowTextAtPoint(context, 10, 400,
            fillAndStrokeText, len(fillAndStrokeText))

    # Now draw again with a thicker stroke width.
    CGContextSetLineWidth(context, 2)
    CGContextSetTextPosition(context, 180, 400)
    CGContextShowText(context, fillAndStrokeText, len(fillAndStrokeText))

    CGContextSetLineWidth(context, 1)
    CGContextTranslateCTM(context, 0, -(fontSize + extraLeading))

    # ----  Text Line 4 ----

    # Set the text drawing mode to invisible so that the next piece of
    # text does not appear. Quartz updates the text position as
    # if it had been drawn.
    CGContextSetTextDrawingMode(context, kCGTextInvisible)
    CGContextShowTextAtPoint(context, 10, 400,
            invisibleText, len(invisibleText))

    CGContextSetTextDrawingMode(context, kCGTextFill)

    CGContextSetTextPosition(context, 180, 400)
    CGContextShowText(context, fillText, len(fillText))

    CGContextTranslateCTM(context, 0, -(fontSize + extraLeading))

    # ----  Text Line 5 ----
    CGContextSaveGState(context)
    if 1:
        # Use the text as a clipping path.
        CGContextSetTextDrawingMode(context, kCGTextClip)
        CGContextShowTextAtPoint(context, 10, 400, clipText, len(clipText))

        # Position and draw a grid of lines.
        CGContextTranslateCTM(context, 10, 400)
        drawGridLines(context)
    CGContextRestoreGState(context)

    CGContextSaveGState(context)
    if 1:
        # The current text position is that after the last piece
        # of text has been drawn. Since CGContextSaveGState/
        # CGContextRestoreGState do not affect the text position or
        # the text matrix, the text position is that after the last
        # text was "drawn", that drawn with the kCGTextClip mode
        # above. This is where the next text drawn will go if it
        # isn't explicitly positioned.
        nextTextPosition = CGContextGetTextPosition(context)

        # Draw so that the text is filled, stroked, and then used
        # the clip subsequent drawing.
        CGContextSetTextDrawingMode(context, kCGTextFillStrokeClip)

        # Explicitly set the text position.
        CGContextSetTextPosition(context, 180, 400)
        nextTextPosition = CGContextGetTextPosition(context)

        CGContextShowText(context, fillStrokeClipText, len(fillStrokeClipText))
        # Adjust the location of the grid lines so that they overlap the
        # text just drawn.
        CGContextTranslateCTM(context, nextTextPosition.x, nextTextPosition.y)
        # Draw the grid lines clipped by the text.
        drawGridLines(context)
    CGContextRestoreGState(context)

# showFlippedTextAtPoint is a cover routine for CGContextShowText
# that is useful for drawing text in a coordinate system where the y axis
# is flipped relative to the default Quartz coordinate system.
#
# This code assumes that the text matrix is only used to
# flip the text, not to perform scaling or any other
# possible use of the text matrix.
#
# This function preserves the a, b, c, and d components of
# the text matrix across its execution but updates the
# tx, ty components (the text position) to reflect the
# text just drawn. If all the text you draw is flipped, it
# isn't necessary to continually set the text matrix. Instead
# you could simply call CGContextSetTextMatrix once with
# the flipped matrix each time your drawing
# code is called.
def showFlippedTextAtPoint(c, x, y, text, textLen):
    t = CGAffineTransform(1.0, 0.0, 0.0, -1.0, 0.0, 0.0)
    # Get the existing text matrix.
    s = CGContextGetTextMatrix(c)
    # Set the text matrix to the one that flips in y.
    CGContextSetTextMatrix(c, t)
    # Draw the text at the point.
    CGContextShowTextAtPoint(c, x, y, text, textLen)
    # Get the updated text position.
    p = CGContextGetTextPosition(c)
    # Update the saved text matrix to reflect the updated
    # text position.
    s.tx = p.x ; s.ty = p.y
    # Reset to the text matrix in effect when this
    # routine was called but with the text position updated.
    CGContextSetTextMatrix(c, s)


def drawQuartzTextWithTextMatrix(context):
    fontSize = 60.0
    extraLeading = 10.0
    text = "Quartz "
    textlen = len(text)

    # The Cocoa framework calls the draw method with an undefined
    # value of the text matrix. It's best to set it to what is needed by
    # this code. Initially that is the identity transform.
    CGContextSetTextMatrix(context, CGAffineTransformIdentity)

    # Set the font with the PostScript name "Times-Roman", at
    # fontSize points, with the MacRoman encoding.
    CGContextSelectFont(context, "Times-Roman", fontSize, kCGEncodingMacRoman)

    # ----  Text Line 1 ----

    # Draw the text at (10, 600).
    CGContextShowTextAtPoint(context, 10, 600, text, textlen)

    # Get the current text position. The text pen is at the trailing
    # point from the text just drawn.
    textPosition = CGContextGetTextPosition(context)

    # Set the text matrix to one that flips text in y and sets
    # the text position to the user space coordinate (0,0).
    t = CGAffineTransformMake(1, 0, 0, -1, 0, 0)
    CGContextSetTextMatrix(context, t)

    # Set the text position to the point where the previous text ended.
    CGContextSetTextPosition(context, textPosition.x, textPosition.y)

    # Draw the text at the current text position. It will be drawn
    # flipped in y, relative to the text drawn previously.
    CGContextShowText(context, text, textlen)

    # ----  Text Line 2 ----

    # Translate down for the next piece of text.
    CGContextTranslateCTM(context, 0, -(3*fontSize + extraLeading))

    CGContextSaveGState(context)
    if 1:
        # Change the text matrix to {1, 0, 0, 3, 0, 0}, which
        # scales text by a factor of 1 in x and 3 in y.
        # This scaling doesn't affect any drawing other than text
        # drawing since only text drawing is transformed by
        # the text matrix.
        t = CGAffineTransformMake(1, 0, 0, 3, 0, 0)
        CGContextSetTextMatrix(context, t)

        # This text is scaled relative to the previous text
        # because of the text matrix scaling.
        CGContextShowTextAtPoint(context, 10, 600, text, textlen)

    # This restores the graphics state to what it was at the time
    # of the last CGContextSaveGState, but since the text matrix
    # isn't part of the Quartz graphics state, it isn't affected.
    CGContextRestoreGState(context)

    # The text matrix isn't affected by CGContextSaveGState and
    # CGContextRestoreGState. You can see this by observing that
    # the next text piece appears immediately after the first piece
    # and with the same text scaling as that text drawn with the
    # text matrix established before we did CGContextRestoreGState.
    CGContextShowText(context, text, textlen)

    # ----  Text Line 3 ----
    # Translate down for the next piece of text.
    CGContextTranslateCTM(context, 0, -(fontSize + extraLeading))

    # Reset the text matrix to the identity matrix.
    CGContextSetTextMatrix(context, CGAffineTransformIdentity)

    # Now draw text in a flipped coordinate system.
    CGContextSaveGState(context)
    if 1:
        # Flip the coordinate system to mimic a coordinate system with the origin
        # at the top-left corner of a window. The new origin is at 600 units in
        # +y from the old origin and the y axis now increases with positive y
        # going down the window.
        CGContextConcatCTM(context, CGAffineTransformMake(1, 0, 0, -1, 0, 600))
        # This text will be flipped along with the CTM.
        CGContextShowTextAtPoint(context, 10, 10, text, textlen)
        # Obtain the user space coordinates of the current text position.
        textPosition = CGContextGetTextPosition(context)
        # Draw text at that point but flipped in y.
        showFlippedTextAtPoint(context, textPosition.x, textPosition.y, text, textlen)
    CGContextRestoreGState(context)

Shadings.py

from Quartz import *
import Utilities

import sys


def RedBlackRedRampEvaluate(info, input, output):
    # The domain of this function is 0 - 1. For an input value of 0
    # this function returns the color to paint at the start point
    # of the shading. For an input value of 1 this function returns
    # the color to paint at the end point of the shading. This
    # is a 1 in, 4 out function where the output values correspond
    # to an r,g,b,a color.
    #
    # For an RGB color space as the shading color space, this
    # function evaluates to produce a blend from pure, opaque
    # red at the start point to a pure opaque black at the
    # midpoint, and back to pure opaque red at the end point.

    return (
        # The red component evaluates to 1 for an input value of 0
        # (the start point of the shading). It smoothly reduces
        # to zero at the midpoint of the shading (input value 0.5)
        # and increases up to 1 at the endpoint of the shading (input
        # value 1.0).
        abs(1.0 - input[0]*2),
        # The green and blue components are always 0.
        0, 0,
        # The alpha component is 1 for the entire shading.
        1,
    )

def createFunctionForRGB(evaluationFunction):
    # This is a 1 in, 4 out function for drawing shadings
    # in a 3 component (plus alpha) color space. Shadings
    # parameterize the endpoints such that the starting point
    # represents the function input value 0 and the ending point
    # represents the function input value 1.
    domain = (0, 1)

    # The range is the range for the output colors. For an rgb
    # color space the values range from 0-1 for the r,g,b, and a
    # components.

    range = (
        # The red component, min and max.
        0, 1,
        # The green component, min and max.
        0, 1,
        # The blue component, min and max.
        0, 1,
        # The alpha component, min and max.
        0, 1
    )

    # Dimension of domain is 1 and dimension of range is 4.
    function = CGFunctionCreate(None, 1, domain, 4, range,
            (
                evaluationFunction,
                None
            ))

    if function is None:
        print >>sys.stderr, "Couldn't create the CGFunction!"
        return None

    return function

def doSimpleAxialShading(context):
    # This shading paints colors in the calibrated Generic RGB
    # color space so it needs a function that evaluates 1 in to 4 out.
    axialFunction = createFunctionForRGB(RedBlackRedRampEvaluate)
    if axialFunction is None:
        return

    # Start the shading at the point (20,20) and
    # end it at (420,20). The axis of the shading
    # is a line from (20,20) to (420,20).
    startPoint = CGPoint(x = 20, y = 20)
    endPoint = CGPoint(x = 420, y = 20)

    # Don't extend this shading.
    extendStart = extendEnd = False

    shading = CGShadingCreateAxial(Utilities.getTheCalibratedRGBColorSpace(),
                            startPoint, endPoint,
                            axialFunction,
                            extendStart, extendEnd)
    # The shading retains the function and this code
    # is done with the function so it should release it.
    del axialFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    # Draw the shading. This paints the shading to
    # the destination context, clipped by the
    # current clipping area.
    CGContextDrawShading(context, shading)

def RedGreenRampEvaluate(info, input, output):
    # The domain of this function is 0 - 1. For an input value of 0
    # this function returns the color to paint at the start point
    # of the shading. For an input value of 1 this function returns
    # the color to paint at the end point of the shading. This
    # is a 1 in, 4 out function where the output values correspond
    # to an r,g,b,a color.
    #
    # For an RGB color space as the shading color space, this
    # function evaluates to produce a blend from pure, opaque
    # red at the start point to a pure opaque green at the end point.


    return (
        # The red component starts at 1 and reduces to zero as the input
        # goes from 0 (the start point of the shading) and increases
        # to 1 (the end point of the shading).
        1.0 - input[0],
        # The green component starts at 0 for an input of 0
        # (the start point of the shading) and increases to 1
        # for an input value of 1 (the end point of the shading).
        input[0],
        # The blue component is always 0.
        0,
        # The alpha component is always 1, the shading is always opaque.
        1,
    )

def doExampleAxialShading(context):
    rect = CGRectMake(0, 0, 240, 240)

    # This shading paints colors in the calibrated Generic RGB
    # color space so it needs a function that evaluates 1 in to 4 out.
    redGreenFunction = createFunctionForRGB(RedGreenRampEvaluate)
    if redGreenFunction is None:
        return

    # Start the shading at the point (20,20) and
    # end it at (220,220). The axis of the shading
    # is a diagonal line from (20,20) to (220,220).
    startPoint = CGPoint(x = 20, y = 20)
    endPoint = CGPoint(x = 220, y = 220)

    # Don't extend this shading.
    extendStart = extendEnd = False
    shading = CGShadingCreateAxial(Utilities.getTheCalibratedRGBColorSpace(),
                            startPoint, endPoint,
                            redGreenFunction,
                            extendStart, extendEnd)

    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    # Position for the first portion of the drawing.
    CGContextTranslateCTM(context, 40, 260)

    # Stroke a black rectangle that will frame the shading.
    CGContextSetLineWidth(context, 2)
    CGContextSetStrokeColorWithColor(context, Utilities.getRGBOpaqueBlackColor())
    CGContextStrokeRect(context, rect)

    CGContextSaveGState(context)
    if 1:
        # Clip to the rectangle that was just stroked.
        CGContextClipToRect(context, rect)
        # Draw the shading. This paints the shading to
        # the destination context, clipped to rect.
        CGContextDrawShading(context, shading)
        # Release the shading once the code is finished with it.
        del shading
        # Restore the graphics state so that the rectangular
        # clip is no longer present.
    CGContextRestoreGState(context)

    # Prepare for the next shading.
    CGContextTranslateCTM(context, 0, -250)

    # Extend this shading.
    extendStart = extendEnd = True
    shading = CGShadingCreateAxial(Utilities.getTheCalibratedRGBColorSpace(),
                            startPoint, endPoint,
                            redGreenFunction,
                            extendStart, extendEnd)
    # The shading retains the function and this code
    # is done with the function so it should release it.
    del redGreenFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    # Stroke with the current stroke color.
    CGContextStrokeRect(context, rect)

    CGContextSaveGState(context)
    if 1:
        CGContextClipToRect(context, rect)
        # Draw the shading. This paints the shading to
        # the destination context, clipped to rect.
        CGContextDrawShading(context, shading)
    CGContextRestoreGState(context)

    # Now paint some text with a shading.
    CGContextSaveGState(context)
    if 1:
        CGContextTranslateCTM(context, 260, 0)
        CGContextSetTextMatrix(context, CGAffineTransformIdentity)

        # Set the font with the PostScript name "Times-Roman", at
        # 80 points, with the MacRoman encoding.
        CGContextSelectFont(context, "Times-Roman", 80,
                                            kCGEncodingMacRoman)

        # Rotate so that the text characters are rotated
        # relative to the page.
        CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45))
        # Set the text drawing mode to clip so that
        # the characters in the string are intersected with
        # the clipping area.
        CGContextSetTextDrawingMode(context, kCGTextClip)
        CGContextShowTextAtPoint(context, 30, 0, "Shading", 7)

        # At this point nothing has been painted; the
        # glyphs in the word "Shading" have been intersected
        # with the previous clipping area to create a new
        # clipping area.

        # Rotate the coordinate system back so that the
        # shading is not rotated relative to the page.
        CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(-45))

        # Draw the shading, painting the shading
        # to the destination context, clipped by the glyphs.
        CGContextDrawShading(context, shading)

    CGContextRestoreGState(context)
    # Release the shading once the code is finished with it.
    del shading

class MyStartEndColor (object):
    def __init__(self):
        self.startColor = [0.0] * 3
        self.endColor = [0.0] * 3

def StartColorEndColorEvaluate(info, input, output):
    # The domain of this function is 0 - 1. For an input value of 0
    # this function returns the color to paint at the start point
    # of the shading. For an input value of 1 this function returns
    # the color to paint at the end point of the shading. This
    # is a 1 in, 4 out function where the output values correspond
    # to an r,g,b,a color.
    #
    # This function evaluates to produce a blend from startColor to endColor.
    #
    # Note that the returned results are clipped to the range
    # by Quartz so this function doesn't worry about values
    # that are outside the range 0-1.

    # Weight the starting and ending color components depending
    # on what position in the blend the input value specifies.
    return (
        (info.startColor[0]*(1-input[0]) + info.endColor[0]*input[0]),
        (info.startColor[1]*(1-input[0]) + info.endColor[1]*input[0]),
        (info.startColor[2]*(1-input[0]) + info.endColor[2]*input[0]),
        # The alpha component is always 1, the shading is always opaque.
        1,
    )

def createFunctionWithStartEndColorRamp(startColor, endColor):
    # Use a pointer to a MyStartEndColor as a way of
    # parameterizing the color ramp this function produces.
    startEndColorP =  MyStartEndColor()

    # Set up start and end colors in the info structure.
    startEndColorP.startColor[0] = startColor[0]
    startEndColorP.startColor[1] = startColor[1]
    startEndColorP.startColor[2] = startColor[2]

    startEndColorP.endColor[0] = endColor[0]
    startEndColorP.endColor[1] = endColor[1]
    startEndColorP.endColor[2] = endColor[2]

    # This is a 1 in, 4 out function for drawing shadings
    # in a 3 component (plus alpha) color space. Shadings
    # parameterize the endpoints such that the starting point
    # represents the function input value 0 and the ending point
    # represents the function input value 1.
    domain = (0, 1)

    # The range is the range for the output colors. For an rgb
    # color space the values range from 0-1 for the r,g,b, and a
    # components.

    range = (
        # The red component, min and max.
        0, 1,
        # The green component, min and max.
        0, 1,
        # The blue component, min and max.
        0, 1,
        # The alpha component, min and max.
        0, 1,
    )

    # Pass startEndColorP as the info parameter.
    function = CGFunctionCreate(startEndColorP, 1, domain, 4,
                        range, (StartColorEndColorEvaluate, None))

    if function is None:
        print >>sys.stderr, "Couldn't create the CGFunction!"
        return None

    return function

def doSimpleRadialShading(context):
    startColor = [ 0.663, 0.0, 0.031 ] # Red.
    endColor   = [ 1.0,   0.8, 0.4   ] # Light yellow.

    # This function describes a color ramp where the starting color
    # is red and the ending color is blue.
    redYellowFunction = createFunctionWithStartEndColorRamp(
                                        startColor, endColor)
    if redYellowFunction is None:
        return

    CGContextTranslateCTM(context, 120, 120)

    # Circles whose origin is the same.
    circleACenter = CGPoint(x = 0, y = 0)
    circleBCenter = circleACenter

    # The starting circle is inside the ending circle.
    circleARadius = 50
    circleBRadius = 100

    #  Don't extend the shading.
    extendStart = extendEnd = False
    shading = CGShadingCreateRadial(
                Utilities.getTheCalibratedRGBColorSpace(),
                circleACenter, circleARadius,
                circleBCenter, circleBRadius,
                redYellowFunction,
                extendStart, extendEnd)

    del redYellowFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return
    CGContextDrawShading(context, shading)

def doExampleRadialShadings(context):
    magenta   = [ 1,    0, 1    ] # Pure magenta.
    magenta30 = [ 0.3,  0, 0.3  ] # 30% magenta.
    black     = [ 0,    0, 0    ]
    red       = [ 1,    0, 0    ]
    green     = [ 0,    1, 0    ]
    blue      = [ 0,    0, 1    ]
    redgreen  = [ 0.66, 1, 0.04 ] # A red-green shade.

    CGContextTranslateCTM(context, 120, 550)

    # This function describes a color ramp where the starting color
    # is a full magenta, the ending color is 30% magenta.
    magentaFunction = createFunctionWithStartEndColorRamp(
                            magenta, magenta30)
    if magentaFunction is None:
        print >>sys.stderr, "Couldn't create the magenta function!"
        return

    # Shading 1. Circle A is completely inside circle B but with
    # different origins. Circle A has radius 0 which produces
    # a point source.

    # The center of circle A is offset from the origin.
    circleACenter = CGPoint(x=30, y=40)
    # The center of circle B is at the origin.
    circleBCenter = CGPoint(x=0, y=0)

    # A radius of zero produces a point source.
    circleARadius = 0
    circleBRadius = 100

    # Don't extend the shading.
    extendStart = extendEnd = False
    shading = CGShadingCreateRadial(
                Utilities.getTheCalibratedRGBColorSpace(),
                circleACenter, circleARadius,
                circleBCenter, circleBRadius,
                magentaFunction,
                extendStart, extendEnd)
    # Finished with the magenta function so release it.
    del magentaFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextDrawShading(context, shading)
    # Finished with the shading so release it.
    del shading

    # Shading 2. Circle A is completely inside
    # circle B but with different origins.

    # The starting color is red and the ending color is green.
    redGreenFunction = createFunctionWithStartEndColorRamp(
                            red, green)
    if redGreenFunction is None:
        print >>sys.stderr, "Couldn't create the red-Green function!"
        return

    circleACenter.x = 55
    circleACenter.y = 70
    circleBCenter.x = 20
    circleBCenter.y = 0
    circleARadius = 10
    # The outer circle is outside the clipping path so the
    # color at the edge of the shape is not
    # that at the radius of the outer circle.
    circleBRadius = 200
    # Extend the end point of this shading.
    extendStart = False
    extendEnd = True
    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    redGreenFunction,
                    extendStart, extendEnd)
    # Finished with this function so release it.
    del redGreenFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    # Set a clipping area to bound the extend. This code
    # sets a clipping area that corresponds to a circular
    # wedge. The starting circle is inside the clipping
    # area and the ending circle is outside.
    CGContextSaveGState(context)
    if 1:
        CGContextTranslateCTM(context, 250, 0)
        CGContextBeginPath(context)
        CGContextMoveToPoint(context, 25, 0)
        CGContextAddArc(context,
                        25, 0, 130,
                        Utilities.DEGREES_TO_RADIANS(30),
                        Utilities.DEGREES_TO_RADIANS(-30),
                        0)
        CGContextClip(context)
        # Paint the shading.
        CGContextDrawShading(context, shading)
        # Finished with the shading so release it.
        del shading
    CGContextRestoreGState(context)

    CGContextTranslateCTM(context, -40, -250)

    # Shading 3. The starting circle is completely outside
    # the ending circle, no extension. The circles
    # have the same radii.
    circleACenter.x = 0
    circleACenter.y = 0
    circleBCenter.x = 125
    circleBCenter.y = 0

    circleARadius = 50
    circleBRadius = 50

    extendStart = extendEnd = False

    # Create a function that paints a red to black ramp.
    redBlackFunction = createFunctionWithStartEndColorRamp(
                            red, black)
    if redBlackFunction is None:
        print >>sys.stderr, "Couldn't create the red-black function!"
        return

    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    redBlackFunction,
                    extendStart, extendEnd)
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextDrawShading(context, shading)
    # Finished with the shading so release it.
    del shading

    # Shading 4. The starting circle is completely outside
    # the ending circle. The circles have different radii.
    circleACenter.x = 120
    circleACenter.y = 0
    circleBCenter.x = 0
    circleBCenter.y = 0

    circleARadius = 75
    circleBRadius = 30

    # Extend at the start and end.
    extendStart = extendEnd = True
    shading = CGShadingCreateRadial(
                Utilities.getTheCalibratedRGBColorSpace(),
                circleACenter, circleARadius,
                circleBCenter, circleBRadius,
                redBlackFunction,
                extendStart, extendEnd)
    # Finished with this function so release it.
    del redBlackFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextSaveGState(context)
    if 1:
        CGContextTranslateCTM(context, 270, 0)
        # Clip to an elliptical path so the shading
        # does not extend to infinity at the larger end.
        CGContextBeginPath(context)
        Utilities.myCGContextAddEllipseInRect(context,
                        CGRectMake(-200, -200, 450, 400))
        CGContextClip(context)
        CGContextDrawShading(context, shading)
        # Finished with the shading so release it.
        del shading
    CGContextRestoreGState(context)

    CGContextTranslateCTM(context, 30, -200)

    # The starting color is blue, the ending color is a red-green color.
    blueGreenFunction = createFunctionWithStartEndColorRamp(
                            blue, redgreen)
    if blueGreenFunction is None:
        print >>sys.stderr, "Couldn't create the blue-Green function!"
        return

    # Shading 5. The circles partially overlap and have
    # different radii with the larger circle at the start.
    circleACenter.x = 0
    circleACenter.y = 0
    circleBCenter.x = 90
    circleBCenter.y = 30

    circleARadius = 75
    circleBRadius = 45

    extendStart = extendEnd = False
    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    blueGreenFunction,
                    extendStart, extendEnd)
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextDrawShading(context, shading)
    # Finished with the shading so release it.
    del shading

    CGContextTranslateCTM(context, 200, 0)

    # Shading 6. The circles partially overlap and have
    # different radii with the larger circle at the end.

    circleARadius = 45
    circleBRadius = 75
    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    blueGreenFunction,
                    extendStart, extendEnd)
    # Finished with this function so release it.
    del blueGreenFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextDrawShading(context, shading)

def doEllipseShading(context):
    black = [ 0, 0, 0 ]
    red   = [ 1, 0, 0 ]

    # This function describes a color ramp where the starting color
    # is red, the ending color is black.
    redBlackFunction = createFunctionWithStartEndColorRamp(
                            red, black)
    if redBlackFunction is None:
        print >>sys.stderr, "Couldn't create the red-black function!"
        return

    CGContextTranslateCTM(context, 100, 300)
    # Shading 1.
    #   To obtain an elliptical shading requires that user space
    #   at the time the shading is painted is transformed so that
    #   the circles which define the radial shading geometry are
    #   rotated and elliptical. User space will be rotated
    #   by 45 degrees, then scaled by 1 in x and 2 in y to produce
    #   the ellipses.

    # Compute the transform needed to create the rotated ellipses.
    t = CGAffineTransformMakeRotation(Utilities.DEGREES_TO_RADIANS(45))
    t = CGAffineTransformScale(t, 1, 2)

    circleACenter = CGPoint(x=0, y=0)
    circleBCenter = CGPoint(x=circleACenter.x + 144, y=circleACenter.y)
    circleARadius = 45
    circleBRadius = 45

    # Don't extend this shading.
    extendStart = extendEnd = False

    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    redBlackFunction,
                    extendStart, extendEnd)
    if shading is None:
        # Couldn't create the shading so release
        # the function before returning.
        print >>sys.stderr, "Couldn't create the shading!"
        return

    CGContextSaveGState(context)
    if 1:
        # Transform coordinates for the drawing of the shading.
        # This transform produces the rotated elliptical shading.
        # This produces the left shading in the figure, the
        # one where both the ellipses and the shading are
        # rotated relative to default user space.
        CGContextConcatCTM(context, t)

        CGContextDrawShading(context, shading)
        del shading
    CGContextRestoreGState(context)

    CGContextTranslateCTM(context, 300, 10)


    # Shading 2.
    #    Now draw the shading where the shading ellipses are
    #    rotated but the axis between the origins of
    #    the ellipses lies parallel to the x axis in default
    #    user space. This is similar to the shading drawn
    #    manually in Chapter 5.
    #
    #    To compute the correct origins for the shading,
    #    the code needs to compute the points that,
    #    transformed by the matrix t used to paint the shading,
    #    produce the desired coordinates. We want coordinates
    #    that are transformed as follows:
    #
    #            P' = P x t
    #
    #    where P' is the point in untransformed user space that
    #    we want as the origin, P is the point in transformed
    #    user space that will be transformed by t, the matrix
    #    which transforms the circles into rotated ellipses.
    #
    #    So we want to calculate P such that P' = P x t .
    #
    #    Notice that if P = P' x Inverse(t) then:
    #
    #    P' = P' x Inverse(t) x t = P' x Identity = P'.
    #
    #    This means that we can calculate the point P
    #    by computing P' x Inverse(t).

    inverseT = CGAffineTransformInvert(t)
    # Now the code can transform the coordinates through the
    # inverse transform to compute the new coordinates. These
    # coordinates, when transformed with the transform t,
    # produce the original coordinate.
    circleACenter = CGPointApplyAffineTransform(circleACenter, inverseT)
    circleBCenter = CGPointApplyAffineTransform(circleBCenter, inverseT)

    shading = CGShadingCreateRadial(
                    Utilities.getTheCalibratedRGBColorSpace(),
                    circleACenter, circleARadius,
                    circleBCenter, circleBRadius,
                    redBlackFunction,
                    extendStart, extendEnd)
    # The code is finished with the function so release it.
    del redBlackFunction
    if shading is None:
        print >>sys.stderr, "Couldn't create the shading!"
        return

    # Transform coordinates for the drawing of the shading.
    # This transform produces the rotated elliptical shading.
    CGContextConcatCTM(context, t)

    CGContextDrawShading(context, shading)

ShadowsAndTransparencyLayers.py

from Quartz import *

import Utilities


def scaleShadowOffset(offset):
    shadowScaling = Utilities.getScalingFactor()
    # Adjust the shadow offset if scaling to export as bits. This is
    # equivalent to scaling base space by the scaling factor.
    if shadowScaling != 1.0:
        offset = CGSizeApplyAffineTransform(offset,
                    CGAffineTransformMakeScale(shadowScaling, shadowScaling))
    return offset


def createTrianglePath(context):
    CGContextBeginPath(context)
    CGContextMoveToPoint(context, 0, 0)
    CGContextAddLineToPoint(context, 50, 0)
    CGContextAddLineToPoint(context, 25, 50)
    CGContextClosePath(context)

def drawSimpleShadow(context):
    r = CGRectMake(20, 20, 100, 200)

    CGContextTranslateCTM(context, 20, 300)

    # A blur of 0 is a hard edge blur.
    blur = 0
    # An offset where both components are negative casts a shadow to the
    # left and down from the object. The coordinate system for the offset
    # is base space, not current user space.
    offset = CGSize(-7, -7)
    offset = scaleShadowOffset(offset)

    # Set the shadow in the context.
    CGContextSetShadow(context, offset, blur)

    # Object 1.
    # Paint a rectangle.
    CGContextFillRect(context, r)

    # Object 2.
    CGContextTranslateCTM(context, 150, 0)
    # A blur of 3 is a soft blur more
    # appropriate for a shadow effect.
    blur = 3
    CGContextSetShadow(context, offset, blur)

    # Fill an ellipse to the right of the rect.
    CGContextBeginPath(context)
    Utilities.myCGContextAddEllipseInRect(context, r)
    CGContextFillPath(context)

    # Object 3.
    CGContextTranslateCTM(context, -130, -140)
    # Scale the coordinate system but the shadow is not affected. The offset
    # is in the base space of the context. Typically it looks best if the shapes
    # have a uniform shadow regardless of how the shapes were created, scaled,
    # rotated, or otherwise transformed.
    CGContextScaleCTM(context, 2, 2)
    createTrianglePath(context)
    CGContextSetStrokeColorWithColor(context, Utilities.getRGBOpaqueRedColor())

    CGContextSetLineWidth(context, 5)
    # Stroking produces a shadow as well.
    CGContextStrokePath(context)

    # Object 4.
    CGContextTranslateCTM(context, 75, 0)
    createTrianglePath(context)
    # Cast the shadow to the left and up from
    # the shape painted.
    offset.width = -5
    offset.height = +7
    offset = scaleShadowOffset(offset)

    # The shadow can be colored. Create a CGColorRef
    # that represents a red color with opacity of 0.3333...
    shadowColor = CGColorCreateCopyWithAlpha(Utilities.getRGBOpaqueRedColor(), 1.0/3.0)

    CGContextSetShadowWithColor(context, offset, blur, shadowColor)
    CGContextStrokePath(context)

    # Object 5. Three stroked circles.
    CGContextTranslateCTM(context, -75, -65)
    # Set a black shadow offset at -7,-7.
    offset.width = -7
    offset.height = -7

    offset = scaleShadowOffset(offset)

    CGContextSetShadow(context, offset, blur)
    # Draw a set of three circles side by side.
    CGContextBeginPath(context)
    CGContextSetLineWidth(context, 3)
    r = CGRectMake(30, 20, 20, 20)
    Utilities.myCGContextAddEllipseInRect(context, r)
    r = CGRectOffset(r, 20, 0)
    Utilities.myCGContextAddEllipseInRect(context, r)
    r = CGRectOffset(r, 20, 0)
    Utilities.myCGContextAddEllipseInRect(context, r)
    CGContextStrokePath(context)


def doShadowScaling(context):
    offset = CGSize(-7, -7)
    blur = 3

    CGContextTranslateCTM(context, 20, 220)
    CGContextSetShadow(context, scaleShadowOffset(offset), blur)

    # Object 1
    # Draw a triangle filled with black and shadowed with black.
    createTrianglePath(context)
    CGContextFillPath(context)

    # Object 2
    # Scaling without changing the shadow doesn't impact
    # the shadow offset or blur.
    t = CGAffineTransformMakeScale(2, 2)
    CGContextConcatCTM(context, t)
    CGContextTranslateCTM(context, 40, 0)
    createTrianglePath(context)
    CGContextFillPath(context)

    # Object 3
    # By transforming the offset you can transform the shadow.
    # This may be desirable if you are drawing a zoomed view.
    offset = CGSizeApplyAffineTransform(offset, t)
    CGContextSetShadow(context, scaleShadowOffset(offset), blur)
    CGContextTranslateCTM(context, 70, 0)
    createTrianglePath(context)
    CGContextFillPath(context)


def drawFillAndStrokeWithShadow(context):
    r = CGRectMake(60, 60, 100, 100)
    offset = CGSize(-7, -7)
    blur = 3

    # Set the shadow.
    CGContextSetShadow(context, scaleShadowOffset(offset), blur)

    CGContextSetFillColorWithColor(context, Utilities.getRGBOpaqueOrangeColor())

    # Draw the graphic on the left.
    CGContextBeginPath(context)
    Utilities.myCGContextAddEllipseInRect(context, r)
    CGContextDrawPath(context, kCGPathFillStroke)

    # Draw the graphic on the right.
    r = CGRectOffset(r, 125, 0)
    # Begin the transparency layer.
    CGContextBeginTransparencyLayer(context, None)
    if 1:
        Utilities.myCGContextAddEllipseInRect(context, r)
        CGContextDrawPath(context, kCGPathFillStroke)
    # End the transparency layer.
    CGContextEndTransparencyLayer(context)

def drawColoredLogo(context):
    r = CGRectMake(0, 0, 100, 100)
    CGContextSaveGState(context)
    if 1:
        # Position the center of the rectangle on the left.
        CGContextTranslateCTM(context, 140, 140)
        # Rotate so that the rectangles are rotated 45 degrees
        # about the current coordinate origin.
        CGContextRotateCTM(context, Utilities.DEGREES_TO_RADIANS(45))
        # Translate so that the center of the rect is at the previous origin.
        CGContextTranslateCTM(context,
                -r.size.width/2, -r.size.height/2)
        # Set the fill color to a purple color.
        CGContextSetFillColorWithColor(context,
                Utilities.getRGBOpaquePurpleColor())
        # Fill the first rectangle.
        CGContextFillRect(context, r)
        # Position to draw the right-most rectangle.
        CGContextTranslateCTM(context, 60, -60)
        # Set the fill color to a yellow color.
        CGContextSetFillColorWithColor(context,
                Utilities.getRGBOpaqueYellowColor())
        CGContextFillRect(context, r)

        # Position for the center rectangle.
        CGContextTranslateCTM(context, -30, +30)
        # Set the stroke color to an orange color.
        CGContextSetStrokeColorWithColor(context,
                Utilities.getRGBOpaqueOrangeColor())
        # Stroke the rectangle with a linewidth of 12.
        CGContextStrokeRectWithWidth(context, r, 12)
    CGContextRestoreGState(context)

def showComplexShadowIssues(context):
    offset = CGSize(-6, -6)
    blur = 3

    # Set the shadow.
    CGContextSetShadow(context, scaleShadowOffset(offset), blur)
    # Draw the colored logo.
    drawColoredLogo(context)

def showComplexShadow(context):
    offset = CGSize(-6, -6)
    blur = 3

    # Set the shadow.
    CGContextSetShadow(context, scaleShadowOffset(offset), blur)

    # Begin a transparency layer. A snapshot is made of the graphics state and
    # the shadow parameter is temporarily reset to no shadow, the blend mode
    # is set to Normal, and the global alpha parameter is set to 1.0.
    #
    # All drawing that occurs after CGContextBeginTransparencyLayer but before
    # CGContextEndTransparencyLayer is collected together and when
    # CGContextEndTransparencyLayer is called, Quartz composites the collected
    # drawing to the context, using the global alpha, blend mode, and shadow
    # that was in effect when CGContextBeginTransparencyLayer was called.

    CGContextBeginTransparencyLayer(context, None)
    # Draw the colored logo.
    drawColoredLogo(context)

    # Ending the transparency layer causes all drawing in the transparency
    # layer to be composited with the global alpha, blend mode, and shadow
    # in effect at the time CGContextBeginTransparencyLayer was called.  The
    # graphics state is restored to that in effect when
    # CGContextBeginTransparencyLayer was called.

    # This restores the graphics state to that in effect
    # at the last call to CGContextBeginTransparencyLayer.
    CGContextEndTransparencyLayer(context)

def doLayerCompositing(context):
    r = CGRectMake(40, 50, 142, 180)
    # Object 1.
    CGContextTranslateCTM(context, 20, 20)
    CGContextSetFillColorWithColor(context, Utilities.getRGBOpaqueGreenColor())
    # Draw a green background.
    CGContextFillRect(context, r)
    # Draw the colored logo.
    drawColoredLogo(context)

    # Object 2.
    CGContextTranslateCTM(context, 300, 0)
    CGContextSetFillColorWithColor(context, Utilities.getRGBOpaqueGreenColor())
    # Draw a green background.
    CGContextFillRect(context, r)

    # Draw the rectangles with opacity 0.75.
    CGContextSetAlpha(context, 0.75)

    drawColoredLogo(context)

    # Object 3.
    CGContextTranslateCTM(context, 300, 0)
    # Set the alpha to 1.0 for drawing the background.
    CGContextSetAlpha(context, 1.0)
    CGContextSetFillColorWithColor(context, Utilities.getRGBOpaqueGreenColor())
    CGContextFillRect(context, r)
    # Draw the rectangles with opacity 0.75.
    CGContextSetAlpha(context, 0.75)
    # Begin a transparency layer. Drawing collected in
    # this transparency layer will be composited with an
    # alpha value of 0.75 when the transparency layer is ended.
    CGContextBeginTransparencyLayer(context, None)
    if 1:
    # Draw the colored logo into the transparency layer.
        drawColoredLogo(context)

    # Ending the transparency layer causes the drawing
    # to then be composited with the global alpha value
    # in effect when CGContextBeginTransparencyLayer was called.
    CGContextEndTransparencyLayer(context)

def shadowPDFDocument(context, url):
    pdfDoc = CGPDFDocumentCreateWithURL(url)
    offset = CGSize(-7, -7)

    if pdfDoc is None:
        print >>sys.stderr, "Couldn't create PDF document reference!"
        return

    r = CGPDFDocumentGetMediaBox(pdfDoc, 1)
    r.origin.x = 20
    r.origin.y = 20

    # Set the shadow.
    CGContextSetShadow(context, scaleShadowOffset(offset), 3)

    # On Tiger and later, there is no need to use
    # a transparency layer to draw a PDF document as
    # a grouped object. On Panther, you can do so
    # by using a transparency layer. Drawing collected in
    # this transparency layer is drawn with the shadow
    # when the layer is ended.
    CGContextBeginTransparencyLayer(context, None)
    if 1:
        CGContextDrawPDFDocument(context, r, pdfDoc, 1)

    CGContextEndTransparencyLayer(context)

UIHandling.py

# ***    Drawing Basics ***

kHICommandSimpleRect            = 1000
kHICommandStrokedRect           = 1001
kHICommandStrokedAndFilledRect  = 1002
kHICommandPathRects             = 1003
kHICommandAlphaRects            = 1004
kHICommandDashed                = 1005
kHICommandSimpleClip            = 1006
kHICommandPDFDoc                = 1007

# ***    Coordinate System ***
kHICommandRotatedEllipses       = 1008
kHICommandDrawSkewCoordinates   = 1082

# ***    Path Drawing ***
kHICommandBezierEgg                 = 1009
kHICommandRoundedRects              = 1010
kHICommandStrokeWithCTM             = 1011
kHICommandRotatedEllipsesWithCGPath = 1012
kHICommandPixelAligned              = 1099

# ***    Color and GState ***
kHICommandDeviceFillAndStrokeColor  = 1013
kHICommandCLUTDrawGraphics          = 1014
kHICommandDrawWithGlobalAlpha       = 1015
kHICommandDrawWithBlendMode         = 1068
kHICommandDrawWithColorRefs         = 1016
kHICommandFunctionsHaveOwnGSave     = 1017

# ***    Images ***
kHICommandDrawJPEGImage                 = 1018
kHICommandColorImageFromFile            = 1019
kHICommandColorImageFromData            = 1020
kHICommandColorImageFromCallbacks       = 1021
kHICommandGrayRamp                      = 1022
kHICommandDrawWithCGImageSource         = 1023
kHICommandDrawWithCGImageSourceIncremental = 1024
kHICommandDrawWithQuickTime             = 1025
kHICommandSubstituteImageProfile        = 1026
kHICommandDoSubImage                    = 1027
kHICommandExportWithQuickTime           =  1028

# ***    Image Masking ***
kHICommandMaskTurkeyImage               = 1029
kHICommandImageMaskedWithMask           = 1030
kHICommandImageMaskedWithGrayImage      = 1031
kHICommandMaskImageWithColor            = 1033
kHICommandClipToMask                    = 1080
kHICommandExportWithCGImageDestination  = 1034

# *** Bitmap Graphics Context and CGLayerRef ***
kHICommandSimpleCGLayer                 = 1090
kHICommandAlphaOnlyContext              = 1091
kHICommandDrawNoOffScreenImage          = 1035
kHICommandDrawOffScreenImage            = 1036
kHICommandDrawWithLayer                 = 1037

# ***    Text ***
kHICommandQuartzRomanText               = 1038
kHICommandQuartzTextModes               = 1039
kHICommandQuartzTextMatrix              = 1040

kHICommandDrawNSString                  = 1041
kHICommandDrawNSLayoutMgr               = 1042
kHICommandDrawCustomNSLayoutMgr         = 1043

# ***    Advanced Drawing ***
kHICommandSimplePattern                 = 1050
kHICommandPatternMatrix                 = 1051
kHICommandPatternPhase                  = 1052
kHICommandUncoloredPattern              = 1053
kHICommandDrawWithPDFPattern            = 1054

kHICommandSimpleShadow                  = 1055
kHICommandShadowScaling                 = 1056
kHICommandShadowProblems                = 1057
kHICommandComplexShadow                 = 1058

kHICommandMultipleShapeComposite        = 1059
kHICommandFillAndStrokeWithShadow       = 1085
kHICommandPDFDocumentShadow             = 1060

kHICommandSimpleAxialShading            = 1061
kHICommandExampleAxialShadings          = 1062
kHICommandSimpleRadialShading           = 1063
kHICommandExampleRadialShadings         = 1064
kHICommandEllipseShading                = 1065

# *** EPS drawing ***
kHICommandDoCompatibleEPS               = 1066

Utilities.py

import math

from Quartz import *
import Quartz
from CoreFoundation import *

class ExportInfo (object):
    command = None
    fileType = None
    useQTForExport = False
    dpi = 1

def DEGREES_TO_RADIANS(degrees):
    return degrees * math.pi / 180


gScalingFactor = 1.0

# These routines are used for getting the correct results when
# drawing shadows and patterns with Quartz and exporting the
# results as bits. This is a hack; in principle the scaling
# factor should be passed to the draw proc.
def setScalingFactor(scalingFactor):
    if scalingFactor > 0:
        gScalingFactor = scalingFactor

def getScalingFactor():
    return gScalingFactor

_appBundle = None
def getAppBundle():
    global _appBundle

    if _appBundle is None:
        _appBundle = CFBundleGetMainBundle()

    return _appBundle


#
#    This version of getTheRGBColorSpace returns
#    the DeviceRGB color space.
#
_deviceRGB = None
def getTheRGBColorSpace():
    global _deviceRGB

    # Set once, the first time this function is called.
    if _deviceRGB is None:
        _deviceRGB = CGColorSpaceCreateDeviceRGB()

    return _deviceRGB


_genericRGBColorSpace = None
def getTheCalibratedRGBColorSpace():
    global _genericRGBColorSpace

    if _genericRGBColorSpace is None:
        _genericRGBColorSpace = CGColorSpaceCreateWithName(
                kCGColorSpaceGenericRGB)

    return _genericRGBColorSpace

_genericGrayColorSpace = None
def getTheCalibratedGrayColorSpace():
    global _genericGrayColorSpace

    if _genericGrayColorSpace is None:
        _genericGrayColorSpace = CGColorSpaceCreateWithName(
                kCGColorSpaceGenericGray)
    return _genericGrayColorSpace


_genericSRGBColorSpace = None
def getTheSRGBColorSpace():
    # This only works on 10.5 or later
    global _genericSRGBColorSpace

    if _genericSRGBColorSpace is None:
        _genericSRGBColorSpace = CGColorSpaceCreateWithName(
                kCGColorSpaceGenericRGB) # XXX: should be GenericSRGB
    return _genericSRGBColorSpace

def getTheDisplayColorSpace():
    # This is a hack, basicly here because the C implementation uses APIs that
    # aren't wrapped yet.
    return getTheRGBColorSpace()


_rgbWhite = None
def getRGBOpaqueWhiteColor():
    global _rgbWhite

    if _rgbWhite is None:
        opaqueWhite = (1.0, 1.0, 1.0, 1.0)
        _rgbWhite = CGColorCreate(getTheCalibratedRGBColorSpace(), opaqueWhite)
    return _rgbWhite

_rgbBlack = None
def getRGBOpaqueBlackColor():
    global _rgbBlack
    if _rgbBlack is None:
        opaqueBlack = (0, 0, 0, 1)
        _rgbBlack = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueBlack)
    return _rgbBlack

_rgbGray = None
def getRGBOpaqueGrayColor():
    global _rgbGray
    if _rgbGray is None:
        opaqueGray = (0.9, 0.9, 0.9, 1)
        _rgbGray = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueGray)
    return _rgbGray

_rgbRed = None
def getRGBOpaqueRedColor():
    global _rgbRed
    if _rgbRed is None:
        opaqueRed = (0.663, 0, 0.031, 1)
        _rgbRed = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueRed)
    return _rgbRed

_rgbBlue = None
def getRGBOpaqueBlueColor():
    global _rgbBlue
    if _rgbBlue is None:
        opaqueBlue = (0.482, 0.62, 0.871, 1)
        _rgbBlue = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueBlue)
    return _rgbBlue

_rgbPurple = None
def getRGBOpaquePurpleColor():
    global _rgbPurple
    if _rgbPurple is None:
        opaquePurple = (0.69, 0.486, 0.722, 1)
        _rgbPurple = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaquePurple)
    return _rgbPurple

_rgbDarkBlue = None
def getRGBOpaqueDarkBlueColor():
    global _rgbDarkBlue
    if _rgbDarkBlue is None:
        opaqueDarkBlue = (0.11, 0.208, 0.451, 1)
        _rgbDarkBlue = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueDarkBlue)
    return _rgbDarkBlue

_rgbBrown = None
def getRGBOpaqueBrownColor():
    global _rgbBrown
    if _rgbBrown is None:
        opaqueBrown = (0.325, 0.208, 0.157, 1)
        _rgbBrown = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueBrown)
    return _rgbBrown

_rgbOrange = None
def getRGBOpaqueOrangeColor():
    global _rgbOrange
    if _rgbOrange is None:
        opaqueOrange = (0.965, 0.584, 0.059, 1)
        _rgbOrange = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueOrange)
    return _rgbOrange

_rgbYellow = None
def getRGBOpaqueYellowColor():
    global _rgbYellow
    if _rgbYellow is None:
        opaqueYellow = (1, 0.816, 0, 1)
        _rgbYellow = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueYellow)
    return _rgbYellow

_rgbGreen = None
def getRGBOpaqueGreenColor():
    global _rgbGreen
    if _rgbGreen is None:
        opaqueGreen = (0.584, 0.871, 0.318, 1)
        _rgbGreen = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueGreen)
    return _rgbGreen

_rgbDarkGreen = None
def getRGBOpaqueDarkGreenColor():
    global _rgbDarkGreen
    if _rgbDarkGreen is None:
        opaqueDarkGreen = (0.404, 0.808, 0.239, 1)
        _rgbDarkGreen = CGColorCreate(
                getTheCalibratedRGBColorSpace(), opaqueDarkGreen)
    return _rgbDarkGreen

def myCGContextAddEllipseInRect(context, r):
    if hasattr(Quartz, 'CGContextAddEllipseInRect'):
        CGContextAddEllipseInRect(context, r)

    else:
        # This is not a perfect emulation but is correct as long as there is
        # not an open subpath already in the current path. In that case the
        # CGContextClosePath here would not necessarily produce the desired
        # result.
        CGContextSaveGState(context)
        if 1:
        # Translate to the center of the ellipse.
            CGContextTranslateCTM(context,
                            CGRectGetMidX(r),
                            CGRectGetMidY(r))
            # Scale by half the width and height of the rectangle
            # bounding the ellipse.
            CGContextScaleCTM(context, r.size.width/2, r.size.height/2)
            # Establish a current point at the first point
            # on the ellipse. This ensures that there
            # is no line segment connecting the previous
            # current point to the first point on the subpath.
            CGContextMoveToPoint(context, 1, 0)
            # Circular arc around the ellipse center with
            # a radius that, when scaled by the CTM, produces
            # the major and minor axes of the ellipse. Since
            # CGContextAddEllipseInRect defines the direction
            # of the path as clockwise, this routine will
            # draw the arc clockwise also.
            CGContextAddArc(context, 0, 0, 1, 0, 2*math.pi, 1)
            CGContextClosePath(context)
        CGContextRestoreGState(context)

# Routines that are useful for debugging.

def drawPoint(context, p):
    CGContextSaveGState(context)
    if 1:
        # Opaque black.
        CGContextSetRGBStrokeColor(context, 0, 0, 0, 1)
        CGContextSetLineWidth(context, 5)
        CGContextSetLineCap(context, kCGLineCapRound)
        CGContextMoveToPoint(context, p.x, p.y)
        CGContextAddLineToPoint(context, p.x, p.y)
        CGContextStrokePath(context)
    CGContextRestoreGState(context)


def printCTM(context):
    t = CGContextGetCTM(context)
    print >>sys.stderr, "CurrentCTM is %r"%(t,)

kTickLength = 5
kTickDistance = 72
kAxesLength = (20*kTickDistance)

def drawCoordinateAxes(context):
    tickLength = kTickLength

    CGContextSaveGState(context)
    if 1:
        CGContextBeginPath(context)
        # Paint the x-axis in red.
        CGContextSetRGBStrokeColor(context, 1, 0, 0, 1)
        CGContextMoveToPoint(context, -kTickLength, 0.)
        CGContextAddLineToPoint(context, kAxesLength, 0.)
        CGContextDrawPath(context, kCGPathStroke)

        # Paint the y-axis in blue.
        CGContextSetRGBStrokeColor(context, 0, 0, 1, 1)
        CGContextMoveToPoint(context, 0, -kTickLength)
        CGContextAddLineToPoint(context, 0, kAxesLength)
        CGContextDrawPath(context, kCGPathStroke)

        # Paint the x-axis tick marks in red.
        CGContextSetRGBStrokeColor(context, 1, 0, 0, 1)
        for i in range(2):
            for t in range(0, kAxesLength, kTickDistance):
                CGContextMoveToPoint(context, t, -tickLength)
                CGContextAddLineToPoint(context, t, tickLength)

            CGContextDrawPath(context, kCGPathStroke)
            CGContextRotateCTM(context, math.pi/2.)
            # Paint the y-axis tick marks in blue.
            CGContextSetRGBStrokeColor(context, 0, 0, 1, 1)

        drawPoint(context, CGPointZero)
    CGContextRestoreGState(context)

def drawDebuggingRect(context, rect):
    CGContextSaveGState(context)
    if 1:
        CGContextSetLineWidth(context, 4.)
        # Draw opaque red from top-left to bottom-right.
        CGContextSetRGBStrokeColor(context, 1, 0, 0, 1.0)
        CGContextMoveToPoint(context, rect.origin.x,
                                        rect.origin.y + rect.size.height)
        CGContextAddLineToPoint(context,
                                        rect.origin.x + rect.size.width,
                                        rect.origin.y)
        CGContextStrokePath(context)
        # Draw opaque blue from top-right to bottom-left.
        CGContextSetRGBStrokeColor(context, 0, 0, 1, 1.0)
        CGContextMoveToPoint(context, rect.origin.x + rect.size.width,
                                        rect.origin.y + rect.size.height)
        CGContextAddLineToPoint(context, rect.origin.x, rect.origin.y)
        CGContextStrokePath(context)
        # Opaque black.
        CGContextSetRGBStrokeColor(context, 0, 0, 0, 1.)
        CGContextStrokeRect(context, rect)
    CGContextRestoreGState(context)

main.py

from PyObjCTools import NibClassBuilder, AppHelper

NibClassBuilder.extractClasses("MainMenu")

# Make sure all code is loaded
import AppDrawing
import BitmapContext
import ColorAndGState
import CoordinateSystem
import DataProvidersAndConsumers
import DrawingBasics
import EPSPrinting
import FrameworkTextDrawing
import FrameworkUtilities
import ImageMasking
import Images
import MyAppController
import MyView
import PDFHandling
import PathDrawing
import PatternDrawing
import QuartzTextDrawing
import Shadings
import ShadowsAndTransparencyLayers
import Utilities

import objc; objc.setVerbose(True)

AppHelper.runEventLoop()

setup.py

"""
Script for building the example.

Usage:
    python setup.py py2app
"""
from distutils.core import setup
import py2app
import os

setup(
    name='BasicDrawing',
    app=["main.py"],
    data_files=["English.lproj"] + [ os.path.join('GraphicsFiles', fn) for fn in os.listdir('GraphicsFiles') ],
)

Resources

• Download example