Changelog
18.2.0 (next release)
- bn::
regular_bg_ptr, bn:: regular_bg_builder, bn:: affine_bg_ptr, bn:: affine_bg_builder, bn:: affine_bg_mat_attributes, bn:: sprite_ptr and bn:: sprite_builder support top-left coordinates for their position. - bn::
regular_bg_top_left_move_to_action, bn:: regular_bg_top_left_move_loop_action, bn:: regular_bg_top_left_move_toggle_action, bn:: affine_bg_top_left_move_to_action, bn:: affine_bg_top_left_move_loop_action, bn:: affine_bg_top_left_move_toggle_action, bn:: sprite_top_left_move_to_action, bn:: sprite_top_left_move_loop_action and bn:: sprite_top_left_move_toggle_action added. - bn::
safe_degrees_angle, bn:: degrees_lut_sin_safe, bn:: degrees_lut_cos_safe and bn:: degrees_lut_sin_and_cos_safe added. - bn::
affine_mat_attributes:: set_rotation_angle_safe, bn:: affine_bg_builder:: set_rotation_angle_safe, bn:: affine_bg_mat_attributes:: set_rotation_angle_safe, bn:: affine_bg_ptr:: set_rotation_angle_safe, bn:: sprite_affine_mat_ptr:: set_rotation_angle_safe, bn:: sprite_builder:: set_rotation_angle_safe and bn:: sprite_ptr:: set_rotation_angle_safe added. - Position in
create
methods is now optional. - Why background coordinates are relative to the center of the screen, instead of to its top-left corner? and Why sprite coordinates are relative to the center of the screen, instead of to its top-left corner? questions added to the Frequently asked questions (FAQ) page.
- Why my game runs fine on emulators but doesn't work on a real GBA with a flash cart? question improved.
18.1.0
- bn::
blending:: set_transparency_and_intensity_alpha added. - bn::
timer:: elapsed_ticks_with_restart added. - bn::
timers:: ticks_per_second added. - BN_
CFG_ TIMER_ FREQUENCY added. - bn::
timer overflow fixed. - bn::
degrees_lut_sin, bn:: degrees_lut_cos and bn:: degrees_lut_sin_and_cos optimized. - Color palettes, sprite tiles and audio management ROM usage reduced.
timer
example added.- Is there a way to get the bn::
sprite_item used to create a bn:: sprite_ptr? question added to the Frequently asked questions (FAQ) page. - GBA pseudo-3D demo added to
README.md
.
18.0.1
Tools no longer crash on Windows with more than 60 logical CPU cores.
18.0.0
- Language standard updated to C++23.
- Old bn::
hdma:: start and bn:: hdma:: high_priority_start API deprecated. BN_UNREACHABLE
deprecated.- Construction of bn::
string and bn:: string_view from nullptr
is disallowed (thanks C++23). - bn::
string:: starts_with, bn:: string:: ends_with, bn:: string_view:: starts_with and bn:: string_view:: ends_with a nullptr
char array is disallowed. - bn::
unique_ptr is now constexpr
. - bn::
bitset and bn:: string aren't constexpr
anymore (it didn't work before). - More overloads added to bn::
string construction, assignment, bn:: string:: assign and bn:: string:: append. - bn::
string:: find and bn:: string_view:: find added. - bn::
string:: contains and bn:: string_view:: contains added. - bn::
string:: substr added. - bn::
string_view:: ends_with a char array added. nullptr
constructor and method overloads added to bn::unique_ptr. - Non-throwing
new
anddelete
supported. - bn::
string_view:: remove_prefix and bn:: string_view:: remove_suffix assert fixed. bn::is_constant_evaluated
replaced withconsteval
.- Unnecessary
operator!=
implementations removed. - bn::
regular_bg_builder:: release_map, bn:: affine_bg_builder:: release_map, bn:: sprite_builder:: release_tiles and bn:: sprite_builder:: release_palette ROM usage reduced. - bn::
deque iterators order operators optimized.
17.9.0
- bn::
hdma:: start and bn:: hdma:: high_priority_start API improved. - Some assert messages improved.
- Missing header includes added.
hdma_palette
example added.- Dead links updated.
- New games made with Butano added to
README.md
.
17.8.1
- bn::
deque:: erase fixed (thanks copyrat90!). - Would I be able to sell my game made with Butano for money? question improved.
17.8.0
- H-Blank effects stop fixed.
random
example added.log
example improved.- No$gba exception setup guide added.
- How can I know what code makes my game crash? question added to the Frequently asked questions (FAQ) page.
- BN_
LOG_ BACKEND_ MGBA also works with Mesen. - bn::
sram documentation improved. - Regular backgrounds and Affine backgrounds import guides improved.
17.7.0
- bn::
bg_palette_ptr:: set_color and bn:: sprite_palette_ptr:: set_color added. - Empty bn::
utf8_characters_map and bn:: utf8_characters_map_ref allowed.
17.6.0
- bn::
bg_palette_ptr:: rotate_range_start, bn:: bg_palette_ptr:: rotate_range_size and bn:: bg_palette_ptr:: set_rotate_range added. - bn::
sprite_palette_ptr:: rotate_range_start, bn:: sprite_palette_ptr:: rotate_range_size and bn:: sprite_palette_ptr:: set_rotate_range added. - bn::
fixed:: modulo added. - bn::
memory:: fast_ewram added. - bn::
random:: get_unbiased_int, bn:: random:: get_unbiased_fixed, bn:: seed_random:: get_unbiased_int and bn:: seed_random:: get_unbiased_fixed added (thanks alope107!). - H-Blank effects management optimized.
- BN_
EWRAM_ WAIT_ STATE_ 1 crash after boot documented. - Slow EWRAM test added.
- IWRAM vs EWRAM stack tests added to the
profiler
coroutine test. - Slow game pak test improved.
- GCC14 false build warnings in Butano Fighter fixed.
17.5.0
- bn::
memory:: dma_enabled and bn:: memory:: set_dma_enabled added. - bn::
fixed explicit conversion operators added. - Custom C++ flags can be specified in the project's
Makefile
. - All logging functions and methods can be called with logging disabled.
- Current gba-link-connection implementation has been moved to a private namespace to allow using other implementations.
- Spelling mistakes corrected.
- Background z order documentation improved.
- GBA Wav to S3m Converter added to the Frequently asked questions (FAQ) page.
17.4.0
- bn::
blending:: set_black_fade_color and bn:: blending:: set_white_fade_color added. - bn::
fixed friend
operators allow different levels of precision. - bn::
list and bn:: forward_list unnecessary asserts removed. - VRAM related error messages shortened.
profiler
coroutine test improved.- BIOS calls can be disabled in the
profiler
test. - Why can't I use some standard functions and classes? question added to the Frequently asked questions (FAQ) page.
- Why I run out of memory so often? question improved.
- Demons of Asteborg DX added to
README.md
.
17.3.0
- bn::
core:: current_cpu_ticks, bn:: core:: last_cpu_ticks and bn:: core:: last_vblank_ticks added. - Import tool now allows to exclude Huffman when choosing the best compression for images. See the Images import guide to learn how to exclude it.
- LZ77 decompression optimized (thanks Lorenzooone!).
- bn::
core:: current_cpu_usage and bn:: core:: last_vblank_usage with skip frames fixed. - Coroutine added to the
profiler
test.
17.2.0
- bn::
core:: log_stacktrace added. Check the log
example to see how to log the current stack trace. - bn::
isprite_animate_action:: next_change_updates, bn:: isprite_cached_animate_action:: next_change_updates, bn:: iregular_bg_animate_action:: next_change_updates, bn:: iregular_bg_cached_animate_action:: next_change_updates, bn:: iaffine_bg_animate_action:: next_change_updates and bn:: iaffine_bg_cached_animate_action:: next_change_updates added. bn::pair
is now astd::pair
alias.- Tonclib ASM ROM usage reduced.
profiler
example simplified.- Compression algorithms added to the
profiler
test. - What function or method call is the source of an error message? question added to the Frequently asked questions (FAQ) page.
- Why changing the color palette of an 8BPP sprite or background doesn't work? question added to the Frequently asked questions (FAQ) page.
- Does hiding a sprite make it count towards the total number of allowed sprites? and Does hiding a background make it count towards the total number of allowed backgrounds? questions added to the Frequently asked questions (FAQ) page.
- Getting started guide improved.
- Why I run out of memory so often? question improved.
- Wavefront To Varooom 3D added to
README.md
.
17.1.1
bn::
17.1.0
- Affine big maps canvas size can be specified by the user: bn::
affine_bg_big_map_canvas_size, bn:: bg_maps:: new_affine_big_map_canvas_size, bn:: bg_maps:: set_new_affine_big_map_canvas_size and bn:: affine_bg_map_ptr:: big_canvas_size added. - Regular big maps canvas height increased.
- Force at least one update before sleeping in bn::
core:: sleep. - bn::
span:: size_bytes implicit conversion warning fixed. - Wonderful Toolchain binary files build time reduced.
- Scale can be changed in the
world_map
example.
17.0.0
- Regular and affine backgrounds allow to specify if they are part of the blending bottom layer or not. See the
blending
example to learn how to do it. - bn::
sprites:: blending_bottom_enabled and bn:: sprites:: set_blending_bottom_enabled added. - bn::
backdrop functions and actions added. - bn::
backdrop_color_hbe_ptr added. - bn::
fixed_point_t, bn:: fixed_size_t, bn:: fixed_rect_t and bn:: top_left_fixed_rect_t added. - Collision methods added to bn::
rect, bn:: fixed_rect, bn:: top_left_rect and bn:: top_left_fixed_rect. __FILE_NAME__
macro is no longer required.- Toolchain detection fixed.
- Build time reduced.
16.6.0
- bn::
sprites:: visible and bn:: sprites:: set_visible added. - bn::
sprites actions added. - Initial transparent color of the backgrounds can be specified in bn::
core:: init. - bn::
date year range not longer limited to [0..99]. - bn::
color_effect:: grayscale, bn:: color_effect:: blend and bn:: color_effect:: fade require 4-byte aligned color references with an even number of colors. - Uncompressed backgrounds commit CPU usage reduced.
- Memory copy speed tests added to the
profiler
example.
16.5.0
- Big maps allow wrapping (they can now be moved beyond their boundaries).
- Stack trace logging on error messages can be enabled with the
STACKTRACE
makefile variable. - Stack trace demangle can be enabled with BN_
CFG_ ASSERT_ STACKTRACE_ DEMANGLE. - bn::
memory:: used_rom added. - Import tool can now generate palettes for regular and affine background tiles. See the Regular background tiles and the Affine background tiles import guides to learn how to generate them.
GRAPHICS
,AUDIO
andDMGAUDIO
makefile variables accept file and folder paths.bn::audio::dmg_sync_enabled
andbn::audio::set_dmg_sync_enabled
removed as they don't work properly.- bn::
time:: current 12-hour mode support. - agbabi updated to 2.1.6.
- Old documentation header restored.
dynamic_regular_bg
example shows how to deal with multiple palette ids.- Tiles offset disabled in
dynamic_regular_bg
anddynamic_affine_bg
examples.
16.4.0
- Wonderful Toolchain experimental support! See the Getting started with Wonderful Toolchain guide to learn how to build Butano games with it.
- Real time clock (RTC) support thanks to agbabi. See bn::
date, bn:: time and the date_time
example to learn how to deal with the RTC. - bn::
core:: hard_reset added. - bn::
isprite_animate_action:: current_graphics_index and bn:: isprite_cached_animate_action:: current_tiles added. - agbabi memory routines IWRAM usage reduced.
- Rumble management CPU usage reduced.
memcmp
optimized.- Hardware access ROM usage reduced.
- Error messages crash fixed.
- Error messages with HDMA enabled have been fixed too.
16.3.0
- bn::
music:: stop, bn:: dmg_music:: stop, bn:: sound_handle:: stop and bn:: sound_handle:: release can be called without triggering an assert if the music/sound in question isn't playing. - Target
*.gba
file is rebuilt when the target*.elf
file isn't present. - Sprite affine mats management CPU usage reduced.
- Sound handles management CPU usage reduced.
- Backgrounds management CPU usage reduced.
- bn::
unordered_map:: erase and bn:: unordered_set:: erase fixed.
16.2.0
- bn::
dmg_music:: master_volume and bn:: dmg_music:: set_master_volume added. - bn::
color_effect:: blend added. - Sprite affine mats management CPU usage reduced.
- bn::
jingle:: play link error fixed.
16.1.0
- Sprite affine mats management CPU usage reduced.
- Music ending detection fixed.
16.0.0
- bn::
sound_handle and sound handle actions added. See the audio
example to learn how to stop, release and setup sound effects with them. - bn::
jingle and jingle actions added. - Audio commands generation optimized.
- Music ending detection fixed.
- Create new tiles methods deprecated.
15.9.0
- Same maps with different tiles or palettes supported.
- Some clangd and Clang-Tidy warnings fixed.
15.8.2
- bn::
unordered_map:: clear and bn:: unordered_set:: clear fixed. - Backgrounds and color palettes modules documentation fixed.
15.8.1
bn::
15.8.0
- Color-related H-Blank effects cleanup fixed.
- Getting started page improved.
- Why I run out of memory so often? question improved.
15.7.1
Python 2 support restored.
15.7.0
- bn::
blending:: restore added. - bn::
window:: restore added.
15.6.0
- bn::
display:: size added. - Standard abort implemented.
- Color-related H-Blank effects update fixed.
15.5.0
- bn::
assert:: callback and bn:: assert:: set_callback added. BN_DATA_EWRAM_BSS
added.- bn::
memory:: used_static_ewram fixed. - Butano subsystems ROM usage reduced.
- Tonclib tiled surface functions added.
- Unused Tonclib functions and data removed.
15.4.1
bn::
15.4.0
- bn::
dmg_music now supports VGM audio files with *.vgm
extension thanks to VGM player. See the DMG music import guide and thedmg_audio
example to learn how to import and play it. - Import tool now allows to specify whether regular and affine backgrounds are big or not. See the Regular backgrounds and the Affine backgrounds import guides to learn how to specify it.
- bn::
regular_bg_map_item:: flat_layout added. - Why everything looks weird when I show two or more sprites with more than 16 colors? and Why everything looks weird when I show two or more backgrounds with more than 16 colors? questions added to the Frequently asked questions (FAQ) page.
- Why I get an "invalid header size" error when I try to import a *.bmp file? question added to the Frequently asked questions (FAQ) page.
- Images import guide improved.
15.3.2
BG blocks commit fixed.
15.3.1
Slow game pak detection fixed (again).
15.3.0
- bn::
top_left_rect and bn:: top_left_fixed_rect added. - bn::
core:: init waits for V-Blank before initializing all Butano subsystems. - Slow game pak detection fixed.
- bn::
rect issues with odd dimensions documented.
15.2.0
- bn::
seed_random added. - Standard assert implemented.
- Thread-safe initialization of local statics disabled.
- Static destructors fixed.
- Maps commit optimized by more than 35% in some cases.
- Palette search optimized by more than 25% in some cases.
- Big maps commit optimized.
- Display setup commit optimized.
- BG blocks and sprite tiles managers ROM usage reduced.
map_collision
example added.
15.1.0
memcmp
optimized.- Link flags fixed.
15.0.0
- newlib dependency removed.
- Standard system libraries linking can be specified in the project's
Makefile
. - bn::
utf8_character:: size for ASCII characters fixed. - More questions added to Frequently asked questions (FAQ) page.
- Frequently asked questions (FAQ) page improved.
14.1.0
14.0.0
- bn::
regular_bg_map_item and bn:: affine_bg_map_item can reference multiple maps per item. - Regular and affine backgrounds import support multiple maps per image thanks to the optional
height
field. - bn::
regular_bg_animate_action and bn:: regular_bg_cached_animate_action added. - bn::
affine_bg_animate_action and bn:: affine_bg_cached_animate_action added. - bn::
pool of trivially destructible types can be destroyed without being empty. - bn::
list and bn:: forward_list destructors fixed and optimized for trivially destructible types. - Deprecated methods removed.
13.18.0
- Sprites and sprite tiles
height
field is now optional. - Standard containers ROM usage reduced.
- bn::
unordered_map:: clear and bn:: unordered_set:: clear optimized. - bn::
best_fit_allocator missing header files included. - BN_
CFG_ LOG_ BACKEND documentation fixed.
13.17.0
- bn::
blending:: set_transparency_alpha and bn:: blending:: set_intensity_alpha fixed. - Tools multiprocessing pools are now closed properly.
- More questions added to Frequently asked questions (FAQ) page.
13.16.1
bn::
13.16.0
- bn::
sound:: master_volume and bn:: sound:: set_master_volume added. - Sound master volume actions added.
- bn::
sprite_shape_size constructor from width and height added. - Maximum number of sprites per scanline increased.
- bn::
timer:: elapsed_ticks accuracy improved. - Display management optimized.
- bn::
ibitset equality operators fixed. - BN_
LOG_ BACKEND_ MGBA also works with NanoBoyAdvance. - Getting started page improved.
- More questions added to Frequently asked questions (FAQ) page.
13.15.0
- Brightness, contrast and intensity color effects optimized.
- bn::
random internal variables are protected
to allow child classes to access them. compile_commands.json
generation support.
13.14.0
- Hash support for bn::
type_id_t added. - Custom build base rules updated.
- Keypad logger startup fixed.
- Redundant move in bn::
affine_bg_mat_attributes_hbe_ptr:: create_optional removed. - Parallel link-time optimization documentation updated.
13.13.0
- bn::
optional:: value_type added. - H-Blank effects management optimized (ROM and EWRAM usage reduced).
- bn::
affine_bg_blending_toggle_action base class inheritance fixed. - bn::
regular_bg_map_cell_info size reduced. - bn::
optional build time reduced.
13.12.1
Tonclib linking error fixed.
13.12.0
- bn::
sprite_ptr:: set_affine_mat optimized. - bn::
intrusive_forward_list:: front fixed. - Flickering in
world_map
example fixed.
13.11.0
- agbabi updated to 2.1.3.
- bn::
core:: current_cpu_usage, bn:: core:: last_cpu_usage and bn:: core:: last_vblank_usage accuracy improved. - Frequently asked questions (FAQ) page improved.
13.10.1
-flto
memset
undefined references fixed.
13.10.0
memset
moved to IWRAM.- Backdrop fade blending fixed.
13.9.0
- bn::
unsafe_sqrt added. memset
fixed.- Sips added to
README.md
. - Frequently asked questions (FAQ) page improved.
13.8.1
bn::
13.8.0
- bn::
any construction and assignment from references to non constant values fixed. - Frequently asked questions (FAQ) page improved.
13.7.0
- bn::
igeneric_pool:: contains added. - bn::
generic_pool:: create invalid element size fixed.
13.6.0
- bn::
memory:: copy and bn:: memory:: clear optimized. - bn::
array_hash fixed.
13.5.0
- bn::
music:: tempo and bn:: music:: set_tempo added. - bn::
music:: pitch and bn:: music:: set_pitch added. - bn::
music_tempo_to_action, bn:: music_tempo_loop_action and bn:: music_tempo_toggle_action added. - bn::
music_pitch_to_action, bn:: music_pitch_loop_action and bn:: music_pitch_toggle_action added. - DMG music import options added. See the DMG music import guide to learn how to specify them.
- Empty bn::
array allowed. - bn::
hash enums support. - Sprites management IWRAM usage reduced.
- bn::
array_hash optimized.
13.4.0
- BN_
BASIC_ ASSERT added. - Repeated color palettes reduction can be disabled when importing a regular background. See the Regular backgrounds import guide to learn how to disable it.
- Unaligned byte
memset
fixed. - Asserts without diagnostic information ROM usage reduced.
- Input tiles in
dynamic_regular_bg
anddynamic_affine_bg
examples are imported without using a map. - Frequently asked questions (FAQ) page improved.
13.3.1
bn::
13.3.0
- BN_
CONST added. - bn::
sqrt, bn:: atan2 and bn:: degrees_atan2 marked as BN_ CONST. - Linking with too many object files fixed.
13.2.0
- bn::
sram:: read_span, bn:: sram:: read_span_offset, bn:: sram:: write_span and bn:: sram:: write_span_offset added. - bn::
core:: last_missed_frames added. - bn::
core:: set_skip_frames accuracy improved. - Wait for V-Blank improved.
- Disabled asserts indicate the compiler that if the condition is false the code is unreachable.
- bn::
blending_transparency_attributes missing header inclusions fixed. - SRAM is cleared when formatting in the
sram
example.
13.1.1
Recovery of deleted background maps fixed.
13.1.0
- bn::
isprite_animate_action and bn:: isprite_cached_animate_action added. - bn::
list:: remove, bn:: list:: remove_if, bn:: forward_list:: remove, bn:: forward_list:: remove_if, bn:: intrusive_list:: remove, bn:: intrusive_list:: remove_if, bn:: intrusive_forward_list:: remove and bn:: intrusive_forward_list:: remove_if added. - Hash support for bn::
istring and bn:: string added. - bn::
best_fit_allocator (used by the heap manager) CPU usage reduced. - bn::
best_fit_allocator sanity check can be enabled with BN_ CFG_ BEST_ FIT_ ALLOCATOR_ SANITY_ CHECK_ ENABLED. - bn::
best_fit_allocator:: free calls can be validated with BN_ CFG_ BEST_ FIT_ ALLOCATOR_ FREE_ CHECK_ ENABLED. - Tonclib unused components removed (EWRAM and ROM usage reduced).
- bn::
best_fit_allocator:: realloc can shrink allocations. - BPP mode can be specified when importing sprites and sprite palettes. See the Images import guide to learn how to specify it.
- Colors count can be specified when importing sprites, sprite tiles, sprite palettes, regular backgrounds and affine backgrounds. See the Images import guide to learn how to specify them.
- BMP files are validated when importing background tiles.
- Flipped tiles reduction disabled in
dynamic_regular_bg
example. - gbadev forums added to
README.md
.
13.0.0
- (Breaking change) bn::
best_fit_allocator (used by the heap manager) supports unlimited allocations. - bn::
best_fit_allocator:: log_status and bn:: memory:: log_alloc_ewram_status added. - New games made with Butano added to
README.md
.
12.5.0
12.4.0
- SRAM magic string fixed.
BN_CODE_IWRAM
macro can be used for thumb code too.- Destructors of classes with
_ptr
suffix ROM usage reduced. - 4BPP regular backgrounds quantization improved.
- Some error messages improved.
- Import images guide explains why Usenti is recommended over other image editors.
12.3.0
- bn::
sprite_text_generator variable width fonts rendering fixed and optimized. - Sprite shape and size update ROM usage reduced.
- Some Cppcheck warnings removed.
12.2.0
- Automatic sprite double size detection fixed.
- Sprite tiles management optimized (EWRAM and CPU usage reduced).
- Background tiles and maps management optimized (EWRAM and CPU usage reduced).
- Color palettes management CPU usage reduced.
- Sprites and sprite affine mats management CPU usage reduced.
- Backgrounds management CPU usage reduced.
- Cameras management CPU usage reduced.
12.1.0
- Sprite tiles delayed commit fixed.
- V-Blank interrupt management optimized (EWRAM and CPU usage reduced).
- Missed link messages frequency reduced.
- bn::
timer:: elapsed_ticks optimized.
12.0.0
- (Breaking change) bn::
aligned fixed. - Color effects optimized.
11.0.1
bn::
11.0.0
Huffman images compression support (make sure to update devkitARM before using it).
10.7.0
- bn::
unique_ptr move constructor, move assignment operator and bn:: unique_ptr:: reset allow to manage pointers and deleters with different type. - bn::
unique_ptr documentation improved. - More questions added to Frequently asked questions (FAQ) page.
- Frequently asked questions (FAQ) page improved.
10.6.1
bn::
10.6.0
- bn::
sprite_animate_action:: set_wait_updates and bn:: sprite_cached_animate_action:: set_wait_updates added. - bn::
sprite_animate_action:: reset and bn:: sprite_cached_animate_action:: reset added. - Backgrounds management optimized (EWRAM and CPU usage reduced).
- Sprites, sprite tiles, palettes and HDMA commit CPU usage reduced.
- Missed link messages frequency reduced.
- mGBA logging CPU usage reduced.
- Keypad logging EWRAM and maximum CPU usage reduced.
- CPU usage profiler entries removed.
- Some assert messages improved.
10.5.0
- bn::
core:: vblank_callback and bn:: core:: set_vblank_callback added. - bn::
random:: update added. - H-Blank effects input data validation fixed.
10.4.0
- Avoid data decompression in V-Blank if possible.
- Audio updates can no longer be interrupted.
10.3.0
- bn::
bg_tiles:: allow_offset and bn:: bg_tiles:: set_allow_offset added. - Import tool can now generate regular and affine background tiles without maps or palettes. See the Regular background tiles and the Affine background tiles import guides to learn how to import them.
- BPP mode can be specified when importing sprite tiles. See the Sprite tiles import guide to learn how to specify it.
- Audio updates can be interrupted.
- SRAM reads and writes optimized.
- BG blocks manager ROM usage reduced.
- agbabi memory routines updated.
- Missing
__FILE_NAME__
macro check added. - Missing license files added.
10.2.0
- bn::
core_lock added. - bn::
reciprocal_16_lut added. - Memory operations like
memcpy
andmemset
optimized thanks to agbabi. - bn::
affine_mat_attributes scale setup optimized (CPU and ROM usage reduced). - bn::
atan2 and bn:: degrees_atan2 optimized thanks to agbabi. - Unused interrupts removed from the interrupt manager.
- More questions added to Frequently asked questions (FAQ) page.
10.1.0
- bn::audio::dmg_sync_enabled and bn::audio::set_dmg_sync_enabled added.
- Custom assembler flags can be specified in the project's
Makefile
. - GBT Player updated to 4.4.1.
- bn::
fixed, bn:: optional, bn:: string_view and bn:: span are no longer forward declared in the public API. - Text color in assert and profile screens improved.
- Audio volume setup optimized.
- Clouds restored in
world_map
example.
10.0.0
- Custom linker flags can be specified in the project's
Makefile
. - Asserts ROM usage reduced.
- Audio startup fixed when link-time optimization is enabled.
- Audio stop fixed when link communication is active.
- Parallel link-time optimization temporal files ignored and added to the list of files to clean.
9.5.0
- bn::
dmg_music:: left_volume, bn:: dmg_music:: right_volume, bn:: dmg_music:: set_left_volume, bn:: dmg_music:: set_right_volume and bn:: dmg_music:: set_volume added. - bn::
dmg_music:: position and bn:: dmg_music:: set_position added. - bn::
dmg_music_volume_to_action, bn:: dmg_music_volume_loop_action and bn:: dmg_music_volume_toggle_action added. - bn::
link_state:: player_count added. - An external
mod2gbt
executable is no longer necessary for importing DMG music with*.mod
extension. - GBT Player updated to 4.4.0.
- New interrupt manager implemented by Universal GBA Library.
- Audio commands list management optimized (ROM, EWRAM and CPU usage reduced).
- Missed link messages frequency reduced.
- Link data sending race condition fixed.
- Link race condition on V-Blank fixed.
- Audio pause/resume No$gba error removed.
- Palette rotate range documentation fixed.
- Frequently asked questions (FAQ) page improved.
9.4.1
BMP files colors count calculation fixed (again).
9.4.0
- bn::
dmg_music and bn:: dmg_music_item added (yes, music playback using DMG channels is now supported thanks to GBT Player). See the DMG music import guide and the dmg_audio
example to learn how to import and play it. - BMP files colors count calculation fixed.
- C++ keywords are not valid asset names anymore.
- Getting started Python setup improved.
- Tremblay Island added to
README.md
.
9.3.0
- bn::
sram:: clear and bn:: sram:: set_bytes added. - bn::
music:: playing_item added. - SRAM code moved back from ROM to EWRAM again, since it doesn't seem to crash No$gba anymore.
- bn::
power_of_two optimized. - Keypad with frame skipping fixed.
9.2.0
- bn::
regular_bg_ptr:: hw_id and bn:: affine_bg_ptr:: hw_id added. - bn::
sin_and_cos, bn:: degrees_sin_and_cos, bn:: lut_sin_and_cos and bn:: degrees_lut_sin_and_cos added. - More bn::
regular_bg_ptr and bn:: affine_bg_ptr static contructors added. - bn::
regular_bg_map_item:: cells_ptr and bn:: affine_bg_map_item:: cells_ptr added. - bn::
affine_mat_attributes rotation angle processing optimized. - bn::
unordered_map and bn:: unordered_set lack of pointer stability documented.
9.1.1
bn::
9.1.0
- bn::
system_font, bn:: core:: system_font and bn:: core:: set_system_font added. - bn::
core:: assert_tag and bn:: core:: set_assert_tag added. - BN_
VERSION_ STRING added. - bn::
rect_window:: restore_boundaries added. - bn::
window:: set_show_all and bn:: window:: set_show_nothing fixed. - bn::
utf8_characters_map_ref:: index assert shows UTF8-character data. - gba-free-fonts added to
README.md
.
9.0.0
- bn::
utf8_characters_map and bn:: utf8_characters_map_ref added: they allow to build an UTF-8 characters map in ROM, without size limit. - (Breaking change) bn::
sprite_font now manages a bn:: utf8_characters_map_ref instead of a span of UTF-8 characters. - (Breaking change)
BN_CFG_SPRITE_TEXT_MAX_UTF8_CHARACTERS
removed. - bn::
blending_transparency_attributes:: set_transparency_and_intensity_alphas added. - More questions added to Frequently asked questions (FAQ) page.
8.10.0
- Huffman decompression support added.
- bn::
best_fit_allocator added. - bn::
istring:: resize and bn:: istring:: shrink added. - bn::
string and bn:: string_view compatibility improved. - bn::
string construction, assignment and append optimized. - Integer to string conversion optimized.
- Slot index added to palettes manager status log.
- bn::
calloc and bn:: memory:: ewram_calloc interface fixed. .elf
files No$gba support restored.-O0
builds support restored.- More questions added to Frequently asked questions (FAQ) page.
8.9.0
- Hue shift palette effect added. See the
palettes
example to learn how to use it. - Brightness effect ROM usage reduced.
- bn::
sprite_item and bn:: sprite_tiles_item size reduced. - Automatic sprite double size detection fixed.
- bn::hbe_visible_toggle_action removed, since it was not possible to use it.
- Clang build fixes.
- Clang-Tidy warnings fixed.
- New games made with Butano added to
README.md
.
8.8.0
- Modified assets detection optimized.
- Audio and graphics tools unified in order to reduce build time.
- bn::newton_raphson_sqrt removed, since it doesn't work for bn::
fixed input values.
8.7.0
- An external bn::
bg_palette_item can be specified when importing regular and affine backgrounds. - Colors count can be specified when importing sprite and background palettes.
- Standard containers equality comparison optimized.
- Asserts file name hack fixed.
- Universal GBA Library LGPL license files removed.
- Standard containers documentation improved.
- Frequently asked questions (FAQ) page improved.
8.6.0
- bn::
random:: get_int and bn:: random:: get_fixed added. - bn::
calloc, bn:: realloc, bn:: memory:: ewram_calloc and bn:: memory:: ewram_realloc added. - bn::
unique_ptr moved to its own header file. - bn::
pool and bn:: generic_pool ROM usage reduced. - Automatic 4BPP regular backgrounds generation fixed.
- Asserts disabled build warnings fixed.
- Frequently asked questions (FAQ) page improved.
8.5.0
- bn::
optional:: get added. - bn::
bitset and bn:: bitset_ref optimized (managed bits count now must be a multiple of 8). - ROM usage reduced due to unnecessary internal asserts removed.
- Blending hardware weights fixed.
- bn::
regular_bg_map_cell_info documentation fixed.
8.4.0
- bn::
bitset_ref added. - bn::
diamond_angle and bn:: degrees_diamond_angle added. - Asserts ROM usage reduced.
- Unnecessary
inline
keyword usages removed.
8.3.0
- Maps commit optimized by more than 50% in some cases.
- Integer alignment at minimum enforced in all containers.
- BG blocks manager and sprite tiles manager commit fixed.
8.2.0
- (Security issue) Source code files full path is not stored in output ROMs anymore.
- Some Clang-Tidy and Cppcheck warnings removed.
8.1.0
- bn::
color_effect added. - bn::
memory:: decompress added. - All
uncompress
methods renamed todecompress
. - All color effects optimized.
- Palettes update and search optimized.
- Getting started page improved.
8.0.0
- Blending transparency weights can be setup separately with bn::
blending:: set_transparency_top_weight and bn:: blending:: set_transparency_bottom_weight. - (Breaking change) bn::
blending_transparency_attributes interface has changed to allow to setup transparency weights separately. - Actions for blending transparency weights added.
- Internal graphics suffix changed from
bn_graphics
tobn_gfx
. Remember to rebuild your project after updating. - Frequently asked questions (FAQ) page improved.
7.8.0
- Generic slow game pak detection replaces SuperCard SD specific one.
- BN_
GAME_ PAK_ WAIT_ STATE_ FIRST_ AUTO and BN_ GAME_ PAK_ WAIT_ STATE_ SECOND_ AUTO enabled by default. - Affine matrices update optimized.
- Tiles and maps managers optimized.
- Background windows optimized.
- bn::
audio:: update_on_vblank and bn:: audio:: set_update_on_vblank documentation improved. - Frequently asked questions (FAQ) page improved.
7.7.0
- bn::
audio:: update_on_vblank and bn:: audio:: set_update_on_vblank added. - Sprite tiles update and commit optimized.
- Background tiles and maps update and commit optimized.
- Big maps commit optimized.
- Asserts ROM usage reduced.
- H-Blank effects ROM usage reduced.
- bn::
sprite_text_generator ROM usage reduced.
7.6.0
- Display and audio hardware commit optimized.
- bn::
unique_ptr size reduced. - bn::
regular_bg_ptr:: set_item and bn:: affine_bg_ptr:: set_item fixed. - Frequently asked questions (FAQ) page improved.
- Licenses section improved.
7.5.1
Audio and HDMA issues when updating at less than 60FPS fixed.
7.5.0
- bn::
sprites:: reserved_handles_count and bn:: sprites:: set_reserved_handles_count added. - BN_
CFG_ PROFILER_ LOG_ ENGINE_ DETAILED added. - Sprites and backgrounds decompression optimized thanks to Cult-of-GBA BIOS.
- Sprites and backgrounds hardware setup optimized.
- Sprites automatic double size mode optimized.
- Affine sprites hiding fixed.
7.4.0
- Run-length is preferred to LZ77 when choosing best compression mode.
- Sprites automatic double size mode and affine matrix management fixed.
- Frequently asked questions (FAQ) page improved.
7.3.0
- bn::
sprite_text_generator can now plot multiple 16x16 variable width characters in a single sprite. - bn::
sprite_text_generator IWRAM usage reduced. - Third party libraries to link can be specified in the project's
Makefile
. - Project's
Makefile
allows to build source files generated with an external tool. See theexternal_tool
example to learn how to do it. butano-audio-tool.py
generates a list of all available music and sound items with their name.audio_player
example added.- Varooom 3D improved (check its
readme.txt
file for details).
7.2.0
- bn::
regular_bg_map_cell_info and bn:: affine_bg_map_cell_info added. - bn::
regular_bg_map_item:: cell_index and bn:: regular_bg_map_item:: cell added. - bn::
affine_bg_map_item:: cell_index and bn:: affine_bg_map_item:: cell added. - Maps commit optimized by more than 200% in some cases.
dynamic_regular_bg
example added.dynamic_bg
example renamed todynamic_affine_bg
and improved.
7.1.1
bn::
7.1.0
- HDMA commit fixed.
- Frequently asked questions (FAQ) page improved.
- Games made with Butano added to
README.md
.
7.0.1
bn::
7.0.0
- Varooom 3D source code and assets added.
- Maximum number of active H-Blank effects reduced to 6.
- Common files moved to
common
namespace.
6.18.0
- Generated items are now
constexpr inline
to avoid being copied to every translation unit. - Sprites EWRAM usage reduced.
- Different type backgrounds sorting fixed.
6.17.1
- bn::sort with 128bit sort keys fixed.
- IRQs setup during startup improved.
6.17.0
- bn::
memory:: used_stack_iwram added. - bn::sort optimized.
- VRAM allocation error messages improved.
- bn::
optional:: emplace copy avoided. - Importing assets guide improved.
- More questions added to Frequently asked questions (FAQ) page.
6.16.0
- bn::
sin_lut is not copied to every translation unit. - bn::
reciprocal_lut is not copied to every translation unit. - GBA keypad is read after playing all keypad commands.
- bn::
degrees_lut_cos assert added.
6.15.0
- bn::
rect:: top_right, bn:: rect:: bottom_left, bn:: fixed_rect:: top_right and bn:: fixed_rect:: bottom_left added. - GPIO register is not setup unless needed (avoids mGBA warning at startup).
- SRAM code moved from EWRAM to ROM in order to avoid a No$gba error.
- bn::
abs for unsigned arguments improved. *.elfbin
output files renamed to*.elf
as it should.- bn::
unordered_map:: erase and bn:: unordered_set:: erase fixed.
6.14.0
- Asserts ROM usage reduced.
- bn::
deque:: push_front, bn:: deque:: emplace_front and bn:: deque:: insert fixed.
6.13.1
- bn::
to_array fixed. - bn::
sprite_text_generator documentation fixed.
6.13.0
- EWRAM wait states count can be specified with BN_
CFG_ EWRAM_ WAIT_ STATE. - bn::
fixed_t:: floor_integer and bn:: fixed_t:: ceil_integer added. - bn::
keypad:: any_held, bn:: keypad:: any_pressed and bn:: keypad:: any_released added. - Unnecessary GPIO register writes avoided.
- bn::
type_id marked as constexpr
. - Background move actions fixed.
constexpr const
replaced withconstexpr
where it makes sense.
6.12.0
- Multiplication and division methods added to bn::
fixed_point, bn:: fixed_size and bn:: fixed_rect. - Colors count added to palettes manager status log.
- Invalid bn::
fixed_t unsigned operator overloads removed.
6.11.0
- An external tool can be called from the project's
Makefile
. See theexternal_tool
example to learn how to call it. - Affine background tiles offset optimized.
- Big numbers to string conversion optimized.
- 32bit integer division optimized.
- 64bit integer division by 0 assert added.
- Big maps maximum valid position fixed.
- Compressed tiles warning fixed.
- GCC11 warning fixed.
- Some 8x8 sprite text characters fixed.
- Qt Creator setup guide added.
- More questions added to Frequently asked questions (FAQ) page.
6.10.0
dynamic_bg
example added.- Affine background tiles offset fixed.
6.9.0
- bn::
sprite_font supports all sprite shapes and sizes. - Trivial type containers destruction optimized.
- Container destructors are always
noexcept
. - Redundant container asserts removed.
- GPIO direction register setup.
6.8.0
- Sprites optimized.
- Blending optimized.
- Mosaic optimized.
- Internal memory transfers optimized.
texture_polygons
example affine parameters fixed.- Clouds removed from
world_map
example.
6.7.0
- Automatic sprite double size detection improved.
- Butano Fighter allows to disable rumble in the title menu.
6.6.2
Automatic sprite double size detection fixed.
6.6.1
BG blocks manager use after move fixed.
6.6.0
- SRAM memory usage reduced.
- Sprite animate actions memory usage reduced.
- Missing asserts added to some actions.
- bn::
random is now a trivial class. - BG blocks manager search fixed.
world_map
example frame rate back to 60FPS.
6.5.0
- bn::
bitset and bn:: ibitset added. - BG blocks manager and sprite tiles manager allocation fixed.
6.4.0
- Sprites and affine backgrounds support horizontal and vertical shear.
- bn::
affine_mat_attributes:: unsafe_set_register_values added. texture_polygons
example added.- More questions added to Frequently asked questions (FAQ) page.
6.3.0
- BN_
VERSION_ MAJOR, BN_ VERSION_ MINOR and BN_ VERSION_ PATCH added. - bn::
core:: current_cpu_usage, bn:: core:: last_cpu_usage and bn:: core:: last_vblank_usage accuracy improved. - Signed division fixed and optimized.
- BG blocks manager and sprite tiles manager allocation fixed.
- BG blocks manager prints requested blocks count when an allocation fails.
6.2.0
- bn::
core:: skip_frames and bn:: core:: set_skip_frames added. - bn::
sprite_font usability improved. - bn::
reciprocal_lut and bn:: lut_reciprocal fixed.
6.1.0
6.0.0
- Rumble support (if your cart supports it). See Rumble and the
rumble
example. - bn::
sprites:: reload added. - bn::
hdma:: high_priority_start and bn:: hdma:: high_priority_stop added. - bn::
hdma:: running and bn:: hdma:: high_priority_running added. - Sprite tiles can be generated from images alone, without palettes.
- Graphics and audio subfolders supported.
- bn::
core:: reset fixed. - HDMA disable when an assert or the profiler are shown fixed.
- HDMA first screen horizontal line fixed.
- bn::newton_raphson_sqrt recursion avoided.
- Python install guide improved.
5.3.1
bn::
5.3.0
- bn::
sin, bn:: cos, bn:: atan2 and bn:: degrees_atan2 added. - H-Blank effects optimized (thanks JoaoBaptMG).
- bn::
calculate_sin_lut_value optimized. - bn::
lut_reciprocal optimized. - Frequently asked questions (FAQ) page improved.
5.2.0
- bn::
sprite_ptr:: put_below, bn:: regular_bg_ptr:: put_below and bn:: affine_bg_ptr:: put_below added. - H-Blank effects IWRAM usage reduced.
butano-graphics-tool.py
errors reporting improved.
5.1.0
- Automatic game pak wait states setup (see BN_
GAME_ PAK_ WAIT_ STATE_ FIRST_ AUTO and BN_ GAME_ PAK_ WAIT_ STATE_ SECOND_ AUTO for more information). - bn::
format and bn:: format_ref functions added. - Some methods to indicate if a background or a background map are big or not have been added.
- bn::
calculate_sin_lut_value precision improved. - Frequently asked questions (FAQ) page added.
butano-graphics-tool.py
now uses all CPU cores.- Missing third party license files included.
5.0.0
- Compressed sprites and backgrounds support (see Importing assets to learn how to generate them).
- bn::
degrees_sin and bn:: degrees_cos don't use a LUT anymore, they are replaced by bn:: degrees_lut_sin and bn:: degrees_lut_cos. - bn::
lut_sin and bn:: lut_cos input angle range increased to [0..2048]. - Enum classes size reduced.
- Required fields when importing assets are not defaulted anymore.
- bn::
rule_of_three_approximation overflow fixed.
4.4.0
- bn::
sprite_font allows to specify space between characters. - Background palettes bits per pixel mode can be specified by the user.
- Palettes change optimized.
- Unused palette colors are not imported anymore.
- bn::
sprite_ptr:: set_tiles() validation fixed.
4.3.0
4.2.0
- Sprite and background palettes can be generated from images alone, without tiles or maps.
<cstddef>
is always included (bn_cstddef.h
header file removed).- bn::
unordered_map and bn:: unordered_set assignment fixed.
4.1.0
- H-Blank effects optimized (it fixes
world_map
example flickering). - SRAM code moved from EWRAM to ROM to avoid a No$gba crash.
4.0.0
- Affine backgrounds support. See Affine backgrounds and the
affine_bgs
,mode_7
andworld_map
examples for more. - bn::hblank_effect_ptr renamed to bn::
hbe_ptr (all child classes have been renamed too). - bn::sprite_affine_mat_attributes renamed to bn::
affine_mat_attributes. - bn::bg_tiles_ptr renamed to bn::
regular_bg_tiles_ptr. - bn::bg_tiles_item renamed to bn::
regular_bg_tiles_item. - bn::affine_mat_scale_lut replaced with bn::
reciprocal_lut. - bn::core::cpu_usage() and bn::core::vblank_usage() renamed to bn::
core:: last_cpu_usage() and bn:: core:: last_vblank_usage(). - bn::
lut_reciprocal() added. - bn::
core:: current_cpu_usage() added. - gba-link-connection updated to v2.1.4.
- HDMA is disabled when needed, like before sleeping or before an assert screen.
- bn::
regular_bg_tiles_item:: valid_tiles_count() fixed. - bn::
nullopt documentation links fixed.
3.3.0
- HDMA properly supported (now it works at less than 60fps). See bn::
hdma and the hdma_polygons
example for more. - gba-link-connection remote timeout detection fixed.
3.2.1
bn::
3.2.0
bn::constexpr
.
3.1.0
- bn::
regular_bg_map_ptr:: tiles_offset() and bn:: regular_bg_map_ptr:: palette_banks_offset() methods added. - Allocated background tiles and maps commit fixed.
3.0.0
Thanks to the awesome gba-link-connection, multiplayer support has been implemented! See bn::link
example for more.
2.0.0
- By removing some method overloads, lots of runtime asserts when creating resources have been removed.
- bn::palette_bpp_mode has been renamed to bn::
bpp_mode and bpp_mode()
methods have been renamed tobpp()
. - 8 bits per pixel background tiles allocation fixed.
1.0.0
- Regular maps bigger than 512x512 supported.
- 32bit integer division by 0 assert added.
- bn::
regular_bg_item maximum tiles check added. - bn::
regular_bg_item generation options fixed.
0.4.0
btn
renamed tobn
. No more API breaks will be made between minor releases after 1.0.0, promise.- Background tiles manager status can be printed in the log with bn::
bg_tiles:: log_status(). This is done automatically when a non-optional background tiles allocation fails too. - Background regular maps manager status can be printed in the log with bn::
bg_maps:: log_status(). This is done automatically when a non-optional regular background map allocation fails too. - Sprite tiles manager status can be printed in the log with bn::
sprite_tiles:: log_status(). This is done automatically when a non-optional sprite tiles allocation fails too. - Color palettes managers status can be printed in the log with bn::
bg_palettes:: log_status() and bn:: sprite_palettes:: log_status(). This is done automatically when a non-optional color palette allocation fails too. - Sprites destruction optimized.
- Setters with an optional parameter added to some classes.
- Optional components documentation fixed.
- Other documentation improvements.
0.3.0
- Sprites update performance improved up to 30% in Butano Fighter thanks to avoid rebuilding sprites list as much as possible.
- Profiler can show the maximum measured ticks per entry.
- Assets tools print output binaries size.
0.2.0
- Performance improved up to 12% in Butano Fighter without
-flto
thanks to using less build translation units. - Documentation improved.
0.1.0
First release.