---
title: Color profiles
framework: colorsync
role: collectionGroup
role_heading: API Collection
path: colorsync/color-profiles
---

# Color profiles

Work with the ICC profiles that describe device and working color spaces.

## Overview

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](colorsync/colorsyncmutableprofile.md)
- [ColorSyncProfile](colorsync/colorsyncprofile.md)

### Creating a profile

- [ColorSyncProfileCreateWithName(_:)](colorsync/colorsyncprofilecreatewithname(_:).md)
- [ColorSyncProfileCreateWithURL(_:_:)](colorsync/colorsyncprofilecreatewithurl(_:_:).md)
- [ColorSyncProfileCreateWithURLAndOptions(_:_:_:)](colorsync/colorsyncprofilecreatewithurlandoptions(_:_:_:).md)
- [ColorSyncProfileCreateMutable()](colorsync/colorsyncprofilecreatemutable().md)
- [ColorSyncProfileCreateMutableCopy(_:)](colorsync/colorsyncprofilecreatemutablecopy(_:).md)

### Embedding and extracting profiles

- [ColorSyncProfileCopyData(_:_:)](colorsync/colorsyncprofilecopydata(_:_:).md)
- [ColorSyncProfileCreate(_:_:)](colorsync/colorsyncprofilecreate(_:_:).md)

### Accessing standard RGB profiles

- [kColorSyncSRGBProfile](colorsync/kcolorsyncsrgbprofile.md)
- [kColorSyncAdobeRGB1998Profile](colorsync/kcolorsyncadobergb1998profile.md)
- [kColorSyncDisplayP3Profile](colorsync/kcolorsyncdisplayp3profile.md)
- [kColorSyncDCIP3Profile](colorsync/kcolorsyncdcip3profile.md)
- [kColorSyncITUR709Profile](colorsync/kcolorsyncitur709profile.md)
- [kColorSyncITUR2020Profile](colorsync/kcolorsyncitur2020profile.md)
- [kColorSyncROMMRGBProfile](colorsync/kcolorsyncrommrgbprofile.md)
- [kColorSyncACESCGLinearProfile](colorsync/kcolorsyncacescglinearprofile.md)
- [kColorSyncGenericRGBProfile](colorsync/kcolorsyncgenericrgbprofile.md)

### Accessing generic and special profiles

- [kColorSyncGenericGrayProfile](colorsync/kcolorsyncgenericgrayprofile.md)
- [kColorSyncGenericGrayGamma22Profile](colorsync/kcolorsyncgenericgraygamma22profile.md)
- [kColorSyncGenericCMYKProfile](colorsync/kcolorsyncgenericcmykprofile.md)
- [kColorSyncGenericLabProfile](colorsync/kcolorsyncgenericlabprofile.md)
- [kColorSyncGenericXYZProfile](colorsync/kcolorsyncgenericxyzprofile.md)
- [kColorSyncWebSafeColorsProfile](colorsync/kcolorsyncwebsafecolorsprofile.md)

### Reading profile data

- [ColorSyncProfileCopyDescriptionString(_:)](colorsync/colorsyncprofilecopydescriptionstring(_:).md)
- [ColorSyncProfileCopyHeader(_:)](colorsync/colorsyncprofilecopyheader(_:).md)
- [ColorSyncProfileGetURL(_:_:)](colorsync/colorsyncprofilegeturl(_:_:).md)
- [ColorSyncProfileGetTypeID()](colorsync/colorsyncprofilegettypeid().md)

### Managing tags and the header

