Monitor API

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

Functions
int	oyGetMonitorInfo (const char *display, char **manufacturer, char **model, char **serial, oyAllocFunc_t allocate_func)
	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, oyAllocFunc_t allocate_func)
	display name from position
char *	oyGetMonitorProfile (const char *display, size_t *size, oyAllocFunc_t allocate_func)
	get the monitor profile
char *	oyGetMonitorProfileName (const char *display, oyAllocFunc_t allocate_func)
	get the monitor profile filename
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.

---

Function Documentation

int oyActivateMonitorProfiles

(

const char *

display_name

)

activate the monitor using the stored configuration

Parameters:

display_name

the display string

Returns:

error

See also:

oySetMonitorProfile for permanently configuring a monitor

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

display name from position

This function will hit exact results only with Xinerama.

Parameters:

	raw_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

int oyGetMonitorInfo	(	const char *	display,
		char **	manufacturer,
		char **	model,
		char **	serial,
		oyAllocFunc_t	allocate_func
	)

pick up monitor information with Xlib

Deprecated:

because sometimes is no ddc information available

Todo:

include connection information - grafic cart

Parameters:

	display	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

char* oyGetMonitorProfile	(	const char *	display,
		size_t *	size,
		oyAllocFunc_t	allocate_func
	)

get the monitor profile

Parameters:

	display	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

char* oyGetMonitorProfileName	(	const char *	display,
		oyAllocFunc_t	allocate_func
	)

get the monitor profile filename

Parameters:

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

Returns:

the profiles filename (if localy available)

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

screen number from position

This function will hit exact results only with Xinerama.

Parameters:

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

Returns:

screen

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

set the monitor profile by filename

Parameters:

	display_name	the display string
	profil_name	the file to use as monitor profile

Returns:

error