| Oyranos Colour Management System API

- Main Page
- Related Pages
- Modules
- Data Structures
- Files

Modules | Data Structures | Enumerations
Profile API
Collaboration diagram for Profile API:

## Modules
| Profile Lists API
| Profile Handling API

## Data Structures
struct | oyProfile_s
| A profile and its attributes. More...
struct | oyProfiles_s
| Tell about the conversion profiles. More...
struct | oyProfileTag_s
| A profile constituting element. More...

## Enumerations
enum | oySIGNATURE_TYPE_e { oySIGNATURE_COLOUR_SPACE, oySIGNATURE_PCS, oySIGNATURE_SIZE, oySIGNATURE_CMM, oySIGNATURE_VERSION, oySIGNATURE_CLASS, oySIGNATURE_MAGIC, oySIGNATURE_PLATFORM, oySIGNATURE_OPTIONS, oySIGNATURE_MANUFACTURER, oySIGNATURE_MODEL, oySIGNATURE_INTENT, oySIGNATURE_CREATOR, oySIGNATURE_DATETIME_YEAR, oySIGNATURE_DATETIME_MONTH, oySIGNATURE_DATETIME_DAY, oySIGNATURE_DATETIME_HOURS, oySIGNATURE_DATETIME_MINUTES, oySIGNATURE_DATETIME_SECONDS, oySIGNATURE_ILLUMINANT }
| general profile infosuse for oyProfile_GetSignature More...
enum | oySTATUS_e
| File status type. More...

## Detailed Description

To open a profile exist several methods in the oyProfile_Fromxxx APIs. oyProfile_FromStd(), oyProfile_FromFile() and oyProfile_FromMem() are basic profile open functions. oyProfile_FromSignature() is used for creating a dummy profile during profile filtering. oyProfile_FromMD5() is a lookup function from a profile hash, e.g. as provided by a 'psid' tag.
Profile properties can be obtained from oyProfile_GetSignature(), like colour spaces, date, magic number and so on. oyProfile_GetChannelNames(), oyProfile_GetText() and oyProfile_GetID() provide additional informations.
The profile element functions have Tag in their names. They work together with the oyProfileTag_s APIs.
oyProfile_GetFileName() is a reverse lookup to obtain the name of a installed file from a profile, e.g. find the name of a reachable display profile.

The oyProfiles_Create() allows to create profile lists with fine grained control. oyProfiles_ForStd() creates a list of profiles suitable to be set as default profiles according to the oyPROFILE_e categories. oyProfiles_DeviceRank() can be used together with a given device so sort for a the best match in descenting order.

Functions to select, read, manipulate and write ICC Profiles. Low level APIs to obtain pure filenames and handle raw bits as well as object oriented APIs are in place.

- Profile Lists API - provides the ICC profile search path content as string list
- Profile Handling API - low level ICC profile I/O and more

## Enumeration Type Documentation

enum oySIGNATURE_TYPE_e

general profile infosuse for oyProfile_GetSignature

Since
  Oyranos: version 0.1.8

Date
  10 december 2007 (API 0.1.8)

Enumerator
oySIGNATURE_COLOUR_SPACE | colour space
oySIGNATURE_PCS | profile connection space
oySIGNATURE_SIZE | internal stored size
oySIGNATURE_CMM | prefered CMM
oySIGNATURE_VERSION | version
oySIGNATURE_CLASS | usage class, e.g. 'mntr' ...
oySIGNATURE_MAGIC | magic; ICC: 'acsp'
oySIGNATURE_PLATFORM | operating system
oySIGNATURE_OPTIONS | various ICC header flags
oySIGNATURE_MANUFACTURER | device manufacturer
oySIGNATURE_MODEL | device modell
oySIGNATURE_INTENT | seldom used profile claimed intent
oySIGNATURE_CREATOR | profile creator ID
oySIGNATURE_DATETIME_YEAR | creation time in UTC
oySIGNATURE_DATETIME_MONTH | creation time in UTC
oySIGNATURE_DATETIME_DAY | creation time in UTC
oySIGNATURE_DATETIME_HOURS | creation time in UTC
oySIGNATURE_DATETIME_MINUTES | creation time in UTC
oySIGNATURE_DATETIME_SECONDS | creation time in UTC
oySIGNATURE_ILLUMINANT | profile illuminant

enum oySTATUS_e

File status type.