Color profiles

Overview

A ColorSyncProfile wraps an ICC profile, the description of a device or working color space that ColorSync uses to convert color accurately. Create profiles from a name, a file, or raw ICC data, and read a profile’s tags and header. To round trip a profile through raw ICC bytes, use ColorSyncProfileCopyData(_:_:) to get the bytes you embed in an image or file, and ColorSyncProfileCreate(_:_:) to reconstruct a profile from bytes you extract. On macOS, you can also install a profile for the current user in ~/Library/ColorSync/Profiles, or for everyone on the system in /Library/ColorSync/Profiles. To convert color between profiles, build a ColorSyncTransform. To bridge to Core Graphics, pass a profile to CGColorSpaceCreateWithColorSyncProfile(_:_:).

Topics

Profiling objects

• ColorSyncMutableProfile
• ColorSyncProfile

Creating a profile

• ColorSyncProfileCreateWithName(_:)
• ColorSyncProfileCreateWithURL(_:_:)
• ColorSyncProfileCreateWithURLAndOptions(_:_:_:)
• ColorSyncProfileCreateMutable()
• ColorSyncProfileCreateMutableCopy(_:)

Embedding and extracting profiles

• ColorSyncProfileCopyData(_:_:)
• ColorSyncProfileCreate(_:_:)

Accessing standard RGB profiles

• kColorSyncSRGBProfile
• kColorSyncAdobeRGB1998Profile
• kColorSyncDisplayP3Profile
• kColorSyncDCIP3Profile
• kColorSyncITUR709Profile
• kColorSyncITUR2020Profile
• kColorSyncROMMRGBProfile
• kColorSyncACESCGLinearProfile
• kColorSyncGenericRGBProfile

Accessing generic and special profiles

• kColorSyncGenericGrayProfile
• kColorSyncGenericGrayGamma22Profile
• kColorSyncGenericCMYKProfile
• kColorSyncGenericLabProfile
• kColorSyncGenericXYZProfile
• kColorSyncWebSafeColorsProfile

Reading profile data

• ColorSyncProfileCopyDescriptionString(_:)
• ColorSyncProfileCopyHeader(_:)
• ColorSyncProfileGetURL(_:_:)
• ColorSyncProfileGetTypeID()

Managing tags and the header

• ColorSyncProfileContainsTag(_:_:)
• ColorSyncProfileCopyTag(_:_:)
• ColorSyncProfileCopyTagSignatures(_:)
• ColorSyncProfileRemoveTag(_:_:)
• ColorSyncProfileSetHeader(_:_:)
• ColorSyncProfileSetTag(_:_:_:)

Inspecting color characteristics

• ColorSyncProfileIsWideGamut(_:)
• ColorSyncProfileIsPQBased(_:)
• ColorSyncProfileIsHLGBased(_:)
• ColorSyncProfileIsMatrixBased(_:)
• ColorSyncProfileEstimateGamma(_:_:)
• ColorSyncProfileVerify(_:_:_:)

Finding installed profiles

• ColorSyncIterateInstalledProfiles(_:_:_:_:)
• ColorSyncProfileIterateCallback

Installing profiles

• ColorSyncProfileInstall(_:_:_:_:)
• ColorSyncProfileUninstall(_:_:)
• ColorSyncIterateInstalledProfilesWithOptions(_:_:_:_:_:)
• COLORSYNC_PROFILE_INSTALL_ENTITLEMENT
• kColorSyncProfileComputerDomain
• kColorSyncProfileUserDomain

Accessing profile properties

• kColorSyncProfileClass
• kColorSyncProfileColorSpace
• kColorSyncProfileDescription
• kColorSyncProfileHeader
• kColorSyncProfileIsValid
• kColorSyncProfilePCS
• kColorSyncProfileURL

Computing profile digests

• ColorSyncProfileGetMD5(_:)
• ColorSyncMD5
• COLORSYNC_MD5_LENGTH
• kColorSyncProfileMD5Digest

Tracking changes and cache

• kColorSyncProfileRepositoryChangeNotification
• kColorSyncProfileCacheSeed
• kColorSyncWaitForCacheReply

See Also

Profile and HDR metadata

• Headroom Adaptive Gain Curve