CP_Graphics_Imp_Quartz Class Reference

CP_Graphics_Imp subclass to perform drawing using Quartz. More...

Inheritance diagram for CP_Graphics_Imp_Quartz:

List of all members.


Public Member Functions
Getters
virtual float	GetLineWidth ()
virtual float	GetAlpha ()
virtual CP_ARGBColor	GetStrokeColor ()
virtual CP_ARGBColor	GetFillColor ()
CP_Canvas	GetCanvas ()
Constructor / Destructor
	CP_Graphics_Imp_Quartz (CP_Canvas &inDestCanvas, bool inSynchronizeWithPort=true)
	Constructor.
virtual	~CP_Graphics_Imp_Quartz ()
	Destructor.
Context
CGContextRef	GetCGContext ()
Setters
virtual void	SetAlpha (float inAlpha)
virtual void	SetLineWidth (float lineWidth)
virtual void	SetLineJoin (CP_E_GraphicsLineJoin inLineJoin)
virtual void	SetLineCap (CP_E_GraphicsLineCap inLineCap)
virtual void	SetStrokeColor (CP_ARGBColor &inStrokeColor)
virtual void	SetFillColor (CP_ARGBColor &inFillColor)
Graphics State
virtual void	SaveState ()
virtual void	RestoreState ()
virtual void	ScaleCTM (float inHorAmt, float inVerAmt)
virtual void	TranslateCTM (float inHorAmt, float inVerAmt)
virtual void	RotateCTM (float inAngle)
Arcs
virtual void	StrokeArc (float inHorCenter, float inVerCenter, float inRadius, float inStartAngle, float inEndAngle)
virtual void	FillArc (float inHorCenter, float inVerCenter, float inRadius, float inStartAngle, float inEndAngle)
Bezier Curves
virtual void	StrokeBezier (const CP_Point &inStartPoint, const CP_Point &inControlPointOne, const CP_Point &inControlPointTwo, const CP_Point &inEndPoint)
virtual void	StrokeQuadBezier (const CP_Point &inStartPoint, const CP_Point &inControlPointOne, const CP_Point &inEndPoint)
Gradient
virtual void	DrawGradient (CP_E_GradientType inGradientType, CP_Rect &inDestBounds)
virtual void	SetGradientAngle (SInt16 inAngle)
virtual void	SetGradientColor (const SInt16 inIndex, const CP_ARGBColor &inColour)
virtual void	SetGradientCount (SInt16 inGradientCount)
Icons
virtual void	DrawIcon (const CP_Rect &inBounds, CP_E_IconStyle inIconType, SInt16 inIconID)
virtual void	DrawIcon (CP_OSIcon &inPicture, const CP_Rect &inBounds)
Images
virtual void	DrawImage (SInt16 inImageResID, CP_Rect &inDestBounds)
virtual void	DrawImage (const CP_FileSystemSpec &inImageSpec, CP_Rect &inDestBounds)
virtual void	DrawImage (const CP_FileSystemSpec &inImageSpec, CP_Rect &inSourceBounds, CP_Rect &inDestBounds)
Lines
virtual void	Line (const CP_Point &inPoint, const CP_Size &inSize)
virtual void	Line (float inStartHorLocation, float inStartVerLocation, float inEndHorLocation, float inEndVerLocation)
Paths
virtual void	BeginPath ()
virtual void	ClosePath ()
virtual void	StrokePath ()
virtual void	FillPath ()
virtual void	DrawPath (CP_E_PathDrawingMode inPathDrawMode)
virtual void	PathMoveTo (const CP_Point &inPoint)
virtual void	PathMoveTo (float inHorLocation, float inVerLocation)
virtual void	PathAddLineTo (const CP_Point &inPoint)
virtual void	PathAddLines (const CP_Point inPoint[], SInt16 inNumberPoints)
virtual void	PathAddLine (const CP_Point &inStartPoint, const CP_Point &inEndPoint)
virtual void	PathAddLine (float inStartH, float inStartV, float inEndH, float inEndV)
virtual void	PathAddRect (const CP_Rect &inBounds)
virtual void	PathAddBezier (const CP_Point &inStartPoint, const CP_Point &inControlPointOne, const CP_Point &inControlPointTwo, const CP_Point &inEndPoint)
virtual void	PathAddQuadBezier (const CP_Point &inStartPoint, const CP_Point &inControlPointOne, const CP_Point &inEndPoint)
virtual void	PathAddArc (float x, float y, float radius, float startAngle, float endAngle, SInt16 clockwise)
virtual void	PathAddArcToPoint (float x1, float y1, float x2, float y2, float radius)
virtual void	PathAddOval (const CP_Rect &inBounds)
virtual void	PathAddPoly (CP_Point_Array &inPoints)
virtual void	ClipPath ()
Polygons
virtual void	StrokePoly (CP_Point_Array &inPoints)
virtual void	FillPoly (CP_Point_Array &inPoints)
Rects
virtual void	StrokeRect (const CP_Rect &inBounds)
virtual void	FillRect (const CP_Rect &inBounds)
Regions
virtual void	StrokeRegion (const CP_Region &inRegion)
virtual void	FillRegion (const CP_Region &inRegion)
Round Rects
virtual void	StrokeRoundRect (const CP_Rect &inBounds, SInt16 inHorRadius, SInt16 inVerRadius)
virtual void	FillRoundRect (const CP_Rect &inBounds, SInt16 inHorRadius, SInt16 inVerRadius)
Oval
virtual void	StrokeOval (const CP_Rect &inBounds)
virtual void	FillOval (const CP_Rect &inBounds)
Text
virtual void	DrawString (CP_FontSpec &inFontSpec, const CP_String &inText, const CP_Point &inStartPoint)
virtual void	DrawQuartzString (CP_FontSpec &inFontSpec, const CP_String &inText, const CP_Point &inStartPoint)
virtual void	DrawText (CP_FontSpec &inFontSpec, const CP_String &inText, const CP_Rect &inBounds, SInt16 inHorAlign=CP_E_TextAlign_HorLeft, SInt16 inVerAlign=CP_E_TextAlign_VerTop, bool inWrapText=true)
virtual void	DrawTrunc (CP_FontSpec &inFontSpec, const CP_String &inText, const CP_Rect &inBounds, SInt16 inHorAlign=CP_E_TextAlign_HorLeft, SInt16 inVerAlign=CP_E_TextAlign_VerTop)
Getters
virtual float	GetLineWidth ()
virtual float	GetAlpha ()
virtual CP_ARGBColor	GetStrokeColor ()
virtual CP_ARGBColor	GetFillColor ()
CP_Canvas	GetCanvas ()
State
virtual void	SkewCTM (float, float)
Gradient
virtual void	SetGradientColor (const SInt16, const CP_ARGBColor &)
Images
virtual void	DrawPicture (CP_OSPicture &, const CP_Rect &)
Paths
virtual void	FillPath (CP_Pattern &)
virtual void	PathAddLines (const CP_Point[], SInt16)
Rects
virtual void	EraseRect (const CP_Rect &)
Text
virtual void	SetTextRenderingFlags (SInt16)
Protected Attributes
CGContextRef	fContextRef
CFBundleRef	fAppServicesFrameworkBundle
CGContextSetAlphaFuncPtr	fSetAlphaFP
CGContextSetLineWidthFuncPtr	fSetLineWidthFP
CGContextSetLineJoinFuncPtr	fLineJoinFP
CGContextSetLineCapFuncPtr	fLineCapFP
CGContextSetRGBStrokeColorFuncPtr	fStrokeColorFP
CGContextSetRGBFillColorFuncPtr	fFillColorFP
CGContextSaveGStateFuncPtr	fSaveGStateFP
CGContextRestoreGStateFuncPtr	fRestoreGStateFP
CGContextScaleCTMFuncPtr	fScaleCTMFP
CGContextTranslateCTMFuncPtr	fTranslateCTMFP
CGContextRotateCTMFuncPtr	fRotateCTMFP
CGContextAddCurveToPointFuncPtr	fCurveToFP
CGContextAddQuadCurveToPointFuncPtr	fQuadCurveToFP
CGColorSpaceCreateDeviceRGBFuncPtr	fColorSpaceCreateDeviceRGBFP
CGColorSpaceReleaseFuncPtr	fColorSpaceReleaseFP
CGContextMoveToPointFuncPtr	fMoveToFP
CGContextAddLineToPointFuncPtr	fLineToFP
CGDataProviderReleaseFuncPtr	fDataProviderReleaseFP
CGDataProviderCreateWithDataFuncPtr	fDataProviderCreateWithDataFP
CGImageReleaseFuncPtr	fImageReleaseFP
CGContextDrawImageFuncPtr	fContextDrawImageFP
CGImageCreateFuncPtr	fImageCreateFP
CGContextBeginPathFuncPtr	fBeginPathFP
CGContextClosePathFuncPtr	fClosePathFP
CGContextStrokePathFuncPtr	fStrokePathFP
CGContextFillPathFuncPtr	fFillPathFP
CGContextDrawPathFuncPtr	fDrawPathFP
CGContextAddRectFuncPtr	fAddRectFP
CGContextAddArcFuncPtr	fAddArcFP
CGContextAddArcToPointFuncPtr	fAddArcToPointFP
CGContextClipFuncPtr	fClipFP
CP_Point_Array	fPoints
CGContextFillRectFuncPtr	fFillRectFP
CGContextStrokeRectFuncPtr	fStrokeRectFP
CGContextShowTextAtPointFuncPtr	fShowTextAtPoint
CGContextSelectFontFuncPtr	fSelectFont
CGAffineTransformScaleFuncPtr	fAffineTransformScale
CGContextSetTextMatrixFuncPtr	fSetTextMatrix
CP_E_GradientType	fGradientType
SInt16	fGradientCount
CP_RGBColor	fColors [kCP_MaxGradientColors]
SInt16	fOffsets [kCP_MaxGradientColors]
SInt16	fGradientAngle
CP_Region	fDestRegion
CP_Canvas	fDestCanvas
float	fAlpha
float	fLineWidth
CP_ARGBColor	fStrokeColor
CP_ARGBColor	fFillColor
Private Member Functions
Misc
void	Init ()
void	MakeRoundRect (const CP_Rect &inBounds, SInt16 inHorRadius, SInt16 inVerRadius)
void	MakeOval (CGPoint inCenter, float a, float b)
Gradient
void	DrawGradient_imp (CP_E_GradientType inGradietType, CP_Rect &inDestBounds)
virtual void	BuildGradient (CP_Rect &inDestBounds, CP_Point &inCenterPoint)
void	InitGradient ()
CP_E_GradientType	GetGradiientType ()
SInt16	GetGradientAngle ()
SInt16	GetNumberGradients ()
SInt32	CalcGradientRange (CP_Rect &inBounds, CP_Point &inCenterPoint)
void	CalcGradientColors (SInt32 inRange, CP_RGBColor &inOutColorOne, CP_RGBColor &inOutColorTwo, CP_E_GradientColorInfo *inOutGradientInfo)
void	AdjustColor (CP_RGBColor &inOutColor, CP_E_GradientColorInfo *inOutGradientInfo)
void	CalcEnclosingBounds (CP_Rect &inOutBounds, CP_Point &inCenterPoint)
void	BuildRect (CP_Rect &inDestBounds, CP_Point &inCenterPoint, CP_E_GradientType inGradientType)
void	BuildRadial (CP_Rect &inBounds, CP_Point &inCenterPoint)
void	BuildSunburst (CP_Rect &inBounds, CP_Point &inCenterPoint, CP_E_GradientType inGradientType)
void	BuildShapeburst (CP_Rect &inBounds, CP_Point &inCenterPoint)
void	BuildAngled (CP_Rect &inBounds)
UInt16	CP_FixedToColor (CP_Fixed inValue)
Images
void	ReadBitmapInfo (GraphicsImportComponent gi, CP_S_QuartzBitmapInfo *bi)
void	GetBitmapData (GraphicsImportComponent gi, CP_S_QuartzBitmapInfo *bi)
Polygons
void	CreatePolyShape ()

