This document contains a list of functions and constants related to audio, events, input handling, and rendering from the SDL library. It includes functions for loading and playing audio, getting input from devices like mice, keyboards and controllers, and handling common event types. The list is organized by category such as audio, events, input handling and rendering.

1. Ring Documentation, Release 1.9
• ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(ALLEGRO_AUDIO_STREAM
*stream)
• void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
• bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
• unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)
• ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(const ALLEGRO_AUDIO_STREAM
*stream)
• ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(const ALLEGRO_AUDIO_STREAM *stream)
• unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)
• float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)
• float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)
• float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)
• bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)
• ALLEGRO_PLAYMODE al_get_audio_stream_playmode(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,ALLEGRO_PLAYMODE val)
• bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
• void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)
• unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
• unsigned int al_get_available_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
• bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)
• double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)
• double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)
• bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,double start, double end)
• ALLEGRO_SAMPLE *al_load_sample(const char *filename)
• ALLEGRO_SAMPLE al_load_sample_f(ALLEGRO_FILE fp, const char *ident)
• ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,size_t buffer_count, unsigned int
samples)
• ALLEGRO_AUDIO_STREAM al_load_audio_stream_f(ALLEGRO_FILE fp, const char *ident,size_t
buffer_count, unsigned int samples)
• bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)
• bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)
1239

2. Ring Documentation, Release 1.9
• bool al_init_acodec_addon(void)
• uint32_t al_get_allegro_acodec_version(void)
• ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)
• void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow,float key, float *red, float *green, float *blue)
• ALLEGRO_COLOR al_color_hsl(float h, float s, float l)
• void al_color_hsl_to_rgb(float hue, float saturation, float lightness,float *red, float *green, float *blue)
• ALLEGRO_COLOR al_color_hsv(float h, float s, float v)
• void al_color_hsv_to_rgb(float hue, float saturation, float value,float *red, float *green, float *blue)
• ALLEGRO_COLOR al_color_html(char const *string)
• void al_color_html_to_rgb(char const *string,float *red, float *green, float *blue)
• void al_color_rgb_to_html(float red, float green, float blue,char *string)
• ALLEGRO_COLOR al_color_name(char const *name)
• bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)
• void al_color_rgb_to_cmyk(float red, float green, float blue,float *cyan, float *magenta, float *yellow, float
*key)
• void al_color_rgb_to_hsl(float red, float green, float blue,float *hue, float *saturation, float *lightness)
• void al_color_rgb_to_hsv(float red, float green, float blue,float *hue, float *saturation, float *value)
• char const *al_color_rgb_to_name(float r, float g, float b)
• void al_color_rgb_to_yuv(float red, float green, float blue,float *y, float *u, float *v)
• ALLEGRO_COLOR al_color_yuv(float y, float u, float v)
• void al_color_yuv_to_rgb(float y, float u, float v,float *red, float *green, float *blue)
• uint32_t al_get_allegro_color_version(void)
• void al_init_font_addon(void)
• void al_shutdown_font_addon(void)
• ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags)
• void al_destroy_font(ALLEGRO_FONT *f)
• int al_get_font_ascent(const ALLEGRO_FONT *f)
• int al_get_font_descent(const ALLEGRO_FONT *f)
• int al_get_text_width(const ALLEGRO_FONT *f, const char *str)
• int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr)
• void al_draw_text(const ALLEGRO_FONT *font,ALLEGRO_COLOR color, float x, float y, int flags,char const
*text)
• void al_draw_ustr(const ALLEGRO_FONT *font,ALLEGRO_COLOR color, float x, float y, int flags,const
ALLEGRO_USTR *ustr)
• void al_draw_justified_text(const ALLEGRO_FONT *font,ALLEGRO_COLOR color, float x1, float x2,float
y, float diff, int flags, const char *text)
• void al_draw_justified_ustr(const ALLEGRO_FONT *font,ALLEGRO_COLOR color, float x1, float x2,float
y, float diff, int flags, const ALLEGRO_USTR *ustr)
1240

