NSImageMBS.cancelIncrementalLoad

This call has no effect if the image is not loading.

NSImageMBS.Constructor

See also:

• Constructor(data as Memoryblock)
• Constructor(file as folderitem)
• Constructor(image as Picture, mask as picture = nil)
• Constructor(width as Double, height as Double)

NSImageMBS.Constructor(data as Memoryblock)

Calls initWithData.
On success the image is valid and the handle is not zero.

See also:

• Constructor
• Constructor(file as folderitem)
• Constructor(image as Picture, mask as picture = nil)
• Constructor(width as Double, height as Double)

NSImageMBS.Constructor(file as folderitem)

Calls initWithContentsOfURL.
On success the image is valid and the handle is not zero.

See also:

• Constructor
• Constructor(data as Memoryblock)
• Constructor(image as Picture, mask as picture = nil)
• Constructor(width as Double, height as Double)

NSImageMBS.Constructor(image as Picture, mask as picture = nil)

Var img as new NSImageMBS(pict)

Optional you can pass a picture with the mask. It is valid to use the mask property of the image for the second parameter.

With 11.3 plugins we are deprecating to pass a mask. The plugin prefers to simply take the mask or alpha channel of the picture itself.

On success the image is valid and the handle is not zero.
Calls initWithPicture.

See also:

• Constructor
• Constructor(data as Memoryblock)
• Constructor(file as folderitem)
• Constructor(width as Double, height as Double)

NSImageMBS.Constructor(width as Double, height as Double)

Calls initWithSize.
On success the image is valid and the handle is not zero.

See also:

• Constructor
• Constructor(data as Memoryblock)
• Constructor(file as folderitem)
• Constructor(image as Picture, mask as picture = nil)

NSImageMBS.CopyMask as picture

Var f as FolderItem
Var n as NSImageMBS

f=SpecialFolder.Desktop.Child("test.png")
n=new NSImageMBS(f)
Backdrop=n.CopyMask

Copies only the alpha channel as mask.
Returns nil on any error.

Not implemented for iOS.

NSImageMBS.CopyPicture(CGColorSpace as Variant = nil, BackgroundColor as NSColorMBS = nil) as picture

Var f as FolderItem
Var n as NSImageMBS

f=SpecialFolder.Desktop.Child("test.png")
n=new NSImageMBS(f)
Backdrop=n.CopyPicture // background is black

A convenience function instead of using CGPictureContextMBS with DrawIntoCGContextAtRect.

Returns nil on any error.

With Colorspace parameter you can pass a RGB CGColorspace to define which colorspace is used. Default is DeviceRGB, but you could also pass generic RGB or other.

If BackgroundColor is not nil, the image is filled in background with this color and NSImage rendered on top of it.

Implemented for iOS in v22.4 to return underlaying UIImage as Xojo picture. Colorspace and background are ignored as picture is passed directly.

NSImageMBS.CopyPictureRect(x as Integer, y as Integer, w as Integer, h as Integer, CGColorSpace as Variant = nil, BackgroundColor as NSColorMBS = nil) as picture

Var f as FolderItem
Var n as NSImageMBS

f=SpecialFolder.Desktop.Child("test.png")
n=new NSImageMBS(f)
Backdrop=n.CopyPicture // background is black

A convenience function instead of using CGPictureContextMBS with DrawIntoCGContextAtRect.

Returns nil on any error.

With Colorspace parameter you can pass a RGB CGColorspace to define which colorspace is used. Default is DeviceRGB, but you could also pass generic RGB or other.

If BackgroundColor is not nil, the image is filled in background with this color and NSImage rendered on top of it.

Not implemented for iOS.

NSImageMBS.CopyPictureWithAlpha as picture

This is a function for Cocoa target which returns picture with alpha channel.
Returns nil on any error.

Not implemented for iOS.

NSImageMBS.CopyPictureWithAlphaRect(x as Integer, y as Integer, w as Integer, h as Integer) as picture

This is a function for Cocoa target which returns picture with alpha channel.
Returns nil on any error.

Not implemented for iOS.

NSImageMBS.CopyPictureWithMask(CGColorSpace as Variant = nil) as picture

Var f as FolderItem
Var n as NSImageMBS

f=SpecialFolder.Desktop.Child("test.png")
n=new NSImageMBS(f)
Backdrop=n.CopyPictureWithMask

Copies the picture and its mask.
This function is faster than CopyPicture and CopyMask combined as the picture is only copied one time to an internal buffer.

A convenience function instead of using CGPictureContextMBS with DrawIntoCGContextAtRect.

Returns nil on any error.

With Colorspace parameter you can pass a RGB CGColorspace to define which colorspace is used. Default is DeviceRGB, but you could also pass generic RGB or other.

Not implemented for iOS.