Detailed Description

This is the CP_Graphics_Imp class used by a CP_Graphics object when the user has selected Quartz as the underlying graphics engine. This will also be selected as the native platform type when running under MacOSX Mach with the Quartz drawing available.

Constructor & Destructor Documentation

CP_Graphics_Imp_Quartz::CP_Graphics_Imp_Quartz ( CP_Canvas & inDestCanvas,

bool inSynchronizeWithPort = true

)

Constructor.

Parameters:

inDestCanvas The CP_Canvas object to draw into.

inSynchronizeWithPort Flag to indicate if the coordinates need to be synchronized with the OSPort in the passed in canvas.

Exceptions:

none

CP_Graphics_Imp_Quartz::~CP_Graphics_Imp_Quartz ( ) [virtual]

Destructor.

Exceptions:

none

Member Function Documentation

CGContextRef CP_Graphics_Imp_Quartz::GetCGContext ( )

void CP_Graphics_Imp_Quartz::SetAlpha ( float inAlpha ) [virtual]

Sets the alpha value used when drawing.

Parameters:

inAlpha The alpha value used in drawing.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetLineWidth ( float inLineWidth ) [virtual]

Sets the line width used in stroking.

Parameters:

inLineWidth The line width used in drawing.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetLineJoin ( CP_E_GraphicsLineJoin inLineJoin ) [virtual]

