diff --git a/examples/textures/textures_image_channel.c b/examples/textures/textures_image_channel.c new file mode 100644 index 000000000..19f105ece --- /dev/null +++ b/examples/textures/textures_image_channel.c @@ -0,0 +1,99 @@ +/******************************************************************************************* +* +* raylib [textures] example - Retrive image channel (mask) +* +* NOTE: Images are loaded in CPU memory (RAM); textures are loaded in GPU memory (VRAM) +* +* Example originally created with raylib 5.1-dev, last time updated with raylib 5.1-dev +* +* Example contributed by Bruno Cabral (github.com/brccabral) and reviewed by Ramon Santamaria (@raysan5) +* +* 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) 2024-2024 Bruno Cabral (github.com/brccabral) and Ramon Santamaria (@raysan5) +* +********************************************************************************************/ + +#include + +//------------------------------------------------------------------------------------ +// Program main entry point +//------------------------------------------------------------------------------------ +int main(void) +{ + // Initialization + //-------------------------------------------------------------------------------------- + + const int screenWidth = 800; + const int screenHeight = 612; + + InitWindow(screenWidth, screenHeight, "raylib [textures] example - extract channel from image"); + + Image fudesumi_image = LoadImage("resources/fudesumi.png"); + Texture2D fudesumi_texture = LoadTextureFromImage(fudesumi_image); + + Image image_red = ImageFromChannel(fudesumi_image, 0, 0.0f); + Texture2D texture_red = LoadTextureFromImage(image_red); + UnloadImage(image_red); + + Image image_green = ImageFromChannel(fudesumi_image, 1, 0.0f); + Texture2D texture_green = LoadTextureFromImage(image_green); + UnloadImage(image_green); + + Image image_blue = ImageFromChannel(fudesumi_image, 2, 0.0f); + Texture2D texture_blue = LoadTextureFromImage(image_blue); + UnloadImage(image_blue); + + Image image_alpha = ImageFromChannel(fudesumi_image, 3, 0.0f); + Texture2D texture_alpha = LoadTextureFromImage(image_alpha); + UnloadImage(image_alpha); + + + Image background_image = GenImageChecked(screenWidth, screenHeight, screenWidth/20, screenHeight/20, ORANGE, YELLOW); + Texture2D background_texture = LoadTextureFromImage(background_image); + UnloadImage(background_image); + + SetTargetFPS(60); // Set our game to run at 60 frames-per-second + + Rectangle fudesumi_rec = {0, 0, fudesumi_image.width, fudesumi_image.height}; + Rectangle red_pos = { 410, 50, fudesumi_image.width / 2, fudesumi_image.height / 2 }; + Rectangle green_pos = { 600, 50, fudesumi_image.width / 2, fudesumi_image.height / 2 }; + Rectangle blue_pos = { 410, 310, fudesumi_image.width / 2, fudesumi_image.height / 2 }; + Rectangle alpha_pos = { 600, 310, fudesumi_image.width / 2, fudesumi_image.height / 2 }; + + //-------------------------------------------------------------------------------------- + + // Main game loop + while (!WindowShouldClose()) // Detect window close button or ESC key + { + // Draw + //---------------------------------------------------------------------------------- + BeginDrawing(); + + DrawTexture(background_texture, 0, 0, WHITE); + DrawTexture(fudesumi_texture, 50, 50, WHITE); + + DrawTexturePro(texture_red, fudesumi_rec, red_pos, (Vector2) {0, 0}, 0, RED); + DrawTexturePro(texture_green, fudesumi_rec, green_pos, (Vector2) {0, 0}, 0, GREEN); + DrawTexturePro(texture_blue, fudesumi_rec, blue_pos, (Vector2) {0, 0}, 0, BLUE); + DrawTexturePro(texture_alpha, fudesumi_rec, alpha_pos, (Vector2) {0, 0}, 0, WHITE); + + EndDrawing(); + //---------------------------------------------------------------------------------- + } + + // De-Initialization + //-------------------------------------------------------------------------------------- + UnloadTexture(background_texture); + UnloadImage(fudesumi_image); + UnloadTexture(fudesumi_texture); + UnloadTexture(texture_red); + UnloadTexture(texture_green); + UnloadTexture(texture_blue); + UnloadTexture(texture_alpha); + CloseWindow(); // Close window and OpenGL context + //-------------------------------------------------------------------------------------- + + return 0; +} diff --git a/examples/textures/textures_image_channel.png b/examples/textures/textures_image_channel.png new file mode 100644 index 000000000..4e8b0b9c5 Binary files /dev/null and b/examples/textures/textures_image_channel.png differ diff --git a/src/raylib.h b/src/raylib.h index 7195fd55f..31a52f485 100644 --- a/src/raylib.h +++ b/src/raylib.h @@ -1334,6 +1334,7 @@ RLAPI Image ImageCopy(Image image); RLAPI Image ImageFromImage(Image image, Rectangle rec); // Create an image from another image piece RLAPI Image ImageText(const char *text, int fontSize, Color color); // Create an image from text (default font) RLAPI Image ImageTextEx(Font font, const char *text, float fontSize, float spacing, Color tint); // Create an image from text (custom sprite font) +RLAPI Image ImageFromChannel(Image image, int selected_channel, float threshold); // Create an image from a selected channel of another image (Gray Alpha or RGBA) RLAPI void ImageFormat(Image *image, int newFormat); // Convert image data to desired format RLAPI void ImageToPOT(Image *image, Color fill); // Convert image to POT (power-of-two) RLAPI void ImageCrop(Image *image, Rectangle crop); // Crop an image to a defined rectangle diff --git a/src/rtextures.c b/src/rtextures.c index 39c0f78f2..cb8d270eb 100644 --- a/src/rtextures.c +++ b/src/rtextures.c @@ -1630,6 +1630,241 @@ Image ImageTextEx(Font font, const char *text, float fontSize, float spacing, Co return imText; } +Image ImageFromChannel(Image image, int selected_channel, float threshold) +{ + Image result = { 0 }; + + // Security check to avoid program crash + if ((image.data == NULL) || (image.width == 0) || (image.height == 0)) + return result; + + // Check thresholds limits + if (threshold < 0.0f) + { + TRACELOG(LOG_WARNING, "Threshold is from 0 to 1, changing to 0."); + threshold = 0.0f; + } + if (threshold > 1.0f) + { + TRACELOG(LOG_WARNING, "Threshold is from 0 to 1, changing to 1."); + threshold = 1.0f; + } + + // Check selected channel + if (image.format == PIXELFORMAT_UNCOMPRESSED_GRAYSCALE + || image.format == PIXELFORMAT_UNCOMPRESSED_R32 + || image.format == PIXELFORMAT_UNCOMPRESSED_R16 + ) + { + if (selected_channel > 0) + { + TRACELOG(LOG_WARNING, "This image has only 1 channel. Setting channel to it."); + selected_channel = 0; + } + } + else if (image.format == PIXELFORMAT_UNCOMPRESSED_GRAY_ALPHA) + { + if (selected_channel > 1) + { + TRACELOG(LOG_WARNING, "This image has only 2 channels. Setting channel to alpha."); + selected_channel = 1; + } + } + else if (image.format == PIXELFORMAT_UNCOMPRESSED_R5G6B5 + || image.format == PIXELFORMAT_UNCOMPRESSED_R8G8B8 + || image.format == PIXELFORMAT_UNCOMPRESSED_R32G32B32 + || image.format == PIXELFORMAT_UNCOMPRESSED_R16G16B16 + ) + { + if (selected_channel > 2) + { + TRACELOG(LOG_WARNING, "This image has only 3 channels. Setting channel to red."); + selected_channel = 0; + } + } + + // formats rgba + if (selected_channel > 3 || selected_channel < 0) + { + TRACELOG(LOG_WARNING, "ImageFromChannel supports channels 0 to 3 (rgba). Setting channel to alpha."); + selected_channel = 3; + } + + result.format = PIXELFORMAT_UNCOMPRESSED_GRAY_ALPHA; + result.height = image.height; + result.width = image.width; + result.mipmaps = 1; + + unsigned char *pixels = (unsigned char *)RL_CALLOC(image.width * 2 * image.height, sizeof(unsigned char)); // values 0 to 255 + + if (image.format >= PIXELFORMAT_COMPRESSED_DXT1_RGB) TRACELOG(LOG_WARNING, "IMAGE: Pixel data retrieval not supported for compressed image formats"); + else + { + for (int i = 0, k = 0; i < image.width*2*image.height; i+=2) + { + float image_value = -1; + float image_alpha = 0; + switch (image.format) + { + case PIXELFORMAT_UNCOMPRESSED_GRAYSCALE: + { + image_value = (float)((unsigned char *)image.data)[i + selected_channel]/255.0f; + image_alpha = 1; + + } break; + case PIXELFORMAT_UNCOMPRESSED_GRAY_ALPHA: + { + image_value = (float)((unsigned char *)image.data)[k + selected_channel]/255.0f; + image_alpha = (float)((unsigned char *)image.data)[k + 1]/255.0f; + + k += 2; + } break; + case PIXELFORMAT_UNCOMPRESSED_R5G5B5A1: + { + unsigned short pixel = ((unsigned short *)image.data)[i]; + + if (selected_channel == 0) + { + image_value = (float)((pixel & 0b1111100000000000) >> 11)*(1.0f/31); + } + else if (selected_channel == 1) + { + image_value = (float)((pixel & 0b0000011111000000) >> 6)*(1.0f/31); + } + else if (selected_channel == 2) + { + image_value = (float)((pixel & 0b0000000000111110) >> 1)*(1.0f/31); + } + else if (selected_channel == 3) + { + image_value = ((pixel & 0b0000000000000001) == 0)? 0.0f : 1.0f; + } + image_alpha = ((pixel & 0b0000000000000001) == 0)? 0.0f : 1.0f; + + } break; + case PIXELFORMAT_UNCOMPRESSED_R5G6B5: + { + unsigned short pixel = ((unsigned short *)image.data)[i]; + + if (selected_channel == 0) + { + image_value = (float)((pixel & 0b1111100000000000) >> 11)*(1.0f/31); + } + else if (selected_channel == 1) + { + image_value = (float)((pixel & 0b0000011111100000) >> 5)*(1.0f/63); + } + else if (selected_channel == 2) + { + image_value = (float)(pixel & 0b0000000000011111)*(1.0f/31); + } + image_alpha = 1; + + } break; + case PIXELFORMAT_UNCOMPRESSED_R4G4B4A4: + { + unsigned short pixel = ((unsigned short *)image.data)[i]; + + if (selected_channel == 0) + { + image_value = (float)((pixel & 0b1111000000000000) >> 12)*(1.0f/15); + } + else if (selected_channel == 1) + { + image_value = (float)((pixel & 0b0000111100000000) >> 8)*(1.0f/15); + } + else if (selected_channel == 2) + { + image_value = (float)((pixel & 0b0000000011110000) >> 4)*(1.0f/15); + } + else if (selected_channel == 3) + { + image_value = (float)(pixel & 0b0000000000001111)*(1.0f/15); + } + image_alpha = (float)(pixel & 0b0000000000001111)*(1.0f/15); + + } break; + case PIXELFORMAT_UNCOMPRESSED_R8G8B8A8: + { + image_value = (float)((unsigned char *)image.data)[k + selected_channel]/255.0f; + image_alpha = (float)((unsigned char *)image.data)[k + 3]/255.0f; + + k += 4; + } break; + case PIXELFORMAT_UNCOMPRESSED_R8G8B8: + { + image_value = (float)((unsigned char *)image.data)[k + selected_channel]/255.0f; + image_alpha = 1; + + k += 3; + } break; + case PIXELFORMAT_UNCOMPRESSED_R32: + { + image_value = ((float *)image.data)[k]; + image_alpha = 1; + + k += 1; + } break; + case PIXELFORMAT_UNCOMPRESSED_R32G32B32: + { + image_value = ((float *)image.data)[k + selected_channel]; + image_alpha = 1; + + k += 3; + } break; + case PIXELFORMAT_UNCOMPRESSED_R32G32B32A32: + { + image_value = ((float *)image.data)[k + selected_channel]; + image_alpha = ((float *)image.data)[k + 3]; + + k += 4; + } break; + case PIXELFORMAT_UNCOMPRESSED_R16: + { + image_value = HalfToFloat(((unsigned short *)image.data)[k]); + image_alpha = 1; + + k += 1; + } break; + case PIXELFORMAT_UNCOMPRESSED_R16G16B16: + { + image_value = HalfToFloat(((unsigned short *)image.data)[k+selected_channel]); + image_alpha = 1; + + k += 3; + } break; + case PIXELFORMAT_UNCOMPRESSED_R16G16B16A16: + { + image_value = HalfToFloat(((unsigned short *)image.data)[k + selected_channel]); + image_alpha = HalfToFloat(((unsigned short *)image.data)[k + 3]); + + k += 4; + } break; + default: break; + } + + // verify threshold + unsigned char result_value = 0; + unsigned char result_alpha = 0; + if (image_value >= threshold) + { + result_value = image_value * 255; + if (image_alpha) + { + result_alpha = 255; + } + } + + pixels[i] = result_value; + pixels[i + 1] = result_alpha; + } + } + + result.data = pixels; + + return result; +} + // Resize and image to new size using Nearest-Neighbor scaling algorithm void ImageResizeNN(Image *image,int newWidth,int newHeight) {