CIImageMBS.AsNSImageMBS as Variant

// make a dummy CIImage
Var Logo as Picture = LogoMBS(500)
Var jpeg as string = PictureToJPEGStringMBS(logo, 80)
Var ci as CIImageMBS = CIImageMBS.imageWithData(jpeg)

// convert to NSImage
Var ni as NSImageMBS = ci.AsNSImageMBS

// and display
Backdrop = ni.CopyPictureWithMask

Returns nil on error.
Result declared as Variant to avoid plugin dependencies.

CIImageMBS.autoAdjustmentFilters as CIFilterMBS()

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var image as CIImageMBS = CIImageMBS.imageWithContentsOfFile(f)

Var filters() as CIFilterMBS = image.autoAdjustmentFilters

Var beginImage as CIImageMBS = image
for each filter as CIFilterMBS in filters
  filter.ValueAsCIImage("inputImage") = beginImage
  beginImage = filter.ValueAsCIImage("outputImage")
next

Backdrop = beginImage.RenderPicture

An array of auto adjustment filters to apply to the image. The filters are preset with values for correcting deficiencies in the supplied image.

CIImageMBS.autoAdjustmentFiltersWithOptions(options as dictionary) as CIFilterMBS()

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var image as CIImageMBS = CIImageMBS.imageWithContentsOfFile(f)

Var options as new Dictionary
options.Value(CIImageMBS.kCIImageAutoAdjustEnhance) = true
options.Value(CIImageMBS.kCIImageAutoAdjustRedEye) = true

Var filters() as CIFilterMBS = image.autoAdjustmentFiltersWithOptions(options)

Var beginImage as CIImageMBS = image
for each filter as CIFilterMBS in filters
  filter.ValueAsCIImage("inputImage") = beginImage
  beginImage = filter.ValueAsCIImage("outputImage")
next

Backdrop = beginImage.RenderPicture

options: You can control which filters are returned by supplying one or more of the keys described in "Auto Adjustment Keys."
The options dictionary can also contain a CIDetectorImageOrientation key. This key is a number with the same value as defined by the TIFF and EXIF specifications; values can range from 1 through 8. The value specifies where the origin (0,0) of the image is located. If not present, the default value is 1, which means the origin of the image is top, left. For details on the image origin specified by each value, see kCGImagePropertyOrientation.

Returns an array of auto adjustment filters, filtered by the supplied options, to apply to the image. The filters are preset with values for correcting deficiencies in the supplied image.

CIImageMBS.imageByApplyingOrientation(orientation as Integer) as CIImageMBS

// use CIImage to rotate to always be top left orientation
Var ciImage As CIImageMBS = New CIImageMBS(file)

Var orientation As Integer = ciImage.properties.Lookup("Orientation", 0)
if orientation <> 0 then
  ciImage = ciImage.imageByApplyingOrientation(orientation)
end if

Var cgPic As CGImageMBS = ciImage.CreateCGImage
Var pic As Picture = cgPic.Picture
ImageViewer1.Image = pic

Orientation values from 1 to 8 as defined in the TIFF spec are supported.
Returns original image if the image is of infinite extent.

Possible orientation values:

Value	orientation	details
1	top left	row 0 top, col 0 lhs
2	top right	row 0 top, col 0 rhs
3	bottom right	row 0 bottom, col 0 rhs
4	bottom left	row 0 bottom, col 0 lhs
5	left top	row 0 lhs, col 0 top
6	right top	row 0 rhs, col 0 top
7	right bottom	row 0 rhs, col 0 bottom
8	left bottom	row 0 lhs, col 0 bottom

Some examples using this method:

• /iOS/Photo Picker/Photo Picker Desktop
• /iOS/Photo Picker/Photo Picker iOS
• /iOS/Photo Picker/PHPickerControl test
• /MacFrameworks/DetectDocumentSegmentationRequest

CIImageMBS.ImageByApplyingTransform(transform as NSAffineTransformMBS) as CIImageMBS

CIImageMBS.imageByClampingToExtent as CIImageMBS

CIImageMBS.imageByCompositingOverImage(dest as CIImageMBS) as CIImageMBS

dest: An image to serve as the destination of the compositing operation.

Returns an image object representing the result of the compositing operation.

Calling this method is equivalent to using the CISourceOverCompositing filter. To use other compositing operations and blending modes, create a CIFilter object using one of the built-in filters from the CICategoryCompositeOperation category. For details, see Core Image Filter Reference.

Available in OS X v10.4 and later.

CIImageMBS.imageByCroppingToRect(r as CGRectMBS) as CIImageMBS

Available in OS X v10.5 and later.

CIImageMBS.properties as Dictionary

If the image is the output of one or more CIFilters, then the metadata of the root inputImage will be returned.

CIImageMBS.releaseHandle

Each retain must have a release. Too many releases and your app will crash, too many retains and it will leak memory.
Use only if you really know what you are doing.