Sets the line join for determing how lines will be drawn when they join. Note: Some platforms do not support line join, and they will be drawn in the normal style. Current values for inLineJoint can be:

CP_E_GraphicsLineJoin_Miter
CP_E_GraphicsLineJoin_Round
CP_E_GraphicsLineJoin_JoinBevel

Parameters:

inLineJoint The way that the lines will join when drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetLineCap ( CP_E_GraphicsLineCap inLineCap ) [virtual]

Sets the line cap for determing how lines ending will be drawn. Note: Some platforms do not support line caps, and they will be drawn in the normal style. Current values for inLineCap can be:

CP_E_GraphicsLineCap_Butt,
CP_E_GraphicsLineCap_Round,
CP_E_GraphicsLineCap_Square

Parameters:

inLineCap The way that the line ends are drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetStrokeColor ( CP_ARGBColor & inStrokeColor ) [virtual]

Sets the color used in stroking objects.

Parameters:

inStrokeColor The color used in stroking objects.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetFillColor ( CP_ARGBColor & inFillColor ) [virtual]

Sets the color used in filling objects.

Parameters:

inStrokeColor The color used in filling objects.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SaveState ( ) [virtual]

Saves the current graphics state.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::RestoreState ( ) [virtual]

Restore the current graphics state. Each RestoreState needs to have a matching SaveState called before calling this.

