X Color Management DDC/CI communication API's

Enumerations
enum	XCM_DDC_ERROR_e {   XCM_DDC_OK, XCM_DDC_NO_FILE, XCM_DDC_PREPARE_FAIL, XCM_DDC_EDID_READ_FAIL,   XCM_DDC_WRONG_EDID }
Functions
XCM_DDC_ERROR_e	XcmDDClist (char ***list, int *count)
	obtain all monitors i2c device names
XCM_DDC_ERROR_e	XcmDDCgetEDID (const char *device_name, char **data, size_t *size)
	obtain all monitors i2c device names
const char *	XcmDDCErrorToString (XCM_DDC_ERROR_e error)
	convert enum into a meaningful text string

---

Detailed Description

The purpose of the API is to establish client side communication with a monitor device. This can be used to update EEDID data and get MCCS properties. The former is supported by this library.

XcmDDClist() returns a list of monitor i2c device names. XcmDDCgetEDID() can be used to fetch EEDID from a device name.

XcmDDC.h

Xcm Xorg Colour Management

DDC communication with monitor devices

Copyright:

2010 (C) Kai-Uwe Behrmann

Author:

Kai-Uwe Behrmann <ku.b@gmx.de>

License:

MIT <http://www.opensource.org/licenses/mit-license.php>

Since:

2010/12/28

---

Enumeration Type Documentation

enum XCM_DDC_ERROR_e

Enumerator:

XCM_DDC_OK	success
XCM_DDC_NO_FILE	fopen failed, permissions?
XCM_DDC_PREPARE_FAIL	setting EEDID adress failed
XCM_DDC_EDID_READ_FAIL	could not obtain EEDID
XCM_DDC_WRONG_EDID	wrong EDID header

---

Function Documentation

const char * XcmDDCErrorToString

(

XCM_DDC_ERROR_e

error

)

convert enum into a meaningful text string

Function XcmDDCErrorToString

Parameters:

[in]

error

the error

Returns:

library owned error text string

Version:

libXcm: 0.4.0

Since:

2010/12/28 (libXcm: 0.4.0)

Date:

2010/12/28

XCM_DDC_ERROR_e XcmDDCgetEDID	(	const char *	device_name,
		char **	data,
		size_t *	size
	)

obtain all monitors i2c device names

Function XcmDDCgetEDID

Parameters:

[in]	device_name	system specific device name
[out]	data	empty pointer to EDID data, will be mallocd for the user
[out]	size	size of memory in data

Returns:

error code

Version:

libXcm: 0.4.0

Since:

2010/12/28 (libXcm: 0.4,0)

Date:

2010/12/28

XCM_DDC_ERROR_e XcmDDClist	(	char ***	list,
		int *	count
	)

obtain all monitors i2c device names

Function XcmDDClist

Parameters:

[out]	list	empty pointer to a list of device names
[out]	count	pass in a pointer to a int. gives the number of elements in list

Returns:

error code

Version:

libXcm: 0.4.0

Since:

2010/12/28 (libXcm: 0.4.0)

Date:

2010/12/28