Platforms to show: All Mac Windows Linux Cross-Platform

Back to CGImageSourceMBS class.

Previous items Next items

CGImageSourceMBS.kCGImagePropertyPNGXPixelsPerMeter as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Portable Network Graphics (PNG) format.

The number of x pixels per meter.

CGImageSourceMBS.kCGImagePropertyPNGYPixelsPerMeter as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Portable Network Graphics (PNG) format.

The number of y pixels per meter.

CGImageSourceMBS.kCGImagePropertyProfileName as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the keys for the properties dictionary.

The name of the optional ICC profile embedded in the image, if known. If present, the value of this key is a CFStringRef.

CGImageSourceMBS.kCGImagePropertyRawDictionary as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the keys for the properties dictionary.

A dictionary of key-value pairs for an image that contains minimally processed, or raw, data.

CGImageSourceMBS.kCGImagePropertyTIFFArtist as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The artist.

CGImageSourceMBS.kCGImagePropertyTIFFCompression as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The compression scheme used on the image data.

CGImageSourceMBS.kCGImagePropertyTIFFCopyright as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

Copyright information.

CGImageSourceMBS.kCGImagePropertyTIFFDateTime as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The date and time.

CGImageSourceMBS.kCGImagePropertyTIFFDictionary as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the keys for the properties dictionary.
Example
// Change rotation in an image file

// files
dim dpath as folderitem = SpecialFolder.Desktop.Child("test.jpg")
dim opath as folderitem = dpath.parent.Child("output.jpg")

// open source
dim imageSource as new cgimagesourcembs(dpath)

// read image
dim img as cgimagembs = imageSource.createimageatindex(0)

// global properties
dim globalprop as dictionary = imageSource.properties
// per image properties
dim p as Dictionary = imageSource.PropertiesAtIndex(0)

dim imageDest as new CGImageDestinationMBS(opath,"public.jpeg",1)

'const orientation = 1 // top left
const orientation = 3 // bottom right

// set globals
imageDest.SetProperties(globalprop)

// now set new orientation
p.value(imageDest.kCGImageDestinationOrientation) = orientation
p.value(imageDest.kCGImageDestinationMergeMetadata) = true

// change tiff dictionary, if present
dim dTIFF as Dictionary = p.lookup(imageSource.kCGImagePropertyTIFFDictionary, nil)
if dTIFF <> nil then
dTIFF.value(imageSource.kCGImagePropertyTIFFOrientation) = orientation
end if

// change iptc dictionary, if present
dim dIPTC as Dictionary = p.lookup(imageSource.kCGImagePropertyIPTCDictionary, nil)
if dIPTC <> nil then
dIPTC.value(imageSource.kCGImagePropertyIPTCImageOrientation) = orientation
end if

// write out image
imageDest.AddImage(img,p)
call imageDest.Finalize

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

CGImageSourceMBS.kCGImagePropertyTIFFDocumentName as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The document name.

CGImageSourceMBS.kCGImagePropertyTIFFHostComputer as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The computer or operation system used when the image was created.

CGImageSourceMBS.kCGImagePropertyTIFFImageDescription as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The image description.

CGImageSourceMBS.kCGImagePropertyTIFFMake as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The camera or input device make.

CGImageSourceMBS.kCGImagePropertyTIFFModel as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

A camera or input device model.

CGImageSourceMBS.kCGImagePropertyTIFFOrientation as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).
Example
// Change rotation in an image file

// files
dim dpath as folderitem = SpecialFolder.Desktop.Child("test.jpg")
dim opath as folderitem = dpath.parent.Child("output.jpg")

// open source
dim imageSource as new cgimagesourcembs(dpath)

// read image
dim img as cgimagembs = imageSource.createimageatindex(0)

// global properties
dim globalprop as dictionary = imageSource.properties
// per image properties
dim p as Dictionary = imageSource.PropertiesAtIndex(0)

dim imageDest as new CGImageDestinationMBS(opath,"public.jpeg",1)

'const orientation = 1 // top left
const orientation = 3 // bottom right

// set globals
imageDest.SetProperties(globalprop)

// now set new orientation
p.value(imageDest.kCGImageDestinationOrientation) = orientation
p.value(imageDest.kCGImageDestinationMergeMetadata) = true

