[[tags: allegro game]] == allegro Allegro 5 bindings for Chicken. [[toc:]] == Disclaimer Due to personal time constraints I have not fully tested these bindings, yet. If you discover any bugs, or even if you believe that some bindings could have a better implementation then please contact me with details. == Help! I have limited time these days. If you could undertake any of the following it would be greatly appreciated: 1. Submit issues you discover to the GitHub issue tracker 2. Submit feature requests to the GitHub issue tracker 3. Correct any errors you discover in this documentation page 4. Add documentation where it is lacking 5. Send me an email if you find this egg useful! == Author Dan Leslie (dan@ironoxide.ca) == Naming Key In general, the naming is fairly indicative of the function's behaviour. The gist is something like this: ; make-type : Constructs a type (Not always available) ; make-type* : Constructs a type, returning a value which must be manually destructed ; free-type! : Manually destructs a type (Not available for internally managed types) ; type-noun : Accessor for value "noun" on a specific type ; type-noun-set! : Mutator for value "noun" on a specific type ; type-verb : Method which requires a specific type to operate ; type-verb! : Method which modifies an object of a specific type ; verbage : Function which operates on the global state ; verbage* : Function which operates on the global state, but also returns a value which must be manually destructed If a function begins with a type name then you can be assured that the first parameter will be an object of that specific type. == Records and Related Procedures === audio-stream audio-stream === bitmap bitmap === color color (make-color*) (make-color) (free-color! color) (color-red color) (color-green color) (color-blue color) (color-alpha color) === condition condition === config config === config-entry config-entry === config-section config-section === cursor cursor === display display === display-mode display-mode (make-display-mode*) (make-display-mode) (free-display-mode! display-mode) (display-mode-width display-mode) (display-mode-width-set! display-mode integer) (display-mode-height display-mode) (display-mode-height-set! display-mode integer) (display-mode-format display-mode) (display-mode-format-set! display-mode pixel-format) (display-mode-refresh-rate display-mode) (display-mode-refresh-rate-set! display-mode integer) === driver driver (free-driver!) (driver-id driver) (driver-ptr driver) (driver-autodetect driver) === event-source event-source === event-queue event-queue === file file === file-interface file-interface === font font (font-data font) (font-height font) === fs-entry fs-entry (fs-entry-vtable fs-entry) === fs-interface fs-interface (free-fs-interface! fs-interface) (fs-interface-create-entry fs-interface) (fs-interface-entry-name fs-interface) (fs-interface-update-entry fs-interface) (fs-interface-entry-mode fs-interface) (fs-interface-atime fs-interface) (fs-interface-mtime fs-interface) (fs-interface-ctime fs-interface) (fs-interface-entry-size fs-interface) (fs-interface-entry-exists? fs-interface) (fs-interface-remove-entry fs-interface) (fs-interface-open-directory fs-interface) (fs-interface-read-directory fs-interface) (fs-interface-close-directory fs-interface) (fs-interface-current-directory fs-interface) (fs-interface-make-directory fs-interface) (fs-interface-filename-exists? fs-interface) (fs-interface-remove-filename fs-interface) (fs-interface-open-file fs-interface) === joystick joystick === joystick-state joystick-state (make-joystick-state*) (make-joystick-state) (free-joystick-state! joystick-state) (joystick-state-button int) === keyboard keyboard === keyboard-state keyboard-state (make-keyboard-state*) (make-keyboard-state) (free-keyboard-state! keyboard-state) (keyboard-state-display) === locked-region locked-region (free-locked-region! locked-region) (locked-region-data locked-region) (locked-region-format locked-region) (locked-region-pitch locked-region) (locked-region-pixel-size locked-region) === memory-interface memory-interface (make-memory-interface*) (make-memory-interface) (free-memory-interface! memory-interface) (memory-interface-malloc memory-interface) (memory-interface-malloc-set! memory-interface (function c-pointer (integer32 integer (const c-string) (const c-string)))) (memory-interface-realloc memory-interface) (memory-interface-realloc-set! memory-interface (function void (c-pointer integer (const c-string) (const c-string)))) (memory-interface-calloc memory-interface) (memory-interface-calloc-set! memory-interface (function c-pointer (c-pointer integer32 integer (const c-string) (const c-string)))) (memory-interface-free memory-interface) (memory-interface-free-set! memory-interface (function c-pointer (integer32 integer32 integer (const c-string) (const c-string)))) === mixer mixer === monitor monitor (make-monitor*) (make-monitor) (free-monitor! monitor) (monitor-x1 monitor) (monitor-y1 monitor) (monitor-x2 monitor) (monitor-y2 monitor) === mouse mouse === mouse mouse-cursor === mouse-state mouse-state (make-mouse-state) (make-mouse-state*) (free-mouse-state! mouse-state) (mouse-state-x mouse-state) (mouse-state-y mouse-state) (mouse-state-z mouse-state) (mouse-state-w mouse-state) (mouse-state-buttons mouse-state) (mouse-state-pressure mouse-state) (mouse-state-axis mouse-state integer) (mouse-state-display mouse-state) === mutex mutex === path path === sample sample === sample-id sample-id === sample-instance sample-instance === state state (make-state*) (make-state) (free-state! state) === system system === thread thread === timer timer === timeout timeout (make-timeout*) (make-timeout) (free-timeout! timeout) === transform transform (make-transform*) (make-transform) (free-transform! transform) (transform-value transform i j) === utf-string utf-string === version version (version-major version) (version-sub version) (version-wip version) (version-release-number version) (version-string version) (version-date-string version) (version-date version) (version-int version) === vertex vertex (make-vertex*) (make-vertex) (free-vertex! vertex) (vertex-x vertex) (vertex-x-set! vertex float) (vertex-y vertex) (vertex-y-set! vertex float) (vertex-z vertex) (vertex-z-set! vertex float) (vertex-u vertex) (vertex-u-set! vertex float) (vertex-v vertex) (vertex-v-set! vertex float) === vertex-declaration vertex-declaration === vertex-element vertex-element (make-vertex-element*) (make-vertex-element) (free-vertex-element! vertex-element) (vertex-element-attribute vertex-element) (vertex-element-attribute-set! vertex-element primitive-attribute) (vertex-element-storage vertex-element) (vertex-element-storage-set! vertex-element primitive-storage) (vertex-element-offset vertex-element) (vertex-element-offset-set! vertex-element integer) === voice voice == Event Records === any-event any-event (any-event-type any-event) (any-event-source any-event) (any-event-timestamp any-event) === display-event display-event (display-event-type display-event) (display-event-source display-event) (display-event-timestamp display-event) (display-event-x display-event) (display-event-y display-event) (display-event-width display-event) (display-event-height display-event) (display-event-orientation display-event) === event event (make-event) (make-event*) (free-event! event) === joystick-event joystick-event (joystick-event-type joystick-event) (joystick-event-source joystick-event) (joystick-event-timestamp joystick-event) (joystick-event-id joystick-event) (joystick-event-stick joystick-event) (joystick-event-axis joystick-event) (joystick-event-position joystick-event) (joystick-event-button joystick-event) === keyboard-event keyboard-event (keyboard-event-type keyboard-event) (keyboard-event-source keyboard-event) (keyboard-event-timestamp keyboard-event) (keyboard-event-display keyboard-event) (keyboard-event-keycode keyboard-event) (keyboard-event-unichar keyboard-event) (keyboard-event-modifiers keyboard-event) (keyboard-event-repeat keyboard-event) === mouse-event mouse-event (mouse-event-type mouse-event) (mouse-event-source mouse-event) (mouse-event-timestamp mouse-event) (mouse-event-display mouse-event) (mouse-event-x mouse-event) (mouse-event-y mouse-event) (mouse-event-z mouse-event) (mouse-event-w mouse-event) (mouse-event-dx mouse-event) (mouse-event-dy mouse-event) (mouse-event-dz mouse-event) (mouse-event-dw mouse-event) (mouse-event-button mouse-event) (mouse-event-pressure mouse-event) === timer-event timer-event (timer-event-type timer-event) (timer-event-source timer-event) (timer-event-timestamp timer-event) (timer-event-count timer-event) (timer-event-error timer-event) === user-event user-event (user-event-type user-event) (user-event-source user-event) (user-event-timestamp user-event) (user-event-data1 user-event) (user-event-data1-set! user-event integer) (user-event-data2 user-event) (user-event-data2-set! user-event integer) (user-event-data3 user-event) (user-event-data3-set! user-event integer) (user-event-data4 user-event) (user-event-data4-set! user-event integer) == Enums === audio-depth (audio-depth->int audio-depth) (int->audio-depth integer) int8 int16 int24 float32 unsigned uint8 uint16 uint24 === display-flag (display-flag->int display-flag) (int->display-flag integer) windowed fullscreen opengl direct3d-internal resizable noframe generate-expose-events opengl3 opengl-forward-compatible fullscreen-window minimized === display-option (display-option->int display-option) (int->display-option integer) red-size green-size blue-size alpha-size red-shift green-shift blue-shift alpha-shift acc-red-size acc-green-size acc-blue-size acc-alpha-size stereo aux-buffers color-size depth-size stencil-size sample-buffers samples render-method float-color float-depth single-buffer swap-method compatible-display update-display-region vsync max-bitmap-size support-npot-bitmap can-draw-into-bitmap support-separate-alpha === display-option-importance (display-option-importance->int display-option-importance) (int->display-option-importance integer) dont-care require suggest === display-orientation (display-orientation->int display-orientation) (int->display-oprientation integer) degrees-0 degrees-90 degrees-180 degrees-270 face-up face-down === bitmap-flag (bitmap-flag->int bitmap-flag) (int->bitmap-flag integer) memory-bitmap keep-bitmap-format force-locking no-preserve-texture alpha-test min-linear mag-linear mipmap no-premultiplied-alpha video-bitmap === blend-operation (blend-operation->int blend-operation) (int->blend-operation integer) add source-minus-destination destination-minus-source === blending-mode (blending-mode->int blending-mode) (int->blending-mode integer) zero one alpha inverse-alpha === blitting-flag (blitting-flag->int blitting-flag) (int->blitting-flag integer) flip-horizontal flip-vertical === channel-configuration (channel-configuration->int channel-configuration) (int->channel-configuration integer) one two three four five-one six-one seven-one === cursor-type (cursor-type->int cursor-type) (int->cursor-type integer) none default arrow busy question edit move resize-north resize-west resize-south resize-east resize-northwest resize-southwest resize-southeast resize-northeast progress precision link alt-select unavailable === event-type (event-type->int event-type) (int->event-type integer) joystick-axis joystick-button-down joystick-button-up joystick-configuration key-down key-char key-up mouse-axes mouse-button-down mouse-button-up mouse-enter-display mouse-leave-display mouse-warped timer display-expose display-resize display-close display-lost display-found display-switch-in display-switch-out display-orientation audio-stream-fragment audio-stream-finished === font-align (font-align->int font-align) (int->font-align integer) left center right === file-mode (file-mode->int file-mode) (int->file-mode integer) read write execute hidden file directory === gl-variant (gl-variant->int gl-variant) (int->gl-variant integer) opengl opengl-es === joystick-flag (joystick-flag->int joystick-flag) (int->joystick-flag integer) digital analog === key (key->int key) (int->key integer) a b c d e f g h i j k l m n o p q r s t u v w x y z one two three four five six seven eight nine zero pad-one pad-two pad-three pad-four pad-five pad-six pad-seven pad-eight pad-nine pad-zerp f1 f2 f3 f4 f5 f6 f7 f9 f9 f10 f11 f12 escape tilde minus equals backspace tab openbrace enter semicolon quote backslash backslash2 comma fullstop slash space insert delete home end pgup pgdn left right up down pad-slash pad-asterisk pad-minus pad-plus pad-delete pad-enter printscreen pause abnt-c1 yen kana convert noconvert at circumflex colon2 kanji pad-equals backquote semicolon2 command unknown lshift rshift lctrl rctrl alt altgr lwin rwin menu scrolllock numlock capslock === keymod (keymod->int keymod) (int->keymod integer) shift ctrl alt lwin rwin menu altgr command scrolllock numlock capslock inaltseq accent1 accent2 accent3 accent4 === locking-flag (locking-flag->int locking-flag) (int->locking-flag integer) read-write read-only write-only === mixer-quality (mixer-quality->int mixer-quality) (int->mixer-quality integer) point linear === pixel-format (pixel-format->int pixel-format) (int->pixel-format integer) any any-no-alpha any-with-alpha any-15-no-alpha any-16-no-alpha any-16-with-alpha any-24-no-alpha any-32-no-alpha any-32-with-alpha argb-8888 rgba-8888 argb-4444 rgb-888 rgb-565 rgb555 rgba-5551 argb-1555 abgr-8888 xbgr-8888 bgr-888 bgr-565 bgr-555 rgbx-8888 xrgb-8888 abgr-f32 abgr-8888-le rgba-4444 === playmode (playmode->int playmode) (int->playmode integer) once loop bidirectional === primitive-attribute (primitive-attribute->int primitive-attribute) (int->primitive-attribute integer) position color texture-coordinate texture-pixel-coordinate === primitive-type (primitive-type->int primitive-type) (int->primitive-type integer) line-list line-strip line-loop triangle-list triangle-strip point-list === primitive-storage (primitive-storage->int primitive-storage) (int->primitive-storage integer) float-2 float-3 short-2 === seek-flag (seek-flag->int seek-flag) (int->seek-flag integer) set current end === state-flag (state-flag->int state-flag) (int->state-flag integer) new-display-parameters new-bitmap-parameters display target-bitmap blender new-file-interface transform bitmap all === system-path (system-path->int system-path) (int->system-path integer) resources-path temp-path user-data-path user-home-path user-settings-path user-documents-path exename-path last-path == Constants joystick-max-axes jostick-max-sticks joystick-max-buttons default-display-adapter eof mouse-max-extra-axis vertex-cache-size primitive-quality audio-pan-none build-version pi == Functions === Audio (make-sample* (blob buffer) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration (bool free-buffer)) Implements al_create_sample. (make-sample (blob buffer) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration (bool free-buffer)) Implements al_create_sample, with (free-sample!) declared as a finalizer. (free-sample! sample) Implements al_destroy_sample. (make-sample-instance* sample) Implements al_create_sample_instance. (make-sample-instance sample) Implements al_create_sample_instance, with (free-sample-instance!) declared as a finalizer. (free-sample-instance! sample) Implements al_destroy_sample_instance. (sample-frequency sample) Implements al_get_sample_frequenecy. (sample-length sample) Implements al_get_sample_length. (sample-depth sample) Implements al_get_sample_depth. (sample-channels sample) Implements al_get_sample_channels. (sample-instance-frequency sample-instance) Implements al_get_sample_instance_frequency. (sample-instance-length sample-instance) Implements al_get_sample_instance_length. (sample-instance-position sample-instance) Implements al_get_sample_instance-position. (sample-instance-speed sample-instance) Implements al_get_sample_instance_speed. (sample-instance-gain sample-instance) Implements al_get_sample_instance_gain. (sample-instance-pan sample-instance) Implements al_get_sample_instance_pan. (sample-instance-time sample-instance) Implements al_get_sample_instance_time. (sample-instance-depth sample-instance) Implements al_get_sample_instance_depth. (sample-instance-channels sample-instance) Implements al_get_sample_instance_channels. (sample-instance-playmode sample-instance) Implements al_get_sample_instance_playmode. (sample-instance-playing? sample-instance) Implements al_get_sample_instance_playing. (sample-instance-attached? sample-instance) Implements al_get_sample_instance_attached. (sample-instance-position-set! sample-instance unsigned-integer) Implements al_set_sample_instance_position. (sample-instance-length-set! sample-instance unsigned-integer) Implements al_set_sample_instance_length. (sample-instance-speed-set! sample-instance float) Implements al_set_sample_instance_speed. (sample-instance-gain-set! sample-instance float) Implements al_set_sample_instance_gain. (sample-instance-pan-set! sample-instance float) Implements al_set_sample_instance_pan. (sample-instance-playmode-set! sample-instance playmode) Implements al_set_sample_instance_playmode. (sample-instance-playing-set! sample-instance bool) Implements al_set_sample_instance_playing. (sample-instance-detach! sample-instance) Implements al_detach_sample_instance. (sample-instance-sample sample-instance) Implements al_get_sample. (sample-instance-sample-set! sample-instance sample) Implements al_set_sample (sample-instance-play sample-instance) Implements al_play_sample_instance. (sample-instance-stop sample-instance) Implements al_stop_sample_instance. (make-audio-stream* (integer buffer-count) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_audio_stream. (make-audio-stream (integer buffer-count) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_audio_stream, with (free-audio-stream!) declared as a finalizer. (free-audio-stream! audio-stream) Implements al_destroy_audio_stream. (audio-stram-drain audio-stream) Implements al_drain_audio_stream. (audio-stream-frequency audio-stream) Implements al_get_audio_stream_frequency. (audio-stream-length audio-stream) Implements al_get_audio_stream_length. (audio-stream-fragments audio-stream) Implements al_get_available_audio_stream_fragments. (audio-stream-available-fragments audio-stream) Implements al_get_available_audio_stream_fragments. (audio-stream-speed audio-stream) Implements al_get_audio_stream_speed. (audio-stream-gain audio-stream) Implements al_get_audio_stream_gain. (audio-stream-channels audio-stream) Implements al_get_audio_stream_channels. (audio-stream-depth audio-stream) Implements al_get_audio_stream_depth. (audio-stream-playmode audio-stream) Implements al_get_audio_stream_playmode. (audio-stream-playing? audio-stream) Implements al_get_audio_stream_playing. (audio-stream-attached? audio-stream) Implements al_get_audio_stream_attached. (audio-stream-fragment audio-stream) Implements al_get_audio_stream_fragment. (audio-stream-speed-set! audio-stream float) Implements al_set_audio_stream_speed. (audio-stream-gain-set! audio-stream float) Implements al_set_audio_stream_gain. (audio-stream-pan-set! audio-stream float) Implements al_set_audio_stream_pan. (audio-stream-playmode-set! audio-stream playmode) Implements al_set_audio_stream_playmode. (audio-stream-playing-set! audio-stream bool) Implements al_set_audio_stream_playing. (audio-stream-detach! audio-stream) Implements al_detach_audio_stream. (audio-stream-fragment-set! audio-stream c-pointer) Implements al_set_audio_stream_fragment. (audio-stream-rewind! audio-stream) Implements al_rewind_audio_stream. (audio-stream-seek-seconds! audio-stream double) Implements al_seek_audio_stream_secs. (audio-stream-position-seconds audio-stream) Impements al_get_audio_stream_position_secs. (audio-stream-length-seconds audio-stream) Implements al_get_audio_length_secs. (audio-stream-loop-set! audio-stream (double start-seconds) (double end-seconds)) Implements al_set_audio_stream_loop_secs. (audio-stream-event-source audio-stream) Implements al_get_audio_stream_event_source. (make-mixer* (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_mixer. (make-mixer (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_mixer, with (free-mixer!) declared as a finalizer. (free-mixer! mixer) Implements al_destroy_mixer. (sample-instance-attach-to-mixer! sample-instance mixer) Implements al_attach_sample_instance_to_mixer. (audio-stream-attach-to-mixer! audio-stream mixer) Implements al_attach_audio_stram_to_mixer. (mixer-attach-to-mixer! mixer mixer) Implements al_attach_mixer_to_mixer. (mixer-postprocess-callback-set! mixer (function void (c-pointer unsigned-integer32 c-pointer)) (c-pointer data)) Implements al_set_mixer_postprocess_callback. (mixer-frequency mixer) Implements al_get_mixer_frequency. (mixer-channels mixer) Implements al_get_mixer_channels. (mixer-depth mixer) Implements al_get_mixer_depth. (mixer-quality mixer) Implements al_get_mixer_quality. (mixer-playing? mixer) Implements al_get_mixer_playing. (mixer-attached? mixer) Implements al_get_mixer_attached. (mixer-frequency-set! mixer unsigned-integer) Implements al_set_mixer_frequency. (mixer-quality-set! mixer mixer-quality) Implements al_set_mixer_quality. (mixer-playing-set! mixer bool) Implements al_set_mixer_playing. (mixer-detach! mixer) Implements al_detach_mixer. (make-voice* (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_voice. (make-voice (unsigned-integer frequency) audio-depth channel-configuration) Implements al_create_voice, with (free-voice!) declared as a finalizer. (free-voice! voice) Implements al_destroy_voice. (sample-instance-attach-to-voice! sample-instance voice) Implements al_attach_sample_instance_to_voice. (audio-stream-attach-to-voice! audio-stram voice) Implements al_attach_audio_stream_to_voice. (mixer-attach-to-voice! mixer voice) Implements al_attach_mixer_to_voice. (voice-detach! voice) Implements al_detach_voice. (voice-frequency voice) Implements al_get_voice_frequency. (voice-position voice) Implements al_get_voice_position voice) (voice-channels voice) Implements al_get_voice_channels. (voice-depth voice) Implements al_get_voice_depth. (voice-playing? voice) Implements al_get_voice_playing. (voice-position-set! voice unsigned-integer) Implements al_set_voice_position. (voice-playing-set! voice bool) Implements al_set_voice_playing. (audio-addon-install) Implements al_install_audio. (audio-addon-uninstall) Implements al_uninstall_audio. (audio-addon-installed?) Implements al_is_audio_installed. (audio-addon-version) Implements al_get_allegro_audio_version. (channel-configuration-count channel-configuration) Implements al_get_channel_count. (audio-depth-size audio-depth) Implements al_get_audio_depth_size. (default-mixer) Implements al_get_default_mixer. (default-mixer-set! mixer) Implements al_set_default_mixer. (default-mixer-restore!) Implements al_restore_default_mixer. (sample-play sample (float gain) (float pan) (float speed) playmode sample-id) Implements al_play_sample. The Sample ID is written to the provided sample-id struct. (sample-stop sample-id) Implements al_stop_sample. (reserve-samples integer) Implements al_reserve_samples. (stop-all-samples) Implements al_stop_samples. (register-sample-loader (string extension) (function sample ((const string)))) Implements al_register_sample_loader. (register-sample-saver (string extension) (function bool ((const c-string) sample))) Implements al_register_sample_saver. (register-audio-stream-loader (string extension) (function audio-stream ((const string) size_t unsigned-integer32))) Implements al_register_audio_stream_loader. (register-sample-file-loader (string extension) (function sample (file))) Implements al_register_sample_loader_f. (register-sample-file-saver (string extension) (function bool (file sample))) Implements al_register_sample_saver_f. (register-audio-stream-file-loader (string extension) (function audio-stream (file size_t unsigned-integer))) Implements al_register_audio_stream_loader_f. (load-sample* string) Implements al_load_sample. (load-sample string) Implements al_load_sample, with (free-sample!) declared as a finalizer. (load-audio-stream* string (integer buffer-count) (unsigned-integer samples)) Implements al_load_audio_stream. (load-audio-stream string (integer buffer-count) (unsigned-integer samples)) Implements al_load_audio_stream, with (free-audio-stream!) declared as a finalizer. (load-audio-stream-from-file* file (string identity) (integer buffer-count) (unsigned-integer samples)) Implements al_load_audio_straem_from_file. (load-audio-stream-from-file file (string identity) (integer buffer-count) (unsigned-integer samples)) Implements al_load_audio_straem_from_file, with (free-audio-stream!) declared as a finalizer. (load-sample-from-file* file (string identity)) Implements al_load_sample_f. (load-sample-from-file file (string identity)) Implements al_load_sample_f, with (free-sample!) declared as a finalizer. (sample-save-to-file sample file (string identity)) Implements al_save_sample_f. (sample-save sample (string filename)) Implements al_save_sample. === Audio Codec Addon (acodec-addon-init) Implements al_init_acodec_addon. (acodec-addon-version) Implements al_get_allegro_acodec_version. === Bitmap (new-bitmap-format-set! pixel-format) Implements al_set_new_bitmap_format. (new-bitmap-format) Implements al_get_new_bitmap_flags. (new-bitmap-flags-set! bitmap-flag) Implements al_set_new_bitmap_flags. (new-bitmap-flags) Implements al_get_new_bitmap_flags. (new-bitmap-add-flag bitmap-flag) Implements al_add_new_bitmap_flag. (make-bitmap* (integer width) (integer height)) Implements al_create_bitmap. (make-bitmap (integer width) (integer height)) Implements al_create_bitmap, with (free-bitmap!) declared as a finalizer. (bitmap-draw bitmap (float dx) (float dy) bitmap-flag) Implements al_draw_bitmap. (bitmap-draw-region bitmap (float sx) (float sy) (float sw) (float sh) (float dx) (float dy) (integer bitmap-flags)) Implements al_draw_bitmap_region. (bitmap-draw-scaled bitmap (float sx) (float sy) (float sw) (float sh) (float dx) (float dy) (float dw) (float dh) (integer bitmap-flags)) Implements al_draw_scaled_bitmap. (bitmap-draw-rotated bitmap (float cx) (float cy) (float dx) (float dy) (float angle) (integer bitmap-flags)) Implements al_draw_rotated_bitmap. (bitmap-draw-scaled-rotated bitmap (float cx) (float cy) (float dx) (float dy) (float xscale) (float yscale) (float angle) (integer bitmap-flags)) Implements al_draw_scaled_rotated_bitmap. (bitmap-draw-tinted (bitmap bmp) (color tint) (float dx) (float dy) (integer bitmap-flags)) Implements al_draw_tinted_bitmap. (bitmap-draw-tinted-region (bitmap bmp) (color tint) (float sx) (float sy) (float sw) (float sh) (float dx) (float dy) (integer bitmap-flags)) Implements al_draw_tinted_bitmap_region. (bitmap-draw-tinted-scaled (bitmap bmp) (color tint) (float sx) (float sy) (float sw) (float sh) (float dx) (float dy) (float dw) (float dh) (integer flags)) Implements al_draw_tinted_scale_bitmap. (bitmap-draw-tinted-rotated (bitmap bmp) (color tint) (float cx) (float cy) (float dx) (float dy) (float angle) (integer flags)) Implements al_draw_tinted_rotated_bitmap. (bitmap-draw-tinted-scaled-rotated (bitmap bmp) (color tint) (float cx) (float cy) (float dx) (float dy) (float xscale) (float yscale) (float angle) (integer flags)) Implements al_draw_tinted_scaled_rotated_bitmap. (bitmap-lock*! bitmap pixel-format (integer bitmap-flags)) Implements al_lock_bitmap. (bitmap-lock-region*! bitmap (integer x) (integer y) (integer width) (integer height) pixel-format (integer bitmap-flags)) Implements al_lock_bitmap_region. (bitmap-unlock! bitmap) Implements al_unlock_bitmap. (bitmap-lock! bitmap pixel-format (integer bitmap-flags)) Implements al_lock_bitmap, with (bitmap-unlock!) and (free-locked-region!) declared as finalizers. (bitmap-lock-region! bitmap (integer x) (integer y) (integer width) (integer height) pixel-format (integer bitmap-flags)) Implements al_lock_bitmap_region, with (bitmap-unlock!) and (free-locked-region!) declared as finalizers. (bitmap-pixel! (bitmap bmp) (int x) (int y) (color c)) Sets the provided color struct to the color value at the given coordinates. (bitmap-pixel* (bitmap bmp) (int x) (int y)) Returns a new color struct of the color value at the given coordinates. (bitmap-pixel (bitmap bmp) (int x) (int y)) Returns a new color struct of the color value at the given coordinates, with (free-color!) declared as a finalizer. (bitmap-width bitmap) Implements al_get_bitmap_width. (bitmap-height bitmap) Implements al_get_bitmap_height. (bitmap-format bitmap) Implements al_get_bitmap_format. (bitmap-flags bitmap) Implements al_get_bitmap_flags. (bitmap-mask->alpha! bitmap color) Implements al_convert_mask_to_alpha. (bitmap-clone* bitmap) Implements al_clone_bitmap. (bitmap-clone bitmap) Implements al_clone_bitmap, with (free-bitmap!) declared as a finalizer. (bitmap-locked? bitmap) Implements al_is_bitmap_locked. (bitmap-put-pixel! bitmap (integer x) (integer y) (color c)) Implements _al_put_pixel. (make-sub-bitmap* bitmap (integer x) (integer y) (integer width) (integer height)) Implements al_create_sub_bitmap. (make-sub-bitmap bitmap (integer x) (integer y) (integer width) (integer height)) Implements al_create_sub_bitmap, with (free-bitmap!) declared as a finalizer. (sub-bitmap? bitmap) Implements al_is_sub_bitmap. (put-pixel (integer x) (integer y) (color c)) Implements al_put_pixel. (put-blended-pixel (integer x) (integer y) (color c)) Implements al_put_blended_pixel. (pixel-size pixel-format) Implements al_get_pixel_size. (color-map-rgb! (color c) (unsigned-byte r) (unsigned-byte g) (unsigned-byte b)) Maps rgb values onto the provided color struct, implementing al_map_rgb. (color-map-rgba! (color c) (unsigned-byte r) (unsigned-byte g) (unsigned-byte b) (unsigned-byte a)) Maps rgba values onto the provided color struct, implementing al_map_rgba. (color-map-rgb-float! (color c) (unsigned-byte r) (unsigned-byte g) (unsigned-byte b)) Maps rgb values onto the provided color struct, implementing al_map_rgb_f. (color-map-rgba-float! (color c) (unsigned-byte r) (unsigned-byte g) (unsigned-byte b) (unsigned-byte a)) Maps rgba values onto the provided color struct, implementing al_map_rgba_f. (map-rgb* r g b) Returns a new color struct mapped to the given rgb values. (map-rgb r g b) Returns a new color struct mapped to the given rgb values, with (free-color!) declared as a finalizer. (map-rgba* r g b a) Prodcues a new color struct mapped to the given rgba values. (map-rgba r g b a) Returns a new color struct mapped to the given rgba values, with (free-color!) declared as a finalizer. (map-rgb-float* r g b) Returns a new color struct mapped to the given rgb values. (map-rgb-float r g b) Returns a new color struct mapped to the given rgb values, with (free-color!) declared as a finalizer. (map-rgba-float* r g b a) Returns a new color struct mapped to the given rgba values. (map-rgba-float r g b a) Returns a new color struct mapped to the given rgba values, with (free-color!) declared as a finalizer. (color-unmap-rgb color) Returns a 3-element list of the rgb values representing a given color struct. (color-unmap-rgba color) Returns a 4-element list of the rgba values representing a given color struct. (color-unmap-rgb-float color) Returns a 3-element list of the rgb values representing a given color struct. (color-unmap-rgba-float color) Returns a 4-element list of the rgb values representing a given color struct. (pixel-format-bits pixel-format) Implements al_get_pixel_format_bits. (clipping-rectangle) Returns a 4-element list of the x, y, width and height values of the current clipping rectangle. (clippingle-rectangle-set! (integer x) (integer y) (integer width) (integer height)) Sets the current clipping rectangle. (blender) Returns a 3-element list of the op, source and destination of the current blender. (blender-set! (blend-operation op) (integer source) (integer destination)) Implements al_set_blender. (separate-blender) Returns a 6-element list of the op, source, destination, alpha op, alpha source, and alpha destination. (separate-blender-set! (blend-operation op) (integer src) (integer destination) (integer alpha-op) (integer alpha-source) (integer alpha-destination)) Implements al_set_separate_blender. === Bitmap I/O (register-bitmap-loader (string extension) (function bitmap ((const c-string)))) Implements al_register_bitmap_loader. (register-bitmap-file-loader (string extension) (function bitmap (file))) Implements al_register_bitmap_loader_f. (register-bitmap-saver (string extension) ((function bool ((const c-string) bitmap)) saver)) Implements al_register_bitmap_saver. (register-bitmap-file-saver (string extension) ((function bool (file bitmap)) saver)) Implements al_register_bitmap_saver_f. (load-bitmap* string) Implements al_load_bitmap. (load-bitmap string) Implements al_load_bitmap, with (free-bitmap!) declared as a finalizer. (load-bitmap-from-file* file string) Implements al_load_bitmap_f. (load-bitmap-from-file file string) Implements al_load_bitmap_f, with (free-bitmap!) declared as a finalizer. (bitmap-save bitmap string) Implements al_save_bitmap. (bitmap-save-to-file bitmap file string) Implements al_save_bitmap_f. === Color (color-addon-version) Implements al_get_allegro_color_version. (hsv->rgb (float h) (float s) (float v)) Returns a 3-element list consisting of the rgb elements. (rgb->hsl (float red) (float green) (float blue)) Returns a 3-element list consisting of the hsl elements. (hsl->rgb (float hue) (float saturation) (float lightness)) Returns a 3-element list consisting of the rgb elements. (name->rgb string) Returns a 3-element list consisting of the rgb elements. (rgb->name (float red) (float green) (float blue)) Returns a string representation of the rgb elements. (cmyk->rgb (float cyan) (float magenta) (float yellow) (float key)) Returns a 3-element list consisting of the rgb elements. (rgb->cmyk (float red) (float green) (float blue)) Returns a 4-element list consisting of the cmyk elements. (yuv->rgb (float y) (float u) (float v)) Returns a 3-element list consisting of the rgb elements. (rgb->yuv (float red) (float green) (float blue)) Returns a 3-element list consisting of the yuv elements. (rgb->html (float red) (float green) (float blue)) Returns a string consisting of the html representation. (html->rgb string) Returns a 3-element list consisting of the rgb elements. (make-color-rgb* (integer r) (integer g) (integer b)) Creates a color struct from rgb elements. (make-color-rgb (integer r) (integer g) (integer b)) Creates a color struct from rgb elements, with (free-color!) declared as a finalizer. (make-color-rgba*(integer r) (integer g) (integer b) (integer a)) Creates a color struct from rgba elements. (make-color-rgba (integer r) (integer g) (integer b) (integer a)) Creates a color struct from rgba elements, with (free-color!) declared as a finalizer. (make-color-yuv* (integer y) (integer u) (integer v)) Creates a color struct from yuv elements. (make-color-yuv (integer y) (integer u) (integer v)) Creates a color struct from yuv elements, with (free-color!) declared as a finalizer. (make-color-cmyk* (integer c) (integer m) (integer y) (integer k)) Creates a color struct from cmyk elements. (make-color-cmyk (integer c) (integer m) (integer y) (integer k)) Creates a color struct from cmyk elements, with (free-color!) declared as a finalizer. (make-color-hsl*(integer h) (integer s) (integer l)) Creates a color struct from hsl elements. (make-color-hsl (integer h) (integer s) (integer l)) Creates a color struct from hsl elements, with (free-color!) declared as a finalizer. (make-color-hsv*(integer h) (integer s) (integer v)) Creates a color struct from hsv elements. (make-color-hsv (integer h) (integer s) (integer v)) Creates a color struct from hsv elements, with (free-color!) declared as a finalizer. (make-color-name* string) Creates a color struct from a string name. (make-color-name string) Creates a color struct from a string name, with (free-color!) declared as a finalizer. (make-color-html* string) Creates a color struct from a html representation. (make-color-html string) Creates a color struct from a html representation, with (free-color!) declared as a finalizer. (color-yuv! color (float y) (float u) (float v)) Maps yuv elements to a color struct. (color-cmyk! color (float c) (float m) (float y) (float k)) Maps cmyk elements to a color struct. (color-hsl! color (float h) (float s) (float l)) Maps hsl elements to a color struct. (color-hsv! color (float h) (float s) (float v)) Maps hsv elements to a color struct. (color-name! color string) Maps a color name to a color struct. (color-html! color string) Maps a html representation to a color struct. === Config Files (make-config*) Implements al_create_config. (make-config) Implements al_create_config, with (free-config!) declared as a finalizer. (free-config! config) Implements al_destroy_config. (config-section-add! config string) Implements al_add_config_section. (config-value-set! config (string section) (string key) (string value)) Implements al_set_config_value. (config-comment-add! config (string section) (string comment)) Implements al_add_config_comment. (config-value config (string section) (string key)) Implements al_get_config_value. (load-config* string) Implements al_load_config_file. (load-config string) Implements al_load_config_file, with (free-config!) decalred as a finalizer. (load-config-from-file* file) Implements al_load_config_file_f. (load-config-from-file file) Implements al_load_config_file_f, with (free-config!) declared as a finalizer. (config-save config string) Implements al_save_config_file. (config-save-to-file config file) Implements al_save_config_file_f. (config-merge! config config) Implements al_merge_config_into. (config-merge config config) Implements al_merge_config. (config-sections config) Creates an iterator that covers the sections of the given config. Returns values of the form (list config-section promise). (force) the promise to get the next section. Needs testing! (config-entries config config-section) Creates an iterator that covers the entries of the given config and config-section. Returns values of the form (list config-entry promise). (force) the promise to get the next entry. Needs testing! === Debugging (trace-prefix (string channel) (int level) (string file) (int line) (string function)) Implements _al_trace_prefix. (trace-level-debug) Implements ALLEGRO_DEBUG. (trace-level-info) Implements ALLEGRO_INFO. (trace-level-warn) Implements ALLEGRO_WARN. (trace-level-error) Implements ALLEGRO_ERROR. (debug-assert bool) Implements ALLEGRO_ASSERT. === Display (new-display-refresh-rate) Implements al_get_new_display_refresh_rate. (new-display-refresh-rate-set! integer) Implements al_set_new_display_refresh_rate. (new-display-flags) Implements al_get_new_display_flags. (new-display-flags-set! integer) Implements al_set_new_display_flags. (new-display-adapter) Implements al_get_new_display_adapter. (new-display-adapter-set! integer) Implements al_set_new_display_adpater. (new-display-window-position) Returns a 2-element list consisting of the new display coordinates. (new-display-window-position-set! (integer x) (integer y)) Sets the a new display's window position. (new-display-option-value display-option) Retrieves the value for a particular display-option for newly created displays. (new-display-option-importance display-option) Retrieves the importance for a particular display-option for newly created dispalys. (new-display-option-set! display-option (integer value) display-option-importance) Implements al_set_new_display_option. (new-display-reset-options) Implements al_reset_new_display_options. (make-display* (integer width) (integer height)) Implements al_create_display. (make-display (integer width) (integer height)) Implements al_create_display, with (free-display!) declared as a finalizer. (make-display/mode* display-mode (integer adapter) (integer flags)) Creates a new display, taking the refresh rate, width and height from a display-mode struct. (make-display/mode display-mode (integer adapter) (integer flags)) Creates a new display, taking the refresh rate, width and height from a display-mode struct, with (free-display-mode!) declared as a finalizer. (free-display! display) Implements al_destroy_display. (current-display) Implements al_get_current_display. (display-mode-count) Implements al_get_num_display_modes. (display-mode-init! display-mode (integer index)) Implements al_get_display_mode, returning #f if unsuccessful. (update-display-region! (integer x) (integer y) (integer width) (integer height)) Implements al_update_display_region. (compatible-bitmap? bitmap) Implements al_is_compatible_bitmap. (wait-for-vsync) Implements al_wait_for_vsync. (draw-pixel (float x) (floay y) color) Implements al_draw_pixel. (video-adapter-count) Implements al_get_num_video_adapters. (monitor-init! monitor (integer adapter)) Implements al_get_monitor_info. (display-option display display-option) Implements al_get_display_option. (display-hold-bitmap-drawing! bool) Implements al_hold_bitmap_drawing. (display-bitmap-drawing-held?) Implements al_is_bitmap_drawing_help. (display-window-title-set! display string) Implements al_set_window_title. (display-width display) Implements al_get_display_width. (display-height display) Implements al_get_display_height. (display-format display) Implements al_get_display_format. (display-refresh-rate display) Implements al_get_display_refresh_rate. (display-flags display) Implements al_get_display_flags. (display-toggle-flag! display display-flag bool) Implements al_toggle_display_flag. (display-backbuffer display) Implements al_get_backbuffer. (display-acknowledge-resize display) Implements al_acknowledge_resize. (display-resize! display (integer width) (integer height)) Implements al_resize_display. (display-event-source display) Implements al_get_display_event_source. (display-iconset! display bitmap) Implements al_set_display_icon. (clear-to-color color) Implements al_clear_to_color. (target-bitmap) Implements al_get_target_bitmap. (target-bitmap-set! bitmap) Implements al_set_target_bitmap. (target-backbuffer-set! display) Implements al_set_target_backbuffer. (flip-display) Implements al_flip_display. === Direct3D (d3d-non-pow2-texture-support?) Implements al_have_d3d_non_pow2_texture_support. (d3d-non-square-texture-support?) Implements al_have_d3d_non_square_texture_support. ==== Bitmap Specific (bitmap-d3d-system-texture bitmap) Implements al_get_d3d_system_texture. (bitmap-d3d-video-texture bitmap) Implements al_get_d3d_video_texture. (bitmap-d3d-texture-position bitmap) Returns a 2-element list consisting of a u, v pair. ==== Display Specific (display-d3d-device-lost? display) Implements al_is_d3d_device_lost. (display-d3d-device display) Implements al_get_d3d_device. === Events (user-event-type? integer) Implements ALLEGRO_EVENT_TYPE_IS_USER. (make-event-type (integer a) (integer b) (integer c) (integer d)) Implements ALLEGRO_GET_EVENT_TYPE. (event-type event) Returns the type of a given event struct. (event->any-event event) Converts an event to an any-event. (event->display-event event) Converts an event to a display-event. (event->joystick-event event) Converts an event to a joystick-event. (event->keyboard-event event) Converts an event to a keyboard-event. (event->mouse-event event) Converts an event to a mouse-event. (event->timer-event event) Converts an event to a timer-event. (event->user-event event) Converts an event to a user-event. (user-event-source-init! event-source) Implements al_init_user_event_source. (free-user-event-source! event-source) Implements al_destroy_user_event_source. (emit-user-event! event-source event (function void (user-event))) Implements al_emit_user_event. (user-event-unref! user-event) Implements al_unref_user_event. (event-source-data event-source) Implements al_get_event_source_data. (event-source-data-set! event-source integer) Implements al_set_event_source_data. (make-event-queue*) Implements al_create_event_queue. (make-event-queue) Implements al_create_event_queue, with (free-event-queue!) declared as a finalizer. (free-event-queue! event-queue) Implements al_destroy_event_queue. (event-queue-register-source! event-queue event-source) Implements al_register_event_source. (event-queue-unregister-source! event-queue event-source) Implements al_unregister_event_source. (event-queue-empty? event-queue) Implements al_is_event_queue_empty. (event-queue-next! event-queue event) Implements al_get_next_event. (event-queue-peek! event-queue event) Implements al_peek_next_event. (event-queue-drop-next! event-queue) Implements al_drop_next_event_queue. (event-queue-flush! event-queue) Implements al_drop_next_event. (event-queue-wait! event-queue event) Implements al_wait_for_event. (event-queue-timed-wait! event-queue event float) Implements al_wait_for_event_timed. (event-queue-wait-until! event-queue event timeout) Implements al_wait_for_event_until. === Errors (error-number) Implements al_get_errno. (error-number-set!) Implements al_set_errno. === File Operations (make-temp-file* (string template) ((c-pointer path) out_path)) Implements al_make_temp_file. (make-temp-file (string template) ((c-pointer path) out_path)) Implements al_make_temp_file, with (free&close-file!) declared as a finalizer. (file-open* (string path) (string mode)) Implements al_fopen. (file-open (string path) (string mode)) Implements al_fopen, with (free&close-file!) declared as a finalizer. (file-open-fd* (integer file-descriptor) (string mode)) Implements al_fopen_fd. (file-open-fd (integer file-descriptor) (string mode)) Implements al_fopen_fd, with (free&close-file!) declared as a finalizer. (free&close-file! file) Closes a file with (file-close!), then uses (free!) to clear the file struct from memory. (file-close! file) Implements al_fclose. (file-read! file blob (integer size)) Implements al_fread. (file-write! file blob (integer size)) Implements al_fwrite. (file-tell file)(file-seek! file (integer offset) (integer whence)) Implements al_fseek. (file-eof? file) Implements al_feof. (file-error? file) Implements al_ferror. (file-clear-error! file) Implements al_fclearerr. (file-unget-chars! file (integer count)) Implements al_fungetc. (file-size file) Implements al_fsize. (file-get-char! file) Implements al_fgetc. (file-put-char! file (integer character)) Implements al_fputc. (file-read-16le! file) Implements al_fread16le. (file-read-16be! file) Implements al_fread16be. (file-write-16le! file integer) Implements al_fwrite16le. (file-read-32le! file) Implements al_fread32le. (file-read-32be! file) Implements al_fread32be. (file-write-32le! file integer) Implements al_fwrite32le. (file-write-32be! file integer) Implements al_fwrite32be. (file-get-string! file blob (integer max)) Implements al_fgets. (file-get-utf-string*! file) Implements al_get_ustr. (file-get-utf-string! file) Implements al_get_ustr, with (free-utf-string!) declared as a finalizer. (file-put-string! file string) Implements al_fputs. (file-userdata file) Implements al_get_file_userdata. (new-file-interface-set! file-interface) Implements al_set_new_file_interface. (file-interface-open* file-interface (string path) (string mode)) Implements al_fopen_interface. (file-interface-open file-interface (string path) (string mode)) Implements al_fopen_interface, with (free&close-file!) declared as a finalizer. (make-file-handle* file-interface (c-pointer userdata)) Implements al_create_file_handle. (make-file-handle file-interface (c-pointer userdata)) Implements al_create_file_handle, with (free&close-file!) decalred as a finalizer. === File System Hooks (make-fs-entry* string) Implements al_create_fs_entry. (make-fs-entry string) Implements al_create_fs_entry, with (free-fs-entry!) declared as a finalizer. (free-fs-entry! fs-entry) Implements al_destroy_fs_entry. (fs-entry-name fs-entry) Implements al_get_fs_entry_name. (fs-entry-update! fs-entry) Implements al_update_fs_entry. (fs-entry-mode fs-entry) Implements al_get_fs_entry_mode. (fs-entry-atime fs-entry) Implements al_get_fs_entry_atime. (fs-entry-mtime fs-entry) Implements al_get_fs_entry_mtime. (fs-entry-ctime fs-entry) Implements al_get_fs_entry_ctime. (fs-entry-size fs-entry) Implements al_get_fs_entry_size. (fs-entry-exists? fs-entry) Implements al_fs_entry_exists. (fs-entry-remove! fs-entry) Implements al_remove_fs_entry. (fs-entry-open fs-enty string) Implements al_open_fs_entry. (fs-entry-directory-open! fs-entry) Implements al_open_directory. (fs-entry-directory-read fs-entry) Implements al_read_directory. (fs-entry-directory-close! fs-entry) Implements al_close_directory. (current-directory) Implements al_get_current_directory. (change-directory string) Implements al_change_directory. (make-directory string) Implements al_make_directory. (filename-exists? string) Implements al_filename_exists. (filename-remove! string) Implements al_remove_filename. (new-file-interface) Implements al_get_new_file_interface. (current-fs-interface) Implements al_get_fs_interface. (current-fs-interface-set!) Implements al_set_fs_interface. (standard-fs-interface-set!) Implements al_set_standard_fs_interface. === Fixed Math (fix-to-rad integer) Implements al_fixtorad_r. (rad-to-fix integer) Implements al_radtofix_r. (fixed-sqrt integer) Implements al_fixsqrt. (fixed-hypot integer) Implements al_fixhypot. (fixed-atan integer) Implements al_fixatan. (fixed-atan2 integer) Implements al_fixatan2. (fixed-cos integer) Wraps _al_fix_cos_tbl. (fixed-tan integer) Wraps _al_fix_tan_tbl. (fixed-acos integer) Wraps _al_fix_acos_tbl. === Fonts (register-font-loader (string extension) (function font (string integer integer))) Implements al_register_font_loader. (load-bitmap-font* string) Implements al_load_bitmap_font. (load-bitmap-font string) Implements al_load_bitmap_font, with (free-font!) declared as a finalizer. (load-font* string (integer size) (integer flags)) Implements al_load_font. (load-font string (integer size) (integer flags)) Implements al_load_font, with (free-font!) declared as a finalizer. (make-font-from-bitmap* bitmap (integer n) (s32vector ranges)) Implements al_grab_font_from_bitmap. (make-font-from-bitmap bitmap (integer n) (s32vector ranges)) Implements al_grab_font_from_bitmap, with (free-font!) declared as a finalizer. (free-font! font) Implements al_destroy_font. (font-draw-utf (font f) (color c) (float x) (float y) (font-align flags) (utf-string ustr)) Implements al_draw_ustr. (font-draw-string (font f) (color c) (float x) (float y) (font-align flags) (string text)) Implements al_draw_text. (font-draw-justified-string (font f) (color c) (float x1) (float x2) (float y) (float diff) (font-align flags) (c-string text)) Implements al_draw_justified_text. (font-draw-justified-utf-string (font f) (color c) (float x1) (float x2) (float y) (float diff) (font-align flags) (utf-string text)) Implements al_draw_justified_ustr. (font-width font string) Implements al_get_text_width. (font-utf-width font utf-string) Implements al_get_ustr_width. (font-line-height font) Implements al_get_font_line_height. (font-ascent font) Implements al_get_font_ascent. (font-descent font) Implements al_get_font_descent. (font-utf-dimensions (font f) (utf-string text)) Returns a 4-element list consisting of the bounding box elements: x, y, width and height. (font-dimensions (font f) (string text)) Returns a 4-element list consisting of the bounding box elements: x, y, width and height. (font-addon-install) Implements al_init_font_addon. (font-addon-uninstall) Implements al_shutdown_font_addon. (font-addon-version) Implements al_get_allegro_font_version. === Image Formats (image-addon-install) Implements al_init_image_addon. (image-addon-uninstall) Implements al_shutdown_image_addon. (image-addon-version) Implements al_get_allegro_image_version. === Joystick (joystick-addon-install) Implements al_install_joystick. (joystick-addon-uninstall) Implements al_uninstall_joystick. (joystick-addon-installed?) Implements al_is_joystick_installed. (joystick-addon-reconfigure) Implements al_reconfigure_joysticks. (joystick-event-source) Implements al_get_joystick_event_source. (joystick-count) Implements al_get_num_joysticks. (joystick-ref integer) Implements al_get_joystick. (joystick-release joystick) Implements al_release_joystick. (joystick-active? joystick) Implements al_get_joystick_active. (joystick-name joystick) Implements al_get_joystick_name. (joystick-axes-count joystick (integer stick)) Implements al_get_joystick_num_axes. (joystick-button-count joystick) Implements al_get_joystick_num_buttons. (joystick-button-name joystick (integer button)) Implements al_get_joystick_button_name. (joystick-state-init! joystick-state joystick) Implements al_get_joystick_state. (joystick-state-axis joystick-state (integer stick) (integer axis)) Retrieves desired axis value for a particular stick; #f if either stick or axis is out of available bounds. === Keyboard (keyboard-addon-installed?) Implements al_is_keyboard_installed. (keyboard-addon-install) Implements al_install_keyboard. (keyboard-addon-uninstall) Implements al_uninstall_keyboard. (keycode->string key) Implements al_keycode_to_name. Not strictly necessary, since the enums are symbols which can easily be converted to strings. (keyboard-event-source) Implements al_get_keyboard_event_source. (keyboard-led-set! integer) Implements al_set_keyboard_leds. (keyboard-state-init! keyboard-state) Implements al_get_keyboard_state. (keyboard-state-key-down? keyboard-state key) Implements al_key_down. (keyboard-three-finger-flag?) Wraps _al_three_finger_flag. (keyboard-led-flag?) Wraps _al_key_led_flag. === Memory (memory-interface-set! memory-interface) Implements al_set_memory_interface. (malloc* integer) Implements al_malloc. (malloc integer) Implements al_malloc, with (free!) declared as a finalizer. (free! ptr) Implements al_free. (realloc* ptr integer) Implements al_realloc. (realloc ptr integer) Implements al_realloc, with (free!) declared as a finalizer. (calloc* integer integer) Implements al_calloc. (calloc integer integer) Implements al_calloc, with (free!) declared as a finalizer. (malloc/context* (int size) (int line) (string file) (string function)) Implements al_malloc_with_context. (malloc/context (int size) (int line) (string file) (string function)) Implements al_malloc_with_context, with (free/context!) declared as a finalizer. (free/context! ptr (int line) (string file) (string function)) Implements al_free_with_context. (realloc/context* ptr (int size) (int line) (string file) (string function)) Implements al_realloc_with_context. (realloc/context ptr (int size) (int line) (string file) (string function)) Implements al_realloc_with_context, with (free/context!) declared as a finalizer. (calloc/context* (int count) (int size) (int line) (string file) (string function)) Implements al_calloc_with_context. (calloc/context (int count) (int size) (int line) (string file) (string function)) Implements al_calloc_with_context, with (free/context!) declared as a finalizer. === Memory Files (open-memfile* (c-pointer mem) (unsigned-integer size) (string mode)) Implements al_open_memfile. (open-memfile (c-pointer mem) (unsigned-integer size) (string mode)) Implements al_open_memfile, with (free&close-file!) declared as a finalizer. (memfile-version) Implements al_get_allegro_memfile_version. === Miscellaneous (combine-flags converter flags) For combining enum flags together, ie: (combine-flags display-flag->int '(windowed opengl resizable generate-expose-events)) (make-id a b c d) Implements AL_ID. (run-main argc argv (function integer (integer (c-pointer c-string)))) Implements al_run_main. (init-everything) Initializes all sub-systems. (init-symbol s) Initializes sub-systems by symbol-name. Valid symbols are: allegro, audio, font, image, joystick, keyboard, mouse, primitives, and ttf. (init-this arg) Initializes sub-systems either by a single symbol or by a list of symbols. Ie: (init-this (list 'allegro 'audio 'font 'image 'joystick 'keyboard 'mouse 'primitives 'ttf)) (uninstall-everything) Attempts to uninitialize all loaded sub-systems. (uninstall-this arg) Attempts to uninitialize sub-systems by either a single symbol or by a list of symbols. Ie: (uninstall-this (list 'system 'audio 'font 'image 'joystick 'keyboard 'mouse 'primitives 'ttf)) === Mouse (mouse-addon-installed?) Implements al_is_mouse_installed. (mouse-addon-install) Implements al_install_mouse. (mouse-addon-uninstall) Implements al_uninstall_mouse. (mouse-button-count) Implements al_get_mouse_num_buttons. (mouse-axes-count) Implements al_get_mouse_num_axes. (mouse-xy-set! display (integer x) (integer y)) Implements al_set_mouse_xy. (mouse-z-set! display integer) Implements al_set_mouse_z. (mouse-w-set! display integer) Implements al_set_mouse_w. (mouse-event-source) Implements al_get_mouse_event_source. (mouse-state-init! mouse-state)(mouse-state-button-down mouse-state (integer button)) Implements al_mouse_button_down. (mouse-state-axis mouse-state (integer axis)) Implements al_get_mouse_state_axis. (mouse-axis-set! (integer axis) (integer value)) Implements al_set_mouse_axis. (make-cursor* (bitmap sprite) (integer xfocus) (integer yfocus)) Implements al_create_mouse_cursor. (make-cursor (bitmap sprite) (integer xfocus) (integer yfocus)) Implements al_create_mouse_cursor, with (free-cursor!) declared as a finalizer. (free-cursor! cursor) Implements al_destroy_mouse_cursor. (mouse-cursor-position) Returns a 2-element list consisting of the x and y position of the mouse cursor. (mouse-ungrab) Implements al_ungrab_mouse. (display-grab-mouse! display) Implements al_grab_mouse. (display-cursor-set! display mouse-cursor) Implements al_set_mouse_cursor. (display-hide-cursor! display) Implements al_hide_mouse_cursor. (display-system-mouse-cursor-set! display cursor-type) Implements al_set_system_mouse_cursor. === OpenGL (opengl-addon-version) Implements al_get_opengl_version. (opengl-extension-exists? string) Implements al_have_opengl_extension. (opengl-proc-address string) Implements al_get_opengl_proc_address. (opengl-texture bitmap) Implements al_get_opengl_texture. (opengl-remove-fbo! bitmap) Implements al_remove_opengl_fbo. (opengl-fbo bitmap) Implements al_get_opengl_fbo. (opengl-texture-size bitmap) Returns a 2-element list of the width and height of the opengl texture for the given bitmap. (opengl-texture-position bitmap) Returns a 2-element list of the u,v position of the opengl texture for the given bitmap. (opengl-context-set! display) Implements al_set_current_opengl_context. (opengl-variant) Implements al_get_opengl_variant. === Paths (make-path* string) Implements al_create_path. (make-path string) Implements al_create_path, with (free-path!) declared as a finalizer. (make-path-for-directory* string) Implements al_create_path_for_directory. (make-path-for-directory string) Implements al_create_path_for_directory, with (free-path!) declared as a finalizer. (free-path! path) Implements al_destroy_path. (path->string path (char separator)) Implements al_path_cstr. (path-component-count path) Implements al_get_path_num_components. (path-component path integer) Implements al_get_path_compoenent. (path-component-set! path integer string) Implements al_replace_path_component. (path-component-remove! path integer) Implements al_remove_path_component. (path-component-insert! path integer string) Implements al_insert_path_component. (path-clone path) Implements al_clone_path. (path-tail path) Implements al_get_path_tail. (path-drop-tail! path) Implements al_drop_path_tail. (path-append! path string) Implements al_append_path_component. (path-join! path path) Implements al_join_paths. (path-rebase! path path) Implements al_rebase_path. (path-drive path) Implements al_get_path_drive. (path-drive-set! path string) Implements al_set_path_drive. (path-filename path) Implements al_get_path_filename. (path-filename-set! path string) Implements al_set_path_filename. (path-extension path) Implements al_get_path_extension. (path-extension-set! path string) Implements al_set_path_extension. (path-basename path) Implements al_get_path_basename. (path-make-canonical! path) Implements al_make_path_canonical. === PhysicsFS See also: the [[physfs]] egg. (enable-physfs-file-interface) Implements al_set_physfs_file_interface. (physfs-addon-version) Implements al_get_allegro_physfs_version. === Primitives (primitives-addon-version) Implements al_get_allegro_primitives_version. (primitives-addon-install) Implements al_init_primitives_addon. (primitives-addon-uninstall) Implements al_shutdown_primitives_addon. (make-vertex-declaration* vertex-element integer) Implements al_create_vertex_decl. (make-vertex-declaration vertex-element integer) Implements al_create_vertex_decl, with (free-vertex-declaration!) declared as a finalizer. (free-vertex-declaration! vertex-declaration) Implements al_destroy_vertex_decl. (draw-primitive (c-pointer vertices) vertex-declaration bitmap (integer start) (integer end) primitive-type) Implements al_draw_prim. (draw-indexed-primitive (c-pointer vertices) vertex-declaration bitmap (s32-vector indices) (integer count) primitive-type) Implements al_draw_indexed_prim. (draw-soft-triangle (vertex v1) (vertex v2) (vertex v3) (uintptr state) ((function void (uintptr vertex vertex vertex)) init) ((function void (uintptr int int int int)) first) ((function void (uintptr int)) step) ((function void (uintptr int int int)) draw)) Implements al_draw_soft_triangle. (draw-soft-line (vertex v1) (vertex v2) (uintptr state) ((function void (uintptr int int vertex vertex)) first) ((function void (uintptr int)) step) ((function void (uintptr int int)) draw)) Implements al_draw_soft_line. (draw-line (float x1) (float y1) (float x2) (float y2) (color c) (float thickness)) Implements al_draw_line. (draw-triangle (float x1) (float y1) (float x2) (float y2) (float x3) (float y3) (color c) (float thickness)) Implements al_draw_triangle. (draw-rectangle (float x1) (float y1) (float x2) (float y2) (color c) (float thickness)) Implements al_draw_rectangle. (draw-rounded-rectangle (float x1) (float y1) (float x2) (float y2) (float rx) (float ry) (color c) (float thickness)) Implements al_draw_rounded_rectangle. (draw-circle (float cx) (float cy) (float r) (color c) (float thickness)) Implements al_draw_circle. (draw-ellipse (float cx) (float cy) (float rx) (float ry) (color c) (float thickness)) Implements al_draw_ellipse. (draw-arc (float cx) (float cy) (float r) (float start_theta) (float delta_theta) (color c) (float thickness)) Implements al_draw_arc. (draw-spline (f32vector points) (color c) (float thickness)) Implements al_draw_spline. (draw-ribbon (f32vector points) (integer32 stride) (color c) (float thickness) (integer32 num_segments)) Implements al_draw_ribbon. (draw-triangle/fill (float x1) (float y1) (float x2) (float y2) (float x3) (float y3) (color c)) Implements al_draw_filled_triangle. (draw-rectangle/fill (float x1) (float y1) (float x2) (float y2) (color c)) Implements al_draw_filled_rectangle. (draw-rounded-rectangle/fill (float x1) (float y1) (float x2) (float y2) (float rx) (float ry) (color c)) Implements al_draw_filled_rounded_rectangle. (draw-circle/fill (float cx) (float cy) (float r) (color c)) Implements al_draw_filled_circle. (draw-ellipse/fill (float cx) (float cy) (float rx) (float ry) (color c)) Implements al_draw_filled_ellipse. (calculate-arc (integer32 stride) (float cx) (float cy) (float rx) (float ry) (float start_theta) (float delta_theta) (float thickness) (integer32 num_segments)) Implements al_calculate_arc. (calculate-spline (integer32 stride) (f32vector points) (float thickness) (int num_segments)) Implements al_calculate_spline. (calculate-ribbon (integer32 dest_stride) ((const f32vector) points) (integer32 points_stride) (float thickness) (integer32 num_segments)) Implements al_calculate_ribbon. === System (init) Implements al_init. (inhibit-screensaver bool) Implements al_inhibit_screensaver. (org-name) Implements al_get_org_name. (org-name-set! string) Implements al_set_org_name. (app-name) Implements al_get_app_name. (app-name-set! string) Implements al_set_app_name. (system-addon-uninstall) Implements al_uninstall_system. (system-addon-installed?) Implements al_is_system_installed. (system-driver) Implements al_get_system_driver. (system-config) Implements al_get_system_config. (standard-path system-path) Implements al_get_standard_path. === Threads WARNING: Untested, may not interact well with Chicken. Please, please tell me about your successes and workarounds. I'll fix the egg as called for. (make-thread* (function c-pointer (thread c-pointer)) c-pointer) Implements al_create_thread. (make-thread (function c-pointer (thread c-pointer)) c-pointer) Implements al_create_thread, with (free-thread!) declared as a finalizer. (free-thread! thread) Implements al_destroy_thread. (run-detached-thread (function c-pointer (c-pointer)) c-pointer) Implements al_run_detached_thread. (thread-start! thread) Implements al_start_thread. (thread-join! thread ((c-pointer c-pointer) ret_value)) Implements al_join_thread. (thread-should-stop? thread) Implements al_get_thread_should_stop. (thread-should-stop-set! thread) Implements al_set_thread_should_stop. (make-mutex*) Implements al_create_mutex. (make-mutex) Implements al_create_mutex, with (free-mutex!) declared as a finalizer. (free-mutex! mutex) Implements al_destroy_mutex. (make-mutex-recursive*) Implements al_create_mutex_recursive. (make-mutex-recursive) Implements al_create_mutex_recursive, with (free-mutex!) declared as a finalizer. (mutex-lock! mutex) Implements al_lock_mutex. (mutex-unlock! mutex) Implements al_unlock_mutex. (make-condition*) Implements al_create_cond. (make-condition) Implements al_create_cond, with (free-condition!) declared as a finalizer. (free-condition! condition) Implements al_destroy_cond. (condition-wait condition mutex) Implements al_wait_cond. (condition-wait-until condition mutex timeout) Implements al_wait_cond_until. (condition-broadcast condition) Implements al_broadcast_cond. (condition-signal condition) Implements al_signal_cond. === Thread Local Storage (state-store! state state-flag) Implements al_store_state. (state-restore state) Implements al_restore_state. === Time (current-time) Implements al_get_time. (rest double) Implements al_rest. (timeout-init! timeout double) Implements al_init_timeout. === Timer (make-timer* double) Implements al_create_timer. (make-timer double) Implements al_create_timer, with (free-timer!) declared as a finalizer. (free-timer! timer) Implements al_destroy_timer. (usec->sec double) Implements ALLEGRO_USECS_TO_SECS. (msec->sec double) Implements ALLEGRO_MSECS_TO_SECS. (bps->sec double) Implements ALLEGRO_BPS_TO_SECS. (bpm->sec double) Implements ALLEGRO_BPM_TO_SECS. (timer-start! timer) Implements al_start_timer. (timer-stop! timer) Implements al_stop_timer. (timer-started? timer) Implements al_get_timer_started. (timer-speed timer) Implements al_get_timer_speed. (timer-speed-set! timer double) Implements al_set_timer_speed. (timer-count timer) Implements al_get_timer_count. (timer-count-set! timer integer) Implements al_set_timer_count. (timer-count-add! timer integer) Implements al_add_timer_count. (timer-source timer) Implements al_get_timer_event_source. === Transformations (transform-use transform) Implements al_use_transform. (transform-copy! transform transform) Implements al_copy_transform. (transform-identity! transform) Implements al_identity_transform. (transform-build! transform (float x) (float y) (float sx) (float sy) (float theta)) Implements al_build_transform. (transform-translate! transform (float x) (float y)) Implements al_translate_transform. (transform-scale! transform (float sx) (float sy)) Implements al_scale_transform. (transform-coordinates transform (float x) (float y)) Implements al_transform_coordinates; returns a 2-element list of the transformed coordinate pair. (transform-compose! transform transform) Implements al_compose_transform. (transform-invert! transform) Implements al_invert_transform. (transform-check-inverse transform float) Implements al_check_inverse. (current-transform) Implements al_get_current_transform. === True Type Font Support (load-ttf* (string filename) (integer size) (integer flags)) Implements al_load_ttf_font. (load-ttf (string filename) (integer size) (integer flags)) Implements al_load_ttf_font, with (free-font!) declared as a finalizer. (load-ttf-from-file* (file f) (string filename) (integer size) (integer flags)) Implements al_load_ttf_font_f. (load-ttf-from-file (file f) (string filename) (integer size) (integer flags)) Implements al_load_ttf_font_f, with (free-font!) declared as a finalizer. (ttf-addon-install) Implements al_init_ttf_addon. (ttf-addon-uninstall) Implements al_shutdown_ttf_addon. (ttf-addon-version) Implements al_get_allegro_ttf_version. === UTF Strings (make-utf-string* string) Implements al_ustr_new. (make-utf-string string) Implements al_ustr_new, with (free-utf-string!) declared as a finalizer. (make-utf-string-from-buffer* blob) Given a blob, produces a new utf-string. (make-utf-string-from-buffer blob) Given a blob, produces a new utf-string, with (free-utf-string!) declared as a finalizer. (free-utf-string! utf-string) Implements al_ustr_free. (utf->string utf-string) Implements al_cstr. (utf->buffer! utf-string blob) Implements al_ustr_to_buffer. (utf->string-copy utf-string) Implements al_cstr_dup. (utf-copy* utf-string) Implements al_ustr_dup. (utf-copy utf-string) Implements al_ustr_dup, with (free-utf-string!) declared as a finalizer. (utf-substring* utf-string (integer start) (integer end)) Implements al_ustr_dup_substr. (utf-substring utf-string (integer start) (integer end)) Implements al_ustr_dup_substr, with (free-utf-string!) declared as a finalizer. (utf-empty-string) Implements al_ustr_empty_string. (make-utf-null-string*) Makes an empty utf-string struct, where the string pointer is unset. (make-utf-null-string) Makes an empty utf-string struct, where the string pointer is unset, with (free-utf-string!) declared as a finalizer. (utf-reference-cstr* string) Implements al_ref_cstr. (utf-reference-cstr string) Implements al_ref_cstr, with (free-utf-string!) declared as a finalizer. (utf-reference-buffer* blob) Implements al_ref_buffer. (utf-reference-buffer blob) Implements al_ref_buffer, with (free-utf-string!) declared as a finalizer. (utf-reference-utf-string* utf-string (integer start) (integer end)) Implements al_ref_ustr. (utf-reference-utf-string utf-string (integer start) (integer end)) Implements al_ref_ustr, with (free-utf-string!) declared as a finalizer. (utf-size utf-string) Implements al_ustr_size. (utf-length utf-string) Implements al_ustr_length. (utf-offset utf-string integer) Implements al_ustr_offset. (utf-next utf-string integer) Implements al_ustr_next, modified to return #f at the end of the string. (utf-previous utf-string integer) Implements al_ustr_prev, modified to return #f at the end of the string. (utf-get utf-string integer) Implements al_ustr_get. (utf-get-next utf-string integer) Returns a 2-element list consisting of the next code and its position, or #f if at the end of the string. (utf-get-prev utf-string integer) Returns a 2-element list consisting of the previous code and its position, or #f if at the start of the string. (utf-remove-char! utf-string integer) Implements al_ustr_remove_chr. (utf-remove-range! utf-string (integer start) (integer end)) Implements al_ustr_remove_range. (utf-truncate! utf-string integer) Implements al_ustr_truncate. (utf-ltrim! utf-string) Implements al_ustr_ltrim_ws. (utf-rtrim! utf-string) Implements al_ustr_rtrim_ws. (utf-trim! utf-string) Implements al_ustr_trim_ws. (utf-assign! utf-string utf-string) Implements al_ustr_assign. (utf-assign-substring! utf-string utf-string (integer start) (integer end)) Implements al_ustr_assign_substr. (utf-assign-string! utf-string string) Implements al_ustr_assign_cstr. (utf-set-char! utf-string (integer pos) (integer char)) Implements al_ustr_set_chr. (utf-replace-range! utf-string (integer start) (integer end) utf-string) Implements al_ustr_replace_range. (utf-find utf-string (integer start) utf-string) Implements al_ustr_find_str. (utf-find-string utf-string (integer start) string) Implements al_ustr_find_cstr. (utf-find-char utf-string (integer start) (integer char)) Implements al_ustr_find_chr. (utf-find-set utf-string (integer start) utf-string) Implements al_ustr_find_set. (utf-find-set-string utf-string integer string) Implements al_ustr_find_set_cstr. (utf-find-cset utf-string integer utf-string) Implements al_ustr_find_cset. (utf-find-cset-string utf-string integer string) Implements al_ustr_find_set_cstr. (utf-rfind utf-string integer utf-string) Implements al_ustr_rfind_str. (utf-rfind-char utf-string integer (integer char)) Implements al_ustr_rfind_char. (utf-rfind-string utf-string integer string) Implements al_ustr_rfind_cstr. (utf-find&replace! utf-string integer utf-string utf-string) Implements al_ustr_find_replace. (utf-find&replace-string! utf-string integer string string) Implements al_ustr_find_replace_cstr. (utf-equal? utf-string utf-string) Implements al_ustr_equal. (utf-compare utf-string utf-string) Implements al_ustr_compare. (utf-ncompare utf-string utf-string integer) Implements al_ustr_ncompare. (utf-prefix? utf-string utf-string) Implements al_ustr_has_prefix. (utf-prefix-string? utf-string string) Implements al_ustr_has_prefix_cstr. (utf-suffix? utf-string utf-string) Implements al_ustr_has_prefix. (utf-suffix-string? utf-string string) Implements al_ustr_has_suffix_cstr. (utf8-width integer32) Implements al_utf8_width. (utf8-encode! blob integer32) Implements al_utf8_encode. (utf-string-utf16-size utf-string) Implements al_ustr_size_utf16. (utf-string-utf16-encode utf-string blob integer) Implements al_ustr_encode_utf16. (utf16-width integer) Implements al_utf16_width. (utf16-encode u16vector integer32) Implements al_utf16_encode. === Windows (windows-window-handle) Implements al_get_win_window_handle. == License Copyright 2012 Daniel J. Leslie. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY DANIEL J. LESLIE ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DANIEL J. LESLIE OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The views and conclusions contained in the software and documentation are those of the authors and should not be interpreted as representing official policies, either expressed or implied, of Daniel J. Leslie.