CP_Graphics graphics( inDestCanvas ); graphics.SaveState(); do some drawing and state changes here, such as setting colors, line styles graphics.RestoreState();

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::ScaleCTM ( float inHorAmt,

float inVerAmt

) [virtual]

Sets the scaling amount to be used in the current transformation matrix.

Parameters:

inHorAmt The horizontal amount to scale.

inVerAmt The vertical amount to scale.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::TranslateCTM ( float inHorAmt,

float inVerAmt

) [virtual]

Sets the translation amount to be used in the current transformation matrix.

Parameters:

inHorAmt The horizontal amount to translate.

inVerAmt The vertical amount to translate.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::RotateCTM ( float inAngle ) [virtual]

Sets the rotation amount to be used in the current transformation matrix.

Parameters:

inAngle The angle to use in rotation.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeArc ( float inHorCenter,

float inVerCenter,

float inRadius,

float inStartAngle,

float inEndAngle

) [virtual]

Draws an arc using the passed in parameters, and then strokes it, using the current stroke color and stroke line width.

Parameters:

inHorCenter The horizontal center coordinate of the arc.

inVerCenter The vertical center coordinate of the arc.

inRadius The radius of the arc.

inStartAngle The starting angle of the arc.

inEndAngle The ending angle of the arc.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillArc ( float inHorCenter,

float inVerCenter,

float inRadius,

float inStartAngle,

float inEndAngle

) [virtual]

Draws an arc using the passed in parameters, and then fills it, using the current fill color.

Parameters:

inHorCenter The horizontal center coordinate of the arc.

inVerCenter The vertical center coordinate of the arc.

inRadius The radius of the arc.

inStartAngle The starting angle of the arc.

inEndAngle The ending angle of the arc.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeBezier ( const CP_Point & inStartPoint,

const CP_Point & inControlPointOne,

const CP_Point & inControlPointTwo,

const CP_Point & inEndPoint

) [virtual]

Draws a Bezier curve using the passed in parameters, and then strokes it, using the current stroke color and stroke line width.

Parameters:

inStartPoint The starting point of the curve.

inControlPointOne The first control point curve.

inControlPointTwo The second control point curve.

inEndPoint The ending point of the curve.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeQuadBezier ( const CP_Point & inStartPoint,

const CP_Point & inControlPointOne,

const CP_Point & inEndPoint

) [virtual]

Draws a Quad Bezier curve using the passed in parameters, and then strokes it, using the current stroke color and stroke line width.

Parameters:

inStartPoint The starting point of the curve.

inControlPointOne The first control point curve.

inEndPoint The ending point of the curve.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawGradient ( CP_E_GradientType inGradietType,

CP_Rect & inDestBounds

) [virtual]

Draws a gradient in the specified bounds. The gradient can be of the following types:

CP_E_GradientType_TopToBottom,
CP_E_GradientType_BottomToTop,
CP_E_GradientType_LeftToRight,
CP_E_GradientType_RightToLeft,
CP_E_GradientType_Radial,
CP_E_GradientType_Sunburst,
CP_E_GradientType_InsetSunburst,
CP_E_GradientType_Shapeburst,
CP_E_GradientType_Angled

Parameters:

inGradientType The type of gradient to draw. See above for acceptable types.

inDestBounds The bounds of the drawn gradient.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

virtual void CP_Graphics_Imp_Quartz::SetGradientAngle ( SInt16 inAngle ) [virtual]

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::SetGradientColor ( const SInt16 inIndex,

const CP_ARGBColor & inColor

) [virtual]

Sets one of the colors used in the gradient drawing.

Parameters:

inindex The index of the color being set.

inColor The color to be used.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp_Quartz::SetGradientCount ( SInt16 inGradientCount ) [virtual]

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawIcon ( const CP_Rect & inBounds,

CP_E_IconStyle inIconType,

SInt16 inIconID

) [virtual]

Draws a icon resource in the passed in bounds. The image will be scaled to fit the rectangle.

Parameters:

inBounds The rectangle to draw the icon in.

inIconType Type type of icon to use.

inIconID Resource ID of the icon to draw.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawIcon ( CP_OSIcon & inIcon,

const CP_Rect & inBounds

) [virtual]

Draws the CP_OSicon in the passed in bounds. The image will be scaled to fit the rectangle.

Parameters:

inIcon A CP_OSIcon that contains the icon to draw.

inBounds The rectangle to draw the picture in.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawImage ( SInt16 inImageResID,

CP_Rect & inDestBounds

) [virtual]

Draws a picture image into the specified area. The image will be scaled to fit into the destination area.

Parameters:

inImageResID Picture resource id.

