CGImageSourceMBS.CreateIncremental(options as dictionary=nil) as CGImageSourceMBS

options: A dictionary that specifies additional creation options. For example kCGImageSourceTypeIdentifierHint.

The function CreateIncremental creates an empty image source container to which you can add data later by calling the function UpdateData. You don't provide data when you call this function.

An incremental image is an image that is created in chunks, similar to the way large images viewed over the web are loaded piece by piece.

Available in Mac OS X version 10.4 and later.

CGImageSourceMBS.CreateThumbnailMT(data as MemoryBlock, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

Data contains the image file data.
ImageIndex is the index of the image in the file to query.
Options contains various flags for options to creating image source and creating thumbnail.

Returns nil in case of any error.

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.

See also:

• CreateThumbnailMT(data as String, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS
• CreateThumbnailMT(file as FolderItem, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

Some examples using this method:

• /MacCG/CGImageSource/CGImageSource Thumbnails Threaded

CGImageSourceMBS.CreateThumbnailMT(data as String, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

Data contains the image file data.
ImageIndex is the index of the image in the file to query.
Options contains various flags for options to creating image source and creating thumbnail.

Returns nil in case of any error.

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.

See also:

• CreateThumbnailMT(data as MemoryBlock, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS
• CreateThumbnailMT(file as FolderItem, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

CGImageSourceMBS.CreateThumbnailMT(file as FolderItem, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

File refers to image file on disk.
ImageIndex is the index of the image in the file to query.
Options contains various flags for options to creating image source and creating thumbnail.

Returns nil in case of any error.

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.

See also:

• CreateThumbnailMT(data as MemoryBlock, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS
• CreateThumbnailMT(data as String, ImageIndex as integer = 0, Options as dictionary = nil) as CGImageMBS

CGImageSourceMBS.CreateWithData(data as string, options as dictionary=nil) as CGImageSourceMBS

data: The data string to read from.
options: A dictionary that specifies additional creation options. For example kCGImageSourceTypeIdentifierHint.

Returns an image source.
Available in Mac OS X version 10.4 and later.

CGImageSourceMBS.CreateWithFile(file as folderitem, options as dictionary=nil) as CGImageSourceMBS

// get a picture file
dim file as FolderItem = SpecialFolder.Desktop.Child("sylwia.jpg")
// get image source
dim source as new CGImageSourceMBS(file)
// read image
dim image as CGImageMBS = source.CreateImageAtIndex(0)
// get Color space from image
dim profile as CGColorSpaceMBS = image.ColorSpace
// get ICC profile data
dim ICCProfile as string = profile.ICCProfile
// and parse it with LCMS and show name
dim LCMSProfile as LCMS2ProfileMBS = LCMS2ProfileMBS.OpenProfileFromString(ICCProfile)
MsgBox LCMSProfile.Name

url: The URL to read from.

options: A dictionary that specifies additional creation options. For example kCGImageSourceTypeIdentifierHint.

Returns an image source.

Available in Mac OS X version 10.4 and later.

CGImageSourceMBS.CreateWithURL(url as string, options as dictionary=nil) as CGImageSourceMBS

url: The URL to read from.

options: A dictionary that specifies additional creation options. For example kCGImageSourceTypeIdentifierHint.

On success the handle value is not zero.

Available in Mac OS X version 10.4 and later.

CGImageSourceMBS.kCGImageProperty8BIMDictionary as string

A dictionary of key-value pairs for an Adobe Photoshop image.

CGImageSourceMBS.kCGImageProperty8BIMLayerNames as string

The layer names for an Adobe Photoshop file.

CGImageSourceMBS.kCGImagePropertyCIFFCameraSerialNumber as string

The camera serial number.

CGImageSourceMBS.kCGImagePropertyCIFFContinuousDrive as string

The continuous drive mode.

CGImageSourceMBS.kCGImagePropertyCIFFDescription as string

The camera description..

CGImageSourceMBS.kCGImagePropertyCIFFDictionary as string

A dictionary of key-value pairs for an image that uses Camera Image File Format (CIFF).

Available in Mac OS X v10.5 and later.

CGImageSourceMBS.kCGImagePropertyCIFFFirmware as string

The firmware version.

CGImageSourceMBS.kCGImagePropertyCIFFFlashExposureComp as string

The flash exposure compensation.

CGImageSourceMBS.kCGImagePropertyCIFFFocusMode as string

The focus mode.

CGImageSourceMBS.kCGImagePropertyCIFFImageFileName as string

The image file name.

CGImageSourceMBS.kCGImagePropertyCIFFImageName as string

The image name.

CGImageSourceMBS.kCGImagePropertyCIFFImageSerialNumber as string

The image serial number.

CGImageSourceMBS.kCGImagePropertyCIFFLensMaxMM as string

The maximum lens length.

CGImageSourceMBS.kCGImagePropertyCIFFLensMinMM as string

The minimum lens length.

CGImageSourceMBS.kCGImagePropertyCIFFLensModel as string

The lens model.

CGImageSourceMBS.kCGImagePropertyCIFFMeasuredEV as string

The measured EV.

CGImageSourceMBS.kCGImagePropertyCIFFMeteringMode as string

The metering mode.

CGImageSourceMBS.kCGImagePropertyCIFFOwnerName as string

The owner name.

CGImageSourceMBS.kCGImagePropertyCIFFRecordID as string

The record ID

CGImageSourceMBS.kCGImagePropertyCIFFReleaseMethod as string

The release method.

CGImageSourceMBS.kCGImagePropertyCIFFReleaseTiming as string

The release timing.

CGImageSourceMBS.kCGImagePropertyCIFFSelfTimingTime as string

The self timing time.

CGImageSourceMBS.kCGImagePropertyCIFFShootingMode as string

The shooting mode.

CGImageSourceMBS.kCGImagePropertyCIFFWhiteBalanceIndex as string

The white balance index.

CGImageSourceMBS.kCGImagePropertyColorModel as string

The color model of the image such as, "RGB", "CMYK", "Gray", or "Lab". The value of this key is CFStringRef.

A color model describes how color values are represented mathematically. A color space is a color model combined with a definition of how to interpret values within the model.

Some examples using this method:

• /MacCG/CGImageSource/CGImageSource Convert

CGImageSourceMBS.kCGImagePropertyColorModelCMYK as string

A CMYK color model.

CGImageSourceMBS.kCGImagePropertyColorModelGray as string

A Gray color model.

Some examples using this method:

• /MacCG/CGImageSource/CGImageSource Convert

CGImageSourceMBS.kCGImagePropertyColorModelLab as string

A Lab color model.

CGImageSourceMBS.kCGImagePropertyColorModelRGB as string

An RGB color model.

Some examples using this method:

• /MacCG/CGImageSource/CGImageSource Convert

CGImageSourceMBS.kCGImagePropertyDepth as string

The number of bits in each color sample of each pixel. If present, this key is a CFNumber value.

CGImageSourceMBS.kCGImagePropertyDNGBackwardVersion as string

The oldest version for which a file is compatible.

CGImageSourceMBS.kCGImagePropertyDNGCameraSerialNumber as string

The camera serial number.

CGImageSourceMBS.kCGImagePropertyDNGDictionary as string

A dictionary of key-value pairs for an image that uses the Digital Negative (DNG) archival format.

CGImageSourceMBS.kCGImagePropertyDNGLensInfo as string

Information about the lens used for the image.

CGImageSourceMBS.kCGImagePropertyDNGLocalizedCameraModel as string

The localized camera model name.

CGImageSourceMBS.kCGImagePropertyDNGUniqueCameraModel as string

A unique, nonlocalized name for the camera mode.

CGImageSourceMBS.kCGImagePropertyDNGVersion as string

An encoding of the four-tier version number.

CGImageSourceMBS.kCGImagePropertyDPIHeight as string

The resolution, in dots per inch, in the x dimension. If present, this key is a CFNumber value.

CGImageSourceMBS.kCGImagePropertyDPIWidth as string

The resolution, in dots per inch, in the y dimension. If present, this key is a CFNumber value.

CGImageSourceMBS.kCGImagePropertyExifApertureValue as string

The aperture value.

CGImageSourceMBS.kCGImagePropertyExifAuxDictionary as string

An auxiliary dictionary of key-value pairs for an image that uses Exchangeable Image File Format (EXIF).

CGImageSourceMBS.kCGImagePropertyExifAuxFirmware as string

Firmware information.