Platforms to show: All Mac Windows Linux Cross-Platform

Back to CGContextMBS class.

CGContextMBS.ScaleCTM(sx as Double, sy as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Scale the current graphics state's transformation matrix (the CTM) by (sx, sy).

Some examples using this method:

CGContextMBS.SelectFont(name as string, size as Double, fontencoding as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Attempts to find the font named 'name'. If successful, scales it to 'size' units in user space.

Name: string that contains the PostScript name of the font to set.

'textEncoding' specifies how to translate from bytes to glyphs.
kCGEncodingFontSpecific0
kCGEncodingMacRoman 1

As "Comic Sans MS" works, but not ""Comic Sans ms" this functions seems to be case sensitive.

Matthias Buercher notes that sometimes a font is not selected if the RGBFillColor was not set before.

You may need to reset the textmatrix with some code like c.TextMatrix = CGAffineTransformMBS.Identity. If the text matrix is different, your text may be rotated, skewed or resized.

Some examples using this method:

CGContextMBS.SetAllowsAntialiasing(allowsAntialiasing as boolean)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 7.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Whether to allow antialiasing.

Allow antialiasing in context if allowsAntialiasing is true; don't allow it otherwise. This parameter is not part of the graphics state. A context will perform antialiasing if both allowsAntialiasing and the graphics state parameter shouldAntialias are true.
Requires Mac OS X 10.4 to work.

CGContextMBS.SetBlendMode(BlendMode as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 8.0 ✅ Yes ❌ No ❌ No ✅ Yes All
Set the blend mode of context to mode.

Requires Mac OS X 10.4.

CGContextMBS.SetFillColor(color as CGColorMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 17.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the given color as fill color.

CGContextMBS.SetFillColorSpace(colorspace as CGColorSpaceMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 4.3 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the colorspace used for the fill color of the graphics context.

CGContextMBS.SetFont(font as CGFontMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 14.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the current font.

CGContextMBS.SetLineDash(phase as Double, lengths as memoryblock, count as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 7.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the pattern for dashed lines in a graphics context.

phase:
A value that specifies how far into the dash pattern the line starts, in units of the user space. For example, passing a value of 3 means the line is drawn with the dash pattern starting at three units from its beginning. Passing a value of 0 draws a line starting with the beginning of a dash pattern.

lengths:
A memoryblock of float values that specify the lengths of the painted segments and unpainted segments, respectively, of the dash pattern—or nil for no dash pattern.

For example, passing a memoryblock with the values [2,3] sets a dash pattern that alternates between a 2-user-space-unit-long painted segment and a 3-user-space-unit-long unpainted segment. Passing the values [1,3,4,2] sets the pattern to a 1-unit painted segment, a 3-unit unpainted segment, a 4-unit painted segment, and a 2-unit unpainted segment.

count
If the lengths parameter specifies a memorybloc, pass the number of elements in the memoryblock. Otherwise, pass 0.

CGContextMBS.SetShadow(x as Double, y as Double, blur as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 8.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Enables shadowing in a graphics context.
Example
Sub Paint(g As Graphics)
Var c as CGContextMBS

c=window1.CGContextMBS

c.SetShadow 5,5,0.5
c.SetRGBFillColor 1,0,0,1
c.FillRect CGMakeRectMBS(100,100,100,100)
c.Flush

End Sub

x/y: Specifies a translation of the context's coordinate system, to establish an offset for the shadow ({0,0} specifies a light source immediately above the screen).
blur: A non-negative number specifying the amount of blur.

Shadow parameters are part of the graphics state in a context. After shadowing is set, all objects drawn are shadowed using a black color with 1/3 alpha (i.e., RGBA = {0, 0, 0, 1.0/3.0}) in the DeviceRGB color space.

To turn off shadowing:

  • Use the standard save/restore mechanism for the graphics state.
  • Use CGContextSetShadowWithColor to set the shadow color to a fully transparent color (or pass nil as the color).

CGContextMBS.SetShadowWithColor(x as Double, y as Double, blur as Double, colorvalue as CGColorMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 8.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Enables shadowing with color a graphics context.

x/y: Specifies a translation in base-space.
blur: A non-negative number specifying the amount of blur.
colorvalue: Specifies the color of the shadow, which may contain a non-opaque alpha value. If nil, then shadowing is disabled.

See also SetShadow.

CGContextMBS.SetShouldSmoothFonts(shouldSmoothFonts as boolean)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 7.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Whether font smoothing is enabled.

Turn on font smoothing if shouldSmoothFonts is true; turn it off otherwise. This parameter is part of the graphics state. Note that this doesn't guarantee that font smoothing will occur: not all destination contexts support font smoothing.
Requires Mac OS X 10.2.

CGContextMBS.SetStrokeColor(color as CGColorMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 17.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the given color as stroke color.

CGContextMBS.SetStrokeColorSpace(colorspace as CGColorSpaceMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 4.3 ✅ Yes ❌ No ❌ No ✅ Yes All
Sets the colorspace used for the stroke color of the graphics context.

CGContextMBS.ShowText(text as string)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Draw 'string' at the point specified by the current text matrix.

Each byte of the string is mapped through the encoding vector of the current font to obtain the glyph to display.
This function is more for quick and dirty text output, but not for serious drawing as it does not do most unicode strings correctly. Use ATS for better drawing.

Some RB 5.x versions show a bug that the text is not displayed on a CGContext in while running the application in debug mode.

CGContextMBS.ShowTextAtPoint(text as string, x as Double, y as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Draw 'string' at the point '(x, y)', specified in user space.

Each byte of the string is mapped through the encoding vector of the current font to obtain the glyph to display.
This function is more for quick and dirty text output, but not for serious drawing as it does not do most unicode strings correctly. Use ATS for better drawing.

Some RB 5.x versions show a bug that the text is not displayed on a CGContext in while running the application in debug mode.

Some examples using this method:

CGContextMBS.StrokeEllipseInRect(rect as CGRectMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 8.0 ✅ Yes ❌ No ❌ No ✅ Yes All
Stroke an ellipse (an oval) inside rect.

Requires Mac OS X 10.4.

CGContextMBS.StrokePath

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Stroke the context's path.
Example
Var c as CGContextMBS

c=window1.CGContextMBS

c.SetRGBStrokeColor 1,0,0,1
c.BeginPath
c.MoveToPoint 0,0
c.AddLineToPoint 100,100
c.StrokePath
c.Flush

CGContextMBS.StrokeRect(rect as CGRectMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Stroke 'rect' with the current stroke color and the current linewidth.

CGContextMBS.StrokeRectWithWidth(rect as CGRectMBS, width as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Stroke 'rect' with the current stroke color, using 'width' as the the line width.

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

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 8.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Draws the frame for the round rectangle.
Example
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.Synchronize

Type Topic Plugin Version macOS Windows Linux iOS Targets
method CoreGraphics MBS MacCG Plugin 2.7 ✅ Yes ❌ No ❌ No ✅ Yes All
Synchronizes the context with the device.

The items on this page are in the following plugins: MBS MacCG Plugin.


The biggest plugin in space...