CIFilterMBS.filterArrayFromSerializedXMP(xmpData as MemoryBlock, extent as CGRectMBS, byref NSError as Variant) as CIFilterMBS()

xmpData: The XMP data created previously by calling serializedXMPFromFilters.
extent: The extent of the image from which the XMP data was extracted.
e: The address of an variant for receiving errors, otherwise nil. This is a NSErrorMBS.

Available in OS X v10.9 and later.

CIFilterMBS.FilterNamesInCategories(categories() as String) as string()

categories: string array with the constants kCICategory*.
Returns nil on any error.

CIFilterMBS.FilterNamesInCategory(category as String) as string()

// load list of filters into Listbox

Var a() as string
Var cf as CIFilterMBS

// get all image categories
a=ciFilterMBS.FilterNamesInCategory(CIFilterMBS.kCICategoryStillImage)

StaticText1.text=str(UBound(a))+" filters."

for each s as string in a
  
  // add to listbox
  Listbox1.AddRow s
  
  // load this filter
  cf=CIFilterMBS.FilterWithName(s)
  
  // And look into the attributes for the Displayname
  if cf<>nil then
    Listbox1.cell(Listbox1.LastIndex,1)=cf.DisplayName
  end if
next

nil on any error.

Some examples using this method:

• /MacCG/CoreImage/Filter List

CIFilterMBS.FilterWithHandle(handle as Integer) as CIFilterMBS

// some filter
Var x as new CIFilterCropMBS

// create a copy
Var f as CIFilterMBS = CIFilterMBS.FilterWithHandle(x.Handle)

// and show name
MsgBox f.FilterName

The object is retained.
Returns nil on error.

CIFilterMBS.filterWithImageData(Data as MemoryBlock, options as Dictionary) as CIFilterMBS

Note that when using this initializer, you should pass in a source type identifier hint (kCGImageSourceTypeIdentifierHint) key/value pair in order to help the decoder determine the file type, as otherwise confusion and incorrect results are possible.

CIFilterMBS.filterWithImageFile(File as FolderItem, options as Dictionary) as CIFilterMBS

Some examples using this method:

• /MacCG/CoreImage/Load Raw File

CIFilterMBS.filterWithImageURL(URL as String, options as Dictionary) as CIFilterMBS

CIFilterMBS.FilterWithName(name as String) as CIFilterMBS

Var cf as CIFilterMBS
// load this filter
cf=CIFilterMBS.FilterWithName("CIAffineTile")

Returns filter object for the name if found.

See also:

• FilterWithName(name as String, options as Dictionary) as CIFilterMBS

CIFilterMBS.FilterWithName(name as String, options as Dictionary) as CIFilterMBS

The filter's input parameters are set from the dictionary of key-value pairs.
On OSX, any of the filter input parameters not specified in the dictionary will be undefined.
On iOS, any of the filter input parameters not specified in the dictionary will be set to default values.
Available in macOS 10.10 or newer.

See also:

• FilterWithName(name as String) as CIFilterMBS

CIFilterMBS.kCIActiveKeys as String

Read-only array containing a list of keys that affect the output image.
Depending on the RAW decoder version (kCIInputDecoderVersionKey) and the input image type, some input keys might have no effect.

CIFilterMBS.kCIApplyOptionColorSpace as String

If used, the value of the kCIApplyOptionColorSpace key be must be an RGB CGColorSpaceMBS.
Using this option specifies that the output of the kernel is in this color space.
If not specified, the output of the kernel is in the working color space of the rendering CIContextMBS.

CIFilterMBS.kCIApplyOptionDefinition as String

CIFilterMBS.kCIApplyOptionExtent as String

CIFilterMBS.kCIApplyOptionUserInfo as String

CIFilterMBS.kCIAttributeClass as String

The class name of the filter.

CIFilterMBS.kCIAttributeDefault as String

The default value, specified as a floating-point value, for a filter parameter.

CIFilterMBS.kCIAttributeDescription as String

