NSGraphicsMBS.addClip(path as NSBezierPathMBS)

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

// create Hello World in red
Var a as NSAttributedStringMBS = NSAttributedStringMBS.attributedStringWithString("Hello World")
Var m as NSMutableAttributedStringMBS = a.mutableCopy

m.addAttribute(a.NSForegroundColorAttributeName, NSColorMBS.redColor, new NSRangeMBS(0, m.length))

// query size
Var g as new NSGraphicsMBS(Canvas1.NSViewMBS)
Var r as NSRectMBS = g.boundingRectWithSize(m, new NSSizeMBS(canvas1.Width, canvas1.Height), g.NSStringDrawingUsesLineFragmentOrigin)

MsgBox r.String

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:

• boundingRectWithSize(text as string, size as NSSizeMBS, options as Integer = 0, DicAttributes as dictionary = nil) as NSRectMBS

NSGraphicsMBS.boundingRectWithSize(text as string, size as NSSizeMBS, options as Integer = 0, DicAttributes as dictionary = nil) as NSRectMBS

Var NSGraphics as New NSGraphicsMBS()
Var size as NSSizeMBS = new NSSizeMBS(100,100)
Var text as string = "Hello World. How are you? I'm fine. This is just a test string."
Var options as Integer = NSGraphics.NSStringDrawingUsesLineFragmentOrigin
Var rect as NSRectMBS = NSGraphics.boundingRectWithSize(text, size, options)

MsgBox str(Rect.Width)+" "+str(Rect.Height)

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:

• boundingRectWithSize(text as NSAttributedStringMBS, size as NSSizeMBS, options as Integer = 0) as NSRectMBS

NSGraphicsMBS.eraseRect(x as Double, y as Double, w as Double, h as Double)

In the Cocoa world the y axis is reversed. y=0 is on the bottom.

NSGraphicsMBS.fill(path as NSBezierPathMBS)

Var n as new NSImageMBS(300, 300)
Var g as new NSGraphicsMBS(n)

g.setFillColor NSColorMBS.redColor

Var r as NSRectMBS = NSMakeRectMBS(50, 50, 100, 100)
Var b as NSBezierPathMBS = NSBezierPathMBS.bezierPathWithRect(r)
g.fill(b)

g = nil

window1.Backdrop = n.CopyPicture // black image with red color rect

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)

Var n as new NSImageMBS(300, 300)
Var g as new NSGraphicsMBS(n)

g.setFillColor NSColorMBS.redColor

Var r as new NSRectMBS(10,10,200,200)
g.fillRect(r)

g = nil

window1.Backdrop = n.CopyPicture // black image with red color rectangle

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:

• fillRect(x as Double, y as Double, w as Double, h as Double)
• fillRect(x as Double, y as Double, w as Double, h as Double, operation as Integer)

NSGraphicsMBS.fillRect(x as Double, y as Double, w as Double, h as Double)

In the Cocoa world the y axis is reversed. y=0 is on the bottom.

See also:

• fillRect(r as NSRectMBS)
• fillRect(x as Double, y as Double, w as Double, h as Double, operation as Integer)

NSGraphicsMBS.fillRect(x as Double, y as Double, w as Double, h as Double, operation as Integer)

See NSComposite* constants.

See also:

• fillRect(r as NSRectMBS)
• fillRect(x as Double, y as Double, w as Double, h as Double)

NSGraphicsMBS.flushGraphics

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:

• /MacCocoa/RTF Printing

NSGraphicsMBS.graphicsPort as Variant

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)

In the Cocoa world the y axis is reversed. y=0 is on the bottom.

NSGraphicsMBS.imageInterpolation as Integer

Note that this value is not part of the graphics state, so it cannot be reset using restoreGraphicsState.
(Read and Write computed property)

NSGraphicsMBS.invalidate

NSGraphicsMBS.isDrawingToScreen as boolean

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

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

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:

• /MacBase/Custom NSWindows/NSWindow like AppStore/AppStore NSWindow
• /MacBase/Custom NSWindows/NSWindow with Pattern/Pattern NSWindow
• /PDFKit/Create Page with Page
• /PDFKit/PDFView/PDFView customized
• /PDFKit/PDFView/PDFView customized with picture overlay

NSGraphicsMBS.TranslateCoordinates(x as Double, y as Double)

Use saveGraphicsState and restoreGraphicsState so you can restore the old state.

Some examples using this method:

• /PDFKit/Create Page with Page