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.


Generated on Mon Jul 27 04:30:07 2009 for Oyranos by  doxygen 1.5.9