CGContextMBS.addArcToPath(x as Double, y as Double, w as Double, h as Double, startAngle as Integer, arcAngle as Integer)

CGContextMBS.AddEllipseInRect(r as CGRectMBS)

See the function CGPathMBS.AddEllipseInRect for more information on how the path for the ellipse is constructed.
Requires Mac OS X 10.4.

CGContextMBS.addOvalToPath(x as Double, y as Double, w as Double, h as Double)

CGContextMBS.AddPath(path as CGPathMBS)

The points in path are transformed by the CTM of context before they are added.
Requires Mac OS X 10.2.

CGContextMBS.addRoundedRectToPath(x as Double, y as Double, w as Double, h as Double, arcWidth as Double, arcHeight as Double)

CGContextMBS.BeginPage(mediabox as CGRectMBS)

CGContextMBS.BeginPath

#If XojoVersion >= 2019.02 Then
  Var p As ptr = g.Handle(Graphics.HandleTypes.CGContextRef)
  Var c As CGContextMBS = CGContextMBS.contextWithCGContext(p)
#Else
  Var h As Integer = g.Handle(g.HandleTypeCGContextRef)
  Var c As CGContextMBS = CGContextMBS.contextWithCGContext(h)
#EndIf

c.SetGrayStrokeColor(0,1)
c.SetGrayFillColor(0,1)
c.BeginPath
c.SetLineWidth 0.5
c.MoveToPoint 50, 550
c.AddLineToPoint 100, 600
c.StrokePath
c.Flush
c = nil

Note that a context has a double path in use at any time: a path is not part of the graphics state.

Some examples using this method:

• /MacCG/CG Ovals
• /MacCG/CG Ovals with PDF in memory
• /MacCG/CoreGraphics Bitmap
• /MacCG/CoreGraphics PDF/PDF Text
• /MacCG/CoreGraphics PDF/PDF using Save and Restore

CGContextMBS.BeginTransparencyLayer(auxiliaryInfo as Dictionary = nil)

All subsequent drawing operations until a corresponding EndTransparencyLayer are composited into a fully transparent backdrop (which is treated as a separate destination buffer from the context). After the transparency layer is ended, the result is composited into the context using the global alpha and shadow state of the context. This operation respects the clipping region of the context. After a call to this function, all of the parameters in the graphics state remain unchanged with the exception of the following:

- The global alpha is set to 1.
- The shadow is turned off.
- The blend mode is set to 'kCGBlendModeNormal'.

Ending the transparency layer restores these parameters to the values they had before BeginTransparencyLayer was called. Transparency layers may be nested.

CGContextMBS.BeginTransparencyLayerWithRect(r as CGRectMBS, auxiliaryInfo as Dictionary = nil)

This function is identical to BeginTransparencyLayer except that the content of the transparency layer will be bounded by rect (specified in user space).

CGContextMBS.DrawCGPDFDocument(pdf as Variant, rect as CGRectMBS, page as Integer)

'get a print session

// print this PDF
Var pathPrinted as FolderItem=GetFolderItem("test.pdf")

Var thePrintSession as CPMPrintSessionMBS = NewCPMPrintSessionMBS
if thePrintSession = nil then Return

'get default page format and print settings and attach it to the print settings
Var thePageFormat as CPMPageFormatMBS = NewCPMPageFormatMBS
Var thePrintSettings as CPMPrintSettingsMBS = NewCPMPrintSettingsMBS
thePrintSession.DefaultPageFormat thePageFormat
thePrintSession.DefaultPrintSettings thePrintSettings

'show the print dialog
if not thePrintSession.PrintDialog(thePrintSettings,thePageFormat) then return

'open the file which will be printed
Var thePdfDocument as CGPDFDocumentMBS = pathPrinted.OpenAsCGPDFDocumentMBS

' limit page counts to the one we have
Var LastPage as Integer = thePdfDocument.PageCount
if thePrintSettings.LastPage<lastpage then
  lastpage=thePrintSettings.LastPage
end if

' you get better progress bar if you tell how many pages will come
thePrintSettings.LastPage=lastpage

'begin the printing
thePrintSession.BeginDocument(thePrintSettings, thePageFormat)

'loop over the number of copies
for currentCopy as Integer = 1 to thePrintSettings.Copies
  
  'loop over the pages
  for currentPage as Integer = thePrintSettings.FirstPage to LastPage
    
    'prepage the page
    Var PrintRect as CPMRectMBS =thePageFormat.AdjustedPageSize
    Var CGRect as CGRectMBS =CGMakeRectMBS(PrintRect.left, PrintRect.top, PrintRect.Width, PrintRect.Height)
    thePrintSession.BeginPage(thePageFormat, nil)
    Var thePrintContext as CGContextMBS = thePrintSession.PageContext
    if thePrintContext = Nil then return
    
    'print the page
    thePrintContext.DrawCGPDFDocument thePdfDocument, CGRect, currentPage
    
    'end the page
    thePrintContext = nil
    thePrintSession.EndPage
  next
  