3. Ring Documentation, Release 1.9
• void al_get_text_dimensions(const ALLEGRO_FONT *f,char const *text,int *bbx, int *bby, int *bbw, int *bbh)
• void al_get_ustr_dimensions(const ALLEGRO_FONT *f,ALLEGRO_USTR const *ustr,int *bbx, int *bby, int
*bbw, int *bbh)
• uint32_t al_get_allegro_font_version(void)
• ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp,int ranges_n, const int ranges[])
• ALLEGRO_FONT *al_load_bitmap_font(const char *fname)
• ALLEGRO_FONT *al_create_builtin_font(void)
• bool al_init_ttf_addon(void)
• void al_shutdown_ttf_addon(void)
• ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)
• ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file,char const *filename, int size, int flags)
• ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h,int flags)
• ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file,char const *filename, int w, int h, int
flags)
• uint32_t al_get_allegro_ttf_version(void)
• bool al_init_image_addon(void)
• void al_shutdown_image_addon(void)
• uint32_t al_get_allegro_image_version(void)
• ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode)
• uint32_t al_get_allegro_memfile_version(void)
• bool al_init_native_dialog_addon(void)
• void al_shutdown_native_dialog_addon(void)
• ALLEGRO_FILECHOOSER *al_create_native_file_dialog(char const *initial_path,char const *title,char const
*patterns,int mode)
• bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display,ALLEGRO_FILECHOOSER *dialog)
• int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog)
• const char *al_get_native_file_dialog_path(const ALLEGRO_FILECHOOSER *dialog, size_t i)
• void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog)
• int al_show_native_message_box(ALLEGRO_DISPLAY *display,char const *title, char const *heading, char
const *text,char const *buttons, int flags)
• ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags)
• void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog)
• uint32_t al_get_allegro_native_dialog_version(void)
• void al_set_physfs_file_interface(void)
• uint32_t al_get_allegro_physfs_version(void)
• uint32_t al_get_allegro_primitives_version(void)
• bool al_init_primitives_addon(void)
1241

4. Ring Documentation, Release 1.9
• void al_shutdown_primitives_addon(void)
• void al_draw_line(float x1, float y1, float x2, float y2,ALLEGRO_COLOR color, float thickness)
• void al_draw_triangle(float x1, float y1, float x2, float y2,float x3, float y3, ALLEGRO_COLOR color, float
thickness)
• void al_draw_filled_triangle(float x1, float y1, float x2, float y2,float x3, float y3, ALLEGRO_COLOR color)
• void al_draw_rectangle(float x1, float y1, float x2, float y2,ALLEGRO_COLOR color, float thickness)
• void al_draw_filled_rectangle(float x1, float y1, float x2, float y2,ALLEGRO_COLOR color)
• void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2,float rx, float ry, ALLEGRO_COLOR color,
float thickness)
• void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2,float rx, float ry, ALLEGRO_COLOR
color)
• void al_calculate_arc(float* dest, int stride, float cx, float cy,float rx, float ry, float start_theta, float delta_theta,
float thickness,int num_points)
• void al_draw_pieslice(float cx, float cy, float r, float start_theta,float delta_theta, ALLEGRO_COLOR color,
float thickness)
• void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta,float delta_theta, ALLEGRO_COLOR
color)
• void al_draw_ellipse(float cx, float cy, float rx, float ry,ALLEGRO_COLOR color, float thickness)
• void al_draw_filled_ellipse(float cx, float cy, float rx, float ry,ALLEGRO_COLOR color)
• void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color,float thickness)
• void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color)
• void al_draw_arc(float cx, float cy, float r, float start_theta,float delta_theta, ALLEGRO_COLOR color, float
thickness)
• void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float start_theta,float delta_theta, ALLE-
GRO_COLOR color, float thickness)
• void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR color,float thickness, int
num_segments)
• int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl,ALLEGRO_BITMAP* texture,
int start, int end, int type)
• int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl,ALLEGRO_BITMAP*
texture, const int* indices, int num_vtx, int type)
• ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int
stride)
• void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl)
1242

