Monitor API

Hardware detection and profile selection for monitors. More...

Functions
int	oyGetMonitorInfo (const char *display_name, char **manufacturer, char **model, char **serial, oyAlloc_f allocate_func)
	brief pick up monitor information with Xlib
int	oyGetScreenFromPosition (const char *display_name, int x, int y)
	screen number from position
char *	oyGetDisplayNameFromPosition (const char *display_name, int x, int y, oyAlloc_f allocate_func)
	display name from position
char *	oyGetMonitorProfile (const char *display_name, size_t *size, oyAlloc_f allocate_func)
	get the monitor profile from the server
char *	oyGetMonitorProfileNameFromDB (const char *display_name, oyAlloc_f allocate_func)
	get the monitor profile filename from the device profile database
int	oySetMonitorProfile (const char *display_name, const char *profil_name)
	set the monitor profile by filename
int	oyActivateMonitorProfiles (const char *display_name)
	activate the monitor using the stored configuration

---

Detailed Description

Hardware detection and profile selection for monitors.

The notation of screens for the X Window system is equal for traditional and Xinerama screens.
The X11 libraries will be loaded at runtime.

---

Function Documentation

int oyActivateMonitorProfiles

(

const char *

display_name

)

activate the monitor using the stored configuration

Function: oyActivateMonitorProfiles Activate in case the appropriate profile is not yet setup in the server.

See also:

oySetMonitorProfile for permanently configuring a monitor

Parameters:

display_name

the display string

Returns:

error

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

char* oyGetDisplayNameFromPosition	(	const char *	display_name,
		int	x,
		int	y,
		oyAlloc_f	allocate_func
	)

display name from position

Function: oyGetDisplayNameFromPosition This function will hit exact results only with Xinerama.

Parameters:

	display_name	raw display string
	x	x position on screen
	y	y position on screen
	allocate_func	function used to allocate memory for the string

Returns:

display name

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

int oyGetMonitorInfo	(	const char *	display_name,
		char **	manufacturer,
		char **	model,
		char **	serial,
		oyAlloc_f	allocate_func
	)

brief pick up monitor information with Xlib

Function: oyGetMonitorInfo

Deprecated:

because sometimes is no ddc information available

Todo:

include connection information - grafic cart

Parameters:

	display_name	the display string
[out]	manufacturer	the manufacturer of the monitor device
[out]	model	the model of the monitor device
[out]	serial	the serial number of the monitor device
	allocate_func	the allocator for the above strings

Returns:

error

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

char* oyGetMonitorProfile	(	const char *	display_name,
		size_t *	size,
		oyAlloc_f	allocate_func
	)

get the monitor profile from the server

Function: oyGetMonitorProfile

Parameters:

	display_name	the display string
[out]	size	the size of profile
	allocate_func	function used to allocate memory for the profile

Returns:

the memory block containing the profile

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

char* oyGetMonitorProfileNameFromDB	(	const char *	display_name,
		oyAlloc_f	allocate_func
	)

get the monitor profile filename from the device profile database

Function: oyGetMonitorProfileNameFromDB

Parameters:

	display_name	the display string
	allocate_func	function used to allocate memory for the string

Returns:

the profiles filename (if localy available)

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

int oyGetScreenFromPosition	(	const char *	display_name,
		int	x,
		int	y
	)

screen number from position

Function: oyGetScreenFromPosition This function will hit exact results only with Xinerama.
a platform specific function

Parameters:

	display_name	the display string
	x	x position on screen
	y	y position on screen

Returns:

screen

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.

int oySetMonitorProfile	(	const char *	display_name,
		const char *	profil_name
	)

set the monitor profile by filename

Function: oySetMonitorProfile

Parameters:

	display_name	the display string
	profil_name	the file to use as monitor profile or 0 to unset

Returns:

error

Version:

Oyranos: 0.1.8

Since:

2005/00/00 (Oyranos: 0.1.x)

Date:

2008/10/24

References oyOBJECT_CMM_API2_S.