org.freedesktop.ColorManager
org.freedesktop.ColorManager ColorManager interface

## Methods

    GetDevices(out'ao'devices)
    GetDevicesByKind(in's'kind,
    out'ao'devices)
    FindDeviceById(in's'device_id,
    out'o'object_path)
    FindSensorById(in's'sensor_id,
    out'o'object_path)
    FindDeviceByProperty(in's'key,
    in's'value,
    out'o'object_path)
    FindProfileById(in's'profile_id,
    out'o'object_path)
    FindProfileByProperty(in's'key,
    in's'value,
    out'o'object_path)
    FindProfileByFilename(in's'filename,
    out'o'object_path)
    GetStandardSpace(in's'standard_space,
    out'o'object_path)
    GetProfiles(out'ao'devices)
    GetSensors(out'ao'devices)
    GetProfilesByKind(in's'kind,
    out'ao'devices)
    CreateProfileWithFd(in's'profile_id,
    in's'scope,
    in'h'handle,
    in'a{ss}'properties,
    out'o'object_path)
    CreateProfile(in's'profile_id,
    in's'scope,
    in'a{ss}'properties,
    out'o'object_path)
    CreateDevice(in's'device_id,
    in's'scope,
    in'a{ss}'properties,
    out'o'object_path)
    DeleteDevice(in'o'object_path)
    DeleteProfile(in'o'object_path)

## Signals

    Changed()
    DeviceAdded('o'object_path)
    DeviceRemoved('o'object_path)
    DeviceChanged('o'object_path)
    ProfileAdded('o'object_path)
    ProfileRemoved('o'object_path)
    SensorAdded('o'object_path)
    SensorRemoved('o'object_path)
    ProfileChanged('o'object_path)

## Implemented Interfaces

Objects implementing org.freedesktop.ColorManager also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

## Properties

    'DaemonVersion'read's'
    'SystemVendor'read's'
    'SystemModel'read's'

## Description

The interface used for quering color parameters for the system.

## Details

### GetDevices ()

    GetDevices (out'ao'devices)

GetDevices ColorManager

Gets a list of all the devices which have assigned color profiles.

devices:

  An array of device paths, e.g. `['/org/freedesktop/ColorManager/device/xrandr_ibm_france_ltn154p2_l05']`.

### GetDevicesByKind ()

    GetDevicesByKind (in's'kind,
    out'ao'devices)

GetDevicesByKind ColorManager

Gets a list of all the devices which have assigned color profiles.

kind:

  A device kind, e.g. `scanner`, `display`, `printer` or `camera`.

devices:

  An array of device paths, e.g. `['/org/freedesktop/ColorManager/device/xrandr_ibm_france_ltn154p2_l05']`.

### FindDeviceById ()

    FindDeviceById (in's'device_id,
    out'o'object_path)

FindDeviceById ColorManager

Gets a device path for the device ID. This method is required as device ID's may have to be mangled to conform with the DBus path specification. For instance, a device ID of "cups$34:dev' would have a object path of "/org/freedesktop/ColorManager/cups_34_dev".

device_id:

  A device ID.

object_path:

  A device path.

### FindSensorById ()

    FindSensorById (in's'sensor_id,
    out'o'object_path)

FindSensorById ColorManager

Gets a sensor path for the sensor ID.

sensor_id:

  A sensor ID.

object_path:

  A sensor path.

### FindDeviceByProperty ()

    FindDeviceByProperty (in's'key,
    in's'value,
    out'o'object_path)

FindDeviceByProperty ColorManager

Gets a device path for the device with the specified property.

key:

  A property key, e.g. `XRANDR_name`.

value:

  A property value, e.g. `lvds`.

object_path:

  A device path.

### FindProfileById ()

    FindProfileById (in's'profile_id,
    out'o'object_path)

FindProfileById ColorManager

Gets a profile path for the profile ID.

profile_id:

  A profile ID.

object_path:

  A profile path.

### FindProfileByProperty ()

    FindProfileByProperty (in's'key,
    in's'value,
    out'o'object_path)

FindProfileByProperty ColorManager

Gets a profile path for the profile with the specified property.

key:

  A property key, e.g. `FILE_checksum`.

value:

  A property value, e.g. `5b3855e8630c9d8a48177cc70680da93`.

object_path:

  A profile path.

### FindProfileByFilename ()

    FindProfileByFilename (in's'filename,
    out'o'object_path)

FindProfileByFilename ColorManager

Gets a profile path for the profile filename, either a fully-qualified filename with path or just the basename of the profile.

filename:

  A profile filename.

object_path:

  A profile path.

### GetStandardSpace ()

    GetStandardSpace (in's'standard_space,
    out'o'object_path)

GetStandardSpace ColorManager

Gets a profile path for a defined profile space. The defined space is set from the profile metadata, specifically in the `STANDARD_space` entry.

NOTE: only system wide profiles are able to define themselves as standard spaces.

standard_space:

  A profile space, e.g. `srgb` or `adobe-srgb`.

object_path:

  A profile path.

### GetProfiles ()

    GetProfiles (out'ao'devices)

GetProfiles ColorManager

Gets a list of all the profiles recognised by the system.

devices:

  An array of profile paths, e.g. `['/org/freedesktop/ColorManager/profile/adobe_rgb']`.

### GetSensors ()

    GetSensors (out'ao'devices)