5. CHAPTER
NINETYFIVE
RINGLIBSDL FUNCTIONS REFERENCE
• MIX_DEFAULT_FORMAT
• SDL_QUIT
• SDL_BUTTON_LEFT
• SDL_BUTTON_MIDDLE
• SDL_BUTTON_RIGHT
• SDL_PRESSED
• SDL_RELEASED
• SDL_APP_TERMINATING
• SDL_APP_LOWMEMORY
• SDL_APP_WILLENTERBACKGROUND
• SDL_APP_DIDENTERBACKGROUND
• SDL_APP_WILLENTERFOREGROUND
• SDL_APP_DIDENTERFOREGROUND
• SDL_WINDOWEVENT
• SDL_SYSWMEVENT
• SDL_KEYDOWN
• SDL_KEYUP
• SDL_TEXTEDITING
• SDL_TEXTINPUT
• SDL_MOUSEMOTION
• SDL_MOUSEBUTTONDOWN
• SDL_MOUSEBUTTONUP
• SDL_MOUSEWHEEL
• SDL_JOYAXISMOTION
• SDL_JOYBALLMOTION
• SDL_JOYHATMOTION
• SDL_JOYBUTTONDOWN
1243

6. Ring Documentation, Release 1.9
• SDL_JOYBUTTONUP
• SDL_JOYDEVICEADDED
• SDL_JOYDEVICEREMOVED
• SDL_CONTROLLERAXISMOTION
• SDL_CONTROLLERBUTTONDOWN
• SDL_CONTROLLERBUTTONUP
• SDL_CONTROLLERDEVICEADDED
• SDL_CONTROLLERDEVICEREMOVED
• SDL_CONTROLLERDEVICEREMAPPED
• SDL_FINGERDOWN
• SDL_FINGERUP
• SDL_FINGERMOTION
• SDL_DOLLARGESTURE
• SDL_DOLLARRECORD
• SDL_MULTIGESTURE
• SDL_CLIPBOARDUPDATE
• SDL_DROPFILE
• SDL_RENDER_TARGETS_RESET
• SDL_USEREVENT
• SDL_LASTEVENT
• SDL_NET_MAJOR_VERSION
• SDL_NET_MINOR_VERSION
• SDL_NET_PATCHLEVEL
• INADDR_ANY
• INADDR_NONE
• INADDR_BROADCAST
• SDLNET_MAX_UDPCHANNELS
• SDLNET_MAX_UDPADDRESSES
• SDLK_0
• SDLK_1
• SDLK_2
• SDLK_3
• SDLK_4
• SDLK_5
• SDLK_6
• SDLK_7
1244

7. Ring Documentation, Release 1.9
• SDLK_8
• SDLK_9
• SDLK_a
• SDLK_AC_BACK
• SDLK_AC_BOOKMARKS
• SDLK_AC_FORWARD
• SDLK_AC_HOME
• SDLK_AC_REFRESH
• SDLK_AC_SEARCH
• SDLK_AC_STOP
• SDLK_AGAIN
• SDLK_ALTERASE
• SDLK_QUOTE
• SDLK_APPLICATION
• SDLK_AUDIOMUTE
• SDLK_AUDIONEXT
• SDLK_AUDIOPLAY
• SDLK_AUDIOPREV
• SDLK_BRIGHTNESSDOWN
• SDLK_BRIGHTNESSUP
• SDLK_c
• SDLK_CALCULATOR
• SDLK_CANCEL
• SDLK_CAPSLOCK
• SDLK_CLEAR
• SDLK_CLEARAGAIN
• SDLK_COMMA
• SDLK_COMPUTER
• SDLK_COPY
• SDLK_CRSEL
• SDLK_CURRENCYSUBUNIT
• SDLK_CURRENCYUNIT
• SDLK_CUT
• SDLK_d
• SDLK_DECIMALSEPARATOR
• SDLK_DELETE
1245