- [ColorSyncProfileContainsTag(_:_:)](colorsync/colorsyncprofilecontainstag(_:_:).md)
- [ColorSyncProfileCopyTag(_:_:)](colorsync/colorsyncprofilecopytag(_:_:).md)
- [ColorSyncProfileCopyTagSignatures(_:)](colorsync/colorsyncprofilecopytagsignatures(_:).md)
- [ColorSyncProfileRemoveTag(_:_:)](colorsync/colorsyncprofileremovetag(_:_:).md)
- [ColorSyncProfileSetHeader(_:_:)](colorsync/colorsyncprofilesetheader(_:_:).md)
- [ColorSyncProfileSetTag(_:_:_:)](colorsync/colorsyncprofilesettag(_:_:_:).md)

### Inspecting color characteristics

- [ColorSyncProfileIsWideGamut(_:)](colorsync/colorsyncprofileiswidegamut(_:).md)
- [ColorSyncProfileIsPQBased(_:)](colorsync/colorsyncprofileispqbased(_:).md)
- [ColorSyncProfileIsHLGBased(_:)](colorsync/colorsyncprofileishlgbased(_:).md)
- [ColorSyncProfileIsMatrixBased(_:)](colorsync/colorsyncprofileismatrixbased(_:).md)
- [ColorSyncProfileEstimateGamma(_:_:)](colorsync/colorsyncprofileestimategamma(_:_:).md)
- [ColorSyncProfileVerify(_:_:_:)](colorsync/colorsyncprofileverify(_:_:_:).md)

### Finding installed profiles

- [ColorSyncIterateInstalledProfiles(_:_:_:_:)](colorsync/colorsynciterateinstalledprofiles(_:_:_:_:).md)
- [ColorSyncProfileIterateCallback](colorsync/colorsyncprofileiteratecallback.md)

### Installing profiles

- [ColorSyncProfileInstall(_:_:_:_:)](colorsync/colorsyncprofileinstall(_:_:_:_:).md)
- [ColorSyncProfileUninstall(_:_:)](colorsync/colorsyncprofileuninstall(_:_:).md)
- [ColorSyncIterateInstalledProfilesWithOptions(_:_:_:_:_:)](colorsync/colorsynciterateinstalledprofileswithoptions(_:_:_:_:_:).md)
- [COLORSYNC_PROFILE_INSTALL_ENTITLEMENT](colorsync/colorsync_profile_install_entitlement.md)
- [kColorSyncProfileComputerDomain](colorsync/kcolorsyncprofilecomputerdomain.md)
- [kColorSyncProfileUserDomain](colorsync/kcolorsyncprofileuserdomain.md)

### Accessing profile properties

- [kColorSyncProfileClass](colorsync/kcolorsyncprofileclass.md)
- [kColorSyncProfileColorSpace](colorsync/kcolorsyncprofilecolorspace.md)
- [kColorSyncProfileDescription](colorsync/kcolorsyncprofiledescription.md)
- [kColorSyncProfileHeader](colorsync/kcolorsyncprofileheader.md)
- [kColorSyncProfileIsValid](colorsync/kcolorsyncprofileisvalid.md)
- [kColorSyncProfilePCS](colorsync/kcolorsyncprofilepcs.md)
- [kColorSyncProfileURL](colorsync/kcolorsyncprofileurl.md)

### Computing profile digests

- [ColorSyncProfileGetMD5(_:)](colorsync/colorsyncprofilegetmd5(_:).md)
- [ColorSyncMD5](colorsync/colorsyncmd5.md)
- [COLORSYNC_MD5_LENGTH](colorsync/colorsync_md5_length.md)
- [kColorSyncProfileMD5Digest](colorsync/kcolorsyncprofilemd5digest.md)

### Tracking changes and cache

- [kColorSyncProfileRepositoryChangeNotification](colorsync/kcolorsyncprofilerepositorychangenotification.md)
- [kColorSyncProfileCacheSeed](colorsync/kcolorsyncprofilecacheseed.md)
- [kColorSyncWaitForCacheReply](colorsync/kcolorsyncwaitforcachereply.md)

## See Also

### Profile and HDR metadata

- [Headroom Adaptive Gain Curve](colorsync/headroom-adaptive-gain-curve.md)