The localized description of the filter. This description should inform the end user what the filter does and be short enough to display in the user interface for the filter. It is not intended to be technically detailed.

CIFilterMBS.kCIAttributeDisplayName as String

The localized version of the filter name that is displayed in the user interface.

CIFilterMBS.kCIAttributeFilterAvailable_iOS as String

The iOS version in which the filter first became available, specified as a string.

CIFilterMBS.kCIAttributeFilterAvailable_Mac as String

The OS X version in which the filter first became available, specified as a string.

CIFilterMBS.kCIAttributeFilterCategories as String

An array of filter category keys that specifies all the categories in which the filter is a member.

CIFilterMBS.kCIAttributeFilterDisplayName as String

The localized display name of the attribute.

CIFilterMBS.kCIAttributeFilterName as String

CIFilterMBS.kCIAttributeIdentity as String

If supplied as a value for a parameter, the parameter has no effect on the input image.

CIFilterMBS.kCIAttributeMax as String

The maximum value for a filter parameter, specified as a floating-point value.

CIFilterMBS.kCIAttributeMin as String

The minimum value for a filter parameter, specified as a floating-point value.

CIFilterMBS.kCIAttributeName as String

The name of the attribute.

CIFilterMBS.kCIAttributeReferenceDocumentation as String

The localized reference documentation for the filter. The reference should provide developers with technical details.

CIFilterMBS.kCIAttributeSliderMax as String

The maximum value, specified as a floating-point value, to use for a slider that controls input values for a filter parameter.

CIFilterMBS.kCIAttributeSliderMin as String

The minimum value, specified as a floating-point value, to use for a slider that controls input values for a filter parameter.

CIFilterMBS.kCIAttributeType as string

An attribute may have a type which defines what kind this attribute type is.
e.g. a number attribute may be a time or a distance.

CIFilterMBS.kCIAttributeTypeAngle as String

An angle.

CIFilterMBS.kCIAttributeTypeBoolean as String

A Boolean value.

CIFilterMBS.kCIAttributeTypeColor as String

A Core Image color (CIColor object) that specifies red, green, and blue component values.

CIFilterMBS.kCIAttributeTypeCount as String

A positive integer value.

CIFilterMBS.kCIAttributeTypeDistance as String

A distance.

CIFilterMBS.kCIAttributeTypeGradient as String

An n-by-1 gradient image used to describe a color ramp.

CIFilterMBS.kCIAttributeTypeImage as String

A CIImage object.

CIFilterMBS.kCIAttributeTypeInteger as String

An integer value.

CIFilterMBS.kCIAttributeTypeOffset as String

An offset. (A 2-element vector type.)

CIFilterMBS.kCIAttributeTypeOpaqueColor as String

A Core Image color (CIColor object) that specifies red, green, and blue component values. Use this key for colors with no alpha component. If the key is not present, Core Image assumes color with alpha.

CIFilterMBS.kCIAttributeTypePosition as String

A two-dimensional location in the working coordinate space. (A 2-element vector type.)

CIFilterMBS.kCIAttributeTypePosition3 as String

A three-dimensional location in the working coordinate space. (A 3-element vector type.)

CIFilterMBS.kCIAttributeTypeRectangle as String

A Core Image vector that specifies the x and y values of the rectangle origin, and the width (w) and height (h) of the rectangle. The vector takes the form [x, y, w, h]. (A 4-element vector type.)

CIFilterMBS.kCIAttributeTypeScalar as String

A scalar value.

CIFilterMBS.kCIAttributeTypeTime as String

A parametric time for transitions, specified as a floating-point value in the range of 0.0 to 1.0.

CIFilterMBS.kCIAttributeTypeTransform as String

An CGAffineTransform is associated with attribute.

CIFilterMBS.kCICategoryBlur as String

A filter that softens images, decreasing the contrast between the edges in an image. Examples of blur filters are Gaussian blur and zoom blur.

CIFilterMBS.kCICategoryBuiltIn as String

A filter provided by Core Image. This distinguishes built-in filters from plug-in filters.