Download the PHP package php-io-extensions/glfw without Composer
On this page you can find all versions of the php package php-io-extensions/glfw. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package glfw
glfw
1:1 PHP bindings of GLFW 3.4 for staged windows: initialization and errors, monitors, video modes and gamma, windows with their hints, attributes and callbacks, events and time, OpenGL contexts, Vulkan surfaces, and native handles. Version 0.10.0. Linux and macOS.
Input is not bound: no keyboard, mouse, cursor, joystick or gamepad functions. Function and constant names are the C names. A handle is one PHP object per native pointer. Dropping the last PHP reference does not destroy the native object.
Requirements
- GLFW 3.4 or newer
- PHP 8.4, NTS or ZTS
- macOS:
brew install glfw - Debian trixie and Raspberry Pi OS:
apt install libglfw3-dev venusian buildreads the system packages fromextra.venusian.systemin composer.json: apt packages to build with and the run-time ones a.debdepends on or recommends, and the Homebrew ones.
No Vulkan, X11, Wayland, GLX or EGL headers are needed to build: the extension declares the few Vulkan types and native-access functions it uses with ABI-identical types.
Install
Through PIE:
From a checkout:
The macOS installer ad-hoc signs the .so and writes 30-glfw.ini, unless an ini in that PHP's scan directory already loads glfw. Pass other PHP binaries as arguments to install those instead.
Names
Bindings are the C API with these translations:
- An out-parameter is a by-reference parameter (
glfwGetWindowSize($window, $width, $height)). - A
GLFWwindow *orGLFWmonitor *is aGLFWwindoworGLFWmonitorhandle;NULLisnull. - A
const GLFWvidmode *GLFW returns is a copiedGLFWvidmode. A list GLFW returns with a count (glfwGetMonitors,glfwGetVideoModes,glfwGetRequiredInstanceExtensions) is a PHP list. GLFWgammarampholds three lists of 16-bit ints.GLFWimageholds RGBA8 pixels as a string of 4 × width × height bytes;glfwSetWindowIcontakes a list of them.- A function address, a Vulkan handle, or a native handle is an
int. - A callback is a PHP callable or
null, called directly from GLFW with the C arguments, aGLFWwindowfirst. - A C
intthat GLFW uses as a boolean in a return (glfwInit,glfwWindowShouldClose,glfwVulkanSupported) isbool. Hints and attributes stayint(GLFW_TRUE,GLFW_FALSE,GLFW_DONT_CARE).
Failure is glfwGetError() or the error callback, as in C. Constants are PHP constants under their C names, with the values of the GLFW header.
Windows for a game engine
An OpenGL window turns vsync off and on with glfwSwapInterval(0) and glfwSwapInterval(1) while its context is current.
Vulkan
Instances, physical devices and surfaces are their handle values as ints, so ext-vulkan's handles pass through pointer() and fromPointer():
GLFW finds the Vulkan loader on the dynamic linker's path. Homebrew's loader on macOS is not on it; hand GLFW its vkGetInstanceProcAddr before glfwInit() with glfwInitVulkanLoader($address).
Native handles
glfwGetCocoaWindow, glfwGetCocoaView, glfwGetCocoaMonitor and glfwGetNSGLContext on macOS; glfwGetX11*, glfwGetWayland*, glfwGetGLX* and glfwGetEGL* on Linux. Each answers an address or an id, for another extension to adopt (NSWindow::fromPointer(glfwGetCocoaWindow($window))).
Platform differences
GLFW's own, reported through glfwGetError():
- Wayland gives the window's position, opacity and icon, and the monitor's gamma, to the compositor: those calls fail with
GLFW_FEATURE_UNAVAILABLE. A client is never told it was iconified. A size the program sets is not called back; sizes the compositor sets are. The compositor picks the windowed size after full screen and draws the decorations, so the frame size reads as 0. - Wayland decorations come from libdecor's GTK 3 plugin by default. In a process that has also loaded GTK 4 (ext-gtk), GTK 3's type registration deadlocks in
glfwShowWindow; setglfwInitHint(GLFW_WAYLAND_LIBDECOR, GLFW_WAYLAND_DISABLE_LIBDECOR)beforeglfwInit()there. - macOS has no window icon (
GLFW_FEATURE_UNAVAILABLE), reports the current video mode in points and lists modes in pixels, and countsGLFW_POSITION_Yfrom the screen's bottom in GLFW 3.4.0. - Focus is granted by the window manager: macOS refuses activation while the user works in another app, and Wayland compositors give focus on user input.
Tests
On a Linux desktop session over SSH, export WAYLAND_DISPLAY, DISPLAY and XDG_RUNTIME_DIR first.
License
MIT
