Zengtudor/glfw
1
0
Fork 0
mirror of https://github.com/glfw/glfw.git synced 2024-11-25 19:42:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documentation work.

Browse Source
This commit is contained in:
Camilla Berglund 2014-10-06 23:18:33 +02:00
parent 95654cfada
commit 6be821c18b
3 changed files with 25 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/monitor.dox
View File

@ -112,7 +112,9 @@ const GLFWvidmode* mode = glfwGetVideoMode(monitor);
@subsection monitor_size Physical size @subsection monitor_size Physical size
The physical size in millimetres of a monitor, or an estimation of it, can be The physical size in millimetres of a monitor, or an estimation of it, can be
retrieved with @ref glfwGetMonitorPhysicalSize. retrieved with @ref glfwGetMonitorPhysicalSize. This has no relation to its
current _resolution_, i.e. the width and height of its current
[video mode](@ref monitor_modes).
@code @code
int widthMM, heightMM; int widthMM, heightMM;

4
docs/window.dox
View File

@ -213,8 +213,8 @@ You nearly always want to use double buffering. This is a hard constraint.
@subsubsection window_hints_mtr Monitor related hints @subsubsection window_hints_mtr Monitor related hints
`GLFW_REFRESH_RATE` specifies the desired refresh rate for full screen windows. `GLFW_REFRESH_RATE` specifies the desired refresh rate for full screen windows.
If set to zero, the highest available refresh rate will be used. This hint is If set to `GLFW_DONT_CARE`, the highest available refresh rate will be used.
ignored for windowed mode windows. This hint is ignored for windowed mode windows.
@subsubsection window_hints_ctx Context related hints @subsubsection window_hints_ctx Context related hints

35
include/GLFW/glfw3.h
View File

@ -1149,7 +1149,7 @@ GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it * 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 * yourself. It is guaranteed to be valid only until the monitor configuration
* changes. * changes or the library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -1252,7 +1252,8 @@ GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* width, int* h
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it * The returned string is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the specified monitor is disconnected. * yourself. It is valid until the specified monitor is disconnected or the
* library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -1307,8 +1308,8 @@ GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it * 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 this * yourself. It is valid until the specified monitor is disconnected, this
* function is called again for that monitor. * function is called again for that monitor or the library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -1339,7 +1340,8 @@ GLFWAPI const GLFWvidmode* glfwGetVideoModes(GLFWmonitor* monitor, int* count);
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it * The returned array is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the specified monitor is disconnected. * yourself. It is valid until the specified monitor is disconnected or the
* library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -1385,7 +1387,8 @@ GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma);
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned structure and its arrays are allocated and freed by GLFW. You * 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 * should not free them yourself. They are valid until the specified monitor
* is disconnected or this function is called again for that monitor. * is disconnected, this function is called again for that monitor or the
* library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -1448,7 +1451,7 @@ GLFWAPI void glfwDefaultWindowHints(void);
* This function sets hints for the next call to @ref glfwCreateWindow. The * This function sets hints for the next call to @ref glfwCreateWindow. The
* hints, once set, retain their values until changed by a call to @ref * hints, once set, retain their values until changed by a call to @ref
* glfwWindowHint or @ref glfwDefaultWindowHints, or until the library is * glfwWindowHint or @ref glfwDefaultWindowHints, or until the library is
* terminated with @ref glfwTerminate. * terminated.
* *
* @param[in] target The [window hint](@ref window_hints) to set. * @param[in] target The [window hint](@ref window_hints) to set.
* @param[in] hint The new value of the window hint. * @param[in] hint The new value of the window hint.
@ -2920,8 +2923,8 @@ GLFWAPI int glfwJoystickPresent(int joy);
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it * The returned array is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the specified joystick is disconnected or this * yourself. It is valid until the specified joystick is disconnected, this
* function is called again for that joystick. * function is called again for that joystick or the library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -2951,8 +2954,8 @@ GLFWAPI const float* glfwGetJoystickAxes(int joy, int* count);
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned array is allocated and freed by GLFW. You should not free it * The returned array is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the specified joystick is disconnected or this * yourself. It is valid until the specified joystick is disconnected, this
* function is called again for that joystick. * function is called again for that joystick or the library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -2981,8 +2984,8 @@ GLFWAPI const unsigned char* glfwGetJoystickButtons(int joy, int* count);
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it * The returned string is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the specified joystick is disconnected or this * yourself. It is valid until the specified joystick is disconnected, this
* function is called again for that joystick. * function is called again for that joystick or the library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -3032,7 +3035,8 @@ GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* string);
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned string is allocated and freed by GLFW. You should not free it * The returned string is allocated and freed by GLFW. You should not free it
* yourself. It is valid until the next call to @ref * yourself. It is valid until the next call to @ref
* glfwGetClipboardString or @ref glfwSetClipboardString. * glfwGetClipboardString or @ref glfwSetClipboardString, or until the library
* is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may only be called from the main thread. * This function may only be called from the main thread.
@ -3257,7 +3261,8 @@ GLFWAPI int glfwExtensionSupported(const char* extension);
* between contexts. * between contexts.
* *
* @par Pointer Lifetime * @par Pointer Lifetime
* The returned function pointer is valid until the context is destroyed. * The returned function pointer is valid until the context is destroyed or the
* library is terminated.
* *
* @par Thread Safety * @par Thread Safety
* This function may be called from any thread. * This function may be called from any thread.