Breaking Change

This page list the framework API breaking change or some major change to the framework.

2026/03/18

Improvement on audio API(#64)

The flow of playing track or sample has been change to better flow.

• Track : GetChannel() -> channel.Play() (Set RestartPoint via channel, not track anymore)
• Sample : Can use GetChannel() -> channel.Play() like Track too but can also use sample.Play() shortcut too if want to just fire-and-forget play.

// Before
var track = TrackStore.Get("audio.ogg");
track.RestartPoint = 5000;
var channel = track.Play();
channel.Looping = true;

// After
var track = TrackStore.Get("audio.ogg");
var channel = track.GetChannel();
channel.RestartPoint = 5000;
channel.Looping = true;
channel.Play();

2026/02/05

Change on renderer drawable scaling on draw (#44)

At first we calculate the size of the drawable based on what renderer give the size that since we enabled the high DPI as default, this make the value that report from renderer about twice of the real pixel on the screen. (e.g. if you create a box with new Vector2(60) size, the actual size of the drawable will be 30*30 on the real pixel). That's why we changed the method on calculating the size to based on the pixel size of the real screen. There is no change required to the code but for migration to maintain the same size of the drawable just resize everything by half should be enough.

Before	After