You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Multiple texture formats supported, including compressed formats (DXT, ETC, ASTC).
Full 3D support, including 3D Shapes, Models, Billboards, Heightmaps and more!
Flexible Materials system, supporting classic maps and PBR maps.
Animated 3D models supported (skeletal bones animation) (IQM, M3D, glTF).
Shaders support, including model shaders and postprocessing shaders.
Powerful math module for Vector, Matrix and Quaternion operations: raymath.
Audio loading and playing with streaming support (WAV, QOA, OGG, MP3, FLAC, XM, MOD).
VR stereo rendering support with configurable HMD device parameters.
Warning
Breaking changes to any feature in raylib-apl should be expected for now, as this library is very young and experimental. If you experience code 999, there was likely a "segfault"/error in raylib-apl, and so a bug report would be appreciated.
Currently raylib-apl provides 4 different libraries; raylib, raygui, physac, and rlgl. Currently only raylib is stable, due to a lack of testing for the other 3.
Documentation
Getting started
Run the following to install temp-c-raylib in the raylib-apl/lib/ folder.
dyalogscript install-raylib.apls
Instead of running the above, you can manually download temp-c-raylib from it's releases page.
Importing raylib-apl
To import raylib-apl as a namespace, take the code below and replace ../ with the path to raylib-apl:
When making a script file like the raylib-apl's examples, I would recommend the .apls file extension and adding this line at the top of the script #!cd $dir && /usr/bin/dyalogscript $fileName. When running .apls files, remember to always be in their directory.
You may ]Link to the raylib-apl/link folder.
This imports raylib.apln, rlgl.apln, and raymath.apln, each of which are from raylib. A 2d physics library called physac is also included as physac.apln, and a GUI library called raygui as raygui.apln.
Example using raylib-apl with ]link is shown below:
Developing an application with raylib-apl is very low level. The entirety of raylib-apl is about 200 functions that take in a list of inputs and returns some outputs, and/or change the state of the application. An example of changing the state of the application is the following:
raylib.InitWindow400400'Title'
This function opens a new window, with width=400, height=400, and window title being "Title".
This changes the state of the computer screen of course, but it also changes something very important, it creates a kind of scope.
Inside this scope, you are allowed a lot more. You can use functions like SetWindowIcon, GetScreenWidth, GetMonitorCount, LoadShader, GetMouseRay, and many more.
Scopes in detail
There are other functions that start and end scopes, like StartDrawing and EndDrawing. StartDrawing and EndDrawing require the InitWindow scope. Inside the StartDrawing scope you can use functions like ClearBackground, which sets the background of the window to a given color. An important note about EndDrawing is that it automatically delays to whatever frame-rate you choose, which by default is your monitor refresh rate. As an example, if your monitor has a refresh rate of 60 frames per second, EndDrawing will delay a maximum of ÷60. I say "maximum", because EndDrawing delays just enough to keep your :while loop running 60 times a second, so if your loop takes ÷60 seconds to run, EndDrawing wouldn't delay.
First application
Applications made with raylib-apl have a common structure and style. As you can see by the below example, there's a :while loop used that draws the frame using BeginDrawing, where the frame being drawn is gray because of ClearBackground . This example is intentionally very simple, simply drawing a window with a black background.
To get a good start into raylib-apl, mess around with the examples and see what you can make!
For a proper list of functions and namespaces found in raylib-apl, consider having a look into what the raylib.apln file defines. Note that the function definitions there aren't final, so drop the RAYLIB suffix to use the proper function. An example is the value raylib.KeyboardKey.KEY_SLASH can be given as argument to raylib.IsKeyPressed to check if the slash key is pressed.
Using dyalogscript
All raylib-apl examples support using dyalogscript, by having the following on the top of every example: #!cd $dir && /usr/bin/dyalogscript $fileName
Optionally parsing raylib-apl/link/raylib.apln
The auto-parsing isn't needed since the parser output is premade, though if you still need to parse, install CBQN to run bqn raylib-apl/parse-raylib-apl/parseAll.bqn.
Credits
Dyalog Limited
raylib-apl has been financially supported by Dyalog Limited.
Brian was hired as an intern by Dyalog Limited at about 7th of July 2024 to develop raylib-apl, alongside Asher. Brian has continued being funded for the development.
The Dyalog team have helped a lot with the development of this library.
raylib
raylib-APL relies on the raylib C library. Lots of thanks to raysan5 and the raylib community for this great library.
Marshall Lochbaum
The current version of raylib-apl has parsing that relies on json.bqn made by Marshall Lochbaum.bqn. Also the BQN programming language in general!
txt←'raylib already installed. Delete it to re-install.',⎕UCS 10
31
+
txt,←'rm ',⍵,⎕UCS 10
32
+
txt Assert 0
33
+
} fullLibFile
34
+
35
+
⍝ ---------------
36
+
⍝ download raylib
37
+
⍝ ---------------
38
+
PlatformToInstallCmd ← {
39
+
'Windows'≡⍵:'Powershell.exe -Command "Invoke-WebRequest -Uri ''',git_clone_path,''' -OutFile ''',fullLibFile,'''"' ⍝ If errors: Curl was likely not found
0 commit comments