Does sprite component support frames with different dimensions?

[kkkiio]

Hello, I'd like to ask if it's possible for frames within a single sprite to have different dimensions without being stretched. Currently, it seems the sprite() component caches the dimensions of the first frame and applies them to all subsequent frames, causing distortion.

For example, if frame_0 is 49px tall and frame_1 is 45px tall, frame_1 gets stretched to match the height of frame_0.

// Assuming texture is 100x100 for simplicity
k.loadSprite("my_sprite", "texture.png", {
    frames: [
        k.quad(0, 0, 50/100, 49/100), // frame_0
        k.quad(0, 49, 50/100, 45/100), // frame_1 (gets stretched)
    ],
    anims: {
        "play": { from: 0, to: 1, loop: true, speed: 1 },
    },
});

Is there a recommended workaround or a specific part of the codebase I could modify to make each frame render at its original aspect ratio? Thank you for your great work on Kaplay

[dragoncoder047]

I don't think this is ever going to be added, having different-sized frames that cause different-sized bounding boxes/colliders. The quad doesn't have anything to do with physics really, it just defines the range of uv inputs that go to the GPU so that it pulls the part of the texture that you want. Whether it gets stretched is controlled by the rest of the rendering code. For example, the scale component changes the screen quad that it gets drawn into, but doesn't change the texture quad, so the chunk of the texture being rendered gets stretched.

If you want it to change size I suggest making two different sprite ids and switching the entire sprite instead of just playing a new animation.

[kkkiio]

Thank you for the quick and clear response! I really appreciate you taking the time to explain.
Out of curiosity, since many engines (o3 searched) support trimmed sprite sheets with offsets, is there a reason or trade-off in Kaplay that makes sticking to uniform frame sizes the preferred approach? I'm not pushing for a change, just trying to better understand the engine's architecture.
For my project, I will likely follow your advice and pre-process my frames to a uniform size to keep code simple and aligned with Kaplay's design.
Thanks again for the help

[dragoncoder047]

If you give the quads manually, you can get different-sized frames like you did in the top post. What you won't get is different-sized physics colliders, so the frames stretch to fit. I think the reason is that if an animation has different-sized frames then the physics collider would be constantly changing size as the animation runs, which stresses the physics engine.

[lajbel]

Probably was never added because it's just easier using a spritesheet with same sized frames and modify the area, but we could eventually add support it (in an easier way that using quads)