inDestBounds The area to draw the picture into.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawImage ( const CP_FileSystemSpec & inImageSpec,

CP_Rect & inDestBounds

) [virtual]

Draws a picture image into the specified area. The image will be scaled to fit into the destination area. The image is located in the passed in file spec.

Parameters:

inImageSpec The location of the file containing the image to be displayed.

inDestBounds The area to draw the image into.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawImage ( const CP_FileSystemSpec & inImageSpec,

CP_Rect & inSourceBounds,

CP_Rect & inDestBounds

) [virtual]

Draw the passed in image object in the destination bounds, scaling the image to fit. This versions copies inSourceBounds portion of the image to the destination.

Parameters:

inImageSpec The location of the file containing the image to be displayed.

inSourceBounds The source area of the image to draw.

inDestBounds The area to draw the image into.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::Line ( const CP_Point & inPoint,

const CP_Size & inSize

) [virtual]

Draws a line from the passed in start location and going for the distance specified in inSize.

Parameters:

inPoint Starting location of the line.

inSize Size to draw the line.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::Line ( float inStartHorLocation,

float inStartVerLocation,

float inEndHorLocation,

float inEndVerLocation

) [virtual]

Draws a line from the passed in start location to the ending location.

Parameters:

inStartHorLocation The starting horizontal location.

inStartVerLocation The starting vertical location.

inEndHorLocation The ending horizontal location.

inEndVerLocation The ending vertical location.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::BeginPath ( ) [virtual]

Marks the beginning of a path. This indicates that all subsequent drawing operations until ClosePath is called is collected into the current path. After ClosePath is called, you can then stroke or fill the path. The only drawing calls that are added, are the ones that begin with Path, such as PathMoveTo, PathAddOval, PathAddRect, etc.

CP_Graphics graphics( inDestCanvas ); graphics.BeginPath(); do some path drawing commands here graphics.EndPath(); graphics.StrokePath();

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::ClosePath ( ) [virtual]

Closes the current path. Every call to ClosePath needs to have a corresponding BeginPath call.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokePath ( ) [virtual]

Strokes the current path.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillPath ( ) [virtual]

Fills the current path.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawPath ( CP_E_PathDrawingMode inPathDrawMode ) [virtual]

Draws the current path using the passed in path drawing mode, which can be one of the following:

CP_E_Graphics_PathFill
CP_E_Graphics_PathEOFill
CP_E_Graphics_PathStroke
CP_E_Graphics_PathFillStroke
CP_E_Graphics_PathEOFillStroke

Parameters:

inPathDrawMode The path drawing mode to use.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathMoveTo ( const CP_Point & inPoint ) [virtual]

Sets the current point in the path to that of the passed in point. This is the location where subsequent drawing operations will begin unless the call specifies a new starting point in its params.

Parameters:

inPoint The location to move to.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathMoveTo ( float inHorLocation,

float inVerLocation

) [virtual]

Sets the current point in the path to that of the passed in coordinates. This is the location where subsequent drawing operations will begin unless the call specifies a new starting point in its params.

Parameters:

inHorLocation The horizontal location to move to.

inVerLocation The vertical location to move to.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddLineTo ( const CP_Point & inPoint ) [virtual]

Adds a line to our path. The line will be drawn from the current point to the location specified in inPoint.

Parameters:

inPoint The ending location of the line.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddLines ( const CP_Point inPoint[],

SInt16 inNumberPoints

) [virtual]

Add inNumberPoints lines to our path. The first point is the starting point, then each additional point has a line drawn from the last point to that point.

Parameters:

inPoint An array of points.

inNumberPoints The number of points in the above array of points.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::PathAddLine ( const CP_Point & inStartPoint,

const CP_Point & inEndPoint

) [virtual]

Adds a starting and ending point to the current path.

Parameters:

inStartPoint The starting point to add.

inEndPoint The ending point to add.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddLine ( float inStartH,

float inStartV,

float inEndH,

float inEndV

) [virtual]

Adds a line to the current path using the specified coordinates.

Parameters:

inStartH Horizontal starting point.

inStartV Vertical starting point.

inEndH Horizontal ending point.

inEndV Vertical ending point.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddRect ( const CP_Rect & inBounds ) [virtual]

Adds a rect to the current path.

Parameters:

inBounds The bounds of the rectangle to add.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddBezier ( const CP_Point & inStartPoint,

const CP_Point & inControlPointOne,

const CP_Point & inControlPointTwo,

const CP_Point & inEndPoint

) [virtual]

Adds a bezier curve to the current path.

Parameters:

inStartPoint The starting point of the curve.

inControlPointOne The first control point curve.

inControlPointTwo The second control point curve.

inEndPoint The ending point of the curve.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddQuadBezier ( const CP_Point & inStartPoint,

const CP_Point & inControlPointOne,

const CP_Point & inEndPoint

) [virtual]

