This is the reference documentation for monitor related functions and types. For more information, see the Monitor guide.
◆ GLFWgammaramp
◆ GLFWmonitor
◆ GLFWmonitorfun
This is the function signature for monitor configuration callback functions.
- Parameters
-
[in] | monitor | The monitor that was connected or disconnected. |
[in] | event | One of GLFW_CONNECTED or GLFW_DISCONNECTED . |
- See also
- glfwSetMonitorCallback
◆ GLFWvidmode
This describes a single video mode.
◆ glfwGetGammaRamp()
This function returns the current gamma ramp of the specified monitor.
- Parameters
-
[in] | monitor | The monitor to query. |
- Returns
- The current gamma ramp, or
NULL
if an error occurred.
- Pointer Lifetime
- The returned structure and its arrays are allocated and freed by GLFW. You should not free them yourself. They are valid until the specified monitor is disconnected, this function is called again for that monitor or the library is terminated.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Gamma ramp
- Since
- Added in GLFW 3.0.
◆ glfwGetMonitorName()
const char* glfwGetMonitorName |
( |
GLFWmonitor * |
monitor | ) |
|
This function returns a human-readable name, encoded as UTF-8, of the specified monitor. The name typically reflects the make and model of the monitor and is not guaranteed to be unique among the connected monitors.
- Parameters
-
[in] | monitor | The monitor to query. |
- Returns
- The UTF-8 encoded name of the monitor, or
NULL
if an error occurred.
- Pointer Lifetime
- The returned string is allocated and freed by GLFW. You should not free it yourself. It is valid until the specified monitor is disconnected or the library is terminated.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Monitor properties
- Since
- Added in GLFW 3.0.
◆ glfwGetMonitorPhysicalSize()
void glfwGetMonitorPhysicalSize |
( |
GLFWmonitor * |
monitor, |
|
|
int * |
widthMM, |
|
|
int * |
heightMM |
|
) |
| |
This function returns the size, in millimetres, of the display area of the specified monitor.
Some systems do not provide accurate monitor size information, either because the monitor EDID data is incorrect or because the driver does not report it accurately.
Any or all of the size arguments may be NULL
. If an error occurs, all non-NULL
size arguments will be set to zero.
- Parameters
-
[in] | monitor | The monitor to query. |
[out] | widthMM | Where to store the width, in millimetres, of the monitor's display area, or NULL . |
[out] | heightMM | Where to store the height, in millimetres, of the monitor's display area, or NULL . |
- Thread Safety
- This function may only be called from the main thread.
- See also
- Monitor properties
- Since
- Added in GLFW 3.0.
◆ glfwGetMonitorPos()
void glfwGetMonitorPos |
( |
GLFWmonitor * |
monitor, |
|
|
int * |
xpos, |
|
|
int * |
ypos |
|
) |
| |
This function returns the position, in screen coordinates, of the upper-left corner of the specified monitor.
Any or all of the position arguments may be NULL
. If an error occurs, all non-NULL
position arguments will be set to zero.
- Parameters
-
[in] | monitor | The monitor to query. |
[out] | xpos | Where to store the monitor x-coordinate, or NULL . |
[out] | ypos | Where to store the monitor y-coordinate, or NULL . |
- Thread Safety
- This function may only be called from the main thread.
- See also
- Monitor properties
- Since
- Added in GLFW 3.0.
◆ glfwGetMonitors()
This function returns an array of handles for all currently connected monitors. The primary monitor is always first in the returned array. If no monitors were found, this function returns NULL
.
- Parameters
-
[out] | count | Where to store the number of monitors in the returned array. This is set to zero if an error occurred. |
- Returns
- An array of monitor handles, or
NULL
if no monitors were found or if an error occurred.
- Pointer Lifetime
- The returned array is allocated and freed by GLFW. You should not free it yourself. It is guaranteed to be valid only until the monitor configuration changes or the library is terminated.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Retrieving monitors
-
Monitor configuration changes
-
glfwGetPrimaryMonitor
- Since
- Added in GLFW 3.0.
◆ glfwGetPrimaryMonitor()
This function returns the primary monitor. This is usually the monitor where elements like the task bar or global menu bar are located.
- Returns
- The primary monitor, or
NULL
if no monitors were found or if an error occurred.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Retrieving monitors
-
glfwGetMonitors
- Since
- Added in GLFW 3.0.
◆ glfwGetVideoMode()
This function returns the current video mode of the specified monitor. If you have created a full screen window for that monitor, the return value will depend on whether that window is iconified.
- Parameters
-
[in] | monitor | The monitor to query. |
- Returns
- The current mode of the monitor, or
NULL
if an error occurred.
- Pointer Lifetime
- The returned array is allocated and freed by GLFW. You should not free it yourself. It is valid until the specified monitor is disconnected or the library is terminated.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Video modes
-
glfwGetVideoModes
- Since
- Added in GLFW 3.0. Replaces
glfwGetDesktopMode
.
◆ glfwGetVideoModes()
This function returns an array of all video modes supported by the specified monitor. The returned array is sorted in ascending order, first by color bit depth (the sum of all channel depths) and then by resolution area (the product of width and height).
- Parameters
-
[in] | monitor | The monitor to query. |
[out] | count | Where to store the number of video modes in the returned array. This is set to zero if an error occurred. |
- Returns
- An array of video modes, or
NULL
if an error occurred.
- Pointer Lifetime
- The returned array is allocated and freed by GLFW. You should not free it yourself. It is valid until the specified monitor is disconnected, this function is called again for that monitor or the library is terminated.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Video modes
-
glfwGetVideoMode
- Since
- Added in GLFW 1.0.
- GLFW 3: Changed to return an array of modes for a specific monitor.
◆ glfwSetGamma()
void glfwSetGamma |
( |
GLFWmonitor * |
monitor, |
|
|
float |
gamma |
|
) |
| |
This function generates a 256-element gamma ramp from the specified exponent and then calls glfwSetGammaRamp with it. The value must be a finite number greater than zero.
- Parameters
-
[in] | monitor | The monitor whose gamma ramp to set. |
[in] | gamma | The desired exponent. |
- Thread Safety
- This function may only be called from the main thread.
- See also
- Gamma ramp
- Since
- Added in GLFW 3.0.
◆ glfwSetGammaRamp()
This function sets the current gamma ramp for the specified monitor. The original gamma ramp for that monitor is saved by GLFW the first time this function is called and is restored by glfwTerminate.
- Parameters
-
[in] | monitor | The monitor whose gamma ramp to set. |
[in] | ramp | The gamma ramp to use. |
- Pointer Lifetime
- The specified gamma ramp is copied before this function returns.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Gamma ramp
- Since
- Added in GLFW 3.0.
◆ glfwSetMonitorCallback()
This function sets the monitor configuration callback, or removes the currently set callback. This is called when a monitor is connected to or disconnected from the system.
- Parameters
-
[in] | cbfun | The new callback, or NULL to remove the currently set callback. |
- Returns
- The previously set callback, or
NULL
if no callback was set or the library had not been initialized.
- Bug:
- X11: This callback is not yet called on monitor configuration changes.
- Thread Safety
- This function may only be called from the main thread.
- See also
- Monitor configuration changes
- Since
- Added in GLFW 3.0.