This is the glfw Reference Manual, version 1.0.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Dec 15 06:18:12 2024 GMT+0.
The main system appears first, followed by any subsystem dependency.
glfwAn up-to-date bindings library to the most recent GLFW OpenGL context management library
Yukari Hafner <shinmera@tymoon.eu>
Yukari Hafner <shinmera@tymoon.eu>
(GIT https://github.com/shirakumo/glfw.git)
zlib
1.0.0
documentation-utils (system).
float-features (system).
cl-opengl (system).
cffi (system).
package.lisp (file).
low-level.lisp (file).
wrapper.lisp (file).
documentation.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
glfw/low-level.lisppackage.lisp (file).
glfw (system).
allocate (generic function).
allocator-allocate (function).
(setf allocator-allocate) (function).
allocator-deallocate (function).
(setf allocator-deallocate) (function).
allocator-reallocate (function).
(setf allocator-reallocate) (function).
allocator-user (function).
(setf allocator-user) (function).
char-entered (generic function).
create-cursor (function).
create-standard-cursor (function).
create-window (function).
create-window-surface (function).
deallocate (generic function).
debug-log (generic function).
default-window-hints (function).
destroy-cursor (function).
destroy-window (function).
error (function).
extension-supported (function).
file-dropped (generic function).
focus-window (function).
framebuffer-resized (generic function).
gamepad-state-axes (function).
(setf gamepad-state-axes) (function).
gamepad-state-buttons (function).
(setf gamepad-state-buttons) (function).
gamma-ramp-blue (function).
(setf gamma-ramp-blue) (function).
gamma-ramp-green (function).
(setf gamma-ramp-green) (function).
gamma-ramp-red (function).
(setf gamma-ramp-red) (function).
gamma-ramp-size (function).
(setf gamma-ramp-size) (function).
get-clipboard-string (function).
get-cocoa-monitor (function).
get-cocoa-window (function).
get-current-context (function).
get-cursor-pos (function).
get-eglcontext (function).
get-egldisplay (function).
get-eglsurface (function).
get-error (function).
get-framebuffer-size (function).
get-gamepad-name (function).
get-gamepad-state (function).
get-gamma-ramp (function).
get-glxcontext (function).
get-glxwindow (function).
get-input-mode (function).
get-instance-proc-address (function).
get-joystick-axes (function).
get-joystick-buttons (function).
get-joystick-guid (function).
get-joystick-hats (function).
get-joystick-name (function).
get-joystick-user-pointer (function).
get-key (function).
get-key-name (function).
get-key-scancode (function).
get-monitor-content-scale (function).
get-monitor-name (function).
get-monitor-physical-size (function).
get-monitor-pos (function).
get-monitor-user-pointer (function).
get-monitor-workarea (function).
get-monitors (function).
get-mouse-button (function).
get-nsglcontext (function).
get-osmesa-color-buffer (function).
get-osmesa-context (function).
get-osmesa-depth-buffer (function).
get-physical-device-presentation-support (function).
get-platform (function).
get-primary-monitor (function).
get-proc-address (function).
get-required-instance-extensions (function).
get-time (function).
get-timer-frequency (function).
get-timer-value (function).
get-version (function).
get-version-string (function).
get-video-mode (function).
get-video-modes (function).
get-wayland-display (function).
get-wayland-monitor (function).
get-wayland-window (function).
get-wglcontext (function).
get-win32-adapter (function).
get-win32-monitor (function).
get-win32-window (function).
get-window-attrib (function).
get-window-content-scale (function).
get-window-frame-size (function).
get-window-monitor (function).
get-window-opacity (function).
get-window-pos (function).
get-window-size (function).
get-window-user-pointer (function).
get-x11-adapter (function).
get-x11-display (function).
get-x11-monitor (function).
get-x11-selection-string (function).
get-x11-window (function).
hide-window (function).
iconify-window (function).
image-height (function).
(setf image-height) (function).
image-pixels (function).
(setf image-pixels) (function).
image-width (function).
(setf image-width) (function).
init (function).
init-allocator (function).
init-hint (function).
init-vulkan-loader (function).
joystick-connected (function).
joystick-disconnected (function).
joystick-is-gamepad (function).
joystick-present (function).
key-changed (generic function).
make-context-current (function).
maximize-window (function).
mouse-button-changed (generic function).
mouse-entered (generic function).
mouse-moved (generic function).
mouse-scrolled (generic function).
platform-supported (function).
poll-events (function).
post-empty-event (function).
raw-mouse-motion-supported (function).
reallocate (generic function).
request-window-attention (function).
restore-window (function).
set-char-callback (function).
set-char-mods-callback (function).
set-clipboard-string (function).
set-cursor (function).
set-cursor-enter-callback (function).
set-cursor-pos (function).
set-cursor-pos-callback (function).
set-drop-callback (function).
set-error-callback (function).
set-framebuffer-size-callback (function).
set-gamma (function).
set-gamma-ramp (function).
set-input-mode (function).
set-joystick-callback (function).
set-joystick-user-pointer (function).
set-key-callback (function).
set-monitor-callback (function).
set-monitor-user-pointer (function).
set-mouse-button-callback (function).
set-scroll-callback (function).
set-time (function).
set-window-aspect-ratio (function).
set-window-attrib (function).
set-window-close-callback (function).
set-window-content-scale-callback (function).
set-window-focus-callback (function).
set-window-icon (function).
set-window-iconify-callback (function).
set-window-maximize-callback (function).
set-window-monitor (function).
set-window-opacity (function).
set-window-pos (function).
set-window-pos-callback (function).
set-window-refresh-callback (function).
set-window-should-close (function).
set-window-size (function).
set-window-size-callback (function).
set-window-size-limits (function).
set-window-title (function).
set-window-user-pointer (function).
set-x11-selection-string (function).
show-window (function).
swap-buffers (function).
swap-interval (function).
terminate (function).
update-gamepad-mappings (function).
video-mode-blue-bits (function).
(setf video-mode-blue-bits) (function).
video-mode-green-bits (function).
(setf video-mode-green-bits) (function).
video-mode-height (function).
(setf video-mode-height) (function).
video-mode-red-bits (function).
(setf video-mode-red-bits) (function).
video-mode-refresh-rate (function).
(setf video-mode-refresh-rate) (function).
video-mode-width (function).
(setf video-mode-width) (function).
vulkan-supported (function).
wait-events (function).
wait-events-timeout (function).
window-closed (generic function).
window-content-scale-changed (generic function).
window-focused (generic function).
window-hint (function).
window-hint-string (function).
window-iconified (generic function).
window-maximized (generic function).
window-moved (generic function).
window-refreshed (generic function).
window-resized (generic function).
window-should-close (function).
*here* (special variable).
*static* (special variable).
allocator-tclass (class).
defglfwcallback (macro).
defglfwfun (macro).
gamepad-state-tclass (class).
gamma-ramp-tclass (class).
image-tclass (class).
translate-name (function).
video-mode-tclass (class).
glfw/wrapper.lisplow-level.lisp (file).
glfw (system).
allocate (method).
aspect-ratio (reader method).
(setf aspect-ratio) (writer method).
(setf aspect-ratio) (method).
(setf aspect-ratio) (method).
attribute (method).
(setf attribute) (method).
center (method).
char-entered (method).
clipboard-string (method).
(setf clipboard-string) (method).
code (reader method).
content-scale (method).
content-scale (method).
cursor (method).
(setf cursor) (method).
(setf cursor) (method).
cursor (class).
cursor-location (method).
(setf cursor-location) (method).
deallocate (method).
debug-log (method).
destroy (generic function).
file-dropped (method).
focus (method).
foreign-object (class).
frame-size (method).
framebuffer-resized (method).
framebuffer-size (method).
gamma (method).
(setf gamma) (method).
gamma-ramp (method).
(setf gamma-ramp) (method).
get-current (method).
glfw-error (condition).
height (reader method).
height (method).
(setf height) (method).
hide (method).
icon (reader method).
(setf icon) (writer method).
(setf icon) (method).
iconified-p (method).
(setf iconified-p) (method).
iconify (method).
init (function).
initialize-instance (method).
initialize-instance (method).
initialize-instance (method).
initialize-instance (method).
input-mode (method).
(setf input-mode) (method).
key-changed (method).
key-state (method).
list-monitors (function).
location (method).
location (method).
(setf location) (method).
make-current (method).
make-current (method).
maximize (method).
maximized-p (method).
(setf maximized-p) (method).
message (reader method).
monitor (method).
(setf monitor) (method).
(setf monitor) (method).
(setf monitor) (method).
(setf monitor) (method).
monitor (class).
monitor-connected (function).
monitor-disconnected (function).
mouse-button-changed (method).
mouse-button-state (method).
mouse-entered (method).
mouse-moved (method).
mouse-scrolled (method).
name (method).
name (reader method).
opacity (method).
(setf opacity) (method).
operation (reader method).
physical-size (method).
platform (function).
pointer (reader method).
(setf pointer) (writer method).
poll-events (function).
primary-monitor (function).
print-object (method).
print-object (method).
print-object (method).
print-object (method).
reallocate (method).
refresh-rate (method).
register-callbacks (method).
request-attention (method).
resolve-window (function).
restore (method).
shared-initialize (method).
should-close-p (method).
(setf should-close-p) (method).
show (method).
shutdown (function).
size (method).
size (method).
(setf size) (method).
size-limits (reader method).
(setf size-limits) (writer method).
(setf size-limits) (method).
state (method).
(setf state) (method).
swap-buffers (method).
swap-interval (reader method).
(setf swap-interval) (writer method).
(setf swap-interval) (method).
time (function).
(setf time) (function).
timestamp (function).
timestamp-resolution (function).
title (reader method).
(setf title) (writer method).
(setf title) (method).
version (function).
video-mode (method).
video-modes (reader method).
visible-p (method).
(setf visible-p) (method).
width (reader method).
width (method).
(setf width) (method).
window (class).
window-closed (method).
window-content-scale-changed (method).
window-focused (method).
window-iconified (method).
window-maximized (method).
window-moved (method).
window-refreshed (method).
window-resized (method).
window-resized (method).
with-game-loop (macro).
work-area (method).
*initialized* (special variable).
*monitors* (special variable).
*object-table* (special variable).
cursor-table (reader method).
(setf cursor-table) (writer method).
extract-values (macro).
find-window-monitor (function).
flag-value (function).
glfw (macro).
list-video-modes (method).
ptr-object (function).
(setf ptr-object) (function).
standard-cursor (class).
glfw/documentation.lispwrapper.lisp (file).
glfw (system).
Packages are listed by definition order.
org.shirakumo.fraf.glfwcommon-lisp.
aspect-ratio (generic reader).
(setf aspect-ratio) (generic function).
attribute (generic function).
(setf attribute) (generic function).
center (generic function).
clipboard-string (generic function).
(setf clipboard-string) (generic function).
code (generic reader).
content-scale (generic function).
cursor (generic function).
(setf cursor) (generic function).
cursor (class).
cursor-location (generic function).
(setf cursor-location) (generic function).
destroy (generic function).
focus (generic function).
foreign-object (class).
frame-size (generic function).
framebuffer-size (generic function).
gamma (generic function).
(setf gamma) (generic function).
gamma-ramp (generic function).
(setf gamma-ramp) (generic function).
get-current (generic function).
glfw-error (condition).
height (generic function).
(setf height) (generic function).
hide (generic function).
icon (generic reader).
(setf icon) (generic function).
iconified-p (generic function).
(setf iconified-p) (generic function).
iconify (generic function).
init (function).
input-mode (generic function).
(setf input-mode) (generic function).
key-state (generic function).
list-monitors (function).
location (generic function).
(setf location) (generic function).
make-current (generic function).
maximize (generic function).
maximized-p (generic function).
(setf maximized-p) (generic function).
message (generic reader).
monitor (generic function).
(setf monitor) (generic function).
monitor (class).
mouse-button-state (generic function).
name (generic function).
opacity (generic function).
(setf opacity) (generic function).
operation (generic reader).
physical-size (generic function).
platform (function).
pointer (generic reader).
(setf pointer) (generic writer).
poll-events (function).
primary-monitor (function).
refresh-rate (generic function).
register-callbacks (generic function).
request-attention (generic function).
restore (generic function).
should-close-p (generic function).
(setf should-close-p) (generic function).
show (generic function).
shutdown (function).
size (generic function).
(setf size) (generic function).
size-limits (generic reader).
(setf size-limits) (generic function).
state (generic function).
(setf state) (generic function).
swap-buffers (generic function).
swap-interval (generic reader).
(setf swap-interval) (generic function).
time (function).
(setf time) (function).
timestamp (function).
timestamp-resolution (function).
title (generic reader).
(setf title) (generic function).
version (function).
video-mode (generic function).
video-modes (generic reader).
visible-p (generic function).
(setf visible-p) (generic function).
width (generic function).
(setf width) (generic function).
window (class).
with-game-loop (macro).
work-area (generic function).
*initialized* (special variable).
*monitors* (special variable).
*object-table* (special variable).
cursor-table (generic reader).
(setf cursor-table) (generic writer).
extract-values (macro).
find-window-monitor (function).
flag-value (function).
glfw (macro).
list-video-modes (generic function).
ptr-object (function).
(setf ptr-object) (function).
standard-cursor (class).
org.shirakumo.fraf.glfw.cfficommon-lisp.
allocate (generic function).
allocator-allocate (function).
(setf allocator-allocate) (function).
allocator-deallocate (function).
(setf allocator-deallocate) (function).
allocator-reallocate (function).
(setf allocator-reallocate) (function).
allocator-user (function).
(setf allocator-user) (function).
char-entered (generic function).
create-cursor (function).
create-standard-cursor (function).
create-window (function).
create-window-surface (function).
deallocate (generic function).
debug-log (generic function).
default-window-hints (function).
destroy-cursor (function).
destroy-window (function).
error (function).
extension-supported (function).
file-dropped (generic function).
focus-window (function).
framebuffer-resized (generic function).
gamepad-state-axes (function).
(setf gamepad-state-axes) (function).
gamepad-state-buttons (function).
(setf gamepad-state-buttons) (function).
gamma-ramp-blue (function).
(setf gamma-ramp-blue) (function).
gamma-ramp-green (function).
(setf gamma-ramp-green) (function).
gamma-ramp-red (function).
(setf gamma-ramp-red) (function).
gamma-ramp-size (function).
(setf gamma-ramp-size) (function).
get-clipboard-string (function).
get-cocoa-monitor (function).
get-cocoa-window (function).
get-current-context (function).
get-cursor-pos (function).
get-eglcontext (function).
get-egldisplay (function).
get-eglsurface (function).
get-error (function).
get-framebuffer-size (function).
get-gamepad-name (function).
get-gamepad-state (function).
get-gamma-ramp (function).
get-glxcontext (function).
get-glxwindow (function).
get-input-mode (function).
get-instance-proc-address (function).
get-joystick-axes (function).
get-joystick-buttons (function).
get-joystick-guid (function).
get-joystick-hats (function).
get-joystick-name (function).
get-joystick-user-pointer (function).
get-key (function).
get-key-name (function).
get-key-scancode (function).
get-monitor-content-scale (function).
get-monitor-name (function).
get-monitor-physical-size (function).
get-monitor-pos (function).
get-monitor-user-pointer (function).
get-monitor-workarea (function).
get-monitors (function).
get-mouse-button (function).
get-nsglcontext (function).
get-osmesa-color-buffer (function).
get-osmesa-context (function).
get-osmesa-depth-buffer (function).
get-physical-device-presentation-support (function).
get-platform (function).
get-primary-monitor (function).
get-proc-address (function).
get-required-instance-extensions (function).
get-time (function).
get-timer-frequency (function).
get-timer-value (function).
get-version (function).
get-version-string (function).
get-video-mode (function).
get-video-modes (function).
get-wayland-display (function).
get-wayland-monitor (function).
get-wayland-window (function).
get-wglcontext (function).
get-win32-adapter (function).
get-win32-monitor (function).
get-win32-window (function).
get-window-attrib (function).
get-window-content-scale (function).
get-window-frame-size (function).
get-window-monitor (function).
get-window-opacity (function).
get-window-pos (function).
get-window-size (function).
get-window-user-pointer (function).
get-x11-adapter (function).
get-x11-display (function).
get-x11-monitor (function).
get-x11-selection-string (function).
get-x11-window (function).
hide-window (function).
iconify-window (function).
image-height (function).
(setf image-height) (function).
image-pixels (function).
(setf image-pixels) (function).
image-width (function).
(setf image-width) (function).
init (function).
init-allocator (function).
init-hint (function).
init-vulkan-loader (function).
joystick-connected (function).
joystick-disconnected (function).
joystick-is-gamepad (function).
joystick-present (function).
key-changed (generic function).
make-context-current (function).
maximize-window (function).
monitor-connected (function).
monitor-disconnected (function).
mouse-button-changed (generic function).
mouse-entered (generic function).
mouse-moved (generic function).
mouse-scrolled (generic function).
platform-supported (function).
poll-events (function).
post-empty-event (function).
raw-mouse-motion-supported (function).
reallocate (generic function).
request-window-attention (function).
resolve-window (function).
restore-window (function).
set-char-callback (function).
set-char-mods-callback (function).
set-clipboard-string (function).
set-cursor (function).
set-cursor-enter-callback (function).
set-cursor-pos (function).
set-cursor-pos-callback (function).
set-drop-callback (function).
set-error-callback (function).
set-framebuffer-size-callback (function).
set-gamma (function).
set-gamma-ramp (function).
set-input-mode (function).
set-joystick-callback (function).
set-joystick-user-pointer (function).
set-key-callback (function).
set-monitor-callback (function).
set-monitor-user-pointer (function).
set-mouse-button-callback (function).
set-scroll-callback (function).
set-time (function).
set-window-aspect-ratio (function).
set-window-attrib (function).
set-window-close-callback (function).
set-window-content-scale-callback (function).
set-window-focus-callback (function).
set-window-icon (function).
set-window-iconify-callback (function).
set-window-maximize-callback (function).
set-window-monitor (function).
set-window-opacity (function).
set-window-pos (function).
set-window-pos-callback (function).
set-window-refresh-callback (function).
set-window-should-close (function).
set-window-size (function).
set-window-size-callback (function).
set-window-size-limits (function).
set-window-title (function).
set-window-user-pointer (function).
set-x11-selection-string (function).
show-window (function).
swap-buffers (function).
swap-interval (function).
terminate (function).
update-gamepad-mappings (function).
video-mode-blue-bits (function).
(setf video-mode-blue-bits) (function).
video-mode-green-bits (function).
(setf video-mode-green-bits) (function).
video-mode-height (function).
(setf video-mode-height) (function).
video-mode-red-bits (function).
(setf video-mode-red-bits) (function).
video-mode-refresh-rate (function).
(setf video-mode-refresh-rate) (function).
video-mode-width (function).
(setf video-mode-width) (function).
vulkan-supported (function).
wait-events (function).
wait-events-timeout (function).
window-closed (generic function).
window-content-scale-changed (generic function).
window-focused (generic function).
window-hint (function).
window-hint-string (function).
window-iconified (generic function).
window-maximized (generic function).
window-moved (generic function).
window-refreshed (generic function).
window-resized (generic function).
window-should-close (function).
*here* (special variable).
*static* (special variable).
allocator-tclass (class).
defglfwcallback (macro).
defglfwfun (macro).
gamepad-state-tclass (class).
gamma-ramp-tclass (class).
image-tclass (class).
translate-name (function).
video-mode-tclass (class).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Convenience macro to provide a basic single-threaded game loop.
This does the following:
1. Call INIT
2. Create a window instance with the given initargs as WINDOW
3. In a loop perform the following until SHOULD-CLOSE-P:
1. Call POLL-EVENTS to handle input events
2. Compute the time difference since the last iteration as DT
3. Evaluate BODY
4. Call SWAP-BUFFERS to display graphics
4. Call FINALIZE
This provides a standard variable frame rate game loop. You must use
DT in all your physics steps, or manually slow down the thread to a
fixed timestep. Please note that correctly implementing physics and
graphics timestepping can be quite involved however, and this macro is
only meant for simple tests. You’ll want to implement your own system
based on it at some point.
See WINDOW (type)
See TIMESTAMP
See TIMESTAMP-RESOLUTION
See INIT
See FINALIZE
See POLL-EVENTS
See SWAP-BUFFERS
See SHOULD-CLOSE-P
Initialise the library.
This will load libglfw and initialize it. You may pass keyword
arguments to control the library initialization. You can find more
information on the initialization options and their effects in the
GLFW documentation:
https://www.glfw.org/docs/latest/intro_guide.html#init_hints
It is safe to call this function multiple times. Once you are done
with the library, you should call SHUTDOWN to clean things up.
Calling any other function in the library before INIT is called will
lead to undefined behaviour.
See SHUTDOWN
List all available monitors.
This returns a fresh list of available MONITOR instances.
If REFRESH is passed, the list of available monitors is refreshed
directly. This is typically not necessary, as changes in the monitor
listing are instead dynamically monitored and the value of
LIST-MONITORS should always be accurate.
INIT must be called before this function returns anything useful.
See MONITOR (type)
Returns the currently used platform.
This may be one of:
:WIN32
:COCOA
:WAYLAND
:X11
:NULL-PLATFORM
Process new events synchronously.
Returns after processing events. This will cause event callbacks to be
called in the same thread.
The TIMEOUT may be one of:
T — Blocks until *some* events have been processed
NIL — Returns immediately if there are no events to process
REAL — Blocks until some events were processed or at most the
given number of seconds have elapsed
See WINDOW (type)
Returns the monitor that is configured as the "primary".
See MONITOR (type)
Shuts the library down.
This will clean up all the windows and other objects, and call GLFW’s
terminate function.
It is safe to call this function multiple times.
Calling any other function in the library after SHUTDOWN is called and before INIT is called again will lead to undefined behaviour.
See INIT
Accesses the current time in seconds as a double-float.
If this was not explicitly set, the time is measured since INIT has been called.
Returns a monotonically increasing timestamp.
See TIMESTAMP-RESOLUTION
Returns the resolution of the timestamp in units/second.
See TIMESTAMP
Returns the version of the GLFW library.
This is a list of (MAJOR MINOR REVISION)
Allocate a block of memory.
This callback is only used if the window is initialised as an
allocator.
Should return pointer to the allocated block if successful, or a null
pointer if not.
See WINDOW (type)
Accesses the forced aspect ratio of the window.
If NIL, no aspect ratio is enforced.
See WINDOW (type)
Access an attribute of the window.
The attribute may be one of:
:DECORATED — Whether the window has a border
:RESIZABLE — Whether the window is resizable
:FLOATING — Whether the window should be "always on top"
:AUTO-ICONIFY — Whether the window should iconify on focus
loss
:FOCUS-ON-SHOW — Whether to request focus when the window is
made visible.
See WINDOW (type)
Centers the window on the given monitor.
If no monitor is passed, the window’s current monitor is used.
See WINDOW (type)
See MONITOR (type)
Callback for when text has been entered.
The CODE-POINT is the unicode code point of the character that has
been entered. You may convert it to a CHARACTER via CL:CODE-CHAR.
The MODIFIERS is a list of active modifier keys at the time, which may
include:
:SHIFT
:CONTROL
:ALT
:SUPER
:CAPS-LOCK
:NUM-LOCK
Users may implement a primary method on this function to react to the
event.
See CL:CODE-CHAR
See WINDOW (type)
Accesses the current clipboard contents.
See WINDOW (type)
Returns the error code that was returned.
See GLFW-ERROR
glfw-error)) ¶code.
Returns the window’s content scaling factor.
This is a list of (X Y).
See WINDOW (type)
Accesses the cursor of the window
You may also call this function with a keyword to retrieve one of
several standard cursor shapes, or directly set a keyword to set one
of those shapes.
See WINDOW (type)
See CURSOR (type)
Accesses the current location of the mouse cursor.
This is a list of (X Y).
See WINDOW (type)
Free a block of memory.
This callback is only used if the window is initialised as an
allocator.
See WINDOW (type)
Finalize and clean up the object.
After this function has been called, the POINTER will be NIL.
It is safe to call this function multiple times.
Using the object in any other way after DESTROY has been called on it
will lead to undefined behaviour.
See POINTER
See FOREIGN-OBJECT (type)
standard-cursor)) ¶Callback for when one or more files have been dropped onto the window.
PATHS is a list of the dropped files’ paths as strings, typically in
the format of a native namestring.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Request the window to gain focus.
See WINDOW (type)
Returns the window’s frame size including decorations.
This is a list of (LEFT TOP RIGHT BOTTOM)
See WINDOW (type)
Callback for when the underlying framebuffer has been resized.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Returns the window’s backing framebuffer resolution.
This is a list of (W H).
See WINDOW (type)
Accesses the gamma of the monitor.
Note that this is in addition to any operating system gamma
ramping. This function is a simplified version of the more detailed
GAMMA-RAMP function. The returned GAMMA is estimated based on the
ramp’s midpoint.
See GAMMA-RAMP
See MONITOR (type)
Accesses the gamma ramp of the monitor.
Note that this is in addition to any operating system gamma ramping. The value must be a plist composed of the following entries:
:RED
:GREEN
:BLUE
Each entry must be a (vector (unsigned-byte 16)) of the same
length. Which length is acceptable and whether the ramp can be set
depends on the operating system. A safe length is 256 entries.
See GAMMA
See MONITOR (type)
Retrieves the current window of the calling thread, if any.
See WINDOW (type)
Accesses the height of the window or monitor in pixels.
See SIZE
See MONITOR (type)
See WINDOW (type)
Request to make the window invisible.
see SHOW
See WINDOW (type)
Access the icons of the application.
Should be a list of images, where each icon image is a list of the
format (PIXELS WIDTH HEIGHT), and where pixels is a
(simple-array (unsigned-byte 8) (*)) with the length (* width height 4)
holding the RGBA encoded pixel data of the icon, top-left aligned.
See WINDOW (type)
Accesses whether the window is iconified.
See ICONIFY
See RESTORE
See STATE
See WINDOW (type)
Request the window to be iconified.
See RESTORE
See WINDOW (type)
Access the state of an input mode of the window.
The mode may be one of:
:CURSOR — Set the cursor state:
:cursor-normal — Show the cursor and unlock it.
:cursor-disabled — Hide the cursor and lock it into the window.
:cursor-hidden — Just make the cursor invisible.
:STICKY-KEYS — Whether a key’s press state should be retained
until KEY-STATE is called for that key.
:STICKY-MOUSE-BUTTONS
— Whether a button’s press state should be
retained until MOUSE-BUTTON-STATE is called
for that button.
:LOCK-KEY-MODS — This will enable tracking caps lock and num
lock for the modifier key sets.
:RAW-MOUSE-MOTION — Whether to supply the window with mouse motion
data that’s closer to the driver, unaffected
by desktop cursor smoothing and so on.
See WINDOW (type)
Callback for when a keyboard keys’s state has changed.
The ACTION may be one of:
:PRESS
:RELEASE
:REPEAT
The MODIFIERS is a list of active modifier keys at the time, which may
include:
:SHIFT
:CONTROL
:ALT
:SUPER
:CAPS-LOCK
:NUM-LOCK
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Returns the current state of the requested key.
May be one of:
:RELEASE
:PRESS
:REPEAT
See WINDOW (type)
Accesess the window’s location on screen.
This is a list of (X Y).
See WINDOW (type)
Makes the context current in the calling thread.
See WINDOW (type)
Request to maximize the window.
See RESTORE
See WINDOW (type)
Accesses whether the window is maximized.
See MAXIMIZE
See RESTORE
See STATE
See WINDOW (type)
Returns the error message that was returned.
See GLFW-ERROR
glfw-error)) ¶Access the current monitor the window resides on.
When a monitor is set, the monitor’s current video mode is retained
and the window is instead fullscreened to that monitor’s
resolution. If you need to set the video mode of the monitor as well,
you must supply a list as the value fitting this lambda-list:
(MONITOR &key WIDTH HEIGHT X Y REFRESH-RATE)
WIDTH, HEIGHT, and REFRESH-RATE default to the values of the monitor’s
current video mode. X and Y default to 0.
MONITOR may also be T in which case the primary monitor is used.
See MONITOR (type)
See WINDOW (type)
Callback for when a mouse button’s state has changed.
The ACTION may be one of:
:PRESS
:RELEASE
The MODIFIERS is a list of active modifier keys at the time, which may
include:
:SHIFT
:CONTROL
:ALT
:SUPER
:CAPS-LOCK
:NUM-LOCK
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Returns the current state of the requested mouse button.
May be one of:
:RELEASE
:PRESS
See WINDOW (type)
Callback for when the cursor has entered or left the window.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the mouse cursor has been moved.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the mouse wheel has scrolled.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Returns a human-readable description of the monitor.
See MONITOR (type)
standard-cursor)) ¶automatically generated reader method
name.
Accesses the window’s opacity factor.
This should be a float in the range [0,1].
See WINDOW (type)
Returns the operation that failed to execute.
See GLFW-ERROR
glfw-error)) ¶Returns the physical size of the monitor in mm.
This is a LIST of (W H).
See MONITOR (type)
Accesses the pointer that ties the object to the foreign resource.
This may be NIL if the object has been destroyed.
See DESTROY
See FOREIGN-OBJECT (type)
foreign-object)) ¶automatically generated reader method
foreign-object)) ¶automatically generated writer method
Resize a block of memory.
This callback is only used if the window is initialised as an
allocator.
Should return pointer to the allocated block if successful, or a null
pointer if not.
See WINDOW (type)
Returns the current refresh rate of the monitor.
See VIDEO-MODE
See MONITOR (type)
This function is used to register all of the GLFW callback functions.
If for some reason you need to override a callback, you should define
a method on this function to do so.
See WINDOW (type)
Request attention for the window.
See WINDOW (type)
Request to restore the window.
See ICONIFY
See MAXIMIZE
See WINDOW (type)
Accesses whether the window should be closed and destroyed.
This flag by itself does nothing. You should read it out in your event
loop and depending on it and possibly other factors, decide to close
and DESTROY the window, or do whatever else is considered appropriate
at the time.
See DESTROY
See WINDOW (type)
Request to make the window visible.
See HIDE
See WINDOW (type)
Accesses the window or monitor’s size on screen.
This is a list of (W H).
See WIDTH
See HEIGHT
See MONITOR (type)
See WINDOW (type)
Accesses the size limits of the window.
This should be a list of four elements:
MIN-WIDTH
MIN-HEIGHT
MAX-WIDTH
MAX-HEIGHT
If any element is NIL, it is considered to have no limit.
See WINDOW (type)
Accesses the current state of the window.
The state may be one of the following:
:ICONIFIED
:HIDDEN
:MAXIMIZED
:FULLSCREEN
:NORMAL
See ICONIFIED-P
See MAXIMIZED-P
See VISIBLE-P
See MONITOR
See WINDOW (type)
Swaps the back buffers to make the drawn content visible.
See WINDOW (type)
Accesses the swap synchronisation interval.
A value of 1 is typically called "vsync".
May be negative on some drivers, which allows "adaptive vsync".
See WINDOW (type)
Accesses the window title.
See WINDOW (type)
Returns the current video-mode of the monitor.
See VIDEO-MODES
See MONITOR (type)
Returns a list of available video modes for the monitor.
Each video mode is a list list with the following elements:
WIDTH — The width in pixels
HEIGHT — The height in pixels
REFRESH-RATE — The refresh rate in Hertz
RED-BITS — The bit-depth of the red channel (usually 8)
GREEN-BITS — The bit-depth of the green channel (usually 8)
BLUE-BITS — The bit-depth of the blue channel (usually 8)
See MONITOR (type)
Accesses whether the window is visible.
Note that an iconified window may also be treated as invisible.
See SHOW
See HIDE
See STATE
See WINDOW (type)
Accesses the width of the window or monitor in pixels.
See SIZE
See MONITOR (type)
See WINDOW (type)
Callback for when the user requested the window to close.
Users may implement a primary method on this function to react to the event. The default primary method sets the SHOULD-CLOSE-P flag to T.
See SHOULD-CLOSE-P
See WINDOW (type)
Callback for when the window’s DPI scaling factor has changed.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the window has changed focus.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the window has changed iconified status.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the window has changed maximized status.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the window has been moved.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the system has requested the window contents be refreshed.
Users may implement a primary method on this function to react to the
event.
See WINDOW (type)
Callback for when the window has been resized.
Users may implement a primary method on this function to react to the
event.
See FRAMEBUFFER-RESIZED
See WINDOW (type)
Returns the work area of the monitor.
This is a LIST of (X Y W H).
See MONITOR (type)
window) &rest args &key initialize-context &allow-other-keys) ¶standard-cursor) &key) ¶foreign-object) stream) ¶standard-cursor) stream) ¶Error signalled when GLFW fails to execute an operation.
See OPERATION
See CODE
See MESSAGE
error.
(quote nil)
:operation
This slot is read-only.
Representation of a cursor.
When constructing a pointer, you should pass PIXELS, WIDTH, HEIGHT,
and optionally XHOT and YHOT. WIDTH and HEIGHT should be the size of
the image in PIXELS, and PIXELS should be a
(simple-array (unsigned-byte 8) (*)) with the size (* width height 4)
this is the RGBA encoded pixel data of the cursor, top-left aligned.
See FOREIGN-OBJECT (type)
See CURSOR
Base class for all objects wrapping a foreign GLFW object.
Usually a foreign-object can be allocated simply by calling MAKE-INSTANCE, which will construct the GLFW object as well.
See POINTER
See DESTROY
:pointer
Representation of a display monitor.
You should not directly create instances of this class. Instead use LIST-MONITORS, PRIMARY-MONITOR, and MONITOR to access existing ones.
See FOREIGN-OBJECT (type)
See VIDEO-MODES
See LIST-MONITORS
See PRIMARY-MONITOR
See LOCATION
See WORK-AREA
See PHYSICAL-SIZE
See CONTENT-SCALE
See NAME
See VIDEO-MODE
See SIZE
See WIDTH
See HEIGHT
See REFRESH-RATE
See GAMMA
See GAMMA-RAMP
See MONITOR
This slot is read-only.
Representation of a window and its context.
The properties of the window and the context are configured via
initargs:
:RESIZABLE — Whether the user can resize the window
:VISIBLE — Whether the window starts visible
:DECORATED — Whether the window has borders
:FOCUSED — Whether the window starts focused
:AUTO-ICONIFY — Whether the window should iconify on focus
loss
:FLOATING — Whether the window should be "always on top"
:MAXIMIZED — Whether the window starts maximized
:CENTER-CURSOR — Whether to center the mouse cursor
:TRANSPARENT-FRAMEBUFFER
— Whether the framebuffer is transparent
:FOCUS-ON-SHOW — Whether to request focus when the window is
made visible
:SCALE-TO-MONITOR — Whether to resize the window area based on
DPI scaling factors of the monitor
:MOUSE-PASSTHROUGH —
:RED-BITS :GREEN-BITS :BLUE-BITS :ALPHA-BITS :DEPTH-BITS :STENCIL-BITS
— The bit depth of the back buffer
:ACCUM-RED-BITS :ACCUM-GREEN-BITS :ACCUM-BLUE-BITS :ACCUM-ALPHA-BITS
— The bit depth of the accumulation buffer
:AUX-BUFFERS — The desired number of auxiliary buffers
:STEREO — Whether to enable stereo rendering
:SAMPLES — The MSAA value to use for the back buffer
:SRGB-CAPABLE — Whether the back buffer is srgb scaled
:DOUBLEBUFFER — Whether to double-buffer the back buffer
:REFRESH-RATE — The intended refresh rate to use
:CLIENT-API — Which OpenGL API to use. May be one of:
:no-api
:opengl-api
:opengl-es-api
:CONTEXT-CREATION-API
— Which API to use to create the context:
:native-context-api
:egl-context-api
:osmesa-context-api
:CONTEXT-VERSION-MAJOR :CONTEXT-VERSION-MINOR
— The version of the context to request
:OPENGL-FORWARD-COMPAT
— Whether the context should be
forward-compatible.
:CONTEXT-DEBUG — Whether to enable context debugging info
:OPENGL-PROFILE — The profile of the context to request:
:opengl-any-profile
:opengl-core-profile
:opengl-compat-profile
:CONTEXT-ROBUSTNESS— The robustness strategy of the context:
:no-robustness
:no-reset-notification
:lose-context-on-reset
:CONTEXT-RELEASE-BEHAVIOR
— The release behaviour of the context:
:any-release-behavior
:release-behavior-flush
:release-behavior-none
:CONTEXT-NO-ERROR — Whether to generate errors on failures
:COCOA-RETINA-FRAMEBUFFER
— Whether to use full-resolution framebuffers
on retina displays
:COCOA-FRAME-NAME — The frame name to use for Cocoa
:COCOA-GRAPHICS-SWITCHING
— Whether to allow Cocoa to move the context
between different GPUs.
:X11-CLASS-NAME — The window class name to use for X11
:X11-INSTANCE-NAME — The window instance name to use for X11
:WAYLAND-APP-ID — The App ID to pass to Wayland
You can find more information on the available initialisation flags
and their effects can be found in the GLFW documentation:
https://www.glfw.org/docs/latest/window_guide.html#window_hints
In addition to the window hints described, the following initargs may
be passed:
:WIDTH — The initial width of the window. Defaults to 800
:HEIGHT — The initial height of the window. Defaults to 600
:TITLE — The title of the window. Defaults to "GLFW"
:MONITOR — The monitor on which to full-screen the window
:SHARE — The context to share with
If you pass the initarg :INITIALIZE-CONTEXT NIL, then the window is
not initialized, and instead a dead window object is created. You must
then later call REINITIALIZE-INSTANCE with :INITIALIZE-CONTEXT T
before the window can be used.
In order to react to events sent to the window, you should create a
subclass and implement methods on the following functions. By default
the corresponding events are simply discarded.
WINDOW-RESIZED — When the window size has been changed
WINDOW-CLOSED — When a close is requested
WINDOW-MOVED — When the window was moved
WINDOW-REFRESHED — When a refresh of the window is requested
WINDOW-FOCUSED — When the window changes focus
WINDOW-ICONIFIED — When the window’s icon status changes
WINDOW-MAXIMIZED — When the window’s maximization status changes
FRAMEBUFFER-RESIZED
— When the back framebuffer’s size changed
WINDOW-CONTENT-SCALE-CHANGED
— When the window’s DPI scaling factors changed
MOUSE-BUTTON-CHANGED
— When a mouse button’s active state changed
MOUSE-MOVED — When the mouse has been moved
MOUSE-ENTERED — When the mouse has entered or left the window
MOUSE-SCROLLED — When the mouse scrolled
KEY-CHANGED — When a keyboard key’s active state changed
CHAR-ENTERED — When a text entry is made
FILE-DROPPED — When one or more files are dropped onto the
window
See FOREIGN-OBJECT (type)
See REGISTER-CALLBACKS
See ALLOCATE
See REALLOCATE
See DEALLOCATE
See WINDOW-RESIZED
See WINDOW-CLOSED
See WINDOW-MOVED
See WINDOW-REFRESHED
See WINDOW-FOCUSED
See WINDOW-ICONIFIED
See WINDOW-MAXIMIZED
See FRAMEBUFFER-RESIZED
See WINDOW-CONTENT-SCALE-CHANGED
See MOUSE-BUTTON-CHANGED
See MOUSE-MOVED
See MOUSE-ENTERED
See MOUSE-SCROLLED
See KEY-CHANGED
See CHAR-ENTERED
See FILE-DROPPED
See SHOULD-CLOSE-P
See TITLE
See LOCATION
See SIZE
See WIDTH
See HEIGHT
See SIZE-LIMITS
See ASPECT-RATIO
See FRAMEBUFFER-SIZE
See FRAME-SIZE
See CONTENT-SCALE
See OPACITY
See ICONIFIED-P
See MAXIMIZED-P
See VISIBLE-P
See STATE
See ICONIFY
See RESTORE
See MAXIMIZE
See SHOW
See HIDE
See FOCUS
See REQUEST-ATTENTION
See MONITOR
See ATTRIBUTE
See INPUT-MODE
See KEY-STATE
See MOUSE-BUTTON-STATE
See CURSOR-LOCATION
See CLIPBOARD-STRING
See MAKE-CURRENT
See GET-CURRENT
See SWAP-BUFFERS
See SWAP-INTERVAL
See CURSOR
allocate.
(setf aspect-ratio).
(setf aspect-ratio).
(setf aspect-ratio).
aspect-ratio.
(setf attribute).
attribute.
center.
char-entered.
(setf clipboard-string).
clipboard-string.
content-scale.
(setf cursor).
(setf cursor).
cursor.
(setf cursor-location).
cursor-location.
(setf cursor-table).
cursor-table.
deallocate.
debug-log.
destroy.
file-dropped.
focus.
frame-size.
framebuffer-resized.
framebuffer-size.
(setf height).
height.
hide.
(setf icon).
(setf icon).
icon.
(setf iconified-p).
iconified-p.
iconify.
initialize-instance.
(setf input-mode).
input-mode.
key-changed.
key-state.
(setf location).
location.
make-current.
maximize.
(setf maximized-p).
maximized-p.
(setf monitor).
(setf monitor).
(setf monitor).
(setf monitor).
monitor.
mouse-button-changed.
mouse-button-state.
mouse-entered.
mouse-moved.
mouse-scrolled.
(setf opacity).
opacity.
print-object.
reallocate.
register-callbacks.
request-attention.
restore.
shared-initialize.
(setf should-close-p).
should-close-p.
show.
(setf size).
size.
(setf size-limits).
(setf size-limits).
size-limits.
(setf state).
state.
swap-buffers.
(setf swap-interval).
(setf swap-interval).
swap-interval.
(setf title).
(setf title).
title.
(setf visible-p).
visible-p.
(setf width).
width.
window-closed.
window-content-scale-changed.
window-focused.
window-iconified.
window-maximized.
window-moved.
window-refreshed.
window-resized.
window-resized.
(list -1 -1 -1 -1)
0
"glfw"
:title
(make-hash-table :test (quote eql))
foreign-struct-type.
translatable-foreign-type.
foreign-struct-type.
translatable-foreign-type.
foreign-struct-type.
translatable-foreign-type.
foreign-struct-type.
translatable-foreign-type.
foreign-struct-type.
translatable-foreign-type.
| Jump to: | (
A C D E F G H I J K L M N O P R S T U V W |
|---|
| Jump to: | (
A C D E F G H I J K L M N O P R S T U V W |
|---|
| Jump to: | *
A C H I M N O P S T V W |
|---|
| Jump to: | *
A C H I M N O P S T V W |
|---|
| Jump to: | A C D F G I L M O P S V W |
|---|
| Jump to: | A C D F G I L M O P S V W |
|---|