Adds a quadratic bezier curve to the current path.

Parameters:

inStartPoint The starting point of the curve.

inControlPointOne The first control point curve.

inEndPoint The ending point of the curve.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddArc ( float x,

float y,

float radius,

float inStartAngle,

float inEndAngle,

SInt16 clockwise

) [virtual]

Add an arc of a circle to the context's path, possibly preceded by a straight line segment. `(inHorCenter, inVerCenter)' is the center of the arc; `inRadius' is its radius; `inStartAngle' is the angle to the first endpoint of the arc; `inEndAngle' is the angle to the second endpoint of the arc; and `inClockwise' is 1 if the arc is to be drawn clockwise, 0 otherwise. `inStartAngle' and `inEndAngle' are measured in radians.

Parameters:

inHorCenter The horizontal center coordinate of the arc.

inVerCenter The vertical center coordinate of the arc.

inRadius The radius of the arc.

inStartAngle The starting angle of the arc.

inEndAngle The ending angle of the arc.

inClockwise Flag to indicate if the arc is drawn clockwise or counter clockwise.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddArcToPoint ( float x1,

float y1,

float x2,

float y2,

float radius

) [virtual]

Add an arc of a circle to the context's path, possibly preceded by a straight line segment. `radius' is the radius of the arc. The arc is tangent to the line from the current point to `(x1, y1)', and the line from `(x1, y1)' to `(x2, y2)'

Parameters:

x1 First horizontal coordinate.

y1 First vertical coordinate.

x2 Second horizontal coordinate.

y2 Second vertical coordinate.

inRadius The radius of the arc.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::PathAddOval ( const CP_Rect & inBounds ) [virtual]

Adds an oval to the current path.

Parameters:

inBounds The bounds of the oval to add.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::PathAddPoly ( CP_Point_Array & inPoints ) [virtual]

Adds a polygon to the current path as specified in the passed in points array.

Parameters:

inPoints An array of points to draw the polygon.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::ClipPath ( ) [virtual]

Sets the clipping path of the canvas being drawn into to that of the current path.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokePoly ( CP_Point_Array & inPoints ) [virtual]

Draws the polygon specified by the passed in points array, then strokes it.

Parameters:

inPoints Points of the polygon to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillPoly ( CP_Point_Array & inPoints ) [virtual]

Draws the polygon specified by the passed in points array, and fills it.

Parameters:

inPoints Points of the polygon to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeRect ( const CP_Rect & inBounds ) [virtual]

Draws a rect specified by the passed in bounds, then strokes it.

Parameters:

inBounds Area of the rect to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillRect ( const CP_Rect & inBounds ) [virtual]

Draws a rect specified by the passed in bounds, then fills it.

Parameters:

inBounds Area of the rect to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeRegion ( const CP_Region & inRegion ) [virtual]

Draws a region specified by the passed in region, then strokes it.

Parameters:

inRegion Region to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillRegion ( const CP_Region & inRegion ) [virtual]

Draws a region specified by the passed in region, then fills it.

Parameters:

inRegion Region to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeRoundRect ( const CP_Rect & inBounds,

SInt16 inHorRadius,

SInt16 inVerRadius

) [virtual]

Draws a rounded rect specified by the passed in rect, then strokes it.

Parameters:

inBounds The bounds of the rect to be drawn.

inHorRadius Horizontal radius of the corners.

inVerRadius Vertical radius of the corners.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillRoundRect ( const CP_Rect & inBounds,

SInt16 inHorRadius,

SInt16 inVerRadius

) [virtual]

Draws a rounded rect specified by the passed in rect, then fills it.

Parameters:

inBounds The bounds of the rect to be drawn.

inHorRadius Horizontal radius of the corners.

inVerRadius Vertical radius of the corners.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::StrokeOval ( const CP_Rect & inBounds ) [virtual]

Draws an oval specified by the passed in rect, then strokes it.

Parameters:

inBounds The bounds of the oval to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::FillOval ( const CP_Rect & inBounds ) [virtual]

Draws an oval specified by the passed in rect, then fills it.

Parameters:

inBounds The bounds of the oval to be drawn.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawString ( CP_FontSpec & inFontSpec,

const CP_String & inText,

const CP_Point & inStartPoint

) [virtual]

Draws the passed in text at the location specified. The text will not be wrapped.

Parameters:

inFontSpec FontSpec object that describes the font and justification of the text.

inText The text to be drawn.

inStartPoint The starting point to draw the text.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawQuartzString ( CP_FontSpec & inFontSpec,

const CP_String & inText,

const CP_Point & inStartPoint

) [virtual]

Draws the passed in text at the location specified. The text will not be wrapped. This version calls on Quartz directly to draw the string.

Parameters:

inFontSpec FontSpec object that describes the font and justification of the text.

inText The text to be drawn.

