Platforms to show: All Mac Windows Linux Cross-Platform
Back to NSGraphicsMBS class.
NSGraphicsMBS.addClip(path as NSBezierPathMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This method uses the current winding rule to determine the clipping shape of the receiver. This method does not affect the receiver's path.
NSGraphicsMBS.boundingRectWithSize(text as NSAttributedStringMBS, size as NSSizeMBS, options as Integer = 0) as NSRectMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.4 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
size: The size of the rectangle to draw in.
options: The string drawing options.
Returns the bounding rectangle in the current graphics context.
The origin of the rectangle returned from this method is the first glyph origin.
See also:
Some examples using this method:
NSGraphicsMBS.boundingRectWithSize(text as string, size as NSSizeMBS, options as Integer = 0, DicAttributes as dictionary = nil) as NSRectMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
text: the text to use for calculation.
size: The size of the rectangle to draw in.
options: String drawing options.
attributes: A dictionary of text attributes to be applied to the string. These are the same attributes that can be applied to an NSAttributedString object, but in the case of Strings, the attributes apply to the entire string, rather than ranges within the string.
Returns the bounding rect for the receiver drawn using the given options and display characteristics. The rect origin returned from this method is the first glyph origin.
Available in Mac OS X v10.4 and later.
See NSStringDrawing* constants. Use NSStringDrawingUsesLineFragmentOrigin to switch to multiline mode.
See also:
NSGraphicsMBS.clipRect(r as NSRectMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
r: The rectangle to intersect with the current clipping path.
NSGraphicsMBS.concat(transform as NSAffineTransformMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 15.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
NSGraphicsMBS.ConcatTransform(NSAffineTransform as Variant)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Please use saveGraphicsState so you can restore the state before applying matrix for other drawings.
Concatenation is performed by matrix multiplication.
If this method is invoked from within an NSView drawRect method, then the current transformation matrix is an accumulation of the screen, window, and any superview's transformation matrices. Invoking this method defines a new user coordinate system whose coordinates are mapped into the former coordinate system according to the receiver's transformation matrix. To undo the concatenation, you must invert the receiver's matrix and invoke this method again.
NSAffineTransform must be a NSAffineTransformMBS object.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
See also:
NSGraphicsMBS.Constructor(targetImage as NSBitmapImageRepMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.3 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Please make sure the graphics object is destroyed (Set to nil) so the drawings flush to the image.
Returns nil on any error.
See also:
NSGraphicsMBS.Constructor(targetImage as NSImageMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Please make sure the graphics object is destroyed (Set to nil) so the drawings flush to the image.
See also:
NSGraphicsMBS.Constructor(targetView as NSViewMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Please make sure the graphics object is destroyed (Set to nil) so the drawings flush to the window.
See also:
NSGraphicsMBS.Constructor(targetWindow as DesktopWindow)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 22.0 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
See also:
NSGraphicsMBS.Constructor(targetWindow as NSWindowMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
See also:
NSGraphicsMBS.Constructor(targetWindow as window)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
See also:
NSGraphicsMBS.drawAtPoint(image as NSImageMBS, x as Double, y as Double, sx as Double, sy as Double, sw as Double, sh as Double, Operation as Integer, fraction as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
x/y: The location in the current coordinate system at which to draw the image.
sx/sy/sw/sh: The source rectangle specifying the portion of the image you want to draw. The coordinates of this rectangle are specified in the image's own coordinate system. If you pass in zeros, the entire image is drawn.
operation: The compositing operation to use when drawing the image. See the NSCompositingOperation constants.
fraction: The opacity of the image, specified as a value from 0.0 to 1.0. Specifying a value of 0.0 draws the image as fully transparent while a value of 1.0 draws the image as fully opaque. Values greater than 1.0 are interpreted as 1.0.
The image content is drawn at its current resolution and is not scaled unless the CTM of the current coordinate system itself contains a scaling factor. The image is otherwise positioned and oriented using the current coordinate system.
For Operation you use the Composite constants in this class.
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
See also:
- drawAtPoint(text as NSAttributedStringMBS, point as NSPointMBS)
- drawAtPoint(text as string, point as NSPointMBS, DicAttributes as dictionary = nil)
Some examples using this method:
- /MacBase/Custom NSWindows/NSWindow with Pattern/Pattern NSWindow
- /MacCocoa/NSStatusItem/StatusItem with Image in menu
- /MacCocoa/NSStatusItem/StatusItem with NSView
- /MacCocoa/NSWindow transparent
- /PDFKit/Create Page
- /PDFKit/Create Page with custom stamp annotation
- /PDFKit/Create Page with Page
- /PDFKit/PDFView/PDFView customized with picture overlay
NSGraphicsMBS.drawAtPoint(text as NSAttributedStringMBS, point as NSPointMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.4 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
point: The point in the current view to draw the text.
The width (height for vertical layout) of the rendering area is unlimited, unlike drawInRect, which uses a bounding rectangle. As a result, this method renders the text in a single line.
Don't invoke this method when no NSView is focused.
See also:
NSGraphicsMBS.drawAtPoint(text as string, point as NSPointMBS, DicAttributes as dictionary = nil)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Point: The origin for the bounding box for drawing the string. If the focused view is flipped, the origin is the upper-left corner of the drawing bounding box; otherwise, the origin is the lower-left corner.
attributes: A dictionary of text attributes to be applied to the string. These are the same attributes that can be applied to an NSAttributedString object, but in the case of strings, the attributes apply to the entire string, rather than ranges within the string.
The width (height for vertical layout) of the rendering area is unlimited, unlike drawInRect, which uses a bounding rectangle. As a result, this method renders the text in a single line.
You should only invoke this method when an NSView object has focus.
See also:
NSGraphicsMBS.drawInRect(image as NSImageMBS, x as Double, y as Double, w as Double, h as Double, sx as Double, sy as Double, sw as Double, sh as Double, Operation as Integer, fraction as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
For Operation you use the Composite constants in this class.
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
See also:
- drawInRect(text as NSAttributedStringMBS, rect as NSRectMBS)
- drawInRect(text as string, rect as NSRectMBS, DicAttributes as dictionary = nil)
Some examples using this method:
- /MacBase/Custom NSWindows/NSWindow like AppStore/AppStore NSWindow
- /MacBase/Custom NSWindows/NSWindow with Pattern/Pattern NSWindow
- /MacCocoa/Custom NSViewControl Drag
- /MacControls/Custom NSView Drag
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
- /MacFrameworks/CustomNSScroller/Dark scrollbar
- /PDFKit/PDFView/PDFView overlay/PDFViewControl overlay
NSGraphicsMBS.drawInRect(text as NSAttributedStringMBS, rect as NSRectMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.4 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
rect: The rectangle in which to draw.
Text is drawn within rect according to its line sweep direction; for example, Arabic text will begin at the right edge and potentially be clipped on the left.
The rect parameter determines how many glyphs are typeset within the width of a line, but it's possible for a portion of a glyph to appear outside the area of rect if the image bounding box of the particular glyph exceeds its typographic bounding box.
If the focus view is flipped, the text origin is set at the upper-left corner of the drawing bounding box; otherwise the origin is set at the lower-left corner. For text rendering, whether the view coordinates are flipped or not doesn't affect the flow of line layout, which goes from top to bottom. However, it affects the interpretation of the text origin. So, for example, if the rect argument is {0.0, 0.0, 100.0, 100.0}, the text origin is {0.0, 0.0} when the view coordinates are flipped and {0.0, 100.0} when not.
Don't invoke this method when no NSView is focused.
See also:
NSGraphicsMBS.drawInRect(text as string, rect as NSRectMBS, DicAttributes as dictionary = nil)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
text: The text to draw.
Rect: The rectangle in which to draw the string.
attributes: A dictionary of text attributes to be applied to the string. These are the same attributes that can be applied to an NSAttributedString object, but in the case of strings, the attributes apply to the entire string, rather than ranges within the string.
The rendering area is bounded by rect, unlike drawAtPoint, which has an unlimited width. As a result, this method renders the text in multiple lines.
You should only invoke this method when an NSView has focus.
See also:
NSGraphicsMBS.drawPicture(image as Picture, x as Double, y as Double, w as Double, h as Double, sx as Double, sy as Double, sw as Double, sh as Double, Operation as Integer, fraction as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Same as drawInRect with NSImageMBS, but using picture.
NSGraphicsMBS.drawRect(x as Double, y as Double, w as Double, h as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
NSGraphicsMBS.DrawWindowBackground(x as Double, y as Double, w as Double, h as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Pass the rectangle (in the current coordinate system) in which to draw the window's background pattern.
NSGraphicsMBS.drawWithRect(text as NSAttributedStringMBS, rect as NSRectMBS, options as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.4 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
rect: The rectangle specifies the rendering origin in the current graphics context.
options: The string drawing options. See NSStringDrawingOptions for the available options..
The rect argument's origin field specifies the rendering origin. The point is interpreted as the baseline origin by default. With NSStringDrawingUsesLineFragmentOrigin, it is interpreted as the upper left corner of the line fragment rect. The size field specifies the text container size. The width part of the size field specifies the maximum line fragment width if larger than 0.0. The height defines the maximum size that can be occupied with text if larger than 0.0 and NSStringDrawingUsesLineFragmentOrigin is specified. If NSStringDrawingUsesLineFragmentOrigin is not specified, height is ignored and considered to be single-line rendering (NSLineBreakByWordWrapping and NSLineBreakByCharWrapping are treated as NSLineBreakByClipping).
You should only invoke this method when there is a current graphics context.
Available in OS X v10.4 and later.
NSGraphicsMBS.eraseRect(x as Double, y as Double, w as Double, h as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
NSGraphicsMBS.fill(path as NSBezierPathMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This method fills the path using the current fill color and the receiver's current winding rule. If the path contains any open subpaths, this method implicitly closes them before painting the fill region.
The painted region includes the pixels right up to, but not including, the path line itself. For paths with large line widths, this can result in overlap between the fill region and the stroked path (which is itself centered on the path line).
NSGraphicsMBS.fillRect(r as NSRectMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
r: A rectangle in the current coordinate system.
This method fills the specified region immediately. This method uses the compositing operation returned by the compositingOperation method of NSGraphicsContext.
See also:
NSGraphicsMBS.fillRect(x as Double, y as Double, w as Double, h as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
See also:
NSGraphicsMBS.fillRect(x as Double, y as Double, w as Double, h as Double, operation as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 11.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
See NSComposite* constants.
See also:
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Graphics contexts use buffers to queue pending operations but for efficiency reasons may not always empty those buffers immediately. This method forces the buffers to be emptied.
Some examples using this method:
NSGraphicsMBS.graphicsPort as Variant
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In Mac OS X, this is the Core Graphics context, a CGContextMBS object.
NSGraphicsMBS.highlightRect(x as Double, y as Double, w as Double, h as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 7.7 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In the Cocoa world the y axis is reversed. y=0 is on the bottom.
NSGraphicsMBS.imageInterpolation as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Note that this value is not part of the graphics state, so it cannot be reset using restoreGraphicsState.
(Read and Write computed property)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
NSGraphicsMBS.isDrawingToScreen as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
True if the drawing destination is the screen, otherwise false.
A return value of false may mean that the drawing destination is a printer, but the destination may also be a PDF or EPS file. If this method returns false, you can call attributes to see if additional information is available about the drawing destination.
NSGraphicsMBS.isFlipped as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
True if the receiver is flipped, otherwise false.
The state is determined by sending isFlipped to the receiver's view that has focus. If no view has focus, returns false unless the receiver is instantiated using graphicsContextWithGraphicsPort:flipped: specifying true as the flipped parameter.
Available in Mac OS X v10.4 and later.
NSGraphicsMBS.restoreGraphicsState
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This method must have been preceded with a saveGraphicsState message to add the graphics state to the stack. Invocations of saveGraphicsState and restoreGraphicsState methods may be nested.
Restoring the graphics state restores such attributes as the current drawing style, transformation matrix, color, and font of the original graphics state.
Some examples using this method:
NSGraphicsMBS.saveGraphicsState
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 10.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This method pushes the context onto the per-thread stack.
Some examples using this method:
NSGraphicsMBS.ScaleCoordinates(x as Double, y as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 12.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Use saveGraphicsState and restoreGraphicsState so you can restore the old state.
Some examples using this method:
NSGraphicsMBS.set(transform as NSAffineTransformMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacCocoa Plugin | 15.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The items on this page are in the following plugins: MBS MacCocoa Plugin.