CIImageMBS.RenderNSImage(UseSoftwareRenderer as boolean = false) as Variant

Var f as CIFilterEdgesMBS

f=new CIFilterEdgesMBS
f.inputImage=NewCIImagewithFileMBS(SpecialFolder.Desktop.Child("Paris.jpg"))
f.inputIntensity=5

Var n as NSImageMBS
n=f.outputImage.RenderNSImage(false)

Creates a new NSImage, creates a CGContext for it, draws the image into the buffer and returns it as a Xojo object.

Returns nil on failure.
Rendering the image will cause the calculations to be done so this call is quite expensive.

If UseSoftwareRenderer is true, the hardware acceleration is not used.

Some examples using this method:

• /Images/JPEG/Quickly generate previews for JPEG and Tiff
• /Images/Tiff/Quickly generate previews for JPEG and Tiff
• /MacCI/CoreImage/Quickly generate previews for JPEG and Tiff
• /MacCI/CoreImage/Simple Filter Chain

CIImageMBS.RenderPicture(Width as Integer = 0, Height as Integer = 0, UseSoftwareRenderer as boolean = false) as Picture

Var f as CIFilterEdgesMBS

f=new CIFilterEdgesMBS
f.inputImage=NewCIImagewithFileMBS(SpecialFolder.Desktop.Child("Paris.jpg"))
f.inputIntensity=5
Backdrop=f.outputImage.RenderPicture

Creates a new image buffer, creates a CGContext for it, draws the image into the buffer and returns it as a picture with mask. If you need picture with alpha channel, please use RenderPictureWithAlpha function.

Returns nil on failure.
Rendering the image will cause the calculations to be done so this call is quite expensive.

If UseSoftwareRenderer is true, the hardware acceleration is not used.

Some examples using this method:

• /AVFoundation/CVPixelBuffer test
• /Mac64bit/CoreML/CoreML Test
• /MacCG/CoreGraphics DirectDisplay/CGDisplayStreamEvent test
• /MacCG/Open Image using CoreImage
• /MacCI/CoreImage/Barcode Generator
• /MacCI/CoreImage/Simple Filter Chain
• /MacCI/CoreImage/Simple Filter with Picture

CIImageMBS.RenderPictureWithAlpha(Width as Integer = 0, Height as Integer = 0, UseSoftwareRenderer as boolean = false) as Picture

Var f as CIFilterEdgesMBS

f=new CIFilterEdgesMBS
f.inputImage=NewCIImagewithFileMBS(SpecialFolder.Desktop.Child("Paris.jpg"))
f.inputIntensity=5
Backdrop= f.outputImage.RenderPictureWithAlphaMT

Creates a new image buffer, creates a CGContext for it, draws the image into the buffer and returns it as a Xojo picture with alpha channel.

Returns nil on failure.
Rendering the image will cause the calculations to be done so this call is quite expensive.

If UseSoftwareRenderer is true, the hardware acceleration is not used.

Some examples using this method:

• /MacFrameworks/DetectDocumentSegmentationRequest

CIImageMBS.RenderPictureWithAlphaMT(Width as Integer = 0, Height as Integer = 0, UseSoftwareRenderer as boolean = false) as Picture

Same as the other RenderPictureWithAlpha function, but threaded.

Creates a new image buffer, creates a CGContext for it, draws the image into the buffer and returns it as a Xojo picture with alpha channel.

Returns nil on failure.
Rendering the image will cause the calculations to be done so this call is quite expensive.

If UseSoftwareRenderer is true, the hardware acceleration is not used.

The work is performed on a preemptive thread, so this function does not block the application and can yield time to other Xojo threads. Must be called in a Xojo thread to enjoy benefits. If called in main thread will block, but keep other background threads running.
If you run several threads calling MT methods, you can get all CPU cores busy while main thread shows GUI with progress window.

CIImageMBS.retainHandle

Each retain must have a release. Too many releases and your app will crash, too many retains and it will leak memory.
Use only if you really know what you are doing.

CIImageMBS.scaleTo(width as Integer, height as Integer) as CIImageMBS

Var pic As Picture = LogoMBS(500)
Var image As CIImageMBS = CIImageMBS.imageWithPicture(pic)

Const targetWidth = 600.0
Const targetHeight = 400.0

#If mbs.VersionNumber < 21.2 Then
  
  Var filter As New CIFilterLanczosScaleTransformMBS
  
  Var scale As Double = targetHeight / image.Extent.Height
  Var aspect As Double = targetWidth / (image.Extent.Width * scale)
  
  filter.inputImage = image
  filter.inputScale = scale
  filter.inputAspectRatio = aspect
  
  Var outputImage As CIImageMBS = filter.outputImage
  
#Else
  
  Var outputImage As CIImageMBS = image.scaleTo(targetWidth, targetHeight)
  
#EndIf

Var result As Picture = outputImage.RenderPicture
Backdrop = result

We use CILanczosScaleTransform filter internally like in the example code for older plugin versions.