inStartPoint The starting point to draw the text.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::DrawText ( CP_FontSpec & inFontSpec,

const CP_String & inText,

const CP_Rect & inBounds,

SInt16 inHorAlign = CP_E_TextAlign_HorLeft,

SInt16 inVerAlign = CP_E_TextAlign_VerTop,

bool inWrapText = true

) [virtual]

Draws the passed in text at the locatio specified. The text will be wrapped to fit in the passed in bounds.

Parameters:

inFontSpec FontSpec object that describes the font and justification of the text.

inText The text to be drawn.

inBounds The bounds to draw the text in.

inHorAlign The horizontal alignment of the text. It should be one of the following:

CP_E_TextAlign_HorLeft
CP_E_TextAlign_HorCenter
CP_E_TextAlign_HorRight

inVerAlign The vertical alignment of the text. It should be one of the following:

CP_E_TextAlign_VerTop
CP_E_TextAlign_VerMiddle
CP_E_TextAlign_VerBottom

inWrapText If true, then the text is wrapped at the right edge of the passed in bounds.

Exceptions:

none

Returns:
void

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::DrawTrunc ( CP_FontSpec & inFontSpec,

const CP_String & inText,

const CP_Rect & inBounds,

SInt16 inHorAlign = CP_E_TextAlign_HorLeft,

SInt16 inVerAlign = CP_E_TextAlign_VerTop

) [virtual]

Reimplemented from CP_Graphics_Imp.

void CP_Graphics_Imp_Quartz::Init ( ) [private]

Finish initializing the members of this class.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::MakeRoundRect ( const CP_Rect & inBounds,

SInt16 inHorRadius,

SInt16 inVerRadius

) [private]

Private routine to create a round rect out of Quartz drawing routines.

Parameters:

inBounds The bounds of the rect to be drawn.

inHorRadius Horizontal radius of the corners.

inVerRadius Vertical radius of the corners.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::MakeOval ( CGPoint inCenter,

float a,

float b

) [private]

Private routine to create an oval out of Quartz drawing routines.

Parameters:

inBounds The bounds of the rect to be drawn.

a Horizontal amount to scale arc.

b Vertical amount to scale arc.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::DrawGradient_imp ( CP_E_GradientType inGradientType,

CP_Rect & inDestBounds

) [private]

Private routine that draws a gradient in the specified bounds. The gradient can be of the following types:

CP_E_GradientType_TopToBottom,
CP_E_GradientType_BottomToTop,
CP_E_GradientType_LeftToRight,
CP_E_GradientType_RightToLeft,
CP_E_GradientType_Radial,
CP_E_GradientType_Sunburst,
CP_E_GradientType_InsetSunburst,
CP_E_GradientType_Shapeburst,
CP_E_GradientType_Angled

Parameters:

inGradientType The type of gradient to draw. See above for acceptable types.

inDestBounds The bounds of the drawn gradient.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildGradient ( CP_Rect & inDestBounds,

CP_Point & inCenterPoint

) [private, virtual]

Build our gradient in our offscreen canvas object.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::InitGradient ( ) [private]

Initialize our gradient to a default top to bottom, black & white pattern.

Exceptions:

none

Returns:
void

CP_E_GradientType CP_Graphics_Imp_Quartz::GetGradiientType ( ) [private]

SInt16 CP_Graphics_Imp_Quartz::GetGradientAngle ( ) [private]

SInt16 CP_Graphics_Imp_Quartz::GetNumberGradients ( ) [private]

SInt32 CP_Graphics_Imp_Quartz::CalcGradientRange ( CP_Rect & inBounds,

CP_Point & inCenterPoint

) [private]

Calculate the number of pixels for the given range.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::CalcGradientColors ( SInt32 inRange,

CP_RGBColor & inOutColorOne,

CP_RGBColor & inOutColorTwo,

CP_E_GradientColorInfo * inOutGradientInfo

) [private]

Calculate the colors and increments for our gradient.

Parameters:

inRange Range color needs to cover.

inOutColorOne First color.

inOutColorTwo Second color.

inOutGradientInfo A gradient color info structure to hold the result of this calculation.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::AdjustColor ( CP_RGBColor & inOutColor,

CP_E_GradientColorInfo * inOutGradientInfo

) [private]

Adjust the passed in color based on information stored in the passed in CP_E_GradientColorInfo structure.

Parameters:

inOutColor Color used in the claculation.

inOutGradientInfo A gradient color info structure to hold the result of this calculation.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::CalcEnclosingBounds ( CP_Rect & inOutBounds,

CP_Point & inCenterPoint

) [private]

Calculate our enclosing bounds based on the passed in center point.

Parameters:

inOutBounds Bounds of the area to return result in.

inCenterPoint Center point used in the calculations.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildRect ( CP_Rect & inBounds,

CP_Point & inCenterPoint,

CP_E_GradientType inGradientType

) [private]

Build a gradient with rectangular orientation into our offscreen port canvas. This will be 1 of our 4 orientations, top to bottom, bottom to top, left to right, right to left.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

