Convert an array from complex coordinates to vector cooridinates

Returns an array with the shape of the orignal, and and an additional 2-long trailing axis. The first component is the X, and the second is the Y. The imaginary part of a complex number corresponds to X and the real part to Y. °Coords takes vector coordinates and gives the complex equivalent.

Check if two rectangles collide ? Size₁ Position₁ Size₂ Position₂

Check if two circles collide ? Radius₁ Center₁ Radius₂ Center₂

Check if a point is inside a circle

Check if a point is inside a rectangle

Check if a rectangle and a circle collide

A color with an opacity of zero

Convert a color from 8-bit rgb to Uiua colors

Uiua color channels are represented by values 0-1, while standard graphics uses integers from 0-255. Colors are rounded to four decimal places so that they display nicely (this will not affect their 8-bit value.) °Rgb converts a Uiua color back to an 8-bit color. Both Rgb and °Rgb clamp the values to be within the correct ranges.

Convert a hexadecimal string into a color

Expects a string in the form #RRGGBB where all the letters are hexadecimal digits corresponding to color channels. The leading # can be omitted, and and alpha channel can also be specified at the end. This function is pervasive, and will convert an array of strings, or an array of box strings into an array of colors. The output will always be non-box, so if a single string has an alpha channel, all of the output will. °Hex converts a color back into a hexidecimal string, always including the #.

Get the alpha channel (transparency) of an image

If Alpha is called on an image without an alpha channel, a fully opaque one will be added. ⍜Alpha edits the alpha channel, and °⊸Alpha can be used to set it. For either inverse if a scalar is provided the entire alpha channel will be set to it. 0 is fully transparent and 1 is fully opaque.

Check if the window is fullscreen

Full returns a boolean to tell if the window is in fullscreen mode. °Full can be passed a boolean to set the state of fullscreen mode. A common pattern to toggle fullscreen is ⍜Full¬.

The size of the window

The dimensions returned are in pixels. °Size sets the size of the window. If the window is in fullscreen mode when °Size is called, fullscreen mode with be turned off. Neither dimension of the window can be zero. If a single number is given as the dimensions, it will be used as both the width and the height.

Get the size of the window when it is fullscreen

The active FPS (framerate)

FPS returns the actual framerate, which varies based on how long your device takes to run a frame. °FPS sets the maximum FPS. By default, the FPS is unbounded, and frames will be run as fast as possible. FPS can take ∞ to have the fastest possible framerate (the default behavior.)

Unload a sound, freeing it's memory

Unload a texture, freeing it's memory

Once a texture is unloaded, attempting to draw it will result in an all-black texture. Calling this function multiple times on a texture will not doing anything.

Get the dimensions of a texture

Load a texture from a filepath

The file must contain an image, and have the proper extension for the image format. The color format of a texture created this way is always color with an alpha channel. ⍜LoadFile will load the texture, and then free the memory when the function is over. [NOTE] You cannot load a texture before Open is called, it will cause a segfault.

Get the image in a texture without unloading the texture

Image remembers the color format of the image you made the texture with. If you provided a grayscale, you will get back a grayscale. °⊸Image edits the image in a texture. It takes the new image as the first argument and the texture as the second argument. ⍜Image gets the image, allows you to change it, and then puts the new image back in the texture. If any of the properties of the image are altered, like the shape or the color format, this function will error.

Load a texture from a Uiua image array

The provided image can be in any color format a Uiua image can be in, except for complex domain coloring. The formats are defined in the Uiua tutorial. The format you use to create the texture is the only one that may be used by the texture. Calling Image will result in an image of the same format. [NOTE] You cannot load a texture before Open is called, it will cause a segfault.

Draw a texture on the window

Color tints a texture a particular color. Angle is given in rotations [0,1], clockwise. Optional args: Color Angle Centered

This function is DEPRECATED use Draw~Background instead

Draw a texture covering the whole window.

The texture will be stretched/scaled to properly fit the size of the window. DrawScreen also supports a Color arg, like Draw Optional args: Color

Fill the whole window with a color or texture

When given a color, Background covers the whole window with that color. When given a texture Background scales the texture to fit over the whole window.

Draw a line on the window

A line will draw from point A to point B, even if either are outside the window. A thickness of zero will cause the line not to draw at all.

Draw a circle on the window

An angle and a starting position can be supplied to draw a sector of the circle. Angle can have the range [-1,1] where positive is clockwise. Start can have the range [0,1] where 0 is upward also moving clockwise. Optional args: Angle Start

Print text to the window

Font is a filepath pointing to a font file. If not specified, the Raylib font is used. Spacing changes how far apart characters are placed from eachother. By default it is 10% of the fontsize. Centered centers the text both horizontally and vertically. Optional args: Font Spacing Centered

Draw a rectangle on the window

Optional args: Centered

TODO: Change back once pervasion is fixed

Draw a square on the window

Exactly like Rect, except that the size is a scalar instead of a vector Optional args: Centered

Check if a key was pressed once

Check if a key is down

Call a function when a key is pressed

The first function is the key to run the function on (or identity to take from the stack) The second function will be called when the key is pressed

Call a function when a key is down

The first function is the key to run the function on (or identity to take from the stack) The second function will be called when the key is down

Get the characters that the user has typed

This function returns a string of queued characters If the user has not typed since the function was called, the string will be empty

Get the key codes that the user has typed

This function returns an array of queued key codes If the user has not typed since the function was called, the array will be empty

Emulate a text input on a string

This function edits a string based on the user's keyboard inputs Typing alphanumerics will append to the string, as well as non-printing characters like newline, space, and tab The string will also respect backspace and the Delete key to clear the string

Get an arrow key for a specific direction ^: Up, v: Down, <: Left, >: Right

Get a particular function key

Returns array of direction constants for WASD keys pressed Takes a boolean to choose between keypress and keydown

Returns array of direction constants for arrow keys pressed Takes a boolean to choose between keypress and keydown

Check if a mouse button was pressed once

Check if a mouse button is down

The current position of the mouse

How many pixels the mouse has moved since the last frame

Hide the mouse from the user

°Hide will make the mouse reappear. The user can still use the mouse while it it hidden. The affect is purely visual.

The direction the mouse is scrolling

Returns 0 if the mouse has not scrolled, and 1 or ¯1 depending on the direction scrolled. The sign may not nicely correspond to 'up' or 'down' since the direction of scrolling depends on the user's device.

Call a function on the scroll direction when the wheel is scrolled

The function will be called on a value of either 1 or ¯1, but never 0

Call a function when the user drags the mouse

The first function is the mouse button that must be down while dragging. If it is monadic it will pull from the stack. The second function is called when a drag occurs and is supplied the distance dragged. If the mouse does not move, this will not trigger, thus the distance cannot be zero.

Call a function on the mouse position when a button is pressed

The first function is the button to run the function on (or identity to take from the stack) The second function will be called with the mouse position as its first argument

Call a function on the mouse position when a button is down

The first function is the button to run the function on (or identity to take from the stack) The second function will be called with the mouse position as its first argument

Check if the mouse is on the window