// change tiff dictionary, if present
dim dTIFF as Dictionary = p.lookup(imageSource.kCGImagePropertyTIFFDictionary, nil)
if dTIFF <> nil then
dTIFF.value(imageSource.kCGImagePropertyTIFFOrientation) = orientation
end if

// change iptc dictionary, if present
dim dIPTC as Dictionary = p.lookup(imageSource.kCGImagePropertyIPTCDictionary, nil)
if dIPTC <> nil then
dIPTC.value(imageSource.kCGImagePropertyIPTCImageOrientation) = orientation
end if

// write out image
imageDest.AddImage(img,p)
call imageDest.Finalize

The image orientation.

CGImageSourceMBS.kCGImagePropertyTIFFPhotometricInterpretation as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The color space of the image data.

CGImageSourceMBS.kCGImagePropertyTIFFPrimaryChromaticities as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The chromaticities of the primaries of the image.

CGImageSourceMBS.kCGImagePropertyTIFFResolutionUnit as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The units of resolution.

CGImageSourceMBS.kCGImagePropertyTIFFSoftware as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The name and version of the software used for image creation.

CGImageSourceMBS.kCGImagePropertyTIFFTransferFunction as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The transfer function, in tabular format, used to map pixel components from a nonlinear form into a linear form.

CGImageSourceMBS.kCGImagePropertyTIFFWhitePoint as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The white point.

CGImageSourceMBS.kCGImagePropertyTIFFXResolution as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The number of pixels per resolution unit in the image width direction.

CGImageSourceMBS.kCGImagePropertyTIFFYResolution as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 9.5 ✅ Yes ❌ No ❌ No ✅ Yes All
Keys for an image that uses Tagged Image File Format (TIFF).

The number of pixels per resolution unit in the image height direction.

CGImageSourceMBS.kCGImageSourceCreateThumbnailFromImageAlways as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies whether a thumbnail should be created from the full image even if a thumbnail is present in the image source file. The thumbnail will be created from the full image, subject to the limit specified by kCGImageSourceThumbnailMaxPixelSize --- if a maximum pixel size isn't specified, then the thumbnail will be the size of the full image, which probably isn't what you want. The value of this key must be a Boolean; the default value of this key is False.

CGImageSourceMBS.kCGImageSourceCreateThumbnailFromImageIfAbsent as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies whether a thumbnail should be automatically created for an image if a thumbnail isn't present in the image source file. The thumbnail will be created from the full image, subject to the limit specified by kCGImageSourceThumbnailMaxPixelSize---if a maximum pixel size isn't specified, then the thumbnail will be the size of the full image, which probably isn't what you want. The value of this key must be a Boolean; the default value of this key is False.

Some examples using this method:

CGImageSourceMBS.kCGImageSourceCreateThumbnailWithTransform as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies whether the thumbnail should be rotated and scaled according to the orientation and pixel aspect ratio of the full image. The value of this key must be a Boolean; the default value of this key is False.

CGImageSourceMBS.kCGImageSourceShouldAllowFloat as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies whether the image should be returned as a floating point CGImage if supported by the file format. Extended range floating point CGImage may require additional processing to render pleasingly. The value of this key must be a Boolean; the default value is False.

CGImageSourceMBS.kCGImageSourceShouldCache as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies whether the image should be cached in a decoded form. The value of this key must be a Boolean; the default value is False.

CGImageSourceMBS.kCGImageSourceShouldCacheImmediately as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 17.0 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the keys for the options dictionary.

Specifies whether image decoding and caching should happen at image creation time.
The value of this key must be a boolean. The default value is kCFBooleanFalse (image decoding will happen at rendering time).

CGImageSourceMBS.kCGImageSourceThumbnailMaxPixelSize as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method CoreGraphics MBS MacCG Plugin 13.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the key names for the properties.

Specifies the maximum width and height in pixels of a thumbnail. If this this key is not specified, the width and height of a thumbnail is not limited and thumbnails may be as big as the image itself. If present, this value of this key must be an Integer.

Some examples using this method:

Previous items Next items

The items on this page are in the following plugins: MBS MacCG Plugin.


💬 Ask a question or report a problem
The biggest plugin in space...