next

'end the printing
thePrintSession.EndDocument

Pass a CGPDFDocumentMBS object for the pdf argument.
The media box of the page is scaled, if necessary, to fit into 'rect'.

Some examples using this method:

• /MacCG/Carbon Print Manager/Carbon Print Hello
• /MacCG/Carbon Print Manager/sample
• /MacCG/Carbon Print Manager/sample with sheets
• /MacCG/CoreGraphics PDF/Show PDF
• /MacCG/Print PDF with CoreGraphics/Print PDF with CoreGraphics
• /MacCG/Rotate PDF Page
• /MacCocoa/RTF Printing

CGContextMBS.DrawLayerAtPoint(Point as CGPointMBS, layer as CGLayerMBS)

context: The graphics context associated with the layer.
point: The location, in current user space coordinates, to use as the origin for the drawing.
layer: The layer whose contents you want to draw.

Calling the function DrawLayerAtPoint is equivalent to calling the function DrawLayerInRect with a rectangle that has its origin at point and its size equal to the size of the layer.

Available in Mac OS X version 10.4 and later.

CGContextMBS.DrawLayerInRect(rect as CGRectMBS, layer as CGLayerMBS)

context: The graphics context associated with the layer.
rect: The rectangle, in current user space coordinates, to draw to.
layer: The layer whose contents you want to draw.

The contents are scaled, if necessary, to fit into the rectangle.
Available in Mac OS X version 10.4 and later.

CGContextMBS.DrawLinearGradient(gradient as CGGradientMBS, startPoint as CGPointMBS, endPoint as CGPointMBS, options as Integer)

gradient: A CGGradient object.
startPoint: The coordinate that defines the starting point of the gradient.
endPoint: The coordinate that defines the ending point of the gradient.
options: Option flags (kCGGradientDrawsBeforeStartLocation or kCGGradientDrawsAfterEndLocation) that control whether the fill is extended beyond the starting or ending point.

The color at location 0 in the CGGradient object is mapped to the starting point. The color at location 1 in the CGGradient object is mapped to the ending point. Colors are linearly interpolated between these two points based on the location values of the gradient. The option flags control whether the gradient is drawn before the start point or after the end point.

Available in Mac OS X v10.5 and later.

Some examples using this method:

• /MacCG/CGGradient test

CGContextMBS.DrawPath(mode as Integer)

CGContextMBS.DrawPicture(pic as CGImageMBS, rect as CGRectMBS)

// put inside window paint event

Var c as CGContextMBS
if TargetCocoa then
  c = GetCurrentCGContextMBS
else
  c = window1.CGContextMBS
end if

Var logo as Picture = logoMBS(500)
Var image as CGImageMBS = CGCreateImageMBS(logo)

Var r as CGRectMBS = CGMakeRectMBS(0,0,g.Width,g.Height)

c.DrawPicture image, r

Remeber that in CoreGraphics the position 0/0 is in the bottom left corner. In Xojo 0/0 is in the top left corner.

CGContextMBS.DrawRadialGradient(gradient as CGGradientMBS, startCenter as CGPointMBS, startRadius as Double, endCenter as CGPointMBS, endRadius as Double, options as Integer)

gradient: A CGGradient object.
startCenter: The coordinate that defines the center of the starting circle.
startRadius: The radius of the starting circle.
endCenter: The coordinate that defines the center of the ending circle.
endRadius: The radius of the ending circle.
options: Option flags (kCGGradientDrawsBeforeStartLocation or kCGGradientDrawsAfterEndLocation) that control whether the gradient is drawn before the starting circle or after the ending circle.

The color at location 0 in the CGGradient object is mapped to the circle defined by startCenter and startRadius. The color at location 1 in the CGGradient object is mapped to the circle defined by endCenter and endRadius. Colors are linearly interpolated between the starting and ending circles based on the location values of the gradient. The option flags control whether the gradient is drawn before the start point or after the end point.

Available in Mac OS X v10.5 and later.

Some examples using this method:

• /MacCG/CGGradient test
• /MacCG/Quartz Gradients

CGContextMBS.DrawShading(shading as CGShadingMBS)

shading: A Quartz shading. Quartz retains this object; upon return, you may safely release it.
Available in Mac OS X version 10.2 and later.

CGContextMBS.DrawTiledImage(pic as CGImageMBS, rect as CGRectMBS)

// put inside window paint event

Var c as CGContextMBS
if TargetCocoa then
  c = GetCurrentCGContextMBS
else
  c = window1.CGContextMBS
end if

Var logo as Picture = logoMBS(50)
Var image as CGImageMBS = CGCreateImageMBS(logo)

