screen_set_display_property_iv()
Graphics and Screen4.0 (8.x)Screen Graphics Subsystem Developer's GuideAPIProgrammingUtilities
Set the value of the specified display property of type integer
Synopsis:
#include <screen/screen.h>
int screen_set_display_property_iv(screen_display_t disp,
int pname,
const int *param)
Arguments:
- disp
- The handle of the display whose property is to be set.
- pname
- The name of the property whose value is being set. The properties that you can set are of type Screen property types.
- param
- A pointer to a buffer containing the new value(s). This buffer must be of type
int
. param may be a single integer or an array of integers depending on the property being set.
Library:
libscreenDescription:
Function Type: Delayed Execution
This function sets the value of a display property from a user-provided buffer. Typically, you must be working within a privileged context of type SCREEN_DISPLAY_MANAGER_CONTEXT to be able to set display-related properties.
You can use this function to set the value of the following properties:
- SCREEN_PROPERTY_BLUE_GAMMA_CURVE [2]
- SCREEN_PROPERTY_BRIGHTNESS
- SCREEN_PROPERTY_CBABC_MODE
- SCREEN_PROPERTY_CONTRAST
- SCREEN_PROPERTY_GAMMA [2]
- SCREEN_PROPERTY_GREEN_GAMMA_CURVE [2]
- SCREEN_PROPERTY_HUE
- SCREEN_PROPERTY_INTENSITY
- SCREEN_PROPERTY_MIRROR_MODE
- SCREEN_PROPERTY_MODE
- SCREEN_PROPERTY_PERMISSIONS
- SCREEN_PROPERTY_POSITION
- SCREEN_PROPERTY_POWER_MODE [1]
- SCREEN_PROPERTY_PROTECTION_ENABLE
- SCREEN_PROPERTY_RED_GAMMA_CURVE [2]
- SCREEN_PROPERTY_ROTATION
- SCREEN_PROPERTY_SATURATION
- SCREEN_PROPERTY_SCALE_FACTOR
- SCREEN_PROPERTY_VIEWPORT_POSITION
- SCREEN_PROPERTY_VIEWPORT_SIZE
Note [1]: You must be working within a privileged context of type SCREEN_POWER_MANAGER_CONTEXT to be able to set this property.
Note [2]: You must be working within a privileged context of type SCREEN_DISPLAY_MANAGER_CONTEXT to be able to set this property.
Returns:
0
if successful, or -1
if an error occurred (errno
is set; refer to errno.h
for more details).
Page updated: