Add function DrawCubeTextureRec

examples/models/models_cube_texture_region.c

@@ -0,0 +1,74 @@
+/*******************************************************************************************
+*
+*   raylib [core] example - Draw cube with texture regions
+*
+*   This example has been created using raylib 4.0 (www.raylib.com)
+*   raylib is licensed under an unmodified zlib/libpng license (View raylib.h for details)
+*
+*   Copyright (c) 2021 Timon de Groot (@tdgroot) and Ramon Santamaria (@raysan5)
+*
+********************************************************************************************/
+
+#include "raylib.h"
+
+int main(void)
+{
+    // Initialization
+    //--------------------------------------------------------------------------------------
+    const int screenWidth = 800;
+    const int screenHeight = 450;
+
+    InitWindow(screenWidth, screenHeight, "raylib [core] example - 3d cube texture region");
+
+    // Define the camera to look into our 3d world
+    Camera3D camera = { 0 };
+    camera.position = (Vector3){ 10.0f, 10.0f, 10.0f }; // Camera position
+    camera.target = (Vector3){ 0.0f, 0.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
+
+    SetCameraMode(camera, CAMERA_FREE); // Set a free camera mode
+
+    // Load texture and define texture regions
+    Texture2D texture = LoadTexture("resources/sheet.png");       // Load texture sheet
+    Rectangle sprite1 = (Rectangle){ 0.0f, 0.0f, 32.0f, 32.0f };  // Define texture region for sprite 1
+    Rectangle sprite2 = (Rectangle){ 32.0f, 0.0f, 32.0f, 32.0f }; // Define texture region for sprite 2
+
+    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);          // Update camera
+
+        if (IsKeyDown('Z')) camera.target = (Vector3){ 0.0f, 0.0f, 0.0f };
+        //----------------------------------------------------------------------------------
+
+        // Draw
+        //----------------------------------------------------------------------------------
+        BeginDrawing();
+
+            ClearBackground(RAYWHITE);
+
+            BeginMode3D(camera);
+
+                DrawCubeTextureRec(texture, sprite1, (Vector3){4.0f, 0.0f, -1.0f }, 2.0f, 2.0f, 2.0f, WHITE);
+                DrawCubeTextureRec(texture, sprite2, (Vector3){-4.0f, 0.0f, 1.0f }, 2.0f, 2.0f, 2.0f, BLUE);
+
+            EndMode3D();
+
+        EndDrawing();
+        //----------------------------------------------------------------------------------
+    }
+
+    // De-Initialization
+    //--------------------------------------------------------------------------------------
+    CloseWindow();        // Close window and OpenGL context
+    //--------------------------------------------------------------------------------------
+
+    return 0;
+}

src/models.c

@@ -464,6 +464,157 @@ void DrawCubeTexture(Texture2D texture, Vector3 position, float width, float hei
     rlSetTexture(0);
 }
 
+void DrawCubeTextureRec(Texture2D texture, Rectangle source, Vector3 position, float width, float height, float length, Color color)
+{
+    float x = position.x;
+    float y = position.y;
+    float z = position.z;
+    float texture_width  = (float)texture.width;
+    float texture_height = (float)texture.height;
+
+    rlCheckRenderBatchLimit(36);
+
+    rlSetTexture(texture.id);
+
+        rlBegin(RL_QUADS);
+            rlColor4ub(color.r, color.g, color.b, color.a);
+
+            // Front Face
+            {
+                // Normal Pointing Towards Viewer
+                rlNormal3f(0.0f, 0.0f, 1.0f);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z + length/2);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z + length/2);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z + length/2);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z + length/2);
+            }
+
+            // Back Face
+            {
+                // Normal Pointing Away From Viewer
+                rlNormal3f(0.0f, 0.0f, - 1.0f);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z - length/2);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z - length/2);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z - length/2);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z - length/2);
+            }
+
+            // Top Face
+            {
+                // Normal Pointing Up
+                rlNormal3f(0.0f, 1.0f, 0.0f);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z - length/2);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z + length/2);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z + length/2);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z - length/2);
+            }
+
+            // Bottom Face
+            {
+                // Normal Pointing Down
+                rlNormal3f(0.0f, - 1.0f, 0.0f);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z - length/2);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z - length/2);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z + length/2);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z + length/2);
+            }
+
+            // Right face
+            {
+                // Normal Pointing Right
+                rlNormal3f(1.0f, 0.0f, 0.0f);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z - length/2);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z - length/2);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x + width/2, y + height/2, z + length/2);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x + width/2, y - height/2, z + length/2);
+            }
+
+            // Left Face
+            {
+                // Normal Pointing Left
+                rlNormal3f( - 1.0f, 0.0f, 0.0f);
+
+                // Bottom Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z - length/2);
+
+                // Bottom Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, (source.y + source.height) / texture_height);
+                rlVertex3f(x - width/2, y - height/2, z + length/2);
+
+                // Top Right Of The Texture and Quad
+                rlTexCoord2f((source.x + source.width) / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z + length/2);
+
+                // Top Left Of The Texture and Quad
+                rlTexCoord2f(source.x / texture_width, source.y / texture_height);
+                rlVertex3f(x - width/2, y + height/2, z - length/2);
+            }
+        rlEnd();
+
+    rlSetTexture(0);
+}
+
 // Draw sphere
 void DrawSphere(Vector3 centerPos, float radius, Color color)
 {

src/raylib.h

@@ -1374,6 +1374,7 @@ RLAPI void DrawCubeV(Vector3 position, Vector3 size, Color color);
 RLAPI void DrawCubeWires(Vector3 position, float width, float height, float length, Color color);        // Draw cube wires
 RLAPI void DrawCubeWiresV(Vector3 position, Vector3 size, Color color);                                  // Draw cube wires (Vector version)
 RLAPI void DrawCubeTexture(Texture2D texture, Vector3 position, float width, float height, float length, Color color); // Draw cube textured
+RLAPI void DrawCubeTextureRec(Texture2D texture, Rectangle source, Vector3 position, float width, float height, float length, Color color); // Draw cube with a region of a texture
 RLAPI void DrawSphere(Vector3 centerPos, float radius, Color color);                                     // Draw sphere
 RLAPI void DrawSphereEx(Vector3 centerPos, float radius, int rings, int slices, Color color);            // Draw sphere with extended parameters
 RLAPI void DrawSphereWires(Vector3 centerPos, float radius, int rings, int slices, Color color);         // Draw sphere wires