Var r as CGRectMBS = CGMakeRectMBS(0,0,50,50)

c.DrawTiledImage image, r

rect: A rectangle that specifies the origin and size of the destination tile. Quartz scales the image—disproportionately, if necessary—to fit the bounds specified by the rect parameter.

image: The image to draw.

Quartz draws the scaled image starting at the origin of the rectangle in user space, then moves to a new point (horizontally by the width of the tile and/or vertically by the height of the tile), draws the scaled image, moves again, draws again, and so on, until the current clip region is tiled with copies of the image. Unlike patterns, the image is tiled in user space, so transformations applied to the CTM affect the final result.

Available in Mac OS X v10.5 and later.

CGContextMBS.EndPage

CGContextMBS.EndTransparencyLayer

CGContextMBS.EOClip

Intersect the context's path with the current clip path and use the resulting path as the clip path for subsequent rendering operations. Use the even-odd fill rule for deciding what's inside the path.

Some examples using this method:

• /MacCG/CoreGraphics PDF/PDF with paths and gradient

CGContextMBS.EOFillPath

Some examples using this method:

• /MacCG/CoreGraphics PDF/PDF with paths
• /MacCG/CoreGraphics PDF/PDF with paths and gradient

CGContextMBS.FillEllipseInRect(rect as CGRectMBS)

// a new picture in RB
Var pic as new Picture(500, 500)

// and create CGBitmapContextMBS pointing to it
Var b as CGBitmapContextMBS = CGBitmapContextMBS.CreateWithPicture(pic)

// color set to full red
b.SetRGBFillColor 1.0, 0.0, 0.0, 1.0

// draw ellipse
Var r as CGRectMBS = CGRectMBS.Make(0, 0, 500, 500)
b.FillEllipseInRect r

// flush drawings
b.Flush

// and show
Backdrop = pic

Requires Mac OS X 10.4.

Some examples using this method:

• /Overlay/Overlay with Draw Event

CGContextMBS.FillPath

CGContextMBS.FillRect(rect as CGRectMBS)

// put in window.paint event
Var c as CGContextMBS

c=window1.CGContextMBS

c.RotateCTM 0.1
c.SetRGBFillColor 0,0,1,0.5
c.FillRect CGMakeRectMBS(0,0,100,100)

c.Flush

Remeber that in CoreGraphics the position 0/0 is in the bottom left corner. In Xojo 0/0 is in the top left corner.

CGContextMBS.fillRoundedRect(x as Double, y as Double, w as Double, h as Double, arcWidth as Double, arcHeight as Double)

Var c as CGContextMBS

c=window1.CGContextMBS

// fill in red
c.SetRGBFillColor 1,0,0,1
c.fillRoundedRect 100,100,100,100,20,20

// draw in green
c.SetRGBStrokeColor 0,1,0,1
c.strokeRoundedRect 100,100,100,100,20,20

CGContextMBS.Flush

Like UpdateNow in the RB window class.

CGContextMBS.frameArc(x as Double, y as Double, w as Double, h as Double, startAngle as Integer, arcAngle as Integer)

Var c as CGContextMBS

c=window1.CGContextMBS

// fill in red
c.SetRGBFillColor 1,0,0,1
c.paintArc 100,100,100,100,50,90

// draw in green
c.SetRGBStrokeColor 0,1,0,1
c.frameArc 100,100,100,100,50,90

angles are in degree.

CGContextMBS.frameOval(x as Double, y as Double, w as Double, h as Double)

Var c as CGContextMBS

c=window1.CGContextMBS

// fill in red
c.SetRGBFillColor 1,0,0,1
c.paintOval 100,100,100,100

// draw in green
c.SetRGBStrokeColor 0,1,0,1
c.frameOval 100,100,100,100

CGContextMBS.frameRect(x as Double, y as Double, w as Double, h as Double)

Var c as CGContextMBS

c=window1.CGContextMBS

// fill in red
c.SetRGBFillColor 1,0,0,1
c.paintRect 100,100,100,100

// draw in green
c.SetRGBStrokeColor 0,1,0,1
c.frameRect 100,100,100,100

Some examples using this method:

• /MacCocoa/RTF Printing

CGContextMBS.GetClipBoundingBox as CGRectMBS

Returns the bounding box of the clipping path, specified in user space.

The bounding box is the smallest rectangle completely enclosing all points in the clipping path, including control points for any Bezier curves in the path.

Available in Mac OS X v10.3 and later.

CGContextMBS.GetCTM as CGAffineTransformMBS

Returns nil on any error.

CGContextMBS.GetPathBoundingBox as CGRectMBS

The bounding box is the smallest rectangle completely enclosing all points in the path, including control points for Bezier and quadratic curves.

CGContextMBS.GetPathCurrentPoint as CGPointMBS

CGContextMBS.GetTextPosition as CGPointMBS

Returns nil on any problem.