sprite animation
There is no browser build of this example yet.
Is it the same as C?
- Desktop:verified The Zig version renders a final frame that is byte-identical to the C example.
- Browser:not checked yet The browser comparison does not cover this example yet.
//! raylib [textures] example - sprite animation
//!
//! Zig-API translation of examples/textures/textures_sprite_animation.c (raylib 6.2).
//! Example licensed under an unmodified zlib/libpng license.
//! Copyright (c) 2014-2025 Ramon Santamaria (@raysan5)
const rl = @import("raylib");
const max_frame_speed = 15;
const min_frame_speed = 1;
pub fn main() !void {
// Initialization
const screen_width = 800;
const screen_height = 450;
rl.initWindow(screen_width, screen_height, "raylib [textures] example - sprite animation");
defer rl.closeWindow(); // Close window and OpenGL context
// NOTE: Textures MUST be loaded after Window initialization (OpenGL context is required)
const scarfy = try rl.loadTexture("resources/scarfy.png"); // Texture loading
defer rl.unloadTexture(scarfy); // Texture unloading
const scarfy_width: f32 = @floatFromInt(scarfy.width);
const position: rl.Vector2 = .{ .x = 350.0, .y = 280.0 };
var frame_rec: rl.Rectangle = .{ .x = 0.0, .y = 0.0, .width = scarfy_width / 6, .height = @floatFromInt(scarfy.height) };
var current_frame: u32 = 0;
var frames_counter: u32 = 0;
var frames_speed: u32 = 8; // Number of spritesheet frames shown by second
rl.setTargetFPS(60); // Set our game to run at 60 frames-per-second
// Main game loop
while (!rl.windowShouldClose()) { // Detect window close button or ESC key
// Update
frames_counter += 1;
if (frames_counter >= (60 / frames_speed)) {
frames_counter = 0;
current_frame += 1;
if (current_frame > 5) current_frame = 0;
frame_rec.x = @as(f32, @floatFromInt(current_frame)) * scarfy_width / 6;
}
// Control frames speed
if (rl.isKeyPressed(.right)) {
frames_speed = @min(frames_speed + 1, max_frame_speed);
} else if (rl.isKeyPressed(.left)) {
frames_speed = @max(frames_speed - 1, min_frame_speed);
}
// Draw
rl.beginDrawing();
defer rl.endDrawing();
rl.clearBackground(.ray_white);
rl.drawTexture(scarfy, 15, 40, .white);
rl.drawRectangleLines(15, 40, scarfy.width, scarfy.height, .lime);
rl.drawRectangleLines(
15 + @as(i32, @intFromFloat(frame_rec.x)),
40 + @as(i32, @intFromFloat(frame_rec.y)),
@intFromFloat(frame_rec.width),
@intFromFloat(frame_rec.height),
.red,
);
rl.drawText("FRAME SPEED: ", 165, 210, 10, .dark_gray);
rl.drawText(rl.textFormat("{d:0>2} FPS", .{frames_speed}), 575, 210, 10, .dark_gray);
rl.drawText("PRESS RIGHT/LEFT KEYS to CHANGE SPEED!", 290, 240, 10, .dark_gray);
for (0..max_frame_speed) |n| {
const i: i32 = @intCast(n);
if (n < frames_speed) rl.drawRectangle(250 + 21 * i, 205, 20, 20, .red);
rl.drawRectangleLines(250 + 21 * i, 205, 20, 20, .maroon);
}
rl.drawTextureRec(scarfy, frame_rec, position, .white); // Draw part of the texture
rl.drawText("(c) Scarfy sprite by Eiden Marsal", screen_width - 200, screen_height - 20, 10, .gray);
}
}/*******************************************************************************************
*
* raylib [textures] example - sprite animation
*
* Example complexity rating: [★★☆☆] 2/4
*
* Example originally created with raylib 1.3, last time updated with raylib 1.3
*
* Example licensed under an unmodified zlib/libpng license, which is an OSI-certified,
* BSD-like license that allows static linking with closed source software
*
* Copyright (c) 2014-2025 Ramon Santamaria (@raysan5)
*
********************************************************************************************/
#include "raylib.h"
#define MAX_FRAME_SPEED 15
#define MIN_FRAME_SPEED 1
//------------------------------------------------------------------------------------
// Program main entry point
//------------------------------------------------------------------------------------
int main(void)
{
// Initialization
//--------------------------------------------------------------------------------------
const int screenWidth = 800;
const int screenHeight = 450;
InitWindow(screenWidth, screenHeight, "raylib [textures] example - sprite animation");
// NOTE: Textures MUST be loaded after Window initialization (OpenGL context is required)
Texture2D scarfy = LoadTexture("resources/scarfy.png"); // Texture loading
Vector2 position = { 350.0f, 280.0f };
Rectangle frameRec = { 0.0f, 0.0f, (float)scarfy.width/6, (float)scarfy.height };
int currentFrame = 0;
int framesCounter = 0;
int framesSpeed = 8; // Number of spritesheet frames shown by second
SetTargetFPS(60); // Set our game to run at 60 frames-per-second
//--------------------------------------------------------------------------------------
// Main game loop
while (!WindowShouldClose()) // Detect window close button or ESC key
{
// Update
//----------------------------------------------------------------------------------
framesCounter++;
if (framesCounter >= (60/framesSpeed))
{
framesCounter = 0;
currentFrame++;
if (currentFrame > 5) currentFrame = 0;
frameRec.x = (float)currentFrame*(float)scarfy.width/6;
}
// Control frames speed
if (IsKeyPressed(KEY_RIGHT)) framesSpeed++;
else if (IsKeyPressed(KEY_LEFT)) framesSpeed--;
if (framesSpeed > MAX_FRAME_SPEED) framesSpeed = MAX_FRAME_SPEED;
else if (framesSpeed < MIN_FRAME_SPEED) framesSpeed = MIN_FRAME_SPEED;
//----------------------------------------------------------------------------------
// Draw
//----------------------------------------------------------------------------------
BeginDrawing();
ClearBackground(RAYWHITE);
DrawTexture(scarfy, 15, 40, WHITE);
DrawRectangleLines(15, 40, scarfy.width, scarfy.height, LIME);
DrawRectangleLines(15 + (int)frameRec.x, 40 + (int)frameRec.y, (int)frameRec.width, (int)frameRec.height, RED);
DrawText("FRAME SPEED: ", 165, 210, 10, DARKGRAY);
DrawText(TextFormat("%02i FPS", framesSpeed), 575, 210, 10, DARKGRAY);
DrawText("PRESS RIGHT/LEFT KEYS to CHANGE SPEED!", 290, 240, 10, DARKGRAY);
for (int i = 0; i < MAX_FRAME_SPEED; i++)
{
if (i < framesSpeed) DrawRectangle(250 + 21*i, 205, 20, 20, RED);
DrawRectangleLines(250 + 21*i, 205, 20, 20, MAROON);
}
DrawTextureRec(scarfy, frameRec, position, WHITE); // Draw part of the texture
DrawText("(c) Scarfy sprite by Eiden Marsal", screenWidth - 200, screenHeight - 20, 10, GRAY);
EndDrawing();
//----------------------------------------------------------------------------------
}
// De-Initialization
//--------------------------------------------------------------------------------------
UnloadTexture(scarfy); // Texture unloading
CloseWindow(); // Close window and OpenGL context
//--------------------------------------------------------------------------------------
return 0;
}From raylib 6.2. The original on GitHub.