org.freedesktop.ColorManager.Sensor

org.freedesktop.ColorManager.Sensor — Sensor interface

Methods

Lock      ()
Unlock    ()
GetSample (in  's'     capability,
           out '(ddd)' value,
           out 'd'     value)

Signals

ButtonPressed ()

Implemented Interfaces

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

Properties

'Kind'         read      's'
'State'        read      's'
'Mode'         read      's'
'Serial'       read      's'
'Model'        read      's'
'Vendor'       read      's'
'Native'       read      'b'
'Locked'       read      'b'
'Capabilities' read      'as'

Description

The interface used for quering color sensors.

Details

Lock ()

Lock ()

Locks the sensor for use by an application.

If the current holder of the lock quits without calling Unlock then it is automatically removed.


Unlock ()

Unlock ()

Unlocks the sensor for use by other applications.


GetSample ()

GetSample (in  's'     capability,
           out '(ddd)' value,
           out 'd'     value)

Gets a color sample using the sensor.

capability:

The capability we are using, e.g. crt, ambient, lcd or projector.

value:

The XYZ value, or -1.0, -1.0, -1.0 if not supported by the sensor.

value:

The value in Lux, or -1.0 if not supported by the sensor.

Note: only populate this value when the capability is ambient or when this value is available at no cost, i.e. does not require additional hardware access.

Signal Details

The ButtonPressed signal

ButtonPressed ()

A button on the sensor has been pressed.

Property Details

The "Kind" property

'Kind'  read      's'

The kind of the sensor, e.g. colormunki


The "State" property

'State'  read      's'

The state of the sensor, e.g. starting, idle or measuring.


The "Mode" property

'Mode'  read      's'

The operating mode of the sensor, e.g. ambient, printer or unknown.

On some devices, a sensor has to be set to a specific position before a reading can be taken. This property should be set to the current device mode.


The "Serial" property

'Serial'  read      's'

The sensor serial number, e.g. 012345678a.


The "Model" property

'Model'  read      's'

The sensor model, e.g. ColorMunki.


The "Vendor" property

'Vendor'  read      's'

The sensor vendor, e.g. XRite.


The "Native" property

'Native'  read      'b'

If the sensor is supported with a native driver, which does not require additional tools such as argyllcms.


The "Locked" property

'Locked'  read      'b'

If the sensor is locked for use by colord.


The "Capabilities" property

'Capabilities'  read      'as'

The capabilities of the sensor, e.g ['display', 'printer', 'projector', 'spot'].