mirror of
https://github.com/glfw/glfw.git
synced 2024-11-11 04:53:50 +00:00
Updated the documentation to reflect the new key codes.
This commit is contained in:
parent
8943a78a65
commit
0f0cff46f0
@ -1212,28 +1212,53 @@ differently on different systems. Do not make any assumptions about when or why
|
||||
\begin{center}
|
||||
\begin{tabular}{|l|l|} \hline \raggedright
|
||||
\textbf{Name} & \textbf{Description} \\ \hline
|
||||
GLFW\_KEY\_\textit{X} & Letter (\textit{X} can be in the range A..Z)\\ \hline
|
||||
GLFW\_KEY\_\textit{n} & Number (\textit{n} can be in the range 0..9)\\ \hline
|
||||
GLFW\_KEY\_SPACE & Space\\ \hline
|
||||
GLFW\_KEY\_ESC & Escape\\ \hline
|
||||
GLFW\_KEY\_MINUS & Minus (-)\\ \hline
|
||||
GLFW\_KEY\_EQUAL & Equal (=)\\ \hline
|
||||
GLFW\_KEY\_LEFT\_BRACKET & Left bracket ([)\\ \hline
|
||||
GLFW\_KEY\_RIGHT\_BRACKET & Right bracket (])\\ \hline
|
||||
GLFW\_KEY\_GRAVE\_ACCENT & Grave accent (`)\\ \hline
|
||||
GLFW\_KEY\_APOSTROPHE & Apostrophe (')\\ \hline
|
||||
GLFW\_KEY\_COMMA & Comma (,)\\ \hline
|
||||
GLFW\_KEY\_PERIOD & Period (.)\\ \hline
|
||||
GLFW\_KEY\_SEMICOLON & Semicolon (;)\\ \hline
|
||||
GLFW\_KEY\_SLASH & Slash ($/$)\\ \hline
|
||||
GLFW\_KEY\_BACKSLASH & Backslash ($\backslash$)\\ \hline
|
||||
GLFW\_KEY\_WORLD\_1 & Non-US character no. 1\\ \hline
|
||||
GLFW\_KEY\_WORLD\_2 & Non-US character no. 2\\ \hline
|
||||
\end{tabular}
|
||||
\end{center}
|
||||
\caption[Key codes for printable keys]{Key codes for printable keys. The keys are named according to the US keyboard layout, but represent physical keys (so for instance, GLFW\_KEY\_Z represents the same physical key, regardless of the system input language).}
|
||||
\label{tab:keys1}
|
||||
\end{table}
|
||||
|
||||
\begin{table}[p]
|
||||
\begin{center}
|
||||
\begin{tabular}{|l|l|} \hline \raggedright
|
||||
\textbf{Name} & \textbf{Description} \\ \hline
|
||||
GLFW\_KEY\_ESCAPE & Escape\\ \hline
|
||||
GLFW\_KEY\_F\textit{n} & Function key \textit{n} (\textit{n} can be in the range 1..25)\\ \hline
|
||||
GLFW\_KEY\_UP & Cursor up\\ \hline
|
||||
GLFW\_KEY\_DOWN & Cursor down\\ \hline
|
||||
GLFW\_KEY\_LEFT & Cursor left\\ \hline
|
||||
GLFW\_KEY\_RIGHT & Cursor right\\ \hline
|
||||
GLFW\_KEY\_LSHIFT & Left shift key\\ \hline
|
||||
GLFW\_KEY\_RSHIFT & Right shift key\\ \hline
|
||||
GLFW\_KEY\_LCTRL & Left control key\\ \hline
|
||||
GLFW\_KEY\_RCTRL & Right control key\\ \hline
|
||||
GLFW\_KEY\_LALT & Left alternate function key\\ \hline
|
||||
GLFW\_KEY\_RALT & Right alternate function key\\ \hline
|
||||
GLFW\_KEY\_LSUPER & Left super key, WinKey, or command key\\ \hline
|
||||
GLFW\_KEY\_RSUPER & Right super key, WinKey, or command key\\ \hline
|
||||
GLFW\_KEY\_LEFT\_SHIFT & Left shift key\\ \hline
|
||||
GLFW\_KEY\_RIGHT\_SHIFT & Right shift key\\ \hline
|
||||
GLFW\_KEY\_LEFT\_CTRL & Left control key\\ \hline
|
||||
GLFW\_KEY\_RIGHT\_CTRL & Right control key\\ \hline
|
||||
GLFW\_KEY\_LEFT\_ALT & Left alternate function key\\ \hline
|
||||
GLFW\_KEY\_RIGHT\_ALT & Right alternate function key\\ \hline
|
||||
GLFW\_KEY\_LEFT\_SUPER & Left super key, WinKey, or command key\\ \hline
|
||||
GLFW\_KEY\_RIGHT\_SUPER & Right super key, WinKey, or command key\\ \hline
|
||||
GLFW\_KEY\_TAB & Tabulator\\ \hline
|
||||
GLFW\_KEY\_ENTER & Enter\\ \hline
|
||||
GLFW\_KEY\_BACKSPACE & Backspace\\ \hline
|
||||
GLFW\_KEY\_INSERT & Insert\\ \hline
|
||||
GLFW\_KEY\_DEL & Delete\\ \hline
|
||||
GLFW\_KEY\_PAGEUP & Page up\\ \hline
|
||||
GLFW\_KEY\_PAGEDOWN & Page down\\ \hline
|
||||
GLFW\_KEY\_DELETE & Delete\\ \hline
|
||||
GLFW\_KEY\_PAGE\_UP & Page up\\ \hline
|
||||
GLFW\_KEY\_PAGE\_DOWN & Page down\\ \hline
|
||||
GLFW\_KEY\_HOME & Home\\ \hline
|
||||
GLFW\_KEY\_END & End\\ \hline
|
||||
GLFW\_KEY\_KP\_\textit{n} & Keypad numeric key \textit{n} (\textit{n} can be in the range 0..9)\\ \hline
|
||||
@ -1244,15 +1269,15 @@ GLFW\_KEY\_KP\_ADD & Keypad add ($+$)\\ \hline
|
||||
GLFW\_KEY\_KP\_DECIMAL & Keypad decimal (. or ,)\\ \hline
|
||||
GLFW\_KEY\_KP\_EQUAL & Keypad equal (=)\\ \hline
|
||||
GLFW\_KEY\_KP\_ENTER & Keypad enter\\ \hline
|
||||
GLFW\_KEY\_KP\_NUM\_LOCK & Keypad num lock\\ \hline
|
||||
GLFW\_KEY\_NUM\_LOCK & Num lock\\ \hline
|
||||
GLFW\_KEY\_CAPS\_LOCK & Caps lock\\ \hline
|
||||
GLFW\_KEY\_SCROLL\_LOCK & Scroll lock\\ \hline
|
||||
GLFW\_KEY\_PAUSE & Pause key\\ \hline
|
||||
GLFW\_KEY\_MENU & Menu key\\ \hline
|
||||
\end{tabular}
|
||||
\end{center}
|
||||
\caption{Special key identifiers}
|
||||
\label{tab:keys}
|
||||
\caption{Key codes for function keys}
|
||||
\label{tab:keys2}
|
||||
\end{table}
|
||||
|
||||
|
||||
@ -1283,9 +1308,8 @@ int glfwGetKey(int key)
|
||||
\begin{refparameters}
|
||||
\begin{description}
|
||||
\item [\textit{key}]\ \\
|
||||
A keyboard key identifier, which can be either an uppercase printable
|
||||
ISO~8859-1 (Latin~1) character (e.g. 'A', '3' or '.'), or a special key
|
||||
identifier. Table \ref{tab:keys} lists valid special key identifiers.
|
||||
A keyboard key identifier, which can be any of the key codes in tables
|
||||
\ref{tab:keys1} and \ref{tab:keys2}.
|
||||
\end{description}
|
||||
\end{refparameters}
|
||||
|
||||
@ -1499,10 +1523,8 @@ void glfwSetKeyCallback(GLFWkeyfun cbfun)
|
||||
\texttt{void functionname(int key, int action);}
|
||||
|
||||
Where \textit{functionname} is the name of the callback function,
|
||||
\textit{key} is a key identifier, which is an uppercase printable
|
||||
ISO~8859-1 character or a special key identifier (see table
|
||||
\ref{tab:keys}), and \textit{action} is either GLFW\_PRESS or
|
||||
GLFW\_RELEASE.
|
||||
\textit{key} is a key code (see tables \ref{tab:keys1} and \ref{tab:keys2}),
|
||||
and \textit{action} is either GLFW\_PRESS or GLFW\_RELEASE.
|
||||
|
||||
If \textit{cbfun} is NULL, any previously set callback function
|
||||
will be unset.
|
||||
|
@ -221,16 +221,14 @@ int glfwGetKey(int key)
|
||||
\end{lstlisting}
|
||||
|
||||
It queries the current status of individual keyboard keys. The argument
|
||||
\textit{key} specifies which key to check, and it can be either an
|
||||
uppercase printable ISO 8859-1 (Latin 1) character (e.g. `A', `3' or `.'),
|
||||
or a special key identifier (see the \textit{GLFW Reference Manual} for a
|
||||
list of special key identifiers). \textbf{glfwGetKey} returns GLFW\_PRESS
|
||||
if the key is currently held down, or GLFW\_RELEASE if the key is not being
|
||||
held down. For example:
|
||||
\textit{key} specifies which key to check, and it must be a valid GLFW key code
|
||||
(see the \textit{GLFW Reference Manual} for a list of key codes).
|
||||
\textbf{glfwGetKey} returns GLFW\_PRESS if the key is currently held down, or
|
||||
GLFW\_RELEASE if the key is not being held down. For example:
|
||||
|
||||
\begin{lstlisting}
|
||||
A_pressed = glfwGetKey('A');
|
||||
esc_pressed = glfwGetKey(GLFW_KEY_ESC);
|
||||
A_pressed = glfwGetKey(GLFW_KEY_A);
|
||||
esc_pressed = glfwGetKey(GLFW_KEY_ESCAPE);
|
||||
\end{lstlisting}
|
||||
|
||||
In order for \textbf{glfwGetKey} to have any effect, you need to poll for
|
||||
@ -282,7 +280,7 @@ int main(void)
|
||||
glfwSwapBuffers();
|
||||
|
||||
// Check if ESC key was pressed or window was closed
|
||||
running = !glfwGetKey(GLFW_KEY_ESC) &&
|
||||
running = !glfwGetKey(GLFW_KEY_ESCAPE) &&
|
||||
glfwGetWindowParam(GLFW_OPENED);
|
||||
}
|
||||
|
||||
@ -698,8 +696,7 @@ int glfwGetKey(int key)
|
||||
\end{lstlisting}
|
||||
|
||||
It queries the current status of individual keyboard keys. The argument
|
||||
\textit{key} specifies which key to check, and it can be either an
|
||||
uppercase ISO~8859-1 character, or a special key identifier.
|
||||
\textit{key} specifies which key to check, which must be a valid GLFW key code.
|
||||
\textbf{glfwGetKey} returns GLFW\_PRESS (or 1) if the key is currently
|
||||
held down, or GLFW\_RELEASE (or 0) if the key is not being held down.
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user