inGradientType The type of gradient to draw. See above for acceptable types.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildRadial ( CP_Rect & inBounds,

CP_Point & inCenterPoint

) [private]

Build a gradient with radial (from center point outward) orientation into our offscreen port canvas.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildSunburst ( CP_Rect & inBounds,

CP_Point & inCenterPoint,

CP_E_GradientType inGradientType

) [private]

Build a gradient with sunburst orientation into our offscreen port canvas.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

inGradientType The type of gradient to draw. See above for acceptable types.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildShapeburst ( CP_Rect & inBounds,

CP_Point & inCenterPoint

) [private]

Build a gradient with shapeburst orientation into our offscreen port canvas.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::BuildAngled ( CP_Rect & inBounds ) [private]

Build a gradient with an angled (as set by the class member fGradientAngle) orientation into our offscreen port canvas.

Parameters:

inDestBounds The bounds of the drawn gradient.

inCenterPoint Center point of the gradient.

Exceptions:

none

Returns:
void

UInt16 CP_Graphics_Imp_Quartz::CP_FixedToColor ( CP_Fixed inValue ) [private]

Convert the passed in CP_Fixed to a UInt16 color.

Parameters:

inValue The CP_Fixed value to be converted.

Exceptions:

none

Returns:
UInt16 The converted color.

void CP_Graphics_Imp_Quartz::ReadBitmapInfo ( GraphicsImportComponent gi,

CP_S_QuartzBitmapInfo * bi

) [private]

Read the image data and store information into the passed in bitmap info structure.

Parameters:

gi GraphicsImportComponent with the image information.

bi Structure used to hold the converted or read in info.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::GetBitmapData ( GraphicsImportComponent gi,

CP_S_QuartzBitmapInfo * bi

) [private]

Returns the bitmap information from the passed in graphics importer.

Parameters:

gi GraphicsImportComponent with the image information.

bi Structure used to hold the converted or read in info.

Exceptions:

none

Returns:
void

void CP_Graphics_Imp_Quartz::CreatePolyShape ( ) [private]

Private routine to draw the polygon from the points specified previously.

Exceptions:

none

Returns:
void

virtual float CP_Graphics_Imp::GetLineWidth ( ) [virtual, inherited]

Returns the current width used in drawing lines.

Exceptions:

none

Returns:
float The width of drawn lines.

virtual float CP_Graphics_Imp::GetAlpha ( ) [virtual, inherited]

Returns the current alpha value used when drawing.

Exceptions:

none

Returns:
float The alpha value used in drawing.

virtual CP_ARGBColor CP_Graphics_Imp::GetStrokeColor ( ) [virtual, inherited]

Returns the current color used in stroking.

Exceptions:

none

Returns:
CP_ARGBColor The color used in stroking.

virtual CP_ARGBColor CP_Graphics_Imp::GetFillColor ( ) [virtual, inherited]

Returns the current color used in filling.

Exceptions:

none

Returns:
CP_ARGBColor The color used in filling.

CP_Canvas CP_Graphics_Imp::GetCanvas ( ) [inherited]

Returns the CP_Canvas object to be drawn into.

Exceptions:

none

Returns:
CP_Canvas The canvas used to draw into.

virtual void CP_Graphics_Imp::SkewCTM ( float ,

float

) [virtual, inherited]

Sets the skewing amount to be used in the current transformation matrix.

Parameters:

inHorAmt The horizontal amount to skew.

inVerAmt The vertical amount to skew.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::SetGradientColor ( const SInt16,

const CP_ARGBColor &

) [virtual, inherited]

Sets one of the colors used to draw the gradient.

Parameters:

inIndex Index where the color is used in drawing.

inColor The color to be used.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::DrawPicture ( CP_OSPicture & ,

const CP_Rect &

) [virtual, inherited]

Draw the passed in OSPicture in the destination bounds, scaling the image as needed to fit.

Parameters:

inPicture The picture to be drawn.

inBounds The destination area to draw the picture.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::FillPath ( CP_Pattern & ) [virtual, inherited]

Fills the current path with the passed in pattern.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::PathAddLines ( const CP_Point[],

SInt16

) [virtual, inherited]

Add inNumberPoints lines to our path. The first point is the starting point, then each additional point has a line drawn from the last point to that point.

Parameters:

inPoint An array of points.

inNumberPoints The number of points in the above array of points.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::EraseRect ( const CP_Rect & ) [virtual, inherited]

Erases the passed in rect using the canvases current background color.

Parameters:

inBounds The rectangle to erase.

Exceptions:

none

Returns:
void

virtual void CP_Graphics_Imp::SetTextRenderingFlags ( SInt16 ) [virtual, inherited]

Sets a flag to indicate how the text will be drawn in the destination canvas, if the platform supports them. Such as transparent or opaque.

Parameters:

inFlags The flags to set.

Exceptions:

none

Returns:
void