NSBitmap object created from a Core Image object.
- macOS 10.5+
A Core Image object whose contents are to be copied to the receiver. This image rectangle must be of a finite size.
NSBitmap object initialized from the contents of the Core Image (
The image in the
ci parameter must be fully rendered before the receiver can be initialized. If you specify an object whose rendering was deferred (and thus does not have any pixels available now), this method forces the image to be rendered immediately. Rendering the image could result in a performance penalty if the image has a complex rendering chain or accelerated rendering hardware is not available. Rendering uses the current graphics context in the thread from which this method is called; to ensure consistent results across multiple threads, set the current context using the
NSGraphics class before calling this method.
By the time this method returns, the resultant
NSBitmap object can have its raw pixel data inspected, can be put on the pasteboard, and can be encoded to any of the standard image formats that
NSBitmap supports (JPEG, TIFF, and so on.)
If you pass in a
CIImage object whose extents are not finite, this method raises an exception.