8. Ring Documentation, Release 1.9
• SDLK_DISPLAYSWITCH
• SDLK_DOWN
• SDLK_e
• SDLK_EJECT
• SDLK_END
• SDLK_EQUALS
• SDLK_ESCAPE
• SDLK_EXECUTE
• SDLK_EXSEL
• SDLK_f
• SDLK_F1
• SDLK_F10
• SDLK_F11
• SDLK_F12
• SDLK_F13
• SDLK_F14
• SDLK_F15
• SDLK_F16
• SDLK_F17
• SDLK_F18
• SDLK_F19
• SDLK_F2
• SDLK_F20
• SDLK_F21
• SDLK_F22
• SDLK_F23
• SDLK_F24
• SDLK_F3
• SDLK_F4
• SDLK_F5
• SDLK_F6
• SDLK_F7
• SDLK_F8
• SDLK_F9
• SDLK_FIND
• SDLK_g
1246

9. Ring Documentation, Release 1.9
• SDLK_BACKQUOTE
• SDLK_h
• SDLK_HELP
• SDLK_HOME
• SDLK_i
• SDLK_INSERT
• SDLK_j
• SDLK_k
• SDLK_KBDILLUMDOWN
• SDLK_KBDILLUMTOGGLE
• SDLK_KBDILLUMUP
• SDLK_KP_0
• SDLK_KP_00
• SDLK_KP_000
• SDLK_KP_1
• SDLK_KP_2
• SDLK_KP_3
• SDLK_KP_4
• SDLK_KP_5
• SDLK_KP_6
• SDLK_KP_7
• SDLK_KP_8
• SDLK_KP_9
• SDLK_KP_A
• SDLK_KP_AMPERSAND
• SDLK_KP_AT
• SDLK_KP_B
• SDLK_KP_BACKSPACE
• SDLK_KP_BINARY
• SDLK_KP_C
• SDLK_KP_CLEAR
• SDLK_KP_CLEARENTRY
• SDLK_KP_COLON
• SDLK_KP_COMMA
• SDLK_KP_D
• SDLK_KP_DBLAMPERSAND
1247

10. Ring Documentation, Release 1.9
• SDLK_KP_DBLVERTICALBAR
• SDLK_KP_DECIMAL
• SDLK_KP_DIVIDE
• SDLK_KP_E
• SDLK_KP_ENTER
• SDLK_KP_EQUALS
• SDLK_KP_EQUALSAS400
• SDLK_KP_EXCLAM
• SDLK_KP_F
• SDLK_KP_GREATER
• SDLK_KP_HASH
• SDLK_KP_HEXADECIMAL
• SDLK_KP_LEFTBRACE
• SDLK_KP_LEFTPAREN
• SDLK_KP_LESS
• SDLK_KP_MEMADD
• SDLK_KP_MEMCLEAR
• SDLK_KP_MEMDIVIDE
• SDLK_KP_MEMMULTIPLY
• SDLK_KP_MEMRECALL
• SDLK_KP_MEMSTORE
• SDLK_KP_MEMSUBTRACT
• SDLK_KP_MINUS
• SDLK_KP_MULTIPLY
• SDLK_KP_OCTAL
• SDLK_KP_PERCENT
• SDLK_KP_PERIOD
• SDLK_KP_PLUS
• SDLK_KP_PLUSMINUS
• SDLK_KP_POWER
• SDLK_KP_RIGHTBRACE
• SDLK_KP_RIGHTPAREN
• SDLK_KP_SPACE
• SDLK_KP_TAB
• SDLK_KP_VERTICALBAR
• SDLK_KP_XOR
1248