colord Reference Manual: cd-sensor-sync

## cd-sensor-sync cd-sensor-sync — Sync helpers for CdSensor |

## Functions

gboolean | cd_sensor_connect_sync ()
gboolean | cd_sensor_lock_sync ()
gboolean | cd_sensor_unlock_sync ()
gboolean | cd_sensor_set_options_sync ()
CdColorXYZ * | cd_sensor_get_sample_sync ()

## Description

These helper functions provide a simple way to use the async functions in command line tools.

See also: CdSensor

## Functions

### cd_sensor_connect_sync ()

    gboolean
    cd_sensor_connect_sync (CdSensor *sensor,
                            GCancellable *cancellable,
                            GError **error);

Connects to the object and fills up initial properties.

WARNING: This function is synchronous, and may block. Do not use it in GUI applications.

#### Parameters

sensor | a CdSensor instance. |
cancellable | a GCancellable or `NULL` |
error | a GError, or `NULL`. |

#### Returns

`TRUE` for success, else `FALSE`.

Since 0.1.8

### cd_sensor_lock_sync ()

    gboolean
    cd_sensor_lock_sync (CdSensor *sensor,
                         GCancellable *cancellable,
                         GError **error);

Locks the device so we can use it.

WARNING: This function is synchronous, and may block. Do not use it in GUI applications.

#### Parameters

sensor | a CdSensor instance. |
cancellable | a GCancellable or `NULL` |
error | a GError, or `NULL`. |

#### Returns

`TRUE` for success, else `FALSE`.

Since 0.1.6

### cd_sensor_unlock_sync ()

    gboolean
    cd_sensor_unlock_sync (CdSensor *sensor,
                           GCancellable *cancellable,
                           GError **error);

Unlocks the device for use by other programs.

WARNING: This function is synchronous, and may block. Do not use it in GUI applications.

#### Parameters

sensor | a CdSensor instance. |
cancellable | a GCancellable or `NULL` |
error | a GError, or `NULL`. |

#### Returns

`TRUE` for success, else `FALSE`.

Since 0.1.6

### cd_sensor_set_options_sync ()

    gboolean
    cd_sensor_set_options_sync (CdSensor *sensor,
                                GHashTable *values,
                                GCancellable *cancellable,
                                GError **error);

Sets options on the sensor device.

WARNING: This function is synchronous, and may block. Do not use it in GUI applications.

#### Parameters

sensor | a CdSensor instance. |
values | the options. | [element-type utf8 GVariant]
cancellable | a GCancellable or `NULL` |
error | a GError, or `NULL`. |

#### Returns

`TRUE` for success, else `FALSE`.

Since 0.1.20

### cd_sensor_get_sample_sync ()

    CdColorXYZ *
    cd_sensor_get_sample_sync (CdSensor *sensor,
                               CdSensorCap cap,
                               GCancellable *cancellable,
                               GError **error);

Gets a sample from the sensor.

WARNING: This function is synchronous, and may block. Do not use it in GUI applications.

#### Parameters

sensor | a CdSensor instance. |
cap | The device capability, e.g. `CD_SENSOR_CAP_AMBIENT`. |
cancellable | a GCancellable or `NULL` |
error | a GError, or `NULL`. |

#### Returns

the XYZ reading, with ambient levels in Lux encoded in X, or `NULL` for error.

Since 0.1.8

## Types and Values