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)
FindDeviceByProperty  (in  's'     key,
                       in  's'     value,
                       out 'o'     object_path)
FindProfileById       (in  's'     profile_id,
                       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)
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'

Description

The interface used for quering color parameters for the system.

Details

GetDevices ()

GetDevices (out 'ao' devices)

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

devices:

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


GetDevicesByKind ()

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

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 IDs, e.g. ['/org/freedesktop/ColorManager/device/xrandr_ibm_france_ltn154p2_l05'].


FindDeviceById ()

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

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.


FindDeviceByProperty ()

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

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)

Gets a profile path for the profile ID.

profile_id:

A profile ID.

object_path:

A profile path.


FindProfileByFilename ()

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

Gets a profile path for the profile filename.

filename:

A profile filename.

object_path:

A profile path.


GetStandardSpace ()

GetStandardSpace (in  's' standard-space,
                  out 'o' object_path)

Gets a profile path for a defined profile space. The defined space is set from the profile metadata, specifically in the STANDARD_space entry. The colord.conf file allows an administrator to manually override profiles if required.

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)

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

devices:

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


GetSensors ()

GetSensors (out 'ao' devices)

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

devices:

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


GetProfilesByKind ()

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

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 IDs, e.g. ['/org/freedesktop/ColorManager/device/xrandr_ibm_france_ltn154p2_l05'].


CreateProfile ()

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

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 RemoveProfiledoc: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.

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.


CreateDevice ()

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

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)

Deletes a device.

object_path:

A device path.


DeleteProfile ()

DeleteProfile (in  'o' object_path)

Deletes a profile.

object_path:

A profile path.

Signal Details

The Changed signal

Changed ()

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


The DeviceAdded signal

DeviceAdded ('o' object_path)

A device has been added.

object_path:

The device path.

The DeviceRemoved signal

DeviceRemoved ('o' object_path)

A device has been removed.

object_path:

The device path.

The DeviceChanged signal

DeviceChanged ('o' object_path)

A device has changed.

object_path:

The device path.

The ProfileAdded signal

ProfileAdded ('o' object_path)

A profile has been added.

object_path:

The profile path.

The ProfileRemoved signal

ProfileRemoved ('o' object_path)

A profile has been removed.

object_path:

The profile path.

The SensorAdded signal

SensorAdded ('o' object_path)

A sensor has been added.

object_path:

The sensor path.

The SensorRemoved signal

SensorRemoved ('o' object_path)

A sensor has been removed.

object_path:

The sensor path.

The ProfileChanged signal

ProfileChanged ('o' object_path)

A profile has been changed.

object_path:

The profile path.

Property Details

The "DaemonVersion" property

'DaemonVersion'  read      's'

The daemon version.