GetSensors ColorManager

Gets a list of all the sensors recognised by the system.

devices:

  An array of sensor paths, e.g. `['/org/freedesktop/ColorManager/sensor/colormunki']`.

### GetProfilesByKind ()

    GetProfilesByKind (in's'kind,
    out'ao'devices)

GetProfilesByKind ColorManager

Gets a list of all the profiles of a specified type.

kind:

  A profile kind, e.g. `input-device` or `abstract`.

devices:

  An array of device paths, e.g. `['/org/freedesktop/ColorManager/device/xrandr_ibm_france_ltn154p2_l05']`.

### CreateProfileWithFd ()

    CreateProfileWithFd (in's'profile_id,
    in's'scope,
    in'h'handle,
    in'a{ss}'properties,
    out'o'object_path)

CreateProfileWithFd ColorManager

Creates a profile.

If the profile has been added to a device in the past, and that device exists already, then the new profile will be automatically added to the device. To prevent this from happening, remove the assignment by doing `RemoveProfile`doc:tt> on the relevant device object.

An optional file descriptor can be sent out of band for the ICC profile file.

Using a file descriptor in addition to the filename allows the daemon to parse the ICC profile without re-opening it, which allows the daemon to read files inside the users home directory in a SELinux environment.

profile_id:

  A unique profile ID that is used to map to the profile. This is normally the MD5 hash of the disk profile.

scope:

  Options for creating the profile. This allows the session color management component to have per-user profiles stored in the home directory that would not be valid if the user logged off, or no users are logged in.

handle:

  An index into the array of file descriptors that may have been sent with the DBus message.

properties:

  Properties to be used when constructing the profile.

  This optional value allows the profile to be created with the latency of one bus round-trip, rather than doing a few `SetProperty` methods indervidually.

  Any properties not interstood by colord will be added as dictionary values to the `Metadata` property.

object_path:

  A profile path.

### CreateProfile ()

    CreateProfile (in's'profile_id,
    in's'scope,
    in'a{ss}'properties,
    out'o'object_path)

CreateProfile ColorManager

Creates a profile without using a file descriptor. It is recomended you use CreateProfileWithFd() as the daemon may not be running as root and have read access to profiles in the users home directory.

profile_id:

  A unique profile ID that is used to map to the profile.

scope:

  Options for creating the profile. See CreateProfileWithFd() for the allowed values.

properties:

  Properties to be used when constructing the profile. See CreateProfileWithFd() for the allowed values.

object_path:

  A profile path.

### CreateDevice ()

    CreateDevice (in's'device_id,
    in's'scope,
    in'a{ss}'properties,
    out'o'object_path)

CreateDevice ColorManager

Creates a device.

If the device has profiles added to it in the past, and that profiles exists already, then the new device will be automatically have profiles added to the device. To prevent this from happening, remove the assignment by doing `RemoveProfile` on the relevant device object.

device_id:

  A device ID that is used to map to the device path.

scope:

  Options for creating the device. This allows the session color management component to have per-session virtual devices cleaned up automatically or devices that are re-created on each boot.

properties:

  Properties to be used when constructing the device.

  This optional value allows the device to be created with the latency of one bus round-trip, rather than doing a few `SetProperty` methods indervidually.

  Any properties not interstood by colord will be added as dictionary values to the `Metadata` property.

object_path:

  A device path.

### DeleteDevice ()

    DeleteDevice (in'o'object_path)

DeleteDevice ColorManager

Deletes a device.

object_path:

  A device path.

### DeleteProfile ()

    DeleteProfile (in'o'object_path)

DeleteProfile ColorManager

Deletes a profile.

object_path:

  A profile path.

## Signal Details

### The Changed signal

    Changed ()

Changed ColorManager

Some value on the interface or the number of devices or profiles has changed.

### The DeviceAdded signal

    DeviceAdded ('o'object_path)

DeviceAdded ColorManager

A device has been added.

object_path:

  The device path.

### The DeviceRemoved signal

    DeviceRemoved ('o'object_path)

DeviceRemoved ColorManager

A device has been removed.

object_path:

  The device path.

### The DeviceChanged signal

    DeviceChanged ('o'object_path)

DeviceChanged ColorManager

A device has changed.

object_path:

  The device path.

### The ProfileAdded signal

    ProfileAdded ('o'object_path)

ProfileAdded ColorManager

A profile has been added.

object_path:

  The profile path.

### The ProfileRemoved signal

    ProfileRemoved ('o'object_path)

ProfileRemoved ColorManager

A profile has been removed.

object_path:

  The profile path.

### The SensorAdded signal

    SensorAdded ('o'object_path)

SensorAdded ColorManager

A sensor has been added.

object_path:

  The sensor path.

### The SensorRemoved signal

    SensorRemoved ('o'object_path)

SensorRemoved ColorManager

A sensor has been removed.

object_path:

  The sensor path.

### The ProfileChanged signal

    ProfileChanged ('o'object_path)

ProfileChanged ColorManager

A profile has been changed.

object_path:

  The profile path.

## Property Details

### The "DaemonVersion" property

    'DaemonVersion'read's'

DaemonVersion ColorManager

The daemon version.

### The "SystemVendor" property

    'SystemVendor'read's'

SystemVendor ColorManager

The system vendor.

### The "SystemModel" property

    'SystemModel'read's'

SystemModel ColorManager

The system model.