loading
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 [models] example - loading
//!
//! NOTE: raylib supports multiple models file formats:
//!
//! - OBJ > Text file format. Must include vertex position-texcoords-normals information,
//! if .obj references some .mtl materials file, it will be tried to be loaded
//! - GLTF/GLB > Text/binary file formats. Includes lot of information and it could
//! also reference external files, mesh and materials data will be tried to be loaded
//! - IQM > Binary file format. Includes mesh vertex data but also animation data,
//! meshes and animation data can be loaded
//! - VOX > Binary file format. MagikaVoxel mesh format:
//! https://github.com/ephtracy/voxel-model/blob/master/MagicaVoxel-file-format-vox.txt
//! - M3D > Binary file format. Model 3D format:
//! https://bztsrc.gitlab.io/model3d
//!
//! Zig-API translation of examples/models/models_loading.c (raylib 6.2).
//! Example licensed under an unmodified zlib/libpng license.
//! Copyright (c) 2014-2025 Ramon Santamaria (@raysan5)
const std = @import("std");
const rl = @import("raylib");
pub fn main() !void {
// Initialization
const screen_width = 800;
const screen_height = 450;
rl.initWindow(screen_width, screen_height, "raylib [models] example - loading");
defer rl.closeWindow(); // Close window and OpenGL context
// Define the camera to look into our 3d world
var camera: rl.Camera = .{
.position = .{ .x = 50.0, .y = 50.0, .z = 50.0 }, // Camera position
.target = .{ .x = 0.0, .y = 12.0, .z = 0.0 }, // Camera looking at point
.up = .{ .x = 0.0, .y = 1.0, .z = 0.0 }, // Camera up vector (rotation towards target)
.fovy = 45.0, // Camera field-of-view Y
.projection = .perspective, // Camera mode type
};
var model = try rl.loadModel("resources/models/obj/castle.obj"); // Load model
defer rl.unloadModel(model);
var texture = try rl.loadTexture("resources/models/obj/castle_diffuse.png"); // Load model texture
defer rl.unloadTexture(texture);
model.materials.?[0].map(.diffuse).texture = texture; // Set map diffuse texture
const position: rl.Vector3 = .{ .x = 0.0, .y = 0.0, .z = 0.0 }; // Set model position
var bounds = rl.getMeshBoundingBox(model.meshes.?[0]); // Set model bounds
// NOTE: bounds are calculated from the original size of the model,
// if model is scaled on drawing, bounds must be also scaled
var selected = false; // Selected object flag
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
rl.updateCamera(&camera, .orbital);
// Load new models/textures on drag&drop
if (rl.isFileDropped()) {
const dropped_files = rl.loadDroppedFiles();
defer rl.unloadDroppedFiles(dropped_files); // Unload filepaths from memory
if (dropped_files.count == 1) { // Only support one file dropped
const path = std.mem.span(dropped_files.paths.?[0]);
if (isModelFile(path)) { // Model file formats supported
// Unload previous model only once the new one loaded
if (rl.loadModel(path)) |new_model| {
rl.unloadModel(model);
model = new_model;
model.materials.?[0].map(.diffuse).texture = texture; // Set current map diffuse texture
bounds = rl.getMeshBoundingBox(model.meshes.?[0]);
// Move camera position from target enough distance to visualize model properly
camera.position.x = bounds.max.x + 10.0;
camera.position.y = bounds.max.y + 10.0;
camera.position.z = bounds.max.z + 10.0;
} else |_| {}
} else if (rl.isFileExtension(path, ".png")) { // Texture file formats supported
// Unload current model texture and load new one
if (rl.loadTexture(path)) |new_texture| {
rl.unloadTexture(texture);
texture = new_texture;
model.materials.?[0].map(.diffuse).texture = texture;
} else |_| {}
}
}
}
// Select model on mouse click
if (rl.isMouseButtonPressed(.left)) {
// Check collision between ray and box
selected = if (rl.getRayCollisionBox(rl.getScreenToWorldRay(rl.getMousePosition(), camera), bounds).hit) !selected else false;
}
// Draw
rl.beginDrawing();
defer rl.endDrawing();
rl.clearBackground(.ray_white);
{
rl.beginMode3D(camera);
defer rl.endMode3D();
rl.drawModel(model, position, 1.0, .white); // Draw 3d model with texture
rl.drawGrid(20, 10.0); // Draw a grid
if (selected) rl.drawBoundingBox(bounds, .green); // Draw selection box
}
rl.drawText("Drag & drop model to load mesh/texture.", 10, rl.getScreenHeight() - 20, 10, .dark_gray);
if (selected) rl.drawText("MODEL SELECTED", rl.getScreenWidth() - 110, 10, 10, .green);
rl.drawText("(c) Castle 3D model by Alberto Cano", screen_width - 200, screen_height - 20, 10, .gray);
rl.drawFPS(10, 10);
}
}
fn isModelFile(path: [:0]const u8) bool {
for ([_][:0]const u8{ ".obj", ".gltf", ".glb", ".vox", ".iqm", ".m3d" }) |ext| {
if (rl.isFileExtension(path, ext)) return true;
}
return false;
}/*******************************************************************************************
*
* raylib [models] example - loading
*
* Example complexity rating: [★☆☆☆] 1/4
*
* NOTE: raylib supports multiple models file formats:
*
* - OBJ > Text file format. Must include vertex position-texcoords-normals information,
* if .obj references some .mtl materials file, it will be tried to be loaded
* - GLTF/GLB > Text/binary file formats. Includes lot of information and it could
* also reference external files, mesh and materials data will be tried to be loaded
* - IQM > Binary file format. Includes mesh vertex data but also animation data,
* meshes and animation data can be loaded
* - VOX > Binary file format. MagikaVoxel mesh format:
* https://github.com/ephtracy/voxel-model/blob/master/MagicaVoxel-file-format-vox.txt
* - M3D > Binary file format. Model 3D format:
* https://bztsrc.gitlab.io/model3d
*
* Example originally created with raylib 2.0, last time updated with raylib 4.2
*
* 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"
//------------------------------------------------------------------------------------
// Program main entry point
//------------------------------------------------------------------------------------
int main(void)
{
// Initialization
//--------------------------------------------------------------------------------------
const int screenWidth = 800;
const int screenHeight = 450;
InitWindow(screenWidth, screenHeight, "raylib [models] example - loading");
// Define the camera to look into our 3d world
Camera camera = { 0 };
camera.position = (Vector3){ 50.0f, 50.0f, 50.0f }; // Camera position
camera.target = (Vector3){ 0.0f, 12.0f, 0.0f }; // Camera looking at point
camera.up = (Vector3){ 0.0f, 1.0f, 0.0f }; // Camera up vector (rotation towards target)
camera.fovy = 45.0f; // Camera field-of-view Y
camera.projection = CAMERA_PERSPECTIVE; // Camera mode type
Model model = LoadModel("resources/models/obj/castle.obj"); // Load model
Texture2D texture = LoadTexture("resources/models/obj/castle_diffuse.png"); // Load model texture
model.materials[0].maps[MATERIAL_MAP_DIFFUSE].texture = texture; // Set map diffuse texture
Vector3 position = { 0.0f, 0.0f, 0.0f }; // Set model position
BoundingBox bounds = GetMeshBoundingBox(model.meshes[0]); // Set model bounds
// NOTE: bounds are calculated from the original size of the model,
// if model is scaled on drawing, bounds must be also scaled
bool selected = false; // Selected object flag
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
//----------------------------------------------------------------------------------
UpdateCamera(&camera, CAMERA_ORBITAL);
// Load new models/textures on drag&drop
if (IsFileDropped())
{
FilePathList droppedFiles = LoadDroppedFiles();
if (droppedFiles.count == 1) // Only support one file dropped
{
if (IsFileExtension(droppedFiles.paths[0], ".obj") ||
IsFileExtension(droppedFiles.paths[0], ".gltf") ||
IsFileExtension(droppedFiles.paths[0], ".glb") ||
IsFileExtension(droppedFiles.paths[0], ".vox") ||
IsFileExtension(droppedFiles.paths[0], ".iqm") ||
IsFileExtension(droppedFiles.paths[0], ".m3d")) // Model file formats supported
{
UnloadModel(model); // Unload previous model
model = LoadModel(droppedFiles.paths[0]); // Load new model
model.materials[0].maps[MATERIAL_MAP_DIFFUSE].texture = texture; // Set current map diffuse texture
bounds = GetMeshBoundingBox(model.meshes[0]);
// Move camera position from target enough distance to visualize model properly
camera.position.x = bounds.max.x + 10.0f;
camera.position.y = bounds.max.y + 10.0f;
camera.position.z = bounds.max.z + 10.0f;
}
else if (IsFileExtension(droppedFiles.paths[0], ".png")) // Texture file formats supported
{
// Unload current model texture and load new one
UnloadTexture(texture);
texture = LoadTexture(droppedFiles.paths[0]);
model.materials[0].maps[MATERIAL_MAP_DIFFUSE].texture = texture;
}
}
UnloadDroppedFiles(droppedFiles); // Unload filepaths from memory
}
// Select model on mouse click
if (IsMouseButtonPressed(MOUSE_BUTTON_LEFT))
{
// Check collision between ray and box
if (GetRayCollisionBox(GetScreenToWorldRay(GetMousePosition(), camera), bounds).hit) selected = !selected;
else selected = false;
}
//----------------------------------------------------------------------------------
// Draw
//----------------------------------------------------------------------------------
BeginDrawing();
ClearBackground(RAYWHITE);
BeginMode3D(camera);
DrawModel(model, position, 1.0f, WHITE); // Draw 3d model with texture
DrawGrid(20, 10.0f); // Draw a grid
if (selected) DrawBoundingBox(bounds, GREEN); // Draw selection box
EndMode3D();
DrawText("Drag & drop model to load mesh/texture.", 10, GetScreenHeight() - 20, 10, DARKGRAY);
if (selected) DrawText("MODEL SELECTED", GetScreenWidth() - 110, 10, 10, GREEN);
DrawText("(c) Castle 3D model by Alberto Cano", screenWidth - 200, screenHeight - 20, 10, GRAY);
DrawFPS(10, 10);
EndDrawing();
//----------------------------------------------------------------------------------
}
// De-Initialization
//--------------------------------------------------------------------------------------
UnloadTexture(texture); // Unload texture
UnloadModel(model); // Unload model
CloseWindow(); // Close window and OpenGL context
//--------------------------------------------------------------------------------------
return 0;
}From raylib 6.2. The original on GitHub.