From 4e0571097fd9647d9d3317c0400006b1cf0e60f5 Mon Sep 17 00:00:00 2001 From: Carlos Lopez Martinez <69404571+Electroner@users.noreply.github.com> Date: Sat, 1 Oct 2022 16:59:24 +0200 Subject: [PATCH] Splitted Functions in Files --- pathwork.cpp => Directories/pathwork.cpp | 0 Directories/pathwork.h | 20 + Feather.exe | Bin 2511360 -> 0 bytes Feather.rc | 2 +- Feather.vcxproj | 26 +- Feather.vcxproj.filters | 111 +- GUI/ExternGUI/ConfigMenu.cpp | 38 + GUI/ExternGUI/DebugConsole.cpp | 38 + GUI/ExternGUI/ErrorWindows.cpp | 24 + GUI/ExternGUI/ImageSaveLoad.cpp | 150 + GUI/ExternGUI/newImage.cpp | 101 + IconsFontAwesome.h => GUI/IconsFontAwesome.h | 0 GUI/MainGUI/ImageDisplayers.cpp | 115 + GUI/MainGUI/Info.cpp | 39 + GUI/MainGUI/Layers.cpp | 49 + GUI/MainGUI/Menu.cpp | 120 + GUI/MainGUI/Properties.cpp | 27 + GUI/MainGUI/ToolProperties.cpp | 20 + GUI/MainGUI/Tools.cpp | 60 + GUI/feathergui.cpp | 341 + feathergui.h => GUI/feathergui.h | 36 +- stb.cpp => ImageIO/stb.cpp | 2 +- ImageIO/stb_image.h | 10412 ++++++++-------- ImageWork.cpp | 4 +- ImageWork/ImageWork.cpp | 173 + ImageWork.h => ImageWork/ImageWork.h | 1 - feathergui.cpp | 30 +- main.cpp | 7 +- pathwork.h | 39 - {Images => resources/Images}/Feather.ico | Bin {Images => resources/Images}/Feather.png | Bin .../Images}/Feather_large.png | Bin .../Images}/Feather_medium.png | Bin .../Images}/Feather_small.png | Bin .../exampleimages/Celestial.png | Bin .../exampleimages/Cosmic.png | Bin .../exampleimages/Ocean.png | Bin .../exampleimages/Skeleton.png | Bin .../exampleimages/imgui.ini | 0 .../exampleimages/naranja.png | Bin .../exampleimages/test.png | Bin .../exampleimages/test2.png | Bin {resoruces => resources}/fonts/consolas.ttf | Bin .../fonts/icon_regular.ttf | Bin {resoruces => resources}/fonts/icon_solid.ttf | Bin .../icons/Black_Brush.png | Bin .../icons/Black_Pencil.png | Bin .../icons/Black_Rubber.png | Bin {resoruces => resources}/icons/Brush.png | Bin {resoruces => resources}/icons/Pencil.png | Bin {resoruces => resources}/icons/Rubber.png | Bin stb_image.h | 8007 ------------ 52 files changed, 6724 insertions(+), 13268 deletions(-) rename pathwork.cpp => Directories/pathwork.cpp (100%) create mode 100644 Directories/pathwork.h delete mode 100644 Feather.exe create mode 100644 GUI/ExternGUI/ConfigMenu.cpp create mode 100644 GUI/ExternGUI/DebugConsole.cpp create mode 100644 GUI/ExternGUI/ErrorWindows.cpp create mode 100644 GUI/ExternGUI/ImageSaveLoad.cpp create mode 100644 GUI/ExternGUI/newImage.cpp rename IconsFontAwesome.h => GUI/IconsFontAwesome.h (100%) create mode 100644 GUI/MainGUI/ImageDisplayers.cpp create mode 100644 GUI/MainGUI/Info.cpp create mode 100644 GUI/MainGUI/Layers.cpp create mode 100644 GUI/MainGUI/Menu.cpp create mode 100644 GUI/MainGUI/Properties.cpp create mode 100644 GUI/MainGUI/ToolProperties.cpp create mode 100644 GUI/MainGUI/Tools.cpp create mode 100644 GUI/feathergui.cpp rename feathergui.h => GUI/feathergui.h (85%) rename stb.cpp => ImageIO/stb.cpp (76%) create mode 100644 ImageWork/ImageWork.cpp rename ImageWork.h => ImageWork/ImageWork.h (99%) delete mode 100644 pathwork.h rename {Images => resources/Images}/Feather.ico (100%) rename {Images => resources/Images}/Feather.png (100%) rename {Images => resources/Images}/Feather_large.png (100%) rename {Images => resources/Images}/Feather_medium.png (100%) rename {Images => resources/Images}/Feather_small.png (100%) rename {resoruces => resources}/exampleimages/Celestial.png (100%) rename {resoruces => resources}/exampleimages/Cosmic.png (100%) rename {resoruces => resources}/exampleimages/Ocean.png (100%) rename {resoruces => resources}/exampleimages/Skeleton.png (100%) rename {resoruces => resources}/exampleimages/imgui.ini (100%) rename {resoruces => resources}/exampleimages/naranja.png (100%) rename {resoruces => resources}/exampleimages/test.png (100%) rename {resoruces => resources}/exampleimages/test2.png (100%) rename {resoruces => resources}/fonts/consolas.ttf (100%) rename {resoruces => resources}/fonts/icon_regular.ttf (100%) rename {resoruces => resources}/fonts/icon_solid.ttf (100%) rename {resoruces => resources}/icons/Black_Brush.png (100%) rename {resoruces => resources}/icons/Black_Pencil.png (100%) rename {resoruces => resources}/icons/Black_Rubber.png (100%) rename {resoruces => resources}/icons/Brush.png (100%) rename {resoruces => resources}/icons/Pencil.png (100%) rename {resoruces => resources}/icons/Rubber.png (100%) delete mode 100644 stb_image.h diff --git a/pathwork.cpp b/Directories/pathwork.cpp similarity index 100% rename from pathwork.cpp rename to Directories/pathwork.cpp diff --git a/Directories/pathwork.h b/Directories/pathwork.h new file mode 100644 index 0000000..5e0c4b5 --- /dev/null +++ b/Directories/pathwork.h @@ -0,0 +1,20 @@ +#ifndef PATHWORK +#define PATHWORK + +#include "../GUI/feathergui.h" + +std::string getCurrentPath(); + +std::string getNormalizedPath(); + +#ifdef WINDOWS_SO +std::string browseFile(HWND hwnd); +std::string browseFolder(HWND hwnd, int _option); +#endif + +#ifdef LINUX_SO +std::string browse(); +#endif + + +#endif \ No newline at end of file diff --git a/Feather.exe b/Feather.exe deleted file mode 100644 index 820f6d231a9026c8d8f2297b7b8960f46ee964f4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2511360 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℘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≷VH#ADuCq1zOFbX|0TW!buqSCP~E| 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Í<7ssrjxyXvW;p=J}WG9~F5YKq$ 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]cIVi%73%5UU}ha>(!bMS#m>PN;y>^_Xh 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

    wG%@D5JoZE*E>RB)4a-ZnA^hJl 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�D<^EuIbpZZr=Tv3ag-U>-ka*(VgJNjkC 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%0A!Z1-&^k5A7W$&$xIRBGw&(GeQ~RQ>eHc$XzAvU} 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 zld�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 diff --git a/Feather.rc b/Feather.rc index b7cd837..10bc3db 100644 --- a/Feather.rc +++ b/Feather.rc @@ -52,7 +52,7 @@ END // Icon with lowest ID value placed first to ensure application icon // remains consistent on all systems. -FEATHER_ICON ICON "Images\\Feather.ico" +FEATHER_ICON ICON "resources\\Images\\Feather.ico" #endif // Español (España, alfabetización internacional) resources ///////////////////////////////////////////////////////////////////////////// diff --git a/Feather.vcxproj b/Feather.vcxproj index 62af055..8475f94 100644 --- a/Feather.vcxproj +++ b/Feather.vcxproj @@ -126,6 +126,7 @@ true C:\Users\carlo\Documents\LibC\glfw-3.3.7.bin.WIN64\include;%(AdditionalIncludeDirectories) stdcpp20 + MultiThreadedDLL Windows @@ -139,7 +140,21 @@ - + + + + + + + + + + + + + + + @@ -149,17 +164,16 @@ - - - + + + - - + diff --git a/Feather.vcxproj.filters b/Feather.vcxproj.filters index 1966f2b..60f2b9c 100644 --- a/Feather.vcxproj.filters +++ b/Feather.vcxproj.filters @@ -19,23 +19,35 @@ {963cb797-1d92-4463-99cc-12deca6daaaf} - - {075a36a7-932d-48d1-9ae3-d14737ba6156} + + {278c0ad6-5a61-41d2-995f-752fe44f6ddb} - - {afbdcc1e-6263-4c18-96c0-1af75522bf41} + + {bf78892e-33aa-4186-be87-9185908c982c} + + + {e9cfdd78-d384-48f4-ab19-308976b53c99} - {b50a1d50-8bc0-4025-be08-36dc2f6bd438} + {dbf196c5-adc3-40d7-a0b9-0fbbc5dcaf7e} - {266a3c1a-74f8-452d-927d-0bfffedd6297} + {81ae82e3-0c7f-42d9-9382-f6ea79ee1559} + + + {ba448c00-060f-49f4-b3da-e4af87c17b33} + + + {be8968ff-d790-4055-80b0-79f385e53a7f} - {bd86191c-be4a-4508-8021-984ae8879f03} + {8a8014b5-d0aa-4430-a660-f8c91aa353ce} - - {278c0ad6-5a61-41d2-995f-752fe44f6ddb} + + {b5e6329c-40b4-4635-8cd5-9ae888ca72f7} + + + {ea7dd477-c572-4ddc-9883-6901cbe7ce0c} @@ -63,17 +75,53 @@ Archivos de origen - - Archivos de origen\ImageIO + + Archivos de origen\ImageWork + + + Archivos de origen\GUI - + Archivos de origen\Directories - - Archivos de origen + + Archivos de origen\ImageIO - - Archivos de origen\ImageWork + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\ExternGUI + + + Archivos de origen\GUI\ExternGUI + + + Archivos de origen\GUI\ExternGUI + + + Archivos de origen\GUI\MainGUI + + + Archivos de origen\GUI\ExternGUI + + + Archivos de origen\GUI\ExternGUI @@ -104,28 +152,31 @@ Archivos de encabezado\Imgui - - Archivos de encabezado\ImageIO + + Archivos de encabezado - - Archivos de encabezado\ImageIO + + Archivos de encabezado\Imgui - - Archivos de encabezado\ImageIO + + Archivos de encabezado\GUI + + + Archivos de encabezado\GUI - + Archivos de encabezado\Directories - - Archivos de encabezado + + Archivos de encabezado\ImageIO - - Archivos de encabezado + + Archivos de encabezado\ImageIO - - Archivos de encabezado\Imgui + + Archivos de encabezado\ImageIO - + Archivos de encabezado\ImageWork diff --git a/GUI/ExternGUI/ConfigMenu.cpp b/GUI/ExternGUI/ConfigMenu.cpp new file mode 100644 index 0000000..fd28658 --- /dev/null +++ b/GUI/ExternGUI/ConfigMenu.cpp @@ -0,0 +1,38 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildConfigMenu() { + //PLACEMENT CONFIG WINDOW + ImGui::Begin("Placement Config", &this->placementConfig, ImGuiWindowFlags_AlwaysAutoResize); + //Create a slider for the toolsPanelPercentage + ImGui::SliderInt("Tools Panel Pixels", &this->toolsPanelPixels, 32, 128); + //Create a slider for the propertiesPanelPercentage + ImGui::SliderInt("Properties Panel Pixels", &this->propertiesPanelPixels, 128, 512); + + float color[4] = { GetBackGroundColor().r,GetBackGroundColor().g, GetBackGroundColor().b, 1.0F }; + //Change background color + ImGui::ColorEdit3("Background Color", color); + SetBackGroundColor(color[0], color[1], color[2]); + + //Separator + ImGui::Separator(); + ImGui::Text("Rounding Options"); + ImGui::SliderFloat("windowRounding", &this->windowRounding, 0.0F, 10.0F); + ImGui::SameLine(); + HelpMarker("Disable rounding by setting this to 0.0"); + //Disable options rounding + ImGui::Checkbox("Options Rounding", &this->disableOptionsRounding); + if (this->disableOptionsRounding) { + ImGui::GetStyle().FrameRounding = 0.0F; + } + else + { + ImGui::GetStyle().FrameRounding = 5.0F; + } + //Enable/disable sync + bool tempsync = this->Vsync; + ImGui::Checkbox("Vertical Sync", &tempsync); + if (tempsync != this->Vsync) { + this->SetSync(tempsync); + } + ImGui::End(); +} \ No newline at end of file diff --git a/GUI/ExternGUI/DebugConsole.cpp b/GUI/ExternGUI/DebugConsole.cpp new file mode 100644 index 0000000..6ef75ab --- /dev/null +++ b/GUI/ExternGUI/DebugConsole.cpp @@ -0,0 +1,38 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildConsoleDebugMenu() { + //DEBUG CONSOLE WINDOW + //Set max size of the window to 1/4 of the screen + ImGui::SetNextWindowSize(ImVec2(this->io->DisplaySize.x / 4, this->io->DisplaySize.y / 2), ImGuiCond_Always); + ImGui::Begin("Debug Console", &this->debugConsole, ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_AlwaysAutoResize); + //FPS + ImGui::Text("Application average %.3f ms/frame (%.1f FPS)", 1000.0f / ImGui::GetIO().Framerate, ImGui::GetIO().Framerate); + //Print the mouse + ImGui::Text("Mouse Position: (%d, %d)", this->MouseImagePositionX, this->MouseImagePositionY); + //Slider int + ImGui::Text("Movement X: %d", this->imageShiftX); + ImGui::Text("Movement Y: %d", this->imageShiftY); + //Print the zoom + ImGui::Text("Zoom: %.2f", this->zoom); + //Print the maximun zoom + ImGui::Text("Max Zoom: %.2f", this->maxZoom); + //Print the minimun zoom + ImGui::Text("Min Zoom: %.2f", this->minZoom); + + + ImGui::Separator(); + + //if (ss.str().c_str() != NULL) { + // //Get time and add a time mark using localtime_s + // time_t rawtime; + // struct tm now; + // char timeMark[80]; + // time(&rawtime); + // localtime_s(&now, &rawtime); + // strftime(timeMark, 80, "%H:%M:%S", &now); + //} + + + ImGui::Text("%s", ss.str().c_str()); + ImGui::End(); +} diff --git a/GUI/ExternGUI/ErrorWindows.cpp b/GUI/ExternGUI/ErrorWindows.cpp new file mode 100644 index 0000000..4cc0f53 --- /dev/null +++ b/GUI/ExternGUI/ErrorWindows.cpp @@ -0,0 +1,24 @@ +#include "../feathergui.h" + +void FeatherGUI::ErrorWindowCreateImage() { + if (this->errorWindowCreateImage) { + ImGui::OpenPopup("Error Creating Image"); + // Always center this window when appearing + ImVec2 center = ImGui::GetMainViewport()->GetCenter(); + ImGui::SetNextWindowPos(center, ImGuiCond_Appearing, ImVec2(0.5f, 0.5f)); + + //Show a BeginPopupModal dialog with error message "The size of the Image must be greater than 0. Also it need to have a name!\n\n" + if (ImGui::BeginPopupModal("Error Creating Image", NULL, ImGuiWindowFlags_AlwaysAutoResize)) + { + ImGui::SetItemDefaultFocus(); + ImGui::Text("Some of the following things were wrong: \n\n-> The size of the Image must be greater than 0.\n-> It need to have a name.\n\n"); + //ImGui::Separator(); + + if (ImGui::Button("OK")) { + this->errorWindowCreateImage = false; + ImGui::CloseCurrentPopup(); + } + ImGui::EndPopup(); + } + } +} \ No newline at end of file diff --git a/GUI/ExternGUI/ImageSaveLoad.cpp b/GUI/ExternGUI/ImageSaveLoad.cpp new file mode 100644 index 0000000..fbfaf6e --- /dev/null +++ b/GUI/ExternGUI/ImageSaveLoad.cpp @@ -0,0 +1,150 @@ +#include "../feathergui.h" + +bool FeatherGUI::loadImage(std::string _path) { + //Load texture from file + ImageStr unloadedImage; + unloadedImage.imagePath = _path; + std::cout << "Loading image: " << _path << std::endl; + //Get the numbers of channels in the image + int channels; + unsigned char* image = stbi_load(_path.c_str(), &unloadedImage.width, &unloadedImage.height, &channels, 0); + if (!image) { + std::cout << "Error Loading the Image: " << _path << std::endl; + return false; + } + unloadedImage.data = stbi_load(_path.c_str(), &unloadedImage.width, &unloadedImage.height, &unloadedImage.channels, channels); + if (!unloadedImage.data) { + fprintf(stderr, "Cannot load image '%s'\n", _path.c_str()); + unloadedImage.loaded = true; + return false; + } + + //free image + stbi_image_free(image); + + //Set the name of the image from the path + unloadedImage.name = _path.substr(_path.find_last_of('/') + 1); + unloadedImage.extension = _path.substr(_path.find_last_of('.') + 1); + std::cout << "Image extension: " << unloadedImage.extension << std::endl; + //Erase the extension of the name + unloadedImage.name = unloadedImage.name.substr(0, unloadedImage.name.find_last_of('.')); + std::cout << "Image name: " << unloadedImage.name << std::endl << std::endl; + + //Enable transparency + glDisable(GL_DEPTH_TEST); + glEnable(GL_BLEND); + glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); + + // Create a OpenGL texture identifier and binding + glGenTextures(1, &unloadedImage.texture); + glBindTexture(GL_TEXTURE_2D, unloadedImage.texture); + + // Setup filtering parameters for display + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); + // Upload pixels into texture +#if defined(GL_UNPACK_ROW_LENGTH) && !defined(__EMSCRIPTEN__) + glPixelStorei(GL_UNPACK_ROW_LENGTH, 0); +#endif + glPixelStorei(GL_UNPACK_ALIGNMENT, 1); + if (channels == 4) + { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, unloadedImage.width, unloadedImage.height, 0, GL_RGBA, GL_UNSIGNED_BYTE, unloadedImage.data); + } + else + { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, unloadedImage.width, unloadedImage.height, 0, GL_RGB, GL_UNSIGNED_BYTE, unloadedImage.data); + } + stbi_image_free(unloadedImage.data); + + //Reserve memory for the image + unloadedImage.data = new GLubyte[unloadedImage.width * unloadedImage.height * unloadedImage.channels]; + + if (channels == 4) + { + glGetTexImage(GL_TEXTURE_2D, 0, GL_RGBA, GL_UNSIGNED_BYTE, unloadedImage.data); + } + else + { + glGetTexImage(GL_TEXTURE_2D, 0, GL_RGB, GL_UNSIGNED_BYTE, unloadedImage.data); + } + + unloadedImage.loaded = true; + + //Add image to Images vector + this->Images->push_back(unloadedImage); + + return true; +} + +bool FeatherGUI::loadIcon(std::string _path) { + //Load texture from file + ImageStr unloadedImage; + unloadedImage.imagePath = _path; + std::cout << "Loading icon: " << _path << std::endl; + int channels; + unsigned char* image = stbi_load(_path.c_str(), &unloadedImage.width, &unloadedImage.height, &channels, 0); + if (!image) { + std::cout << "Error Loading the icon: " << _path << std::endl; + return false; + } + unloadedImage.data = stbi_load(_path.c_str(), &unloadedImage.width, &unloadedImage.height, &unloadedImage.channels, channels); + if (!unloadedImage.data) { + fprintf(stderr, "Cannot load icon '%s'\n", _path.c_str()); + unloadedImage.loaded = true; + return false; + } + + //free image + stbi_image_free(image); + + //Set the name of the image from the path + unloadedImage.name = _path.substr(_path.find_last_of('/') + 1); + unloadedImage.extension = _path.substr(_path.find_last_of('.') + 1); + std::cout << "Icon extension: " << unloadedImage.extension << std::endl; + //Erase the extension of the name + unloadedImage.name = unloadedImage.name.substr(0, unloadedImage.name.find_last_of('.')); + std::cout << "Icon name: " << unloadedImage.name << std::endl << std::endl; + + // Create a OpenGL texture identifier and binding + glGenTextures(1, &unloadedImage.texture); + glBindTexture(GL_TEXTURE_2D, unloadedImage.texture); + + // Setup filtering parameters for display + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); + + // Upload pixels into texture +#if defined(GL_UNPACK_ROW_LENGTH) && !defined(__EMSCRIPTEN__) + glPixelStorei(GL_UNPACK_ROW_LENGTH, 0); +#endif + glPixelStorei(GL_UNPACK_ALIGNMENT, 1); + if (channels == 4) { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, unloadedImage.width, unloadedImage.height, 0, GL_RGBA, GL_UNSIGNED_BYTE, unloadedImage.data); + } + else { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, unloadedImage.width, unloadedImage.height, 0, GL_RGB, GL_UNSIGNED_BYTE, unloadedImage.data); + } + stbi_image_free(unloadedImage.data); + + unloadedImage.loaded = true; + + //Add image to Images vector + toolsIcons.push_back(unloadedImage); + + return true; +} + +bool FeatherGUI::saveImage(std::string _path) { + if (_path.size() == 0) + { + std::cout << "Error saving image: No path specified" << std::endl; + return false; + } + std::string location; + //_path includes the name of the image + location = _path + "." + this->CurrentImage->extension; + std::cout << "Image saved at: " << location << std::endl; + stbi_write_png(location.c_str(), this->CurrentImage->width, this->CurrentImage->height, this->CurrentImage->channels, this->CurrentImage->data, this->CurrentImage->width * this->CurrentImage->channels); + return true; +} \ No newline at end of file diff --git a/GUI/ExternGUI/newImage.cpp b/GUI/ExternGUI/newImage.cpp new file mode 100644 index 0000000..6bb8421 --- /dev/null +++ b/GUI/ExternGUI/newImage.cpp @@ -0,0 +1,101 @@ +#include "../feathergui.h" + +void FeatherGUI::newImage() { + + //make buttons, sliders, radiobuttons white + ImGui::PushStyleColor(ImGuiCol_Button, ImVec4(0.25F, 0.25F, 0.25F, 1.20F)); + //Make overbutton selection white + ImGui::PushStyleColor(ImGuiCol_ButtonHovered, ImVec4(0.75F, 0.75F, 0.75F, 1.20F)); + //Make textbox gray + ImGui::PushStyleColor(ImGuiCol_FrameBg, ImVec4(0.25F, 0.25F, 0.25F, 1.20F)); + + ImVec2 center = ImGui::GetMainViewport()->GetCenter(); + ImGui::SetNextWindowPos(center, ImGuiCond_Appearing, ImVec2(0.5f, 0.5f)); + + //Create a new window to ask for the new image size and the new image name + if (ImGui::Begin(ICON_FA_IMAGE " New Image", &this->newImagePopUp, ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_AlwaysAutoResize)) + { + ImGui::InputText("Image Name", this->newImageName, 100); + ImGui::InputInt("Image Width", &this->newImageWidth); + ImGui::InputInt("Image Height", &this->newImageHeight); + ImGui::Checkbox("Transparency", &this->newImageTransparency); + + //If the user press the OK button + if (ImGui::Button("Create Image")) { + //check if the image size is bigger than 0 + if (this->newImageWidth > 0 && this->newImageHeight > 0 && this->newImageName[0] != '\0') { + ImageStr blank; + //Create a new image with the given parameters + blank.name = this->newImageName; + blank.width = this->newImageWidth; + blank.height = this->newImageHeight; + blank.extension = "png"; + + if (this->newImageTransparency) + { + blank.channels = 4; + } + else + { + blank.channels = 3; + } + + blank.data = new unsigned char[blank.width * blank.height * blank.channels]; + //For every pixel set it white + for (int i = 0; i < blank.width * blank.height * blank.channels; i++) { + blank.data[i] = 255; + } + + //Enable transparency + glDisable(GL_DEPTH_TEST); + glEnable(GL_BLEND); + glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); + + // Create a OpenGL texture identifier and binding + glGenTextures(1, &blank.texture); + glBindTexture(GL_TEXTURE_2D, blank.texture); + + // Setup filtering parameters for display + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); + // Upload pixels into texture +#if defined(GL_UNPACK_ROW_LENGTH) && !defined(__EMSCRIPTEN__) + glPixelStorei(GL_UNPACK_ROW_LENGTH, 0); +#endif + glPixelStorei(GL_UNPACK_ALIGNMENT, 1); + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, blank.width, blank.height, 0, GL_RGB, GL_UNSIGNED_BYTE, blank.data); + + //Add the new image to the image list + this->Images->push_back(blank); + //Set the new image as the current image + workStation.selectFrontImage(); + this->centerImage(); + + *this->newImageName = {}; + //Close the window + this->newImagePopUp = false; + } + else + { + this->errorWindowCreateImage = true; + } + } + //Show Buttons on the same line + ImGui::SameLine(); + + if (ImGui::Button("Cancel")) { + *this->newImageName = {}; + this->newImagePopUp = false; + } + + ImGui::End(); + } + + //Show Error Windows in case of error + this->ErrorWindowCreateImage(); + + //Pop style + ImGui::PopStyleColor(); + ImGui::PopStyleColor(); + ImGui::PopStyleColor(); +} \ No newline at end of file diff --git a/IconsFontAwesome.h b/GUI/IconsFontAwesome.h similarity index 100% rename from IconsFontAwesome.h rename to GUI/IconsFontAwesome.h diff --git a/GUI/MainGUI/ImageDisplayers.cpp b/GUI/MainGUI/ImageDisplayers.cpp new file mode 100644 index 0000000..0205338 --- /dev/null +++ b/GUI/MainGUI/ImageDisplayers.cpp @@ -0,0 +1,115 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildImageDisplayer() { + //IMAGE WINDOW + ImGui::SetNextWindowPos(ImVec2((float)(static_cast(this->toolsPanelPixels) / static_cast(this->windowWidth)) * (float)io->DisplaySize.x, (float)this->MenuSizePixels), ImGuiCond_Always); + ImGui::SetNextWindowSize(ImVec2((1.0F - (float)(static_cast(this->toolsPanelPixels + this->propertiesPanelPixels) / static_cast(this->windowWidth))) * io->DisplaySize.x, io->DisplaySize.y - this->MenuSizePixels - this->infoPanelPixels), ImGuiCond_Always); + ImGui::Begin("Image Window", NULL, ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoBringToFrontOnFocus | ImGuiWindowFlags_NoBackground | ImGuiWindowFlags_NoScrollWithMouse); + + //Check if this windows is in the top and nothing else is over it + if (ImGui::IsItemActive() && ImGui::IsWindowHovered(ImGuiHoveredFlags_RootAndChildWindows)) { + this->MouseOverImageWindow = true; + } + else + { + this->MouseOverImageWindow = false; + } + + //Move the image + ImGui::SetCursorPos(ImVec2((float)this->imageShiftX, (float)this->imageShiftY)); + //Draw Image + if (!this->Images->empty()) { + if (this->CurrentImage->data != NULL) { + ImGui::Image((void*)(intptr_t)this->CurrentImage->texture, ImVec2(this->CurrentImage->width * this->zoom, this->CurrentImage->height * this->zoom)); + } + } + + ImGui::End(); +} + +void FeatherGUI::calculateZoom() { + //Whit the size of the image and the size of the screen, calculate the zoom to fit the image in the screen letting 32 pixels of space on the closest side + //If the image is taller than widder then the image will be zoomed in vertically and horizontally + //If the image is wider than taller then the image will be zoomed in horizontally and vertically + + //Window Sizes + int size_x = static_cast((1.0F - (float)(static_cast(this->toolsPanelPixels + this->propertiesPanelPixels) / static_cast(this->windowWidth))) * io->DisplaySize.x); + int size_y = static_cast(io->DisplaySize.y - this->MenuSizePixels - this->infoPanelPixels); + + //Image Sizes + int image_x = this->CurrentImage->width; + int image_y = this->CurrentImage->height; + + //Calculate the zoom to fit the image in the secreen + if (image_x / size_x > image_y / size_y) { + this->zoom = (float)size_x / ((float)image_x + 32.0F); + } + else { + this->zoom = (float)size_y / ((float)image_y + 32.0F); + } + + //TODO Improve this + + //Set the minimun to fit 100 pixels in a pixel + this->minZoom = 100.0F / ((float)image_x); + + float diff = this->zoom - this->minZoom; + + //Set the max zoom with the diff multiplied by the factor of adjust + this->maxZoom = this->zoom + diff * 32; + + //Set the increment in the 1% of the diference between min and max + this->zoomIncrement = (this->maxZoom - this->minZoom) / 100.0F; + + std::cout << "Adjusting zoom of " << this->CurrentImage->name << std::endl; + std::cout << "Adjusted Zoom to: " << this->zoom << std::endl; + std::cout << "Adjusted Max Zoom: " << this->maxZoom << std::endl; + std::cout << "Adjusted Min Zoom: " << this->minZoom << std::endl; + std::cout << "Adjusted Zoom Increment: " << this->zoomIncrement << std::endl; +} + +void FeatherGUI::centerImage() { + calculateZoom(); + //Center X is (1-(x+z))/2+x, where x is toolsPanelPixels and z is propertiesPanelPixels, substract the size of the image + this->imageShiftX = static_cast((1.0F - (float)(static_cast(this->toolsPanelPixels + this->propertiesPanelPixels) / static_cast(this->windowWidth))) * io->DisplaySize.x / 2.0F - (this->CurrentImage->width * this->zoom / 2.0F)); + //Center Y is the size of the screen minus the size of the image divided by 2 + this->imageShiftY = static_cast((io->DisplaySize.y - this->infoPanelPixels - this->MenuSizePixels) / 2.0F - (this->CurrentImage->height * this->zoom / 2.0F)); + + std::cout << "Adjusted Image Shift X: " << this->imageShiftX << std::endl; + std::cout << "Adjusted Image Shift Y: " << this->imageShiftY << std::endl; +} + +void FeatherGUI::UpdateImage() { + //Select current texture and bind it + glBindTexture(GL_TEXTURE_2D, this->CurrentImage->texture); + + //Method 1: Update the entire image + //glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, this->CurrentImage->width, this->CurrentImage->height, 0, GL_RGB, GL_UNSIGNED_BYTE, this->CurrentImage->data); + + //Method 2: Update the rectangle of the image that has been modified during the interpolation + //Calculate the width and height of the rectangl0e + int width = workStation.getInterpolationMax().first - workStation.getInterpolationMin().first + 1; + int height = workStation.getInterpolationMax().second - workStation.getInterpolationMin().second + 1; + + //Create and reserve a pixel array to store the rectangle of the image + unsigned char* pixel = new unsigned char[width * height * this->CurrentImage->channels]; + //Store the image data in the pixel array + for (int i = 0; i < height; i++) { + for (int j = 0; j < width; j++) { + for (int k = 0; k < this->CurrentImage->channels; k++) { + pixel[(i * width + j) * this->CurrentImage->channels + k] = this->CurrentImage->data[((i + workStation.getInterpolationMin().second) * this->CurrentImage->width + j + workStation.getInterpolationMin().first) * this->CurrentImage->channels + k]; + } + } + } + + if (this->CurrentImage->channels == 4) + { + glTexSubImage2D(GL_TEXTURE_2D, 0, workStation.getInterpolationMin().first, workStation.getInterpolationMin().second, width, height, GL_RGBA, GL_UNSIGNED_BYTE, pixel); + } + else + { + glTexSubImage2D(GL_TEXTURE_2D, 0, workStation.getInterpolationMin().first, workStation.getInterpolationMin().second, width, height, GL_RGB, GL_UNSIGNED_BYTE, pixel); + } + //Delete the pixel array + delete[] pixel; +} \ No newline at end of file diff --git a/GUI/MainGUI/Info.cpp b/GUI/MainGUI/Info.cpp new file mode 100644 index 0000000..d185bcf --- /dev/null +++ b/GUI/MainGUI/Info.cpp @@ -0,0 +1,39 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildInfo() { + //INFO WINDOW + ImGui::SetNextWindowPos(ImVec2(0, this->io->DisplaySize.y - this->infoPanelPixels), ImGuiCond_Always); + ImGui::SetNextWindowSize(ImVec2(this->io->DisplaySize.x, (float)this->infoPanelPixels), ImGuiCond_Always); + ImGui::PushStyleColor(ImGuiCol_WindowBg, this->colorSelectedWindow); + //Adjust the font size to fit the window + ImGui::Begin("Info Bar", NULL, ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoBringToFrontOnFocus); + //TODO + { + //Check first if the mouse is over the Image Window + if (this->MouseImagePositionX >= 0 && this->MouseImagePositionX < this->CurrentImage->width && + this->MouseImagePositionY >= 0 && this->MouseImagePositionY < this->CurrentImage->height) { + ImGui::Text("Current Pixel: (%d, %d)", this->MouseImagePositionX + 1, this->MouseImagePositionY + 1); + + //Read from the texture of opengl and Get the color of the pixel + ImGui::SameLine(); + int index = (this->MouseImagePositionY * this->CurrentImage->width + this->MouseImagePositionX) * this->CurrentImage->channels; + if (this->CurrentImage->channels == 4) { + ImGui::Text(" | Color: (%d, %d, %d, %d)", this->CurrentImage->data[index], this->CurrentImage->data[index + 1], this->CurrentImage->data[index + 2], this->CurrentImage->data[index + 3]); + } + else + { + ImGui::Text(" | Color: (%d, %d, %d)", this->CurrentImage->data[index], this->CurrentImage->data[index + 1], this->CurrentImage->data[index + 2]); + } + } + else + { + ImGui::Text("Current Pixel: (-,-)"); + } + //Print the zoom on the same line + ImGui::SameLine(); + ImGui::Text(" | Zoom: %.2f", this->zoom); + } + //TODOEND + ImGui::End(); + ImGui::PopStyleColor(); +} \ No newline at end of file diff --git a/GUI/MainGUI/Layers.cpp b/GUI/MainGUI/Layers.cpp new file mode 100644 index 0000000..ff74ea5 --- /dev/null +++ b/GUI/MainGUI/Layers.cpp @@ -0,0 +1,49 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildLayers() { + //LAYER WINDOW + float temp_percentage = ((float)(static_cast(this->propertiesPanelPixels) / static_cast(this->windowWidth))); + ImGui::SetNextWindowPos(ImVec2((1.0F - temp_percentage) * this->io->DisplaySize.x, (this->io->DisplaySize.y + this->MenuSizePixels) / 2), ImGuiCond_Always); + ImGui::SetNextWindowSize(ImVec2(temp_percentage * this->io->DisplaySize.x, (this->io->DisplaySize.y - this->MenuSizePixels) / 2 - this->infoPanelPixels), ImGuiCond_Always); + //TODO + ImGui::Begin("Layers Menu", NULL, ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoBringToFrontOnFocus); + if (ImGui::BeginTabBar("Layers", ImGuiTabBarFlags_None)) { + if (ImGui::BeginTabItem("Layers")) { + ImGuiStyle& style = ImGui::GetStyle(); + + ImVec2 windowPosition = ImGui::GetWindowPos(); + ImVec2 cursorPosition = ImGui::GetCursorPos(); + + // this is not a pixel perfect position + // you can try to make it more accurate by adding some offset + ImVec2 itemPosition( + windowPosition.x + cursorPosition.x, + windowPosition.y + cursorPosition.y - style.ItemSpacing.y + ); + + for (int i = 0; i < this->Images->size(); i++) { + ImGui::Image((void*)(intptr_t)this->Images->at(i).texture, ImVec2(100 * temp_percentage, 100 * temp_percentage)); + ImGui::SameLine(); + ImGui::Selectable(this->Images->at(i).name.c_str()); + + if (ImGui::IsItemActive() && ImGui::IsMouseDragging(0)) + { + int n_next = static_cast(floorf((ImGui::GetMousePos().y - itemPosition.y) / 25)); //25 is the height of the item + + if (n_next >= 0 && n_next < this->Images->size()) + { + std::swap(this->Images->at(i), this->Images->at(n_next)); + workStation.selectFrontImage(); + centerImage(); + } + } + ImGui::Separator(); + } + ImGui::EndTabItem(); + } + ImGui::EndTabBar(); + } + //TODOEND + ImGui::End(); + ImGui::PopStyleColor(); +} \ No newline at end of file diff --git a/GUI/MainGUI/Menu.cpp b/GUI/MainGUI/Menu.cpp new file mode 100644 index 0000000..9de2720 --- /dev/null +++ b/GUI/MainGUI/Menu.cpp @@ -0,0 +1,120 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildMenu() { + //Create a main menu + if (ImGui::BeginMainMenuBar()) { + if (ImGui::BeginMenu(ICON_FA_FILE_ALT " File")) { + if (ImGui::MenuItem(ICON_FA_FILE_IMAGE " New", "|Ctrl+N")) { + this->newImagePopUp = true; + std::cout << "Opened New Image window Pop Up" << std::endl; + } + if (ImGui::MenuItem(ICON_FA_FILE " Open", "|Ctrl+O")) { + std::string filename; + filename = browseFile(0); + //If the filename doesnt have ":" error + if (filename.find(':') == std::string::npos) { + std::cout << "No file selected" << std::endl; + } + else + { + //load the image + if (!loadImage(filename)) + { + std::cout << "Error loading image" << std::endl; + } + else + { + workStation.selectFrontImage(); + this->centerImage(); + } + } + } + if (ImGui::MenuItem(ICON_FA_SAVE " Save", "|Ctrl+S")) { + std::string folderName; + folderName = browseFolder(0, 0); + //If the foldername doesnt have ":" error + if (folderName.find(':') == std::string::npos) { + std::cout << "No folder selected" << std::endl; + } + else + { + if (!saveImage(folderName)) { + std::cout << "Error saving image" << std::endl; + } + else { + std::cout << "Image saved" << std::endl; + } + } + } + if (ImGui::MenuItem(ICON_FA_SAVE " Save As", "|Ctrl+Shift+S")) { + std::string folderName; + folderName = browseFolder(0, 1); + //If the foldername doesnt have ":" error + if (folderName.find(':') == std::string::npos) { + std::cout << "No folder selected" << std::endl; + } + else + { + if (!saveImage(folderName)) { + std::cout << "Error saving image" << std::endl; + } + else { + std::cout << "Image saved" << std::endl; + } + } + } + ImGui::Separator(); + if (ImGui::MenuItem(ICON_FA_WINDOW_CLOSE " Close", "|Alt+F4")) { + //Free every image + for (int i = 0; i < this->Images->size(); i++) { + //Free the image + glDeleteTextures(1, &this->Images->at(i).texture); + //delete Image data + delete this->Images->at(i).data; + } + this->isOpen = false; + } + ImGui::EndMenu(); + } + ImGui::Separator(); + //Edit + if (ImGui::BeginMenu(ICON_FA_EDIT " Edit")) { + ImGui::EndMenu(); + } + //Add a separator + ImGui::Separator(); + //Layer + if (ImGui::BeginMenu(ICON_FA_IMAGES " Layer")) { + ImGui::EndMenu(); + } + ImGui::Separator(); + //Filter + if (ImGui::BeginMenu(ICON_FA_OBJECT_UNGROUP " Filter")) { + ImGui::EndMenu(); + } + ImGui::Separator(); + //Windows + if (ImGui::BeginMenu(ICON_FA_WINDOW_MAXIMIZE " Windows")) { + ImGui::EndMenu(); + } + ImGui::Separator(); + //Settings + if (ImGui::BeginMenu(ICON_FA_SUN " Settings")) { + if (ImGui::MenuItem(" GUI Placements", "|Ctrl+Alt+D")) { + std::cout << "Placement GUI opened" << std::endl; + this->placementConfig = true; + } + if (ImGui::MenuItem(" GUI Colors", "|Ctrl+Alt+G")) { + + } + if (ImGui::MenuItem(" GUI Fonts", "|Ctrl+Alt+F")) { + + } + if (ImGui::MenuItem(" Open Debug Log", "|Ctrl+Alt+C")) { + this->debugConsole = true; + } + ImGui::EndMenu(); + } + ImGui::EndMainMenuBar(); + } +} \ No newline at end of file diff --git a/GUI/MainGUI/Properties.cpp b/GUI/MainGUI/Properties.cpp new file mode 100644 index 0000000..dad75a4 --- /dev/null +++ b/GUI/MainGUI/Properties.cpp @@ -0,0 +1,27 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildProperties() { + //PROPERTIES WINDOW + float temp_percentage = ((float)(static_cast(this->propertiesPanelPixels) / static_cast(this->windowWidth))); + ImGui::SetNextWindowPos(ImVec2((1.0F - temp_percentage) * this->io->DisplaySize.x, (float)this->MenuSizePixels), ImGuiCond_Always); + ImGui::SetNextWindowSize(ImVec2(temp_percentage * this->io->DisplaySize.x, (this->io->DisplaySize.y - this->MenuSizePixels) / 2), ImGuiCond_Always); + ImGui::PushStyleColor(ImGuiCol_WindowBg, this->colorSelectedWindow); + ImGui::Begin("Properties Menu", NULL, ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoBringToFrontOnFocus); + //TODO + //TabItem + if (ImGui::BeginTabBar("Properties", ImGuiTabBarFlags_None)) { + if (ImGui::BeginTabItem("Images")) { + ImGui::Text("Data of the Image"); + ImGui::Separator(); + ImGui::Text("Identifier: %d", this->CurrentImage->texture); + ImGui::Text("Size = %d x %d", this->CurrentImage->width, CurrentImage->height); + ImGui::Text("Channels: %d", this->CurrentImage->channels); + ImGui::EndTabItem(); + } + ImGui::EndTabBar(); + ImGui::Separator(); + //If pencil tool is selected + this->BuildToolProperties(); + } + ImGui::End(); +} \ No newline at end of file diff --git a/GUI/MainGUI/ToolProperties.cpp b/GUI/MainGUI/ToolProperties.cpp new file mode 100644 index 0000000..6a84b2d --- /dev/null +++ b/GUI/MainGUI/ToolProperties.cpp @@ -0,0 +1,20 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildToolProperties() { + RGB temp_color_RGB = this->workStation.getToolColor(); + float temp_color[4] = { temp_color_RGB.r,temp_color_RGB.g, temp_color_RGB.b, 1.0F }; + switch (this->CurrentTool) + { + case 0: + //Create a ColorEdit3 + ImGui::ColorEdit3("Color", temp_color); + temp_color_RGB.r = temp_color[0]; + temp_color_RGB.g = temp_color[1]; + temp_color_RGB.b = temp_color[2]; + this->workStation.setToolColor(temp_color_RGB); + break; + + default: + break; + } +} \ No newline at end of file diff --git a/GUI/MainGUI/Tools.cpp b/GUI/MainGUI/Tools.cpp new file mode 100644 index 0000000..db41d1e --- /dev/null +++ b/GUI/MainGUI/Tools.cpp @@ -0,0 +1,60 @@ +#include "../feathergui.h" + +void FeatherGUI::BuildTools() { + //TOOLS WINDOW + //Create a window on the left maximized that occupies toolsPanelPixels of the space. + ImGui::SetNextWindowPos(ImVec2(0, (float)this->MenuSizePixels), ImGuiCond_Always); + ImGui::SetNextWindowSize(ImVec2((float)(static_cast(this->toolsPanelPixels) / static_cast(this->windowWidth)) * io->DisplaySize.x, io->DisplaySize.y - this->MenuSizePixels - this->infoPanelPixels - 1), ImGuiCond_Always); + ImGui::PushStyleColor(ImGuiCol_WindowBg, this->colorSelectedWindow); + ImGui::Begin("Tools Menu", NULL, ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResize | ImGuiWindowFlags_NoMove | ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoBringToFrontOnFocus); + //TODO + ImVec4 colorActualButton; + //For every icon in the folder + int temp_i; + for (int i = 0; i < this->toolsIcons.size() / 2; i++) { + temp_i = i; + if (this->whiteIcons) { + temp_i = i; + } + else + { + temp_i = static_cast(i + this->toolsIcons.size() / 2); + } + //Select the color for selected icon + if (this->CurrentTool == i) + { + colorActualButton = this->colorSelectedTool; + if (this->whiteIcons) + { + colorActualButton = this->colorSelectedTool; + temp_i = static_cast(i + this->toolsIcons.size() / 2); + } + else + { + colorActualButton = this->colorSelectedTool; + temp_i = i; + } + } + else + { + colorActualButton = this->colorNoSelectedTool; + } + //Create a iconbutton for each tool using the images of the icons vector with transparent background + if (ImGui::ImageButton((void*)(intptr_t)this->toolsIcons[temp_i].texture, ImVec2(static_cast(this->toolsPanelPixels / 2), static_cast(this->toolsPanelPixels / 2)), ImVec2(0, 0), ImVec2(1, 1), 0, colorActualButton)) { + //create a floatingtext with index + if (this->CurrentTool == i) + { + std::cout << "Tool " << i << " deselected" << std::endl; + this->CurrentTool = -1; + } + else + { + std::cout << "Tool " << i << " selected" << std::endl; + this->CurrentTool = i; + } + } + } + //TODOEND + ImGui::End(); + ImGui::PopStyleColor(); +} \ No newline at end of file diff --git a/GUI/feathergui.cpp b/GUI/feathergui.cpp new file mode 100644 index 0000000..375282d --- /dev/null +++ b/GUI/feathergui.cpp @@ -0,0 +1,341 @@ +#include "feathergui.h" + +//TODO +/* + -> Add all the options to the menu + -> Add the ability to change the icon size + -> Add a import export configuration + -> Add a configuration file + -> Fix the zoom + -> Add a configuration option to enable/disable the default zoom + -> Make the default zoom configurable + -> Sort and make the configuration menu more user friendly + -> Make more tools + -> Fix drawing lines with less than 1 of zoom + + # Search if there is any option to set the images into the executable +*/ + +FeatherGUI::FeatherGUI(GLFWwindow* _windowContext, const char* _glsl_version) +{ + this->windowContext = _windowContext; + glfwGetWindowSize(this->windowContext, &this->windowWidth, &this->windowHeight); + + // Initialize the Feather GUI + IMGUI_CHECKVERSION(); + ImGui::CreateContext(); + this->io = &ImGui::GetIO(); + (void)io; + //io->Fonts->AddFontDefault(); + this->CurrentFont = io->Fonts->AddFontFromFileTTF("./resources/fonts/consolas.ttf", 16); + ImGui::StyleColorsDark(); + + this->io->IniFilename = NULL; + + //Link the buffer + this->coutbuff = std::cout.rdbuf(); + std::cout.rdbuf(ss.rdbuf()); + + this->MouseImagePositionX = 0; + this->MouseImagePositionY = 0; + + //Windows + this->isOpen = true; + this->disableOptionsRounding = true; + this->placementConfig = false; + this->debugConsole = true; + this->newImagePopUp = false; + + //Error Windows + errorWindowCreateImage = false; + + //Image Default New Values + this->newImageWidth = 100; + this->newImageHeight = 100; + + //Fonts and Text + this->iconSize = 12.0; + + //Adding Icons + static const ImWchar icons_ranges[] = { ICON_MIN_FA, ICON_MAX_FA, 0 }; + ImFontConfig icons_config; icons_config.MergeMode = true; icons_config.PixelSnapH = true; + io->Fonts->AddFontFromFileTTF("./resources/fonts/icon_regular.ttf", this->getIconSize(), &icons_config, icons_ranges); + //Loading Icons + if (!loadIcon("./resources/icons/Pencil.png")) { + std::cout << "Error Loading the Image Pencil.png" << std::endl; + } + if (!loadIcon("./resources/icons/Brush.png")) { + std::cout << "Error Loading the Image Brush.png" << std::endl; + } + if (!loadIcon("./resources/icons/Rubber.png")) { + std::cout << "Error Loading the Image Rubber.jpg" << std::endl; + } + //Load the Black Icons + if (!loadIcon("./resources/icons/Black_Pencil.png")) { + std::cout << "Error Loading the Image Black Pencil.png" << std::endl; + } + if (!loadIcon("./resources/icons/Black_Brush.png")) { + std::cout << "Error Loading the Image Black Brush.png" << std::endl; + } + if (!loadIcon("./resources/icons/Black_Rubber.png")) { + std::cout << "Error Loading the Image Black Rubber.jpg" << std::endl; + } + + // Setup Platform/Renderer backends + ImGui_ImplGlfw_InitForOpenGL(_windowContext, true); + ImGui_ImplOpenGL3_Init(_glsl_version); + + this->windowRounding = 0.0F; + + //OPTION VARS + this->Vsync = true; + + this->BackGroundRGB.r = 0.25; + this->BackGroundRGB.g = 0.25; + this->BackGroundRGB.b = 0.25; + this->BackGroundRGB.delta = 1.0; + + this->whiteIcons = true; + + //Colors of the buttons when a tool is selected and when it is not + this->colorWindowBar = ImVec4(this->GetBackGroundColor().r - 0.5F, this->GetBackGroundColor().g - 0.05F, this->GetBackGroundColor().b - 0.05F, 1.0f); + this->colorSelectedWindow = ImVec4(this->GetBackGroundColor().r - 0.1F, this->GetBackGroundColor().g - 0.1F, this->GetBackGroundColor().b - 0.1F, 1.0f); + this->colorNoSelectedWindow = ImVec4(this->GetBackGroundColor().r - 0.90F, this->GetBackGroundColor().g - 0.90F, this->GetBackGroundColor().b - 0.90F, 1.0f); + this->colorNoSelectedTool = this->colorSelectedWindow; + this->colorSelectedTool = ImVec4(1.0F - this->BackGroundRGB.r, 1.0F - this->BackGroundRGB.g, 1.0F - this->BackGroundRGB.b, 1.0F); + + workStation.init(&Images,&CurrentImage); + + //set to false every loaded image in the vector + for (int i = 0; i < this->Images->size(); i++) { + Images->at(i).loaded = false; + } + + this->MouseOverImageWindow = false; + this->zoom = 1; + this->zoomIncrement = 0.1F; + this->maxZoom = 10.0F; + this->minZoom = 0.01F; + this->imageShiftX = 8; + this->imageShiftY = 8; + + //GUI PLACEMENTS + this->toolsPanelPixels = 32; + this->propertiesPanelPixels = 256; + this->infoPanelPixels = 32; + + //TOOLS VARs + this->CurrentTool = -1; +} + +FeatherGUI::~FeatherGUI() { + ImGui_ImplOpenGL3_Shutdown(); + ImGui_ImplGlfw_Shutdown(); + ImGui::DestroyContext(); +} + +void FeatherGUI::HelpMarker(const char* desc) +{ + ImGui::TextDisabled("(?)"); + if (ImGui::IsItemHovered()) + { + ImGui::BeginTooltip(); + ImGui::PushTextWrapPos(ImGui::GetFontSize() * 35.0f); + ImGui::TextUnformatted(desc); + ImGui::PopTextWrapPos(); + ImGui::EndTooltip(); + } +} + +void FeatherGUI::FloatingText(char* desc) { + FloatingText((const char*)desc); +} + +void FeatherGUI::FloatingText(const char* desc) { + if (ImGui::IsItemHovered()) + { + ImGui::BeginTooltip(); + ImGui::PushTextWrapPos(ImGui::GetFontSize() * 35.0f); + ImGui::TextUnformatted(desc); + ImGui::PopTextWrapPos(); + ImGui::EndTooltip(); + } +} + +void FeatherGUI::SetBackGroundColor(float r, float g, float b) { + this->BackGroundRGB.r = r; + this->BackGroundRGB.g = g; + this->BackGroundRGB.b = b; + + //if the colors is white (rgb > 128) set whiteIcons = false + if (this->BackGroundRGB.r > 0.5 && this->BackGroundRGB.g > 0.5 && this->BackGroundRGB.b > 0.5) { + this->whiteIcons = false; + } + else { + this->whiteIcons = true; + } + + //Colors of the buttons when a tool is selected and when it is not + this->colorWindowBar = ImVec4(this->GetBackGroundColor().r - 0.05F, this->GetBackGroundColor().g - 0.05F, this->GetBackGroundColor().b - 0.05F, 1.0f); + this->colorSelectedWindow = ImVec4(this->GetBackGroundColor().r - 0.1F, this->GetBackGroundColor().g - 0.1F, this->GetBackGroundColor().b - 0.1F, 1.0f); + this->colorNoSelectedWindow = ImVec4(this->GetBackGroundColor().r - 0.90F, this->GetBackGroundColor().g - 0.90F, this->GetBackGroundColor().b - 0.90F, 1.0f); + this->colorNoSelectedTool = this->colorSelectedWindow; + this->colorSelectedTool = ImVec4(1.0F - this->BackGroundRGB.r, 1.0F - this->BackGroundRGB.g, 1.0F - this->BackGroundRGB.b, 1.0F); +} + +RGB FeatherGUI::GetBackGroundColor() { + return this->BackGroundRGB; +} + +void FeatherGUI::InitGUI() { + ImGui_ImplOpenGL3_NewFrame(); + ImGui_ImplGlfw_NewFrame(); + ImGui::NewFrame(); +} + +void FeatherGUI::BuildGUI() { + + glfwGetWindowSize(this->windowContext, &this->windowWidth, &this->windowHeight); + //Make all menus rounds with window Rounding + ImGui::PushStyleVar(ImGuiStyleVar_WindowRounding, this->windowRounding); + //Make all menus red + ImGui::PushStyleColor(ImGuiCol_TitleBgActive, this->colorNoSelectedWindow); // Background of the windows + ImGui::PushStyleColor(ImGuiCol_TabActive, this->colorSelectedWindow); //Tabs in layer and options and selected tool + ImGui::PushStyleColor(ImGuiCol_Button, this->colorWindowBar); // Window + //BUILDGUI + { + //--------------------STATIC WINDOWS-------------------- + this->BuildMenu(); + if (this->isOpen) { + this->BuildTools(); + this->BuildImageDisplayer(); + this->BuildProperties(); + this->BuildLayers(); + this->BuildInfo(); + + + //--------------------DYNAMIC WINDOWS-------------------- + if (newImagePopUp) { + this->newImage(); + } + if (this->placementConfig) { + this->BuildConfigMenu(); + } + if (this->debugConsole) { + this->BuildConsoleDebugMenu(); + } + } + } + ImGui::PopStyleColor(); + ImGui::PopStyleColor(); + ImGui::PopStyleColor(); + ImGui::PopStyleVar(); + + //--------------------INPUT FUNTIONS-------------------- + this->InputFunctions(); +} + +void FeatherGUI::RenderGUI() { + ImGui::Render(); + ImGui_ImplOpenGL3_RenderDrawData(ImGui::GetDrawData()); +} + +void FeatherGUI::SetSync(bool _sync) { + if(_sync) { + this->Vsync = true; + glfwSwapInterval(1); + std::cout << "Vsync enabled" << std::endl; + } + else { + this->Vsync = false; + glfwSwapInterval(0); + std::cout << "Vsync disabled" << std::endl; + } +} + +bool FeatherGUI::GetSync() { + return this->Vsync; +} + +bool FeatherGUI::IsOpened() { + return this->isOpen; +} + +void FeatherGUI::setIconSize(float _size) { + this->iconSize = _size; +} + +float FeatherGUI::getIconSize() { + return this->iconSize; +} + +void FeatherGUI::InputFunctions() { + //Dragging the Image over the window + if (ImGui::IsMouseDown(1)) { + this->imageShiftX += static_cast(this->io->MouseDelta.x); + this->imageShiftY += static_cast(this->io->MouseDelta.y); + } + + //Double click set zoom to 1.0F and the image shift to the center of the Image Window + if (ImGui::IsMouseDoubleClicked(1)) { + std::cout << "Current Image: " << this->CurrentImage->name << std::endl; + this->centerImage(); + } + + //UP + if (io->MouseWheel > 0) { + //increase lineal zoom by 0.1 if this one is less than 3 + if (this->zoom < this->maxZoom) { + this->zoom += this->zoomIncrement; + } + } + //DOWN + if (io->MouseWheel < 0) { + //decrease lineal zoom by 0.1 if this one is greater than 0.1 + if (this->zoom > this->minZoom) { + this->zoom -= this->zoomIncrement; + } + } + + //ESC + if (io->KeysDown[GLFW_KEY_ESCAPE]) { + //Close the overlayer windows + this->placementConfig = false; + this->debugConsole = false; + this->newImagePopUp = false; + } + + //MOUSE + // Check if mouse is over the image window + if (this->MouseOverImageWindow) + { + //If the mouse is over the image + if (this->MouseImagePositionX >= 0 && this->MouseImagePositionX < this->CurrentImage->width && + this->MouseImagePositionY >= 0 && this->MouseImagePositionY < this->CurrentImage->height) { + //If mouse click or holded + if (ImGui::IsMouseClicked(0) || ImGui::IsMouseDragging(0) || ImGui::IsMouseDown(0)) { + if (this->CurrentTool != -1) { + workStation.useTool(this->CurrentTool, this->MouseImagePositionX, this->MouseImagePositionY); + this->UpdateImage(); + } + } + } + } + if (ImGui::IsMouseReleased(0)) { + //Clear the vector of the tool + workStation.clearMousePoints(); + +#ifdef DEBUG + std::cout << "Min x: " << workStation.getInterpolationMin().first << "Min Y:" << workStation.getInterpolationMin().second << std::endl; + std::cout << "Max x: " << workStation.getInterpolationMax().first << "Max Y:" << workStation.getInterpolationMax().second << std::endl; +#endif // DEBUG + + //Clear Pairs + workStation.clearMousePairs(); + } + + + //Position of the mouse inside the Image Window compensating the image shift and zoom + this->MouseImagePositionX = (int)floor(static_cast((this->io->MousePos.x - this->toolsPanelPixels - this->imageShiftX)) / (float)this->zoom); + this->MouseImagePositionY = (int)floor(static_cast((this->io->MousePos.y - this->MenuSizePixels - this->imageShiftY)) / (float)this->zoom); +} \ No newline at end of file diff --git a/feathergui.h b/GUI/feathergui.h similarity index 85% rename from feathergui.h rename to GUI/feathergui.h index 100515f..53d53c3 100644 --- a/feathergui.h +++ b/GUI/feathergui.h @@ -1,6 +1,10 @@ #ifndef FEATHERGUI #define FEATHERGUI +#define ICONPATH "/resources/Images/Feather.png" + +//#define DEBUG + #include #include #include @@ -10,16 +14,33 @@ #include #include +#define WINDOWS_SO +//#define LINUX_SO + +#ifdef WINDOWS_SO +#include +#include +#include +#endif + +#ifdef LINUX +#include +#include +#endif + #include -#include "imgui/imgui.h" -#include "imgui/imgui_impl_glfw.h" -#include "imgui/imgui_impl_opengl3.h" +#include "../imgui/imgui.h" +#include "../imgui/imgui_impl_glfw.h" +#include "../imgui/imgui_impl_opengl3.h" + +#include "../ImageIO/stb_image.h" +#include "../ImageIO/stb_image_write.h" -#include "ImageIO/stb_image.h" -#include "ImageIO/stb_image_write.h" +#include "../ImageWork/ImageWork.h" -#include "ImageWork.h" +#include "../Directories/pathwork.h" +#include "IconsFontAwesome.h" class FeatherGUI { @@ -158,5 +179,4 @@ class FeatherGUI RGB GetBackGroundColor(); }; -#endif // !FEATHERGUI - +#endif // !FEATHERGUI \ No newline at end of file diff --git a/stb.cpp b/ImageIO/stb.cpp similarity index 76% rename from stb.cpp rename to ImageIO/stb.cpp index 5a35465..d093bac 100644 --- a/stb.cpp +++ b/ImageIO/stb.cpp @@ -3,4 +3,4 @@ #define STBI_MSC_SECURE_CRT #define STB_IMAGE_WRITE_IMPLEMENTATION -#include "imageIO/stb_image_write.h" \ No newline at end of file +#include "../imageIO/stb_image_write.h" \ No newline at end of file diff --git a/ImageIO/stb_image.h b/ImageIO/stb_image.h index d60371b..eaf8699 100644 --- a/ImageIO/stb_image.h +++ b/ImageIO/stb_image.h @@ -372,12 +372,12 @@ RECENT REVISION HISTORY: enum { - STBI_default = 0, // only used for desired_channels + STBI_default = 0, // only used for desired_channels - STBI_grey = 1, - STBI_grey_alpha = 2, - STBI_rgb = 3, - STBI_rgb_alpha = 4 + STBI_grey = 1, + STBI_grey_alpha = 2, + STBI_rgb = 3, + STBI_rgb_alpha = 4 }; #include @@ -396,140 +396,140 @@ extern "C" { #endif #endif -////////////////////////////////////////////////////////////////////////////// -// -// PRIMARY API - works on images of any type -// + ////////////////////////////////////////////////////////////////////////////// + // + // PRIMARY API - works on images of any type + // -// -// load image by filename, open file, or memory buffer -// + // + // load image by filename, open file, or memory buffer + // -typedef struct -{ - int (*read) (void *user,char *data,int size); // fill 'data' with 'size' bytes. return number of bytes actually read - void (*skip) (void *user,int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative - int (*eof) (void *user); // returns nonzero if we are at end of file/data -} stbi_io_callbacks; + typedef struct + { + int (*read) (void* user, char* data, int size); // fill 'data' with 'size' bytes. return number of bytes actually read + void (*skip) (void* user, int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative + int (*eof) (void* user); // returns nonzero if we are at end of file/data + } stbi_io_callbacks; -//////////////////////////////////// -// -// 8-bits-per-channel interface -// + //////////////////////////////////// + // + // 8-bits-per-channel interface + // -STBIDEF stbi_uc *stbi_load_from_memory (stbi_uc const *buffer, int len , int *x, int *y, int *channels_in_file, int desired_channels); -STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk , void *user, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF stbi_uc* stbi_load_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF stbi_uc* stbi_load_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); #ifndef STBI_NO_STDIO -STBIDEF stbi_uc *stbi_load (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); -STBIDEF stbi_uc *stbi_load_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); -// for stbi_load_from_file, file pointer is left pointing immediately after image + STBIDEF stbi_uc* stbi_load(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF stbi_uc* stbi_load_from_file(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); + // for stbi_load_from_file, file pointer is left pointing immediately after image #endif #ifndef STBI_NO_GIF -STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp); + STBIDEF stbi_uc* stbi_load_gif_from_memory(stbi_uc const* buffer, int len, int** delays, int* x, int* y, int* z, int* comp, int req_comp); #endif #ifdef STBI_WINDOWS_UTF8 -STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); + STBIDEF int stbi_convert_wchar_to_utf8(char* buffer, size_t bufferlen, const wchar_t* input); #endif -//////////////////////////////////// -// -// 16-bits-per-channel interface -// + //////////////////////////////////// + // + // 16-bits-per-channel interface + // -STBIDEF stbi_us *stbi_load_16_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); -STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF stbi_us* stbi_load_16_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF stbi_us* stbi_load_16_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); #ifndef STBI_NO_STDIO -STBIDEF stbi_us *stbi_load_16 (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); -STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF stbi_us* stbi_load_16(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF stbi_us* stbi_load_from_file_16(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); #endif -//////////////////////////////////// -// -// float-per-channel interface -// + //////////////////////////////////// + // + // float-per-channel interface + // #ifndef STBI_NO_LINEAR - STBIDEF float *stbi_loadf_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); - STBIDEF float *stbi_loadf_from_callbacks (stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float* stbi_loadf_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF float* stbi_loadf_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); - #ifndef STBI_NO_STDIO - STBIDEF float *stbi_loadf (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); - STBIDEF float *stbi_loadf_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); - #endif +#ifndef STBI_NO_STDIO + STBIDEF float* stbi_loadf(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); + STBIDEF float* stbi_loadf_from_file(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); +#endif #endif #ifndef STBI_NO_HDR - STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); - STBIDEF void stbi_hdr_to_ldr_scale(float scale); + STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); + STBIDEF void stbi_hdr_to_ldr_scale(float scale); #endif // STBI_NO_HDR #ifndef STBI_NO_LINEAR - STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); - STBIDEF void stbi_ldr_to_hdr_scale(float scale); + STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); + STBIDEF void stbi_ldr_to_hdr_scale(float scale); #endif // STBI_NO_LINEAR -// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR -STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user); -STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len); + // stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR + STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const* clbk, void* user); + STBIDEF int stbi_is_hdr_from_memory(stbi_uc const* buffer, int len); #ifndef STBI_NO_STDIO -STBIDEF int stbi_is_hdr (char const *filename); -STBIDEF int stbi_is_hdr_from_file(FILE *f); + STBIDEF int stbi_is_hdr(char const* filename); + STBIDEF int stbi_is_hdr_from_file(FILE* f); #endif // STBI_NO_STDIO -// get a VERY brief reason for failure -// on most compilers (and ALL modern mainstream compilers) this is threadsafe -STBIDEF const char *stbi_failure_reason (void); + // get a VERY brief reason for failure + // on most compilers (and ALL modern mainstream compilers) this is threadsafe + STBIDEF const char* stbi_failure_reason(void); -// free the loaded image -- this is just free() -STBIDEF void stbi_image_free (void *retval_from_stbi_load); + // free the loaded image -- this is just free() + STBIDEF void stbi_image_free(void* retval_from_stbi_load); -// get image dimensions & components without fully decoding -STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp); -STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp); -STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len); -STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user); + // get image dimensions & components without fully decoding + STBIDEF int stbi_info_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp); + STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp); + STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const* buffer, int len); + STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const* clbk, void* user); #ifndef STBI_NO_STDIO -STBIDEF int stbi_info (char const *filename, int *x, int *y, int *comp); -STBIDEF int stbi_info_from_file (FILE *f, int *x, int *y, int *comp); -STBIDEF int stbi_is_16_bit (char const *filename); -STBIDEF int stbi_is_16_bit_from_file(FILE *f); + STBIDEF int stbi_info(char const* filename, int* x, int* y, int* comp); + STBIDEF int stbi_info_from_file(FILE* f, int* x, int* y, int* comp); + STBIDEF int stbi_is_16_bit(char const* filename); + STBIDEF int stbi_is_16_bit_from_file(FILE* f); #endif -// for image formats that explicitly notate that they have premultiplied alpha, -// we just return the colors as stored in the file. set this flag to force -// unpremultiplication. results are undefined if the unpremultiply overflow. -STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); + // for image formats that explicitly notate that they have premultiplied alpha, + // we just return the colors as stored in the file. set this flag to force + // unpremultiplication. results are undefined if the unpremultiply overflow. + STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); -// indicate whether we should process iphone images back to canonical format, -// or just pass them through "as-is" -STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); + // indicate whether we should process iphone images back to canonical format, + // or just pass them through "as-is" + STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); -// flip the image vertically, so the first pixel in the output array is the bottom left -STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); + // flip the image vertically, so the first pixel in the output array is the bottom left + STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); -// as above, but only applies to images loaded on the thread that calls the function -// this function is only available if your compiler supports thread-local variables; -// calling it will fail to link if your compiler doesn't -STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); -STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); -STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); + // as above, but only applies to images loaded on the thread that calls the function + // this function is only available if your compiler supports thread-local variables; + // calling it will fail to link if your compiler doesn't + STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); + STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); + STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); -// ZLIB client - used by PNG, available for other purposes + // ZLIB client - used by PNG, available for other purposes -STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen); -STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header); -STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen); -STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + STBIDEF char* stbi_zlib_decode_malloc_guesssize(const char* buffer, int len, int initial_size, int* outlen); + STBIDEF char* stbi_zlib_decode_malloc_guesssize_headerflag(const char* buffer, int len, int initial_size, int* outlen, int parse_header); + STBIDEF char* stbi_zlib_decode_malloc(const char* buffer, int len, int* outlen); + STBIDEF int stbi_zlib_decode_buffer(char* obuffer, int olen, const char* ibuffer, int ilen); -STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen); -STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + STBIDEF char* stbi_zlib_decode_noheader_malloc(const char* buffer, int len, int* outlen); + STBIDEF int stbi_zlib_decode_noheader_buffer(char* obuffer, int olen, const char* ibuffer, int ilen); #ifdef __cplusplus @@ -547,33 +547,33 @@ STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const ch || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \ || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \ || defined(STBI_ONLY_ZLIB) - #ifndef STBI_ONLY_JPEG - #define STBI_NO_JPEG - #endif - #ifndef STBI_ONLY_PNG - #define STBI_NO_PNG - #endif - #ifndef STBI_ONLY_BMP - #define STBI_NO_BMP - #endif - #ifndef STBI_ONLY_PSD - #define STBI_NO_PSD - #endif - #ifndef STBI_ONLY_TGA - #define STBI_NO_TGA - #endif - #ifndef STBI_ONLY_GIF - #define STBI_NO_GIF - #endif - #ifndef STBI_ONLY_HDR - #define STBI_NO_HDR - #endif - #ifndef STBI_ONLY_PIC - #define STBI_NO_PIC - #endif - #ifndef STBI_ONLY_PNM - #define STBI_NO_PNM - #endif +#ifndef STBI_ONLY_JPEG +#define STBI_NO_JPEG +#endif +#ifndef STBI_ONLY_PNG +#define STBI_NO_PNG +#endif +#ifndef STBI_ONLY_BMP +#define STBI_NO_BMP +#endif +#ifndef STBI_ONLY_PSD +#define STBI_NO_PSD +#endif +#ifndef STBI_ONLY_TGA +#define STBI_NO_TGA +#endif +#ifndef STBI_ONLY_GIF +#define STBI_NO_GIF +#endif +#ifndef STBI_ONLY_HDR +#define STBI_NO_HDR +#endif +#ifndef STBI_ONLY_PIC +#define STBI_NO_PIC +#endif +#ifndef STBI_ONLY_PNM +#define STBI_NO_PNM +#endif #endif #if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB) @@ -608,31 +608,31 @@ STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const ch #ifndef _MSC_VER - #ifdef __cplusplus - #define stbi_inline inline - #else - #define stbi_inline - #endif +#ifdef __cplusplus +#define stbi_inline inline +#else +#define stbi_inline +#endif #else - #define stbi_inline __forceinline +#define stbi_inline __forceinline #endif #ifndef STBI_NO_THREAD_LOCALS - #if defined(__cplusplus) && __cplusplus >= 201103L - #define STBI_THREAD_LOCAL thread_local - #elif defined(__GNUC__) && __GNUC__ < 5 - #define STBI_THREAD_LOCAL __thread - #elif defined(_MSC_VER) - #define STBI_THREAD_LOCAL __declspec(thread) - #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) - #define STBI_THREAD_LOCAL _Thread_local - #endif - - #ifndef STBI_THREAD_LOCAL - #if defined(__GNUC__) - #define STBI_THREAD_LOCAL __thread - #endif - #endif +#if defined(__cplusplus) && __cplusplus >= 201103L +#define STBI_THREAD_LOCAL thread_local +#elif defined(__GNUC__) && __GNUC__ < 5 +#define STBI_THREAD_LOCAL __thread +#elif defined(_MSC_VER) +#define STBI_THREAD_LOCAL __declspec(thread) +#elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) +#define STBI_THREAD_LOCAL _Thread_local +#endif + +#ifndef STBI_THREAD_LOCAL +#if defined(__GNUC__) +#define STBI_THREAD_LOCAL __thread +#endif +#endif #endif #ifdef _MSC_VER @@ -649,7 +649,7 @@ typedef int32_t stbi__int32; #endif // should produce compiler error if size is wrong -typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; +typedef unsigned char validate_uint32[sizeof(stbi__uint32) == 4 ? 1 : -1]; #ifdef _MSC_VER #define STBI_NOTUSED(v) (void)(v) @@ -662,9 +662,9 @@ typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; #endif #ifdef STBI_HAS_LROTL - #define stbi_lrot(x,y) _lrotl(x,y) +#define stbi_lrot(x,y) _lrotl(x,y) #else - #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) +#define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) #endif #if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) @@ -728,20 +728,20 @@ typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; #include // __cpuid static int stbi__cpuid3(void) { - int info[4]; - __cpuid(info,1); - return info[3]; + int info[4]; + __cpuid(info, 1); + return info[3]; } #else static int stbi__cpuid3(void) { - int res; - __asm { - mov eax,1 - cpuid - mov res,edx - } - return res; + int res; + __asm { + mov eax, 1 + cpuid + mov res, edx + } + return res; } #endif @@ -750,8 +750,8 @@ static int stbi__cpuid3(void) #if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) static int stbi__sse2_available(void) { - int info3 = stbi__cpuid3(); - return ((info3 >> 26) & 1) != 0; + int info3 = stbi__cpuid3(); + return ((info3 >> 26) & 1) != 0; } #endif @@ -761,10 +761,10 @@ static int stbi__sse2_available(void) #if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) static int stbi__sse2_available(void) { - // If we're even attempting to compile this on GCC/Clang, that means - // -msse2 is on, which means the compiler is allowed to use SSE2 - // instructions at will, and so are we. - return 1; + // If we're even attempting to compile this on GCC/Clang, that means + // -msse2 is on, which means the compiler is allowed to use SSE2 + // instructions at will, and so are we. + return 1; } #endif @@ -801,67 +801,67 @@ static int stbi__sse2_available(void) // contains all the IO context, plus some basic image information typedef struct { - stbi__uint32 img_x, img_y; - int img_n, img_out_n; + stbi__uint32 img_x, img_y; + int img_n, img_out_n; - stbi_io_callbacks io; - void *io_user_data; + stbi_io_callbacks io; + void* io_user_data; - int read_from_callbacks; - int buflen; - stbi_uc buffer_start[128]; - int callback_already_read; + int read_from_callbacks; + int buflen; + stbi_uc buffer_start[128]; + int callback_already_read; - stbi_uc *img_buffer, *img_buffer_end; - stbi_uc *img_buffer_original, *img_buffer_original_end; + stbi_uc* img_buffer, * img_buffer_end; + stbi_uc* img_buffer_original, * img_buffer_original_end; } stbi__context; -static void stbi__refill_buffer(stbi__context *s); +static void stbi__refill_buffer(stbi__context* s); // initialize a memory-decode context -static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len) +static void stbi__start_mem(stbi__context* s, stbi_uc const* buffer, int len) { - s->io.read = NULL; - s->read_from_callbacks = 0; - s->callback_already_read = 0; - s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer; - s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len; + s->io.read = NULL; + s->read_from_callbacks = 0; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = (stbi_uc*)buffer; + s->img_buffer_end = s->img_buffer_original_end = (stbi_uc*)buffer + len; } // initialize a callback-based context -static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user) +static void stbi__start_callbacks(stbi__context* s, stbi_io_callbacks* c, void* user) { - s->io = *c; - s->io_user_data = user; - s->buflen = sizeof(s->buffer_start); - s->read_from_callbacks = 1; - s->callback_already_read = 0; - s->img_buffer = s->img_buffer_original = s->buffer_start; - stbi__refill_buffer(s); - s->img_buffer_original_end = s->img_buffer_end; + s->io = *c; + s->io_user_data = user; + s->buflen = sizeof(s->buffer_start); + s->read_from_callbacks = 1; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = s->buffer_start; + stbi__refill_buffer(s); + s->img_buffer_original_end = s->img_buffer_end; } #ifndef STBI_NO_STDIO -static int stbi__stdio_read(void *user, char *data, int size) +static int stbi__stdio_read(void* user, char* data, int size) { - return (int) fread(data,1,size,(FILE*) user); + return (int)fread(data, 1, size, (FILE*)user); } -static void stbi__stdio_skip(void *user, int n) +static void stbi__stdio_skip(void* user, int n) { - int ch; - fseek((FILE*) user, n, SEEK_CUR); - ch = fgetc((FILE*) user); /* have to read a byte to reset feof()'s flag */ - if (ch != EOF) { - ungetc(ch, (FILE *) user); /* push byte back onto stream if valid. */ - } + int ch; + fseek((FILE*)user, n, SEEK_CUR); + ch = fgetc((FILE*)user); /* have to read a byte to reset feof()'s flag */ + if (ch != EOF) { + ungetc(ch, (FILE*)user); /* push byte back onto stream if valid. */ + } } -static int stbi__stdio_eof(void *user) +static int stbi__stdio_eof(void* user) { - return feof((FILE*) user) || ferror((FILE *) user); + return feof((FILE*)user) || ferror((FILE*)user); } static stbi_io_callbacks stbi__stdio_callbacks = @@ -871,115 +871,115 @@ static stbi_io_callbacks stbi__stdio_callbacks = stbi__stdio_eof, }; -static void stbi__start_file(stbi__context *s, FILE *f) +static void stbi__start_file(stbi__context* s, FILE* f) { - stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f); + stbi__start_callbacks(s, &stbi__stdio_callbacks, (void*)f); } //static void stop_file(stbi__context *s) { } #endif // !STBI_NO_STDIO -static void stbi__rewind(stbi__context *s) +static void stbi__rewind(stbi__context* s) { - // conceptually rewind SHOULD rewind to the beginning of the stream, - // but we just rewind to the beginning of the initial buffer, because - // we only use it after doing 'test', which only ever looks at at most 92 bytes - s->img_buffer = s->img_buffer_original; - s->img_buffer_end = s->img_buffer_original_end; + // conceptually rewind SHOULD rewind to the beginning of the stream, + // but we just rewind to the beginning of the initial buffer, because + // we only use it after doing 'test', which only ever looks at at most 92 bytes + s->img_buffer = s->img_buffer_original; + s->img_buffer_end = s->img_buffer_original_end; } enum { - STBI_ORDER_RGB, - STBI_ORDER_BGR + STBI_ORDER_RGB, + STBI_ORDER_BGR }; typedef struct { - int bits_per_channel; - int num_channels; - int channel_order; + int bits_per_channel; + int num_channels; + int channel_order; } stbi__result_info; #ifndef STBI_NO_JPEG -static int stbi__jpeg_test(stbi__context *s); -static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__jpeg_test(stbi__context* s); +static void* stbi__jpeg_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__jpeg_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_PNG -static int stbi__png_test(stbi__context *s); -static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp); -static int stbi__png_is16(stbi__context *s); +static int stbi__png_test(stbi__context* s); +static void* stbi__png_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__png_info(stbi__context* s, int* x, int* y, int* comp); +static int stbi__png_is16(stbi__context* s); #endif #ifndef STBI_NO_BMP -static int stbi__bmp_test(stbi__context *s); -static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__bmp_test(stbi__context* s); +static void* stbi__bmp_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__bmp_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_TGA -static int stbi__tga_test(stbi__context *s); -static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__tga_test(stbi__context* s); +static void* stbi__tga_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__tga_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_PSD -static int stbi__psd_test(stbi__context *s); -static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc); -static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp); -static int stbi__psd_is16(stbi__context *s); +static int stbi__psd_test(stbi__context* s); +static void* stbi__psd_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc); +static int stbi__psd_info(stbi__context* s, int* x, int* y, int* comp); +static int stbi__psd_is16(stbi__context* s); #endif #ifndef STBI_NO_HDR -static int stbi__hdr_test(stbi__context *s); -static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__hdr_test(stbi__context* s); +static float* stbi__hdr_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__hdr_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_PIC -static int stbi__pic_test(stbi__context *s); -static void *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__pic_test(stbi__context* s); +static void* stbi__pic_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__pic_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_GIF -static int stbi__gif_test(stbi__context *s); -static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp); -static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__gif_test(stbi__context* s); +static void* stbi__gif_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static void* stbi__load_gif_main(stbi__context* s, int** delays, int* x, int* y, int* z, int* comp, int req_comp); +static int stbi__gif_info(stbi__context* s, int* x, int* y, int* comp); #endif #ifndef STBI_NO_PNM -static int stbi__pnm_test(stbi__context *s); -static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); -static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp); -static int stbi__pnm_is16(stbi__context *s); +static int stbi__pnm_test(stbi__context* s); +static void* stbi__pnm_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); +static int stbi__pnm_info(stbi__context* s, int* x, int* y, int* comp); +static int stbi__pnm_is16(stbi__context* s); #endif static #ifdef STBI_THREAD_LOCAL STBI_THREAD_LOCAL #endif -const char *stbi__g_failure_reason; +const char* stbi__g_failure_reason; -STBIDEF const char *stbi_failure_reason(void) +STBIDEF const char* stbi_failure_reason(void) { - return stbi__g_failure_reason; + return stbi__g_failure_reason; } #ifndef STBI_NO_FAILURE_STRINGS -static int stbi__err(const char *str) +static int stbi__err(const char* str) { - stbi__g_failure_reason = str; - return 0; + stbi__g_failure_reason = str; + return 0; } #endif -static void *stbi__malloc(size_t size) +static void* stbi__malloc(size_t size) { return STBI_MALLOC(size); } @@ -998,68 +998,68 @@ static void *stbi__malloc(size_t size) // negative terms are considered invalid. static int stbi__addsizes_valid(int a, int b) { - if (b < 0) return 0; - // now 0 <= b <= INT_MAX, hence also - // 0 <= INT_MAX - b <= INTMAX. - // And "a + b <= INT_MAX" (which might overflow) is the - // same as a <= INT_MAX - b (no overflow) - return a <= INT_MAX - b; + if (b < 0) return 0; + // now 0 <= b <= INT_MAX, hence also + // 0 <= INT_MAX - b <= INTMAX. + // And "a + b <= INT_MAX" (which might overflow) is the + // same as a <= INT_MAX - b (no overflow) + return a <= INT_MAX - b; } // returns 1 if the product is valid, 0 on overflow. // negative factors are considered invalid. static int stbi__mul2sizes_valid(int a, int b) { - if (a < 0 || b < 0) return 0; - if (b == 0) return 1; // mul-by-0 is always safe - // portable way to check for no overflows in a*b - return a <= INT_MAX/b; + if (a < 0 || b < 0) return 0; + if (b == 0) return 1; // mul-by-0 is always safe + // portable way to check for no overflows in a*b + return a <= INT_MAX / b; } #if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) // returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow static int stbi__mad2sizes_valid(int a, int b, int add) { - return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add); + return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a * b, add); } #endif // returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow static int stbi__mad3sizes_valid(int a, int b, int c, int add) { - return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && - stbi__addsizes_valid(a*b*c, add); + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a * b, c) && + stbi__addsizes_valid(a * b * c, add); } // returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow #if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) { - return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && - stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add); + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a * b, c) && + stbi__mul2sizes_valid(a * b * c, d) && stbi__addsizes_valid(a * b * c * d, add); } #endif #if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) // mallocs with size overflow checking -static void *stbi__malloc_mad2(int a, int b, int add) +static void* stbi__malloc_mad2(int a, int b, int add) { - if (!stbi__mad2sizes_valid(a, b, add)) return NULL; - return stbi__malloc(a*b + add); + if (!stbi__mad2sizes_valid(a, b, add)) return NULL; + return stbi__malloc(a * b + add); } #endif -static void *stbi__malloc_mad3(int a, int b, int c, int add) +static void* stbi__malloc_mad3(int a, int b, int c, int add) { - if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; - return stbi__malloc(a*b*c + add); + if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; + return stbi__malloc(a * b * c + add); } #if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) -static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) +static void* stbi__malloc_mad4(int a, int b, int c, int d, int add) { - if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; - return stbi__malloc(a*b*c*d + add); + if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; + return stbi__malloc(a * b * c * d + add); } #endif @@ -1068,34 +1068,34 @@ static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) // stbi__errpuc - error returning pointer to unsigned char #ifdef STBI_NO_FAILURE_STRINGS - #define stbi__err(x,y) 0 +#define stbi__err(x,y) 0 #elif defined(STBI_FAILURE_USERMSG) - #define stbi__err(x,y) stbi__err(y) +#define stbi__err(x,y) stbi__err(y) #else - #define stbi__err(x,y) stbi__err(x) +#define stbi__err(x,y) stbi__err(x) #endif #define stbi__errpf(x,y) ((float *)(size_t) (stbi__err(x,y)?NULL:NULL)) #define stbi__errpuc(x,y) ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL)) -STBIDEF void stbi_image_free(void *retval_from_stbi_load) +STBIDEF void stbi_image_free(void* retval_from_stbi_load) { - STBI_FREE(retval_from_stbi_load); + STBI_FREE(retval_from_stbi_load); } #ifndef STBI_NO_LINEAR -static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp); +static float* stbi__ldr_to_hdr(stbi_uc* data, int x, int y, int comp); #endif #ifndef STBI_NO_HDR -static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp); +static stbi_uc* stbi__hdr_to_ldr(float* data, int x, int y, int comp); #endif static int stbi__vertically_flip_on_load_global = 0; STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) { - stbi__vertically_flip_on_load_global = flag_true_if_should_flip; + stbi__vertically_flip_on_load_global = flag_true_if_should_flip; } #ifndef STBI_THREAD_LOCAL @@ -1105,8 +1105,8 @@ static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertical STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) { - stbi__vertically_flip_on_load_local = flag_true_if_should_flip; - stbi__vertically_flip_on_load_set = 1; + stbi__vertically_flip_on_load_local = flag_true_if_should_flip; + stbi__vertically_flip_on_load_set = 1; } #define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ @@ -1114,377 +1114,377 @@ STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_fli : stbi__vertically_flip_on_load_global) #endif // STBI_THREAD_LOCAL -static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) -{ - memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields - ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed - ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order - ri->num_channels = 0; - - // test the formats with a very explicit header first (at least a FOURCC - // or distinctive magic number first) - #ifndef STBI_NO_PNG - if (stbi__png_test(s)) return stbi__png_load(s,x,y,comp,req_comp, ri); - #endif - #ifndef STBI_NO_BMP - if (stbi__bmp_test(s)) return stbi__bmp_load(s,x,y,comp,req_comp, ri); - #endif - #ifndef STBI_NO_GIF - if (stbi__gif_test(s)) return stbi__gif_load(s,x,y,comp,req_comp, ri); - #endif - #ifndef STBI_NO_PSD - if (stbi__psd_test(s)) return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc); - #else - STBI_NOTUSED(bpc); - #endif - #ifndef STBI_NO_PIC - if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); - #endif - - // then the formats that can end up attempting to load with just 1 or 2 - // bytes matching expectations; these are prone to false positives, so - // try them later - #ifndef STBI_NO_JPEG - if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); - #endif - #ifndef STBI_NO_PNM - if (stbi__pnm_test(s)) return stbi__pnm_load(s,x,y,comp,req_comp, ri); - #endif - - #ifndef STBI_NO_HDR - if (stbi__hdr_test(s)) { - float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri); - return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); - } - #endif +static void* stbi__load_main(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc) +{ + memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields + ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed + ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order + ri->num_channels = 0; + + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) +#ifndef STBI_NO_PNG + if (stbi__png_test(s)) return stbi__png_load(s, x, y, comp, req_comp, ri); +#endif +#ifndef STBI_NO_BMP + if (stbi__bmp_test(s)) return stbi__bmp_load(s, x, y, comp, req_comp, ri); +#endif +#ifndef STBI_NO_GIF + if (stbi__gif_test(s)) return stbi__gif_load(s, x, y, comp, req_comp, ri); +#endif +#ifndef STBI_NO_PSD + if (stbi__psd_test(s)) return stbi__psd_load(s, x, y, comp, req_comp, ri, bpc); +#else + STBI_NOTUSED(bpc); +#endif +#ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_load(s, x, y, comp, req_comp, ri); +#endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later +#ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s, x, y, comp, req_comp, ri); +#endif +#ifndef STBI_NO_PNM + if (stbi__pnm_test(s)) return stbi__pnm_load(s, x, y, comp, req_comp, ri); +#endif + +#ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + float* hdr = stbi__hdr_load(s, x, y, comp, req_comp, ri); + return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); + } +#endif - #ifndef STBI_NO_TGA - // test tga last because it's a crappy test! - if (stbi__tga_test(s)) - return stbi__tga_load(s,x,y,comp,req_comp, ri); - #endif +#ifndef STBI_NO_TGA + // test tga last because it's a crappy test! + if (stbi__tga_test(s)) + return stbi__tga_load(s, x, y, comp, req_comp, ri); +#endif - return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); + return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); } -static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels) +static stbi_uc* stbi__convert_16_to_8(stbi__uint16* orig, int w, int h, int channels) { - int i; - int img_len = w * h * channels; - stbi_uc *reduced; + int i; + int img_len = w * h * channels; + stbi_uc* reduced; - reduced = (stbi_uc *) stbi__malloc(img_len); - if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); + reduced = (stbi_uc*)stbi__malloc(img_len); + if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); - for (i = 0; i < img_len; ++i) - reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling + for (i = 0; i < img_len; ++i) + reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling - STBI_FREE(orig); - return reduced; + STBI_FREE(orig); + return reduced; } -static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels) +static stbi__uint16* stbi__convert_8_to_16(stbi_uc* orig, int w, int h, int channels) { - int i; - int img_len = w * h * channels; - stbi__uint16 *enlarged; + int i; + int img_len = w * h * channels; + stbi__uint16* enlarged; - enlarged = (stbi__uint16 *) stbi__malloc(img_len*2); - if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + enlarged = (stbi__uint16*)stbi__malloc(img_len * 2); + if (enlarged == NULL) return (stbi__uint16*)stbi__errpuc("outofmem", "Out of memory"); - for (i = 0; i < img_len; ++i) - enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff + for (i = 0; i < img_len; ++i) + enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff - STBI_FREE(orig); - return enlarged; + STBI_FREE(orig); + return enlarged; } -static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel) +static void stbi__vertical_flip(void* image, int w, int h, int bytes_per_pixel) { - int row; - size_t bytes_per_row = (size_t)w * bytes_per_pixel; - stbi_uc temp[2048]; - stbi_uc *bytes = (stbi_uc *)image; + int row; + size_t bytes_per_row = (size_t)w * bytes_per_pixel; + stbi_uc temp[2048]; + stbi_uc* bytes = (stbi_uc*)image; - for (row = 0; row < (h>>1); row++) { - stbi_uc *row0 = bytes + row*bytes_per_row; - stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row; - // swap row0 with row1 - size_t bytes_left = bytes_per_row; - while (bytes_left) { - size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); - memcpy(temp, row0, bytes_copy); - memcpy(row0, row1, bytes_copy); - memcpy(row1, temp, bytes_copy); - row0 += bytes_copy; - row1 += bytes_copy; - bytes_left -= bytes_copy; - } - } + for (row = 0; row < (h >> 1); row++) { + stbi_uc* row0 = bytes + row * bytes_per_row; + stbi_uc* row1 = bytes + (h - row - 1) * bytes_per_row; + // swap row0 with row1 + size_t bytes_left = bytes_per_row; + while (bytes_left) { + size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); + memcpy(temp, row0, bytes_copy); + memcpy(row0, row1, bytes_copy); + memcpy(row1, temp, bytes_copy); + row0 += bytes_copy; + row1 += bytes_copy; + bytes_left -= bytes_copy; + } + } } #ifndef STBI_NO_GIF -static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel) +static void stbi__vertical_flip_slices(void* image, int w, int h, int z, int bytes_per_pixel) { - int slice; - int slice_size = w * h * bytes_per_pixel; + int slice; + int slice_size = w * h * bytes_per_pixel; - stbi_uc *bytes = (stbi_uc *)image; - for (slice = 0; slice < z; ++slice) { - stbi__vertical_flip(bytes, w, h, bytes_per_pixel); - bytes += slice_size; - } + stbi_uc* bytes = (stbi_uc*)image; + for (slice = 0; slice < z; ++slice) { + stbi__vertical_flip(bytes, w, h, bytes_per_pixel); + bytes += slice_size; + } } #endif -static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +static unsigned char* stbi__load_and_postprocess_8bit(stbi__context* s, int* x, int* y, int* comp, int req_comp) { - stbi__result_info ri; - void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); + stbi__result_info ri; + void* result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); - if (result == NULL) - return NULL; + if (result == NULL) + return NULL; - // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. - STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); - if (ri.bits_per_channel != 8) { - result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp); - ri.bits_per_channel = 8; - } + if (ri.bits_per_channel != 8) { + result = stbi__convert_16_to_8((stbi__uint16*)result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 8; + } - // @TODO: move stbi__convert_format to here + // @TODO: move stbi__convert_format to here - if (stbi__vertically_flip_on_load) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); - } + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); + } - return (unsigned char *) result; + return (unsigned char*)result; } -static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +static stbi__uint16* stbi__load_and_postprocess_16bit(stbi__context* s, int* x, int* y, int* comp, int req_comp) { - stbi__result_info ri; - void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); + stbi__result_info ri; + void* result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); - if (result == NULL) - return NULL; + if (result == NULL) + return NULL; - // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. - STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); - if (ri.bits_per_channel != 16) { - result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp); - ri.bits_per_channel = 16; - } + if (ri.bits_per_channel != 16) { + result = stbi__convert_8_to_16((stbi_uc*)result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 16; + } - // @TODO: move stbi__convert_format16 to here - // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision + // @TODO: move stbi__convert_format16 to here + // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision - if (stbi__vertically_flip_on_load) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); - } + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); + } - return (stbi__uint16 *) result; + return (stbi__uint16*)result; } #if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR) -static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp) +static void stbi__float_postprocess(float* result, int* x, int* y, int* comp, int req_comp) { - if (stbi__vertically_flip_on_load && result != NULL) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); - } + if (stbi__vertically_flip_on_load && result != NULL) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); + } } #endif #ifndef STBI_NO_STDIO #if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) -STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); -STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); +STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char* str, int cbmb, wchar_t* widestr, int cchwide); +STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t* widestr, int cchwide, char* str, int cbmb, const char* defchar, int* used_default); #endif #if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) -STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) +STBIDEF int stbi_convert_wchar_to_utf8(char* buffer, size_t bufferlen, const wchar_t* input) { - return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); + return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int)bufferlen, NULL, NULL); } #endif -static FILE *stbi__fopen(char const *filename, char const *mode) +static FILE* stbi__fopen(char const* filename, char const* mode) { - FILE *f; + FILE* f; #if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) - wchar_t wMode[64]; - wchar_t wFilename[1024]; - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) - return 0; + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename) / sizeof(*wFilename))) + return 0; - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) - return 0; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode) / sizeof(*wMode))) + return 0; #if defined(_MSC_VER) && _MSC_VER >= 1400 - if (0 != _wfopen_s(&f, wFilename, wMode)) - f = 0; + if (0 != _wfopen_s(&f, wFilename, wMode)) + f = 0; #else - f = _wfopen(wFilename, wMode); + f = _wfopen(wFilename, wMode); #endif #elif defined(_MSC_VER) && _MSC_VER >= 1400 - if (0 != fopen_s(&f, filename, mode)) - f=0; + if (0 != fopen_s(&f, filename, mode)) + f = 0; #else - f = fopen(filename, mode); + f = fopen(filename, mode); #endif - return f; + return f; } -STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi_uc* stbi_load(char const* filename, int* x, int* y, int* comp, int req_comp) { - FILE *f = stbi__fopen(filename, "rb"); - unsigned char *result; - if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); - result = stbi_load_from_file(f,x,y,comp,req_comp); - fclose(f); - return result; + FILE* f = stbi__fopen(filename, "rb"); + unsigned char* result; + if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file(f, x, y, comp, req_comp); + fclose(f); + return result; } -STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi_uc* stbi_load_from_file(FILE* f, int* x, int* y, int* comp, int req_comp) { - unsigned char *result; - stbi__context s; - stbi__start_file(&s,f); - result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); - if (result) { - // need to 'unget' all the characters in the IO buffer - fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); - } - return result; + unsigned char* result; + stbi__context s; + stbi__start_file(&s, f); + result = stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, -(int)(s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; } -STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi__uint16* stbi_load_from_file_16(FILE* f, int* x, int* y, int* comp, int req_comp) { - stbi__uint16 *result; - stbi__context s; - stbi__start_file(&s,f); - result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp); - if (result) { - // need to 'unget' all the characters in the IO buffer - fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); - } - return result; + stbi__uint16* result; + stbi__context s; + stbi__start_file(&s, f); + result = stbi__load_and_postprocess_16bit(&s, x, y, comp, req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, -(int)(s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; } -STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi_us* stbi_load_16(char const* filename, int* x, int* y, int* comp, int req_comp) { - FILE *f = stbi__fopen(filename, "rb"); - stbi__uint16 *result; - if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file"); - result = stbi_load_from_file_16(f,x,y,comp,req_comp); - fclose(f); - return result; + FILE* f = stbi__fopen(filename, "rb"); + stbi__uint16* result; + if (!f) return (stbi_us*)stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file_16(f, x, y, comp, req_comp); + fclose(f); + return result; } #endif //!STBI_NO_STDIO -STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels) +STBIDEF stbi_us* stbi_load_16_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels) { - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__load_and_postprocess_16bit(&s, x, y, channels_in_file, desired_channels); } -STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels) +STBIDEF stbi_us* stbi_load_16_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels) { - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user); - return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); + return stbi__load_and_postprocess_16bit(&s, x, y, channels_in_file, desired_channels); } -STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi_uc* stbi_load_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp, int req_comp) { - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); } -STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +STBIDEF stbi_uc* stbi_load_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp, int req_comp) { - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); - return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); + return stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); } #ifndef STBI_NO_GIF -STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +STBIDEF stbi_uc* stbi_load_gif_from_memory(stbi_uc const* buffer, int len, int** delays, int* x, int* y, int* z, int* comp, int req_comp) { - unsigned char *result; - stbi__context s; - stbi__start_mem(&s,buffer,len); + unsigned char* result; + stbi__context s; + stbi__start_mem(&s, buffer, len); - result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); - if (stbi__vertically_flip_on_load) { - stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); - } + result = (unsigned char*)stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); + if (stbi__vertically_flip_on_load) { + stbi__vertical_flip_slices(result, *x, *y, *z, *comp); + } - return result; + return result; } #endif #ifndef STBI_NO_LINEAR -static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp) -{ - unsigned char *data; - #ifndef STBI_NO_HDR - if (stbi__hdr_test(s)) { - stbi__result_info ri; - float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri); - if (hdr_data) - stbi__float_postprocess(hdr_data,x,y,comp,req_comp); - return hdr_data; - } - #endif - data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); - if (data) - return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); - return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); +static float* stbi__loadf_main(stbi__context* s, int* x, int* y, int* comp, int req_comp) +{ + unsigned char* data; +#ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + stbi__result_info ri; + float* hdr_data = stbi__hdr_load(s, x, y, comp, req_comp, &ri); + if (hdr_data) + stbi__float_postprocess(hdr_data, x, y, comp, req_comp); + return hdr_data; + } +#endif + data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); + if (data) + return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); + return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); } -STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +STBIDEF float* stbi_loadf_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp, int req_comp) { - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__loadf_main(&s,x,y,comp,req_comp); + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__loadf_main(&s, x, y, comp, req_comp); } -STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +STBIDEF float* stbi_loadf_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp, int req_comp) { - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); - return stbi__loadf_main(&s,x,y,comp,req_comp); + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); + return stbi__loadf_main(&s, x, y, comp, req_comp); } #ifndef STBI_NO_STDIO -STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp) +STBIDEF float* stbi_loadf(char const* filename, int* x, int* y, int* comp, int req_comp) { - float *result; - FILE *f = stbi__fopen(filename, "rb"); - if (!f) return stbi__errpf("can't fopen", "Unable to open file"); - result = stbi_loadf_from_file(f,x,y,comp,req_comp); - fclose(f); - return result; + float* result; + FILE* f = stbi__fopen(filename, "rb"); + if (!f) return stbi__errpf("can't fopen", "Unable to open file"); + result = stbi_loadf_from_file(f, x, y, comp, req_comp); + fclose(f); + return result; } -STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +STBIDEF float* stbi_loadf_from_file(FILE* f, int* x, int* y, int* comp, int req_comp) { - stbi__context s; - stbi__start_file(&s,f); - return stbi__loadf_main(&s,x,y,comp,req_comp); + stbi__context s; + stbi__start_file(&s, f); + return stbi__loadf_main(&s, x, y, comp, req_comp); } #endif // !STBI_NO_STDIO @@ -1494,72 +1494,72 @@ STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_ // defined, for API simplicity; if STBI_NO_LINEAR is defined, it always // reports false! -STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len) +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const* buffer, int len) { - #ifndef STBI_NO_HDR - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__hdr_test(&s); - #else - STBI_NOTUSED(buffer); - STBI_NOTUSED(len); - return 0; - #endif +#ifndef STBI_NO_HDR + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__hdr_test(&s); +#else + STBI_NOTUSED(buffer); + STBI_NOTUSED(len); + return 0; +#endif } #ifndef STBI_NO_STDIO -STBIDEF int stbi_is_hdr (char const *filename) +STBIDEF int stbi_is_hdr(char const* filename) { - FILE *f = stbi__fopen(filename, "rb"); - int result=0; - if (f) { - result = stbi_is_hdr_from_file(f); - fclose(f); - } - return result; + FILE* f = stbi__fopen(filename, "rb"); + int result = 0; + if (f) { + result = stbi_is_hdr_from_file(f); + fclose(f); + } + return result; } -STBIDEF int stbi_is_hdr_from_file(FILE *f) +STBIDEF int stbi_is_hdr_from_file(FILE* f) { - #ifndef STBI_NO_HDR - long pos = ftell(f); - int res; - stbi__context s; - stbi__start_file(&s,f); - res = stbi__hdr_test(&s); - fseek(f, pos, SEEK_SET); - return res; - #else - STBI_NOTUSED(f); - return 0; - #endif +#ifndef STBI_NO_HDR + long pos = ftell(f); + int res; + stbi__context s; + stbi__start_file(&s, f); + res = stbi__hdr_test(&s); + fseek(f, pos, SEEK_SET); + return res; +#else + STBI_NOTUSED(f); + return 0; +#endif } #endif // !STBI_NO_STDIO -STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user) +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const* clbk, void* user) { - #ifndef STBI_NO_HDR - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); - return stbi__hdr_test(&s); - #else - STBI_NOTUSED(clbk); - STBI_NOTUSED(user); - return 0; - #endif +#ifndef STBI_NO_HDR + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); + return stbi__hdr_test(&s); +#else + STBI_NOTUSED(clbk); + STBI_NOTUSED(user); + return 0; +#endif } #ifndef STBI_NO_LINEAR -static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f; +static float stbi__l2h_gamma = 2.2f, stbi__l2h_scale = 1.0f; STBIDEF void stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; } STBIDEF void stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; } #endif -static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f; +static float stbi__h2l_gamma_i = 1.0f / 2.2f, stbi__h2l_scale_i = 1.0f; -STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; } -STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; } +STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1 / gamma; } +STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1 / scale; } ////////////////////////////////////////////////////////////////////////////// @@ -1569,141 +1569,143 @@ STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; enum { - STBI__SCAN_load=0, - STBI__SCAN_type, - STBI__SCAN_header + STBI__SCAN_load = 0, + STBI__SCAN_type, + STBI__SCAN_header }; -static void stbi__refill_buffer(stbi__context *s) -{ - int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen); - s->callback_already_read += (int) (s->img_buffer - s->img_buffer_original); - if (n == 0) { - // at end of file, treat same as if from memory, but need to handle case - // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file - s->read_from_callbacks = 0; - s->img_buffer = s->buffer_start; - s->img_buffer_end = s->buffer_start+1; - *s->img_buffer = 0; - } else { - s->img_buffer = s->buffer_start; - s->img_buffer_end = s->buffer_start + n; - } +static void stbi__refill_buffer(stbi__context* s) +{ + int n = (s->io.read)(s->io_user_data, (char*)s->buffer_start, s->buflen); + s->callback_already_read += (int)(s->img_buffer - s->img_buffer_original); + if (n == 0) { + // at end of file, treat same as if from memory, but need to handle case + // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file + s->read_from_callbacks = 0; + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start + 1; + *s->img_buffer = 0; + } + else { + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start + n; + } } -stbi_inline static stbi_uc stbi__get8(stbi__context *s) +stbi_inline static stbi_uc stbi__get8(stbi__context* s) { - if (s->img_buffer < s->img_buffer_end) - return *s->img_buffer++; - if (s->read_from_callbacks) { - stbi__refill_buffer(s); - return *s->img_buffer++; - } - return 0; + if (s->img_buffer < s->img_buffer_end) + return *s->img_buffer++; + if (s->read_from_callbacks) { + stbi__refill_buffer(s); + return *s->img_buffer++; + } + return 0; } #if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) // nothing #else -stbi_inline static int stbi__at_eof(stbi__context *s) +stbi_inline static int stbi__at_eof(stbi__context* s) { - if (s->io.read) { - if (!(s->io.eof)(s->io_user_data)) return 0; - // if feof() is true, check if buffer = end - // special case: we've only got the special 0 character at the end - if (s->read_from_callbacks == 0) return 1; - } + if (s->io.read) { + if (!(s->io.eof)(s->io_user_data)) return 0; + // if feof() is true, check if buffer = end + // special case: we've only got the special 0 character at the end + if (s->read_from_callbacks == 0) return 1; + } - return s->img_buffer >= s->img_buffer_end; + return s->img_buffer >= s->img_buffer_end; } #endif #if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) // nothing #else -static void stbi__skip(stbi__context *s, int n) +static void stbi__skip(stbi__context* s, int n) { - if (n == 0) return; // already there! - if (n < 0) { - s->img_buffer = s->img_buffer_end; - return; - } - if (s->io.read) { - int blen = (int) (s->img_buffer_end - s->img_buffer); - if (blen < n) { - s->img_buffer = s->img_buffer_end; - (s->io.skip)(s->io_user_data, n - blen); - return; - } - } - s->img_buffer += n; + if (n == 0) return; // already there! + if (n < 0) { + s->img_buffer = s->img_buffer_end; + return; + } + if (s->io.read) { + int blen = (int)(s->img_buffer_end - s->img_buffer); + if (blen < n) { + s->img_buffer = s->img_buffer_end; + (s->io.skip)(s->io_user_data, n - blen); + return; + } + } + s->img_buffer += n; } #endif #if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) // nothing #else -static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n) +static int stbi__getn(stbi__context* s, stbi_uc* buffer, int n) { - if (s->io.read) { - int blen = (int) (s->img_buffer_end - s->img_buffer); - if (blen < n) { - int res, count; + if (s->io.read) { + int blen = (int)(s->img_buffer_end - s->img_buffer); + if (blen < n) { + int res, count; - memcpy(buffer, s->img_buffer, blen); + memcpy(buffer, s->img_buffer, blen); - count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen); - res = (count == (n-blen)); - s->img_buffer = s->img_buffer_end; - return res; - } - } + count = (s->io.read)(s->io_user_data, (char*)buffer + blen, n - blen); + res = (count == (n - blen)); + s->img_buffer = s->img_buffer_end; + return res; + } + } - if (s->img_buffer+n <= s->img_buffer_end) { - memcpy(buffer, s->img_buffer, n); - s->img_buffer += n; - return 1; - } else - return 0; + if (s->img_buffer + n <= s->img_buffer_end) { + memcpy(buffer, s->img_buffer, n); + s->img_buffer += n; + return 1; + } + else + return 0; } #endif #if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) // nothing #else -static int stbi__get16be(stbi__context *s) +static int stbi__get16be(stbi__context* s) { - int z = stbi__get8(s); - return (z << 8) + stbi__get8(s); + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); } #endif #if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) // nothing #else -static stbi__uint32 stbi__get32be(stbi__context *s) +static stbi__uint32 stbi__get32be(stbi__context* s) { - stbi__uint32 z = stbi__get16be(s); - return (z << 16) + stbi__get16be(s); + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); } #endif #if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) // nothing #else -static int stbi__get16le(stbi__context *s) +static int stbi__get16le(stbi__context* s) { - int z = stbi__get8(s); - return z + (stbi__get8(s) << 8); + int z = stbi__get8(s); + return z + (stbi__get8(s) << 8); } #endif #ifndef STBI_NO_BMP -static stbi__uint32 stbi__get32le(stbi__context *s) +static stbi__uint32 stbi__get32le(stbi__context* s) { - stbi__uint32 z = stbi__get16le(s); - z += (stbi__uint32)stbi__get16le(s) << 16; - return z; + stbi__uint32 z = stbi__get16le(s); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; } #endif @@ -1725,55 +1727,55 @@ static stbi__uint32 stbi__get32le(stbi__context *s) static stbi_uc stbi__compute_y(int r, int g, int b) { - return (stbi_uc) (((r*77) + (g*150) + (29*b)) >> 8); + return (stbi_uc)(((r * 77) + (g * 150) + (29 * b)) >> 8); } #endif #if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) // nothing #else -static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y) +static unsigned char* stbi__convert_format(unsigned char* data, int img_n, int req_comp, unsigned int x, unsigned int y) { - int i,j; - unsigned char *good; + int i, j; + unsigned char* good; - if (req_comp == img_n) return data; - STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); - good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0); - if (good == NULL) { - STBI_FREE(data); - return stbi__errpuc("outofmem", "Out of memory"); - } + good = (unsigned char*)stbi__malloc_mad3(req_comp, x, y, 0); + if (good == NULL) { + STBI_FREE(data); + return stbi__errpuc("outofmem", "Out of memory"); + } - for (j=0; j < (int) y; ++j) { - unsigned char *src = data + j * x * img_n ; - unsigned char *dest = good + j * x * req_comp; - - #define STBI__COMBO(a,b) ((a)*8+(b)) - #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) - // convert source image with img_n components to one with req_comp components; - // avoid switch per pixel, so use switch per scanline and massive macros - switch (STBI__COMBO(img_n, req_comp)) { - STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255; } break; - STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; - STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255; } break; - STBI__CASE(2,1) { dest[0]=src[0]; } break; - STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; - STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; - STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255; } break; - STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; - STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255; } break; - STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; - STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break; - STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; - default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); - } - #undef STBI__CASE - } + for (j = 0; j < (int)y; ++j) { + unsigned char* src = data + j * x * img_n; + unsigned char* dest = good + j * x * req_comp; + +#define STBI__COMBO(a,b) ((a)*8+(b)) +#define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1, 2) { dest[0] = src[0]; dest[1] = 255; } break; + STBI__CASE(1, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; + STBI__CASE(1, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = 255; } break; + STBI__CASE(2, 1) { dest[0] = src[0]; } break; + STBI__CASE(2, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; + STBI__CASE(2, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = src[1]; } break; + STBI__CASE(3, 4) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; dest[3] = 255; } break; + STBI__CASE(3, 1) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); } break; + STBI__CASE(3, 2) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); dest[1] = 255; } break; + STBI__CASE(4, 1) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); } break; + STBI__CASE(4, 2) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); dest[1] = src[3]; } break; + STBI__CASE(4, 3) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); + } +#undef STBI__CASE + } - STBI_FREE(data); - return good; + STBI_FREE(data); + return good; } #endif @@ -1782,110 +1784,110 @@ static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int r #else static stbi__uint16 stbi__compute_y_16(int r, int g, int b) { - return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); + return (stbi__uint16)(((r * 77) + (g * 150) + (29 * b)) >> 8); } #endif #if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) // nothing #else -static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y) +static stbi__uint16* stbi__convert_format16(stbi__uint16* data, int img_n, int req_comp, unsigned int x, unsigned int y) { - int i,j; - stbi__uint16 *good; + int i, j; + stbi__uint16* good; - if (req_comp == img_n) return data; - STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); - good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2); - if (good == NULL) { - STBI_FREE(data); - return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); - } + good = (stbi__uint16*)stbi__malloc(req_comp * x * y * 2); + if (good == NULL) { + STBI_FREE(data); + return (stbi__uint16*)stbi__errpuc("outofmem", "Out of memory"); + } - for (j=0; j < (int) y; ++j) { - stbi__uint16 *src = data + j * x * img_n ; - stbi__uint16 *dest = good + j * x * req_comp; - - #define STBI__COMBO(a,b) ((a)*8+(b)) - #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) - // convert source image with img_n components to one with req_comp components; - // avoid switch per pixel, so use switch per scanline and massive macros - switch (STBI__COMBO(img_n, req_comp)) { - STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff; } break; - STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; - STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff; } break; - STBI__CASE(2,1) { dest[0]=src[0]; } break; - STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; - STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; - STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff; } break; - STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; - STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break; - STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; - STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break; - STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; - default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*) stbi__errpuc("unsupported", "Unsupported format conversion"); - } - #undef STBI__CASE - } + for (j = 0; j < (int)y; ++j) { + stbi__uint16* src = data + j * x * img_n; + stbi__uint16* dest = good + j * x * req_comp; + +#define STBI__COMBO(a,b) ((a)*8+(b)) +#define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1, 2) { dest[0] = src[0]; dest[1] = 0xffff; } break; + STBI__CASE(1, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; + STBI__CASE(1, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = 0xffff; } break; + STBI__CASE(2, 1) { dest[0] = src[0]; } break; + STBI__CASE(2, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; + STBI__CASE(2, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = src[1]; } break; + STBI__CASE(3, 4) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; dest[3] = 0xffff; } break; + STBI__CASE(3, 1) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); } break; + STBI__CASE(3, 2) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); dest[1] = 0xffff; } break; + STBI__CASE(4, 1) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); } break; + STBI__CASE(4, 2) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); dest[1] = src[3]; } break; + STBI__CASE(4, 3) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*)stbi__errpuc("unsupported", "Unsupported format conversion"); + } +#undef STBI__CASE + } - STBI_FREE(data); - return good; + STBI_FREE(data); + return good; } #endif #ifndef STBI_NO_LINEAR -static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp) -{ - int i,k,n; - float *output; - if (!data) return NULL; - output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0); - if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } - // compute number of non-alpha components - if (comp & 1) n = comp; else n = comp-1; - for (i=0; i < x*y; ++i) { - for (k=0; k < n; ++k) { - output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale); - } - } - if (n < comp) { - for (i=0; i < x*y; ++i) { - output[i*comp + n] = data[i*comp + n]/255.0f; - } - } - STBI_FREE(data); - return output; +static float* stbi__ldr_to_hdr(stbi_uc* data, int x, int y, int comp) +{ + int i, k, n; + float* output; + if (!data) return NULL; + output = (float*)stbi__malloc_mad4(x, y, comp, sizeof(float), 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp - 1; + for (i = 0; i < x * y; ++i) { + for (k = 0; k < n; ++k) { + output[i * comp + k] = (float)(pow(data[i * comp + k] / 255.0f, stbi__l2h_gamma) * stbi__l2h_scale); + } + } + if (n < comp) { + for (i = 0; i < x * y; ++i) { + output[i * comp + n] = data[i * comp + n] / 255.0f; + } + } + STBI_FREE(data); + return output; } #endif #ifndef STBI_NO_HDR #define stbi__float2int(x) ((int) (x)) -static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp) -{ - int i,k,n; - stbi_uc *output; - if (!data) return NULL; - output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0); - if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } - // compute number of non-alpha components - if (comp & 1) n = comp; else n = comp-1; - for (i=0; i < x*y; ++i) { - for (k=0; k < n; ++k) { - float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; - if (z < 0) z = 0; - if (z > 255) z = 255; - output[i*comp + k] = (stbi_uc) stbi__float2int(z); - } - if (k < comp) { - float z = data[i*comp+k] * 255 + 0.5f; - if (z < 0) z = 0; - if (z > 255) z = 255; - output[i*comp + k] = (stbi_uc) stbi__float2int(z); - } - } - STBI_FREE(data); - return output; +static stbi_uc* stbi__hdr_to_ldr(float* data, int x, int y, int comp) +{ + int i, k, n; + stbi_uc* output; + if (!data) return NULL; + output = (stbi_uc*)stbi__malloc_mad3(x, y, comp, 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp - 1; + for (i = 0; i < x * y; ++i) { + for (k = 0; k < n; ++k) { + float z = (float)pow(data[i * comp + k] * stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i * comp + k] = (stbi_uc)stbi__float2int(z); + } + if (k < comp) { + float z = data[i * comp + k] * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i * comp + k] = (stbi_uc)stbi__float2int(z); + } + } + STBI_FREE(data); + return output; } #endif @@ -1917,253 +1919,253 @@ static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp) typedef struct { - stbi_uc fast[1 << FAST_BITS]; - // weirdly, repacking this into AoS is a 10% speed loss, instead of a win - stbi__uint16 code[256]; - stbi_uc values[256]; - stbi_uc size[257]; - unsigned int maxcode[18]; - int delta[17]; // old 'firstsymbol' - old 'firstcode' + stbi_uc fast[1 << FAST_BITS]; + // weirdly, repacking this into AoS is a 10% speed loss, instead of a win + stbi__uint16 code[256]; + stbi_uc values[256]; + stbi_uc size[257]; + unsigned int maxcode[18]; + int delta[17]; // old 'firstsymbol' - old 'firstcode' } stbi__huffman; typedef struct { - stbi__context *s; - stbi__huffman huff_dc[4]; - stbi__huffman huff_ac[4]; - stbi__uint16 dequant[4][64]; - stbi__int16 fast_ac[4][1 << FAST_BITS]; - -// sizes for components, interleaved MCUs - int img_h_max, img_v_max; - int img_mcu_x, img_mcu_y; - int img_mcu_w, img_mcu_h; - -// definition of jpeg image component - struct - { - int id; - int h,v; - int tq; - int hd,ha; - int dc_pred; - - int x,y,w2,h2; - stbi_uc *data; - void *raw_data, *raw_coeff; - stbi_uc *linebuf; - short *coeff; // progressive only - int coeff_w, coeff_h; // number of 8x8 coefficient blocks - } img_comp[4]; - - stbi__uint32 code_buffer; // jpeg entropy-coded buffer - int code_bits; // number of valid bits - unsigned char marker; // marker seen while filling entropy buffer - int nomore; // flag if we saw a marker so must stop - - int progressive; - int spec_start; - int spec_end; - int succ_high; - int succ_low; - int eob_run; - int jfif; - int app14_color_transform; // Adobe APP14 tag - int rgb; - - int scan_n, order[4]; - int restart_interval, todo; - -// kernels - void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]); - void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step); - stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs); + stbi__context* s; + stbi__huffman huff_dc[4]; + stbi__huffman huff_ac[4]; + stbi__uint16 dequant[4][64]; + stbi__int16 fast_ac[4][1 << FAST_BITS]; + + // sizes for components, interleaved MCUs + int img_h_max, img_v_max; + int img_mcu_x, img_mcu_y; + int img_mcu_w, img_mcu_h; + + // definition of jpeg image component + struct + { + int id; + int h, v; + int tq; + int hd, ha; + int dc_pred; + + int x, y, w2, h2; + stbi_uc* data; + void* raw_data, * raw_coeff; + stbi_uc* linebuf; + short* coeff; // progressive only + int coeff_w, coeff_h; // number of 8x8 coefficient blocks + } img_comp[4]; + + stbi__uint32 code_buffer; // jpeg entropy-coded buffer + int code_bits; // number of valid bits + unsigned char marker; // marker seen while filling entropy buffer + int nomore; // flag if we saw a marker so must stop + + int progressive; + int spec_start; + int spec_end; + int succ_high; + int succ_low; + int eob_run; + int jfif; + int app14_color_transform; // Adobe APP14 tag + int rgb; + + int scan_n, order[4]; + int restart_interval, todo; + + // kernels + void (*idct_block_kernel)(stbi_uc* out, int out_stride, short data[64]); + void (*YCbCr_to_RGB_kernel)(stbi_uc* out, const stbi_uc* y, const stbi_uc* pcb, const stbi_uc* pcr, int count, int step); + stbi_uc* (*resample_row_hv_2_kernel)(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs); } stbi__jpeg; -static int stbi__build_huffman(stbi__huffman *h, int *count) -{ - int i,j,k=0; - unsigned int code; - // build size list for each symbol (from JPEG spec) - for (i=0; i < 16; ++i) - for (j=0; j < count[i]; ++j) - h->size[k++] = (stbi_uc) (i+1); - h->size[k] = 0; - - // compute actual symbols (from jpeg spec) - code = 0; - k = 0; - for(j=1; j <= 16; ++j) { - // compute delta to add to code to compute symbol id - h->delta[j] = k - code; - if (h->size[k] == j) { - while (h->size[k] == j) - h->code[k++] = (stbi__uint16) (code++); - if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG"); - } - // compute largest code + 1 for this size, preshifted as needed later - h->maxcode[j] = code << (16-j); - code <<= 1; - } - h->maxcode[j] = 0xffffffff; - - // build non-spec acceleration table; 255 is flag for not-accelerated - memset(h->fast, 255, 1 << FAST_BITS); - for (i=0; i < k; ++i) { - int s = h->size[i]; - if (s <= FAST_BITS) { - int c = h->code[i] << (FAST_BITS-s); - int m = 1 << (FAST_BITS-s); - for (j=0; j < m; ++j) { - h->fast[c+j] = (stbi_uc) i; - } - } - } - return 1; +static int stbi__build_huffman(stbi__huffman* h, int* count) +{ + int i, j, k = 0; + unsigned int code; + // build size list for each symbol (from JPEG spec) + for (i = 0; i < 16; ++i) + for (j = 0; j < count[i]; ++j) + h->size[k++] = (stbi_uc)(i + 1); + h->size[k] = 0; + + // compute actual symbols (from jpeg spec) + code = 0; + k = 0; + for (j = 1; j <= 16; ++j) { + // compute delta to add to code to compute symbol id + h->delta[j] = k - code; + if (h->size[k] == j) { + while (h->size[k] == j) + h->code[k++] = (stbi__uint16)(code++); + if (code - 1 >= (1u << j)) return stbi__err("bad code lengths", "Corrupt JPEG"); + } + // compute largest code + 1 for this size, preshifted as needed later + h->maxcode[j] = code << (16 - j); + code <<= 1; + } + h->maxcode[j] = 0xffffffff; + + // build non-spec acceleration table; 255 is flag for not-accelerated + memset(h->fast, 255, 1 << FAST_BITS); + for (i = 0; i < k; ++i) { + int s = h->size[i]; + if (s <= FAST_BITS) { + int c = h->code[i] << (FAST_BITS - s); + int m = 1 << (FAST_BITS - s); + for (j = 0; j < m; ++j) { + h->fast[c + j] = (stbi_uc)i; + } + } + } + return 1; } // build a table that decodes both magnitude and value of small ACs in // one go. -static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h) -{ - int i; - for (i=0; i < (1 << FAST_BITS); ++i) { - stbi_uc fast = h->fast[i]; - fast_ac[i] = 0; - if (fast < 255) { - int rs = h->values[fast]; - int run = (rs >> 4) & 15; - int magbits = rs & 15; - int len = h->size[fast]; - - if (magbits && len + magbits <= FAST_BITS) { - // magnitude code followed by receive_extend code - int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); - int m = 1 << (magbits - 1); - if (k < m) k += (~0U << magbits) + 1; - // if the result is small enough, we can fit it in fast_ac table - if (k >= -128 && k <= 127) - fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits)); - } - } - } +static void stbi__build_fast_ac(stbi__int16* fast_ac, stbi__huffman* h) +{ + int i; + for (i = 0; i < (1 << FAST_BITS); ++i) { + stbi_uc fast = h->fast[i]; + fast_ac[i] = 0; + if (fast < 255) { + int rs = h->values[fast]; + int run = (rs >> 4) & 15; + int magbits = rs & 15; + int len = h->size[fast]; + + if (magbits && len + magbits <= FAST_BITS) { + // magnitude code followed by receive_extend code + int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); + int m = 1 << (magbits - 1); + if (k < m) k += (~0U << magbits) + 1; + // if the result is small enough, we can fit it in fast_ac table + if (k >= -128 && k <= 127) + fast_ac[i] = (stbi__int16)((k * 256) + (run * 16) + (len + magbits)); + } + } + } } -static void stbi__grow_buffer_unsafe(stbi__jpeg *j) +static void stbi__grow_buffer_unsafe(stbi__jpeg* j) { - do { - unsigned int b = j->nomore ? 0 : stbi__get8(j->s); - if (b == 0xff) { - int c = stbi__get8(j->s); - while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes - if (c != 0) { - j->marker = (unsigned char) c; - j->nomore = 1; - return; - } - } - j->code_buffer |= b << (24 - j->code_bits); - j->code_bits += 8; - } while (j->code_bits <= 24); + do { + unsigned int b = j->nomore ? 0 : stbi__get8(j->s); + if (b == 0xff) { + int c = stbi__get8(j->s); + while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes + if (c != 0) { + j->marker = (unsigned char)c; + j->nomore = 1; + return; + } + } + j->code_buffer |= b << (24 - j->code_bits); + j->code_bits += 8; + } while (j->code_bits <= 24); } // (1 << n) - 1 -static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535}; +static const stbi__uint32 stbi__bmask[17] = { 0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535 }; // decode a jpeg huffman value from the bitstream -stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h) -{ - unsigned int temp; - int c,k; - - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - - // look at the top FAST_BITS and determine what symbol ID it is, - // if the code is <= FAST_BITS - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); - k = h->fast[c]; - if (k < 255) { - int s = h->size[k]; - if (s > j->code_bits) - return -1; - j->code_buffer <<= s; - j->code_bits -= s; - return h->values[k]; - } +stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg* j, stbi__huffman* h) +{ + unsigned int temp; + int c, k; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + // look at the top FAST_BITS and determine what symbol ID it is, + // if the code is <= FAST_BITS + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); + k = h->fast[c]; + if (k < 255) { + int s = h->size[k]; + if (s > j->code_bits) + return -1; + j->code_buffer <<= s; + j->code_bits -= s; + return h->values[k]; + } - // naive test is to shift the code_buffer down so k bits are - // valid, then test against maxcode. To speed this up, we've - // preshifted maxcode left so that it has (16-k) 0s at the - // end; in other words, regardless of the number of bits, it - // wants to be compared against something shifted to have 16; - // that way we don't need to shift inside the loop. - temp = j->code_buffer >> 16; - for (k=FAST_BITS+1 ; ; ++k) - if (temp < h->maxcode[k]) - break; - if (k == 17) { - // error! code not found - j->code_bits -= 16; - return -1; - } + // naive test is to shift the code_buffer down so k bits are + // valid, then test against maxcode. To speed this up, we've + // preshifted maxcode left so that it has (16-k) 0s at the + // end; in other words, regardless of the number of bits, it + // wants to be compared against something shifted to have 16; + // that way we don't need to shift inside the loop. + temp = j->code_buffer >> 16; + for (k = FAST_BITS + 1; ; ++k) + if (temp < h->maxcode[k]) + break; + if (k == 17) { + // error! code not found + j->code_bits -= 16; + return -1; + } - if (k > j->code_bits) - return -1; + if (k > j->code_bits) + return -1; - // convert the huffman code to the symbol id - c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; - STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); + // convert the huffman code to the symbol id + c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; + STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); - // convert the id to a symbol - j->code_bits -= k; - j->code_buffer <<= k; - return h->values[c]; + // convert the id to a symbol + j->code_bits -= k; + j->code_buffer <<= k; + return h->values[c]; } // bias[n] = (-1<code_bits < n) stbi__grow_buffer_unsafe(j); + unsigned int k; + int sgn; + if (j->code_bits < n) stbi__grow_buffer_unsafe(j); - sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) - k = stbi_lrot(j->code_buffer, n); - j->code_buffer = k & ~stbi__bmask[n]; - k &= stbi__bmask[n]; - j->code_bits -= n; - return k + (stbi__jbias[n] & (sgn - 1)); + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k + (stbi__jbias[n] & (sgn - 1)); } // get some unsigned bits -stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n) +stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg* j, int n) { - unsigned int k; - if (j->code_bits < n) stbi__grow_buffer_unsafe(j); - k = stbi_lrot(j->code_buffer, n); - j->code_buffer = k & ~stbi__bmask[n]; - k &= stbi__bmask[n]; - j->code_bits -= n; - return k; + unsigned int k; + if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k; } -stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j) +stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg* j) { - unsigned int k; - if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); - k = j->code_buffer; - j->code_buffer <<= 1; - --j->code_bits; - return k & 0x80000000; + unsigned int k; + if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); + k = j->code_buffer; + j->code_buffer <<= 1; + --j->code_bits; + return k & 0x80000000; } // given a value that's at position X in the zigzag stream, // where does it appear in the 8x8 matrix coded as row-major? -static const stbi_uc stbi__jpeg_dezigzag[64+15] = +static const stbi_uc stbi__jpeg_dezigzag[64 + 15] = { 0, 1, 8, 16, 9, 2, 3, 10, 17, 24, 32, 25, 18, 11, 4, 5, @@ -2179,214 +2181,224 @@ static const stbi_uc stbi__jpeg_dezigzag[64+15] = }; // decode one 64-entry block-- -static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant) -{ - int diff,dc,k; - int t; - - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - t = stbi__jpeg_huff_decode(j, hdc); - if (t < 0 || t > 15) return stbi__err("bad huffman code","Corrupt JPEG"); - - // 0 all the ac values now so we can do it 32-bits at a time - memset(data,0,64*sizeof(data[0])); - - diff = t ? stbi__extend_receive(j, t) : 0; - dc = j->img_comp[b].dc_pred + diff; - j->img_comp[b].dc_pred = dc; - data[0] = (short) (dc * dequant[0]); - - // decode AC components, see JPEG spec - k = 1; - do { - unsigned int zig; - int c,r,s; - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); - r = fac[c]; - if (r) { // fast-AC path - k += (r >> 4) & 15; // run - s = r & 15; // combined length - j->code_buffer <<= s; - j->code_bits -= s; - // decode into unzigzag'd location - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) ((r >> 8) * dequant[zig]); - } else { - int rs = stbi__jpeg_huff_decode(j, hac); - if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (rs != 0xf0) break; // end block - k += 16; - } else { - k += r; +static int stbi__jpeg_decode_block(stbi__jpeg* j, short data[64], stbi__huffman* hdc, stbi__huffman* hac, stbi__int16* fac, int b, stbi__uint16* dequant) +{ + int diff, dc, k; + int t; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("bad huffman code", "Corrupt JPEG"); + + // 0 all the ac values now so we can do it 32-bits at a time + memset(data, 0, 64 * sizeof(data[0])); + + diff = t ? stbi__extend_receive(j, t) : 0; + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + data[0] = (short)(dc * dequant[0]); + + // decode AC components, see JPEG spec + k = 1; + do { + unsigned int zig; + int c, r, s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + j->code_buffer <<= s; + j->code_bits -= s; // decode into unzigzag'd location zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]); - } - } - } while (k < 64); - return 1; + data[zig] = (short)((r >> 8) * dequant[zig]); + } + else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (rs != 0xf0) break; // end block + k += 16; + } + else { + k += r; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short)(stbi__extend_receive(j, s) * dequant[zig]); + } + } + } while (k < 64); + return 1; } -static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b) +static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg* j, short data[64], stbi__huffman* hdc, int b) { - int diff,dc; - int t; - if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + int diff, dc; + int t; + if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - if (j->succ_high == 0) { - // first scan for DC coefficient, must be first - memset(data,0,64*sizeof(data[0])); // 0 all the ac values now - t = stbi__jpeg_huff_decode(j, hdc); - if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - diff = t ? stbi__extend_receive(j, t) : 0; + if (j->succ_high == 0) { + // first scan for DC coefficient, must be first + memset(data, 0, 64 * sizeof(data[0])); // 0 all the ac values now + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + diff = t ? stbi__extend_receive(j, t) : 0; - dc = j->img_comp[b].dc_pred + diff; - j->img_comp[b].dc_pred = dc; - data[0] = (short) (dc * (1 << j->succ_low)); - } else { - // refinement scan for DC coefficient - if (stbi__jpeg_get_bit(j)) - data[0] += (short) (1 << j->succ_low); - } - return 1; + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + data[0] = (short)(dc * (1 << j->succ_low)); + } + else { + // refinement scan for DC coefficient + if (stbi__jpeg_get_bit(j)) + data[0] += (short)(1 << j->succ_low); + } + return 1; } // @OPTIMIZE: store non-zigzagged during the decode passes, // and only de-zigzag when dequantizing -static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac) +static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg* j, short data[64], stbi__huffman* hac, stbi__int16* fac) { - int k; - if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + int k; + if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - if (j->succ_high == 0) { - int shift = j->succ_low; + if (j->succ_high == 0) { + int shift = j->succ_low; - if (j->eob_run) { - --j->eob_run; - return 1; - } + if (j->eob_run) { + --j->eob_run; + return 1; + } - k = j->spec_start; - do { - unsigned int zig; - int c,r,s; - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); - r = fac[c]; - if (r) { // fast-AC path - k += (r >> 4) & 15; // run - s = r & 15; // combined length - j->code_buffer <<= s; - j->code_bits -= s; - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) ((r >> 8) * (1 << shift)); - } else { - int rs = stbi__jpeg_huff_decode(j, hac); - if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (r < 15) { - j->eob_run = (1 << r); - if (r) - j->eob_run += stbi__jpeg_get_bits(j, r); - --j->eob_run; - break; - } - k += 16; - } else { - k += r; - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short) (stbi__extend_receive(j,s) * (1 << shift)); + k = j->spec_start; + do { + unsigned int zig; + int c, r, s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + j->code_buffer <<= s; + j->code_bits -= s; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short)((r >> 8) * (1 << shift)); } - } - } while (k <= j->spec_end); - } else { - // refinement scan for these AC coefficients - - short bit = (short) (1 << j->succ_low); - - if (j->eob_run) { - --j->eob_run; - for (k = j->spec_start; k <= j->spec_end; ++k) { - short *p = &data[stbi__jpeg_dezigzag[k]]; - if (*p != 0) - if (stbi__jpeg_get_bit(j)) - if ((*p & bit)==0) { - if (*p > 0) - *p += bit; - else - *p -= bit; - } - } - } else { - k = j->spec_start; - do { - int r,s; - int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh - if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (r < 15) { - j->eob_run = (1 << r) - 1; - if (r) - j->eob_run += stbi__jpeg_get_bits(j, r); - r = 64; // force end of block - } else { - // r=15 s=0 should write 16 0s, so we just do - // a run of 15 0s and then write s (which is 0), - // so we don't have to do anything special here - } - } else { - if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); - // sign bit - if (stbi__jpeg_get_bit(j)) - s = bit; - else - s = -bit; + else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r); + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + --j->eob_run; + break; + } + k += 16; + } + else { + k += r; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short)(stbi__extend_receive(j, s) * (1 << shift)); + } } - - // advance by r - while (k <= j->spec_end) { - short *p = &data[stbi__jpeg_dezigzag[k++]]; - if (*p != 0) { - if (stbi__jpeg_get_bit(j)) - if ((*p & bit)==0) { - if (*p > 0) - *p += bit; - else - *p -= bit; - } - } else { - if (r == 0) { - *p = (short) s; - break; - } - --r; - } + } while (k <= j->spec_end); + } + else { + // refinement scan for these AC coefficients + + short bit = (short)(1 << j->succ_low); + + if (j->eob_run) { + --j->eob_run; + for (k = j->spec_start; k <= j->spec_end; ++k) { + short* p = &data[stbi__jpeg_dezigzag[k]]; + if (*p != 0) + if (stbi__jpeg_get_bit(j)) + if ((*p & bit) == 0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } } - } while (k <= j->spec_end); - } - } - return 1; + } + else { + k = j->spec_start; + do { + int r, s; + int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh + if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r) - 1; + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + r = 64; // force end of block + } + else { + // r=15 s=0 should write 16 0s, so we just do + // a run of 15 0s and then write s (which is 0), + // so we don't have to do anything special here + } + } + else { + if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); + // sign bit + if (stbi__jpeg_get_bit(j)) + s = bit; + else + s = -bit; + } + + // advance by r + while (k <= j->spec_end) { + short* p = &data[stbi__jpeg_dezigzag[k++]]; + if (*p != 0) { + if (stbi__jpeg_get_bit(j)) + if ((*p & bit) == 0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } + else { + if (r == 0) { + *p = (short)s; + break; + } + --r; + } + } + } while (k <= j->spec_end); + } + } + return 1; } // take a -128..127 value and stbi__clamp it and convert to 0..255 stbi_inline static stbi_uc stbi__clamp(int x) { - // trick to use a single test to catch both cases - if ((unsigned int) x > 255) { - if (x < 0) return 0; - if (x > 255) return 255; - } - return (stbi_uc) x; + // trick to use a single test to catch both cases + if ((unsigned int)x > 255) { + if (x < 0) return 0; + if (x > 255) return 255; + } + return (stbi_uc)x; } #define stbi__f2f(x) ((int) (((x) * 4096 + 0.5))) @@ -2430,81 +2442,82 @@ stbi_inline static stbi_uc stbi__clamp(int x) t1 += p2+p4; \ t0 += p1+p3; -static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64]) -{ - int i,val[64],*v=val; - stbi_uc *o; - short *d = data; - - // columns - for (i=0; i < 8; ++i,++d, ++v) { - // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing - if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0 - && d[40]==0 && d[48]==0 && d[56]==0) { - // no shortcut 0 seconds - // (1|2|3|4|5|6|7)==0 0 seconds - // all separate -0.047 seconds - // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds - int dcterm = d[0]*4; - v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; - } else { - STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56]) - // constants scaled things up by 1<<12; let's bring them back - // down, but keep 2 extra bits of precision - x0 += 512; x1 += 512; x2 += 512; x3 += 512; - v[ 0] = (x0+t3) >> 10; - v[56] = (x0-t3) >> 10; - v[ 8] = (x1+t2) >> 10; - v[48] = (x1-t2) >> 10; - v[16] = (x2+t1) >> 10; - v[40] = (x2-t1) >> 10; - v[24] = (x3+t0) >> 10; - v[32] = (x3-t0) >> 10; - } - } +static void stbi__idct_block(stbi_uc* out, int out_stride, short data[64]) +{ + int i, val[64], * v = val; + stbi_uc* o; + short* d = data; + + // columns + for (i = 0; i < 8; ++i, ++d, ++v) { + // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing + if (d[8] == 0 && d[16] == 0 && d[24] == 0 && d[32] == 0 + && d[40] == 0 && d[48] == 0 && d[56] == 0) { + // no shortcut 0 seconds + // (1|2|3|4|5|6|7)==0 0 seconds + // all separate -0.047 seconds + // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds + int dcterm = d[0] * 4; + v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; + } + else { + STBI__IDCT_1D(d[0], d[8], d[16], d[24], d[32], d[40], d[48], d[56]) + // constants scaled things up by 1<<12; let's bring them back + // down, but keep 2 extra bits of precision + x0 += 512; x1 += 512; x2 += 512; x3 += 512; + v[0] = (x0 + t3) >> 10; + v[56] = (x0 - t3) >> 10; + v[8] = (x1 + t2) >> 10; + v[48] = (x1 - t2) >> 10; + v[16] = (x2 + t1) >> 10; + v[40] = (x2 - t1) >> 10; + v[24] = (x3 + t0) >> 10; + v[32] = (x3 - t0) >> 10; + } + } - for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) { - // no fast case since the first 1D IDCT spread components out - STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7]) - // constants scaled things up by 1<<12, plus we had 1<<2 from first - // loop, plus horizontal and vertical each scale by sqrt(8) so together - // we've got an extra 1<<3, so 1<<17 total we need to remove. - // so we want to round that, which means adding 0.5 * 1<<17, - // aka 65536. Also, we'll end up with -128 to 127 that we want - // to encode as 0..255 by adding 128, so we'll add that before the shift - x0 += 65536 + (128<<17); - x1 += 65536 + (128<<17); - x2 += 65536 + (128<<17); - x3 += 65536 + (128<<17); - // tried computing the shifts into temps, or'ing the temps to see - // if any were out of range, but that was slower - o[0] = stbi__clamp((x0+t3) >> 17); - o[7] = stbi__clamp((x0-t3) >> 17); - o[1] = stbi__clamp((x1+t2) >> 17); - o[6] = stbi__clamp((x1-t2) >> 17); - o[2] = stbi__clamp((x2+t1) >> 17); - o[5] = stbi__clamp((x2-t1) >> 17); - o[3] = stbi__clamp((x3+t0) >> 17); - o[4] = stbi__clamp((x3-t0) >> 17); - } + for (i = 0, v = val, o = out; i < 8; ++i, v += 8, o += out_stride) { + // no fast case since the first 1D IDCT spread components out + STBI__IDCT_1D(v[0], v[1], v[2], v[3], v[4], v[5], v[6], v[7]) + // constants scaled things up by 1<<12, plus we had 1<<2 from first + // loop, plus horizontal and vertical each scale by sqrt(8) so together + // we've got an extra 1<<3, so 1<<17 total we need to remove. + // so we want to round that, which means adding 0.5 * 1<<17, + // aka 65536. Also, we'll end up with -128 to 127 that we want + // to encode as 0..255 by adding 128, so we'll add that before the shift + x0 += 65536 + (128 << 17); + x1 += 65536 + (128 << 17); + x2 += 65536 + (128 << 17); + x3 += 65536 + (128 << 17); + // tried computing the shifts into temps, or'ing the temps to see + // if any were out of range, but that was slower + o[0] = stbi__clamp((x0 + t3) >> 17); + o[7] = stbi__clamp((x0 - t3) >> 17); + o[1] = stbi__clamp((x1 + t2) >> 17); + o[6] = stbi__clamp((x1 - t2) >> 17); + o[2] = stbi__clamp((x2 + t1) >> 17); + o[5] = stbi__clamp((x2 - t1) >> 17); + o[3] = stbi__clamp((x3 + t0) >> 17); + o[4] = stbi__clamp((x3 - t0) >> 17); + } } #ifdef STBI_SSE2 // sse2 integer IDCT. not the fastest possible implementation but it // produces bit-identical results to the generic C version so it's // fully "transparent". -static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +static void stbi__idct_simd(stbi_uc* out, int out_stride, short data[64]) { - // This is constructed to match our regular (generic) integer IDCT exactly. - __m128i row0, row1, row2, row3, row4, row5, row6, row7; - __m128i tmp; + // This is constructed to match our regular (generic) integer IDCT exactly. + __m128i row0, row1, row2, row3, row4, row5, row6, row7; + __m128i tmp; - // dot product constant: even elems=x, odd elems=y - #define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) + // dot product constant: even elems=x, odd elems=y +#define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) - // out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) - // out(1) = c1[even]*x + c1[odd]*y - #define dct_rot(out0,out1, x,y,c0,c1) \ +// out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) +// out(1) = c1[even]*x + c1[odd]*y +#define dct_rot(out0,out1, x,y,c0,c1) \ __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \ __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \ __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \ @@ -2513,22 +2526,22 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) __m128i out1##_h = _mm_madd_epi16(c0##hi, c1) // out = in << 12 (in 16-bit, out 32-bit) - #define dct_widen(out, in) \ +#define dct_widen(out, in) \ __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \ __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4) // wide add - #define dct_wadd(out, a, b) \ +#define dct_wadd(out, a, b) \ __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \ __m128i out##_h = _mm_add_epi32(a##_h, b##_h) // wide sub - #define dct_wsub(out, a, b) \ +#define dct_wsub(out, a, b) \ __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \ __m128i out##_h = _mm_sub_epi32(a##_h, b##_h) // butterfly a/b, add bias, then shift by "s" and pack - #define dct_bfly32o(out0, out1, a,b,bias,s) \ +#define dct_bfly32o(out0, out1, a,b,bias,s) \ { \ __m128i abiased_l = _mm_add_epi32(a##_l, bias); \ __m128i abiased_h = _mm_add_epi32(a##_h, bias); \ @@ -2539,18 +2552,18 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) } // 8-bit interleave step (for transposes) - #define dct_interleave8(a, b) \ +#define dct_interleave8(a, b) \ tmp = a; \ a = _mm_unpacklo_epi8(a, b); \ b = _mm_unpackhi_epi8(tmp, b) // 16-bit interleave step (for transposes) - #define dct_interleave16(a, b) \ +#define dct_interleave16(a, b) \ tmp = a; \ a = _mm_unpacklo_epi16(a, b); \ b = _mm_unpackhi_epi16(tmp, b) - #define dct_pass(bias,shift) \ +#define dct_pass(bias,shift) \ { \ /* even part */ \ dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \ @@ -2578,84 +2591,84 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) dct_bfly32o(row3,row4, x3,x4,bias,shift); \ } - __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); - __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f)); - __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); - __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); - __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f)); - __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f)); - __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f)); - __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f)); - - // rounding biases in column/row passes, see stbi__idct_block for explanation. - __m128i bias_0 = _mm_set1_epi32(512); - __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17)); - - // load - row0 = _mm_load_si128((const __m128i *) (data + 0*8)); - row1 = _mm_load_si128((const __m128i *) (data + 1*8)); - row2 = _mm_load_si128((const __m128i *) (data + 2*8)); - row3 = _mm_load_si128((const __m128i *) (data + 3*8)); - row4 = _mm_load_si128((const __m128i *) (data + 4*8)); - row5 = _mm_load_si128((const __m128i *) (data + 5*8)); - row6 = _mm_load_si128((const __m128i *) (data + 6*8)); - row7 = _mm_load_si128((const __m128i *) (data + 7*8)); - - // column pass - dct_pass(bias_0, 10); - - { - // 16bit 8x8 transpose pass 1 - dct_interleave16(row0, row4); - dct_interleave16(row1, row5); - dct_interleave16(row2, row6); - dct_interleave16(row3, row7); - - // transpose pass 2 - dct_interleave16(row0, row2); - dct_interleave16(row1, row3); - dct_interleave16(row4, row6); - dct_interleave16(row5, row7); - - // transpose pass 3 - dct_interleave16(row0, row1); - dct_interleave16(row2, row3); - dct_interleave16(row4, row5); - dct_interleave16(row6, row7); - } + __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); + __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f(0.765366865f), stbi__f2f(0.5411961f)); + __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); + __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); + __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f(0.298631336f), stbi__f2f(-1.961570560f)); + __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f(3.072711026f)); + __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f(2.053119869f), stbi__f2f(-0.390180644f)); + __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f(1.501321110f)); + + // rounding biases in column/row passes, see stbi__idct_block for explanation. + __m128i bias_0 = _mm_set1_epi32(512); + __m128i bias_1 = _mm_set1_epi32(65536 + (128 << 17)); + + // load + row0 = _mm_load_si128((const __m128i*) (data + 0 * 8)); + row1 = _mm_load_si128((const __m128i*) (data + 1 * 8)); + row2 = _mm_load_si128((const __m128i*) (data + 2 * 8)); + row3 = _mm_load_si128((const __m128i*) (data + 3 * 8)); + row4 = _mm_load_si128((const __m128i*) (data + 4 * 8)); + row5 = _mm_load_si128((const __m128i*) (data + 5 * 8)); + row6 = _mm_load_si128((const __m128i*) (data + 6 * 8)); + row7 = _mm_load_si128((const __m128i*) (data + 7 * 8)); + + // column pass + dct_pass(bias_0, 10); + + { + // 16bit 8x8 transpose pass 1 + dct_interleave16(row0, row4); + dct_interleave16(row1, row5); + dct_interleave16(row2, row6); + dct_interleave16(row3, row7); + + // transpose pass 2 + dct_interleave16(row0, row2); + dct_interleave16(row1, row3); + dct_interleave16(row4, row6); + dct_interleave16(row5, row7); + + // transpose pass 3 + dct_interleave16(row0, row1); + dct_interleave16(row2, row3); + dct_interleave16(row4, row5); + dct_interleave16(row6, row7); + } - // row pass - dct_pass(bias_1, 17); - - { - // pack - __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 - __m128i p1 = _mm_packus_epi16(row2, row3); - __m128i p2 = _mm_packus_epi16(row4, row5); - __m128i p3 = _mm_packus_epi16(row6, row7); - - // 8bit 8x8 transpose pass 1 - dct_interleave8(p0, p2); // a0e0a1e1... - dct_interleave8(p1, p3); // c0g0c1g1... - - // transpose pass 2 - dct_interleave8(p0, p1); // a0c0e0g0... - dct_interleave8(p2, p3); // b0d0f0h0... - - // transpose pass 3 - dct_interleave8(p0, p2); // a0b0c0d0... - dct_interleave8(p1, p3); // a4b4c4d4... - - // store - _mm_storel_epi64((__m128i *) out, p0); out += out_stride; - _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i *) out, p2); out += out_stride; - _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i *) out, p1); out += out_stride; - _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i *) out, p3); out += out_stride; - _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e)); - } + // row pass + dct_pass(bias_1, 17); + + { + // pack + __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 + __m128i p1 = _mm_packus_epi16(row2, row3); + __m128i p2 = _mm_packus_epi16(row4, row5); + __m128i p3 = _mm_packus_epi16(row6, row7); + + // 8bit 8x8 transpose pass 1 + dct_interleave8(p0, p2); // a0e0a1e1... + dct_interleave8(p1, p3); // c0g0c1g1... + + // transpose pass 2 + dct_interleave8(p0, p1); // a0c0e0g0... + dct_interleave8(p2, p3); // b0d0f0h0... + + // transpose pass 3 + dct_interleave8(p0, p2); // a0b0c0d0... + dct_interleave8(p1, p3); // a4b4c4d4... + + // store + _mm_storel_epi64((__m128i*) out, p0); out += out_stride; + _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i*) out, p2); out += out_stride; + _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i*) out, p1); out += out_stride; + _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i*) out, p3); out += out_stride; + _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p3, 0x4e)); + } #undef dct_const #undef dct_rot @@ -2674,22 +2687,22 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) // NEON integer IDCT. should produce bit-identical // results to the generic C version. -static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) -{ - int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; - - int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); - int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); - int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f)); - int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f)); - int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); - int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); - int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); - int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); - int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f)); - int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f)); - int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f)); - int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f)); +static void stbi__idct_simd(stbi_uc* out, int out_stride, short data[64]) +{ + int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; + + int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); + int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); + int16x4_t rot0_2 = vdup_n_s16(stbi__f2f(0.765366865f)); + int16x4_t rot1_0 = vdup_n_s16(stbi__f2f(1.175875602f)); + int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); + int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); + int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); + int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); + int16x4_t rot3_0 = vdup_n_s16(stbi__f2f(0.298631336f)); + int16x4_t rot3_1 = vdup_n_s16(stbi__f2f(2.053119869f)); + int16x4_t rot3_2 = vdup_n_s16(stbi__f2f(3.072711026f)); + int16x4_t rot3_3 = vdup_n_s16(stbi__f2f(1.501321110f)); #define dct_long_mul(out, inq, coeff) \ int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \ @@ -2703,7 +2716,7 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \ int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12) -// wide add + // wide add #define dct_wadd(out, a, b) \ int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \ int32x4_t out##_h = vaddq_s32(a##_h, b##_h) @@ -2763,70 +2776,70 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) } // load - row0 = vld1q_s16(data + 0*8); - row1 = vld1q_s16(data + 1*8); - row2 = vld1q_s16(data + 2*8); - row3 = vld1q_s16(data + 3*8); - row4 = vld1q_s16(data + 4*8); - row5 = vld1q_s16(data + 5*8); - row6 = vld1q_s16(data + 6*8); - row7 = vld1q_s16(data + 7*8); - - // add DC bias - row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); - - // column pass - dct_pass(vrshrn_n_s32, 10); - - // 16bit 8x8 transpose - { -// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. -// whether compilers actually get this is another story, sadly. + row0 = vld1q_s16(data + 0 * 8); + row1 = vld1q_s16(data + 1 * 8); + row2 = vld1q_s16(data + 2 * 8); + row3 = vld1q_s16(data + 3 * 8); + row4 = vld1q_s16(data + 4 * 8); + row5 = vld1q_s16(data + 5 * 8); + row6 = vld1q_s16(data + 6 * 8); + row7 = vld1q_s16(data + 7 * 8); + + // add DC bias + row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); + + // column pass + dct_pass(vrshrn_n_s32, 10); + + // 16bit 8x8 transpose + { + // these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. + // whether compilers actually get this is another story, sadly. #define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; } #define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); } #define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); } // pass 1 - dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 - dct_trn16(row2, row3); - dct_trn16(row4, row5); - dct_trn16(row6, row7); - - // pass 2 - dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 - dct_trn32(row1, row3); - dct_trn32(row4, row6); - dct_trn32(row5, row7); - - // pass 3 - dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 - dct_trn64(row1, row5); - dct_trn64(row2, row6); - dct_trn64(row3, row7); + dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 + dct_trn16(row2, row3); + dct_trn16(row4, row5); + dct_trn16(row6, row7); + + // pass 2 + dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 + dct_trn32(row1, row3); + dct_trn32(row4, row6); + dct_trn32(row5, row7); + + // pass 3 + dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 + dct_trn64(row1, row5); + dct_trn64(row2, row6); + dct_trn64(row3, row7); #undef dct_trn16 #undef dct_trn32 #undef dct_trn64 - } + } - // row pass - // vrshrn_n_s32 only supports shifts up to 16, we need - // 17. so do a non-rounding shift of 16 first then follow - // up with a rounding shift by 1. - dct_pass(vshrn_n_s32, 16); - - { - // pack and round - uint8x8_t p0 = vqrshrun_n_s16(row0, 1); - uint8x8_t p1 = vqrshrun_n_s16(row1, 1); - uint8x8_t p2 = vqrshrun_n_s16(row2, 1); - uint8x8_t p3 = vqrshrun_n_s16(row3, 1); - uint8x8_t p4 = vqrshrun_n_s16(row4, 1); - uint8x8_t p5 = vqrshrun_n_s16(row5, 1); - uint8x8_t p6 = vqrshrun_n_s16(row6, 1); - uint8x8_t p7 = vqrshrun_n_s16(row7, 1); - - // again, these can translate into one instruction, but often don't. + // row pass + // vrshrn_n_s32 only supports shifts up to 16, we need + // 17. so do a non-rounding shift of 16 first then follow + // up with a rounding shift by 1. + dct_pass(vshrn_n_s32, 16); + + { + // pack and round + uint8x8_t p0 = vqrshrun_n_s16(row0, 1); + uint8x8_t p1 = vqrshrun_n_s16(row1, 1); + uint8x8_t p2 = vqrshrun_n_s16(row2, 1); + uint8x8_t p3 = vqrshrun_n_s16(row3, 1); + uint8x8_t p4 = vqrshrun_n_s16(row4, 1); + uint8x8_t p5 = vqrshrun_n_s16(row5, 1); + uint8x8_t p6 = vqrshrun_n_s16(row6, 1); + uint8x8_t p7 = vqrshrun_n_s16(row7, 1); + + // again, these can translate into one instruction, but often don't. #define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; } #define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); } #define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); } @@ -2835,37 +2848,37 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) // 8 bytes to each scan line! // 8x8 8-bit transpose pass 1 - dct_trn8_8(p0, p1); - dct_trn8_8(p2, p3); - dct_trn8_8(p4, p5); - dct_trn8_8(p6, p7); - - // pass 2 - dct_trn8_16(p0, p2); - dct_trn8_16(p1, p3); - dct_trn8_16(p4, p6); - dct_trn8_16(p5, p7); - - // pass 3 - dct_trn8_32(p0, p4); - dct_trn8_32(p1, p5); - dct_trn8_32(p2, p6); - dct_trn8_32(p3, p7); - - // store - vst1_u8(out, p0); out += out_stride; - vst1_u8(out, p1); out += out_stride; - vst1_u8(out, p2); out += out_stride; - vst1_u8(out, p3); out += out_stride; - vst1_u8(out, p4); out += out_stride; - vst1_u8(out, p5); out += out_stride; - vst1_u8(out, p6); out += out_stride; - vst1_u8(out, p7); + dct_trn8_8(p0, p1); + dct_trn8_8(p2, p3); + dct_trn8_8(p4, p5); + dct_trn8_8(p6, p7); + + // pass 2 + dct_trn8_16(p0, p2); + dct_trn8_16(p1, p3); + dct_trn8_16(p4, p6); + dct_trn8_16(p5, p7); + + // pass 3 + dct_trn8_32(p0, p4); + dct_trn8_32(p1, p5); + dct_trn8_32(p2, p6); + dct_trn8_32(p3, p7); + + // store + vst1_u8(out, p0); out += out_stride; + vst1_u8(out, p1); out += out_stride; + vst1_u8(out, p2); out += out_stride; + vst1_u8(out, p3); out += out_stride; + vst1_u8(out, p4); out += out_stride; + vst1_u8(out, p5); out += out_stride; + vst1_u8(out, p6); out += out_stride; + vst1_u8(out, p7); #undef dct_trn8_8 #undef dct_trn8_16 #undef dct_trn8_32 - } + } #undef dct_long_mul #undef dct_long_mac @@ -2882,15 +2895,15 @@ static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) // if there's a pending marker from the entropy stream, return that // otherwise, fetch from the stream and get a marker. if there's no // marker, return 0xff, which is never a valid marker value -static stbi_uc stbi__get_marker(stbi__jpeg *j) +static stbi_uc stbi__get_marker(stbi__jpeg* j) { - stbi_uc x; - if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } - x = stbi__get8(j->s); - if (x != 0xff) return STBI__MARKER_none; - while (x == 0xff) - x = stbi__get8(j->s); // consume repeated 0xff fill bytes - return x; + stbi_uc x; + if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } + x = stbi__get8(j->s); + if (x != 0xff) return STBI__MARKER_none; + while (x == 0xff) + x = stbi__get8(j->s); // consume repeated 0xff fill bytes + return x; } // in each scan, we'll have scan_n components, and the order @@ -2899,423 +2912,430 @@ static stbi_uc stbi__get_marker(stbi__jpeg *j) // after a restart interval, stbi__jpeg_reset the entropy decoder and // the dc prediction -static void stbi__jpeg_reset(stbi__jpeg *j) -{ - j->code_bits = 0; - j->code_buffer = 0; - j->nomore = 0; - j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; - j->marker = STBI__MARKER_none; - j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; - j->eob_run = 0; - // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, - // since we don't even allow 1<<30 pixels -} - -static int stbi__parse_entropy_coded_data(stbi__jpeg *z) -{ - stbi__jpeg_reset(z); - if (!z->progressive) { - if (z->scan_n == 1) { - int i,j; - STBI_SIMD_ALIGN(short, data[64]); - int n = z->order[0]; - // non-interleaved data, we just need to process one block at a time, - // in trivial scanline order - // number of blocks to do just depends on how many actual "pixels" this - // component has, independent of interleaved MCU blocking and such - int w = (z->img_comp[n].x+7) >> 3; - int h = (z->img_comp[n].y+7) >> 3; - for (j=0; j < h; ++j) { - for (i=0; i < w; ++i) { - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; - z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); - // every data block is an MCU, so countdown the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - // if it's NOT a restart, then just bail, so we get corrupt data - // rather than no data - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } - } - } - return 1; - } else { // interleaved - int i,j,k,x,y; - STBI_SIMD_ALIGN(short, data[64]); - for (j=0; j < z->img_mcu_y; ++j) { - for (i=0; i < z->img_mcu_x; ++i) { - // scan an interleaved mcu... process scan_n components in order - for (k=0; k < z->scan_n; ++k) { - int n = z->order[k]; - // scan out an mcu's worth of this component; that's just determined - // by the basic H and V specified for the component - for (y=0; y < z->img_comp[n].v; ++y) { - for (x=0; x < z->img_comp[n].h; ++x) { - int x2 = (i*z->img_comp[n].h + x)*8; - int y2 = (j*z->img_comp[n].v + y)*8; - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; - z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data); - } - } - } - // after all interleaved components, that's an interleaved MCU, - // so now count down the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } +static void stbi__jpeg_reset(stbi__jpeg* j) +{ + j->code_bits = 0; + j->code_buffer = 0; + j->nomore = 0; + j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; + j->marker = STBI__MARKER_none; + j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; + j->eob_run = 0; + // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, + // since we don't even allow 1<<30 pixels +} + +static int stbi__parse_entropy_coded_data(stbi__jpeg* z) +{ + stbi__jpeg_reset(z); + if (!z->progressive) { + if (z->scan_n == 1) { + int i, j; + STBI_SIMD_ALIGN(short, data[64]); + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x + 7) >> 3; + int h = (z->img_comp[n].y + 7) >> 3; + for (j = 0; j < h; ++j) { + for (i = 0; i < w; ++i) { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc + z->img_comp[n].hd, z->huff_ac + ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * j * 8 + i * 8, z->img_comp[n].w2, data); + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + // if it's NOT a restart, then just bail, so we get corrupt data + // rather than no data + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } } - } - return 1; - } - } else { - if (z->scan_n == 1) { - int i,j; - int n = z->order[0]; - // non-interleaved data, we just need to process one block at a time, - // in trivial scanline order - // number of blocks to do just depends on how many actual "pixels" this - // component has, independent of interleaved MCU blocking and such - int w = (z->img_comp[n].x+7) >> 3; - int h = (z->img_comp[n].y+7) >> 3; - for (j=0; j < h; ++j) { - for (i=0; i < w; ++i) { - short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); - if (z->spec_start == 0) { - if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) - return 0; - } else { - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) - return 0; - } - // every data block is an MCU, so countdown the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } + return 1; + } + else { // interleaved + int i, j, k, x, y; + STBI_SIMD_ALIGN(short, data[64]); + for (j = 0; j < z->img_mcu_y; ++j) { + for (i = 0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k = 0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y = 0; y < z->img_comp[n].v; ++y) { + for (x = 0; x < z->img_comp[n].h; ++x) { + int x2 = (i * z->img_comp[n].h + x) * 8; + int y2 = (j * z->img_comp[n].v + y) * 8; + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc + z->img_comp[n].hd, z->huff_ac + ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * y2 + x2, z->img_comp[n].w2, data); + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } } - } - return 1; - } else { // interleaved - int i,j,k,x,y; - for (j=0; j < z->img_mcu_y; ++j) { - for (i=0; i < z->img_mcu_x; ++i) { - // scan an interleaved mcu... process scan_n components in order - for (k=0; k < z->scan_n; ++k) { - int n = z->order[k]; - // scan out an mcu's worth of this component; that's just determined - // by the basic H and V specified for the component - for (y=0; y < z->img_comp[n].v; ++y) { - for (x=0; x < z->img_comp[n].h; ++x) { - int x2 = (i*z->img_comp[n].h + x); - int y2 = (j*z->img_comp[n].v + y); - short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); + return 1; + } + } + else { + if (z->scan_n == 1) { + int i, j; + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x + 7) >> 3; + int h = (z->img_comp[n].y + 7) >> 3; + for (j = 0; j < h; ++j) { + for (i = 0; i < w; ++i) { + short* data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + if (z->spec_start == 0) { if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) - return 0; - } - } - } - // after all interleaved components, that's an interleaved MCU, - // so now count down the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } + return 0; + } + else { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) + return 0; + } + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } } - } - return 1; - } - } + return 1; + } + else { // interleaved + int i, j, k, x, y; + for (j = 0; j < z->img_mcu_y; ++j) { + for (i = 0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k = 0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y = 0; y < z->img_comp[n].v; ++y) { + for (x = 0; x < z->img_comp[n].h; ++x) { + int x2 = (i * z->img_comp[n].h + x); + int y2 = (j * z->img_comp[n].v + y); + short* data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } } -static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant) +static void stbi__jpeg_dequantize(short* data, stbi__uint16* dequant) { - int i; - for (i=0; i < 64; ++i) - data[i] *= dequant[i]; + int i; + for (i = 0; i < 64; ++i) + data[i] *= dequant[i]; } -static void stbi__jpeg_finish(stbi__jpeg *z) +static void stbi__jpeg_finish(stbi__jpeg* z) { - if (z->progressive) { - // dequantize and idct the data - int i,j,n; - for (n=0; n < z->s->img_n; ++n) { - int w = (z->img_comp[n].x+7) >> 3; - int h = (z->img_comp[n].y+7) >> 3; - for (j=0; j < h; ++j) { - for (i=0; i < w; ++i) { - short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); - stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); - z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + if (z->progressive) { + // dequantize and idct the data + int i, j, n; + for (n = 0; n < z->s->img_n; ++n) { + int w = (z->img_comp[n].x + 7) >> 3; + int h = (z->img_comp[n].y + 7) >> 3; + for (j = 0; j < h; ++j) { + for (i = 0; i < w; ++i) { + short* data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); + z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * j * 8 + i * 8, z->img_comp[n].w2, data); + } } - } - } - } + } + } } -static int stbi__process_marker(stbi__jpeg *z, int m) +static int stbi__process_marker(stbi__jpeg* z, int m) { - int L; - switch (m) { - case STBI__MARKER_none: // no marker found - return stbi__err("expected marker","Corrupt JPEG"); + int L; + switch (m) { + case STBI__MARKER_none: // no marker found + return stbi__err("expected marker", "Corrupt JPEG"); - case 0xDD: // DRI - specify restart interval - if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG"); - z->restart_interval = stbi__get16be(z->s); - return 1; + case 0xDD: // DRI - specify restart interval + if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len", "Corrupt JPEG"); + z->restart_interval = stbi__get16be(z->s); + return 1; - case 0xDB: // DQT - define quantization table - L = stbi__get16be(z->s)-2; - while (L > 0) { + case 0xDB: // DQT - define quantization table + L = stbi__get16be(z->s) - 2; + while (L > 0) { int q = stbi__get8(z->s); int p = q >> 4, sixteen = (p != 0); - int t = q & 15,i; - if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG"); - if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG"); + int t = q & 15, i; + if (p != 0 && p != 1) return stbi__err("bad DQT type", "Corrupt JPEG"); + if (t > 3) return stbi__err("bad DQT table", "Corrupt JPEG"); - for (i=0; i < 64; ++i) - z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); + for (i = 0; i < 64; ++i) + z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); L -= (sixteen ? 129 : 65); - } - return L==0; - - case 0xC4: // DHT - define huffman table - L = stbi__get16be(z->s)-2; - while (L > 0) { - stbi_uc *v; - int sizes[16],i,n=0; + } + return L == 0; + + case 0xC4: // DHT - define huffman table + L = stbi__get16be(z->s) - 2; + while (L > 0) { + stbi_uc* v; + int sizes[16], i, n = 0; int q = stbi__get8(z->s); int tc = q >> 4; int th = q & 15; - if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG"); - for (i=0; i < 16; ++i) { - sizes[i] = stbi__get8(z->s); - n += sizes[i]; + if (tc > 1 || th > 3) return stbi__err("bad DHT header", "Corrupt JPEG"); + for (i = 0; i < 16; ++i) { + sizes[i] = stbi__get8(z->s); + n += sizes[i]; } L -= 17; if (tc == 0) { - if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0; - v = z->huff_dc[th].values; - } else { - if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0; - v = z->huff_ac[th].values; + if (!stbi__build_huffman(z->huff_dc + th, sizes)) return 0; + v = z->huff_dc[th].values; } - for (i=0; i < n; ++i) - v[i] = stbi__get8(z->s); + else { + if (!stbi__build_huffman(z->huff_ac + th, sizes)) return 0; + v = z->huff_ac[th].values; + } + for (i = 0; i < n; ++i) + v[i] = stbi__get8(z->s); if (tc != 0) - stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); + stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); L -= n; - } - return L==0; - } + } + return L == 0; + } - // check for comment block or APP blocks - if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { - L = stbi__get16be(z->s); - if (L < 2) { - if (m == 0xFE) - return stbi__err("bad COM len","Corrupt JPEG"); - else - return stbi__err("bad APP len","Corrupt JPEG"); - } - L -= 2; - - if (m == 0xE0 && L >= 5) { // JFIF APP0 segment - static const unsigned char tag[5] = {'J','F','I','F','\0'}; - int ok = 1; - int i; - for (i=0; i < 5; ++i) - if (stbi__get8(z->s) != tag[i]) - ok = 0; - L -= 5; - if (ok) - z->jfif = 1; - } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment - static const unsigned char tag[6] = {'A','d','o','b','e','\0'}; - int ok = 1; - int i; - for (i=0; i < 6; ++i) - if (stbi__get8(z->s) != tag[i]) - ok = 0; - L -= 6; - if (ok) { - stbi__get8(z->s); // version - stbi__get16be(z->s); // flags0 - stbi__get16be(z->s); // flags1 - z->app14_color_transform = stbi__get8(z->s); // color transform + // check for comment block or APP blocks + if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { + L = stbi__get16be(z->s); + if (L < 2) { + if (m == 0xFE) + return stbi__err("bad COM len", "Corrupt JPEG"); + else + return stbi__err("bad APP len", "Corrupt JPEG"); + } + L -= 2; + + if (m == 0xE0 && L >= 5) { // JFIF APP0 segment + static const unsigned char tag[5] = { 'J','F','I','F','\0' }; + int ok = 1; + int i; + for (i = 0; i < 5; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 5; + if (ok) + z->jfif = 1; + } + else if (m == 0xEE && L >= 12) { // Adobe APP14 segment + static const unsigned char tag[6] = { 'A','d','o','b','e','\0' }; + int ok = 1; + int i; + for (i = 0; i < 6; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; L -= 6; - } - } + if (ok) { + stbi__get8(z->s); // version + stbi__get16be(z->s); // flags0 + stbi__get16be(z->s); // flags1 + z->app14_color_transform = stbi__get8(z->s); // color transform + L -= 6; + } + } - stbi__skip(z->s, L); - return 1; - } + stbi__skip(z->s, L); + return 1; + } - return stbi__err("unknown marker","Corrupt JPEG"); + return stbi__err("unknown marker", "Corrupt JPEG"); } // after we see SOS -static int stbi__process_scan_header(stbi__jpeg *z) -{ - int i; - int Ls = stbi__get16be(z->s); - z->scan_n = stbi__get8(z->s); - if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG"); - if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG"); - for (i=0; i < z->scan_n; ++i) { - int id = stbi__get8(z->s), which; - int q = stbi__get8(z->s); - for (which = 0; which < z->s->img_n; ++which) - if (z->img_comp[which].id == id) - break; - if (which == z->s->img_n) return 0; // no match - z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG"); - z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG"); - z->order[i] = which; - } +static int stbi__process_scan_header(stbi__jpeg* z) +{ + int i; + int Ls = stbi__get16be(z->s); + z->scan_n = stbi__get8(z->s); + if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int)z->s->img_n) return stbi__err("bad SOS component count", "Corrupt JPEG"); + if (Ls != 6 + 2 * z->scan_n) return stbi__err("bad SOS len", "Corrupt JPEG"); + for (i = 0; i < z->scan_n; ++i) { + int id = stbi__get8(z->s), which; + int q = stbi__get8(z->s); + for (which = 0; which < z->s->img_n; ++which) + if (z->img_comp[which].id == id) + break; + if (which == z->s->img_n) return 0; // no match + z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff", "Corrupt JPEG"); + z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff", "Corrupt JPEG"); + z->order[i] = which; + } - { - int aa; - z->spec_start = stbi__get8(z->s); - z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 - aa = stbi__get8(z->s); - z->succ_high = (aa >> 4); - z->succ_low = (aa & 15); - if (z->progressive) { - if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) - return stbi__err("bad SOS", "Corrupt JPEG"); - } else { - if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG"); - if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG"); - z->spec_end = 63; - } - } + { + int aa; + z->spec_start = stbi__get8(z->s); + z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 + aa = stbi__get8(z->s); + z->succ_high = (aa >> 4); + z->succ_low = (aa & 15); + if (z->progressive) { + if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) + return stbi__err("bad SOS", "Corrupt JPEG"); + } + else { + if (z->spec_start != 0) return stbi__err("bad SOS", "Corrupt JPEG"); + if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS", "Corrupt JPEG"); + z->spec_end = 63; + } + } - return 1; + return 1; } -static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why) +static int stbi__free_jpeg_components(stbi__jpeg* z, int ncomp, int why) { - int i; - for (i=0; i < ncomp; ++i) { - if (z->img_comp[i].raw_data) { - STBI_FREE(z->img_comp[i].raw_data); - z->img_comp[i].raw_data = NULL; - z->img_comp[i].data = NULL; - } - if (z->img_comp[i].raw_coeff) { - STBI_FREE(z->img_comp[i].raw_coeff); - z->img_comp[i].raw_coeff = 0; - z->img_comp[i].coeff = 0; - } - if (z->img_comp[i].linebuf) { - STBI_FREE(z->img_comp[i].linebuf); - z->img_comp[i].linebuf = NULL; - } - } - return why; -} - -static int stbi__process_frame_header(stbi__jpeg *z, int scan) -{ - stbi__context *s = z->s; - int Lf,p,i,q, h_max=1,v_max=1,c; - Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG - p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline - s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG - s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); - c = stbi__get8(s); - if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG"); - s->img_n = c; - for (i=0; i < c; ++i) { - z->img_comp[i].data = NULL; - z->img_comp[i].linebuf = NULL; - } + int i; + for (i = 0; i < ncomp; ++i) { + if (z->img_comp[i].raw_data) { + STBI_FREE(z->img_comp[i].raw_data); + z->img_comp[i].raw_data = NULL; + z->img_comp[i].data = NULL; + } + if (z->img_comp[i].raw_coeff) { + STBI_FREE(z->img_comp[i].raw_coeff); + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].coeff = 0; + } + if (z->img_comp[i].linebuf) { + STBI_FREE(z->img_comp[i].linebuf); + z->img_comp[i].linebuf = NULL; + } + } + return why; +} + +static int stbi__process_frame_header(stbi__jpeg* z, int scan) +{ + stbi__context* s = z->s; + int Lf, p, i, q, h_max = 1, v_max = 1, c; + Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len", "Corrupt JPEG"); // JPEG + p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit", "JPEG format not supported: 8-bit only"); // JPEG baseline + s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG + s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width", "Corrupt JPEG"); // JPEG requires + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); + c = stbi__get8(s); + if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count", "Corrupt JPEG"); + s->img_n = c; + for (i = 0; i < c; ++i) { + z->img_comp[i].data = NULL; + z->img_comp[i].linebuf = NULL; + } - if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG"); - - z->rgb = 0; - for (i=0; i < s->img_n; ++i) { - static const unsigned char rgb[3] = { 'R', 'G', 'B' }; - z->img_comp[i].id = stbi__get8(s); - if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) - ++z->rgb; - q = stbi__get8(s); - z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG"); - z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG"); - z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG"); - } + if (Lf != 8 + 3 * s->img_n) return stbi__err("bad SOF len", "Corrupt JPEG"); + + z->rgb = 0; + for (i = 0; i < s->img_n; ++i) { + static const unsigned char rgb[3] = { 'R', 'G', 'B' }; + z->img_comp[i].id = stbi__get8(s); + if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) + ++z->rgb; + q = stbi__get8(s); + z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H", "Corrupt JPEG"); + z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V", "Corrupt JPEG"); + z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ", "Corrupt JPEG"); + } - if (scan != STBI__SCAN_load) return 1; + if (scan != STBI__SCAN_load) return 1; - if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); + if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); - for (i=0; i < s->img_n; ++i) { - if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; - if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; - } + for (i = 0; i < s->img_n; ++i) { + if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; + if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; + } - // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios - // and I've never seen a non-corrupted JPEG file actually use them - for (i=0; i < s->img_n; ++i) { - if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); - if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); - } + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i = 0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H", "Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V", "Corrupt JPEG"); + } - // compute interleaved mcu info - z->img_h_max = h_max; - z->img_v_max = v_max; - z->img_mcu_w = h_max * 8; - z->img_mcu_h = v_max * 8; - // these sizes can't be more than 17 bits - z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w; - z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h; - - for (i=0; i < s->img_n; ++i) { - // number of effective pixels (e.g. for non-interleaved MCU) - z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max; - z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max; - // to simplify generation, we'll allocate enough memory to decode - // the bogus oversized data from using interleaved MCUs and their - // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't - // discard the extra data until colorspace conversion - // - // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) - // so these muls can't overflow with 32-bit ints (which we require) - z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; - z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; - z->img_comp[i].coeff = 0; - z->img_comp[i].raw_coeff = 0; - z->img_comp[i].linebuf = NULL; - z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); - if (z->img_comp[i].raw_data == NULL) - return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); - // align blocks for idct using mmx/sse - z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15); - if (z->progressive) { - // w2, h2 are multiples of 8 (see above) - z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; - z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; - z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); - if (z->img_comp[i].raw_coeff == NULL) - return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); - z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15); - } - } + // compute interleaved mcu info + z->img_h_max = h_max; + z->img_v_max = v_max; + z->img_mcu_w = h_max * 8; + z->img_mcu_h = v_max * 8; + // these sizes can't be more than 17 bits + z->img_mcu_x = (s->img_x + z->img_mcu_w - 1) / z->img_mcu_w; + z->img_mcu_y = (s->img_y + z->img_mcu_h - 1) / z->img_mcu_h; + + for (i = 0; i < s->img_n; ++i) { + // number of effective pixels (e.g. for non-interleaved MCU) + z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max - 1) / h_max; + z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max - 1) / v_max; + // to simplify generation, we'll allocate enough memory to decode + // the bogus oversized data from using interleaved MCUs and their + // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't + // discard the extra data until colorspace conversion + // + // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) + // so these muls can't overflow with 32-bit ints (which we require) + z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; + z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; + z->img_comp[i].coeff = 0; + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].linebuf = NULL; + z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); + if (z->img_comp[i].raw_data == NULL) + return stbi__free_jpeg_components(z, i + 1, stbi__err("outofmem", "Out of memory")); + // align blocks for idct using mmx/sse + z->img_comp[i].data = (stbi_uc*)(((size_t)z->img_comp[i].raw_data + 15) & ~15); + if (z->progressive) { + // w2, h2 are multiples of 8 (see above) + z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; + z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; + z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); + if (z->img_comp[i].raw_coeff == NULL) + return stbi__free_jpeg_components(z, i + 1, stbi__err("outofmem", "Out of memory")); + z->img_comp[i].coeff = (short*)(((size_t)z->img_comp[i].raw_coeff + 15) & ~15); + } + } - return 1; + return 1; } // use comparisons since in some cases we handle more than one case (e.g. SOF) @@ -3327,697 +3347,708 @@ static int stbi__process_frame_header(stbi__jpeg *z, int scan) #define stbi__SOF_progressive(x) ((x) == 0xc2) -static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan) -{ - int m; - z->jfif = 0; - z->app14_color_transform = -1; // valid values are 0,1,2 - z->marker = STBI__MARKER_none; // initialize cached marker to empty - m = stbi__get_marker(z); - if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG"); - if (scan == STBI__SCAN_type) return 1; - m = stbi__get_marker(z); - while (!stbi__SOF(m)) { - if (!stbi__process_marker(z,m)) return 0; - m = stbi__get_marker(z); - while (m == STBI__MARKER_none) { - // some files have extra padding after their blocks, so ok, we'll scan - if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); - m = stbi__get_marker(z); - } - } - z->progressive = stbi__SOF_progressive(m); - if (!stbi__process_frame_header(z, scan)) return 0; - return 1; +static int stbi__decode_jpeg_header(stbi__jpeg* z, int scan) +{ + int m; + z->jfif = 0; + z->app14_color_transform = -1; // valid values are 0,1,2 + z->marker = STBI__MARKER_none; // initialize cached marker to empty + m = stbi__get_marker(z); + if (!stbi__SOI(m)) return stbi__err("no SOI", "Corrupt JPEG"); + if (scan == STBI__SCAN_type) return 1; + m = stbi__get_marker(z); + while (!stbi__SOF(m)) { + if (!stbi__process_marker(z, m)) return 0; + m = stbi__get_marker(z); + while (m == STBI__MARKER_none) { + // some files have extra padding after their blocks, so ok, we'll scan + if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); + m = stbi__get_marker(z); + } + } + z->progressive = stbi__SOF_progressive(m); + if (!stbi__process_frame_header(z, scan)) return 0; + return 1; } // decode image to YCbCr format -static int stbi__decode_jpeg_image(stbi__jpeg *j) +static int stbi__decode_jpeg_image(stbi__jpeg* j) { - int m; - for (m = 0; m < 4; m++) { - j->img_comp[m].raw_data = NULL; - j->img_comp[m].raw_coeff = NULL; - } - j->restart_interval = 0; - if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; - m = stbi__get_marker(j); - while (!stbi__EOI(m)) { - if (stbi__SOS(m)) { - if (!stbi__process_scan_header(j)) return 0; - if (!stbi__parse_entropy_coded_data(j)) return 0; - if (j->marker == STBI__MARKER_none ) { - // handle 0s at the end of image data from IP Kamera 9060 - while (!stbi__at_eof(j->s)) { - int x = stbi__get8(j->s); - if (x == 255) { - j->marker = stbi__get8(j->s); - break; - } + int m; + for (m = 0; m < 4; m++) { + j->img_comp[m].raw_data = NULL; + j->img_comp[m].raw_coeff = NULL; + } + j->restart_interval = 0; + if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; + m = stbi__get_marker(j); + while (!stbi__EOI(m)) { + if (stbi__SOS(m)) { + if (!stbi__process_scan_header(j)) return 0; + if (!stbi__parse_entropy_coded_data(j)) return 0; + if (j->marker == STBI__MARKER_none) { + // handle 0s at the end of image data from IP Kamera 9060 + while (!stbi__at_eof(j->s)) { + int x = stbi__get8(j->s); + if (x == 255) { + j->marker = stbi__get8(j->s); + break; + } + } + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 } - // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 - } - } else if (stbi__DNL(m)) { - int Ld = stbi__get16be(j->s); - stbi__uint32 NL = stbi__get16be(j->s); - if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); - if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); - } else { - if (!stbi__process_marker(j, m)) return 0; - } - m = stbi__get_marker(j); - } - if (j->progressive) - stbi__jpeg_finish(j); - return 1; + } + else if (stbi__DNL(m)) { + int Ld = stbi__get16be(j->s); + stbi__uint32 NL = stbi__get16be(j->s); + if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); + if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); + } + else { + if (!stbi__process_marker(j, m)) return 0; + } + m = stbi__get_marker(j); + } + if (j->progressive) + stbi__jpeg_finish(j); + return 1; } // static jfif-centered resampling (across block boundaries) -typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1, - int w, int hs); +typedef stbi_uc* (*resample_row_func)(stbi_uc* out, stbi_uc* in0, stbi_uc* in1, + int w, int hs); #define stbi__div4(x) ((stbi_uc) ((x) >> 2)) -static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* resample_row_1(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - STBI_NOTUSED(out); - STBI_NOTUSED(in_far); - STBI_NOTUSED(w); - STBI_NOTUSED(hs); - return in_near; + STBI_NOTUSED(out); + STBI_NOTUSED(in_far); + STBI_NOTUSED(w); + STBI_NOTUSED(hs); + return in_near; } -static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* stbi__resample_row_v_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - // need to generate two samples vertically for every one in input - int i; - STBI_NOTUSED(hs); - for (i=0; i < w; ++i) - out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2); - return out; + // need to generate two samples vertically for every one in input + int i; + STBI_NOTUSED(hs); + for (i = 0; i < w; ++i) + out[i] = stbi__div4(3 * in_near[i] + in_far[i] + 2); + return out; } -static stbi_uc* stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* stbi__resample_row_h_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - // need to generate two samples horizontally for every one in input - int i; - stbi_uc *input = in_near; + // need to generate two samples horizontally for every one in input + int i; + stbi_uc* input = in_near; - if (w == 1) { - // if only one sample, can't do any interpolation - out[0] = out[1] = input[0]; - return out; - } + if (w == 1) { + // if only one sample, can't do any interpolation + out[0] = out[1] = input[0]; + return out; + } - out[0] = input[0]; - out[1] = stbi__div4(input[0]*3 + input[1] + 2); - for (i=1; i < w-1; ++i) { - int n = 3*input[i]+2; - out[i*2+0] = stbi__div4(n+input[i-1]); - out[i*2+1] = stbi__div4(n+input[i+1]); - } - out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2); - out[i*2+1] = input[w-1]; + out[0] = input[0]; + out[1] = stbi__div4(input[0] * 3 + input[1] + 2); + for (i = 1; i < w - 1; ++i) { + int n = 3 * input[i] + 2; + out[i * 2 + 0] = stbi__div4(n + input[i - 1]); + out[i * 2 + 1] = stbi__div4(n + input[i + 1]); + } + out[i * 2 + 0] = stbi__div4(input[w - 2] * 3 + input[w - 1] + 2); + out[i * 2 + 1] = input[w - 1]; - STBI_NOTUSED(in_far); - STBI_NOTUSED(hs); + STBI_NOTUSED(in_far); + STBI_NOTUSED(hs); - return out; + return out; } #define stbi__div16(x) ((stbi_uc) ((x) >> 4)) -static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* stbi__resample_row_hv_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - // need to generate 2x2 samples for every one in input - int i,t0,t1; - if (w == 1) { - out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); - return out; - } + // need to generate 2x2 samples for every one in input + int i, t0, t1; + if (w == 1) { + out[0] = out[1] = stbi__div4(3 * in_near[0] + in_far[0] + 2); + return out; + } - t1 = 3*in_near[0] + in_far[0]; - out[0] = stbi__div4(t1+2); - for (i=1; i < w; ++i) { - t0 = t1; - t1 = 3*in_near[i]+in_far[i]; - out[i*2-1] = stbi__div16(3*t0 + t1 + 8); - out[i*2 ] = stbi__div16(3*t1 + t0 + 8); - } - out[w*2-1] = stbi__div4(t1+2); + t1 = 3 * in_near[0] + in_far[0]; + out[0] = stbi__div4(t1 + 2); + for (i = 1; i < w; ++i) { + t0 = t1; + t1 = 3 * in_near[i] + in_far[i]; + out[i * 2 - 1] = stbi__div16(3 * t0 + t1 + 8); + out[i * 2] = stbi__div16(3 * t1 + t0 + 8); + } + out[w * 2 - 1] = stbi__div4(t1 + 2); - STBI_NOTUSED(hs); + STBI_NOTUSED(hs); - return out; + return out; } #if defined(STBI_SSE2) || defined(STBI_NEON) -static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* stbi__resample_row_hv_2_simd(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - // need to generate 2x2 samples for every one in input - int i=0,t0,t1; + // need to generate 2x2 samples for every one in input + int i = 0, t0, t1; - if (w == 1) { - out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); - return out; - } + if (w == 1) { + out[0] = out[1] = stbi__div4(3 * in_near[0] + in_far[0] + 2); + return out; + } - t1 = 3*in_near[0] + in_far[0]; - // process groups of 8 pixels for as long as we can. - // note we can't handle the last pixel in a row in this loop - // because we need to handle the filter boundary conditions. - for (; i < ((w-1) & ~7); i += 8) { + t1 = 3 * in_near[0] + in_far[0]; + // process groups of 8 pixels for as long as we can. + // note we can't handle the last pixel in a row in this loop + // because we need to handle the filter boundary conditions. + for (; i < ((w - 1) & ~7); i += 8) { #if defined(STBI_SSE2) - // load and perform the vertical filtering pass - // this uses 3*x + y = 4*x + (y - x) - __m128i zero = _mm_setzero_si128(); - __m128i farb = _mm_loadl_epi64((__m128i *) (in_far + i)); - __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i)); - __m128i farw = _mm_unpacklo_epi8(farb, zero); - __m128i nearw = _mm_unpacklo_epi8(nearb, zero); - __m128i diff = _mm_sub_epi16(farw, nearw); - __m128i nears = _mm_slli_epi16(nearw, 2); - __m128i curr = _mm_add_epi16(nears, diff); // current row - - // horizontal filter works the same based on shifted vers of current - // row. "prev" is current row shifted right by 1 pixel; we need to - // insert the previous pixel value (from t1). - // "next" is current row shifted left by 1 pixel, with first pixel - // of next block of 8 pixels added in. - __m128i prv0 = _mm_slli_si128(curr, 2); - __m128i nxt0 = _mm_srli_si128(curr, 2); - __m128i prev = _mm_insert_epi16(prv0, t1, 0); - __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7); - - // horizontal filter, polyphase implementation since it's convenient: - // even pixels = 3*cur + prev = cur*4 + (prev - cur) - // odd pixels = 3*cur + next = cur*4 + (next - cur) - // note the shared term. - __m128i bias = _mm_set1_epi16(8); - __m128i curs = _mm_slli_epi16(curr, 2); - __m128i prvd = _mm_sub_epi16(prev, curr); - __m128i nxtd = _mm_sub_epi16(next, curr); - __m128i curb = _mm_add_epi16(curs, bias); - __m128i even = _mm_add_epi16(prvd, curb); - __m128i odd = _mm_add_epi16(nxtd, curb); - - // interleave even and odd pixels, then undo scaling. - __m128i int0 = _mm_unpacklo_epi16(even, odd); - __m128i int1 = _mm_unpackhi_epi16(even, odd); - __m128i de0 = _mm_srli_epi16(int0, 4); - __m128i de1 = _mm_srli_epi16(int1, 4); - - // pack and write output - __m128i outv = _mm_packus_epi16(de0, de1); - _mm_storeu_si128((__m128i *) (out + i*2), outv); + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + __m128i zero = _mm_setzero_si128(); + __m128i farb = _mm_loadl_epi64((__m128i*) (in_far + i)); + __m128i nearb = _mm_loadl_epi64((__m128i*) (in_near + i)); + __m128i farw = _mm_unpacklo_epi8(farb, zero); + __m128i nearw = _mm_unpacklo_epi8(nearb, zero); + __m128i diff = _mm_sub_epi16(farw, nearw); + __m128i nears = _mm_slli_epi16(nearw, 2); + __m128i curr = _mm_add_epi16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + __m128i prv0 = _mm_slli_si128(curr, 2); + __m128i nxt0 = _mm_srli_si128(curr, 2); + __m128i prev = _mm_insert_epi16(prv0, t1, 0); + __m128i next = _mm_insert_epi16(nxt0, 3 * in_near[i + 8] + in_far[i + 8], 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + __m128i bias = _mm_set1_epi16(8); + __m128i curs = _mm_slli_epi16(curr, 2); + __m128i prvd = _mm_sub_epi16(prev, curr); + __m128i nxtd = _mm_sub_epi16(next, curr); + __m128i curb = _mm_add_epi16(curs, bias); + __m128i even = _mm_add_epi16(prvd, curb); + __m128i odd = _mm_add_epi16(nxtd, curb); + + // interleave even and odd pixels, then undo scaling. + __m128i int0 = _mm_unpacklo_epi16(even, odd); + __m128i int1 = _mm_unpackhi_epi16(even, odd); + __m128i de0 = _mm_srli_epi16(int0, 4); + __m128i de1 = _mm_srli_epi16(int1, 4); + + // pack and write output + __m128i outv = _mm_packus_epi16(de0, de1); + _mm_storeu_si128((__m128i*) (out + i * 2), outv); #elif defined(STBI_NEON) - // load and perform the vertical filtering pass - // this uses 3*x + y = 4*x + (y - x) - uint8x8_t farb = vld1_u8(in_far + i); - uint8x8_t nearb = vld1_u8(in_near + i); - int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); - int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); - int16x8_t curr = vaddq_s16(nears, diff); // current row - - // horizontal filter works the same based on shifted vers of current - // row. "prev" is current row shifted right by 1 pixel; we need to - // insert the previous pixel value (from t1). - // "next" is current row shifted left by 1 pixel, with first pixel - // of next block of 8 pixels added in. - int16x8_t prv0 = vextq_s16(curr, curr, 7); - int16x8_t nxt0 = vextq_s16(curr, curr, 1); - int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); - int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7); - - // horizontal filter, polyphase implementation since it's convenient: - // even pixels = 3*cur + prev = cur*4 + (prev - cur) - // odd pixels = 3*cur + next = cur*4 + (next - cur) - // note the shared term. - int16x8_t curs = vshlq_n_s16(curr, 2); - int16x8_t prvd = vsubq_s16(prev, curr); - int16x8_t nxtd = vsubq_s16(next, curr); - int16x8_t even = vaddq_s16(curs, prvd); - int16x8_t odd = vaddq_s16(curs, nxtd); - - // undo scaling and round, then store with even/odd phases interleaved - uint8x8x2_t o; - o.val[0] = vqrshrun_n_s16(even, 4); - o.val[1] = vqrshrun_n_s16(odd, 4); - vst2_u8(out + i*2, o); -#endif - - // "previous" value for next iter - t1 = 3*in_near[i+7] + in_far[i+7]; - } + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + uint8x8_t farb = vld1_u8(in_far + i); + uint8x8_t nearb = vld1_u8(in_near + i); + int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); + int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); + int16x8_t curr = vaddq_s16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + int16x8_t prv0 = vextq_s16(curr, curr, 7); + int16x8_t nxt0 = vextq_s16(curr, curr, 1); + int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); + int16x8_t next = vsetq_lane_s16(3 * in_near[i + 8] + in_far[i + 8], nxt0, 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + int16x8_t curs = vshlq_n_s16(curr, 2); + int16x8_t prvd = vsubq_s16(prev, curr); + int16x8_t nxtd = vsubq_s16(next, curr); + int16x8_t even = vaddq_s16(curs, prvd); + int16x8_t odd = vaddq_s16(curs, nxtd); + + // undo scaling and round, then store with even/odd phases interleaved + uint8x8x2_t o; + o.val[0] = vqrshrun_n_s16(even, 4); + o.val[1] = vqrshrun_n_s16(odd, 4); + vst2_u8(out + i * 2, o); +#endif - t0 = t1; - t1 = 3*in_near[i] + in_far[i]; - out[i*2] = stbi__div16(3*t1 + t0 + 8); + // "previous" value for next iter + t1 = 3 * in_near[i + 7] + in_far[i + 7]; + } - for (++i; i < w; ++i) { - t0 = t1; - t1 = 3*in_near[i]+in_far[i]; - out[i*2-1] = stbi__div16(3*t0 + t1 + 8); - out[i*2 ] = stbi__div16(3*t1 + t0 + 8); - } - out[w*2-1] = stbi__div4(t1+2); + t0 = t1; + t1 = 3 * in_near[i] + in_far[i]; + out[i * 2] = stbi__div16(3 * t1 + t0 + 8); - STBI_NOTUSED(hs); + for (++i; i < w; ++i) { + t0 = t1; + t1 = 3 * in_near[i] + in_far[i]; + out[i * 2 - 1] = stbi__div16(3 * t0 + t1 + 8); + out[i * 2] = stbi__div16(3 * t1 + t0 + 8); + } + out[w * 2 - 1] = stbi__div4(t1 + 2); - return out; + STBI_NOTUSED(hs); + + return out; } #endif -static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +static stbi_uc* stbi__resample_row_generic(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) { - // resample with nearest-neighbor - int i,j; - STBI_NOTUSED(in_far); - for (i=0; i < w; ++i) - for (j=0; j < hs; ++j) - out[i*hs+j] = in_near[i]; - return out; + // resample with nearest-neighbor + int i, j; + STBI_NOTUSED(in_far); + for (i = 0; i < w; ++i) + for (j = 0; j < hs; ++j) + out[i * hs + j] = in_near[i]; + return out; } // this is a reduced-precision calculation of YCbCr-to-RGB introduced // to make sure the code produces the same results in both SIMD and scalar #define stbi__float2fixed(x) (((int) ((x) * 4096.0f + 0.5f)) << 8) -static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step) -{ - int i; - for (i=0; i < count; ++i) { - int y_fixed = (y[i] << 20) + (1<<19); // rounding - int r,g,b; - int cr = pcr[i] - 128; - int cb = pcb[i] - 128; - r = y_fixed + cr* stbi__float2fixed(1.40200f); - g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); - b = y_fixed + cb* stbi__float2fixed(1.77200f); - r >>= 20; - g >>= 20; - b >>= 20; - if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } - if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } - if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } - out[0] = (stbi_uc)r; - out[1] = (stbi_uc)g; - out[2] = (stbi_uc)b; - out[3] = 255; - out += step; - } +static void stbi__YCbCr_to_RGB_row(stbi_uc* out, const stbi_uc* y, const stbi_uc* pcb, const stbi_uc* pcr, int count, int step) +{ + int i; + for (i = 0; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1 << 19); // rounding + int r, g, b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr * stbi__float2fixed(1.40200f); + g = y_fixed + (cr * -stbi__float2fixed(0.71414f)) + ((cb * -stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb * stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned)r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned)g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned)b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } } #if defined(STBI_SSE2) || defined(STBI_NEON) -static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step) +static void stbi__YCbCr_to_RGB_simd(stbi_uc* out, stbi_uc const* y, stbi_uc const* pcb, stbi_uc const* pcr, int count, int step) { - int i = 0; + int i = 0; #ifdef STBI_SSE2 - // step == 3 is pretty ugly on the final interleave, and i'm not convinced - // it's useful in practice (you wouldn't use it for textures, for example). - // so just accelerate step == 4 case. - if (step == 4) { - // this is a fairly straightforward implementation and not super-optimized. - __m128i signflip = _mm_set1_epi8(-0x80); - __m128i cr_const0 = _mm_set1_epi16( (short) ( 1.40200f*4096.0f+0.5f)); - __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f)); - __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f)); - __m128i cb_const1 = _mm_set1_epi16( (short) ( 1.77200f*4096.0f+0.5f)); - __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128); - __m128i xw = _mm_set1_epi16(255); // alpha channel - - for (; i+7 < count; i += 8) { - // load - __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i)); - __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i)); - __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i)); - __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 - __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 - - // unpack to short (and left-shift cr, cb by 8) - __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); - __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); - __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); - - // color transform - __m128i yws = _mm_srli_epi16(yw, 4); - __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); - __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); - __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); - __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); - __m128i rws = _mm_add_epi16(cr0, yws); - __m128i gwt = _mm_add_epi16(cb0, yws); - __m128i bws = _mm_add_epi16(yws, cb1); - __m128i gws = _mm_add_epi16(gwt, cr1); - - // descale - __m128i rw = _mm_srai_epi16(rws, 4); - __m128i bw = _mm_srai_epi16(bws, 4); - __m128i gw = _mm_srai_epi16(gws, 4); - - // back to byte, set up for transpose - __m128i brb = _mm_packus_epi16(rw, bw); - __m128i gxb = _mm_packus_epi16(gw, xw); - - // transpose to interleave channels - __m128i t0 = _mm_unpacklo_epi8(brb, gxb); - __m128i t1 = _mm_unpackhi_epi8(brb, gxb); - __m128i o0 = _mm_unpacklo_epi16(t0, t1); - __m128i o1 = _mm_unpackhi_epi16(t0, t1); - - // store - _mm_storeu_si128((__m128i *) (out + 0), o0); - _mm_storeu_si128((__m128i *) (out + 16), o1); - out += 32; - } - } + // step == 3 is pretty ugly on the final interleave, and i'm not convinced + // it's useful in practice (you wouldn't use it for textures, for example). + // so just accelerate step == 4 case. + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + __m128i signflip = _mm_set1_epi8(-0x80); + __m128i cr_const0 = _mm_set1_epi16((short)(1.40200f * 4096.0f + 0.5f)); + __m128i cr_const1 = _mm_set1_epi16(-(short)(0.71414f * 4096.0f + 0.5f)); + __m128i cb_const0 = _mm_set1_epi16(-(short)(0.34414f * 4096.0f + 0.5f)); + __m128i cb_const1 = _mm_set1_epi16((short)(1.77200f * 4096.0f + 0.5f)); + __m128i y_bias = _mm_set1_epi8((char)(unsigned char)128); + __m128i xw = _mm_set1_epi16(255); // alpha channel + + for (; i + 7 < count; i += 8) { + // load + __m128i y_bytes = _mm_loadl_epi64((__m128i*) (y + i)); + __m128i cr_bytes = _mm_loadl_epi64((__m128i*) (pcr + i)); + __m128i cb_bytes = _mm_loadl_epi64((__m128i*) (pcb + i)); + __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 + __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 + + // unpack to short (and left-shift cr, cb by 8) + __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); + __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); + __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); + + // color transform + __m128i yws = _mm_srli_epi16(yw, 4); + __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); + __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); + __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); + __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); + __m128i rws = _mm_add_epi16(cr0, yws); + __m128i gwt = _mm_add_epi16(cb0, yws); + __m128i bws = _mm_add_epi16(yws, cb1); + __m128i gws = _mm_add_epi16(gwt, cr1); + + // descale + __m128i rw = _mm_srai_epi16(rws, 4); + __m128i bw = _mm_srai_epi16(bws, 4); + __m128i gw = _mm_srai_epi16(gws, 4); + + // back to byte, set up for transpose + __m128i brb = _mm_packus_epi16(rw, bw); + __m128i gxb = _mm_packus_epi16(gw, xw); + + // transpose to interleave channels + __m128i t0 = _mm_unpacklo_epi8(brb, gxb); + __m128i t1 = _mm_unpackhi_epi8(brb, gxb); + __m128i o0 = _mm_unpacklo_epi16(t0, t1); + __m128i o1 = _mm_unpackhi_epi16(t0, t1); + + // store + _mm_storeu_si128((__m128i*) (out + 0), o0); + _mm_storeu_si128((__m128i*) (out + 16), o1); + out += 32; + } + } #endif #ifdef STBI_NEON - // in this version, step=3 support would be easy to add. but is there demand? - if (step == 4) { - // this is a fairly straightforward implementation and not super-optimized. - uint8x8_t signflip = vdup_n_u8(0x80); - int16x8_t cr_const0 = vdupq_n_s16( (short) ( 1.40200f*4096.0f+0.5f)); - int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f)); - int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f)); - int16x8_t cb_const1 = vdupq_n_s16( (short) ( 1.77200f*4096.0f+0.5f)); - - for (; i+7 < count; i += 8) { - // load - uint8x8_t y_bytes = vld1_u8(y + i); - uint8x8_t cr_bytes = vld1_u8(pcr + i); - uint8x8_t cb_bytes = vld1_u8(pcb + i); - int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); - int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); - - // expand to s16 - int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); - int16x8_t crw = vshll_n_s8(cr_biased, 7); - int16x8_t cbw = vshll_n_s8(cb_biased, 7); - - // color transform - int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); - int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); - int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); - int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); - int16x8_t rws = vaddq_s16(yws, cr0); - int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); - int16x8_t bws = vaddq_s16(yws, cb1); - - // undo scaling, round, convert to byte - uint8x8x4_t o; - o.val[0] = vqrshrun_n_s16(rws, 4); - o.val[1] = vqrshrun_n_s16(gws, 4); - o.val[2] = vqrshrun_n_s16(bws, 4); - o.val[3] = vdup_n_u8(255); - - // store, interleaving r/g/b/a - vst4_u8(out, o); - out += 8*4; - } - } + // in this version, step=3 support would be easy to add. but is there demand? + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + uint8x8_t signflip = vdup_n_u8(0x80); + int16x8_t cr_const0 = vdupq_n_s16((short)(1.40200f * 4096.0f + 0.5f)); + int16x8_t cr_const1 = vdupq_n_s16(-(short)(0.71414f * 4096.0f + 0.5f)); + int16x8_t cb_const0 = vdupq_n_s16(-(short)(0.34414f * 4096.0f + 0.5f)); + int16x8_t cb_const1 = vdupq_n_s16((short)(1.77200f * 4096.0f + 0.5f)); + + for (; i + 7 < count; i += 8) { + // load + uint8x8_t y_bytes = vld1_u8(y + i); + uint8x8_t cr_bytes = vld1_u8(pcr + i); + uint8x8_t cb_bytes = vld1_u8(pcb + i); + int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); + int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); + + // expand to s16 + int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); + int16x8_t crw = vshll_n_s8(cr_biased, 7); + int16x8_t cbw = vshll_n_s8(cb_biased, 7); + + // color transform + int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); + int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); + int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); + int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); + int16x8_t rws = vaddq_s16(yws, cr0); + int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); + int16x8_t bws = vaddq_s16(yws, cb1); + + // undo scaling, round, convert to byte + uint8x8x4_t o; + o.val[0] = vqrshrun_n_s16(rws, 4); + o.val[1] = vqrshrun_n_s16(gws, 4); + o.val[2] = vqrshrun_n_s16(bws, 4); + o.val[3] = vdup_n_u8(255); + + // store, interleaving r/g/b/a + vst4_u8(out, o); + out += 8 * 4; + } + } #endif - for (; i < count; ++i) { - int y_fixed = (y[i] << 20) + (1<<19); // rounding - int r,g,b; - int cr = pcr[i] - 128; - int cb = pcb[i] - 128; - r = y_fixed + cr* stbi__float2fixed(1.40200f); - g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); - b = y_fixed + cb* stbi__float2fixed(1.77200f); - r >>= 20; - g >>= 20; - b >>= 20; - if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } - if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } - if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } - out[0] = (stbi_uc)r; - out[1] = (stbi_uc)g; - out[2] = (stbi_uc)b; - out[3] = 255; - out += step; - } + for (; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1 << 19); // rounding + int r, g, b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr * stbi__float2fixed(1.40200f); + g = y_fixed + cr * -stbi__float2fixed(0.71414f) + ((cb * -stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb * stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned)r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned)g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned)b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } } #endif // set up the kernels -static void stbi__setup_jpeg(stbi__jpeg *j) +static void stbi__setup_jpeg(stbi__jpeg* j) { - j->idct_block_kernel = stbi__idct_block; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; + j->idct_block_kernel = stbi__idct_block; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; #ifdef STBI_SSE2 - if (stbi__sse2_available()) { - j->idct_block_kernel = stbi__idct_simd; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; - } + if (stbi__sse2_available()) { + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; + } #endif #ifdef STBI_NEON - j->idct_block_kernel = stbi__idct_simd; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; #endif } // clean up the temporary component buffers -static void stbi__cleanup_jpeg(stbi__jpeg *j) +static void stbi__cleanup_jpeg(stbi__jpeg* j) { - stbi__free_jpeg_components(j, j->s->img_n, 0); + stbi__free_jpeg_components(j, j->s->img_n, 0); } typedef struct { - resample_row_func resample; - stbi_uc *line0,*line1; - int hs,vs; // expansion factor in each axis - int w_lores; // horizontal pixels pre-expansion - int ystep; // how far through vertical expansion we are - int ypos; // which pre-expansion row we're on + resample_row_func resample; + stbi_uc* line0, * line1; + int hs, vs; // expansion factor in each axis + int w_lores; // horizontal pixels pre-expansion + int ystep; // how far through vertical expansion we are + int ypos; // which pre-expansion row we're on } stbi__resample; // fast 0..255 * 0..255 => 0..255 rounded multiplication static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y) { - unsigned int t = x*y + 128; - return (stbi_uc) ((t + (t >>8)) >> 8); + unsigned int t = x * y + 128; + return (stbi_uc)((t + (t >> 8)) >> 8); } -static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp) +static stbi_uc* load_jpeg_image(stbi__jpeg* z, int* out_x, int* out_y, int* comp, int req_comp) { - int n, decode_n, is_rgb; - z->s->img_n = 0; // make stbi__cleanup_jpeg safe + int n, decode_n, is_rgb; + z->s->img_n = 0; // make stbi__cleanup_jpeg safe - // validate req_comp - if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + // validate req_comp + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); - // load a jpeg image from whichever source, but leave in YCbCr format - if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } + // load a jpeg image from whichever source, but leave in YCbCr format + if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } - // determine actual number of components to generate - n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; + // determine actual number of components to generate + n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; - is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); + is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); - if (z->s->img_n == 3 && n < 3 && !is_rgb) - decode_n = 1; - else - decode_n = z->s->img_n; + if (z->s->img_n == 3 && n < 3 && !is_rgb) + decode_n = 1; + else + decode_n = z->s->img_n; - // nothing to do if no components requested; check this now to avoid - // accessing uninitialized coutput[0] later - if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } - // resample and color-convert - { - int k; - unsigned int i,j; - stbi_uc *output; - stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL }; + // resample and color-convert + { + int k; + unsigned int i, j; + stbi_uc* output; + stbi_uc* coutput[4] = { NULL, NULL, NULL, NULL }; - stbi__resample res_comp[4]; + stbi__resample res_comp[4]; - for (k=0; k < decode_n; ++k) { - stbi__resample *r = &res_comp[k]; + for (k = 0; k < decode_n; ++k) { + stbi__resample* r = &res_comp[k]; - // allocate line buffer big enough for upsampling off the edges - // with upsample factor of 4 - z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3); - if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + // allocate line buffer big enough for upsampling off the edges + // with upsample factor of 4 + z->img_comp[k].linebuf = (stbi_uc*)stbi__malloc(z->s->img_x + 3); + if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } - r->hs = z->img_h_max / z->img_comp[k].h; - r->vs = z->img_v_max / z->img_comp[k].v; - r->ystep = r->vs >> 1; - r->w_lores = (z->s->img_x + r->hs-1) / r->hs; - r->ypos = 0; - r->line0 = r->line1 = z->img_comp[k].data; + r->hs = z->img_h_max / z->img_comp[k].h; + r->vs = z->img_v_max / z->img_comp[k].v; + r->ystep = r->vs >> 1; + r->w_lores = (z->s->img_x + r->hs - 1) / r->hs; + r->ypos = 0; + r->line0 = r->line1 = z->img_comp[k].data; - if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; - else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; - else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; - else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; - else r->resample = stbi__resample_row_generic; - } + if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; + else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; + else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; + else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; + else r->resample = stbi__resample_row_generic; + } - // can't error after this so, this is safe - output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); - if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } - - // now go ahead and resample - for (j=0; j < z->s->img_y; ++j) { - stbi_uc *out = output + n * z->s->img_x * j; - for (k=0; k < decode_n; ++k) { - stbi__resample *r = &res_comp[k]; - int y_bot = r->ystep >= (r->vs >> 1); - coutput[k] = r->resample(z->img_comp[k].linebuf, - y_bot ? r->line1 : r->line0, - y_bot ? r->line0 : r->line1, - r->w_lores, r->hs); - if (++r->ystep >= r->vs) { - r->ystep = 0; - r->line0 = r->line1; - if (++r->ypos < z->img_comp[k].y) - r->line1 += z->img_comp[k].w2; + // can't error after this so, this is safe + output = (stbi_uc*)stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); + if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + // now go ahead and resample + for (j = 0; j < z->s->img_y; ++j) { + stbi_uc* out = output + n * z->s->img_x * j; + for (k = 0; k < decode_n; ++k) { + stbi__resample* r = &res_comp[k]; + int y_bot = r->ystep >= (r->vs >> 1); + coutput[k] = r->resample(z->img_comp[k].linebuf, + y_bot ? r->line1 : r->line0, + y_bot ? r->line0 : r->line1, + r->w_lores, r->hs); + if (++r->ystep >= r->vs) { + r->ystep = 0; + r->line0 = r->line1; + if (++r->ypos < z->img_comp[k].y) + r->line1 += z->img_comp[k].w2; + } } - } - if (n >= 3) { - stbi_uc *y = coutput[0]; - if (z->s->img_n == 3) { - if (is_rgb) { - for (i=0; i < z->s->img_x; ++i) { - out[0] = y[i]; - out[1] = coutput[1][i]; - out[2] = coutput[2][i]; - out[3] = 255; - out += n; - } - } else { - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - } - } else if (z->s->img_n == 4) { - if (z->app14_color_transform == 0) { // CMYK - for (i=0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - out[0] = stbi__blinn_8x8(coutput[0][i], m); - out[1] = stbi__blinn_8x8(coutput[1][i], m); - out[2] = stbi__blinn_8x8(coutput[2][i], m); - out[3] = 255; - out += n; - } - } else if (z->app14_color_transform == 2) { // YCCK - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - for (i=0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - out[0] = stbi__blinn_8x8(255 - out[0], m); - out[1] = stbi__blinn_8x8(255 - out[1], m); - out[2] = stbi__blinn_8x8(255 - out[2], m); - out += n; - } - } else { // YCbCr + alpha? Ignore the fourth channel for now - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - } - } else - for (i=0; i < z->s->img_x; ++i) { - out[0] = out[1] = out[2] = y[i]; - out[3] = 255; // not used if n==3 - out += n; - } - } else { - if (is_rgb) { - if (n == 1) - for (i=0; i < z->s->img_x; ++i) - *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); - else { - for (i=0; i < z->s->img_x; ++i, out += 2) { - out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); - out[1] = 255; - } - } - } else if (z->s->img_n == 4 && z->app14_color_transform == 0) { - for (i=0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); - stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); - stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); - out[0] = stbi__compute_y(r, g, b); - out[1] = 255; - out += n; - } - } else if (z->s->img_n == 4 && z->app14_color_transform == 2) { - for (i=0; i < z->s->img_x; ++i) { - out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); - out[1] = 255; - out += n; - } - } else { - stbi_uc *y = coutput[0]; - if (n == 1) - for (i=0; i < z->s->img_x; ++i) out[i] = y[i]; - else - for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } + if (n >= 3) { + stbi_uc* y = coutput[0]; + if (z->s->img_n == 3) { + if (is_rgb) { + for (i = 0; i < z->s->img_x; ++i) { + out[0] = y[i]; + out[1] = coutput[1][i]; + out[2] = coutput[2][i]; + out[3] = 255; + out += n; + } + } + else { + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } + else if (z->s->img_n == 4) { + if (z->app14_color_transform == 0) { // CMYK + for (i = 0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(coutput[0][i], m); + out[1] = stbi__blinn_8x8(coutput[1][i], m); + out[2] = stbi__blinn_8x8(coutput[2][i], m); + out[3] = 255; + out += n; + } + } + else if (z->app14_color_transform == 2) { // YCCK + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + for (i = 0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(255 - out[0], m); + out[1] = stbi__blinn_8x8(255 - out[1], m); + out[2] = stbi__blinn_8x8(255 - out[2], m); + out += n; + } + } + else { // YCbCr + alpha? Ignore the fourth channel for now + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } + else + for (i = 0; i < z->s->img_x; ++i) { + out[0] = out[1] = out[2] = y[i]; + out[3] = 255; // not used if n==3 + out += n; + } } - } - } - stbi__cleanup_jpeg(z); - *out_x = z->s->img_x; - *out_y = z->s->img_y; - if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output - return output; - } + else { + if (is_rgb) { + if (n == 1) + for (i = 0; i < z->s->img_x; ++i) + *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + else { + for (i = 0; i < z->s->img_x; ++i, out += 2) { + out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + out[1] = 255; + } + } + } + else if (z->s->img_n == 4 && z->app14_color_transform == 0) { + for (i = 0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); + stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); + stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); + out[0] = stbi__compute_y(r, g, b); + out[1] = 255; + out += n; + } + } + else if (z->s->img_n == 4 && z->app14_color_transform == 2) { + for (i = 0; i < z->s->img_x; ++i) { + out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); + out[1] = 255; + out += n; + } + } + else { + stbi_uc* y = coutput[0]; + if (n == 1) + for (i = 0; i < z->s->img_x; ++i) out[i] = y[i]; + else + for (i = 0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } + } + } + } + stbi__cleanup_jpeg(z); + *out_x = z->s->img_x; + *out_y = z->s->img_y; + if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output + return output; + } } -static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +static void* stbi__jpeg_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) { - unsigned char* result; - stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg)); - if (!j) return stbi__errpuc("outofmem", "Out of memory"); - STBI_NOTUSED(ri); - j->s = s; - stbi__setup_jpeg(j); - result = load_jpeg_image(j, x,y,comp,req_comp); - STBI_FREE(j); - return result; + unsigned char* result; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + STBI_NOTUSED(ri); + j->s = s; + stbi__setup_jpeg(j); + result = load_jpeg_image(j, x, y, comp, req_comp); + STBI_FREE(j); + return result; } -static int stbi__jpeg_test(stbi__context *s) +static int stbi__jpeg_test(stbi__context* s) { - int r; - stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); - if (!j) return stbi__err("outofmem", "Out of memory"); - j->s = s; - stbi__setup_jpeg(j); - r = stbi__decode_jpeg_header(j, STBI__SCAN_type); - stbi__rewind(s); - STBI_FREE(j); - return r; + int r; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + j->s = s; + stbi__setup_jpeg(j); + r = stbi__decode_jpeg_header(j, STBI__SCAN_type); + stbi__rewind(s); + STBI_FREE(j); + return r; } -static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp) +static int stbi__jpeg_info_raw(stbi__jpeg* j, int* x, int* y, int* comp) { - if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { - stbi__rewind( j->s ); - return 0; - } - if (x) *x = j->s->img_x; - if (y) *y = j->s->img_y; - if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; - return 1; + if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { + stbi__rewind(j->s); + return 0; + } + if (x) *x = j->s->img_x; + if (y) *y = j->s->img_y; + if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; + return 1; } -static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__jpeg_info(stbi__context* s, int* x, int* y, int* comp) { - int result; - stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); - if (!j) return stbi__err("outofmem", "Out of memory"); - j->s = s; - result = stbi__jpeg_info_raw(j, x, y, comp); - STBI_FREE(j); - return result; + int result; + stbi__jpeg* j = (stbi__jpeg*)(stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + j->s = s; + result = stbi__jpeg_info_raw(j, x, y, comp); + STBI_FREE(j); + return result; } #endif @@ -4039,76 +4070,76 @@ static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) // (jpegs packs from left, zlib from right, so can't share code) typedef struct { - stbi__uint16 fast[1 << STBI__ZFAST_BITS]; - stbi__uint16 firstcode[16]; - int maxcode[17]; - stbi__uint16 firstsymbol[16]; - stbi_uc size[STBI__ZNSYMS]; - stbi__uint16 value[STBI__ZNSYMS]; + stbi__uint16 fast[1 << STBI__ZFAST_BITS]; + stbi__uint16 firstcode[16]; + int maxcode[17]; + stbi__uint16 firstsymbol[16]; + stbi_uc size[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; } stbi__zhuffman; stbi_inline static int stbi__bitreverse16(int n) { - n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); - n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); - n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); - n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); - return n; + n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); + n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); + n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); + n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); + return n; } stbi_inline static int stbi__bit_reverse(int v, int bits) { - STBI_ASSERT(bits <= 16); - // to bit reverse n bits, reverse 16 and shift - // e.g. 11 bits, bit reverse and shift away 5 - return stbi__bitreverse16(v) >> (16-bits); -} - -static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num) -{ - int i,k=0; - int code, next_code[16], sizes[17]; - - // DEFLATE spec for generating codes - memset(sizes, 0, sizeof(sizes)); - memset(z->fast, 0, sizeof(z->fast)); - for (i=0; i < num; ++i) - ++sizes[sizelist[i]]; - sizes[0] = 0; - for (i=1; i < 16; ++i) - if (sizes[i] > (1 << i)) - return stbi__err("bad sizes", "Corrupt PNG"); - code = 0; - for (i=1; i < 16; ++i) { - next_code[i] = code; - z->firstcode[i] = (stbi__uint16) code; - z->firstsymbol[i] = (stbi__uint16) k; - code = (code + sizes[i]); - if (sizes[i]) - if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG"); - z->maxcode[i] = code << (16-i); // preshift for inner loop - code <<= 1; - k += sizes[i]; - } - z->maxcode[16] = 0x10000; // sentinel - for (i=0; i < num; ++i) { - int s = sizelist[i]; - if (s) { - int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; - stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i); - z->size [c] = (stbi_uc ) s; - z->value[c] = (stbi__uint16) i; - if (s <= STBI__ZFAST_BITS) { - int j = stbi__bit_reverse(next_code[s],s); - while (j < (1 << STBI__ZFAST_BITS)) { - z->fast[j] = fastv; - j += (1 << s); + STBI_ASSERT(bits <= 16); + // to bit reverse n bits, reverse 16 and shift + // e.g. 11 bits, bit reverse and shift away 5 + return stbi__bitreverse16(v) >> (16 - bits); +} + +static int stbi__zbuild_huffman(stbi__zhuffman* z, const stbi_uc* sizelist, int num) +{ + int i, k = 0; + int code, next_code[16], sizes[17]; + + // DEFLATE spec for generating codes + memset(sizes, 0, sizeof(sizes)); + memset(z->fast, 0, sizeof(z->fast)); + for (i = 0; i < num; ++i) + ++sizes[sizelist[i]]; + sizes[0] = 0; + for (i = 1; i < 16; ++i) + if (sizes[i] > (1 << i)) + return stbi__err("bad sizes", "Corrupt PNG"); + code = 0; + for (i = 1; i < 16; ++i) { + next_code[i] = code; + z->firstcode[i] = (stbi__uint16)code; + z->firstsymbol[i] = (stbi__uint16)k; + code = (code + sizes[i]); + if (sizes[i]) + if (code - 1 >= (1 << i)) return stbi__err("bad codelengths", "Corrupt PNG"); + z->maxcode[i] = code << (16 - i); // preshift for inner loop + code <<= 1; + k += sizes[i]; + } + z->maxcode[16] = 0x10000; // sentinel + for (i = 0; i < num; ++i) { + int s = sizelist[i]; + if (s) { + int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; + stbi__uint16 fastv = (stbi__uint16)((s << 9) | i); + z->size[c] = (stbi_uc)s; + z->value[c] = (stbi__uint16)i; + if (s <= STBI__ZFAST_BITS) { + int j = stbi__bit_reverse(next_code[s], s); + while (j < (1 << STBI__ZFAST_BITS)) { + z->fast[j] = fastv; + j += (1 << s); + } } - } - ++next_code[s]; - } - } - return 1; + ++next_code[s]; + } + } + return 1; } // zlib-from-memory implementation for PNG reading @@ -4119,108 +4150,108 @@ static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int typedef struct { - stbi_uc *zbuffer, *zbuffer_end; - int num_bits; - stbi__uint32 code_buffer; + stbi_uc* zbuffer, * zbuffer_end; + int num_bits; + stbi__uint32 code_buffer; - char *zout; - char *zout_start; - char *zout_end; - int z_expandable; + char* zout; + char* zout_start; + char* zout_end; + int z_expandable; - stbi__zhuffman z_length, z_distance; + stbi__zhuffman z_length, z_distance; } stbi__zbuf; -stbi_inline static int stbi__zeof(stbi__zbuf *z) +stbi_inline static int stbi__zeof(stbi__zbuf* z) { - return (z->zbuffer >= z->zbuffer_end); + return (z->zbuffer >= z->zbuffer_end); } -stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf* z) { - return stbi__zeof(z) ? 0 : *z->zbuffer++; + return stbi__zeof(z) ? 0 : *z->zbuffer++; } -static void stbi__fill_bits(stbi__zbuf *z) +static void stbi__fill_bits(stbi__zbuf* z) { - do { - if (z->code_buffer >= (1U << z->num_bits)) { - z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ - return; - } - z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits; - z->num_bits += 8; - } while (z->num_bits <= 24); -} - -stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n) -{ - unsigned int k; - if (z->num_bits < n) stbi__fill_bits(z); - k = z->code_buffer & ((1 << n) - 1); - z->code_buffer >>= n; - z->num_bits -= n; - return k; -} - -static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) -{ - int b,s,k; - // not resolved by fast table, so compute it the slow way - // use jpeg approach, which requires MSbits at top - k = stbi__bit_reverse(a->code_buffer, 16); - for (s=STBI__ZFAST_BITS+1; ; ++s) - if (k < z->maxcode[s]) - break; - if (s >= 16) return -1; // invalid code! - // code size is s, so: - b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; - if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! - if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. - a->code_buffer >>= s; - a->num_bits -= s; - return z->value[b]; -} - -stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z) -{ - int b,s; - if (a->num_bits < 16) { - if (stbi__zeof(a)) { - return -1; /* report error for unexpected end of data. */ - } - stbi__fill_bits(a); - } - b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; - if (b) { - s = b >> 9; - a->code_buffer >>= s; - a->num_bits -= s; - return b & 511; - } - return stbi__zhuffman_decode_slowpath(a, z); + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + z->code_buffer |= (unsigned int)stbi__zget8(z) << z->num_bits; + z->num_bits += 8; + } while (z->num_bits <= 24); } -static int stbi__zexpand(stbi__zbuf *z, char *zout, int n) // need to make room for n bytes +stbi_inline static unsigned int stbi__zreceive(stbi__zbuf* z, int n) { - char *q; - unsigned int cur, limit, old_limit; - z->zout = zout; - if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); - cur = (unsigned int) (z->zout - z->zout_start); - limit = old_limit = (unsigned) (z->zout_end - z->zout_start); - if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); - while (cur + n > limit) { - if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); - limit *= 2; - } - q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); - STBI_NOTUSED(old_limit); - if (q == NULL) return stbi__err("outofmem", "Out of memory"); - z->zout_start = q; - z->zout = q + cur; - z->zout_end = q + limit; - return 1; + unsigned int k; + if (z->num_bits < n) stbi__fill_bits(z); + k = z->code_buffer & ((1 << n) - 1); + z->code_buffer >>= n; + z->num_bits -= n; + return k; +} + +static int stbi__zhuffman_decode_slowpath(stbi__zbuf* a, stbi__zhuffman* z) +{ + int b, s, k; + // not resolved by fast table, so compute it the slow way + // use jpeg approach, which requires MSbits at top + k = stbi__bit_reverse(a->code_buffer, 16); + for (s = STBI__ZFAST_BITS + 1; ; ++s) + if (k < z->maxcode[s]) + break; + if (s >= 16) return -1; // invalid code! + // code size is s, so: + b = (k >> (16 - s)) - z->firstcode[s] + z->firstsymbol[s]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + a->code_buffer >>= s; + a->num_bits -= s; + return z->value[b]; +} + +stbi_inline static int stbi__zhuffman_decode(stbi__zbuf* a, stbi__zhuffman* z) +{ + int b, s; + if (a->num_bits < 16) { + if (stbi__zeof(a)) { + return -1; /* report error for unexpected end of data. */ + } + stbi__fill_bits(a); + } + b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; + if (b) { + s = b >> 9; + a->code_buffer >>= s; + a->num_bits -= s; + return b & 511; + } + return stbi__zhuffman_decode_slowpath(a, z); +} + +static int stbi__zexpand(stbi__zbuf* z, char* zout, int n) // need to make room for n bytes +{ + char* q; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit", "Corrupt PNG"); + cur = (unsigned int)(z->zout - z->zout_start); + limit = old_limit = (unsigned)(z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned)n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if (limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + limit *= 2; + } + q = (char*)STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); + STBI_NOTUSED(old_limit); + if (q == NULL) return stbi__err("outofmem", "Out of memory"); + z->zout_start = q; + z->zout = q + cur; + z->zout_end = q + limit; + return 1; } static const int stbi__zlength_base[31] = { @@ -4228,148 +4259,153 @@ static const int stbi__zlength_base[31] = { 15,17,19,23,27,31,35,43,51,59, 67,83,99,115,131,163,195,227,258,0,0 }; -static const int stbi__zlength_extra[31]= +static const int stbi__zlength_extra[31] = { 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, -257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0}; +257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0 }; static const int stbi__zdist_extra[32] = -{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13}; - -static int stbi__parse_huffman_block(stbi__zbuf *a) -{ - char *zout = a->zout; - for(;;) { - int z = stbi__zhuffman_decode(a, &a->z_length); - if (z < 256) { - if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes - if (zout >= a->zout_end) { - if (!stbi__zexpand(a, zout, 1)) return 0; - zout = a->zout; - } - *zout++ = (char) z; - } else { - stbi_uc *p; - int len,dist; - if (z == 256) { - a->zout = zout; - return 1; - } - z -= 257; - len = stbi__zlength_base[z]; - if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); - z = stbi__zhuffman_decode(a, &a->z_distance); - if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); - dist = stbi__zdist_base[z]; - if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); - if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG"); - if (zout + len > a->zout_end) { - if (!stbi__zexpand(a, zout, len)) return 0; - zout = a->zout; - } - p = (stbi_uc *) (zout - dist); - if (dist == 1) { // run of one byte; common in images. - stbi_uc v = *p; - if (len) { do *zout++ = v; while (--len); } - } else { - if (len) { do *zout++ = *p++; while (--len); } - } - } - } +{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13 }; + +static int stbi__parse_huffman_block(stbi__zbuf* a) +{ + char* zout = a->zout; + for (;;) { + int z = stbi__zhuffman_decode(a, &a->z_length); + if (z < 256) { + if (z < 0) return stbi__err("bad huffman code", "Corrupt PNG"); // error in huffman codes + if (zout >= a->zout_end) { + if (!stbi__zexpand(a, zout, 1)) return 0; + zout = a->zout; + } + *zout++ = (char)z; + } + else { + stbi_uc* p; + int len, dist; + if (z == 256) { + a->zout = zout; + return 1; + } + z -= 257; + len = stbi__zlength_base[z]; + if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); + z = stbi__zhuffman_decode(a, &a->z_distance); + if (z < 0) return stbi__err("bad huffman code", "Corrupt PNG"); + dist = stbi__zdist_base[z]; + if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); + if (zout - a->zout_start < dist) return stbi__err("bad dist", "Corrupt PNG"); + if (zout + len > a->zout_end) { + if (!stbi__zexpand(a, zout, len)) return 0; + zout = a->zout; + } + p = (stbi_uc*)(zout - dist); + if (dist == 1) { // run of one byte; common in images. + stbi_uc v = *p; + if (len) { do *zout++ = v; while (--len); } + } + else { + if (len) { do *zout++ = *p++; while (--len); } + } + } + } } -static int stbi__compute_huffman_codes(stbi__zbuf *a) +static int stbi__compute_huffman_codes(stbi__zbuf* a) { - static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; - stbi__zhuffman z_codelength; - stbi_uc lencodes[286+32+137];//padding for maximum single op - stbi_uc codelength_sizes[19]; - int i,n; + static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; + stbi__zhuffman z_codelength; + stbi_uc lencodes[286 + 32 + 137];//padding for maximum single op + stbi_uc codelength_sizes[19]; + int i, n; - int hlit = stbi__zreceive(a,5) + 257; - int hdist = stbi__zreceive(a,5) + 1; - int hclen = stbi__zreceive(a,4) + 4; - int ntot = hlit + hdist; + int hlit = stbi__zreceive(a, 5) + 257; + int hdist = stbi__zreceive(a, 5) + 1; + int hclen = stbi__zreceive(a, 4) + 4; + int ntot = hlit + hdist; - memset(codelength_sizes, 0, sizeof(codelength_sizes)); - for (i=0; i < hclen; ++i) { - int s = stbi__zreceive(a,3); - codelength_sizes[length_dezigzag[i]] = (stbi_uc) s; - } - if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; - - n = 0; - while (n < ntot) { - int c = stbi__zhuffman_decode(a, &z_codelength); - if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); - if (c < 16) - lencodes[n++] = (stbi_uc) c; - else { - stbi_uc fill = 0; - if (c == 16) { - c = stbi__zreceive(a,2)+3; - if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); - fill = lencodes[n-1]; - } else if (c == 17) { - c = stbi__zreceive(a,3)+3; - } else if (c == 18) { - c = stbi__zreceive(a,7)+11; - } else { - return stbi__err("bad codelengths", "Corrupt PNG"); - } - if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); - memset(lencodes+n, fill, c); - n += c; - } - } - if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG"); - if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; - if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0; - return 1; -} - -static int stbi__parse_uncompressed_block(stbi__zbuf *a) -{ - stbi_uc header[4]; - int len,nlen,k; - if (a->num_bits & 7) - stbi__zreceive(a, a->num_bits & 7); // discard - // drain the bit-packed data into header - k = 0; - while (a->num_bits > 0) { - header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check - a->code_buffer >>= 8; - a->num_bits -= 8; - } - if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); - // now fill header the normal way - while (k < 4) - header[k++] = stbi__zget8(a); - len = header[1] * 256 + header[0]; - nlen = header[3] * 256 + header[2]; - if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG"); - if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG"); - if (a->zout + len > a->zout_end) - if (!stbi__zexpand(a, a->zout, len)) return 0; - memcpy(a->zout, a->zbuffer, len); - a->zbuffer += len; - a->zout += len; - return 1; -} - -static int stbi__parse_zlib_header(stbi__zbuf *a) -{ - int cmf = stbi__zget8(a); - int cm = cmf & 15; - /* int cinfo = cmf >> 4; */ - int flg = stbi__zget8(a); - if (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec - if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec - if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png - if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png - // window = 1 << (8 + cinfo)... but who cares, we fully buffer output - return 1; + memset(codelength_sizes, 0, sizeof(codelength_sizes)); + for (i = 0; i < hclen; ++i) { + int s = stbi__zreceive(a, 3); + codelength_sizes[length_dezigzag[i]] = (stbi_uc)s; + } + if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; + + n = 0; + while (n < ntot) { + int c = stbi__zhuffman_decode(a, &z_codelength); + if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); + if (c < 16) + lencodes[n++] = (stbi_uc)c; + else { + stbi_uc fill = 0; + if (c == 16) { + c = stbi__zreceive(a, 2) + 3; + if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); + fill = lencodes[n - 1]; + } + else if (c == 17) { + c = stbi__zreceive(a, 3) + 3; + } + else if (c == 18) { + c = stbi__zreceive(a, 7) + 11; + } + else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); + memset(lencodes + n, fill, c); + n += c; + } + } + if (n != ntot) return stbi__err("bad codelengths", "Corrupt PNG"); + if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, lencodes + hlit, hdist)) return 0; + return 1; +} + +static int stbi__parse_uncompressed_block(stbi__zbuf* a) +{ + stbi_uc header[4]; + int len, nlen, k; + if (a->num_bits & 7) + stbi__zreceive(a, a->num_bits & 7); // discard + // drain the bit-packed data into header + k = 0; + while (a->num_bits > 0) { + header[k++] = (stbi_uc)(a->code_buffer & 255); // suppress MSVC run-time check + a->code_buffer >>= 8; + a->num_bits -= 8; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt", "Corrupt PNG"); + // now fill header the normal way + while (k < 4) + header[k++] = stbi__zget8(a); + len = header[1] * 256 + header[0]; + nlen = header[3] * 256 + header[2]; + if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt", "Corrupt PNG"); + if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer", "Corrupt PNG"); + if (a->zout + len > a->zout_end) + if (!stbi__zexpand(a, a->zout, len)) return 0; + memcpy(a->zout, a->zbuffer, len); + a->zbuffer += len; + a->zout += len; + return 1; +} + +static int stbi__parse_zlib_header(stbi__zbuf* a) +{ + int cmf = stbi__zget8(a); + int cm = cmf & 15; + /* int cinfo = cmf >> 4; */ + int flg = stbi__zget8(a); + if (stbi__zeof(a)) return stbi__err("bad zlib header", "Corrupt PNG"); // zlib spec + if ((cmf * 256 + flg) % 31 != 0) return stbi__err("bad zlib header", "Corrupt PNG"); // zlib spec + if (flg & 32) return stbi__err("no preset dict", "Corrupt PNG"); // preset dictionary not allowed in png + if (cm != 8) return stbi__err("bad compression", "Corrupt PNG"); // DEFLATE required for png + // window = 1 << (8 + cinfo)... but who cares, we fully buffer output + return 1; } static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = @@ -4401,117 +4437,123 @@ Init algorithm: } */ -static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) -{ - int final, type; - if (parse_header) - if (!stbi__parse_zlib_header(a)) return 0; - a->num_bits = 0; - a->code_buffer = 0; - do { - final = stbi__zreceive(a,1); - type = stbi__zreceive(a,2); - if (type == 0) { - if (!stbi__parse_uncompressed_block(a)) return 0; - } else if (type == 3) { - return 0; - } else { - if (type == 1) { - // use fixed code lengths - if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; - if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; - } else { - if (!stbi__compute_huffman_codes(a)) return 0; - } - if (!stbi__parse_huffman_block(a)) return 0; - } - } while (!final); - return 1; +static int stbi__parse_zlib(stbi__zbuf* a, int parse_header) +{ + int final, type; + if (parse_header) + if (!stbi__parse_zlib_header(a)) return 0; + a->num_bits = 0; + a->code_buffer = 0; + do { + final = stbi__zreceive(a, 1); + type = stbi__zreceive(a, 2); + if (type == 0) { + if (!stbi__parse_uncompressed_block(a)) return 0; + } + else if (type == 3) { + return 0; + } + else { + if (type == 1) { + // use fixed code lengths + if (!stbi__zbuild_huffman(&a->z_length, stbi__zdefault_length, STBI__ZNSYMS)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; + } + else { + if (!stbi__compute_huffman_codes(a)) return 0; + } + if (!stbi__parse_huffman_block(a)) return 0; + } + } while (!final); + return 1; } -static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header) +static int stbi__do_zlib(stbi__zbuf* a, char* obuf, int olen, int exp, int parse_header) { - a->zout_start = obuf; - a->zout = obuf; - a->zout_end = obuf + olen; - a->z_expandable = exp; + a->zout_start = obuf; + a->zout = obuf; + a->zout_end = obuf + olen; + a->z_expandable = exp; - return stbi__parse_zlib(a, parse_header); + return stbi__parse_zlib(a, parse_header); } -STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen) +STBIDEF char* stbi_zlib_decode_malloc_guesssize(const char* buffer, int len, int initial_size, int* outlen) { - stbi__zbuf a; - char *p = (char *) stbi__malloc(initial_size); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc *) buffer; - a.zbuffer_end = (stbi_uc *) buffer + len; - if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { - if (outlen) *outlen = (int) (a.zout - a.zout_start); - return a.zout_start; - } else { - STBI_FREE(a.zout_start); - return NULL; - } + stbi__zbuf a; + char* p = (char*)stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc*)buffer; + a.zbuffer_end = (stbi_uc*)buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { + if (outlen) *outlen = (int)(a.zout - a.zout_start); + return a.zout_start; + } + else { + STBI_FREE(a.zout_start); + return NULL; + } } -STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen) +STBIDEF char* stbi_zlib_decode_malloc(char const* buffer, int len, int* outlen) { - return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); + return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); } -STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header) +STBIDEF char* stbi_zlib_decode_malloc_guesssize_headerflag(const char* buffer, int len, int initial_size, int* outlen, int parse_header) { - stbi__zbuf a; - char *p = (char *) stbi__malloc(initial_size); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc *) buffer; - a.zbuffer_end = (stbi_uc *) buffer + len; - if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { - if (outlen) *outlen = (int) (a.zout - a.zout_start); - return a.zout_start; - } else { - STBI_FREE(a.zout_start); - return NULL; - } + stbi__zbuf a; + char* p = (char*)stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc*)buffer; + a.zbuffer_end = (stbi_uc*)buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { + if (outlen) *outlen = (int)(a.zout - a.zout_start); + return a.zout_start; + } + else { + STBI_FREE(a.zout_start); + return NULL; + } } -STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen) +STBIDEF int stbi_zlib_decode_buffer(char* obuffer, int olen, char const* ibuffer, int ilen) { - stbi__zbuf a; - a.zbuffer = (stbi_uc *) ibuffer; - a.zbuffer_end = (stbi_uc *) ibuffer + ilen; - if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) - return (int) (a.zout - a.zout_start); - else - return -1; + stbi__zbuf a; + a.zbuffer = (stbi_uc*)ibuffer; + a.zbuffer_end = (stbi_uc*)ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) + return (int)(a.zout - a.zout_start); + else + return -1; } -STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen) +STBIDEF char* stbi_zlib_decode_noheader_malloc(char const* buffer, int len, int* outlen) { - stbi__zbuf a; - char *p = (char *) stbi__malloc(16384); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc *) buffer; - a.zbuffer_end = (stbi_uc *) buffer+len; - if (stbi__do_zlib(&a, p, 16384, 1, 0)) { - if (outlen) *outlen = (int) (a.zout - a.zout_start); - return a.zout_start; - } else { - STBI_FREE(a.zout_start); - return NULL; - } + stbi__zbuf a; + char* p = (char*)stbi__malloc(16384); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc*)buffer; + a.zbuffer_end = (stbi_uc*)buffer + len; + if (stbi__do_zlib(&a, p, 16384, 1, 0)) { + if (outlen) *outlen = (int)(a.zout - a.zout_start); + return a.zout_start; + } + else { + STBI_FREE(a.zout_start); + return NULL; + } } -STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen) +STBIDEF int stbi_zlib_decode_noheader_buffer(char* obuffer, int olen, const char* ibuffer, int ilen) { - stbi__zbuf a; - a.zbuffer = (stbi_uc *) ibuffer; - a.zbuffer_end = (stbi_uc *) ibuffer + ilen; - if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) - return (int) (a.zout - a.zout_start); - else - return -1; + stbi__zbuf a; + a.zbuffer = (stbi_uc*)ibuffer; + a.zbuffer_end = (stbi_uc*)ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) + return (int)(a.zout - a.zout_start); + else + return -1; } #endif @@ -4528,44 +4570,44 @@ STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char #ifndef STBI_NO_PNG typedef struct { - stbi__uint32 length; - stbi__uint32 type; + stbi__uint32 length; + stbi__uint32 type; } stbi__pngchunk; -static stbi__pngchunk stbi__get_chunk_header(stbi__context *s) +static stbi__pngchunk stbi__get_chunk_header(stbi__context* s) { - stbi__pngchunk c; - c.length = stbi__get32be(s); - c.type = stbi__get32be(s); - return c; + stbi__pngchunk c; + c.length = stbi__get32be(s); + c.type = stbi__get32be(s); + return c; } -static int stbi__check_png_header(stbi__context *s) +static int stbi__check_png_header(stbi__context* s) { - static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; - int i; - for (i=0; i < 8; ++i) - if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG"); - return 1; + static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; + int i; + for (i = 0; i < 8; ++i) + if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig", "Not a PNG"); + return 1; } typedef struct { - stbi__context *s; - stbi_uc *idata, *expanded, *out; - int depth; + stbi__context* s; + stbi_uc* idata, * expanded, * out; + int depth; } stbi__png; enum { - STBI__F_none=0, - STBI__F_sub=1, - STBI__F_up=2, - STBI__F_avg=3, - STBI__F_paeth=4, - // synthetic filters used for first scanline to avoid needing a dummy row of 0s - STBI__F_avg_first, - STBI__F_paeth_first + STBI__F_none = 0, + STBI__F_sub = 1, + STBI__F_up = 2, + STBI__F_avg = 3, + STBI__F_paeth = 4, + // synthetic filters used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first, + STBI__F_paeth_first }; static stbi_uc first_row_filter[5] = @@ -4579,360 +4621,370 @@ static stbi_uc first_row_filter[5] = static int stbi__paeth(int a, int b, int c) { - int p = a + b - c; - int pa = abs(p-a); - int pb = abs(p-b); - int pc = abs(p-c); - if (pa <= pb && pa <= pc) return a; - if (pb <= pc) return b; - return c; + int p = a + b - c; + int pa = abs(p - a); + int pb = abs(p - b); + int pc = abs(p - c); + if (pa <= pb && pa <= pc) return a; + if (pb <= pc) return b; + return c; } static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; // create the png data from post-deflated data -static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) -{ - int bytes = (depth == 16? 2 : 1); - stbi__context *s = a->s; - stbi__uint32 i,j,stride = x*out_n*bytes; - stbi__uint32 img_len, img_width_bytes; - int k; - int img_n = s->img_n; // copy it into a local for later - - int output_bytes = out_n*bytes; - int filter_bytes = img_n*bytes; - int width = x; - - STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1); - a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into - if (!a->out) return stbi__err("outofmem", "Out of memory"); - - if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); - img_width_bytes = (((img_n * x * depth) + 7) >> 3); - img_len = (img_width_bytes + 1) * y; - - // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, - // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), - // so just check for raw_len < img_len always. - if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG"); - - for (j=0; j < y; ++j) { - stbi_uc *cur = a->out + stride*j; - stbi_uc *prior; - int filter = *raw++; - - if (filter > 4) - return stbi__err("invalid filter","Corrupt PNG"); - - if (depth < 8) { - if (img_width_bytes > x) return stbi__err("invalid width","Corrupt PNG"); - cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place - filter_bytes = 1; - width = img_width_bytes; - } - prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above - - // if first row, use special filter that doesn't sample previous row - if (j == 0) filter = first_row_filter[filter]; - - // handle first byte explicitly - for (k=0; k < filter_bytes; ++k) { - switch (filter) { - case STBI__F_none : cur[k] = raw[k]; break; - case STBI__F_sub : cur[k] = raw[k]; break; - case STBI__F_up : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; - case STBI__F_avg : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break; - case STBI__F_paeth : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break; - case STBI__F_avg_first : cur[k] = raw[k]; break; +static int stbi__create_png_image_raw(stbi__png* a, stbi_uc* raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) +{ + int bytes = (depth == 16 ? 2 : 1); + stbi__context* s = a->s; + stbi__uint32 i, j, stride = x * out_n * bytes; + stbi__uint32 img_len, img_width_bytes; + int k; + int img_n = s->img_n; // copy it into a local for later + + int output_bytes = out_n * bytes; + int filter_bytes = img_n * bytes; + int width = x; + + STBI_ASSERT(out_n == s->img_n || out_n == s->img_n + 1); + a->out = (stbi_uc*)stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into + if (!a->out) return stbi__err("outofmem", "Out of memory"); + + if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); + img_width_bytes = (((img_n * x * depth) + 7) >> 3); + img_len = (img_width_bytes + 1) * y; + + // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, + // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), + // so just check for raw_len < img_len always. + if (raw_len < img_len) return stbi__err("not enough pixels", "Corrupt PNG"); + + for (j = 0; j < y; ++j) { + stbi_uc* cur = a->out + stride * j; + stbi_uc* prior; + int filter = *raw++; + + if (filter > 4) + return stbi__err("invalid filter", "Corrupt PNG"); + + if (depth < 8) { + if (img_width_bytes > x) return stbi__err("invalid width", "Corrupt PNG"); + cur += x * out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place + filter_bytes = 1; + width = img_width_bytes; + } + prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // handle first byte explicitly + for (k = 0; k < filter_bytes; ++k) { + switch (filter) { + case STBI__F_none: cur[k] = raw[k]; break; + case STBI__F_sub: cur[k] = raw[k]; break; + case STBI__F_up: cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; + case STBI__F_avg: cur[k] = STBI__BYTECAST(raw[k] + (prior[k] >> 1)); break; + case STBI__F_paeth: cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0, prior[k], 0)); break; + case STBI__F_avg_first: cur[k] = raw[k]; break; case STBI__F_paeth_first: cur[k] = raw[k]; break; - } - } + } + } - if (depth == 8) { - if (img_n != out_n) - cur[img_n] = 255; // first pixel - raw += img_n; - cur += out_n; - prior += out_n; - } else if (depth == 16) { - if (img_n != out_n) { - cur[filter_bytes] = 255; // first pixel top byte - cur[filter_bytes+1] = 255; // first pixel bottom byte - } - raw += filter_bytes; - cur += output_bytes; - prior += output_bytes; - } else { - raw += 1; - cur += 1; - prior += 1; - } + if (depth == 8) { + if (img_n != out_n) + cur[img_n] = 255; // first pixel + raw += img_n; + cur += out_n; + prior += out_n; + } + else if (depth == 16) { + if (img_n != out_n) { + cur[filter_bytes] = 255; // first pixel top byte + cur[filter_bytes + 1] = 255; // first pixel bottom byte + } + raw += filter_bytes; + cur += output_bytes; + prior += output_bytes; + } + else { + raw += 1; + cur += 1; + prior += 1; + } - // this is a little gross, so that we don't switch per-pixel or per-component - if (depth < 8 || img_n == out_n) { - int nk = (width - 1)*filter_bytes; - #define STBI__CASE(f) \ + // this is a little gross, so that we don't switch per-pixel or per-component + if (depth < 8 || img_n == out_n) { + int nk = (width - 1) * filter_bytes; +#define STBI__CASE(f) \ case f: \ for (k=0; k < nk; ++k) - switch (filter) { - // "none" filter turns into a memcpy here; make that explicit. + switch (filter) { + // "none" filter turns into a memcpy here; make that explicit. case STBI__F_none: memcpy(cur, raw, nk); break; - STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break; - STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; - STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break; - STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break; - STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break; - STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break; - } - #undef STBI__CASE - raw += nk; - } else { - STBI_ASSERT(img_n+1 == out_n); - #define STBI__CASE(f) \ + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k - filter_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k - filter_bytes]) >> 1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - filter_bytes], prior[k], prior[k - filter_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k - filter_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - filter_bytes], 0, 0)); } break; + } +#undef STBI__CASE + raw += nk; + } + else { + STBI_ASSERT(img_n + 1 == out_n); +#define STBI__CASE(f) \ case f: \ for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \ for (k=0; k < filter_bytes; ++k) - switch (filter) { - STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; - STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break; - STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; - STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break; - STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break; - STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break; - STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break; - } - #undef STBI__CASE - - // the loop above sets the high byte of the pixels' alpha, but for - // 16 bit png files we also need the low byte set. we'll do that here. - if (depth == 16) { - cur = a->out + stride*j; // start at the beginning of the row again - for (i=0; i < x; ++i,cur+=output_bytes) { - cur[filter_bytes+1] = 255; + switch (filter) { + STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k - output_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k - output_bytes]) >> 1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - output_bytes], prior[k], prior[k - output_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k - output_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - output_bytes], 0, 0)); } break; } - } - } - } +#undef STBI__CASE + + // the loop above sets the high byte of the pixels' alpha, but for + // 16 bit png files we also need the low byte set. we'll do that here. + if (depth == 16) { + cur = a->out + stride * j; // start at the beginning of the row again + for (i = 0; i < x; ++i, cur += output_bytes) { + cur[filter_bytes + 1] = 255; + } + } + } + } - // we make a separate pass to expand bits to pixels; for performance, - // this could run two scanlines behind the above code, so it won't - // intefere with filtering but will still be in the cache. - if (depth < 8) { - for (j=0; j < y; ++j) { - stbi_uc *cur = a->out + stride*j; - stbi_uc *in = a->out + stride*j + x*out_n - img_width_bytes; - // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit - // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop - stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range - - // note that the final byte might overshoot and write more data than desired. - // we can allocate enough data that this never writes out of memory, but it - // could also overwrite the next scanline. can it overwrite non-empty data - // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. - // so we need to explicitly clamp the final ones - - if (depth == 4) { - for (k=x*img_n; k >= 2; k-=2, ++in) { - *cur++ = scale * ((*in >> 4) ); - *cur++ = scale * ((*in ) & 0x0f); + // we make a separate pass to expand bits to pixels; for performance, + // this could run two scanlines behind the above code, so it won't + // intefere with filtering but will still be in the cache. + if (depth < 8) { + for (j = 0; j < y; ++j) { + stbi_uc* cur = a->out + stride * j; + stbi_uc* in = a->out + stride * j + x * out_n - img_width_bytes; + // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit + // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + + // note that the final byte might overshoot and write more data than desired. + // we can allocate enough data that this never writes out of memory, but it + // could also overwrite the next scanline. can it overwrite non-empty data + // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. + // so we need to explicitly clamp the final ones + + if (depth == 4) { + for (k = x * img_n; k >= 2; k -= 2, ++in) { + *cur++ = scale * ((*in >> 4)); + *cur++ = scale * ((*in) & 0x0f); + } + if (k > 0) *cur++ = scale * ((*in >> 4)); } - if (k > 0) *cur++ = scale * ((*in >> 4) ); - } else if (depth == 2) { - for (k=x*img_n; k >= 4; k-=4, ++in) { - *cur++ = scale * ((*in >> 6) ); - *cur++ = scale * ((*in >> 4) & 0x03); - *cur++ = scale * ((*in >> 2) & 0x03); - *cur++ = scale * ((*in ) & 0x03); + else if (depth == 2) { + for (k = x * img_n; k >= 4; k -= 4, ++in) { + *cur++ = scale * ((*in >> 6)); + *cur++ = scale * ((*in >> 4) & 0x03); + *cur++ = scale * ((*in >> 2) & 0x03); + *cur++ = scale * ((*in) & 0x03); + } + if (k > 0) *cur++ = scale * ((*in >> 6)); + if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); + if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); } - if (k > 0) *cur++ = scale * ((*in >> 6) ); - if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); - if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); - } else if (depth == 1) { - for (k=x*img_n; k >= 8; k-=8, ++in) { - *cur++ = scale * ((*in >> 7) ); - *cur++ = scale * ((*in >> 6) & 0x01); - *cur++ = scale * ((*in >> 5) & 0x01); - *cur++ = scale * ((*in >> 4) & 0x01); - *cur++ = scale * ((*in >> 3) & 0x01); - *cur++ = scale * ((*in >> 2) & 0x01); - *cur++ = scale * ((*in >> 1) & 0x01); - *cur++ = scale * ((*in ) & 0x01); + else if (depth == 1) { + for (k = x * img_n; k >= 8; k -= 8, ++in) { + *cur++ = scale * ((*in >> 7)); + *cur++ = scale * ((*in >> 6) & 0x01); + *cur++ = scale * ((*in >> 5) & 0x01); + *cur++ = scale * ((*in >> 4) & 0x01); + *cur++ = scale * ((*in >> 3) & 0x01); + *cur++ = scale * ((*in >> 2) & 0x01); + *cur++ = scale * ((*in >> 1) & 0x01); + *cur++ = scale * ((*in) & 0x01); + } + if (k > 0) *cur++ = scale * ((*in >> 7)); + if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); + if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); + if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); + if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); + if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); + if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); } - if (k > 0) *cur++ = scale * ((*in >> 7) ); - if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); - if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); - if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); - if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); - if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); - if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); - } - if (img_n != out_n) { - int q; - // insert alpha = 255 - cur = a->out + stride*j; - if (img_n == 1) { - for (q=x-1; q >= 0; --q) { - cur[q*2+1] = 255; - cur[q*2+0] = cur[q]; - } - } else { - STBI_ASSERT(img_n == 3); - for (q=x-1; q >= 0; --q) { - cur[q*4+3] = 255; - cur[q*4+2] = cur[q*3+2]; - cur[q*4+1] = cur[q*3+1]; - cur[q*4+0] = cur[q*3+0]; - } + if (img_n != out_n) { + int q; + // insert alpha = 255 + cur = a->out + stride * j; + if (img_n == 1) { + for (q = x - 1; q >= 0; --q) { + cur[q * 2 + 1] = 255; + cur[q * 2 + 0] = cur[q]; + } + } + else { + STBI_ASSERT(img_n == 3); + for (q = x - 1; q >= 0; --q) { + cur[q * 4 + 3] = 255; + cur[q * 4 + 2] = cur[q * 3 + 2]; + cur[q * 4 + 1] = cur[q * 3 + 1]; + cur[q * 4 + 0] = cur[q * 3 + 0]; + } + } } - } - } - } else if (depth == 16) { - // force the image data from big-endian to platform-native. - // this is done in a separate pass due to the decoding relying - // on the data being untouched, but could probably be done - // per-line during decode if care is taken. - stbi_uc *cur = a->out; - stbi__uint16 *cur16 = (stbi__uint16*)cur; - - for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) { - *cur16 = (cur[0] << 8) | cur[1]; - } - } + } + } + else if (depth == 16) { + // force the image data from big-endian to platform-native. + // this is done in a separate pass due to the decoding relying + // on the data being untouched, but could probably be done + // per-line during decode if care is taken. + stbi_uc* cur = a->out; + stbi__uint16* cur16 = (stbi__uint16*)cur; + + for (i = 0; i < x * y * out_n; ++i, cur16++, cur += 2) { + *cur16 = (cur[0] << 8) | cur[1]; + } + } - return 1; -} - -static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) -{ - int bytes = (depth == 16 ? 2 : 1); - int out_bytes = out_n * bytes; - stbi_uc *final; - int p; - if (!interlaced) - return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); - - // de-interlacing - final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); - if (!final) return stbi__err("outofmem", "Out of memory"); - for (p=0; p < 7; ++p) { - int xorig[] = { 0,4,0,2,0,1,0 }; - int yorig[] = { 0,0,4,0,2,0,1 }; - int xspc[] = { 8,8,4,4,2,2,1 }; - int yspc[] = { 8,8,8,4,4,2,2 }; - int i,j,x,y; - // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 - x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p]; - y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p]; - if (x && y) { - stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; - if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { - STBI_FREE(final); - return 0; - } - for (j=0; j < y; ++j) { - for (i=0; i < x; ++i) { - int out_y = j*yspc[p]+yorig[p]; - int out_x = i*xspc[p]+xorig[p]; - memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes, - a->out + (j*x+i)*out_bytes, out_bytes); + return 1; +} + +static int stbi__create_png_image(stbi__png* a, stbi_uc* image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) +{ + int bytes = (depth == 16 ? 2 : 1); + int out_bytes = out_n * bytes; + stbi_uc* final; + int p; + if (!interlaced) + return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); + + // de-interlacing + final = (stbi_uc*)stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); + for (p = 0; p < 7; ++p) { + int xorig[] = { 0,4,0,2,0,1,0 }; + int yorig[] = { 0,0,4,0,2,0,1 }; + int xspc[] = { 8,8,4,4,2,2,1 }; + int yspc[] = { 8,8,8,4,4,2,2 }; + int i, j, x, y; + // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 + x = (a->s->img_x - xorig[p] + xspc[p] - 1) / xspc[p]; + y = (a->s->img_y - yorig[p] + yspc[p] - 1) / yspc[p]; + if (x && y) { + stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; + if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { + STBI_FREE(final); + return 0; } - } - STBI_FREE(a->out); - image_data += img_len; - image_data_len -= img_len; - } - } - a->out = final; + for (j = 0; j < y; ++j) { + for (i = 0; i < x; ++i) { + int out_y = j * yspc[p] + yorig[p]; + int out_x = i * xspc[p] + xorig[p]; + memcpy(final + out_y * a->s->img_x * out_bytes + out_x * out_bytes, + a->out + (j * x + i) * out_bytes, out_bytes); + } + } + STBI_FREE(a->out); + image_data += img_len; + image_data_len -= img_len; + } + } + a->out = final; - return 1; + return 1; } -static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n) +static int stbi__compute_transparency(stbi__png* z, stbi_uc tc[3], int out_n) { - stbi__context *s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi_uc *p = z->out; + stbi__context* s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc* p = z->out; - // compute color-based transparency, assuming we've - // already got 255 as the alpha value in the output - STBI_ASSERT(out_n == 2 || out_n == 4); + // compute color-based transparency, assuming we've + // already got 255 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); - if (out_n == 2) { - for (i=0; i < pixel_count; ++i) { - p[1] = (p[0] == tc[0] ? 0 : 255); - p += 2; - } - } else { - for (i=0; i < pixel_count; ++i) { - if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) - p[3] = 0; - p += 4; - } - } - return 1; + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 255); + p += 2; + } + } + else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; } -static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n) +static int stbi__compute_transparency16(stbi__png* z, stbi__uint16 tc[3], int out_n) { - stbi__context *s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi__uint16 *p = (stbi__uint16*) z->out; + stbi__context* s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi__uint16* p = (stbi__uint16*)z->out; - // compute color-based transparency, assuming we've - // already got 65535 as the alpha value in the output - STBI_ASSERT(out_n == 2 || out_n == 4); + // compute color-based transparency, assuming we've + // already got 65535 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); - if (out_n == 2) { - for (i = 0; i < pixel_count; ++i) { - p[1] = (p[0] == tc[0] ? 0 : 65535); - p += 2; - } - } else { - for (i = 0; i < pixel_count; ++i) { - if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) - p[3] = 0; - p += 4; - } - } - return 1; + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 65535); + p += 2; + } + } + else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; } -static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n) +static int stbi__expand_png_palette(stbi__png* a, stbi_uc* palette, int len, int pal_img_n) { - stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; - stbi_uc *p, *temp_out, *orig = a->out; + stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; + stbi_uc* p, * temp_out, * orig = a->out; - p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0); - if (p == NULL) return stbi__err("outofmem", "Out of memory"); + p = (stbi_uc*)stbi__malloc_mad2(pixel_count, pal_img_n, 0); + if (p == NULL) return stbi__err("outofmem", "Out of memory"); - // between here and free(out) below, exitting would leak - temp_out = p; + // between here and free(out) below, exitting would leak + temp_out = p; - if (pal_img_n == 3) { - for (i=0; i < pixel_count; ++i) { - int n = orig[i]*4; - p[0] = palette[n ]; - p[1] = palette[n+1]; - p[2] = palette[n+2]; - p += 3; - } - } else { - for (i=0; i < pixel_count; ++i) { - int n = orig[i]*4; - p[0] = palette[n ]; - p[1] = palette[n+1]; - p[2] = palette[n+2]; - p[3] = palette[n+3]; - p += 4; - } - } - STBI_FREE(a->out); - a->out = temp_out; + if (pal_img_n == 3) { + for (i = 0; i < pixel_count; ++i) { + int n = orig[i] * 4; + p[0] = palette[n]; + p[1] = palette[n + 1]; + p[2] = palette[n + 2]; + p += 3; + } + } + else { + for (i = 0; i < pixel_count; ++i) { + int n = orig[i] * 4; + p[0] = palette[n]; + p[1] = palette[n + 1]; + p[2] = palette[n + 2]; + p[3] = palette[n + 3]; + p += 4; + } + } + STBI_FREE(a->out); + a->out = temp_out; - STBI_NOTUSED(len); + STBI_NOTUSED(len); - return 1; + return 1; } static int stbi__unpremultiply_on_load_global = 0; @@ -4940,12 +4992,12 @@ static int stbi__de_iphone_flag_global = 0; STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) { - stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; } STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) { - stbi__de_iphone_flag_global = flag_true_if_should_convert; + stbi__de_iphone_flag_global = flag_true_if_should_convert; } #ifndef STBI_THREAD_LOCAL @@ -4957,14 +5009,14 @@ static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_se STBIDEF void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) { - stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; - stbi__unpremultiply_on_load_set = 1; + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; } STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) { - stbi__de_iphone_flag_local = flag_true_if_should_convert; - stbi__de_iphone_flag_set = 1; + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; } #define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ @@ -4975,354 +5027,362 @@ STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_conve : stbi__de_iphone_flag_global) #endif // STBI_THREAD_LOCAL -static void stbi__de_iphone(stbi__png *z) +static void stbi__de_iphone(stbi__png* z) { - stbi__context *s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi_uc *p = z->out; + stbi__context* s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc* p = z->out; - if (s->img_out_n == 3) { // convert bgr to rgb - for (i=0; i < pixel_count; ++i) { - stbi_uc t = p[0]; - p[0] = p[2]; - p[2] = t; - p += 3; - } - } else { - STBI_ASSERT(s->img_out_n == 4); - if (stbi__unpremultiply_on_load) { - // convert bgr to rgb and unpremultiply - for (i=0; i < pixel_count; ++i) { - stbi_uc a = p[3]; - stbi_uc t = p[0]; - if (a) { - stbi_uc half = a / 2; - p[0] = (p[2] * 255 + half) / a; - p[1] = (p[1] * 255 + half) / a; - p[2] = ( t * 255 + half) / a; - } else { - p[0] = p[2]; - p[2] = t; - } - p += 4; - } - } else { - // convert bgr to rgb - for (i=0; i < pixel_count; ++i) { + if (s->img_out_n == 3) { // convert bgr to rgb + for (i = 0; i < pixel_count; ++i) { stbi_uc t = p[0]; p[0] = p[2]; p[2] = t; - p += 4; - } - } - } + p += 3; + } + } + else { + STBI_ASSERT(s->img_out_n == 4); + if (stbi__unpremultiply_on_load) { + // convert bgr to rgb and unpremultiply + for (i = 0; i < pixel_count; ++i) { + stbi_uc a = p[3]; + stbi_uc t = p[0]; + if (a) { + stbi_uc half = a / 2; + p[0] = (p[2] * 255 + half) / a; + p[1] = (p[1] * 255 + half) / a; + p[2] = (t * 255 + half) / a; + } + else { + p[0] = p[2]; + p[2] = t; + } + p += 4; + } + } + else { + // convert bgr to rgb + for (i = 0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 4; + } + } + } } #define STBI__PNG_TYPE(a,b,c,d) (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d)) -static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) +static int stbi__parse_png_file(stbi__png* z, int scan, int req_comp) { - stbi_uc palette[1024], pal_img_n=0; - stbi_uc has_trans=0, tc[3]={0}; - stbi__uint16 tc16[3]; - stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0; - int first=1,k,interlace=0, color=0, is_iphone=0; - stbi__context *s = z->s; + stbi_uc palette[1024], pal_img_n = 0; + stbi_uc has_trans = 0, tc[3] = { 0 }; + stbi__uint16 tc16[3]; + stbi__uint32 ioff = 0, idata_limit = 0, i, pal_len = 0; + int first = 1, k, interlace = 0, color = 0, is_iphone = 0; + stbi__context* s = z->s; - z->expanded = NULL; - z->idata = NULL; - z->out = NULL; + z->expanded = NULL; + z->idata = NULL; + z->out = NULL; - if (!stbi__check_png_header(s)) return 0; + if (!stbi__check_png_header(s)) return 0; - if (scan == STBI__SCAN_type) return 1; + if (scan == STBI__SCAN_type) return 1; - for (;;) { - stbi__pngchunk c = stbi__get_chunk_header(s); - switch (c.type) { - case STBI__PNG_TYPE('C','g','B','I'): + for (;;) { + stbi__pngchunk c = stbi__get_chunk_header(s); + switch (c.type) { + case STBI__PNG_TYPE('C', 'g', 'B', 'I'): is_iphone = 1; stbi__skip(s, c.length); break; - case STBI__PNG_TYPE('I','H','D','R'): { - int comp,filter; - if (!first) return stbi__err("multiple IHDR","Corrupt PNG"); + case STBI__PNG_TYPE('I', 'H', 'D', 'R'): { + int comp, filter; + if (!first) return stbi__err("multiple IHDR", "Corrupt PNG"); first = 0; - if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG"); + if (c.length != 13) return stbi__err("bad IHDR len", "Corrupt PNG"); s->img_x = stbi__get32be(s); s->img_y = stbi__get32be(s); - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); - z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only"); - color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype","Corrupt PNG"); - if (color == 3 && z->depth == 16) return stbi__err("bad ctype","Corrupt PNG"); - if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG"); - comp = stbi__get8(s); if (comp) return stbi__err("bad comp method","Corrupt PNG"); - filter= stbi__get8(s); if (filter) return stbi__err("bad filter method","Corrupt PNG"); - interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG"); - if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG"); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); + z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only", "PNG not supported: 1/2/4/8/16-bit only"); + color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype", "Corrupt PNG"); + if (color == 3 && z->depth == 16) return stbi__err("bad ctype", "Corrupt PNG"); + if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype", "Corrupt PNG"); + comp = stbi__get8(s); if (comp) return stbi__err("bad comp method", "Corrupt PNG"); + filter = stbi__get8(s); if (filter) return stbi__err("bad filter method", "Corrupt PNG"); + interlace = stbi__get8(s); if (interlace > 1) return stbi__err("bad interlace method", "Corrupt PNG"); + if (!s->img_x || !s->img_y) return stbi__err("0-pixel image", "Corrupt PNG"); if (!pal_img_n) { - s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); - if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); - if (scan == STBI__SCAN_header) return 1; - } else { - // if paletted, then pal_n is our final components, and - // img_n is # components to decompress/filter. - s->img_n = 1; - if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG"); - // if SCAN_header, have to scan to see if we have a tRNS + s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); + if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); + if (scan == STBI__SCAN_header) return 1; + } + else { + // if paletted, then pal_n is our final components, and + // img_n is # components to decompress/filter. + s->img_n = 1; + if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large", "Corrupt PNG"); + // if SCAN_header, have to scan to see if we have a tRNS } break; - } + } - case STBI__PNG_TYPE('P','L','T','E'): { + case STBI__PNG_TYPE('P', 'L', 'T', 'E'): { if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG"); + if (c.length > 256 * 3) return stbi__err("invalid PLTE", "Corrupt PNG"); pal_len = c.length / 3; - if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG"); - for (i=0; i < pal_len; ++i) { - palette[i*4+0] = stbi__get8(s); - palette[i*4+1] = stbi__get8(s); - palette[i*4+2] = stbi__get8(s); - palette[i*4+3] = 255; + if (pal_len * 3 != c.length) return stbi__err("invalid PLTE", "Corrupt PNG"); + for (i = 0; i < pal_len; ++i) { + palette[i * 4 + 0] = stbi__get8(s); + palette[i * 4 + 1] = stbi__get8(s); + palette[i * 4 + 2] = stbi__get8(s); + palette[i * 4 + 3] = 255; } break; - } + } - case STBI__PNG_TYPE('t','R','N','S'): { + case STBI__PNG_TYPE('t', 'R', 'N', 'S'): { if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG"); + if (z->idata) return stbi__err("tRNS after IDAT", "Corrupt PNG"); if (pal_img_n) { - if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } - if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG"); - if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG"); - pal_img_n = 4; - for (i=0; i < c.length; ++i) - palette[i*4+3] = stbi__get8(s); - } else { - if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG"); - if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG"); - has_trans = 1; - if (z->depth == 16) { - for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is - } else { - for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger - } + if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } + if (pal_len == 0) return stbi__err("tRNS before PLTE", "Corrupt PNG"); + if (c.length > pal_len) return stbi__err("bad tRNS len", "Corrupt PNG"); + pal_img_n = 4; + for (i = 0; i < c.length; ++i) + palette[i * 4 + 3] = stbi__get8(s); + } + else { + if (!(s->img_n & 1)) return stbi__err("tRNS with alpha", "Corrupt PNG"); + if (c.length != (stbi__uint32)s->img_n * 2) return stbi__err("bad tRNS len", "Corrupt PNG"); + has_trans = 1; + if (z->depth == 16) { + for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } + else { + for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger + } } break; - } + } - case STBI__PNG_TYPE('I','D','A','T'): { + case STBI__PNG_TYPE('I', 'D', 'A', 'T'): { if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG"); + if (pal_img_n && !pal_len) return stbi__err("no PLTE", "Corrupt PNG"); if (scan == STBI__SCAN_header) { s->img_n = pal_img_n; return 1; } if ((int)(ioff + c.length) < (int)ioff) return 0; if (ioff + c.length > idata_limit) { - stbi__uint32 idata_limit_old = idata_limit; - stbi_uc *p; - if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096; - while (ioff + c.length > idata_limit) - idata_limit *= 2; - STBI_NOTUSED(idata_limit_old); - p = (stbi_uc *) STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory"); - z->idata = p; + stbi__uint32 idata_limit_old = idata_limit; + stbi_uc* p; + if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096; + while (ioff + c.length > idata_limit) + idata_limit *= 2; + STBI_NOTUSED(idata_limit_old); + p = (stbi_uc*)STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory"); + z->idata = p; } - if (!stbi__getn(s, z->idata+ioff,c.length)) return stbi__err("outofdata","Corrupt PNG"); + if (!stbi__getn(s, z->idata + ioff, c.length)) return stbi__err("outofdata", "Corrupt PNG"); ioff += c.length; break; - } + } - case STBI__PNG_TYPE('I','E','N','D'): { + case STBI__PNG_TYPE('I', 'E', 'N', 'D'): { stbi__uint32 raw_len, bpl; if (first) return stbi__err("first not IHDR", "Corrupt PNG"); if (scan != STBI__SCAN_load) return 1; - if (z->idata == NULL) return stbi__err("no IDAT","Corrupt PNG"); + if (z->idata == NULL) return stbi__err("no IDAT", "Corrupt PNG"); // initial guess for decoded data size to avoid unnecessary reallocs bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */; - z->expanded = (stbi_uc *) stbi_zlib_decode_malloc_guesssize_headerflag((char *) z->idata, ioff, raw_len, (int *) &raw_len, !is_iphone); + z->expanded = (stbi_uc*)stbi_zlib_decode_malloc_guesssize_headerflag((char*)z->idata, ioff, raw_len, (int*)&raw_len, !is_iphone); if (z->expanded == NULL) return 0; // zlib should set error STBI_FREE(z->idata); z->idata = NULL; - if ((req_comp == s->img_n+1 && req_comp != 3 && !pal_img_n) || has_trans) - s->img_out_n = s->img_n+1; + if ((req_comp == s->img_n + 1 && req_comp != 3 && !pal_img_n) || has_trans) + s->img_out_n = s->img_n + 1; else - s->img_out_n = s->img_n; + s->img_out_n = s->img_n; if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0; if (has_trans) { - if (z->depth == 16) { - if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0; - } else { - if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0; - } + if (z->depth == 16) { + if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0; + } + else { + if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0; + } } if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2) - stbi__de_iphone(z); + stbi__de_iphone(z); if (pal_img_n) { - // pal_img_n == 3 or 4 - s->img_n = pal_img_n; // record the actual colors we had - s->img_out_n = pal_img_n; - if (req_comp >= 3) s->img_out_n = req_comp; - if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n)) - return 0; - } else if (has_trans) { - // non-paletted image with tRNS -> source image has (constant) alpha - ++s->img_n; + // pal_img_n == 3 or 4 + s->img_n = pal_img_n; // record the actual colors we had + s->img_out_n = pal_img_n; + if (req_comp >= 3) s->img_out_n = req_comp; + if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n)) + return 0; + } + else if (has_trans) { + // non-paletted image with tRNS -> source image has (constant) alpha + ++s->img_n; } STBI_FREE(z->expanded); z->expanded = NULL; // end of PNG chunk, read and skip CRC stbi__get32be(s); return 1; - } + } - default: + default: // if critical, fail if (first) return stbi__err("first not IHDR", "Corrupt PNG"); if ((c.type & (1 << 29)) == 0) { - #ifndef STBI_NO_FAILURE_STRINGS - // not threadsafe - static char invalid_chunk[] = "XXXX PNG chunk not known"; - invalid_chunk[0] = STBI__BYTECAST(c.type >> 24); - invalid_chunk[1] = STBI__BYTECAST(c.type >> 16); - invalid_chunk[2] = STBI__BYTECAST(c.type >> 8); - invalid_chunk[3] = STBI__BYTECAST(c.type >> 0); - #endif - return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type"); +#ifndef STBI_NO_FAILURE_STRINGS + // not threadsafe + static char invalid_chunk[] = "XXXX PNG chunk not known"; + invalid_chunk[0] = STBI__BYTECAST(c.type >> 24); + invalid_chunk[1] = STBI__BYTECAST(c.type >> 16); + invalid_chunk[2] = STBI__BYTECAST(c.type >> 8); + invalid_chunk[3] = STBI__BYTECAST(c.type >> 0); +#endif + return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type"); } stbi__skip(s, c.length); break; - } - // end of PNG chunk, read and skip CRC - stbi__get32be(s); - } + } + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + } } -static void *stbi__do_png(stbi__png *p, int *x, int *y, int *n, int req_comp, stbi__result_info *ri) -{ - void *result=NULL; - if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); - if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) { - if (p->depth <= 8) - ri->bits_per_channel = 8; - else if (p->depth == 16) - ri->bits_per_channel = 16; - else - return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color depth"); - result = p->out; - p->out = NULL; - if (req_comp && req_comp != p->s->img_out_n) { - if (ri->bits_per_channel == 8) - result = stbi__convert_format((unsigned char *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); - else - result = stbi__convert_format16((stbi__uint16 *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); - p->s->img_out_n = req_comp; - if (result == NULL) return result; - } - *x = p->s->img_x; - *y = p->s->img_y; - if (n) *n = p->s->img_n; - } - STBI_FREE(p->out); p->out = NULL; - STBI_FREE(p->expanded); p->expanded = NULL; - STBI_FREE(p->idata); p->idata = NULL; +static void* stbi__do_png(stbi__png* p, int* x, int* y, int* n, int req_comp, stbi__result_info* ri) +{ + void* result = NULL; + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) { + if (p->depth <= 8) + ri->bits_per_channel = 8; + else if (p->depth == 16) + ri->bits_per_channel = 16; + else + return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color depth"); + result = p->out; + p->out = NULL; + if (req_comp && req_comp != p->s->img_out_n) { + if (ri->bits_per_channel == 8) + result = stbi__convert_format((unsigned char*)result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + else + result = stbi__convert_format16((stbi__uint16*)result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + p->s->img_out_n = req_comp; + if (result == NULL) return result; + } + *x = p->s->img_x; + *y = p->s->img_y; + if (n) *n = p->s->img_n; + } + STBI_FREE(p->out); p->out = NULL; + STBI_FREE(p->expanded); p->expanded = NULL; + STBI_FREE(p->idata); p->idata = NULL; - return result; + return result; } -static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +static void* stbi__png_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) { - stbi__png p; - p.s = s; - return stbi__do_png(&p, x,y,comp,req_comp, ri); + stbi__png p; + p.s = s; + return stbi__do_png(&p, x, y, comp, req_comp, ri); } -static int stbi__png_test(stbi__context *s) +static int stbi__png_test(stbi__context* s) { - int r; - r = stbi__check_png_header(s); - stbi__rewind(s); - return r; + int r; + r = stbi__check_png_header(s); + stbi__rewind(s); + return r; } -static int stbi__png_info_raw(stbi__png *p, int *x, int *y, int *comp) +static int stbi__png_info_raw(stbi__png* p, int* x, int* y, int* comp) { - if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) { - stbi__rewind( p->s ); - return 0; - } - if (x) *x = p->s->img_x; - if (y) *y = p->s->img_y; - if (comp) *comp = p->s->img_n; - return 1; + if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) { + stbi__rewind(p->s); + return 0; + } + if (x) *x = p->s->img_x; + if (y) *y = p->s->img_y; + if (comp) *comp = p->s->img_n; + return 1; } -static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__png_info(stbi__context* s, int* x, int* y, int* comp) { - stbi__png p; - p.s = s; - return stbi__png_info_raw(&p, x, y, comp); + stbi__png p; + p.s = s; + return stbi__png_info_raw(&p, x, y, comp); } -static int stbi__png_is16(stbi__context *s) +static int stbi__png_is16(stbi__context* s) { - stbi__png p; - p.s = s; - if (!stbi__png_info_raw(&p, NULL, NULL, NULL)) - return 0; - if (p.depth != 16) { - stbi__rewind(p.s); - return 0; - } - return 1; + stbi__png p; + p.s = s; + if (!stbi__png_info_raw(&p, NULL, NULL, NULL)) + return 0; + if (p.depth != 16) { + stbi__rewind(p.s); + return 0; + } + return 1; } #endif // Microsoft/Windows BMP image #ifndef STBI_NO_BMP -static int stbi__bmp_test_raw(stbi__context *s) +static int stbi__bmp_test_raw(stbi__context* s) { - int r; - int sz; - if (stbi__get8(s) != 'B') return 0; - if (stbi__get8(s) != 'M') return 0; - stbi__get32le(s); // discard filesize - stbi__get16le(s); // discard reserved - stbi__get16le(s); // discard reserved - stbi__get32le(s); // discard data offset - sz = stbi__get32le(s); - r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124); - return r; + int r; + int sz; + if (stbi__get8(s) != 'B') return 0; + if (stbi__get8(s) != 'M') return 0; + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + stbi__get32le(s); // discard data offset + sz = stbi__get32le(s); + r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124); + return r; } -static int stbi__bmp_test(stbi__context *s) +static int stbi__bmp_test(stbi__context* s) { - int r = stbi__bmp_test_raw(s); - stbi__rewind(s); - return r; + int r = stbi__bmp_test_raw(s); + stbi__rewind(s); + return r; } // returns 0..31 for the highest set bit static int stbi__high_bit(unsigned int z) { - int n=0; - if (z == 0) return -1; - if (z >= 0x10000) { n += 16; z >>= 16; } - if (z >= 0x00100) { n += 8; z >>= 8; } - if (z >= 0x00010) { n += 4; z >>= 4; } - if (z >= 0x00004) { n += 2; z >>= 2; } - if (z >= 0x00002) { n += 1;/* >>= 1;*/ } - return n; + int n = 0; + if (z == 0) return -1; + if (z >= 0x10000) { n += 16; z >>= 16; } + if (z >= 0x00100) { n += 8; z >>= 8; } + if (z >= 0x00010) { n += 4; z >>= 4; } + if (z >= 0x00004) { n += 2; z >>= 2; } + if (z >= 0x00002) { n += 1;/* >>= 1;*/ } + return n; } static int stbi__bitcount(unsigned int a) { - a = (a & 0x55555555) + ((a >> 1) & 0x55555555); // max 2 - a = (a & 0x33333333) + ((a >> 2) & 0x33333333); // max 4 - a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits - a = (a + (a >> 8)); // max 16 per 8 bits - a = (a + (a >> 16)); // max 32 per 8 bits - return a & 0xff; + a = (a & 0x55555555) + ((a >> 1) & 0x55555555); // max 2 + a = (a & 0x33333333) + ((a >> 2) & 0x33333333); // max 4 + a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits + a = (a + (a >> 8)); // max 16 per 8 bits + a = (a + (a >> 16)); // max 32 per 8 bits + return a & 0xff; } // extract an arbitrarily-aligned N-bit value (N=bits) @@ -5330,327 +5390,338 @@ static int stbi__bitcount(unsigned int a) // extend it to full full range. static int stbi__shiftsigned(unsigned int v, int shift, int bits) { - static unsigned int mul_table[9] = { - 0, - 0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/, - 0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/, - }; - static unsigned int shift_table[9] = { - 0, 0,0,1,0,2,4,6,0, - }; - if (shift < 0) - v <<= -shift; - else - v >>= shift; - STBI_ASSERT(v < 256); - v >>= (8-bits); - STBI_ASSERT(bits >= 0 && bits <= 8); - return (int) ((unsigned) v * mul_table[bits]) >> shift_table[bits]; + static unsigned int mul_table[9] = { + 0, + 0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/, + 0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/, + }; + static unsigned int shift_table[9] = { + 0, 0,0,1,0,2,4,6,0, + }; + if (shift < 0) + v <<= -shift; + else + v >>= shift; + STBI_ASSERT(v < 256); + v >>= (8 - bits); + STBI_ASSERT(bits >= 0 && bits <= 8); + return (int)((unsigned)v * mul_table[bits]) >> shift_table[bits]; } typedef struct { - int bpp, offset, hsz; - unsigned int mr,mg,mb,ma, all_a; - int extra_read; + int bpp, offset, hsz; + unsigned int mr, mg, mb, ma, all_a; + int extra_read; } stbi__bmp_data; -static int stbi__bmp_set_mask_defaults(stbi__bmp_data *info, int compress) -{ - // BI_BITFIELDS specifies masks explicitly, don't override - if (compress == 3) - return 1; - - if (compress == 0) { - if (info->bpp == 16) { - info->mr = 31u << 10; - info->mg = 31u << 5; - info->mb = 31u << 0; - } else if (info->bpp == 32) { - info->mr = 0xffu << 16; - info->mg = 0xffu << 8; - info->mb = 0xffu << 0; - info->ma = 0xffu << 24; - info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 - } else { - // otherwise, use defaults, which is all-0 - info->mr = info->mg = info->mb = info->ma = 0; - } - return 1; - } - return 0; // error -} - -static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) -{ - int hsz; - if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP"); - stbi__get32le(s); // discard filesize - stbi__get16le(s); // discard reserved - stbi__get16le(s); // discard reserved - info->offset = stbi__get32le(s); - info->hsz = hsz = stbi__get32le(s); - info->mr = info->mg = info->mb = info->ma = 0; - info->extra_read = 14; - - if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); - - if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown"); - if (hsz == 12) { - s->img_x = stbi__get16le(s); - s->img_y = stbi__get16le(s); - } else { - s->img_x = stbi__get32le(s); - s->img_y = stbi__get32le(s); - } - if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP"); - info->bpp = stbi__get16le(s); - if (hsz != 12) { - int compress = stbi__get32le(s); - if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); - if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes - if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel - stbi__get32le(s); // discard sizeof - stbi__get32le(s); // discard hres - stbi__get32le(s); // discard vres - stbi__get32le(s); // discard colorsused - stbi__get32le(s); // discard max important - if (hsz == 40 || hsz == 56) { - if (hsz == 56) { - stbi__get32le(s); - stbi__get32le(s); - stbi__get32le(s); - stbi__get32le(s); - } - if (info->bpp == 16 || info->bpp == 32) { - if (compress == 0) { - stbi__bmp_set_mask_defaults(info, compress); - } else if (compress == 3) { - info->mr = stbi__get32le(s); - info->mg = stbi__get32le(s); - info->mb = stbi__get32le(s); - info->extra_read += 12; - // not documented, but generated by photoshop and handled by mspaint - if (info->mr == info->mg && info->mg == info->mb) { - // ?!?!? - return stbi__errpuc("bad BMP", "bad BMP"); - } - } else - return stbi__errpuc("bad BMP", "bad BMP"); - } - } else { - // V4/V5 header - int i; - if (hsz != 108 && hsz != 124) - return stbi__errpuc("bad BMP", "bad BMP"); - info->mr = stbi__get32le(s); - info->mg = stbi__get32le(s); - info->mb = stbi__get32le(s); - info->ma = stbi__get32le(s); - if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs - stbi__bmp_set_mask_defaults(info, compress); - stbi__get32le(s); // discard color space - for (i=0; i < 12; ++i) - stbi__get32le(s); // discard color space parameters - if (hsz == 124) { - stbi__get32le(s); // discard rendering intent - stbi__get32le(s); // discard offset of profile data - stbi__get32le(s); // discard size of profile data - stbi__get32le(s); // discard reserved - } - } - } - return (void *) 1; +static int stbi__bmp_set_mask_defaults(stbi__bmp_data* info, int compress) +{ + // BI_BITFIELDS specifies masks explicitly, don't override + if (compress == 3) + return 1; + + if (compress == 0) { + if (info->bpp == 16) { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } + else if (info->bpp == 32) { + info->mr = 0xffu << 16; + info->mg = 0xffu << 8; + info->mb = 0xffu << 0; + info->ma = 0xffu << 24; + info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 + } + else { + // otherwise, use defaults, which is all-0 + info->mr = info->mg = info->mb = info->ma = 0; + } + return 1; + } + return 0; // error } +static void* stbi__bmp_parse_header(stbi__context* s, stbi__bmp_data* info) +{ + int hsz; + if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP"); + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + info->offset = stbi__get32le(s); + info->hsz = hsz = stbi__get32le(s); + info->mr = info->mg = info->mb = info->ma = 0; + info->extra_read = 14; + + if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); -static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) + if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown"); + if (hsz == 12) { + s->img_x = stbi__get16le(s); + s->img_y = stbi__get16le(s); + } + else { + s->img_x = stbi__get32le(s); + s->img_y = stbi__get32le(s); + } + if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP"); + info->bpp = stbi__get16le(s); + if (hsz != 12) { + int compress = stbi__get32le(s); + if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); + if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes + if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel + stbi__get32le(s); // discard sizeof + stbi__get32le(s); // discard hres + stbi__get32le(s); // discard vres + stbi__get32le(s); // discard colorsused + stbi__get32le(s); // discard max important + if (hsz == 40 || hsz == 56) { + if (hsz == 56) { + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + } + if (info->bpp == 16 || info->bpp == 32) { + if (compress == 0) { + stbi__bmp_set_mask_defaults(info, compress); + } + else if (compress == 3) { + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->extra_read += 12; + // not documented, but generated by photoshop and handled by mspaint + if (info->mr == info->mg && info->mg == info->mb) { + // ?!?!? + return stbi__errpuc("bad BMP", "bad BMP"); + } + } + else + return stbi__errpuc("bad BMP", "bad BMP"); + } + } + else { + // V4/V5 header + int i; + if (hsz != 108 && hsz != 124) + return stbi__errpuc("bad BMP", "bad BMP"); + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->ma = stbi__get32le(s); + if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs + stbi__bmp_set_mask_defaults(info, compress); + stbi__get32le(s); // discard color space + for (i = 0; i < 12; ++i) + stbi__get32le(s); // discard color space parameters + if (hsz == 124) { + stbi__get32le(s); // discard rendering intent + stbi__get32le(s); // discard offset of profile data + stbi__get32le(s); // discard size of profile data + stbi__get32le(s); // discard reserved + } + } + } + return (void*)1; +} + + +static void* stbi__bmp_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) { - stbi_uc *out; - unsigned int mr=0,mg=0,mb=0,ma=0, all_a; - stbi_uc pal[256][4]; - int psize=0,i,j,width; - int flip_vertically, pad, target; - stbi__bmp_data info; - STBI_NOTUSED(ri); + stbi_uc* out; + unsigned int mr = 0, mg = 0, mb = 0, ma = 0, all_a; + stbi_uc pal[256][4]; + int psize = 0, i, j, width; + int flip_vertically, pad, target; + stbi__bmp_data info; + STBI_NOTUSED(ri); - info.all_a = 255; - if (stbi__bmp_parse_header(s, &info) == NULL) - return NULL; // error code already set + info.all_a = 255; + if (stbi__bmp_parse_header(s, &info) == NULL) + return NULL; // error code already set - flip_vertically = ((int) s->img_y) > 0; - s->img_y = abs((int) s->img_y); + flip_vertically = ((int)s->img_y) > 0; + s->img_y = abs((int)s->img_y); - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - mr = info.mr; - mg = info.mg; - mb = info.mb; - ma = info.ma; - all_a = info.all_a; + mr = info.mr; + mg = info.mg; + mb = info.mb; + ma = info.ma; + all_a = info.all_a; - if (info.hsz == 12) { - if (info.bpp < 24) - psize = (info.offset - info.extra_read - 24) / 3; - } else { - if (info.bpp < 16) - psize = (info.offset - info.extra_read - info.hsz) >> 2; - } - if (psize == 0) { - if (info.offset != s->callback_already_read + (s->img_buffer - s->img_buffer_original)) { - return stbi__errpuc("bad offset", "Corrupt BMP"); - } - } + if (info.hsz == 12) { + if (info.bpp < 24) + psize = (info.offset - info.extra_read - 24) / 3; + } + else { + if (info.bpp < 16) + psize = (info.offset - info.extra_read - info.hsz) >> 2; + } + if (psize == 0) { + if (info.offset != s->callback_already_read + (s->img_buffer - s->img_buffer_original)) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } + } - if (info.bpp == 24 && ma == 0xff000000) - s->img_n = 3; - else - s->img_n = ma ? 4 : 3; - if (req_comp && req_comp >= 3) // we can directly decode 3 or 4 - target = req_comp; - else - target = s->img_n; // if they want monochrome, we'll post-convert - - // sanity-check size - if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0)) - return stbi__errpuc("too large", "Corrupt BMP"); - - out = (stbi_uc *) stbi__malloc_mad3(target, s->img_x, s->img_y, 0); - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - if (info.bpp < 16) { - int z=0; - if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); } - for (i=0; i < psize; ++i) { - pal[i][2] = stbi__get8(s); - pal[i][1] = stbi__get8(s); - pal[i][0] = stbi__get8(s); - if (info.hsz != 12) stbi__get8(s); - pal[i][3] = 255; - } - stbi__skip(s, info.offset - info.extra_read - info.hsz - psize * (info.hsz == 12 ? 3 : 4)); - if (info.bpp == 1) width = (s->img_x + 7) >> 3; - else if (info.bpp == 4) width = (s->img_x + 1) >> 1; - else if (info.bpp == 8) width = s->img_x; - else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); } - pad = (-width)&3; - if (info.bpp == 1) { - for (j=0; j < (int) s->img_y; ++j) { - int bit_offset = 7, v = stbi__get8(s); - for (i=0; i < (int) s->img_x; ++i) { - int color = (v>>bit_offset)&0x1; - out[z++] = pal[color][0]; - out[z++] = pal[color][1]; - out[z++] = pal[color][2]; - if (target == 4) out[z++] = 255; - if (i+1 == (int) s->img_x) break; - if((--bit_offset) < 0) { - bit_offset = 7; - v = stbi__get8(s); - } + if (info.bpp == 24 && ma == 0xff000000) + s->img_n = 3; + else + s->img_n = ma ? 4 : 3; + if (req_comp && req_comp >= 3) // we can directly decode 3 or 4 + target = req_comp; + else + target = s->img_n; // if they want monochrome, we'll post-convert + + // sanity-check size + if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0)) + return stbi__errpuc("too large", "Corrupt BMP"); + + out = (stbi_uc*)stbi__malloc_mad3(target, s->img_x, s->img_y, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + if (info.bpp < 16) { + int z = 0; + if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); } + for (i = 0; i < psize; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + if (info.hsz != 12) stbi__get8(s); + pal[i][3] = 255; + } + stbi__skip(s, info.offset - info.extra_read - info.hsz - psize * (info.hsz == 12 ? 3 : 4)); + if (info.bpp == 1) width = (s->img_x + 7) >> 3; + else if (info.bpp == 4) width = (s->img_x + 1) >> 1; + else if (info.bpp == 8) width = s->img_x; + else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); } + pad = (-width) & 3; + if (info.bpp == 1) { + for (j = 0; j < (int)s->img_y; ++j) { + int bit_offset = 7, v = stbi__get8(s); + for (i = 0; i < (int)s->img_x; ++i) { + int color = (v >> bit_offset) & 0x1; + out[z++] = pal[color][0]; + out[z++] = pal[color][1]; + out[z++] = pal[color][2]; + if (target == 4) out[z++] = 255; + if (i + 1 == (int)s->img_x) break; + if ((--bit_offset) < 0) { + bit_offset = 7; + v = stbi__get8(s); + } + } + stbi__skip(s, pad); } - stbi__skip(s, pad); - } - } else { - for (j=0; j < (int) s->img_y; ++j) { - for (i=0; i < (int) s->img_x; i += 2) { - int v=stbi__get8(s),v2=0; - if (info.bpp == 4) { - v2 = v & 15; - v >>= 4; - } - out[z++] = pal[v][0]; - out[z++] = pal[v][1]; - out[z++] = pal[v][2]; - if (target == 4) out[z++] = 255; - if (i+1 == (int) s->img_x) break; - v = (info.bpp == 8) ? stbi__get8(s) : v2; - out[z++] = pal[v][0]; - out[z++] = pal[v][1]; - out[z++] = pal[v][2]; - if (target == 4) out[z++] = 255; + } + else { + for (j = 0; j < (int)s->img_y; ++j) { + for (i = 0; i < (int)s->img_x; i += 2) { + int v = stbi__get8(s), v2 = 0; + if (info.bpp == 4) { + v2 = v & 15; + v >>= 4; + } + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + if (i + 1 == (int)s->img_x) break; + v = (info.bpp == 8) ? stbi__get8(s) : v2; + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + } + stbi__skip(s, pad); } - stbi__skip(s, pad); - } - } - } else { - int rshift=0,gshift=0,bshift=0,ashift=0,rcount=0,gcount=0,bcount=0,acount=0; - int z = 0; - int easy=0; - stbi__skip(s, info.offset - info.extra_read - info.hsz); - if (info.bpp == 24) width = 3 * s->img_x; - else if (info.bpp == 16) width = 2*s->img_x; - else /* bpp = 32 and pad = 0 */ width=0; - pad = (-width) & 3; - if (info.bpp == 24) { - easy = 1; - } else if (info.bpp == 32) { - if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000) - easy = 2; - } - if (!easy) { - if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } - // right shift amt to put high bit in position #7 - rshift = stbi__high_bit(mr)-7; rcount = stbi__bitcount(mr); - gshift = stbi__high_bit(mg)-7; gcount = stbi__bitcount(mg); - bshift = stbi__high_bit(mb)-7; bcount = stbi__bitcount(mb); - ashift = stbi__high_bit(ma)-7; acount = stbi__bitcount(ma); - if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } - } - for (j=0; j < (int) s->img_y; ++j) { - if (easy) { - for (i=0; i < (int) s->img_x; ++i) { - unsigned char a; - out[z+2] = stbi__get8(s); - out[z+1] = stbi__get8(s); - out[z+0] = stbi__get8(s); - z += 3; - a = (easy == 2 ? stbi__get8(s) : 255); - all_a |= a; - if (target == 4) out[z++] = a; + } + } + else { + int rshift = 0, gshift = 0, bshift = 0, ashift = 0, rcount = 0, gcount = 0, bcount = 0, acount = 0; + int z = 0; + int easy = 0; + stbi__skip(s, info.offset - info.extra_read - info.hsz); + if (info.bpp == 24) width = 3 * s->img_x; + else if (info.bpp == 16) width = 2 * s->img_x; + else /* bpp = 32 and pad = 0 */ width = 0; + pad = (-width) & 3; + if (info.bpp == 24) { + easy = 1; + } + else if (info.bpp == 32) { + if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000) + easy = 2; + } + if (!easy) { + if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + // right shift amt to put high bit in position #7 + rshift = stbi__high_bit(mr) - 7; rcount = stbi__bitcount(mr); + gshift = stbi__high_bit(mg) - 7; gcount = stbi__bitcount(mg); + bshift = stbi__high_bit(mb) - 7; bcount = stbi__bitcount(mb); + ashift = stbi__high_bit(ma) - 7; acount = stbi__bitcount(ma); + if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + } + for (j = 0; j < (int)s->img_y; ++j) { + if (easy) { + for (i = 0; i < (int)s->img_x; ++i) { + unsigned char a; + out[z + 2] = stbi__get8(s); + out[z + 1] = stbi__get8(s); + out[z + 0] = stbi__get8(s); + z += 3; + a = (easy == 2 ? stbi__get8(s) : 255); + all_a |= a; + if (target == 4) out[z++] = a; + } } - } else { - int bpp = info.bpp; - for (i=0; i < (int) s->img_x; ++i) { - stbi__uint32 v = (bpp == 16 ? (stbi__uint32) stbi__get16le(s) : stbi__get32le(s)); - unsigned int a; - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount)); - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount)); - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount)); - a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255); - all_a |= a; - if (target == 4) out[z++] = STBI__BYTECAST(a); + else { + int bpp = info.bpp; + for (i = 0; i < (int)s->img_x; ++i) { + stbi__uint32 v = (bpp == 16 ? (stbi__uint32)stbi__get16le(s) : stbi__get32le(s)); + unsigned int a; + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount)); + a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255); + all_a |= a; + if (target == 4) out[z++] = STBI__BYTECAST(a); + } } - } - stbi__skip(s, pad); - } - } + stbi__skip(s, pad); + } + } - // if alpha channel is all 0s, replace with all 255s - if (target == 4 && all_a == 0) - for (i=4*s->img_x*s->img_y-1; i >= 0; i -= 4) - out[i] = 255; - - if (flip_vertically) { - stbi_uc t; - for (j=0; j < (int) s->img_y>>1; ++j) { - stbi_uc *p1 = out + j *s->img_x*target; - stbi_uc *p2 = out + (s->img_y-1-j)*s->img_x*target; - for (i=0; i < (int) s->img_x*target; ++i) { - t = p1[i]; p1[i] = p2[i]; p2[i] = t; - } - } - } + // if alpha channel is all 0s, replace with all 255s + if (target == 4 && all_a == 0) + for (i = 4 * s->img_x * s->img_y - 1; i >= 0; i -= 4) + out[i] = 255; + + if (flip_vertically) { + stbi_uc t; + for (j = 0; j < (int)s->img_y >> 1; ++j) { + stbi_uc* p1 = out + j * s->img_x * target; + stbi_uc* p2 = out + (s->img_y - 1 - j) * s->img_x * target; + for (i = 0; i < (int)s->img_x * target; ++i) { + t = p1[i]; p1[i] = p2[i]; p2[i] = t; + } + } + } - if (req_comp && req_comp != target) { - out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } + if (req_comp && req_comp != target) { + out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } - *x = s->img_x; - *y = s->img_y; - if (comp) *comp = s->img_n; - return out; + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + return out; } #endif @@ -5660,78 +5731,80 @@ static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req // returns STBI_rgb or whatever, 0 on error static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16) { - // only RGB or RGBA (incl. 16bit) or grey allowed - if (is_rgb16) *is_rgb16 = 0; - switch(bits_per_pixel) { - case 8: return STBI_grey; - case 16: if(is_grey) return STBI_grey_alpha; - // fallthrough - case 15: if(is_rgb16) *is_rgb16 = 1; - return STBI_rgb; - case 24: // fallthrough - case 32: return bits_per_pixel/8; - default: return 0; - } + // only RGB or RGBA (incl. 16bit) or grey allowed + if (is_rgb16) *is_rgb16 = 0; + switch (bits_per_pixel) { + case 8: return STBI_grey; + case 16: if (is_grey) return STBI_grey_alpha; + // fallthrough + case 15: if (is_rgb16) *is_rgb16 = 1; + return STBI_rgb; + case 24: // fallthrough + case 32: return bits_per_pixel / 8; + default: return 0; + } } -static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__tga_info(stbi__context* s, int* x, int* y, int* comp) { int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp; int sz, tga_colormap_type; stbi__get8(s); // discard Offset tga_colormap_type = stbi__get8(s); // colormap type - if( tga_colormap_type > 1 ) { + if (tga_colormap_type > 1) { stbi__rewind(s); return 0; // only RGB or indexed allowed } tga_image_type = stbi__get8(s); // image type - if ( tga_colormap_type == 1 ) { // colormapped (paletted) image + if (tga_colormap_type == 1) { // colormapped (paletted) image if (tga_image_type != 1 && tga_image_type != 9) { stbi__rewind(s); return 0; } - stbi__skip(s,4); // skip index of first colormap entry and number of entries + stbi__skip(s, 4); // skip index of first colormap entry and number of entries sz = stbi__get8(s); // check bits per palette color entry - if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) { + if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) { stbi__rewind(s); return 0; } - stbi__skip(s,4); // skip image x and y origin + stbi__skip(s, 4); // skip image x and y origin tga_colormap_bpp = sz; - } else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE - if ( (tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11) ) { + } + else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE + if ((tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11)) { stbi__rewind(s); return 0; // only RGB or grey allowed, +/- RLE } - stbi__skip(s,9); // skip colormap specification and image x/y origin + stbi__skip(s, 9); // skip colormap specification and image x/y origin tga_colormap_bpp = 0; } tga_w = stbi__get16le(s); - if( tga_w < 1 ) { + if (tga_w < 1) { stbi__rewind(s); return 0; // test width } tga_h = stbi__get16le(s); - if( tga_h < 1 ) { + if (tga_h < 1) { stbi__rewind(s); return 0; // test height } tga_bits_per_pixel = stbi__get8(s); // bits per pixel stbi__get8(s); // ignore alpha bits if (tga_colormap_bpp != 0) { - if((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) { + if ((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) { // when using a colormap, tga_bits_per_pixel is the size of the indexes // I don't think anything but 8 or 16bit indexes makes sense stbi__rewind(s); return 0; } tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL); - } else { + } + else { tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL); } - if(!tga_comp) { - stbi__rewind(s); - return 0; + if (!tga_comp) { + stbi__rewind(s); + return 0; } if (x) *x = tga_w; if (y) *y = tga_h; @@ -5739,260 +5812,267 @@ static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp) return 1; // seems to have passed everything } -static int stbi__tga_test(stbi__context *s) -{ - int res = 0; - int sz, tga_color_type; - stbi__get8(s); // discard Offset - tga_color_type = stbi__get8(s); // color type - if ( tga_color_type > 1 ) goto errorEnd; // only RGB or indexed allowed - sz = stbi__get8(s); // image type - if ( tga_color_type == 1 ) { // colormapped (paletted) image - if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9 - stbi__skip(s,4); // skip index of first colormap entry and number of entries - sz = stbi__get8(s); // check bits per palette color entry - if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; - stbi__skip(s,4); // skip image x and y origin - } else { // "normal" image w/o colormap - if ( (sz != 2) && (sz != 3) && (sz != 10) && (sz != 11) ) goto errorEnd; // only RGB or grey allowed, +/- RLE - stbi__skip(s,9); // skip colormap specification and image x/y origin - } - if ( stbi__get16le(s) < 1 ) goto errorEnd; // test width - if ( stbi__get16le(s) < 1 ) goto errorEnd; // test height - sz = stbi__get8(s); // bits per pixel - if ( (tga_color_type == 1) && (sz != 8) && (sz != 16) ) goto errorEnd; // for colormapped images, bpp is size of an index - if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; +static int stbi__tga_test(stbi__context* s) +{ + int res = 0; + int sz, tga_color_type; + stbi__get8(s); // discard Offset + tga_color_type = stbi__get8(s); // color type + if (tga_color_type > 1) goto errorEnd; // only RGB or indexed allowed + sz = stbi__get8(s); // image type + if (tga_color_type == 1) { // colormapped (paletted) image + if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9 + stbi__skip(s, 4); // skip index of first colormap entry and number of entries + sz = stbi__get8(s); // check bits per palette color entry + if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) goto errorEnd; + stbi__skip(s, 4); // skip image x and y origin + } + else { // "normal" image w/o colormap + if ((sz != 2) && (sz != 3) && (sz != 10) && (sz != 11)) goto errorEnd; // only RGB or grey allowed, +/- RLE + stbi__skip(s, 9); // skip colormap specification and image x/y origin + } + if (stbi__get16le(s) < 1) goto errorEnd; // test width + if (stbi__get16le(s) < 1) goto errorEnd; // test height + sz = stbi__get8(s); // bits per pixel + if ((tga_color_type == 1) && (sz != 8) && (sz != 16)) goto errorEnd; // for colormapped images, bpp is size of an index + if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) goto errorEnd; - res = 1; // if we got this far, everything's good and we can return 1 instead of 0 + res = 1; // if we got this far, everything's good and we can return 1 instead of 0 errorEnd: - stbi__rewind(s); - return res; + stbi__rewind(s); + return res; } // read 16bit value and convert to 24bit RGB -static void stbi__tga_read_rgb16(stbi__context *s, stbi_uc* out) -{ - stbi__uint16 px = (stbi__uint16)stbi__get16le(s); - stbi__uint16 fiveBitMask = 31; - // we have 3 channels with 5bits each - int r = (px >> 10) & fiveBitMask; - int g = (px >> 5) & fiveBitMask; - int b = px & fiveBitMask; - // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later - out[0] = (stbi_uc)((r * 255)/31); - out[1] = (stbi_uc)((g * 255)/31); - out[2] = (stbi_uc)((b * 255)/31); - - // some people claim that the most significant bit might be used for alpha - // (possibly if an alpha-bit is set in the "image descriptor byte") - // but that only made 16bit test images completely translucent.. - // so let's treat all 15 and 16bit TGAs as RGB with no alpha. -} - -static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) -{ - // read in the TGA header stuff - int tga_offset = stbi__get8(s); - int tga_indexed = stbi__get8(s); - int tga_image_type = stbi__get8(s); - int tga_is_RLE = 0; - int tga_palette_start = stbi__get16le(s); - int tga_palette_len = stbi__get16le(s); - int tga_palette_bits = stbi__get8(s); - int tga_x_origin = stbi__get16le(s); - int tga_y_origin = stbi__get16le(s); - int tga_width = stbi__get16le(s); - int tga_height = stbi__get16le(s); - int tga_bits_per_pixel = stbi__get8(s); - int tga_comp, tga_rgb16=0; - int tga_inverted = stbi__get8(s); - // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?) - // image data - unsigned char *tga_data; - unsigned char *tga_palette = NULL; - int i, j; - unsigned char raw_data[4] = {0}; - int RLE_count = 0; - int RLE_repeating = 0; - int read_next_pixel = 1; - STBI_NOTUSED(ri); - STBI_NOTUSED(tga_x_origin); // @TODO - STBI_NOTUSED(tga_y_origin); // @TODO - - if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - - // do a tiny bit of precessing - if ( tga_image_type >= 8 ) - { - tga_image_type -= 8; - tga_is_RLE = 1; - } - tga_inverted = 1 - ((tga_inverted >> 5) & 1); +static void stbi__tga_read_rgb16(stbi__context* s, stbi_uc* out) +{ + stbi__uint16 px = (stbi__uint16)stbi__get16le(s); + stbi__uint16 fiveBitMask = 31; + // we have 3 channels with 5bits each + int r = (px >> 10) & fiveBitMask; + int g = (px >> 5) & fiveBitMask; + int b = px & fiveBitMask; + // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later + out[0] = (stbi_uc)((r * 255) / 31); + out[1] = (stbi_uc)((g * 255) / 31); + out[2] = (stbi_uc)((b * 255) / 31); + + // some people claim that the most significant bit might be used for alpha + // (possibly if an alpha-bit is set in the "image descriptor byte") + // but that only made 16bit test images completely translucent.. + // so let's treat all 15 and 16bit TGAs as RGB with no alpha. +} + +static void* stbi__tga_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) +{ + // read in the TGA header stuff + int tga_offset = stbi__get8(s); + int tga_indexed = stbi__get8(s); + int tga_image_type = stbi__get8(s); + int tga_is_RLE = 0; + int tga_palette_start = stbi__get16le(s); + int tga_palette_len = stbi__get16le(s); + int tga_palette_bits = stbi__get8(s); + int tga_x_origin = stbi__get16le(s); + int tga_y_origin = stbi__get16le(s); + int tga_width = stbi__get16le(s); + int tga_height = stbi__get16le(s); + int tga_bits_per_pixel = stbi__get8(s); + int tga_comp, tga_rgb16 = 0; + int tga_inverted = stbi__get8(s); + // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?) + // image data + unsigned char* tga_data; + unsigned char* tga_palette = NULL; + int i, j; + unsigned char raw_data[4] = { 0 }; + int RLE_count = 0; + int RLE_repeating = 0; + int read_next_pixel = 1; + STBI_NOTUSED(ri); + STBI_NOTUSED(tga_x_origin); // @TODO + STBI_NOTUSED(tga_y_origin); // @TODO + + if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + + // do a tiny bit of precessing + if (tga_image_type >= 8) + { + tga_image_type -= 8; + tga_is_RLE = 1; + } + tga_inverted = 1 - ((tga_inverted >> 5) & 1); - // If I'm paletted, then I'll use the number of bits from the palette - if ( tga_indexed ) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16); - else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16); + // If I'm paletted, then I'll use the number of bits from the palette + if (tga_indexed) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16); + else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16); - if(!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency - return stbi__errpuc("bad format", "Can't find out TGA pixelformat"); + if (!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency + return stbi__errpuc("bad format", "Can't find out TGA pixelformat"); - // tga info - *x = tga_width; - *y = tga_height; - if (comp) *comp = tga_comp; + // tga info + *x = tga_width; + *y = tga_height; + if (comp) *comp = tga_comp; - if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0)) - return stbi__errpuc("too large", "Corrupt TGA"); + if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0)) + return stbi__errpuc("too large", "Corrupt TGA"); - tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0); - if (!tga_data) return stbi__errpuc("outofmem", "Out of memory"); + tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0); + if (!tga_data) return stbi__errpuc("outofmem", "Out of memory"); - // skip to the data's starting position (offset usually = 0) - stbi__skip(s, tga_offset ); + // skip to the data's starting position (offset usually = 0) + stbi__skip(s, tga_offset); - if ( !tga_indexed && !tga_is_RLE && !tga_rgb16 ) { - for (i=0; i < tga_height; ++i) { - int row = tga_inverted ? tga_height -i - 1 : i; - stbi_uc *tga_row = tga_data + row*tga_width*tga_comp; - stbi__getn(s, tga_row, tga_width * tga_comp); - } - } else { - // do I need to load a palette? - if ( tga_indexed) - { - if (tga_palette_len == 0) { /* you have to have at least one entry! */ - STBI_FREE(tga_data); - return stbi__errpuc("bad palette", "Corrupt TGA"); - } - - // any data to skip? (offset usually = 0) - stbi__skip(s, tga_palette_start ); - // load the palette - tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0); - if (!tga_palette) { - STBI_FREE(tga_data); - return stbi__errpuc("outofmem", "Out of memory"); - } - if (tga_rgb16) { - stbi_uc *pal_entry = tga_palette; - STBI_ASSERT(tga_comp == STBI_rgb); - for (i=0; i < tga_palette_len; ++i) { - stbi__tga_read_rgb16(s, pal_entry); - pal_entry += tga_comp; + if (!tga_indexed && !tga_is_RLE && !tga_rgb16) { + for (i = 0; i < tga_height; ++i) { + int row = tga_inverted ? tga_height - i - 1 : i; + stbi_uc* tga_row = tga_data + row * tga_width * tga_comp; + stbi__getn(s, tga_row, tga_width * tga_comp); + } + } + else { + // do I need to load a palette? + if (tga_indexed) + { + if (tga_palette_len == 0) { /* you have to have at least one entry! */ + STBI_FREE(tga_data); + return stbi__errpuc("bad palette", "Corrupt TGA"); } - } else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) { - STBI_FREE(tga_data); - STBI_FREE(tga_palette); - return stbi__errpuc("bad palette", "Corrupt TGA"); - } - } - // load the data - for (i=0; i < tga_width * tga_height; ++i) - { - // if I'm in RLE mode, do I need to get a RLE stbi__pngchunk? - if ( tga_is_RLE ) - { - if ( RLE_count == 0 ) - { - // yep, get the next byte as a RLE command - int RLE_cmd = stbi__get8(s); - RLE_count = 1 + (RLE_cmd & 127); - RLE_repeating = RLE_cmd >> 7; - read_next_pixel = 1; - } else if ( !RLE_repeating ) - { - read_next_pixel = 1; + + // any data to skip? (offset usually = 0) + stbi__skip(s, tga_palette_start); + // load the palette + tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0); + if (!tga_palette) { + STBI_FREE(tga_data); + return stbi__errpuc("outofmem", "Out of memory"); + } + if (tga_rgb16) { + stbi_uc* pal_entry = tga_palette; + STBI_ASSERT(tga_comp == STBI_rgb); + for (i = 0; i < tga_palette_len; ++i) { + stbi__tga_read_rgb16(s, pal_entry); + pal_entry += tga_comp; + } } - } else - { - read_next_pixel = 1; - } - // OK, if I need to read a pixel, do it now - if ( read_next_pixel ) - { - // load however much data we did have - if ( tga_indexed ) + else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) { + STBI_FREE(tga_data); + STBI_FREE(tga_palette); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + } + // load the data + for (i = 0; i < tga_width * tga_height; ++i) + { + // if I'm in RLE mode, do I need to get a RLE stbi__pngchunk? + if (tga_is_RLE) { - // read in index, then perform the lookup - int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s); - if ( pal_idx >= tga_palette_len ) { - // invalid index - pal_idx = 0; - } - pal_idx *= tga_comp; - for (j = 0; j < tga_comp; ++j) { - raw_data[j] = tga_palette[pal_idx+j]; - } - } else if(tga_rgb16) { - STBI_ASSERT(tga_comp == STBI_rgb); - stbi__tga_read_rgb16(s, raw_data); - } else { - // read in the data raw - for (j = 0; j < tga_comp; ++j) { - raw_data[j] = stbi__get8(s); - } + if (RLE_count == 0) + { + // yep, get the next byte as a RLE command + int RLE_cmd = stbi__get8(s); + RLE_count = 1 + (RLE_cmd & 127); + RLE_repeating = RLE_cmd >> 7; + read_next_pixel = 1; + } + else if (!RLE_repeating) + { + read_next_pixel = 1; + } } - // clear the reading flag for the next pixel - read_next_pixel = 0; - } // end of reading a pixel - - // copy data - for (j = 0; j < tga_comp; ++j) - tga_data[i*tga_comp+j] = raw_data[j]; - - // in case we're in RLE mode, keep counting down - --RLE_count; - } - // do I need to invert the image? - if ( tga_inverted ) - { - for (j = 0; j*2 < tga_height; ++j) - { - int index1 = j * tga_width * tga_comp; - int index2 = (tga_height - 1 - j) * tga_width * tga_comp; - for (i = tga_width * tga_comp; i > 0; --i) + else + { + read_next_pixel = 1; + } + // OK, if I need to read a pixel, do it now + if (read_next_pixel) + { + // load however much data we did have + if (tga_indexed) + { + // read in index, then perform the lookup + int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s); + if (pal_idx >= tga_palette_len) { + // invalid index + pal_idx = 0; + } + pal_idx *= tga_comp; + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = tga_palette[pal_idx + j]; + } + } + else if (tga_rgb16) { + STBI_ASSERT(tga_comp == STBI_rgb); + stbi__tga_read_rgb16(s, raw_data); + } + else { + // read in the data raw + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = stbi__get8(s); + } + } + // clear the reading flag for the next pixel + read_next_pixel = 0; + } // end of reading a pixel + + // copy data + for (j = 0; j < tga_comp; ++j) + tga_data[i * tga_comp + j] = raw_data[j]; + + // in case we're in RLE mode, keep counting down + --RLE_count; + } + // do I need to invert the image? + if (tga_inverted) + { + for (j = 0; j * 2 < tga_height; ++j) { - unsigned char temp = tga_data[index1]; - tga_data[index1] = tga_data[index2]; - tga_data[index2] = temp; - ++index1; - ++index2; + int index1 = j * tga_width * tga_comp; + int index2 = (tga_height - 1 - j) * tga_width * tga_comp; + for (i = tga_width * tga_comp; i > 0; --i) + { + unsigned char temp = tga_data[index1]; + tga_data[index1] = tga_data[index2]; + tga_data[index2] = temp; + ++index1; + ++index2; + } } - } - } - // clear my palette, if I had one - if ( tga_palette != NULL ) - { - STBI_FREE( tga_palette ); - } - } + } + // clear my palette, if I had one + if (tga_palette != NULL) + { + STBI_FREE(tga_palette); + } + } - // swap RGB - if the source data was RGB16, it already is in the right order - if (tga_comp >= 3 && !tga_rgb16) - { - unsigned char* tga_pixel = tga_data; - for (i=0; i < tga_width * tga_height; ++i) - { - unsigned char temp = tga_pixel[0]; - tga_pixel[0] = tga_pixel[2]; - tga_pixel[2] = temp; - tga_pixel += tga_comp; - } - } + // swap RGB - if the source data was RGB16, it already is in the right order + if (tga_comp >= 3 && !tga_rgb16) + { + unsigned char* tga_pixel = tga_data; + for (i = 0; i < tga_width * tga_height; ++i) + { + unsigned char temp = tga_pixel[0]; + tga_pixel[0] = tga_pixel[2]; + tga_pixel[2] = temp; + tga_pixel += tga_comp; + } + } - // convert to target component count - if (req_comp && req_comp != tga_comp) - tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height); + // convert to target component count + if (req_comp && req_comp != tga_comp) + tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height); - // the things I do to get rid of an error message, and yet keep - // Microsoft's C compilers happy... [8^( - tga_palette_start = tga_palette_len = tga_palette_bits = - tga_x_origin = tga_y_origin = 0; - STBI_NOTUSED(tga_palette_start); - // OK, done - return tga_data; + // the things I do to get rid of an error message, and yet keep + // Microsoft's C compilers happy... [8^( + tga_palette_start = tga_palette_len = tga_palette_bits = + tga_x_origin = tga_y_origin = 0; + STBI_NOTUSED(tga_palette_start); + // OK, done + return tga_data; } #endif @@ -6000,250 +6080,260 @@ static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req // Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB #ifndef STBI_NO_PSD -static int stbi__psd_test(stbi__context *s) +static int stbi__psd_test(stbi__context* s) { - int r = (stbi__get32be(s) == 0x38425053); - stbi__rewind(s); - return r; + int r = (stbi__get32be(s) == 0x38425053); + stbi__rewind(s); + return r; } -static int stbi__psd_decode_rle(stbi__context *s, stbi_uc *p, int pixelCount) +static int stbi__psd_decode_rle(stbi__context* s, stbi_uc* p, int pixelCount) { - int count, nleft, len; + int count, nleft, len; - count = 0; - while ((nleft = pixelCount - count) > 0) { - len = stbi__get8(s); - if (len == 128) { - // No-op. - } else if (len < 128) { - // Copy next len+1 bytes literally. - len++; - if (len > nleft) return 0; // corrupt data - count += len; - while (len) { - *p = stbi__get8(s); - p += 4; - len--; - } - } else if (len > 128) { - stbi_uc val; - // Next -len+1 bytes in the dest are replicated from next source byte. - // (Interpret len as a negative 8-bit int.) - len = 257 - len; - if (len > nleft) return 0; // corrupt data - val = stbi__get8(s); - count += len; - while (len) { - *p = val; - p += 4; - len--; - } - } - } + count = 0; + while ((nleft = pixelCount - count) > 0) { + len = stbi__get8(s); + if (len == 128) { + // No-op. + } + else if (len < 128) { + // Copy next len+1 bytes literally. + len++; + if (len > nleft) return 0; // corrupt data + count += len; + while (len) { + *p = stbi__get8(s); + p += 4; + len--; + } + } + else if (len > 128) { + stbi_uc val; + // Next -len+1 bytes in the dest are replicated from next source byte. + // (Interpret len as a negative 8-bit int.) + len = 257 - len; + if (len > nleft) return 0; // corrupt data + val = stbi__get8(s); + count += len; + while (len) { + *p = val; + p += 4; + len--; + } + } + } - return 1; -} - -static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) -{ - int pixelCount; - int channelCount, compression; - int channel, i; - int bitdepth; - int w,h; - stbi_uc *out; - STBI_NOTUSED(ri); - - // Check identifier - if (stbi__get32be(s) != 0x38425053) // "8BPS" - return stbi__errpuc("not PSD", "Corrupt PSD image"); - - // Check file type version. - if (stbi__get16be(s) != 1) - return stbi__errpuc("wrong version", "Unsupported version of PSD image"); - - // Skip 6 reserved bytes. - stbi__skip(s, 6 ); - - // Read the number of channels (R, G, B, A, etc). - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) - return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image"); - - // Read the rows and columns of the image. - h = stbi__get32be(s); - w = stbi__get32be(s); - - if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - - // Make sure the depth is 8 bits. - bitdepth = stbi__get16be(s); - if (bitdepth != 8 && bitdepth != 16) - return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit"); - - // Make sure the color mode is RGB. - // Valid options are: - // 0: Bitmap - // 1: Grayscale - // 2: Indexed color - // 3: RGB color - // 4: CMYK color - // 7: Multichannel - // 8: Duotone - // 9: Lab color - if (stbi__get16be(s) != 3) - return stbi__errpuc("wrong color format", "PSD is not in RGB color format"); - - // Skip the Mode Data. (It's the palette for indexed color; other info for other modes.) - stbi__skip(s,stbi__get32be(s) ); - - // Skip the image resources. (resolution, pen tool paths, etc) - stbi__skip(s, stbi__get32be(s) ); - - // Skip the reserved data. - stbi__skip(s, stbi__get32be(s) ); - - // Find out if the data is compressed. - // Known values: - // 0: no compression - // 1: RLE compressed - compression = stbi__get16be(s); - if (compression > 1) - return stbi__errpuc("bad compression", "PSD has an unknown compression format"); - - // Check size - if (!stbi__mad3sizes_valid(4, w, h, 0)) - return stbi__errpuc("too large", "Corrupt PSD"); - - // Create the destination image. - - if (!compression && bitdepth == 16 && bpc == 16) { - out = (stbi_uc *) stbi__malloc_mad3(8, w, h, 0); - ri->bits_per_channel = 16; - } else - out = (stbi_uc *) stbi__malloc(4 * w*h); - - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - pixelCount = w*h; - - // Initialize the data to zero. - //memset( out, 0, pixelCount * 4 ); - - // Finally, the image data. - if (compression) { - // RLE as used by .PSD and .TIFF - // Loop until you get the number of unpacked bytes you are expecting: - // Read the next source byte into n. - // If n is between 0 and 127 inclusive, copy the next n+1 bytes literally. - // Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times. - // Else if n is 128, noop. - // Endloop - - // The RLE-compressed data is preceded by a 2-byte data count for each row in the data, - // which we're going to just skip. - stbi__skip(s, h * channelCount * 2 ); - - // Read the RLE data by channel. - for (channel = 0; channel < 4; channel++) { - stbi_uc *p; - - p = out+channel; - if (channel >= channelCount) { - // Fill this channel with default data. - for (i = 0; i < pixelCount; i++, p += 4) - *p = (channel == 3 ? 255 : 0); - } else { - // Read the RLE data. - if (!stbi__psd_decode_rle(s, p, pixelCount)) { - STBI_FREE(out); - return stbi__errpuc("corrupt", "bad RLE data"); + return 1; +} + +static void* stbi__psd_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc) +{ + int pixelCount; + int channelCount, compression; + int channel, i; + int bitdepth; + int w, h; + stbi_uc* out; + STBI_NOTUSED(ri); + + // Check identifier + if (stbi__get32be(s) != 0x38425053) // "8BPS" + return stbi__errpuc("not PSD", "Corrupt PSD image"); + + // Check file type version. + if (stbi__get16be(s) != 1) + return stbi__errpuc("wrong version", "Unsupported version of PSD image"); + + // Skip 6 reserved bytes. + stbi__skip(s, 6); + + // Read the number of channels (R, G, B, A, etc). + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) + return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image"); + + // Read the rows and columns of the image. + h = stbi__get32be(s); + w = stbi__get32be(s); + + if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + + // Make sure the depth is 8 bits. + bitdepth = stbi__get16be(s); + if (bitdepth != 8 && bitdepth != 16) + return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit"); + + // Make sure the color mode is RGB. + // Valid options are: + // 0: Bitmap + // 1: Grayscale + // 2: Indexed color + // 3: RGB color + // 4: CMYK color + // 7: Multichannel + // 8: Duotone + // 9: Lab color + if (stbi__get16be(s) != 3) + return stbi__errpuc("wrong color format", "PSD is not in RGB color format"); + + // Skip the Mode Data. (It's the palette for indexed color; other info for other modes.) + stbi__skip(s, stbi__get32be(s)); + + // Skip the image resources. (resolution, pen tool paths, etc) + stbi__skip(s, stbi__get32be(s)); + + // Skip the reserved data. + stbi__skip(s, stbi__get32be(s)); + + // Find out if the data is compressed. + // Known values: + // 0: no compression + // 1: RLE compressed + compression = stbi__get16be(s); + if (compression > 1) + return stbi__errpuc("bad compression", "PSD has an unknown compression format"); + + // Check size + if (!stbi__mad3sizes_valid(4, w, h, 0)) + return stbi__errpuc("too large", "Corrupt PSD"); + + // Create the destination image. + + if (!compression && bitdepth == 16 && bpc == 16) { + out = (stbi_uc*)stbi__malloc_mad3(8, w, h, 0); + ri->bits_per_channel = 16; + } + else + out = (stbi_uc*)stbi__malloc(4 * w * h); + + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + pixelCount = w * h; + + // Initialize the data to zero. + //memset( out, 0, pixelCount * 4 ); + + // Finally, the image data. + if (compression) { + // RLE as used by .PSD and .TIFF + // Loop until you get the number of unpacked bytes you are expecting: + // Read the next source byte into n. + // If n is between 0 and 127 inclusive, copy the next n+1 bytes literally. + // Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times. + // Else if n is 128, noop. + // Endloop + + // The RLE-compressed data is preceded by a 2-byte data count for each row in the data, + // which we're going to just skip. + stbi__skip(s, h * channelCount * 2); + + // Read the RLE data by channel. + for (channel = 0; channel < 4; channel++) { + stbi_uc* p; + + p = out + channel; + if (channel >= channelCount) { + // Fill this channel with default data. + for (i = 0; i < pixelCount; i++, p += 4) + *p = (channel == 3 ? 255 : 0); } - } - } + else { + // Read the RLE data. + if (!stbi__psd_decode_rle(s, p, pixelCount)) { + STBI_FREE(out); + return stbi__errpuc("corrupt", "bad RLE data"); + } + } + } - } else { - // We're at the raw image data. It's each channel in order (Red, Green, Blue, Alpha, ...) - // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image. - - // Read the data by channel. - for (channel = 0; channel < 4; channel++) { - if (channel >= channelCount) { - // Fill this channel with default data. - if (bitdepth == 16 && bpc == 16) { - stbi__uint16 *q = ((stbi__uint16 *) out) + channel; - stbi__uint16 val = channel == 3 ? 65535 : 0; - for (i = 0; i < pixelCount; i++, q += 4) - *q = val; - } else { - stbi_uc *p = out+channel; - stbi_uc val = channel == 3 ? 255 : 0; - for (i = 0; i < pixelCount; i++, p += 4) - *p = val; + } + else { + // We're at the raw image data. It's each channel in order (Red, Green, Blue, Alpha, ...) + // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image. + + // Read the data by channel. + for (channel = 0; channel < 4; channel++) { + if (channel >= channelCount) { + // Fill this channel with default data. + if (bitdepth == 16 && bpc == 16) { + stbi__uint16* q = ((stbi__uint16*)out) + channel; + stbi__uint16 val = channel == 3 ? 65535 : 0; + for (i = 0; i < pixelCount; i++, q += 4) + *q = val; + } + else { + stbi_uc* p = out + channel; + stbi_uc val = channel == 3 ? 255 : 0; + for (i = 0; i < pixelCount; i++, p += 4) + *p = val; + } } - } else { - if (ri->bits_per_channel == 16) { // output bpc - stbi__uint16 *q = ((stbi__uint16 *) out) + channel; - for (i = 0; i < pixelCount; i++, q += 4) - *q = (stbi__uint16) stbi__get16be(s); - } else { - stbi_uc *p = out+channel; - if (bitdepth == 16) { // input bpc - for (i = 0; i < pixelCount; i++, p += 4) - *p = (stbi_uc) (stbi__get16be(s) >> 8); - } else { - for (i = 0; i < pixelCount; i++, p += 4) - *p = stbi__get8(s); - } + else { + if (ri->bits_per_channel == 16) { // output bpc + stbi__uint16* q = ((stbi__uint16*)out) + channel; + for (i = 0; i < pixelCount; i++, q += 4) + *q = (stbi__uint16)stbi__get16be(s); + } + else { + stbi_uc* p = out + channel; + if (bitdepth == 16) { // input bpc + for (i = 0; i < pixelCount; i++, p += 4) + *p = (stbi_uc)(stbi__get16be(s) >> 8); + } + else { + for (i = 0; i < pixelCount; i++, p += 4) + *p = stbi__get8(s); + } + } } - } - } - } + } + } - // remove weird white matte from PSD - if (channelCount >= 4) { - if (ri->bits_per_channel == 16) { - for (i=0; i < w*h; ++i) { - stbi__uint16 *pixel = (stbi__uint16 *) out + 4*i; - if (pixel[3] != 0 && pixel[3] != 65535) { - float a = pixel[3] / 65535.0f; - float ra = 1.0f / a; - float inv_a = 65535.0f * (1 - ra); - pixel[0] = (stbi__uint16) (pixel[0]*ra + inv_a); - pixel[1] = (stbi__uint16) (pixel[1]*ra + inv_a); - pixel[2] = (stbi__uint16) (pixel[2]*ra + inv_a); + // remove weird white matte from PSD + if (channelCount >= 4) { + if (ri->bits_per_channel == 16) { + for (i = 0; i < w * h; ++i) { + stbi__uint16* pixel = (stbi__uint16*)out + 4 * i; + if (pixel[3] != 0 && pixel[3] != 65535) { + float a = pixel[3] / 65535.0f; + float ra = 1.0f / a; + float inv_a = 65535.0f * (1 - ra); + pixel[0] = (stbi__uint16)(pixel[0] * ra + inv_a); + pixel[1] = (stbi__uint16)(pixel[1] * ra + inv_a); + pixel[2] = (stbi__uint16)(pixel[2] * ra + inv_a); + } } - } - } else { - for (i=0; i < w*h; ++i) { - unsigned char *pixel = out + 4*i; - if (pixel[3] != 0 && pixel[3] != 255) { - float a = pixel[3] / 255.0f; - float ra = 1.0f / a; - float inv_a = 255.0f * (1 - ra); - pixel[0] = (unsigned char) (pixel[0]*ra + inv_a); - pixel[1] = (unsigned char) (pixel[1]*ra + inv_a); - pixel[2] = (unsigned char) (pixel[2]*ra + inv_a); + } + else { + for (i = 0; i < w * h; ++i) { + unsigned char* pixel = out + 4 * i; + if (pixel[3] != 0 && pixel[3] != 255) { + float a = pixel[3] / 255.0f; + float ra = 1.0f / a; + float inv_a = 255.0f * (1 - ra); + pixel[0] = (unsigned char)(pixel[0] * ra + inv_a); + pixel[1] = (unsigned char)(pixel[1] * ra + inv_a); + pixel[2] = (unsigned char)(pixel[2] * ra + inv_a); + } } - } - } - } + } + } - // convert to desired output format - if (req_comp && req_comp != 4) { - if (ri->bits_per_channel == 16) - out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, 4, req_comp, w, h); - else - out = stbi__convert_format(out, 4, req_comp, w, h); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } + // convert to desired output format + if (req_comp && req_comp != 4) { + if (ri->bits_per_channel == 16) + out = (stbi_uc*)stbi__convert_format16((stbi__uint16*)out, 4, req_comp, w, h); + else + out = stbi__convert_format(out, 4, req_comp, w, h); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } - if (comp) *comp = 4; - *y = h; - *x = w; + if (comp) *comp = 4; + *y = h; + *x = w; - return out; + return out; } #endif @@ -6255,216 +6345,217 @@ static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req // See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/ #ifndef STBI_NO_PIC -static int stbi__pic_is4(stbi__context *s,const char *str) +static int stbi__pic_is4(stbi__context* s, const char* str) { - int i; - for (i=0; i<4; ++i) - if (stbi__get8(s) != (stbi_uc)str[i]) - return 0; + int i; + for (i = 0; i < 4; ++i) + if (stbi__get8(s) != (stbi_uc)str[i]) + return 0; - return 1; + return 1; } -static int stbi__pic_test_core(stbi__context *s) +static int stbi__pic_test_core(stbi__context* s) { - int i; + int i; - if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) - return 0; + if (!stbi__pic_is4(s, "\x53\x80\xF6\x34")) + return 0; - for(i=0;i<84;++i) - stbi__get8(s); + for (i = 0; i < 84; ++i) + stbi__get8(s); - if (!stbi__pic_is4(s,"PICT")) - return 0; + if (!stbi__pic_is4(s, "PICT")) + return 0; - return 1; + return 1; } typedef struct { - stbi_uc size,type,channel; + stbi_uc size, type, channel; } stbi__pic_packet; -static stbi_uc *stbi__readval(stbi__context *s, int channel, stbi_uc *dest) +static stbi_uc* stbi__readval(stbi__context* s, int channel, stbi_uc* dest) { - int mask=0x80, i; + int mask = 0x80, i; - for (i=0; i<4; ++i, mask>>=1) { - if (channel & mask) { - if (stbi__at_eof(s)) return stbi__errpuc("bad file","PIC file too short"); - dest[i]=stbi__get8(s); - } - } + for (i = 0; i < 4; ++i, mask >>= 1) { + if (channel & mask) { + if (stbi__at_eof(s)) return stbi__errpuc("bad file", "PIC file too short"); + dest[i] = stbi__get8(s); + } + } - return dest; + return dest; } -static void stbi__copyval(int channel,stbi_uc *dest,const stbi_uc *src) +static void stbi__copyval(int channel, stbi_uc* dest, const stbi_uc* src) { - int mask=0x80,i; + int mask = 0x80, i; - for (i=0;i<4; ++i, mask>>=1) - if (channel&mask) - dest[i]=src[i]; + for (i = 0; i < 4; ++i, mask >>= 1) + if (channel & mask) + dest[i] = src[i]; } -static stbi_uc *stbi__pic_load_core(stbi__context *s,int width,int height,int *comp, stbi_uc *result) +static stbi_uc* stbi__pic_load_core(stbi__context* s, int width, int height, int* comp, stbi_uc* result) { - int act_comp=0,num_packets=0,y,chained; - stbi__pic_packet packets[10]; + int act_comp = 0, num_packets = 0, y, chained; + stbi__pic_packet packets[10]; - // this will (should...) cater for even some bizarre stuff like having data - // for the same channel in multiple packets. - do { - stbi__pic_packet *packet; + // this will (should...) cater for even some bizarre stuff like having data + // for the same channel in multiple packets. + do { + stbi__pic_packet* packet; - if (num_packets==sizeof(packets)/sizeof(packets[0])) - return stbi__errpuc("bad format","too many packets"); + if (num_packets == sizeof(packets) / sizeof(packets[0])) + return stbi__errpuc("bad format", "too many packets"); - packet = &packets[num_packets++]; + packet = &packets[num_packets++]; - chained = stbi__get8(s); - packet->size = stbi__get8(s); - packet->type = stbi__get8(s); - packet->channel = stbi__get8(s); + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); - act_comp |= packet->channel; + act_comp |= packet->channel; - if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (reading packets)"); - if (packet->size != 8) return stbi__errpuc("bad format","packet isn't 8bpp"); - } while (chained); + if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (reading packets)"); + if (packet->size != 8) return stbi__errpuc("bad format", "packet isn't 8bpp"); + } while (chained); - *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel? + *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel? - for(y=0; ytype) { + switch (packet->type) { default: - return stbi__errpuc("bad format","packet has bad compression type"); + return stbi__errpuc("bad format", "packet has bad compression type"); case 0: {//uncompressed - int x; + int x; - for(x=0;xchannel,dest)) - return 0; - break; + for (x = 0; x < width; ++x, dest += 4) + if (!stbi__readval(s, packet->channel, dest)) + return 0; + break; } case 1://Pure RLE - { - int left=width, i; + { + int left = width, i; - while (left>0) { - stbi_uc count,value[4]; + while (left > 0) { + stbi_uc count, value[4]; - count=stbi__get8(s); - if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pure read count)"); + count = stbi__get8(s); + if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (pure read count)"); - if (count > left) - count = (stbi_uc) left; + if (count > left) + count = (stbi_uc)left; - if (!stbi__readval(s,packet->channel,value)) return 0; + if (!stbi__readval(s, packet->channel, value)) return 0; - for(i=0; ichannel,dest,value); - left -= count; - } - } - break; + for (i = 0; i < count; ++i, dest += 4) + stbi__copyval(packet->channel, dest, value); + left -= count; + } + } + break; case 2: {//Mixed RLE - int left=width; - while (left>0) { - int count = stbi__get8(s), i; - if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (mixed read count)"); - - if (count >= 128) { // Repeated - stbi_uc value[4]; - - if (count==128) - count = stbi__get16be(s); - else - count -= 127; - if (count > left) - return stbi__errpuc("bad file","scanline overrun"); - - if (!stbi__readval(s,packet->channel,value)) - return 0; + int left = width; + while (left > 0) { + int count = stbi__get8(s), i; + if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (mixed read count)"); + + if (count >= 128) { // Repeated + stbi_uc value[4]; - for(i=0;ichannel,dest,value); - } else { // Raw - ++count; - if (count>left) return stbi__errpuc("bad file","scanline overrun"); - - for(i=0;ichannel,dest)) - return 0; - } - left-=count; - } - break; + if (count == 128) + count = stbi__get16be(s); + else + count -= 127; + if (count > left) + return stbi__errpuc("bad file", "scanline overrun"); + + if (!stbi__readval(s, packet->channel, value)) + return 0; + + for (i = 0; i < count; ++i, dest += 4) + stbi__copyval(packet->channel, dest, value); + } + else { // Raw + ++count; + if (count > left) return stbi__errpuc("bad file", "scanline overrun"); + + for (i = 0; i < count; ++i, dest += 4) + if (!stbi__readval(s, packet->channel, dest)) + return 0; + } + left -= count; + } + break; } - } - } - } + } + } + } - return result; + return result; } -static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_comp, stbi__result_info *ri) +static void* stbi__pic_load(stbi__context* s, int* px, int* py, int* comp, int req_comp, stbi__result_info* ri) { - stbi_uc *result; - int i, x,y, internal_comp; - STBI_NOTUSED(ri); + stbi_uc* result; + int i, x, y, internal_comp; + STBI_NOTUSED(ri); - if (!comp) comp = &internal_comp; + if (!comp) comp = &internal_comp; - for (i=0; i<92; ++i) - stbi__get8(s); + for (i = 0; i < 92; ++i) + stbi__get8(s); - x = stbi__get16be(s); - y = stbi__get16be(s); + x = stbi__get16be(s); + y = stbi__get16be(s); - if (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pic header)"); - if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode"); + if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (pic header)"); + if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode"); - stbi__get32be(s); //skip `ratio' - stbi__get16be(s); //skip `fields' - stbi__get16be(s); //skip `pad' + stbi__get32be(s); //skip `ratio' + stbi__get16be(s); //skip `fields' + stbi__get16be(s); //skip `pad' - // intermediate buffer is RGBA - result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0); - if (!result) return stbi__errpuc("outofmem", "Out of memory"); - memset(result, 0xff, x*y*4); + // intermediate buffer is RGBA + result = (stbi_uc*)stbi__malloc_mad3(x, y, 4, 0); + if (!result) return stbi__errpuc("outofmem", "Out of memory"); + memset(result, 0xff, x * y * 4); - if (!stbi__pic_load_core(s,x,y,comp, result)) { - STBI_FREE(result); - result=0; - } - *px = x; - *py = y; - if (req_comp == 0) req_comp = *comp; - result=stbi__convert_format(result,4,req_comp,x,y); + if (!stbi__pic_load_core(s, x, y, comp, result)) { + STBI_FREE(result); + result = 0; + } + *px = x; + *py = y; + if (req_comp == 0) req_comp = *comp; + result = stbi__convert_format(result, 4, req_comp, x, y); - return result; + return result; } -static int stbi__pic_test(stbi__context *s) +static int stbi__pic_test(stbi__context* s) { - int r = stbi__pic_test_core(s); - stbi__rewind(s); - return r; + int r = stbi__pic_test_core(s); + stbi__rewind(s); + return r; } #endif @@ -6474,340 +6565,351 @@ static int stbi__pic_test(stbi__context *s) #ifndef STBI_NO_GIF typedef struct { - stbi__int16 prefix; - stbi_uc first; - stbi_uc suffix; + stbi__int16 prefix; + stbi_uc first; + stbi_uc suffix; } stbi__gif_lzw; typedef struct { - int w,h; - stbi_uc *out; // output buffer (always 4 components) - stbi_uc *background; // The current "background" as far as a gif is concerned - stbi_uc *history; - int flags, bgindex, ratio, transparent, eflags; - stbi_uc pal[256][4]; - stbi_uc lpal[256][4]; - stbi__gif_lzw codes[8192]; - stbi_uc *color_table; - int parse, step; - int lflags; - int start_x, start_y; - int max_x, max_y; - int cur_x, cur_y; - int line_size; - int delay; + int w, h; + stbi_uc* out; // output buffer (always 4 components) + stbi_uc* background; // The current "background" as far as a gif is concerned + stbi_uc* history; + int flags, bgindex, ratio, transparent, eflags; + stbi_uc pal[256][4]; + stbi_uc lpal[256][4]; + stbi__gif_lzw codes[8192]; + stbi_uc* color_table; + int parse, step; + int lflags; + int start_x, start_y; + int max_x, max_y; + int cur_x, cur_y; + int line_size; + int delay; } stbi__gif; -static int stbi__gif_test_raw(stbi__context *s) +static int stbi__gif_test_raw(stbi__context* s) { - int sz; - if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0; - sz = stbi__get8(s); - if (sz != '9' && sz != '7') return 0; - if (stbi__get8(s) != 'a') return 0; - return 1; + int sz; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0; + sz = stbi__get8(s); + if (sz != '9' && sz != '7') return 0; + if (stbi__get8(s) != 'a') return 0; + return 1; } -static int stbi__gif_test(stbi__context *s) +static int stbi__gif_test(stbi__context* s) { - int r = stbi__gif_test_raw(s); - stbi__rewind(s); - return r; + int r = stbi__gif_test_raw(s); + stbi__rewind(s); + return r; } -static void stbi__gif_parse_colortable(stbi__context *s, stbi_uc pal[256][4], int num_entries, int transp) +static void stbi__gif_parse_colortable(stbi__context* s, stbi_uc pal[256][4], int num_entries, int transp) { - int i; - for (i=0; i < num_entries; ++i) { - pal[i][2] = stbi__get8(s); - pal[i][1] = stbi__get8(s); - pal[i][0] = stbi__get8(s); - pal[i][3] = transp == i ? 0 : 255; - } + int i; + for (i = 0; i < num_entries; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + pal[i][3] = transp == i ? 0 : 255; + } } -static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_info) +static int stbi__gif_header(stbi__context* s, stbi__gif* g, int* comp, int is_info) { - stbi_uc version; - if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') - return stbi__err("not GIF", "Corrupt GIF"); + stbi_uc version; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') + return stbi__err("not GIF", "Corrupt GIF"); - version = stbi__get8(s); - if (version != '7' && version != '9') return stbi__err("not GIF", "Corrupt GIF"); - if (stbi__get8(s) != 'a') return stbi__err("not GIF", "Corrupt GIF"); + version = stbi__get8(s); + if (version != '7' && version != '9') return stbi__err("not GIF", "Corrupt GIF"); + if (stbi__get8(s) != 'a') return stbi__err("not GIF", "Corrupt GIF"); - stbi__g_failure_reason = ""; - g->w = stbi__get16le(s); - g->h = stbi__get16le(s); - g->flags = stbi__get8(s); - g->bgindex = stbi__get8(s); - g->ratio = stbi__get8(s); - g->transparent = -1; + stbi__g_failure_reason = ""; + g->w = stbi__get16le(s); + g->h = stbi__get16le(s); + g->flags = stbi__get8(s); + g->bgindex = stbi__get8(s); + g->ratio = stbi__get8(s); + g->transparent = -1; - if (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); - if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); + if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - if (comp != 0) *comp = 4; // can't actually tell whether it's 3 or 4 until we parse the comments + if (comp != 0) *comp = 4; // can't actually tell whether it's 3 or 4 until we parse the comments - if (is_info) return 1; + if (is_info) return 1; - if (g->flags & 0x80) - stbi__gif_parse_colortable(s,g->pal, 2 << (g->flags & 7), -1); + if (g->flags & 0x80) + stbi__gif_parse_colortable(s, g->pal, 2 << (g->flags & 7), -1); - return 1; + return 1; } -static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp) +static int stbi__gif_info_raw(stbi__context* s, int* x, int* y, int* comp) { - stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif)); - if (!g) return stbi__err("outofmem", "Out of memory"); - if (!stbi__gif_header(s, g, comp, 1)) { - STBI_FREE(g); - stbi__rewind( s ); - return 0; - } - if (x) *x = g->w; - if (y) *y = g->h; - STBI_FREE(g); - return 1; + stbi__gif* g = (stbi__gif*)stbi__malloc(sizeof(stbi__gif)); + if (!g) return stbi__err("outofmem", "Out of memory"); + if (!stbi__gif_header(s, g, comp, 1)) { + STBI_FREE(g); + stbi__rewind(s); + return 0; + } + if (x) *x = g->w; + if (y) *y = g->h; + STBI_FREE(g); + return 1; } -static void stbi__out_gif_code(stbi__gif *g, stbi__uint16 code) +static void stbi__out_gif_code(stbi__gif* g, stbi__uint16 code) { - stbi_uc *p, *c; - int idx; + stbi_uc* p, * c; + int idx; - // recurse to decode the prefixes, since the linked-list is backwards, - // and working backwards through an interleaved image would be nasty - if (g->codes[code].prefix >= 0) - stbi__out_gif_code(g, g->codes[code].prefix); + // recurse to decode the prefixes, since the linked-list is backwards, + // and working backwards through an interleaved image would be nasty + if (g->codes[code].prefix >= 0) + stbi__out_gif_code(g, g->codes[code].prefix); - if (g->cur_y >= g->max_y) return; + if (g->cur_y >= g->max_y) return; - idx = g->cur_x + g->cur_y; - p = &g->out[idx]; - g->history[idx / 4] = 1; + idx = g->cur_x + g->cur_y; + p = &g->out[idx]; + g->history[idx / 4] = 1; - c = &g->color_table[g->codes[code].suffix * 4]; - if (c[3] > 128) { // don't render transparent pixels; - p[0] = c[2]; - p[1] = c[1]; - p[2] = c[0]; - p[3] = c[3]; - } - g->cur_x += 4; + c = &g->color_table[g->codes[code].suffix * 4]; + if (c[3] > 128) { // don't render transparent pixels; + p[0] = c[2]; + p[1] = c[1]; + p[2] = c[0]; + p[3] = c[3]; + } + g->cur_x += 4; - if (g->cur_x >= g->max_x) { - g->cur_x = g->start_x; - g->cur_y += g->step; + if (g->cur_x >= g->max_x) { + g->cur_x = g->start_x; + g->cur_y += g->step; - while (g->cur_y >= g->max_y && g->parse > 0) { - g->step = (1 << g->parse) * g->line_size; - g->cur_y = g->start_y + (g->step >> 1); - --g->parse; - } - } + while (g->cur_y >= g->max_y && g->parse > 0) { + g->step = (1 << g->parse) * g->line_size; + g->cur_y = g->start_y + (g->step >> 1); + --g->parse; + } + } } -static stbi_uc *stbi__process_gif_raster(stbi__context *s, stbi__gif *g) -{ - stbi_uc lzw_cs; - stbi__int32 len, init_code; - stbi__uint32 first; - stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear; - stbi__gif_lzw *p; - - lzw_cs = stbi__get8(s); - if (lzw_cs > 12) return NULL; - clear = 1 << lzw_cs; - first = 1; - codesize = lzw_cs + 1; - codemask = (1 << codesize) - 1; - bits = 0; - valid_bits = 0; - for (init_code = 0; init_code < clear; init_code++) { - g->codes[init_code].prefix = -1; - g->codes[init_code].first = (stbi_uc) init_code; - g->codes[init_code].suffix = (stbi_uc) init_code; - } +static stbi_uc* stbi__process_gif_raster(stbi__context* s, stbi__gif* g) +{ + stbi_uc lzw_cs; + stbi__int32 len, init_code; + stbi__uint32 first; + stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear; + stbi__gif_lzw* p; + + lzw_cs = stbi__get8(s); + if (lzw_cs > 12) return NULL; + clear = 1 << lzw_cs; + first = 1; + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + bits = 0; + valid_bits = 0; + for (init_code = 0; init_code < clear; init_code++) { + g->codes[init_code].prefix = -1; + g->codes[init_code].first = (stbi_uc)init_code; + g->codes[init_code].suffix = (stbi_uc)init_code; + } - // support no starting clear code - avail = clear+2; - oldcode = -1; - - len = 0; - for(;;) { - if (valid_bits < codesize) { - if (len == 0) { - len = stbi__get8(s); // start new block - if (len == 0) - return g->out; - } - --len; - bits |= (stbi__int32) stbi__get8(s) << valid_bits; - valid_bits += 8; - } else { - stbi__int32 code = bits & codemask; - bits >>= codesize; - valid_bits -= codesize; - // @OPTIMIZE: is there some way we can accelerate the non-clear path? - if (code == clear) { // clear code - codesize = lzw_cs + 1; - codemask = (1 << codesize) - 1; - avail = clear + 2; - oldcode = -1; - first = 0; - } else if (code == clear + 1) { // end of stream code - stbi__skip(s, len); - while ((len = stbi__get8(s)) > 0) - stbi__skip(s,len); - return g->out; - } else if (code <= avail) { - if (first) { - return stbi__errpuc("no clear code", "Corrupt GIF"); + // support no starting clear code + avail = clear + 2; + oldcode = -1; + + len = 0; + for (;;) { + if (valid_bits < codesize) { + if (len == 0) { + len = stbi__get8(s); // start new block + if (len == 0) + return g->out; } - - if (oldcode >= 0) { - p = &g->codes[avail++]; - if (avail > 8192) { - return stbi__errpuc("too many codes", "Corrupt GIF"); - } - - p->prefix = (stbi__int16) oldcode; - p->first = g->codes[oldcode].first; - p->suffix = (code == avail) ? p->first : g->codes[code].first; - } else if (code == avail) - return stbi__errpuc("illegal code in raster", "Corrupt GIF"); - - stbi__out_gif_code(g, (stbi__uint16) code); - - if ((avail & codemask) == 0 && avail <= 0x0FFF) { - codesize++; - codemask = (1 << codesize) - 1; + --len; + bits |= (stbi__int32)stbi__get8(s) << valid_bits; + valid_bits += 8; + } + else { + stbi__int32 code = bits & codemask; + bits >>= codesize; + valid_bits -= codesize; + // @OPTIMIZE: is there some way we can accelerate the non-clear path? + if (code == clear) { // clear code + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + avail = clear + 2; + oldcode = -1; + first = 0; } - - oldcode = code; - } else { - return stbi__errpuc("illegal code in raster", "Corrupt GIF"); - } - } - } + else if (code == clear + 1) { // end of stream code + stbi__skip(s, len); + while ((len = stbi__get8(s)) > 0) + stbi__skip(s, len); + return g->out; + } + else if (code <= avail) { + if (first) { + return stbi__errpuc("no clear code", "Corrupt GIF"); + } + + if (oldcode >= 0) { + p = &g->codes[avail++]; + if (avail > 8192) { + return stbi__errpuc("too many codes", "Corrupt GIF"); + } + + p->prefix = (stbi__int16)oldcode; + p->first = g->codes[oldcode].first; + p->suffix = (code == avail) ? p->first : g->codes[code].first; + } + else if (code == avail) + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + + stbi__out_gif_code(g, (stbi__uint16)code); + + if ((avail & codemask) == 0 && avail <= 0x0FFF) { + codesize++; + codemask = (1 << codesize) - 1; + } + + oldcode = code; + } + else { + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + } + } + } } // this function is designed to support animated gifs, although stb_image doesn't support it // two back is the image from two frames ago, used for a very specific disposal format -static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, int req_comp, stbi_uc *two_back) -{ - int dispose; - int first_frame; - int pi; - int pcount; - STBI_NOTUSED(req_comp); - - // on first frame, any non-written pixels get the background colour (non-transparent) - first_frame = 0; - if (g->out == 0) { - if (!stbi__gif_header(s, g, comp,0)) return 0; // stbi__g_failure_reason set by stbi__gif_header - if (!stbi__mad3sizes_valid(4, g->w, g->h, 0)) - return stbi__errpuc("too large", "GIF image is too large"); - pcount = g->w * g->h; - g->out = (stbi_uc *) stbi__malloc(4 * pcount); - g->background = (stbi_uc *) stbi__malloc(4 * pcount); - g->history = (stbi_uc *) stbi__malloc(pcount); - if (!g->out || !g->background || !g->history) - return stbi__errpuc("outofmem", "Out of memory"); - - // image is treated as "transparent" at the start - ie, nothing overwrites the current background; - // background colour is only used for pixels that are not rendered first frame, after that "background" - // color refers to the color that was there the previous frame. - memset(g->out, 0x00, 4 * pcount); - memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent) - memset(g->history, 0x00, pcount); // pixels that were affected previous frame - first_frame = 1; - } else { - // second frame - how do we dispose of the previous one? - dispose = (g->eflags & 0x1C) >> 2; - pcount = g->w * g->h; - - if ((dispose == 3) && (two_back == 0)) { - dispose = 2; // if I don't have an image to revert back to, default to the old background - } +static stbi_uc* stbi__gif_load_next(stbi__context* s, stbi__gif* g, int* comp, int req_comp, stbi_uc* two_back) +{ + int dispose; + int first_frame; + int pi; + int pcount; + STBI_NOTUSED(req_comp); + + // on first frame, any non-written pixels get the background colour (non-transparent) + first_frame = 0; + if (g->out == 0) { + if (!stbi__gif_header(s, g, comp, 0)) return 0; // stbi__g_failure_reason set by stbi__gif_header + if (!stbi__mad3sizes_valid(4, g->w, g->h, 0)) + return stbi__errpuc("too large", "GIF image is too large"); + pcount = g->w * g->h; + g->out = (stbi_uc*)stbi__malloc(4 * pcount); + g->background = (stbi_uc*)stbi__malloc(4 * pcount); + g->history = (stbi_uc*)stbi__malloc(pcount); + if (!g->out || !g->background || !g->history) + return stbi__errpuc("outofmem", "Out of memory"); + + // image is treated as "transparent" at the start - ie, nothing overwrites the current background; + // background colour is only used for pixels that are not rendered first frame, after that "background" + // color refers to the color that was there the previous frame. + memset(g->out, 0x00, 4 * pcount); + memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent) + memset(g->history, 0x00, pcount); // pixels that were affected previous frame + first_frame = 1; + } + else { + // second frame - how do we dispose of the previous one? + dispose = (g->eflags & 0x1C) >> 2; + pcount = g->w * g->h; + + if ((dispose == 3) && (two_back == 0)) { + dispose = 2; // if I don't have an image to revert back to, default to the old background + } - if (dispose == 3) { // use previous graphic - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi]) { - memcpy( &g->out[pi * 4], &two_back[pi * 4], 4 ); + if (dispose == 3) { // use previous graphic + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy(&g->out[pi * 4], &two_back[pi * 4], 4); + } } - } - } else if (dispose == 2) { - // restore what was changed last frame to background before that frame; - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi]) { - memcpy( &g->out[pi * 4], &g->background[pi * 4], 4 ); + } + else if (dispose == 2) { + // restore what was changed last frame to background before that frame; + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy(&g->out[pi * 4], &g->background[pi * 4], 4); + } } - } - } else { - // This is a non-disposal case eithe way, so just - // leave the pixels as is, and they will become the new background - // 1: do not dispose - // 0: not specified. - } + } + else { + // This is a non-disposal case eithe way, so just + // leave the pixels as is, and they will become the new background + // 1: do not dispose + // 0: not specified. + } - // background is what out is after the undoing of the previou frame; - memcpy( g->background, g->out, 4 * g->w * g->h ); - } + // background is what out is after the undoing of the previou frame; + memcpy(g->background, g->out, 4 * g->w * g->h); + } - // clear my history; - memset( g->history, 0x00, g->w * g->h ); // pixels that were affected previous frame + // clear my history; + memset(g->history, 0x00, g->w * g->h); // pixels that were affected previous frame - for (;;) { - int tag = stbi__get8(s); - switch (tag) { - case 0x2C: /* Image Descriptor */ - { + for (;;) { + int tag = stbi__get8(s); + switch (tag) { + case 0x2C: /* Image Descriptor */ + { stbi__int32 x, y, w, h; - stbi_uc *o; + stbi_uc* o; x = stbi__get16le(s); y = stbi__get16le(s); w = stbi__get16le(s); h = stbi__get16le(s); if (((x + w) > (g->w)) || ((y + h) > (g->h))) - return stbi__errpuc("bad Image Descriptor", "Corrupt GIF"); + return stbi__errpuc("bad Image Descriptor", "Corrupt GIF"); g->line_size = g->w * 4; g->start_x = x * 4; g->start_y = y * g->line_size; - g->max_x = g->start_x + w * 4; - g->max_y = g->start_y + h * g->line_size; - g->cur_x = g->start_x; - g->cur_y = g->start_y; + g->max_x = g->start_x + w * 4; + g->max_y = g->start_y + h * g->line_size; + g->cur_x = g->start_x; + g->cur_y = g->start_y; // if the width of the specified rectangle is 0, that means // we may not see *any* pixels or the image is malformed; // to make sure this is caught, move the current y down to // max_y (which is what out_gif_code checks). if (w == 0) - g->cur_y = g->max_y; + g->cur_y = g->max_y; g->lflags = stbi__get8(s); if (g->lflags & 0x40) { - g->step = 8 * g->line_size; // first interlaced spacing - g->parse = 3; - } else { - g->step = g->line_size; - g->parse = 0; + g->step = 8 * g->line_size; // first interlaced spacing + g->parse = 3; + } + else { + g->step = g->line_size; + g->parse = 0; } if (g->lflags & 0x80) { - stbi__gif_parse_colortable(s,g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1); - g->color_table = (stbi_uc *) g->lpal; - } else if (g->flags & 0x80) { - g->color_table = (stbi_uc *) g->pal; - } else - return stbi__errpuc("missing color table", "Corrupt GIF"); + stbi__gif_parse_colortable(s, g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1); + g->color_table = (stbi_uc*)g->lpal; + } + else if (g->flags & 0x80) { + g->color_table = (stbi_uc*)g->pal; + } + else + return stbi__errpuc("missing color table", "Corrupt GIF"); o = stbi__process_gif_raster(s, g); if (!o) return NULL; @@ -6815,190 +6917,195 @@ static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, i // if this was the first frame, pcount = g->w * g->h; if (first_frame && (g->bgindex > 0)) { - // if first frame, any pixel not drawn to gets the background color - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi] == 0) { - g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; - memcpy( &g->out[pi * 4], &g->pal[g->bgindex], 4 ); - } - } + // if first frame, any pixel not drawn to gets the background color + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi] == 0) { + g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; + memcpy(&g->out[pi * 4], &g->pal[g->bgindex], 4); + } + } } return o; - } + } - case 0x21: // Comment Extension. - { + case 0x21: // Comment Extension. + { int len; int ext = stbi__get8(s); if (ext == 0xF9) { // Graphic Control Extension. - len = stbi__get8(s); - if (len == 4) { - g->eflags = stbi__get8(s); - g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths. - - // unset old transparent - if (g->transparent >= 0) { - g->pal[g->transparent][3] = 255; - } - if (g->eflags & 0x01) { - g->transparent = stbi__get8(s); - if (g->transparent >= 0) { - g->pal[g->transparent][3] = 0; - } - } else { - // don't need transparent - stbi__skip(s, 1); - g->transparent = -1; - } - } else { - stbi__skip(s, len); - break; - } + len = stbi__get8(s); + if (len == 4) { + g->eflags = stbi__get8(s); + g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths. + + // unset old transparent + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 255; + } + if (g->eflags & 0x01) { + g->transparent = stbi__get8(s); + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 0; + } + } + else { + // don't need transparent + stbi__skip(s, 1); + g->transparent = -1; + } + } + else { + stbi__skip(s, len); + break; + } } while ((len = stbi__get8(s)) != 0) { - stbi__skip(s, len); + stbi__skip(s, len); } break; - } + } - case 0x3B: // gif stream termination code - return (stbi_uc *) s; // using '1' causes warning on some compilers + case 0x3B: // gif stream termination code + return (stbi_uc*)s; // using '1' causes warning on some compilers - default: + default: return stbi__errpuc("unknown code", "Corrupt GIF"); - } - } + } + } } -static void *stbi__load_gif_main_outofmem(stbi__gif *g, stbi_uc *out, int **delays) +static void* stbi__load_gif_main_outofmem(stbi__gif* g, stbi_uc* out, int** delays) { - STBI_FREE(g->out); - STBI_FREE(g->history); - STBI_FREE(g->background); + STBI_FREE(g->out); + STBI_FREE(g->history); + STBI_FREE(g->background); - if (out) STBI_FREE(out); - if (delays && *delays) STBI_FREE(*delays); - return stbi__errpuc("outofmem", "Out of memory"); + if (out) STBI_FREE(out); + if (delays && *delays) STBI_FREE(*delays); + return stbi__errpuc("outofmem", "Out of memory"); } -static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +static void* stbi__load_gif_main(stbi__context* s, int** delays, int* x, int* y, int* z, int* comp, int req_comp) { - if (stbi__gif_test(s)) { - int layers = 0; - stbi_uc *u = 0; - stbi_uc *out = 0; - stbi_uc *two_back = 0; - stbi__gif g; - int stride; - int out_size = 0; - int delays_size = 0; + if (stbi__gif_test(s)) { + int layers = 0; + stbi_uc* u = 0; + stbi_uc* out = 0; + stbi_uc* two_back = 0; + stbi__gif g; + int stride; + int out_size = 0; + int delays_size = 0; - STBI_NOTUSED(out_size); - STBI_NOTUSED(delays_size); + STBI_NOTUSED(out_size); + STBI_NOTUSED(delays_size); - memset(&g, 0, sizeof(g)); - if (delays) { - *delays = 0; - } + memset(&g, 0, sizeof(g)); + if (delays) { + *delays = 0; + } - do { - u = stbi__gif_load_next(s, &g, comp, req_comp, two_back); - if (u == (stbi_uc *) s) u = 0; // end of animated gif marker - - if (u) { - *x = g.w; - *y = g.h; - ++layers; - stride = g.w * g.h * 4; - - if (out) { - void *tmp = (stbi_uc*) STBI_REALLOC_SIZED( out, out_size, layers * stride ); - if (!tmp) - return stbi__load_gif_main_outofmem(&g, out, delays); - else { - out = (stbi_uc*) tmp; - out_size = layers * stride; - } - - if (delays) { - int *new_delays = (int*) STBI_REALLOC_SIZED( *delays, delays_size, sizeof(int) * layers ); - if (!new_delays) - return stbi__load_gif_main_outofmem(&g, out, delays); - *delays = new_delays; - delays_size = layers * sizeof(int); - } - } else { - out = (stbi_uc*)stbi__malloc( layers * stride ); - if (!out) - return stbi__load_gif_main_outofmem(&g, out, delays); - out_size = layers * stride; - if (delays) { - *delays = (int*) stbi__malloc( layers * sizeof(int) ); - if (!*delays) - return stbi__load_gif_main_outofmem(&g, out, delays); - delays_size = layers * sizeof(int); - } - } - memcpy( out + ((layers - 1) * stride), u, stride ); - if (layers >= 2) { - two_back = out - 2 * stride; + do { + u = stbi__gif_load_next(s, &g, comp, req_comp, two_back); + if (u == (stbi_uc*)s) u = 0; // end of animated gif marker + + if (u) { + *x = g.w; + *y = g.h; + ++layers; + stride = g.w * g.h * 4; + + if (out) { + void* tmp = (stbi_uc*)STBI_REALLOC_SIZED(out, out_size, layers * stride); + if (!tmp) + return stbi__load_gif_main_outofmem(&g, out, delays); + else { + out = (stbi_uc*)tmp; + out_size = layers * stride; + } + + if (delays) { + int* new_delays = (int*)STBI_REALLOC_SIZED(*delays, delays_size, sizeof(int) * layers); + if (!new_delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + *delays = new_delays; + delays_size = layers * sizeof(int); + } + } + else { + out = (stbi_uc*)stbi__malloc(layers * stride); + if (!out) + return stbi__load_gif_main_outofmem(&g, out, delays); + out_size = layers * stride; + if (delays) { + *delays = (int*)stbi__malloc(layers * sizeof(int)); + if (!*delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + delays_size = layers * sizeof(int); + } + } + memcpy(out + ((layers - 1) * stride), u, stride); + if (layers >= 2) { + two_back = out - 2 * stride; + } + + if (delays) { + (*delays)[layers - 1U] = g.delay; + } } + } while (u != 0); - if (delays) { - (*delays)[layers - 1U] = g.delay; - } - } - } while (u != 0); - - // free temp buffer; - STBI_FREE(g.out); - STBI_FREE(g.history); - STBI_FREE(g.background); - - // do the final conversion after loading everything; - if (req_comp && req_comp != 4) - out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h); - - *z = layers; - return out; - } else { - return stbi__errpuc("not GIF", "Image was not as a gif type."); - } + // free temp buffer; + STBI_FREE(g.out); + STBI_FREE(g.history); + STBI_FREE(g.background); + + // do the final conversion after loading everything; + if (req_comp && req_comp != 4) + out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h); + + *z = layers; + return out; + } + else { + return stbi__errpuc("not GIF", "Image was not as a gif type."); + } } -static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +static void* stbi__gif_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) { - stbi_uc *u = 0; - stbi__gif g; - memset(&g, 0, sizeof(g)); - STBI_NOTUSED(ri); + stbi_uc* u = 0; + stbi__gif g; + memset(&g, 0, sizeof(g)); + STBI_NOTUSED(ri); - u = stbi__gif_load_next(s, &g, comp, req_comp, 0); - if (u == (stbi_uc *) s) u = 0; // end of animated gif marker - if (u) { - *x = g.w; - *y = g.h; + u = stbi__gif_load_next(s, &g, comp, req_comp, 0); + if (u == (stbi_uc*)s) u = 0; // end of animated gif marker + if (u) { + *x = g.w; + *y = g.h; - // moved conversion to after successful load so that the same - // can be done for multiple frames. - if (req_comp && req_comp != 4) - u = stbi__convert_format(u, 4, req_comp, g.w, g.h); - } else if (g.out) { - // if there was an error and we allocated an image buffer, free it! - STBI_FREE(g.out); - } + // moved conversion to after successful load so that the same + // can be done for multiple frames. + if (req_comp && req_comp != 4) + u = stbi__convert_format(u, 4, req_comp, g.w, g.h); + } + else if (g.out) { + // if there was an error and we allocated an image buffer, free it! + STBI_FREE(g.out); + } - // free buffers needed for multiple frame loading; - STBI_FREE(g.history); - STBI_FREE(g.background); + // free buffers needed for multiple frame loading; + STBI_FREE(g.history); + STBI_FREE(g.background); - return u; + return u; } -static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__gif_info(stbi__context* s, int* x, int* y, int* comp) { - return stbi__gif_info_raw(s,x,y,comp); + return stbi__gif_info_raw(s, x, y, comp); } #endif @@ -7006,397 +7113,400 @@ static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp) // Radiance RGBE HDR loader // originally by Nicolas Schulz #ifndef STBI_NO_HDR -static int stbi__hdr_test_core(stbi__context *s, const char *signature) +static int stbi__hdr_test_core(stbi__context* s, const char* signature) { - int i; - for (i=0; signature[i]; ++i) - if (stbi__get8(s) != signature[i]) - return 0; - stbi__rewind(s); - return 1; + int i; + for (i = 0; signature[i]; ++i) + if (stbi__get8(s) != signature[i]) + return 0; + stbi__rewind(s); + return 1; } static int stbi__hdr_test(stbi__context* s) { - int r = stbi__hdr_test_core(s, "#?RADIANCE\n"); - stbi__rewind(s); - if(!r) { - r = stbi__hdr_test_core(s, "#?RGBE\n"); - stbi__rewind(s); - } - return r; + int r = stbi__hdr_test_core(s, "#?RADIANCE\n"); + stbi__rewind(s); + if (!r) { + r = stbi__hdr_test_core(s, "#?RGBE\n"); + stbi__rewind(s); + } + return r; } #define STBI__HDR_BUFLEN 1024 -static char *stbi__hdr_gettoken(stbi__context *z, char *buffer) +static char* stbi__hdr_gettoken(stbi__context* z, char* buffer) { - int len=0; - char c = '\0'; + int len = 0; + char c = '\0'; - c = (char) stbi__get8(z); + c = (char)stbi__get8(z); - while (!stbi__at_eof(z) && c != '\n') { - buffer[len++] = c; - if (len == STBI__HDR_BUFLEN-1) { - // flush to end of line - while (!stbi__at_eof(z) && stbi__get8(z) != '\n') - ; - break; - } - c = (char) stbi__get8(z); - } + while (!stbi__at_eof(z) && c != '\n') { + buffer[len++] = c; + if (len == STBI__HDR_BUFLEN - 1) { + // flush to end of line + while (!stbi__at_eof(z) && stbi__get8(z) != '\n') + ; + break; + } + c = (char)stbi__get8(z); + } - buffer[len] = 0; - return buffer; + buffer[len] = 0; + return buffer; } -static void stbi__hdr_convert(float *output, stbi_uc *input, int req_comp) +static void stbi__hdr_convert(float* output, stbi_uc* input, int req_comp) { - if ( input[3] != 0 ) { - float f1; - // Exponent - f1 = (float) ldexp(1.0f, input[3] - (int)(128 + 8)); - if (req_comp <= 2) - output[0] = (input[0] + input[1] + input[2]) * f1 / 3; - else { - output[0] = input[0] * f1; - output[1] = input[1] * f1; - output[2] = input[2] * f1; - } - if (req_comp == 2) output[1] = 1; - if (req_comp == 4) output[3] = 1; - } else { - switch (req_comp) { - case 4: output[3] = 1; /* fallthrough */ - case 3: output[0] = output[1] = output[2] = 0; - break; - case 2: output[1] = 1; /* fallthrough */ - case 1: output[0] = 0; - break; - } - } + if (input[3] != 0) { + float f1; + // Exponent + f1 = (float)ldexp(1.0f, input[3] - (int)(128 + 8)); + if (req_comp <= 2) + output[0] = (input[0] + input[1] + input[2]) * f1 / 3; + else { + output[0] = input[0] * f1; + output[1] = input[1] * f1; + output[2] = input[2] * f1; + } + if (req_comp == 2) output[1] = 1; + if (req_comp == 4) output[3] = 1; + } + else { + switch (req_comp) { + case 4: output[3] = 1; /* fallthrough */ + case 3: output[0] = output[1] = output[2] = 0; + break; + case 2: output[1] = 1; /* fallthrough */ + case 1: output[0] = 0; + break; + } + } } -static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) -{ - char buffer[STBI__HDR_BUFLEN]; - char *token; - int valid = 0; - int width, height; - stbi_uc *scanline; - float *hdr_data; - int len; - unsigned char count, value; - int i, j, k, c1,c2, z; - const char *headerToken; - STBI_NOTUSED(ri); - - // Check identifier - headerToken = stbi__hdr_gettoken(s,buffer); - if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0) - return stbi__errpf("not HDR", "Corrupt HDR image"); - - // Parse header - for(;;) { - token = stbi__hdr_gettoken(s,buffer); - if (token[0] == 0) break; - if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; - } +static float* stbi__hdr_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) +{ + char buffer[STBI__HDR_BUFLEN]; + char* token; + int valid = 0; + int width, height; + stbi_uc* scanline; + float* hdr_data; + int len; + unsigned char count, value; + int i, j, k, c1, c2, z; + const char* headerToken; + STBI_NOTUSED(ri); + + // Check identifier + headerToken = stbi__hdr_gettoken(s, buffer); + if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0) + return stbi__errpf("not HDR", "Corrupt HDR image"); + + // Parse header + for (;;) { + token = stbi__hdr_gettoken(s, buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } - if (!valid) return stbi__errpf("unsupported format", "Unsupported HDR format"); - - // Parse width and height - // can't use sscanf() if we're not using stdio! - token = stbi__hdr_gettoken(s,buffer); - if (strncmp(token, "-Y ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); - token += 3; - height = (int) strtol(token, &token, 10); - while (*token == ' ') ++token; - if (strncmp(token, "+X ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); - token += 3; - width = (int) strtol(token, NULL, 10); - - if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); - if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); - - *x = width; - *y = height; - - if (comp) *comp = 3; - if (req_comp == 0) req_comp = 3; - - if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0)) - return stbi__errpf("too large", "HDR image is too large"); - - // Read data - hdr_data = (float *) stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0); - if (!hdr_data) - return stbi__errpf("outofmem", "Out of memory"); - - // Load image data - // image data is stored as some number of sca - if ( width < 8 || width >= 32768) { - // Read flat data - for (j=0; j < height; ++j) { - for (i=0; i < width; ++i) { - stbi_uc rgbe[4]; - main_decode_loop: - stbi__getn(s, rgbe, 4); - stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp); - } - } - } else { - // Read RLE-encoded data - scanline = NULL; - - for (j = 0; j < height; ++j) { - c1 = stbi__get8(s); - c2 = stbi__get8(s); - len = stbi__get8(s); - if (c1 != 2 || c2 != 2 || (len & 0x80)) { - // not run-length encoded, so we have to actually use THIS data as a decoded - // pixel (note this can't be a valid pixel--one of RGB must be >= 128) - stbi_uc rgbe[4]; - rgbe[0] = (stbi_uc) c1; - rgbe[1] = (stbi_uc) c2; - rgbe[2] = (stbi_uc) len; - rgbe[3] = (stbi_uc) stbi__get8(s); - stbi__hdr_convert(hdr_data, rgbe, req_comp); - i = 1; - j = 0; - STBI_FREE(scanline); - goto main_decode_loop; // yes, this makes no sense - } - len <<= 8; - len |= stbi__get8(s); - if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); } - if (scanline == NULL) { - scanline = (stbi_uc *) stbi__malloc_mad2(width, 4, 0); - if (!scanline) { - STBI_FREE(hdr_data); - return stbi__errpf("outofmem", "Out of memory"); + if (!valid) return stbi__errpf("unsupported format", "Unsupported HDR format"); + + // Parse width and height + // can't use sscanf() if we're not using stdio! + token = stbi__hdr_gettoken(s, buffer); + if (strncmp(token, "-Y ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + height = (int)strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + width = (int)strtol(token, NULL, 10); + + if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large", "Very large image (corrupt?)"); + if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large", "Very large image (corrupt?)"); + + *x = width; + *y = height; + + if (comp) *comp = 3; + if (req_comp == 0) req_comp = 3; + + if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0)) + return stbi__errpf("too large", "HDR image is too large"); + + // Read data + hdr_data = (float*)stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0); + if (!hdr_data) + return stbi__errpf("outofmem", "Out of memory"); + + // Load image data + // image data is stored as some number of sca + if (width < 8 || width >= 32768) { + // Read flat data + for (j = 0; j < height; ++j) { + for (i = 0; i < width; ++i) { + stbi_uc rgbe[4]; + main_decode_loop: + stbi__getn(s, rgbe, 4); + stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp); + } + } + } + else { + // Read RLE-encoded data + scanline = NULL; + + for (j = 0; j < height; ++j) { + c1 = stbi__get8(s); + c2 = stbi__get8(s); + len = stbi__get8(s); + if (c1 != 2 || c2 != 2 || (len & 0x80)) { + // not run-length encoded, so we have to actually use THIS data as a decoded + // pixel (note this can't be a valid pixel--one of RGB must be >= 128) + stbi_uc rgbe[4]; + rgbe[0] = (stbi_uc)c1; + rgbe[1] = (stbi_uc)c2; + rgbe[2] = (stbi_uc)len; + rgbe[3] = (stbi_uc)stbi__get8(s); + stbi__hdr_convert(hdr_data, rgbe, req_comp); + i = 1; + j = 0; + STBI_FREE(scanline); + goto main_decode_loop; // yes, this makes no sense } - } - - for (k = 0; k < 4; ++k) { - int nleft; - i = 0; - while ((nleft = width - i) > 0) { - count = stbi__get8(s); - if (count > 128) { - // Run - value = stbi__get8(s); - count -= 128; - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } - for (z = 0; z < count; ++z) - scanline[i++ * 4 + k] = value; - } else { - // Dump - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } - for (z = 0; z < count; ++z) - scanline[i++ * 4 + k] = stbi__get8(s); - } + len <<= 8; + len |= stbi__get8(s); + if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); } + if (scanline == NULL) { + scanline = (stbi_uc*)stbi__malloc_mad2(width, 4, 0); + if (!scanline) { + STBI_FREE(hdr_data); + return stbi__errpf("outofmem", "Out of memory"); + } } - } - for (i=0; i < width; ++i) - stbi__hdr_convert(hdr_data+(j*width + i)*req_comp, scanline + i*4, req_comp); - } - if (scanline) - STBI_FREE(scanline); - } - return hdr_data; + for (k = 0; k < 4; ++k) { + int nleft; + i = 0; + while ((nleft = width - i) > 0) { + count = stbi__get8(s); + if (count > 128) { + // Run + value = stbi__get8(s); + count -= 128; + if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = value; + } + else { + // Dump + if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = stbi__get8(s); + } + } + } + for (i = 0; i < width; ++i) + stbi__hdr_convert(hdr_data + (j * width + i) * req_comp, scanline + i * 4, req_comp); + } + if (scanline) + STBI_FREE(scanline); + } + + return hdr_data; } -static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__hdr_info(stbi__context* s, int* x, int* y, int* comp) { - char buffer[STBI__HDR_BUFLEN]; - char *token; - int valid = 0; - int dummy; + char buffer[STBI__HDR_BUFLEN]; + char* token; + int valid = 0; + int dummy; - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; - if (stbi__hdr_test(s) == 0) { - stbi__rewind( s ); - return 0; - } + if (stbi__hdr_test(s) == 0) { + stbi__rewind(s); + return 0; + } - for(;;) { - token = stbi__hdr_gettoken(s,buffer); - if (token[0] == 0) break; - if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; - } + for (;;) { + token = stbi__hdr_gettoken(s, buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } - if (!valid) { - stbi__rewind( s ); - return 0; - } - token = stbi__hdr_gettoken(s,buffer); - if (strncmp(token, "-Y ", 3)) { - stbi__rewind( s ); - return 0; - } - token += 3; - *y = (int) strtol(token, &token, 10); - while (*token == ' ') ++token; - if (strncmp(token, "+X ", 3)) { - stbi__rewind( s ); - return 0; - } - token += 3; - *x = (int) strtol(token, NULL, 10); - *comp = 3; - return 1; + if (!valid) { + stbi__rewind(s); + return 0; + } + token = stbi__hdr_gettoken(s, buffer); + if (strncmp(token, "-Y ", 3)) { + stbi__rewind(s); + return 0; + } + token += 3; + *y = (int)strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) { + stbi__rewind(s); + return 0; + } + token += 3; + *x = (int)strtol(token, NULL, 10); + *comp = 3; + return 1; } #endif // STBI_NO_HDR #ifndef STBI_NO_BMP -static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__bmp_info(stbi__context* s, int* x, int* y, int* comp) { - void *p; - stbi__bmp_data info; + void* p; + stbi__bmp_data info; - info.all_a = 255; - p = stbi__bmp_parse_header(s, &info); - if (p == NULL) { - stbi__rewind( s ); - return 0; - } - if (x) *x = s->img_x; - if (y) *y = s->img_y; - if (comp) { - if (info.bpp == 24 && info.ma == 0xff000000) - *comp = 3; - else - *comp = info.ma ? 4 : 3; - } - return 1; + info.all_a = 255; + p = stbi__bmp_parse_header(s, &info); + if (p == NULL) { + stbi__rewind(s); + return 0; + } + if (x) *x = s->img_x; + if (y) *y = s->img_y; + if (comp) { + if (info.bpp == 24 && info.ma == 0xff000000) + *comp = 3; + else + *comp = info.ma ? 4 : 3; + } + return 1; } #endif #ifndef STBI_NO_PSD -static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp) -{ - int channelCount, dummy, depth; - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; - if (stbi__get32be(s) != 0x38425053) { - stbi__rewind( s ); - return 0; - } - if (stbi__get16be(s) != 1) { - stbi__rewind( s ); - return 0; - } - stbi__skip(s, 6); - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) { - stbi__rewind( s ); - return 0; - } - *y = stbi__get32be(s); - *x = stbi__get32be(s); - depth = stbi__get16be(s); - if (depth != 8 && depth != 16) { - stbi__rewind( s ); - return 0; - } - if (stbi__get16be(s) != 3) { - stbi__rewind( s ); - return 0; - } - *comp = 4; - return 1; +static int stbi__psd_info(stbi__context* s, int* x, int* y, int* comp) +{ + int channelCount, dummy, depth; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind(s); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind(s); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind(s); + return 0; + } + *y = stbi__get32be(s); + *x = stbi__get32be(s); + depth = stbi__get16be(s); + if (depth != 8 && depth != 16) { + stbi__rewind(s); + return 0; + } + if (stbi__get16be(s) != 3) { + stbi__rewind(s); + return 0; + } + *comp = 4; + return 1; } -static int stbi__psd_is16(stbi__context *s) +static int stbi__psd_is16(stbi__context* s) { - int channelCount, depth; - if (stbi__get32be(s) != 0x38425053) { - stbi__rewind( s ); - return 0; - } - if (stbi__get16be(s) != 1) { - stbi__rewind( s ); - return 0; - } - stbi__skip(s, 6); - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) { - stbi__rewind( s ); - return 0; - } - STBI_NOTUSED(stbi__get32be(s)); - STBI_NOTUSED(stbi__get32be(s)); - depth = stbi__get16be(s); - if (depth != 16) { - stbi__rewind( s ); - return 0; - } - return 1; + int channelCount, depth; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind(s); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind(s); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind(s); + return 0; + } + STBI_NOTUSED(stbi__get32be(s)); + STBI_NOTUSED(stbi__get32be(s)); + depth = stbi__get16be(s); + if (depth != 16) { + stbi__rewind(s); + return 0; + } + return 1; } #endif #ifndef STBI_NO_PIC -static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__pic_info(stbi__context* s, int* x, int* y, int* comp) { - int act_comp=0,num_packets=0,chained,dummy; - stbi__pic_packet packets[10]; + int act_comp = 0, num_packets = 0, chained, dummy; + stbi__pic_packet packets[10]; - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; - if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) { - stbi__rewind(s); - return 0; - } + if (!stbi__pic_is4(s, "\x53\x80\xF6\x34")) { + stbi__rewind(s); + return 0; + } - stbi__skip(s, 88); + stbi__skip(s, 88); - *x = stbi__get16be(s); - *y = stbi__get16be(s); - if (stbi__at_eof(s)) { - stbi__rewind( s); - return 0; - } - if ( (*x) != 0 && (1 << 28) / (*x) < (*y)) { - stbi__rewind( s ); - return 0; - } + *x = stbi__get16be(s); + *y = stbi__get16be(s); + if (stbi__at_eof(s)) { + stbi__rewind(s); + return 0; + } + if ((*x) != 0 && (1 << 28) / (*x) < (*y)) { + stbi__rewind(s); + return 0; + } - stbi__skip(s, 8); + stbi__skip(s, 8); - do { - stbi__pic_packet *packet; + do { + stbi__pic_packet* packet; - if (num_packets==sizeof(packets)/sizeof(packets[0])) - return 0; + if (num_packets == sizeof(packets) / sizeof(packets[0])) + return 0; - packet = &packets[num_packets++]; - chained = stbi__get8(s); - packet->size = stbi__get8(s); - packet->type = stbi__get8(s); - packet->channel = stbi__get8(s); - act_comp |= packet->channel; + packet = &packets[num_packets++]; + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); + act_comp |= packet->channel; - if (stbi__at_eof(s)) { - stbi__rewind( s ); - return 0; - } - if (packet->size != 8) { - stbi__rewind( s ); - return 0; - } - } while (chained); + if (stbi__at_eof(s)) { + stbi__rewind(s); + return 0; + } + if (packet->size != 8) { + stbi__rewind(s); + return 0; + } + } while (chained); - *comp = (act_comp & 0x10 ? 4 : 3); + *comp = (act_comp & 0x10 ? 4 : 3); - return 1; + return 1; } #endif @@ -7413,193 +7523,193 @@ static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp) #ifndef STBI_NO_PNM -static int stbi__pnm_test(stbi__context *s) +static int stbi__pnm_test(stbi__context* s) { - char p, t; - p = (char) stbi__get8(s); - t = (char) stbi__get8(s); - if (p != 'P' || (t != '5' && t != '6')) { - stbi__rewind( s ); - return 0; - } - return 1; + char p, t; + p = (char)stbi__get8(s); + t = (char)stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind(s); + return 0; + } + return 1; } -static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +static void* stbi__pnm_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) { - stbi_uc *out; - STBI_NOTUSED(ri); + stbi_uc* out; + STBI_NOTUSED(ri); - ri->bits_per_channel = stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n); - if (ri->bits_per_channel == 0) - return 0; + ri->bits_per_channel = stbi__pnm_info(s, (int*)&s->img_x, (int*)&s->img_y, (int*)&s->img_n); + if (ri->bits_per_channel == 0) + return 0; - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - *x = s->img_x; - *y = s->img_y; - if (comp) *comp = s->img_n; + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; - if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) - return stbi__errpuc("too large", "PNM too large"); + if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) + return stbi__errpuc("too large", "PNM too large"); - out = (stbi_uc *) stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8)); + out = (stbi_uc*)stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8)); - if (req_comp && req_comp != s->img_n) { - out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } - return out; + if (req_comp && req_comp != s->img_n) { + out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + return out; } static int stbi__pnm_isspace(char c) { - return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r'; + return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r'; } -static void stbi__pnm_skip_whitespace(stbi__context *s, char *c) +static void stbi__pnm_skip_whitespace(stbi__context* s, char* c) { - for (;;) { - while (!stbi__at_eof(s) && stbi__pnm_isspace(*c)) - *c = (char) stbi__get8(s); + for (;;) { + while (!stbi__at_eof(s) && stbi__pnm_isspace(*c)) + *c = (char)stbi__get8(s); - if (stbi__at_eof(s) || *c != '#') - break; + if (stbi__at_eof(s) || *c != '#') + break; - while (!stbi__at_eof(s) && *c != '\n' && *c != '\r' ) - *c = (char) stbi__get8(s); - } + while (!stbi__at_eof(s) && *c != '\n' && *c != '\r') + *c = (char)stbi__get8(s); + } } static int stbi__pnm_isdigit(char c) { - return c >= '0' && c <= '9'; + return c >= '0' && c <= '9'; } -static int stbi__pnm_getinteger(stbi__context *s, char *c) +static int stbi__pnm_getinteger(stbi__context* s, char* c) { - int value = 0; + int value = 0; - while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { - value = value*10 + (*c - '0'); - *c = (char) stbi__get8(s); - } + while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { + value = value * 10 + (*c - '0'); + *c = (char)stbi__get8(s); + } - return value; + return value; } -static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp) +static int stbi__pnm_info(stbi__context* s, int* x, int* y, int* comp) { - int maxv, dummy; - char c, p, t; + int maxv, dummy; + char c, p, t; - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; - stbi__rewind(s); + stbi__rewind(s); - // Get identifier - p = (char) stbi__get8(s); - t = (char) stbi__get8(s); - if (p != 'P' || (t != '5' && t != '6')) { - stbi__rewind(s); - return 0; - } + // Get identifier + p = (char)stbi__get8(s); + t = (char)stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind(s); + return 0; + } - *comp = (t == '6') ? 3 : 1; // '5' is 1-component .pgm; '6' is 3-component .ppm + *comp = (t == '6') ? 3 : 1; // '5' is 1-component .pgm; '6' is 3-component .ppm - c = (char) stbi__get8(s); - stbi__pnm_skip_whitespace(s, &c); + c = (char)stbi__get8(s); + stbi__pnm_skip_whitespace(s, &c); - *x = stbi__pnm_getinteger(s, &c); // read width - stbi__pnm_skip_whitespace(s, &c); + *x = stbi__pnm_getinteger(s, &c); // read width + stbi__pnm_skip_whitespace(s, &c); - *y = stbi__pnm_getinteger(s, &c); // read height - stbi__pnm_skip_whitespace(s, &c); + *y = stbi__pnm_getinteger(s, &c); // read height + stbi__pnm_skip_whitespace(s, &c); - maxv = stbi__pnm_getinteger(s, &c); // read max value - if (maxv > 65535) - return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); - else if (maxv > 255) - return 16; - else - return 8; + maxv = stbi__pnm_getinteger(s, &c); // read max value + if (maxv > 65535) + return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); + else if (maxv > 255) + return 16; + else + return 8; } -static int stbi__pnm_is16(stbi__context *s) +static int stbi__pnm_is16(stbi__context* s) { - if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) - return 1; - return 0; + if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) + return 1; + return 0; } #endif -static int stbi__info_main(stbi__context *s, int *x, int *y, int *comp) +static int stbi__info_main(stbi__context* s, int* x, int* y, int* comp) { - #ifndef STBI_NO_JPEG - if (stbi__jpeg_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_JPEG + if (stbi__jpeg_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_PNG - if (stbi__png_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_PNG + if (stbi__png_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_GIF - if (stbi__gif_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_GIF + if (stbi__gif_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_BMP - if (stbi__bmp_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_BMP + if (stbi__bmp_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_PSD - if (stbi__psd_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_PSD + if (stbi__psd_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_PIC - if (stbi__pic_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_PIC + if (stbi__pic_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_PNM - if (stbi__pnm_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_PNM + if (stbi__pnm_info(s, x, y, comp)) return 1; +#endif - #ifndef STBI_NO_HDR - if (stbi__hdr_info(s, x, y, comp)) return 1; - #endif +#ifndef STBI_NO_HDR + if (stbi__hdr_info(s, x, y, comp)) return 1; +#endif - // test tga last because it's a crappy test! - #ifndef STBI_NO_TGA - if (stbi__tga_info(s, x, y, comp)) - return 1; - #endif - return stbi__err("unknown image type", "Image not of any known type, or corrupt"); + // test tga last because it's a crappy test! +#ifndef STBI_NO_TGA + if (stbi__tga_info(s, x, y, comp)) + return 1; +#endif + return stbi__err("unknown image type", "Image not of any known type, or corrupt"); } -static int stbi__is_16_main(stbi__context *s) +static int stbi__is_16_main(stbi__context* s) { - #ifndef STBI_NO_PNG - if (stbi__png_is16(s)) return 1; - #endif +#ifndef STBI_NO_PNG + if (stbi__png_is16(s)) return 1; +#endif - #ifndef STBI_NO_PSD - if (stbi__psd_is16(s)) return 1; - #endif +#ifndef STBI_NO_PSD + if (stbi__psd_is16(s)) return 1; +#endif - #ifndef STBI_NO_PNM - if (stbi__pnm_is16(s)) return 1; - #endif - return 0; +#ifndef STBI_NO_PNM + if (stbi__pnm_is16(s)) return 1; +#endif + return 0; } #ifndef STBI_NO_STDIO -STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp) +STBIDEF int stbi_info(char const* filename, int* x, int* y, int* comp) { - FILE *f = stbi__fopen(filename, "rb"); + FILE* f = stbi__fopen(filename, "rb"); int result; if (!f) return stbi__err("can't fopen", "Unable to open file"); result = stbi_info_from_file(f, x, y, comp); @@ -7607,20 +7717,20 @@ STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp) return result; } -STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp) +STBIDEF int stbi_info_from_file(FILE* f, int* x, int* y, int* comp) { - int r; - stbi__context s; - long pos = ftell(f); - stbi__start_file(&s, f); - r = stbi__info_main(&s,x,y,comp); - fseek(f,pos,SEEK_SET); - return r; + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__info_main(&s, x, y, comp); + fseek(f, pos, SEEK_SET); + return r; } -STBIDEF int stbi_is_16_bit(char const *filename) +STBIDEF int stbi_is_16_bit(char const* filename) { - FILE *f = stbi__fopen(filename, "rb"); + FILE* f = stbi__fopen(filename, "rb"); int result; if (!f) return stbi__err("can't fopen", "Unable to open file"); result = stbi_is_16_bit_from_file(f); @@ -7628,44 +7738,44 @@ STBIDEF int stbi_is_16_bit(char const *filename) return result; } -STBIDEF int stbi_is_16_bit_from_file(FILE *f) +STBIDEF int stbi_is_16_bit_from_file(FILE* f) { - int r; - stbi__context s; - long pos = ftell(f); - stbi__start_file(&s, f); - r = stbi__is_16_main(&s); - fseek(f,pos,SEEK_SET); - return r; + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__is_16_main(&s); + fseek(f, pos, SEEK_SET); + return r; } #endif // !STBI_NO_STDIO -STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp) +STBIDEF int stbi_info_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp) { - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__info_main(&s,x,y,comp); + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__info_main(&s, x, y, comp); } -STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp) +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const* c, void* user, int* x, int* y, int* comp) { - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); - return stbi__info_main(&s,x,y,comp); + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)c, user); + return stbi__info_main(&s, x, y, comp); } -STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len) +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const* buffer, int len) { - stbi__context s; - stbi__start_mem(&s,buffer,len); - return stbi__is_16_main(&s); + stbi__context s; + stbi__start_mem(&s, buffer, len); + return stbi__is_16_main(&s); } -STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user) +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const* c, void* user) { - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); - return stbi__is_16_main(&s); + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks*)c, user); + return stbi__is_16_main(&s); } #endif // STB_IMAGE_IMPLEMENTATION @@ -7894,4 +8004,4 @@ AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ------------------------------------------------------------------------------ -*/ +*/ \ No newline at end of file diff --git a/ImageWork.cpp b/ImageWork.cpp index 363ddda..d0e0588 100644 --- a/ImageWork.cpp +++ b/ImageWork.cpp @@ -1,4 +1,4 @@ -#include "ImageWork.h" +#include "./ImageWork/ImageWork.h" void ImageWork::init(std::vector** _Images, ImageStr** _CurrentImage) { *_Images = &this->Images; @@ -6,8 +6,6 @@ void ImageWork::init(std::vector** _Images, ImageStr** _CurrentImage) this->interpolationMin = std::pair(this->CurrentImage.width, this->CurrentImage.height); this->interpolationMax = std::pair(0, 0); - - temp = 0; } std::pair ImageWork::getInterpolationMin() { diff --git a/ImageWork/ImageWork.cpp b/ImageWork/ImageWork.cpp new file mode 100644 index 0000000..6cd9fe7 --- /dev/null +++ b/ImageWork/ImageWork.cpp @@ -0,0 +1,173 @@ +#include "ImageWork.h" + +void ImageWork::init(std::vector** _Images, ImageStr** _CurrentImage) { + *_Images = &this->Images; + *_CurrentImage = &this->CurrentImage; + + this->interpolationMin = std::pair(this->CurrentImage.width, this->CurrentImage.height); + this->interpolationMax = std::pair(0, 0); +} + +std::pair ImageWork::getInterpolationMin() { + return this->interpolationMin; +} + +std::pair ImageWork::getInterpolationMax() { + return this->interpolationMax; +} + +void ImageWork::clearMousePoints() { + this->mousePoints.clear(); +} + +void ImageWork::clearMousePairs() { + this->interpolationMin = std::pair(this->CurrentImage.width, this->CurrentImage.height); + this->interpolationMax = std::pair(0, 0); +} + +bool ImageWork::useTool(int _tool, int _MouseImagePositionX, int _MouseImagePositionY) { + + switch (_tool) + { + case 0: + toolPencil(_MouseImagePositionX, _MouseImagePositionY); + break; + case 1: + toolBrush(_MouseImagePositionX, _MouseImagePositionY); + break; + case 2: + toolEraser(_MouseImagePositionX, _MouseImagePositionY); + break; + + default: + break; + } + + return true; +} + +void ImageWork::toolPencil(int _MouseImagePositionX, int _MouseImagePositionY) { + //Add point to mousePoints + mousePoints.push_back(std::make_pair(_MouseImagePositionX, _MouseImagePositionY)); + + //Update interpolation min and max + if (this->interpolationMin.first > _MouseImagePositionX) { + this->interpolationMin.first = _MouseImagePositionX; + } + if (this->interpolationMin.second > _MouseImagePositionY) { + this->interpolationMin.second = _MouseImagePositionY; + } + if (this->interpolationMax.first < _MouseImagePositionX) { + this->interpolationMax.first = _MouseImagePositionX; + } + if (this->interpolationMax.second < _MouseImagePositionY) { + this->interpolationMax.second = _MouseImagePositionY; + } + + //If there is only one point, set the pixel + if (!mousePoints.empty()) { + int index = (_MouseImagePositionY * this->CurrentImage.width * this->CurrentImage.channels) + (_MouseImagePositionX * this->CurrentImage.channels); + CurrentImage.data[index] = static_cast(this->toolcolor.r * 255); + CurrentImage.data[index + 1] = static_cast(this->toolcolor.g * 255); + CurrentImage.data[index + 2] = static_cast(this->toolcolor.b * 255); + if (CurrentImage.channels == 4) { + + CurrentImage.data[index + 3] = 255; + } + } + + //If there are more than 2 points, interpolate + if (mousePoints.size() > 1) { + //Interpolate + int x1 = mousePoints[mousePoints.size() - 2].first; + int y1 = mousePoints[mousePoints.size() - 2].second; + int x2 = mousePoints[mousePoints.size() - 1].first; + int y2 = mousePoints[mousePoints.size() - 1].second; + int dx = abs(x2 - x1); + int dy = abs(y2 - y1); + int sx = x1 < x2 ? 1 : -1; + int sy = y1 < y2 ? 1 : -1; + int err = dx - dy; + int e2; + while (true) { + //Set pixel + int index = (y1 * CurrentImage.width + x1) * CurrentImage.channels; + CurrentImage.data[index] = static_cast(toolcolor.r * 255); + CurrentImage.data[index + 1] = static_cast(toolcolor.g * 255); + CurrentImage.data[index + 2] = static_cast(toolcolor.b * 255); + if (this->CurrentImage.channels == 4) { + CurrentImage.data[index + 3] = 255; + } + if (x1 == x2 && y1 == y2) break; + e2 = 2 * err; + if (e2 > -dy) { err -= dy; x1 += sx; } + if (e2 < dx) { err += dx; y1 += sy; } + } + } + + //If the size is 10 or more clear the vector and let the last two points be the first points for optimization + if (mousePoints.size() >= 10) { + std::pair lastPoint = mousePoints[mousePoints.size() - 1]; + std::pair secondLastPoint = mousePoints[mousePoints.size() - 2]; + mousePoints.clear(); + mousePoints.push_back(secondLastPoint); + mousePoints.push_back(lastPoint); + + //Calculate the new interpolation min and max values with the last two points + if (lastPoint.first < secondLastPoint.first) { + this->interpolationMin.first = lastPoint.first; + this->interpolationMax.first = secondLastPoint.first; + } + else { + this->interpolationMin.first = secondLastPoint.first; + this->interpolationMax.first = lastPoint.first; + } + if (lastPoint.second < secondLastPoint.second) { + this->interpolationMin.second = lastPoint.second; + this->interpolationMax.second = secondLastPoint.second; + } + else { + this->interpolationMin.second = secondLastPoint.second; + this->interpolationMax.second = lastPoint.second; + } + } +} + +void ImageWork::toolBrush(int _MouseImagePositionX, int _MouseImagePositionY) { + +} + +void ImageWork::toolEraser(int _MouseImagePositionX, int _MouseImagePositionY){ + //paint the pixel white + int index = ((_MouseImagePositionY - 1) * this->CurrentImage.width * this->CurrentImage.channels) + ((_MouseImagePositionX - 1) * this->CurrentImage.channels); + //Paint the pixel black + this->CurrentImage.data[index] = 255; + this->CurrentImage.data[index + 1] = 255; + this->CurrentImage.data[index + 2] = 255; + if (this->CurrentImage.channels == 4) { + + this->CurrentImage.data[index + 3] = 255; + } +} + +void ImageWork::selectFrontImage() { + //Set the current Image + this->CurrentImage = this->Images.front(); +} + +void ImageWork::selectImage(int _index) { + //Set the current Image + this->CurrentImage = Images.at(_index); +} + +void ImageWork::swapImage(int _indexa, int _indexb) { + std::swap(this->Images.at(_indexa), this->Images.at(_indexb)); +} + +void ImageWork::setToolColor(RGB _color) { + this->toolcolor = _color; +} + +RGB ImageWork::getToolColor() { + return this->toolcolor; +} \ No newline at end of file diff --git a/ImageWork.h b/ImageWork/ImageWork.h similarity index 99% rename from ImageWork.h rename to ImageWork/ImageWork.h index 654c657..ae8341d 100644 --- a/ImageWork.h +++ b/ImageWork/ImageWork.h @@ -34,7 +34,6 @@ const struct ImageStr { class ImageWork { private: - int temp; std::vector Images; ImageStr CurrentImage; diff --git a/feathergui.cpp b/feathergui.cpp index 8f006c0..7f8e5ea 100644 --- a/feathergui.cpp +++ b/feathergui.cpp @@ -1,6 +1,6 @@ -#include "feathergui.h" -#include "pathwork.h" -#include "IconsFontAwesome.h" +#include "./GUI/feathergui.h" +#include "./Directories/pathwork.h" +#include "./GUI/IconsFontAwesome.h" //TODO /* @@ -22,16 +22,16 @@ void FeatherGUI::BuildGUI() { //LOADING IMAGES /*if (this->Images->empty()) { - if (!loadImage("./resoruces/exampleimages/naranja.png")) { + if (!loadImage("./resources/exampleimages/naranja.png")) { std::cout << "Error Loading the Image test.png" << std::endl; } - if (!loadImage("./resoruces/exampleimages/Cosmic.png")) { + if (!loadImage("./resources/exampleimages/Cosmic.png")) { std::cout << "Error Loading the Image test.png" << std::endl; } - if (!loadImage("./resoruces/exampleimages/Ocean.png")) { + if (!loadImage("./resources/exampleimages/Ocean.png")) { std::cout << "Error Loading the Image test.png" << std::endl; } - if (!loadImage("./resoruces/exampleimages/Skeleton.png")) { + if (!loadImage("./resources/exampleimages/Skeleton.png")) { std::cout << "Error Loading the Image test.png" << std::endl; } @@ -90,7 +90,7 @@ FeatherGUI::FeatherGUI(GLFWwindow* _windowContext, const char* _glsl_version) this->io = &ImGui::GetIO(); (void)io; //io->Fonts->AddFontDefault(); - this->CurrentFont = io->Fonts->AddFontFromFileTTF("./resoruces/fonts/consolas.ttf", 16); + this->CurrentFont = io->Fonts->AddFontFromFileTTF("./resources/fonts/consolas.ttf", 16); ImGui::StyleColorsDark(); this->io->IniFilename = NULL; @@ -122,25 +122,25 @@ FeatherGUI::FeatherGUI(GLFWwindow* _windowContext, const char* _glsl_version) //Adding Icons static const ImWchar icons_ranges[] = { ICON_MIN_FA, ICON_MAX_FA, 0 }; ImFontConfig icons_config; icons_config.MergeMode = true; icons_config.PixelSnapH = true; - io->Fonts->AddFontFromFileTTF("./resoruces/fonts/icon_regular.ttf", this->getIconSize(), &icons_config, icons_ranges); + io->Fonts->AddFontFromFileTTF("./resources/fonts/icon_regular.ttf", this->getIconSize(), &icons_config, icons_ranges); //Loading Icons - if (!loadIcon("./resoruces/icons/Pencil.png")) { + if (!loadIcon("./resources/icons/Pencil.png")) { std::cout << "Error Loading the Image Pencil.png" << std::endl; } - if (!loadIcon("./resoruces/icons/Brush.png")) { + if (!loadIcon("./resources/icons/Brush.png")) { std::cout << "Error Loading the Image Brush.png" << std::endl; } - if (!loadIcon("./resoruces/icons/Rubber.png")) { + if (!loadIcon("./resources/icons/Rubber.png")) { std::cout << "Error Loading the Image Rubber.jpg" << std::endl; } //Load the Black Icons - if (!loadIcon("./resoruces/icons/Black_Pencil.png")) { + if (!loadIcon("./resources/icons/Black_Pencil.png")) { std::cout << "Error Loading the Image Black Pencil.png" << std::endl; } - if (!loadIcon("./resoruces/icons/Black_Brush.png")) { + if (!loadIcon("./resources/icons/Black_Brush.png")) { std::cout << "Error Loading the Image Black Brush.png" << std::endl; } - if (!loadIcon("./resoruces/icons/Black_Rubber.png")) { + if (!loadIcon("./resources/icons/Black_Rubber.png")) { std::cout << "Error Loading the Image Black Rubber.jpg" << std::endl; } diff --git a/main.cpp b/main.cpp index 1ed0d14..0430cc9 100644 --- a/main.cpp +++ b/main.cpp @@ -1,9 +1,4 @@ -#include "pathwork.h" -#include "feathergui.h" - -#define ICONPATH "/Images/Feather.png" - -//#define DEBUG +#include "./GUI/feathergui.h" static void glfw_error_callback(int error, const char* description) { diff --git a/pathwork.h b/pathwork.h deleted file mode 100644 index 753cd2e..0000000 --- a/pathwork.h +++ /dev/null @@ -1,39 +0,0 @@ -#ifndef PATHWORK -#define PATHWORK - -#define WINDOWS_SO -//#define LINUX_SO - -#ifdef WINDOWS_SO -#include -#include -#include -#endif - -#ifdef LINUX -#include -#include -#endif - -#include -#include -#include -#include -#include -#include - -std::string getCurrentPath(); - -std::string getNormalizedPath(); - -#ifdef WINDOWS_SO -std::string browseFile(HWND hwnd); -std::string browseFolder(HWND hwnd, int _option); -#endif - -#ifdef LINUX_SO -std::string browse(); -#endif - - -#endif \ No newline at end of file diff --git a/Images/Feather.ico b/resources/Images/Feather.ico similarity index 100% rename from Images/Feather.ico rename to resources/Images/Feather.ico diff --git a/Images/Feather.png b/resources/Images/Feather.png similarity index 100% rename from Images/Feather.png rename to resources/Images/Feather.png diff --git a/Images/Feather_large.png b/resources/Images/Feather_large.png similarity index 100% rename from Images/Feather_large.png rename to resources/Images/Feather_large.png diff --git a/Images/Feather_medium.png b/resources/Images/Feather_medium.png similarity index 100% rename from Images/Feather_medium.png rename to resources/Images/Feather_medium.png diff --git a/Images/Feather_small.png b/resources/Images/Feather_small.png similarity index 100% rename from Images/Feather_small.png rename to resources/Images/Feather_small.png diff --git a/resoruces/exampleimages/Celestial.png b/resources/exampleimages/Celestial.png similarity index 100% rename from resoruces/exampleimages/Celestial.png rename to resources/exampleimages/Celestial.png diff --git a/resoruces/exampleimages/Cosmic.png b/resources/exampleimages/Cosmic.png similarity index 100% rename from resoruces/exampleimages/Cosmic.png rename to resources/exampleimages/Cosmic.png diff --git a/resoruces/exampleimages/Ocean.png b/resources/exampleimages/Ocean.png similarity index 100% rename from resoruces/exampleimages/Ocean.png rename to resources/exampleimages/Ocean.png diff --git a/resoruces/exampleimages/Skeleton.png b/resources/exampleimages/Skeleton.png similarity index 100% rename from resoruces/exampleimages/Skeleton.png rename to resources/exampleimages/Skeleton.png diff --git a/resoruces/exampleimages/imgui.ini b/resources/exampleimages/imgui.ini similarity index 100% rename from resoruces/exampleimages/imgui.ini rename to resources/exampleimages/imgui.ini diff --git a/resoruces/exampleimages/naranja.png b/resources/exampleimages/naranja.png similarity index 100% rename from resoruces/exampleimages/naranja.png rename to resources/exampleimages/naranja.png diff --git a/resoruces/exampleimages/test.png b/resources/exampleimages/test.png similarity index 100% rename from resoruces/exampleimages/test.png rename to resources/exampleimages/test.png diff --git a/resoruces/exampleimages/test2.png b/resources/exampleimages/test2.png similarity index 100% rename from resoruces/exampleimages/test2.png rename to resources/exampleimages/test2.png diff --git a/resoruces/fonts/consolas.ttf b/resources/fonts/consolas.ttf similarity index 100% rename from resoruces/fonts/consolas.ttf rename to resources/fonts/consolas.ttf diff --git a/resoruces/fonts/icon_regular.ttf b/resources/fonts/icon_regular.ttf similarity index 100% rename from resoruces/fonts/icon_regular.ttf rename to resources/fonts/icon_regular.ttf diff --git a/resoruces/fonts/icon_solid.ttf b/resources/fonts/icon_solid.ttf similarity index 100% rename from resoruces/fonts/icon_solid.ttf rename to resources/fonts/icon_solid.ttf diff --git a/resoruces/icons/Black_Brush.png b/resources/icons/Black_Brush.png similarity index 100% rename from resoruces/icons/Black_Brush.png rename to resources/icons/Black_Brush.png diff --git a/resoruces/icons/Black_Pencil.png b/resources/icons/Black_Pencil.png similarity index 100% rename from resoruces/icons/Black_Pencil.png rename to resources/icons/Black_Pencil.png diff --git a/resoruces/icons/Black_Rubber.png b/resources/icons/Black_Rubber.png similarity index 100% rename from resoruces/icons/Black_Rubber.png rename to resources/icons/Black_Rubber.png diff --git a/resoruces/icons/Brush.png b/resources/icons/Brush.png similarity index 100% rename from resoruces/icons/Brush.png rename to resources/icons/Brush.png diff --git a/resoruces/icons/Pencil.png b/resources/icons/Pencil.png similarity index 100% rename from resoruces/icons/Pencil.png rename to resources/icons/Pencil.png diff --git a/resoruces/icons/Rubber.png b/resources/icons/Rubber.png similarity index 100% rename from resoruces/icons/Rubber.png rename to resources/icons/Rubber.png diff --git a/stb_image.h b/stb_image.h deleted file mode 100644 index eaf8699..0000000 --- a/stb_image.h +++ /dev/null @@ -1,8007 +0,0 @@ -/* stb_image - v2.27 - public domain image loader - http://nothings.org/stb - no warranty implied; use at your own risk - - Do this: - #define STB_IMAGE_IMPLEMENTATION - before you include this file in *one* C or C++ file to create the implementation. - - // i.e. it should look like this: - #include ... - #include ... - #include ... - #define STB_IMAGE_IMPLEMENTATION - #include "stb_image.h" - - You can #define STBI_ASSERT(x) before the #include to avoid using assert.h. - And #define STBI_MALLOC, STBI_REALLOC, and STBI_FREE to avoid using malloc,realloc,free - - - QUICK NOTES: - Primarily of interest to game developers and other people who can - avoid problematic images and only need the trivial interface - - JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib) - PNG 1/2/4/8/16-bit-per-channel - - TGA (not sure what subset, if a subset) - BMP non-1bpp, non-RLE - PSD (composited view only, no extra channels, 8/16 bit-per-channel) - - GIF (*comp always reports as 4-channel) - HDR (radiance rgbE format) - PIC (Softimage PIC) - PNM (PPM and PGM binary only) - - Animated GIF still needs a proper API, but here's one way to do it: - http://gist.github.com/urraka/685d9a6340b26b830d49 - - - decode from memory or through FILE (define STBI_NO_STDIO to remove code) - - decode from arbitrary I/O callbacks - - SIMD acceleration on x86/x64 (SSE2) and ARM (NEON) - - Full documentation under "DOCUMENTATION" below. - - -LICENSE - - See end of file for license information. - -RECENT REVISION HISTORY: - - 2.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes - 2.26 (2020-07-13) many minor fixes - 2.25 (2020-02-02) fix warnings - 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically - 2.23 (2019-08-11) fix clang static analysis warning - 2.22 (2019-03-04) gif fixes, fix warnings - 2.21 (2019-02-25) fix typo in comment - 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs - 2.19 (2018-02-11) fix warning - 2.18 (2018-01-30) fix warnings - 2.17 (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings - 2.16 (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes - 2.15 (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC - 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs - 2.13 (2016-12-04) experimental 16-bit API, only for PNG so far; fixes - 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes - 2.11 (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64 - RGB-format JPEG; remove white matting in PSD; - allocate large structures on the stack; - correct channel count for PNG & BMP - 2.10 (2016-01-22) avoid warning introduced in 2.09 - 2.09 (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED - - See end of file for full revision history. - - - ============================ Contributors ========================= - - Image formats Extensions, features - Sean Barrett (jpeg, png, bmp) Jetro Lauha (stbi_info) - Nicolas Schulz (hdr, psd) Martin "SpartanJ" Golini (stbi_info) - Jonathan Dummer (tga) James "moose2000" Brown (iPhone PNG) - Jean-Marc Lienher (gif) Ben "Disch" Wenger (io callbacks) - Tom Seddon (pic) Omar Cornut (1/2/4-bit PNG) - Thatcher Ulrich (psd) Nicolas Guillemot (vertical flip) - Ken Miller (pgm, ppm) Richard Mitton (16-bit PSD) - github:urraka (animated gif) Junggon Kim (PNM comments) - Christopher Forseth (animated gif) Daniel Gibson (16-bit TGA) - socks-the-fox (16-bit PNG) - Jeremy Sawicki (handle all ImageNet JPGs) - Optimizations & bugfixes Mikhail Morozov (1-bit BMP) - Fabian "ryg" Giesen Anael Seghezzi (is-16-bit query) - Arseny Kapoulkine Simon Breuss (16-bit PNM) - John-Mark Allen - Carmelo J Fdez-Aguera - - Bug & warning fixes - Marc LeBlanc David Woo Guillaume George Martins Mozeiko - Christpher Lloyd Jerry Jansson Joseph Thomson Blazej Dariusz Roszkowski - Phil Jordan Dave Moore Roy Eltham - Hayaki Saito Nathan Reed Won Chun - Luke Graham Johan Duparc Nick Verigakis the Horde3D community - Thomas Ruf Ronny Chevalier github:rlyeh - Janez Zemva John Bartholomew Michal Cichon github:romigrou - Jonathan Blow Ken Hamada Tero Hanninen github:svdijk - Eugene Golushkov Laurent Gomila Cort Stratton github:snagar - Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex - Cass Everitt Ryamond Barbiero github:grim210 - Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw - Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus - Josh Tobin Matthew Gregan github:poppolopoppo - Julian Raschke Gregory Mullen Christian Floisand github:darealshinji - Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 - Brad Weinberger Matvey Cherevko github:mosra - Luca Sas Alexander Veselov Zack Middleton [reserved] - Ryan C. Gordon [reserved] [reserved] - DO NOT ADD YOUR NAME HERE - - Jacko Dirks - - To add your name to the credits, pick a random blank space in the middle and fill it. - 80% of merge conflicts on stb PRs are due to people adding their name at the end - of the credits. -*/ - -#ifndef STBI_INCLUDE_STB_IMAGE_H -#define STBI_INCLUDE_STB_IMAGE_H - -// DOCUMENTATION -// -// Limitations: -// - no 12-bit-per-channel JPEG -// - no JPEGs with arithmetic coding -// - GIF always returns *comp=4 -// -// Basic usage (see HDR discussion below for HDR usage): -// int x,y,n; -// unsigned char *data = stbi_load(filename, &x, &y, &n, 0); -// // ... process data if not NULL ... -// // ... x = width, y = height, n = # 8-bit components per pixel ... -// // ... replace '0' with '1'..'4' to force that many components per pixel -// // ... but 'n' will always be the number that it would have been if you said 0 -// stbi_image_free(data) -// -// Standard parameters: -// int *x -- outputs image width in pixels -// int *y -- outputs image height in pixels -// int *channels_in_file -- outputs # of image components in image file -// int desired_channels -- if non-zero, # of image components requested in result -// -// The return value from an image loader is an 'unsigned char *' which points -// to the pixel data, or NULL on an allocation failure or if the image is -// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels, -// with each pixel consisting of N interleaved 8-bit components; the first -// pixel pointed to is top-left-most in the image. There is no padding between -// image scanlines or between pixels, regardless of format. The number of -// components N is 'desired_channels' if desired_channels is non-zero, or -// *channels_in_file otherwise. If desired_channels is non-zero, -// *channels_in_file has the number of components that _would_ have been -// output otherwise. E.g. if you set desired_channels to 4, you will always -// get RGBA output, but you can check *channels_in_file to see if it's trivially -// opaque because e.g. there were only 3 channels in the source image. -// -// An output image with N components has the following components interleaved -// in this order in each pixel: -// -// N=#comp components -// 1 grey -// 2 grey, alpha -// 3 red, green, blue -// 4 red, green, blue, alpha -// -// If image loading fails for any reason, the return value will be NULL, -// and *x, *y, *channels_in_file will be unchanged. The function -// stbi_failure_reason() can be queried for an extremely brief, end-user -// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS -// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly -// more user-friendly ones. -// -// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized. -// -// To query the width, height and component count of an image without having to -// decode the full file, you can use the stbi_info family of functions: -// -// int x,y,n,ok; -// ok = stbi_info(filename, &x, &y, &n); -// // returns ok=1 and sets x, y, n if image is a supported format, -// // 0 otherwise. -// -// Note that stb_image pervasively uses ints in its public API for sizes, -// including sizes of memory buffers. This is now part of the API and thus -// hard to change without causing breakage. As a result, the various image -// loaders all have certain limits on image size; these differ somewhat -// by format but generally boil down to either just under 2GB or just under -// 1GB. When the decoded image would be larger than this, stb_image decoding -// will fail. -// -// Additionally, stb_image will reject image files that have any of their -// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, -// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, -// the only way to have an image with such dimensions load correctly -// is for it to have a rather extreme aspect ratio. Either way, the -// assumption here is that such larger images are likely to be malformed -// or malicious. If you do need to load an image with individual dimensions -// larger than that, and it still fits in the overall size limit, you can -// #define STBI_MAX_DIMENSIONS on your own to be something larger. -// -// =========================================================================== -// -// UNICODE: -// -// If compiling for Windows and you wish to use Unicode filenames, compile -// with -// #define STBI_WINDOWS_UTF8 -// and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert -// Windows wchar_t filenames to utf8. -// -// =========================================================================== -// -// Philosophy -// -// stb libraries are designed with the following priorities: -// -// 1. easy to use -// 2. easy to maintain -// 3. good performance -// -// Sometimes I let "good performance" creep up in priority over "easy to maintain", -// and for best performance I may provide less-easy-to-use APIs that give higher -// performance, in addition to the easy-to-use ones. Nevertheless, it's important -// to keep in mind that from the standpoint of you, a client of this library, -// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all. -// -// Some secondary priorities arise directly from the first two, some of which -// provide more explicit reasons why performance can't be emphasized. -// -// - Portable ("ease of use") -// - Small source code footprint ("easy to maintain") -// - No dependencies ("ease of use") -// -// =========================================================================== -// -// I/O callbacks -// -// I/O callbacks allow you to read from arbitrary sources, like packaged -// files or some other source. Data read from callbacks are processed -// through a small internal buffer (currently 128 bytes) to try to reduce -// overhead. -// -// The three functions you must define are "read" (reads some bytes of data), -// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end). -// -// =========================================================================== -// -// SIMD support -// -// The JPEG decoder will try to automatically use SIMD kernels on x86 when -// supported by the compiler. For ARM Neon support, you must explicitly -// request it. -// -// (The old do-it-yourself SIMD API is no longer supported in the current -// code.) -// -// On x86, SSE2 will automatically be used when available based on a run-time -// test; if not, the generic C versions are used as a fall-back. On ARM targets, -// the typical path is to have separate builds for NEON and non-NEON devices -// (at least this is true for iOS and Android). Therefore, the NEON support is -// toggled by a build flag: define STBI_NEON to get NEON loops. -// -// If for some reason you do not want to use any of SIMD code, or if -// you have issues compiling it, you can disable it entirely by -// defining STBI_NO_SIMD. -// -// =========================================================================== -// -// HDR image support (disable by defining STBI_NO_HDR) -// -// stb_image supports loading HDR images in general, and currently the Radiance -// .HDR file format specifically. You can still load any file through the existing -// interface; if you attempt to load an HDR file, it will be automatically remapped -// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1; -// both of these constants can be reconfigured through this interface: -// -// stbi_hdr_to_ldr_gamma(2.2f); -// stbi_hdr_to_ldr_scale(1.0f); -// -// (note, do not use _inverse_ constants; stbi_image will invert them -// appropriately). -// -// Additionally, there is a new, parallel interface for loading files as -// (linear) floats to preserve the full dynamic range: -// -// float *data = stbi_loadf(filename, &x, &y, &n, 0); -// -// If you load LDR images through this interface, those images will -// be promoted to floating point values, run through the inverse of -// constants corresponding to the above: -// -// stbi_ldr_to_hdr_scale(1.0f); -// stbi_ldr_to_hdr_gamma(2.2f); -// -// Finally, given a filename (or an open file or memory block--see header -// file for details) containing image data, you can query for the "most -// appropriate" interface to use (that is, whether the image is HDR or -// not), using: -// -// stbi_is_hdr(char *filename); -// -// =========================================================================== -// -// iPhone PNG support: -// -// We optionally support converting iPhone-formatted PNGs (which store -// premultiplied BGRA) back to RGB, even though they're internally encoded -// differently. To enable this conversion, call -// stbi_convert_iphone_png_to_rgb(1). -// -// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per -// pixel to remove any premultiplied alpha *only* if the image file explicitly -// says there's premultiplied data (currently only happens in iPhone images, -// and only if iPhone convert-to-rgb processing is on). -// -// =========================================================================== -// -// ADDITIONAL CONFIGURATION -// -// - You can suppress implementation of any of the decoders to reduce -// your code footprint by #defining one or more of the following -// symbols before creating the implementation. -// -// STBI_NO_JPEG -// STBI_NO_PNG -// STBI_NO_BMP -// STBI_NO_PSD -// STBI_NO_TGA -// STBI_NO_GIF -// STBI_NO_HDR -// STBI_NO_PIC -// STBI_NO_PNM (.ppm and .pgm) -// -// - You can request *only* certain decoders and suppress all other ones -// (this will be more forward-compatible, as addition of new decoders -// doesn't require you to disable them explicitly): -// -// STBI_ONLY_JPEG -// STBI_ONLY_PNG -// STBI_ONLY_BMP -// STBI_ONLY_PSD -// STBI_ONLY_TGA -// STBI_ONLY_GIF -// STBI_ONLY_HDR -// STBI_ONLY_PIC -// STBI_ONLY_PNM (.ppm and .pgm) -// -// - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still -// want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB -// -// - If you define STBI_MAX_DIMENSIONS, stb_image will reject images greater -// than that size (in either width or height) without further processing. -// This is to let programs in the wild set an upper bound to prevent -// denial-of-service attacks on untrusted data, as one could generate a -// valid image of gigantic dimensions and force stb_image to allocate a -// huge block of memory and spend disproportionate time decoding it. By -// default this is set to (1 << 24), which is 16777216, but that's still -// very big. - -#ifndef STBI_NO_STDIO -#include -#endif // STBI_NO_STDIO - -#define STBI_VERSION 1 - -enum -{ - STBI_default = 0, // only used for desired_channels - - STBI_grey = 1, - STBI_grey_alpha = 2, - STBI_rgb = 3, - STBI_rgb_alpha = 4 -}; - -#include -typedef unsigned char stbi_uc; -typedef unsigned short stbi_us; - -#ifdef __cplusplus -extern "C" { -#endif - -#ifndef STBIDEF -#ifdef STB_IMAGE_STATIC -#define STBIDEF static -#else -#define STBIDEF extern -#endif -#endif - - ////////////////////////////////////////////////////////////////////////////// - // - // PRIMARY API - works on images of any type - // - - // - // load image by filename, open file, or memory buffer - // - - typedef struct - { - int (*read) (void* user, char* data, int size); // fill 'data' with 'size' bytes. return number of bytes actually read - void (*skip) (void* user, int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative - int (*eof) (void* user); // returns nonzero if we are at end of file/data - } stbi_io_callbacks; - - //////////////////////////////////// - // - // 8-bits-per-channel interface - // - - STBIDEF stbi_uc* stbi_load_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF stbi_uc* stbi_load_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); - -#ifndef STBI_NO_STDIO - STBIDEF stbi_uc* stbi_load(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF stbi_uc* stbi_load_from_file(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); - // for stbi_load_from_file, file pointer is left pointing immediately after image -#endif - -#ifndef STBI_NO_GIF - STBIDEF stbi_uc* stbi_load_gif_from_memory(stbi_uc const* buffer, int len, int** delays, int* x, int* y, int* z, int* comp, int req_comp); -#endif - -#ifdef STBI_WINDOWS_UTF8 - STBIDEF int stbi_convert_wchar_to_utf8(char* buffer, size_t bufferlen, const wchar_t* input); -#endif - - //////////////////////////////////// - // - // 16-bits-per-channel interface - // - - STBIDEF stbi_us* stbi_load_16_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF stbi_us* stbi_load_16_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); - -#ifndef STBI_NO_STDIO - STBIDEF stbi_us* stbi_load_16(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF stbi_us* stbi_load_from_file_16(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); -#endif - - //////////////////////////////////// - // - // float-per-channel interface - // -#ifndef STBI_NO_LINEAR - STBIDEF float* stbi_loadf_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF float* stbi_loadf_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels); - -#ifndef STBI_NO_STDIO - STBIDEF float* stbi_loadf(char const* filename, int* x, int* y, int* channels_in_file, int desired_channels); - STBIDEF float* stbi_loadf_from_file(FILE* f, int* x, int* y, int* channels_in_file, int desired_channels); -#endif -#endif - -#ifndef STBI_NO_HDR - STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); - STBIDEF void stbi_hdr_to_ldr_scale(float scale); -#endif // STBI_NO_HDR - -#ifndef STBI_NO_LINEAR - STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); - STBIDEF void stbi_ldr_to_hdr_scale(float scale); -#endif // STBI_NO_LINEAR - - // stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR - STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const* clbk, void* user); - STBIDEF int stbi_is_hdr_from_memory(stbi_uc const* buffer, int len); -#ifndef STBI_NO_STDIO - STBIDEF int stbi_is_hdr(char const* filename); - STBIDEF int stbi_is_hdr_from_file(FILE* f); -#endif // STBI_NO_STDIO - - - // get a VERY brief reason for failure - // on most compilers (and ALL modern mainstream compilers) this is threadsafe - STBIDEF const char* stbi_failure_reason(void); - - // free the loaded image -- this is just free() - STBIDEF void stbi_image_free(void* retval_from_stbi_load); - - // get image dimensions & components without fully decoding - STBIDEF int stbi_info_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp); - STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp); - STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const* buffer, int len); - STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const* clbk, void* user); - -#ifndef STBI_NO_STDIO - STBIDEF int stbi_info(char const* filename, int* x, int* y, int* comp); - STBIDEF int stbi_info_from_file(FILE* f, int* x, int* y, int* comp); - STBIDEF int stbi_is_16_bit(char const* filename); - STBIDEF int stbi_is_16_bit_from_file(FILE* f); -#endif - - - - // for image formats that explicitly notate that they have premultiplied alpha, - // we just return the colors as stored in the file. set this flag to force - // unpremultiplication. results are undefined if the unpremultiply overflow. - STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); - - // indicate whether we should process iphone images back to canonical format, - // or just pass them through "as-is" - STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); - - // flip the image vertically, so the first pixel in the output array is the bottom left - STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); - - // as above, but only applies to images loaded on the thread that calls the function - // this function is only available if your compiler supports thread-local variables; - // calling it will fail to link if your compiler doesn't - STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); - STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); - STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); - - // ZLIB client - used by PNG, available for other purposes - - STBIDEF char* stbi_zlib_decode_malloc_guesssize(const char* buffer, int len, int initial_size, int* outlen); - STBIDEF char* stbi_zlib_decode_malloc_guesssize_headerflag(const char* buffer, int len, int initial_size, int* outlen, int parse_header); - STBIDEF char* stbi_zlib_decode_malloc(const char* buffer, int len, int* outlen); - STBIDEF int stbi_zlib_decode_buffer(char* obuffer, int olen, const char* ibuffer, int ilen); - - STBIDEF char* stbi_zlib_decode_noheader_malloc(const char* buffer, int len, int* outlen); - STBIDEF int stbi_zlib_decode_noheader_buffer(char* obuffer, int olen, const char* ibuffer, int ilen); - - -#ifdef __cplusplus -} -#endif - -// -// -//// end header file ///////////////////////////////////////////////////// -#endif // STBI_INCLUDE_STB_IMAGE_H - -#ifdef STB_IMAGE_IMPLEMENTATION - -#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \ - || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \ - || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \ - || defined(STBI_ONLY_ZLIB) -#ifndef STBI_ONLY_JPEG -#define STBI_NO_JPEG -#endif -#ifndef STBI_ONLY_PNG -#define STBI_NO_PNG -#endif -#ifndef STBI_ONLY_BMP -#define STBI_NO_BMP -#endif -#ifndef STBI_ONLY_PSD -#define STBI_NO_PSD -#endif -#ifndef STBI_ONLY_TGA -#define STBI_NO_TGA -#endif -#ifndef STBI_ONLY_GIF -#define STBI_NO_GIF -#endif -#ifndef STBI_ONLY_HDR -#define STBI_NO_HDR -#endif -#ifndef STBI_ONLY_PIC -#define STBI_NO_PIC -#endif -#ifndef STBI_ONLY_PNM -#define STBI_NO_PNM -#endif -#endif - -#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB) -#define STBI_NO_ZLIB -#endif - - -#include -#include // ptrdiff_t on osx -#include -#include -#include - -#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) -#include // ldexp, pow -#endif - -#ifndef STBI_NO_STDIO -#include -#endif - -#ifndef STBI_ASSERT -#include -#define STBI_ASSERT(x) assert(x) -#endif - -#ifdef __cplusplus -#define STBI_EXTERN extern "C" -#else -#define STBI_EXTERN extern -#endif - - -#ifndef _MSC_VER -#ifdef __cplusplus -#define stbi_inline inline -#else -#define stbi_inline -#endif -#else -#define stbi_inline __forceinline -#endif - -#ifndef STBI_NO_THREAD_LOCALS -#if defined(__cplusplus) && __cplusplus >= 201103L -#define STBI_THREAD_LOCAL thread_local -#elif defined(__GNUC__) && __GNUC__ < 5 -#define STBI_THREAD_LOCAL __thread -#elif defined(_MSC_VER) -#define STBI_THREAD_LOCAL __declspec(thread) -#elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) -#define STBI_THREAD_LOCAL _Thread_local -#endif - -#ifndef STBI_THREAD_LOCAL -#if defined(__GNUC__) -#define STBI_THREAD_LOCAL __thread -#endif -#endif -#endif - -#ifdef _MSC_VER -typedef unsigned short stbi__uint16; -typedef signed short stbi__int16; -typedef unsigned int stbi__uint32; -typedef signed int stbi__int32; -#else -#include -typedef uint16_t stbi__uint16; -typedef int16_t stbi__int16; -typedef uint32_t stbi__uint32; -typedef int32_t stbi__int32; -#endif - -// should produce compiler error if size is wrong -typedef unsigned char validate_uint32[sizeof(stbi__uint32) == 4 ? 1 : -1]; - -#ifdef _MSC_VER -#define STBI_NOTUSED(v) (void)(v) -#else -#define STBI_NOTUSED(v) (void)sizeof(v) -#endif - -#ifdef _MSC_VER -#define STBI_HAS_LROTL -#endif - -#ifdef STBI_HAS_LROTL -#define stbi_lrot(x,y) _lrotl(x,y) -#else -#define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) -#endif - -#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) -// ok -#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED) -// ok -#else -#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)." -#endif - -#ifndef STBI_MALLOC -#define STBI_MALLOC(sz) malloc(sz) -#define STBI_REALLOC(p,newsz) realloc(p,newsz) -#define STBI_FREE(p) free(p) -#endif - -#ifndef STBI_REALLOC_SIZED -#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz) -#endif - -// x86/x64 detection -#if defined(__x86_64__) || defined(_M_X64) -#define STBI__X64_TARGET -#elif defined(__i386) || defined(_M_IX86) -#define STBI__X86_TARGET -#endif - -#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD) -// gcc doesn't support sse2 intrinsics unless you compile with -msse2, -// which in turn means it gets to use SSE2 everywhere. This is unfortunate, -// but previous attempts to provide the SSE2 functions with runtime -// detection caused numerous issues. The way architecture extensions are -// exposed in GCC/Clang is, sadly, not really suited for one-file libs. -// New behavior: if compiled with -msse2, we use SSE2 without any -// detection; if not, we don't use it at all. -#define STBI_NO_SIMD -#endif - -#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD) -// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET -// -// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the -// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant. -// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not -// simultaneously enabling "-mstackrealign". -// -// See https://github.com/nothings/stb/issues/81 for more information. -// -// So default to no SSE2 on 32-bit MinGW. If you've read this far and added -// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2. -#define STBI_NO_SIMD -#endif - -#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET)) -#define STBI_SSE2 -#include - -#ifdef _MSC_VER - -#if _MSC_VER >= 1400 // not VC6 -#include // __cpuid -static int stbi__cpuid3(void) -{ - int info[4]; - __cpuid(info, 1); - return info[3]; -} -#else -static int stbi__cpuid3(void) -{ - int res; - __asm { - mov eax, 1 - cpuid - mov res, edx - } - return res; -} -#endif - -#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name - -#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) -static int stbi__sse2_available(void) -{ - int info3 = stbi__cpuid3(); - return ((info3 >> 26) & 1) != 0; -} -#endif - -#else // assume GCC-style if not VC++ -#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) - -#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) -static int stbi__sse2_available(void) -{ - // If we're even attempting to compile this on GCC/Clang, that means - // -msse2 is on, which means the compiler is allowed to use SSE2 - // instructions at will, and so are we. - return 1; -} -#endif - -#endif -#endif - -// ARM NEON -#if defined(STBI_NO_SIMD) && defined(STBI_NEON) -#undef STBI_NEON -#endif - -#ifdef STBI_NEON -#include -#ifdef _MSC_VER -#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name -#else -#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) -#endif -#endif - -#ifndef STBI_SIMD_ALIGN -#define STBI_SIMD_ALIGN(type, name) type name -#endif - -#ifndef STBI_MAX_DIMENSIONS -#define STBI_MAX_DIMENSIONS (1 << 24) -#endif - -/////////////////////////////////////////////// -// -// stbi__context struct and start_xxx functions - -// stbi__context structure is our basic context used by all images, so it -// contains all the IO context, plus some basic image information -typedef struct -{ - stbi__uint32 img_x, img_y; - int img_n, img_out_n; - - stbi_io_callbacks io; - void* io_user_data; - - int read_from_callbacks; - int buflen; - stbi_uc buffer_start[128]; - int callback_already_read; - - stbi_uc* img_buffer, * img_buffer_end; - stbi_uc* img_buffer_original, * img_buffer_original_end; -} stbi__context; - - -static void stbi__refill_buffer(stbi__context* s); - -// initialize a memory-decode context -static void stbi__start_mem(stbi__context* s, stbi_uc const* buffer, int len) -{ - s->io.read = NULL; - s->read_from_callbacks = 0; - s->callback_already_read = 0; - s->img_buffer = s->img_buffer_original = (stbi_uc*)buffer; - s->img_buffer_end = s->img_buffer_original_end = (stbi_uc*)buffer + len; -} - -// initialize a callback-based context -static void stbi__start_callbacks(stbi__context* s, stbi_io_callbacks* c, void* user) -{ - s->io = *c; - s->io_user_data = user; - s->buflen = sizeof(s->buffer_start); - s->read_from_callbacks = 1; - s->callback_already_read = 0; - s->img_buffer = s->img_buffer_original = s->buffer_start; - stbi__refill_buffer(s); - s->img_buffer_original_end = s->img_buffer_end; -} - -#ifndef STBI_NO_STDIO - -static int stbi__stdio_read(void* user, char* data, int size) -{ - return (int)fread(data, 1, size, (FILE*)user); -} - -static void stbi__stdio_skip(void* user, int n) -{ - int ch; - fseek((FILE*)user, n, SEEK_CUR); - ch = fgetc((FILE*)user); /* have to read a byte to reset feof()'s flag */ - if (ch != EOF) { - ungetc(ch, (FILE*)user); /* push byte back onto stream if valid. */ - } -} - -static int stbi__stdio_eof(void* user) -{ - return feof((FILE*)user) || ferror((FILE*)user); -} - -static stbi_io_callbacks stbi__stdio_callbacks = -{ - stbi__stdio_read, - stbi__stdio_skip, - stbi__stdio_eof, -}; - -static void stbi__start_file(stbi__context* s, FILE* f) -{ - stbi__start_callbacks(s, &stbi__stdio_callbacks, (void*)f); -} - -//static void stop_file(stbi__context *s) { } - -#endif // !STBI_NO_STDIO - -static void stbi__rewind(stbi__context* s) -{ - // conceptually rewind SHOULD rewind to the beginning of the stream, - // but we just rewind to the beginning of the initial buffer, because - // we only use it after doing 'test', which only ever looks at at most 92 bytes - s->img_buffer = s->img_buffer_original; - s->img_buffer_end = s->img_buffer_original_end; -} - -enum -{ - STBI_ORDER_RGB, - STBI_ORDER_BGR -}; - -typedef struct -{ - int bits_per_channel; - int num_channels; - int channel_order; -} stbi__result_info; - -#ifndef STBI_NO_JPEG -static int stbi__jpeg_test(stbi__context* s); -static void* stbi__jpeg_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__jpeg_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_PNG -static int stbi__png_test(stbi__context* s); -static void* stbi__png_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__png_info(stbi__context* s, int* x, int* y, int* comp); -static int stbi__png_is16(stbi__context* s); -#endif - -#ifndef STBI_NO_BMP -static int stbi__bmp_test(stbi__context* s); -static void* stbi__bmp_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__bmp_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_TGA -static int stbi__tga_test(stbi__context* s); -static void* stbi__tga_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__tga_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_PSD -static int stbi__psd_test(stbi__context* s); -static void* stbi__psd_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc); -static int stbi__psd_info(stbi__context* s, int* x, int* y, int* comp); -static int stbi__psd_is16(stbi__context* s); -#endif - -#ifndef STBI_NO_HDR -static int stbi__hdr_test(stbi__context* s); -static float* stbi__hdr_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__hdr_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_PIC -static int stbi__pic_test(stbi__context* s); -static void* stbi__pic_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__pic_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_GIF -static int stbi__gif_test(stbi__context* s); -static void* stbi__gif_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static void* stbi__load_gif_main(stbi__context* s, int** delays, int* x, int* y, int* z, int* comp, int req_comp); -static int stbi__gif_info(stbi__context* s, int* x, int* y, int* comp); -#endif - -#ifndef STBI_NO_PNM -static int stbi__pnm_test(stbi__context* s); -static void* stbi__pnm_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri); -static int stbi__pnm_info(stbi__context* s, int* x, int* y, int* comp); -static int stbi__pnm_is16(stbi__context* s); -#endif - -static -#ifdef STBI_THREAD_LOCAL -STBI_THREAD_LOCAL -#endif -const char* stbi__g_failure_reason; - -STBIDEF const char* stbi_failure_reason(void) -{ - return stbi__g_failure_reason; -} - -#ifndef STBI_NO_FAILURE_STRINGS -static int stbi__err(const char* str) -{ - stbi__g_failure_reason = str; - return 0; -} -#endif - -static void* stbi__malloc(size_t size) -{ - return STBI_MALLOC(size); -} - -// stb_image uses ints pervasively, including for offset calculations. -// therefore the largest decoded image size we can support with the -// current code, even on 64-bit targets, is INT_MAX. this is not a -// significant limitation for the intended use case. -// -// we do, however, need to make sure our size calculations don't -// overflow. hence a few helper functions for size calculations that -// multiply integers together, making sure that they're non-negative -// and no overflow occurs. - -// return 1 if the sum is valid, 0 on overflow. -// negative terms are considered invalid. -static int stbi__addsizes_valid(int a, int b) -{ - if (b < 0) return 0; - // now 0 <= b <= INT_MAX, hence also - // 0 <= INT_MAX - b <= INTMAX. - // And "a + b <= INT_MAX" (which might overflow) is the - // same as a <= INT_MAX - b (no overflow) - return a <= INT_MAX - b; -} - -// returns 1 if the product is valid, 0 on overflow. -// negative factors are considered invalid. -static int stbi__mul2sizes_valid(int a, int b) -{ - if (a < 0 || b < 0) return 0; - if (b == 0) return 1; // mul-by-0 is always safe - // portable way to check for no overflows in a*b - return a <= INT_MAX / b; -} - -#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) -// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow -static int stbi__mad2sizes_valid(int a, int b, int add) -{ - return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a * b, add); -} -#endif - -// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow -static int stbi__mad3sizes_valid(int a, int b, int c, int add) -{ - return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a * b, c) && - stbi__addsizes_valid(a * b * c, add); -} - -// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow -#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) -static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) -{ - return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a * b, c) && - stbi__mul2sizes_valid(a * b * c, d) && stbi__addsizes_valid(a * b * c * d, add); -} -#endif - -#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) -// mallocs with size overflow checking -static void* stbi__malloc_mad2(int a, int b, int add) -{ - if (!stbi__mad2sizes_valid(a, b, add)) return NULL; - return stbi__malloc(a * b + add); -} -#endif - -static void* stbi__malloc_mad3(int a, int b, int c, int add) -{ - if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; - return stbi__malloc(a * b * c + add); -} - -#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) -static void* stbi__malloc_mad4(int a, int b, int c, int d, int add) -{ - if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; - return stbi__malloc(a * b * c * d + add); -} -#endif - -// stbi__err - error -// stbi__errpf - error returning pointer to float -// stbi__errpuc - error returning pointer to unsigned char - -#ifdef STBI_NO_FAILURE_STRINGS -#define stbi__err(x,y) 0 -#elif defined(STBI_FAILURE_USERMSG) -#define stbi__err(x,y) stbi__err(y) -#else -#define stbi__err(x,y) stbi__err(x) -#endif - -#define stbi__errpf(x,y) ((float *)(size_t) (stbi__err(x,y)?NULL:NULL)) -#define stbi__errpuc(x,y) ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL)) - -STBIDEF void stbi_image_free(void* retval_from_stbi_load) -{ - STBI_FREE(retval_from_stbi_load); -} - -#ifndef STBI_NO_LINEAR -static float* stbi__ldr_to_hdr(stbi_uc* data, int x, int y, int comp); -#endif - -#ifndef STBI_NO_HDR -static stbi_uc* stbi__hdr_to_ldr(float* data, int x, int y, int comp); -#endif - -static int stbi__vertically_flip_on_load_global = 0; - -STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) -{ - stbi__vertically_flip_on_load_global = flag_true_if_should_flip; -} - -#ifndef STBI_THREAD_LOCAL -#define stbi__vertically_flip_on_load stbi__vertically_flip_on_load_global -#else -static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertically_flip_on_load_set; - -STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) -{ - stbi__vertically_flip_on_load_local = flag_true_if_should_flip; - stbi__vertically_flip_on_load_set = 1; -} - -#define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ - ? stbi__vertically_flip_on_load_local \ - : stbi__vertically_flip_on_load_global) -#endif // STBI_THREAD_LOCAL - -static void* stbi__load_main(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc) -{ - memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields - ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed - ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order - ri->num_channels = 0; - - // test the formats with a very explicit header first (at least a FOURCC - // or distinctive magic number first) -#ifndef STBI_NO_PNG - if (stbi__png_test(s)) return stbi__png_load(s, x, y, comp, req_comp, ri); -#endif -#ifndef STBI_NO_BMP - if (stbi__bmp_test(s)) return stbi__bmp_load(s, x, y, comp, req_comp, ri); -#endif -#ifndef STBI_NO_GIF - if (stbi__gif_test(s)) return stbi__gif_load(s, x, y, comp, req_comp, ri); -#endif -#ifndef STBI_NO_PSD - if (stbi__psd_test(s)) return stbi__psd_load(s, x, y, comp, req_comp, ri, bpc); -#else - STBI_NOTUSED(bpc); -#endif -#ifndef STBI_NO_PIC - if (stbi__pic_test(s)) return stbi__pic_load(s, x, y, comp, req_comp, ri); -#endif - - // then the formats that can end up attempting to load with just 1 or 2 - // bytes matching expectations; these are prone to false positives, so - // try them later -#ifndef STBI_NO_JPEG - if (stbi__jpeg_test(s)) return stbi__jpeg_load(s, x, y, comp, req_comp, ri); -#endif -#ifndef STBI_NO_PNM - if (stbi__pnm_test(s)) return stbi__pnm_load(s, x, y, comp, req_comp, ri); -#endif - -#ifndef STBI_NO_HDR - if (stbi__hdr_test(s)) { - float* hdr = stbi__hdr_load(s, x, y, comp, req_comp, ri); - return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); - } -#endif - -#ifndef STBI_NO_TGA - // test tga last because it's a crappy test! - if (stbi__tga_test(s)) - return stbi__tga_load(s, x, y, comp, req_comp, ri); -#endif - - return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); -} - -static stbi_uc* stbi__convert_16_to_8(stbi__uint16* orig, int w, int h, int channels) -{ - int i; - int img_len = w * h * channels; - stbi_uc* reduced; - - reduced = (stbi_uc*)stbi__malloc(img_len); - if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); - - for (i = 0; i < img_len; ++i) - reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling - - STBI_FREE(orig); - return reduced; -} - -static stbi__uint16* stbi__convert_8_to_16(stbi_uc* orig, int w, int h, int channels) -{ - int i; - int img_len = w * h * channels; - stbi__uint16* enlarged; - - enlarged = (stbi__uint16*)stbi__malloc(img_len * 2); - if (enlarged == NULL) return (stbi__uint16*)stbi__errpuc("outofmem", "Out of memory"); - - for (i = 0; i < img_len; ++i) - enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff - - STBI_FREE(orig); - return enlarged; -} - -static void stbi__vertical_flip(void* image, int w, int h, int bytes_per_pixel) -{ - int row; - size_t bytes_per_row = (size_t)w * bytes_per_pixel; - stbi_uc temp[2048]; - stbi_uc* bytes = (stbi_uc*)image; - - for (row = 0; row < (h >> 1); row++) { - stbi_uc* row0 = bytes + row * bytes_per_row; - stbi_uc* row1 = bytes + (h - row - 1) * bytes_per_row; - // swap row0 with row1 - size_t bytes_left = bytes_per_row; - while (bytes_left) { - size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); - memcpy(temp, row0, bytes_copy); - memcpy(row0, row1, bytes_copy); - memcpy(row1, temp, bytes_copy); - row0 += bytes_copy; - row1 += bytes_copy; - bytes_left -= bytes_copy; - } - } -} - -#ifndef STBI_NO_GIF -static void stbi__vertical_flip_slices(void* image, int w, int h, int z, int bytes_per_pixel) -{ - int slice; - int slice_size = w * h * bytes_per_pixel; - - stbi_uc* bytes = (stbi_uc*)image; - for (slice = 0; slice < z; ++slice) { - stbi__vertical_flip(bytes, w, h, bytes_per_pixel); - bytes += slice_size; - } -} -#endif - -static unsigned char* stbi__load_and_postprocess_8bit(stbi__context* s, int* x, int* y, int* comp, int req_comp) -{ - stbi__result_info ri; - void* result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); - - if (result == NULL) - return NULL; - - // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. - STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); - - if (ri.bits_per_channel != 8) { - result = stbi__convert_16_to_8((stbi__uint16*)result, *x, *y, req_comp == 0 ? *comp : req_comp); - ri.bits_per_channel = 8; - } - - // @TODO: move stbi__convert_format to here - - if (stbi__vertically_flip_on_load) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); - } - - return (unsigned char*)result; -} - -static stbi__uint16* stbi__load_and_postprocess_16bit(stbi__context* s, int* x, int* y, int* comp, int req_comp) -{ - stbi__result_info ri; - void* result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); - - if (result == NULL) - return NULL; - - // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. - STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); - - if (ri.bits_per_channel != 16) { - result = stbi__convert_8_to_16((stbi_uc*)result, *x, *y, req_comp == 0 ? *comp : req_comp); - ri.bits_per_channel = 16; - } - - // @TODO: move stbi__convert_format16 to here - // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision - - if (stbi__vertically_flip_on_load) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); - } - - return (stbi__uint16*)result; -} - -#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR) -static void stbi__float_postprocess(float* result, int* x, int* y, int* comp, int req_comp) -{ - if (stbi__vertically_flip_on_load && result != NULL) { - int channels = req_comp ? req_comp : *comp; - stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); - } -} -#endif - -#ifndef STBI_NO_STDIO - -#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) -STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char* str, int cbmb, wchar_t* widestr, int cchwide); -STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t* widestr, int cchwide, char* str, int cbmb, const char* defchar, int* used_default); -#endif - -#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) -STBIDEF int stbi_convert_wchar_to_utf8(char* buffer, size_t bufferlen, const wchar_t* input) -{ - return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int)bufferlen, NULL, NULL); -} -#endif - -static FILE* stbi__fopen(char const* filename, char const* mode) -{ - FILE* f; -#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) - wchar_t wMode[64]; - wchar_t wFilename[1024]; - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename) / sizeof(*wFilename))) - return 0; - - if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode) / sizeof(*wMode))) - return 0; - -#if defined(_MSC_VER) && _MSC_VER >= 1400 - if (0 != _wfopen_s(&f, wFilename, wMode)) - f = 0; -#else - f = _wfopen(wFilename, wMode); -#endif - -#elif defined(_MSC_VER) && _MSC_VER >= 1400 - if (0 != fopen_s(&f, filename, mode)) - f = 0; -#else - f = fopen(filename, mode); -#endif - return f; -} - - -STBIDEF stbi_uc* stbi_load(char const* filename, int* x, int* y, int* comp, int req_comp) -{ - FILE* f = stbi__fopen(filename, "rb"); - unsigned char* result; - if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); - result = stbi_load_from_file(f, x, y, comp, req_comp); - fclose(f); - return result; -} - -STBIDEF stbi_uc* stbi_load_from_file(FILE* f, int* x, int* y, int* comp, int req_comp) -{ - unsigned char* result; - stbi__context s; - stbi__start_file(&s, f); - result = stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); - if (result) { - // need to 'unget' all the characters in the IO buffer - fseek(f, -(int)(s.img_buffer_end - s.img_buffer), SEEK_CUR); - } - return result; -} - -STBIDEF stbi__uint16* stbi_load_from_file_16(FILE* f, int* x, int* y, int* comp, int req_comp) -{ - stbi__uint16* result; - stbi__context s; - stbi__start_file(&s, f); - result = stbi__load_and_postprocess_16bit(&s, x, y, comp, req_comp); - if (result) { - // need to 'unget' all the characters in the IO buffer - fseek(f, -(int)(s.img_buffer_end - s.img_buffer), SEEK_CUR); - } - return result; -} - -STBIDEF stbi_us* stbi_load_16(char const* filename, int* x, int* y, int* comp, int req_comp) -{ - FILE* f = stbi__fopen(filename, "rb"); - stbi__uint16* result; - if (!f) return (stbi_us*)stbi__errpuc("can't fopen", "Unable to open file"); - result = stbi_load_from_file_16(f, x, y, comp, req_comp); - fclose(f); - return result; -} - - -#endif //!STBI_NO_STDIO - -STBIDEF stbi_us* stbi_load_16_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* channels_in_file, int desired_channels) -{ - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__load_and_postprocess_16bit(&s, x, y, channels_in_file, desired_channels); -} - -STBIDEF stbi_us* stbi_load_16_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* channels_in_file, int desired_channels) -{ - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); - return stbi__load_and_postprocess_16bit(&s, x, y, channels_in_file, desired_channels); -} - -STBIDEF stbi_uc* stbi_load_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp, int req_comp) -{ - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); -} - -STBIDEF stbi_uc* stbi_load_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp, int req_comp) -{ - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); - return stbi__load_and_postprocess_8bit(&s, x, y, comp, req_comp); -} - -#ifndef STBI_NO_GIF -STBIDEF stbi_uc* stbi_load_gif_from_memory(stbi_uc const* buffer, int len, int** delays, int* x, int* y, int* z, int* comp, int req_comp) -{ - unsigned char* result; - stbi__context s; - stbi__start_mem(&s, buffer, len); - - result = (unsigned char*)stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); - if (stbi__vertically_flip_on_load) { - stbi__vertical_flip_slices(result, *x, *y, *z, *comp); - } - - return result; -} -#endif - -#ifndef STBI_NO_LINEAR -static float* stbi__loadf_main(stbi__context* s, int* x, int* y, int* comp, int req_comp) -{ - unsigned char* data; -#ifndef STBI_NO_HDR - if (stbi__hdr_test(s)) { - stbi__result_info ri; - float* hdr_data = stbi__hdr_load(s, x, y, comp, req_comp, &ri); - if (hdr_data) - stbi__float_postprocess(hdr_data, x, y, comp, req_comp); - return hdr_data; - } -#endif - data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); - if (data) - return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); - return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); -} - -STBIDEF float* stbi_loadf_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp, int req_comp) -{ - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__loadf_main(&s, x, y, comp, req_comp); -} - -STBIDEF float* stbi_loadf_from_callbacks(stbi_io_callbacks const* clbk, void* user, int* x, int* y, int* comp, int req_comp) -{ - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); - return stbi__loadf_main(&s, x, y, comp, req_comp); -} - -#ifndef STBI_NO_STDIO -STBIDEF float* stbi_loadf(char const* filename, int* x, int* y, int* comp, int req_comp) -{ - float* result; - FILE* f = stbi__fopen(filename, "rb"); - if (!f) return stbi__errpf("can't fopen", "Unable to open file"); - result = stbi_loadf_from_file(f, x, y, comp, req_comp); - fclose(f); - return result; -} - -STBIDEF float* stbi_loadf_from_file(FILE* f, int* x, int* y, int* comp, int req_comp) -{ - stbi__context s; - stbi__start_file(&s, f); - return stbi__loadf_main(&s, x, y, comp, req_comp); -} -#endif // !STBI_NO_STDIO - -#endif // !STBI_NO_LINEAR - -// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is -// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always -// reports false! - -STBIDEF int stbi_is_hdr_from_memory(stbi_uc const* buffer, int len) -{ -#ifndef STBI_NO_HDR - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__hdr_test(&s); -#else - STBI_NOTUSED(buffer); - STBI_NOTUSED(len); - return 0; -#endif -} - -#ifndef STBI_NO_STDIO -STBIDEF int stbi_is_hdr(char const* filename) -{ - FILE* f = stbi__fopen(filename, "rb"); - int result = 0; - if (f) { - result = stbi_is_hdr_from_file(f); - fclose(f); - } - return result; -} - -STBIDEF int stbi_is_hdr_from_file(FILE* f) -{ -#ifndef STBI_NO_HDR - long pos = ftell(f); - int res; - stbi__context s; - stbi__start_file(&s, f); - res = stbi__hdr_test(&s); - fseek(f, pos, SEEK_SET); - return res; -#else - STBI_NOTUSED(f); - return 0; -#endif -} -#endif // !STBI_NO_STDIO - -STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const* clbk, void* user) -{ -#ifndef STBI_NO_HDR - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)clbk, user); - return stbi__hdr_test(&s); -#else - STBI_NOTUSED(clbk); - STBI_NOTUSED(user); - return 0; -#endif -} - -#ifndef STBI_NO_LINEAR -static float stbi__l2h_gamma = 2.2f, stbi__l2h_scale = 1.0f; - -STBIDEF void stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; } -STBIDEF void stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; } -#endif - -static float stbi__h2l_gamma_i = 1.0f / 2.2f, stbi__h2l_scale_i = 1.0f; - -STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1 / gamma; } -STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1 / scale; } - - -////////////////////////////////////////////////////////////////////////////// -// -// Common code used by all image loaders -// - -enum -{ - STBI__SCAN_load = 0, - STBI__SCAN_type, - STBI__SCAN_header -}; - -static void stbi__refill_buffer(stbi__context* s) -{ - int n = (s->io.read)(s->io_user_data, (char*)s->buffer_start, s->buflen); - s->callback_already_read += (int)(s->img_buffer - s->img_buffer_original); - if (n == 0) { - // at end of file, treat same as if from memory, but need to handle case - // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file - s->read_from_callbacks = 0; - s->img_buffer = s->buffer_start; - s->img_buffer_end = s->buffer_start + 1; - *s->img_buffer = 0; - } - else { - s->img_buffer = s->buffer_start; - s->img_buffer_end = s->buffer_start + n; - } -} - -stbi_inline static stbi_uc stbi__get8(stbi__context* s) -{ - if (s->img_buffer < s->img_buffer_end) - return *s->img_buffer++; - if (s->read_from_callbacks) { - stbi__refill_buffer(s); - return *s->img_buffer++; - } - return 0; -} - -#if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) -// nothing -#else -stbi_inline static int stbi__at_eof(stbi__context* s) -{ - if (s->io.read) { - if (!(s->io.eof)(s->io_user_data)) return 0; - // if feof() is true, check if buffer = end - // special case: we've only got the special 0 character at the end - if (s->read_from_callbacks == 0) return 1; - } - - return s->img_buffer >= s->img_buffer_end; -} -#endif - -#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) -// nothing -#else -static void stbi__skip(stbi__context* s, int n) -{ - if (n == 0) return; // already there! - if (n < 0) { - s->img_buffer = s->img_buffer_end; - return; - } - if (s->io.read) { - int blen = (int)(s->img_buffer_end - s->img_buffer); - if (blen < n) { - s->img_buffer = s->img_buffer_end; - (s->io.skip)(s->io_user_data, n - blen); - return; - } - } - s->img_buffer += n; -} -#endif - -#if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) -// nothing -#else -static int stbi__getn(stbi__context* s, stbi_uc* buffer, int n) -{ - if (s->io.read) { - int blen = (int)(s->img_buffer_end - s->img_buffer); - if (blen < n) { - int res, count; - - memcpy(buffer, s->img_buffer, blen); - - count = (s->io.read)(s->io_user_data, (char*)buffer + blen, n - blen); - res = (count == (n - blen)); - s->img_buffer = s->img_buffer_end; - return res; - } - } - - if (s->img_buffer + n <= s->img_buffer_end) { - memcpy(buffer, s->img_buffer, n); - s->img_buffer += n; - return 1; - } - else - return 0; -} -#endif - -#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) -// nothing -#else -static int stbi__get16be(stbi__context* s) -{ - int z = stbi__get8(s); - return (z << 8) + stbi__get8(s); -} -#endif - -#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) -// nothing -#else -static stbi__uint32 stbi__get32be(stbi__context* s) -{ - stbi__uint32 z = stbi__get16be(s); - return (z << 16) + stbi__get16be(s); -} -#endif - -#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) -// nothing -#else -static int stbi__get16le(stbi__context* s) -{ - int z = stbi__get8(s); - return z + (stbi__get8(s) << 8); -} -#endif - -#ifndef STBI_NO_BMP -static stbi__uint32 stbi__get32le(stbi__context* s) -{ - stbi__uint32 z = stbi__get16le(s); - z += (stbi__uint32)stbi__get16le(s) << 16; - return z; -} -#endif - -#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings - -#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) -// nothing -#else -////////////////////////////////////////////////////////////////////////////// -// -// generic converter from built-in img_n to req_comp -// individual types do this automatically as much as possible (e.g. jpeg -// does all cases internally since it needs to colorspace convert anyway, -// and it never has alpha, so very few cases ). png can automatically -// interleave an alpha=255 channel, but falls back to this for other cases -// -// assume data buffer is malloced, so malloc a new one and free that one -// only failure mode is malloc failing - -static stbi_uc stbi__compute_y(int r, int g, int b) -{ - return (stbi_uc)(((r * 77) + (g * 150) + (29 * b)) >> 8); -} -#endif - -#if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) -// nothing -#else -static unsigned char* stbi__convert_format(unsigned char* data, int img_n, int req_comp, unsigned int x, unsigned int y) -{ - int i, j; - unsigned char* good; - - if (req_comp == img_n) return data; - STBI_ASSERT(req_comp >= 1 && req_comp <= 4); - - good = (unsigned char*)stbi__malloc_mad3(req_comp, x, y, 0); - if (good == NULL) { - STBI_FREE(data); - return stbi__errpuc("outofmem", "Out of memory"); - } - - for (j = 0; j < (int)y; ++j) { - unsigned char* src = data + j * x * img_n; - unsigned char* dest = good + j * x * req_comp; - -#define STBI__COMBO(a,b) ((a)*8+(b)) -#define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) - // convert source image with img_n components to one with req_comp components; - // avoid switch per pixel, so use switch per scanline and massive macros - switch (STBI__COMBO(img_n, req_comp)) { - STBI__CASE(1, 2) { dest[0] = src[0]; dest[1] = 255; } break; - STBI__CASE(1, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; - STBI__CASE(1, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = 255; } break; - STBI__CASE(2, 1) { dest[0] = src[0]; } break; - STBI__CASE(2, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; - STBI__CASE(2, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = src[1]; } break; - STBI__CASE(3, 4) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; dest[3] = 255; } break; - STBI__CASE(3, 1) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); } break; - STBI__CASE(3, 2) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); dest[1] = 255; } break; - STBI__CASE(4, 1) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); } break; - STBI__CASE(4, 2) { dest[0] = stbi__compute_y(src[0], src[1], src[2]); dest[1] = src[3]; } break; - STBI__CASE(4, 3) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; } break; - default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); - } -#undef STBI__CASE - } - - STBI_FREE(data); - return good; -} -#endif - -#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) -// nothing -#else -static stbi__uint16 stbi__compute_y_16(int r, int g, int b) -{ - return (stbi__uint16)(((r * 77) + (g * 150) + (29 * b)) >> 8); -} -#endif - -#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) -// nothing -#else -static stbi__uint16* stbi__convert_format16(stbi__uint16* data, int img_n, int req_comp, unsigned int x, unsigned int y) -{ - int i, j; - stbi__uint16* good; - - if (req_comp == img_n) return data; - STBI_ASSERT(req_comp >= 1 && req_comp <= 4); - - good = (stbi__uint16*)stbi__malloc(req_comp * x * y * 2); - if (good == NULL) { - STBI_FREE(data); - return (stbi__uint16*)stbi__errpuc("outofmem", "Out of memory"); - } - - for (j = 0; j < (int)y; ++j) { - stbi__uint16* src = data + j * x * img_n; - stbi__uint16* dest = good + j * x * req_comp; - -#define STBI__COMBO(a,b) ((a)*8+(b)) -#define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) - // convert source image with img_n components to one with req_comp components; - // avoid switch per pixel, so use switch per scanline and massive macros - switch (STBI__COMBO(img_n, req_comp)) { - STBI__CASE(1, 2) { dest[0] = src[0]; dest[1] = 0xffff; } break; - STBI__CASE(1, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; - STBI__CASE(1, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = 0xffff; } break; - STBI__CASE(2, 1) { dest[0] = src[0]; } break; - STBI__CASE(2, 3) { dest[0] = dest[1] = dest[2] = src[0]; } break; - STBI__CASE(2, 4) { dest[0] = dest[1] = dest[2] = src[0]; dest[3] = src[1]; } break; - STBI__CASE(3, 4) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; dest[3] = 0xffff; } break; - STBI__CASE(3, 1) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); } break; - STBI__CASE(3, 2) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); dest[1] = 0xffff; } break; - STBI__CASE(4, 1) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); } break; - STBI__CASE(4, 2) { dest[0] = stbi__compute_y_16(src[0], src[1], src[2]); dest[1] = src[3]; } break; - STBI__CASE(4, 3) { dest[0] = src[0]; dest[1] = src[1]; dest[2] = src[2]; } break; - default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*)stbi__errpuc("unsupported", "Unsupported format conversion"); - } -#undef STBI__CASE - } - - STBI_FREE(data); - return good; -} -#endif - -#ifndef STBI_NO_LINEAR -static float* stbi__ldr_to_hdr(stbi_uc* data, int x, int y, int comp) -{ - int i, k, n; - float* output; - if (!data) return NULL; - output = (float*)stbi__malloc_mad4(x, y, comp, sizeof(float), 0); - if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } - // compute number of non-alpha components - if (comp & 1) n = comp; else n = comp - 1; - for (i = 0; i < x * y; ++i) { - for (k = 0; k < n; ++k) { - output[i * comp + k] = (float)(pow(data[i * comp + k] / 255.0f, stbi__l2h_gamma) * stbi__l2h_scale); - } - } - if (n < comp) { - for (i = 0; i < x * y; ++i) { - output[i * comp + n] = data[i * comp + n] / 255.0f; - } - } - STBI_FREE(data); - return output; -} -#endif - -#ifndef STBI_NO_HDR -#define stbi__float2int(x) ((int) (x)) -static stbi_uc* stbi__hdr_to_ldr(float* data, int x, int y, int comp) -{ - int i, k, n; - stbi_uc* output; - if (!data) return NULL; - output = (stbi_uc*)stbi__malloc_mad3(x, y, comp, 0); - if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } - // compute number of non-alpha components - if (comp & 1) n = comp; else n = comp - 1; - for (i = 0; i < x * y; ++i) { - for (k = 0; k < n; ++k) { - float z = (float)pow(data[i * comp + k] * stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; - if (z < 0) z = 0; - if (z > 255) z = 255; - output[i * comp + k] = (stbi_uc)stbi__float2int(z); - } - if (k < comp) { - float z = data[i * comp + k] * 255 + 0.5f; - if (z < 0) z = 0; - if (z > 255) z = 255; - output[i * comp + k] = (stbi_uc)stbi__float2int(z); - } - } - STBI_FREE(data); - return output; -} -#endif - -////////////////////////////////////////////////////////////////////////////// -// -// "baseline" JPEG/JFIF decoder -// -// simple implementation -// - doesn't support delayed output of y-dimension -// - simple interface (only one output format: 8-bit interleaved RGB) -// - doesn't try to recover corrupt jpegs -// - doesn't allow partial loading, loading multiple at once -// - still fast on x86 (copying globals into locals doesn't help x86) -// - allocates lots of intermediate memory (full size of all components) -// - non-interleaved case requires this anyway -// - allows good upsampling (see next) -// high-quality -// - upsampled channels are bilinearly interpolated, even across blocks -// - quality integer IDCT derived from IJG's 'slow' -// performance -// - fast huffman; reasonable integer IDCT -// - some SIMD kernels for common paths on targets with SSE2/NEON -// - uses a lot of intermediate memory, could cache poorly - -#ifndef STBI_NO_JPEG - -// huffman decoding acceleration -#define FAST_BITS 9 // larger handles more cases; smaller stomps less cache - -typedef struct -{ - stbi_uc fast[1 << FAST_BITS]; - // weirdly, repacking this into AoS is a 10% speed loss, instead of a win - stbi__uint16 code[256]; - stbi_uc values[256]; - stbi_uc size[257]; - unsigned int maxcode[18]; - int delta[17]; // old 'firstsymbol' - old 'firstcode' -} stbi__huffman; - -typedef struct -{ - stbi__context* s; - stbi__huffman huff_dc[4]; - stbi__huffman huff_ac[4]; - stbi__uint16 dequant[4][64]; - stbi__int16 fast_ac[4][1 << FAST_BITS]; - - // sizes for components, interleaved MCUs - int img_h_max, img_v_max; - int img_mcu_x, img_mcu_y; - int img_mcu_w, img_mcu_h; - - // definition of jpeg image component - struct - { - int id; - int h, v; - int tq; - int hd, ha; - int dc_pred; - - int x, y, w2, h2; - stbi_uc* data; - void* raw_data, * raw_coeff; - stbi_uc* linebuf; - short* coeff; // progressive only - int coeff_w, coeff_h; // number of 8x8 coefficient blocks - } img_comp[4]; - - stbi__uint32 code_buffer; // jpeg entropy-coded buffer - int code_bits; // number of valid bits - unsigned char marker; // marker seen while filling entropy buffer - int nomore; // flag if we saw a marker so must stop - - int progressive; - int spec_start; - int spec_end; - int succ_high; - int succ_low; - int eob_run; - int jfif; - int app14_color_transform; // Adobe APP14 tag - int rgb; - - int scan_n, order[4]; - int restart_interval, todo; - - // kernels - void (*idct_block_kernel)(stbi_uc* out, int out_stride, short data[64]); - void (*YCbCr_to_RGB_kernel)(stbi_uc* out, const stbi_uc* y, const stbi_uc* pcb, const stbi_uc* pcr, int count, int step); - stbi_uc* (*resample_row_hv_2_kernel)(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs); -} stbi__jpeg; - -static int stbi__build_huffman(stbi__huffman* h, int* count) -{ - int i, j, k = 0; - unsigned int code; - // build size list for each symbol (from JPEG spec) - for (i = 0; i < 16; ++i) - for (j = 0; j < count[i]; ++j) - h->size[k++] = (stbi_uc)(i + 1); - h->size[k] = 0; - - // compute actual symbols (from jpeg spec) - code = 0; - k = 0; - for (j = 1; j <= 16; ++j) { - // compute delta to add to code to compute symbol id - h->delta[j] = k - code; - if (h->size[k] == j) { - while (h->size[k] == j) - h->code[k++] = (stbi__uint16)(code++); - if (code - 1 >= (1u << j)) return stbi__err("bad code lengths", "Corrupt JPEG"); - } - // compute largest code + 1 for this size, preshifted as needed later - h->maxcode[j] = code << (16 - j); - code <<= 1; - } - h->maxcode[j] = 0xffffffff; - - // build non-spec acceleration table; 255 is flag for not-accelerated - memset(h->fast, 255, 1 << FAST_BITS); - for (i = 0; i < k; ++i) { - int s = h->size[i]; - if (s <= FAST_BITS) { - int c = h->code[i] << (FAST_BITS - s); - int m = 1 << (FAST_BITS - s); - for (j = 0; j < m; ++j) { - h->fast[c + j] = (stbi_uc)i; - } - } - } - return 1; -} - -// build a table that decodes both magnitude and value of small ACs in -// one go. -static void stbi__build_fast_ac(stbi__int16* fast_ac, stbi__huffman* h) -{ - int i; - for (i = 0; i < (1 << FAST_BITS); ++i) { - stbi_uc fast = h->fast[i]; - fast_ac[i] = 0; - if (fast < 255) { - int rs = h->values[fast]; - int run = (rs >> 4) & 15; - int magbits = rs & 15; - int len = h->size[fast]; - - if (magbits && len + magbits <= FAST_BITS) { - // magnitude code followed by receive_extend code - int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); - int m = 1 << (magbits - 1); - if (k < m) k += (~0U << magbits) + 1; - // if the result is small enough, we can fit it in fast_ac table - if (k >= -128 && k <= 127) - fast_ac[i] = (stbi__int16)((k * 256) + (run * 16) + (len + magbits)); - } - } - } -} - -static void stbi__grow_buffer_unsafe(stbi__jpeg* j) -{ - do { - unsigned int b = j->nomore ? 0 : stbi__get8(j->s); - if (b == 0xff) { - int c = stbi__get8(j->s); - while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes - if (c != 0) { - j->marker = (unsigned char)c; - j->nomore = 1; - return; - } - } - j->code_buffer |= b << (24 - j->code_bits); - j->code_bits += 8; - } while (j->code_bits <= 24); -} - -// (1 << n) - 1 -static const stbi__uint32 stbi__bmask[17] = { 0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535 }; - -// decode a jpeg huffman value from the bitstream -stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg* j, stbi__huffman* h) -{ - unsigned int temp; - int c, k; - - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - - // look at the top FAST_BITS and determine what symbol ID it is, - // if the code is <= FAST_BITS - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); - k = h->fast[c]; - if (k < 255) { - int s = h->size[k]; - if (s > j->code_bits) - return -1; - j->code_buffer <<= s; - j->code_bits -= s; - return h->values[k]; - } - - // naive test is to shift the code_buffer down so k bits are - // valid, then test against maxcode. To speed this up, we've - // preshifted maxcode left so that it has (16-k) 0s at the - // end; in other words, regardless of the number of bits, it - // wants to be compared against something shifted to have 16; - // that way we don't need to shift inside the loop. - temp = j->code_buffer >> 16; - for (k = FAST_BITS + 1; ; ++k) - if (temp < h->maxcode[k]) - break; - if (k == 17) { - // error! code not found - j->code_bits -= 16; - return -1; - } - - if (k > j->code_bits) - return -1; - - // convert the huffman code to the symbol id - c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; - STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); - - // convert the id to a symbol - j->code_bits -= k; - j->code_buffer <<= k; - return h->values[c]; -} - -// bias[n] = (-1<code_bits < n) stbi__grow_buffer_unsafe(j); - - sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) - k = stbi_lrot(j->code_buffer, n); - j->code_buffer = k & ~stbi__bmask[n]; - k &= stbi__bmask[n]; - j->code_bits -= n; - return k + (stbi__jbias[n] & (sgn - 1)); -} - -// get some unsigned bits -stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg* j, int n) -{ - unsigned int k; - if (j->code_bits < n) stbi__grow_buffer_unsafe(j); - k = stbi_lrot(j->code_buffer, n); - j->code_buffer = k & ~stbi__bmask[n]; - k &= stbi__bmask[n]; - j->code_bits -= n; - return k; -} - -stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg* j) -{ - unsigned int k; - if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); - k = j->code_buffer; - j->code_buffer <<= 1; - --j->code_bits; - return k & 0x80000000; -} - -// given a value that's at position X in the zigzag stream, -// where does it appear in the 8x8 matrix coded as row-major? -static const stbi_uc stbi__jpeg_dezigzag[64 + 15] = -{ - 0, 1, 8, 16, 9, 2, 3, 10, - 17, 24, 32, 25, 18, 11, 4, 5, - 12, 19, 26, 33, 40, 48, 41, 34, - 27, 20, 13, 6, 7, 14, 21, 28, - 35, 42, 49, 56, 57, 50, 43, 36, - 29, 22, 15, 23, 30, 37, 44, 51, - 58, 59, 52, 45, 38, 31, 39, 46, - 53, 60, 61, 54, 47, 55, 62, 63, - // let corrupt input sample past end - 63, 63, 63, 63, 63, 63, 63, 63, - 63, 63, 63, 63, 63, 63, 63 -}; - -// decode one 64-entry block-- -static int stbi__jpeg_decode_block(stbi__jpeg* j, short data[64], stbi__huffman* hdc, stbi__huffman* hac, stbi__int16* fac, int b, stbi__uint16* dequant) -{ - int diff, dc, k; - int t; - - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - t = stbi__jpeg_huff_decode(j, hdc); - if (t < 0 || t > 15) return stbi__err("bad huffman code", "Corrupt JPEG"); - - // 0 all the ac values now so we can do it 32-bits at a time - memset(data, 0, 64 * sizeof(data[0])); - - diff = t ? stbi__extend_receive(j, t) : 0; - dc = j->img_comp[b].dc_pred + diff; - j->img_comp[b].dc_pred = dc; - data[0] = (short)(dc * dequant[0]); - - // decode AC components, see JPEG spec - k = 1; - do { - unsigned int zig; - int c, r, s; - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); - r = fac[c]; - if (r) { // fast-AC path - k += (r >> 4) & 15; // run - s = r & 15; // combined length - j->code_buffer <<= s; - j->code_bits -= s; - // decode into unzigzag'd location - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short)((r >> 8) * dequant[zig]); - } - else { - int rs = stbi__jpeg_huff_decode(j, hac); - if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (rs != 0xf0) break; // end block - k += 16; - } - else { - k += r; - // decode into unzigzag'd location - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short)(stbi__extend_receive(j, s) * dequant[zig]); - } - } - } while (k < 64); - return 1; -} - -static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg* j, short data[64], stbi__huffman* hdc, int b) -{ - int diff, dc; - int t; - if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - - if (j->succ_high == 0) { - // first scan for DC coefficient, must be first - memset(data, 0, 64 * sizeof(data[0])); // 0 all the ac values now - t = stbi__jpeg_huff_decode(j, hdc); - if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - diff = t ? stbi__extend_receive(j, t) : 0; - - dc = j->img_comp[b].dc_pred + diff; - j->img_comp[b].dc_pred = dc; - data[0] = (short)(dc * (1 << j->succ_low)); - } - else { - // refinement scan for DC coefficient - if (stbi__jpeg_get_bit(j)) - data[0] += (short)(1 << j->succ_low); - } - return 1; -} - -// @OPTIMIZE: store non-zigzagged during the decode passes, -// and only de-zigzag when dequantizing -static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg* j, short data[64], stbi__huffman* hac, stbi__int16* fac) -{ - int k; - if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); - - if (j->succ_high == 0) { - int shift = j->succ_low; - - if (j->eob_run) { - --j->eob_run; - return 1; - } - - k = j->spec_start; - do { - unsigned int zig; - int c, r, s; - if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); - c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS) - 1); - r = fac[c]; - if (r) { // fast-AC path - k += (r >> 4) & 15; // run - s = r & 15; // combined length - j->code_buffer <<= s; - j->code_bits -= s; - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short)((r >> 8) * (1 << shift)); - } - else { - int rs = stbi__jpeg_huff_decode(j, hac); - if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (r < 15) { - j->eob_run = (1 << r); - if (r) - j->eob_run += stbi__jpeg_get_bits(j, r); - --j->eob_run; - break; - } - k += 16; - } - else { - k += r; - zig = stbi__jpeg_dezigzag[k++]; - data[zig] = (short)(stbi__extend_receive(j, s) * (1 << shift)); - } - } - } while (k <= j->spec_end); - } - else { - // refinement scan for these AC coefficients - - short bit = (short)(1 << j->succ_low); - - if (j->eob_run) { - --j->eob_run; - for (k = j->spec_start; k <= j->spec_end; ++k) { - short* p = &data[stbi__jpeg_dezigzag[k]]; - if (*p != 0) - if (stbi__jpeg_get_bit(j)) - if ((*p & bit) == 0) { - if (*p > 0) - *p += bit; - else - *p -= bit; - } - } - } - else { - k = j->spec_start; - do { - int r, s; - int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh - if (rs < 0) return stbi__err("bad huffman code", "Corrupt JPEG"); - s = rs & 15; - r = rs >> 4; - if (s == 0) { - if (r < 15) { - j->eob_run = (1 << r) - 1; - if (r) - j->eob_run += stbi__jpeg_get_bits(j, r); - r = 64; // force end of block - } - else { - // r=15 s=0 should write 16 0s, so we just do - // a run of 15 0s and then write s (which is 0), - // so we don't have to do anything special here - } - } - else { - if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); - // sign bit - if (stbi__jpeg_get_bit(j)) - s = bit; - else - s = -bit; - } - - // advance by r - while (k <= j->spec_end) { - short* p = &data[stbi__jpeg_dezigzag[k++]]; - if (*p != 0) { - if (stbi__jpeg_get_bit(j)) - if ((*p & bit) == 0) { - if (*p > 0) - *p += bit; - else - *p -= bit; - } - } - else { - if (r == 0) { - *p = (short)s; - break; - } - --r; - } - } - } while (k <= j->spec_end); - } - } - return 1; -} - -// take a -128..127 value and stbi__clamp it and convert to 0..255 -stbi_inline static stbi_uc stbi__clamp(int x) -{ - // trick to use a single test to catch both cases - if ((unsigned int)x > 255) { - if (x < 0) return 0; - if (x > 255) return 255; - } - return (stbi_uc)x; -} - -#define stbi__f2f(x) ((int) (((x) * 4096 + 0.5))) -#define stbi__fsh(x) ((x) * 4096) - -// derived from jidctint -- DCT_ISLOW -#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \ - int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \ - p2 = s2; \ - p3 = s6; \ - p1 = (p2+p3) * stbi__f2f(0.5411961f); \ - t2 = p1 + p3*stbi__f2f(-1.847759065f); \ - t3 = p1 + p2*stbi__f2f( 0.765366865f); \ - p2 = s0; \ - p3 = s4; \ - t0 = stbi__fsh(p2+p3); \ - t1 = stbi__fsh(p2-p3); \ - x0 = t0+t3; \ - x3 = t0-t3; \ - x1 = t1+t2; \ - x2 = t1-t2; \ - t0 = s7; \ - t1 = s5; \ - t2 = s3; \ - t3 = s1; \ - p3 = t0+t2; \ - p4 = t1+t3; \ - p1 = t0+t3; \ - p2 = t1+t2; \ - p5 = (p3+p4)*stbi__f2f( 1.175875602f); \ - t0 = t0*stbi__f2f( 0.298631336f); \ - t1 = t1*stbi__f2f( 2.053119869f); \ - t2 = t2*stbi__f2f( 3.072711026f); \ - t3 = t3*stbi__f2f( 1.501321110f); \ - p1 = p5 + p1*stbi__f2f(-0.899976223f); \ - p2 = p5 + p2*stbi__f2f(-2.562915447f); \ - p3 = p3*stbi__f2f(-1.961570560f); \ - p4 = p4*stbi__f2f(-0.390180644f); \ - t3 += p1+p4; \ - t2 += p2+p3; \ - t1 += p2+p4; \ - t0 += p1+p3; - -static void stbi__idct_block(stbi_uc* out, int out_stride, short data[64]) -{ - int i, val[64], * v = val; - stbi_uc* o; - short* d = data; - - // columns - for (i = 0; i < 8; ++i, ++d, ++v) { - // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing - if (d[8] == 0 && d[16] == 0 && d[24] == 0 && d[32] == 0 - && d[40] == 0 && d[48] == 0 && d[56] == 0) { - // no shortcut 0 seconds - // (1|2|3|4|5|6|7)==0 0 seconds - // all separate -0.047 seconds - // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds - int dcterm = d[0] * 4; - v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; - } - else { - STBI__IDCT_1D(d[0], d[8], d[16], d[24], d[32], d[40], d[48], d[56]) - // constants scaled things up by 1<<12; let's bring them back - // down, but keep 2 extra bits of precision - x0 += 512; x1 += 512; x2 += 512; x3 += 512; - v[0] = (x0 + t3) >> 10; - v[56] = (x0 - t3) >> 10; - v[8] = (x1 + t2) >> 10; - v[48] = (x1 - t2) >> 10; - v[16] = (x2 + t1) >> 10; - v[40] = (x2 - t1) >> 10; - v[24] = (x3 + t0) >> 10; - v[32] = (x3 - t0) >> 10; - } - } - - for (i = 0, v = val, o = out; i < 8; ++i, v += 8, o += out_stride) { - // no fast case since the first 1D IDCT spread components out - STBI__IDCT_1D(v[0], v[1], v[2], v[3], v[4], v[5], v[6], v[7]) - // constants scaled things up by 1<<12, plus we had 1<<2 from first - // loop, plus horizontal and vertical each scale by sqrt(8) so together - // we've got an extra 1<<3, so 1<<17 total we need to remove. - // so we want to round that, which means adding 0.5 * 1<<17, - // aka 65536. Also, we'll end up with -128 to 127 that we want - // to encode as 0..255 by adding 128, so we'll add that before the shift - x0 += 65536 + (128 << 17); - x1 += 65536 + (128 << 17); - x2 += 65536 + (128 << 17); - x3 += 65536 + (128 << 17); - // tried computing the shifts into temps, or'ing the temps to see - // if any were out of range, but that was slower - o[0] = stbi__clamp((x0 + t3) >> 17); - o[7] = stbi__clamp((x0 - t3) >> 17); - o[1] = stbi__clamp((x1 + t2) >> 17); - o[6] = stbi__clamp((x1 - t2) >> 17); - o[2] = stbi__clamp((x2 + t1) >> 17); - o[5] = stbi__clamp((x2 - t1) >> 17); - o[3] = stbi__clamp((x3 + t0) >> 17); - o[4] = stbi__clamp((x3 - t0) >> 17); - } -} - -#ifdef STBI_SSE2 -// sse2 integer IDCT. not the fastest possible implementation but it -// produces bit-identical results to the generic C version so it's -// fully "transparent". -static void stbi__idct_simd(stbi_uc* out, int out_stride, short data[64]) -{ - // This is constructed to match our regular (generic) integer IDCT exactly. - __m128i row0, row1, row2, row3, row4, row5, row6, row7; - __m128i tmp; - - // dot product constant: even elems=x, odd elems=y -#define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) - -// out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) -// out(1) = c1[even]*x + c1[odd]*y -#define dct_rot(out0,out1, x,y,c0,c1) \ - __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \ - __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \ - __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \ - __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \ - __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \ - __m128i out1##_h = _mm_madd_epi16(c0##hi, c1) - - // out = in << 12 (in 16-bit, out 32-bit) -#define dct_widen(out, in) \ - __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \ - __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4) - - // wide add -#define dct_wadd(out, a, b) \ - __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \ - __m128i out##_h = _mm_add_epi32(a##_h, b##_h) - - // wide sub -#define dct_wsub(out, a, b) \ - __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \ - __m128i out##_h = _mm_sub_epi32(a##_h, b##_h) - - // butterfly a/b, add bias, then shift by "s" and pack -#define dct_bfly32o(out0, out1, a,b,bias,s) \ - { \ - __m128i abiased_l = _mm_add_epi32(a##_l, bias); \ - __m128i abiased_h = _mm_add_epi32(a##_h, bias); \ - dct_wadd(sum, abiased, b); \ - dct_wsub(dif, abiased, b); \ - out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \ - out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \ - } - - // 8-bit interleave step (for transposes) -#define dct_interleave8(a, b) \ - tmp = a; \ - a = _mm_unpacklo_epi8(a, b); \ - b = _mm_unpackhi_epi8(tmp, b) - - // 16-bit interleave step (for transposes) -#define dct_interleave16(a, b) \ - tmp = a; \ - a = _mm_unpacklo_epi16(a, b); \ - b = _mm_unpackhi_epi16(tmp, b) - -#define dct_pass(bias,shift) \ - { \ - /* even part */ \ - dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \ - __m128i sum04 = _mm_add_epi16(row0, row4); \ - __m128i dif04 = _mm_sub_epi16(row0, row4); \ - dct_widen(t0e, sum04); \ - dct_widen(t1e, dif04); \ - dct_wadd(x0, t0e, t3e); \ - dct_wsub(x3, t0e, t3e); \ - dct_wadd(x1, t1e, t2e); \ - dct_wsub(x2, t1e, t2e); \ - /* odd part */ \ - dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \ - dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \ - __m128i sum17 = _mm_add_epi16(row1, row7); \ - __m128i sum35 = _mm_add_epi16(row3, row5); \ - dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \ - dct_wadd(x4, y0o, y4o); \ - dct_wadd(x5, y1o, y5o); \ - dct_wadd(x6, y2o, y5o); \ - dct_wadd(x7, y3o, y4o); \ - dct_bfly32o(row0,row7, x0,x7,bias,shift); \ - dct_bfly32o(row1,row6, x1,x6,bias,shift); \ - dct_bfly32o(row2,row5, x2,x5,bias,shift); \ - dct_bfly32o(row3,row4, x3,x4,bias,shift); \ - } - - __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); - __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f(0.765366865f), stbi__f2f(0.5411961f)); - __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); - __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); - __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f(0.298631336f), stbi__f2f(-1.961570560f)); - __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f(3.072711026f)); - __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f(2.053119869f), stbi__f2f(-0.390180644f)); - __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f(1.501321110f)); - - // rounding biases in column/row passes, see stbi__idct_block for explanation. - __m128i bias_0 = _mm_set1_epi32(512); - __m128i bias_1 = _mm_set1_epi32(65536 + (128 << 17)); - - // load - row0 = _mm_load_si128((const __m128i*) (data + 0 * 8)); - row1 = _mm_load_si128((const __m128i*) (data + 1 * 8)); - row2 = _mm_load_si128((const __m128i*) (data + 2 * 8)); - row3 = _mm_load_si128((const __m128i*) (data + 3 * 8)); - row4 = _mm_load_si128((const __m128i*) (data + 4 * 8)); - row5 = _mm_load_si128((const __m128i*) (data + 5 * 8)); - row6 = _mm_load_si128((const __m128i*) (data + 6 * 8)); - row7 = _mm_load_si128((const __m128i*) (data + 7 * 8)); - - // column pass - dct_pass(bias_0, 10); - - { - // 16bit 8x8 transpose pass 1 - dct_interleave16(row0, row4); - dct_interleave16(row1, row5); - dct_interleave16(row2, row6); - dct_interleave16(row3, row7); - - // transpose pass 2 - dct_interleave16(row0, row2); - dct_interleave16(row1, row3); - dct_interleave16(row4, row6); - dct_interleave16(row5, row7); - - // transpose pass 3 - dct_interleave16(row0, row1); - dct_interleave16(row2, row3); - dct_interleave16(row4, row5); - dct_interleave16(row6, row7); - } - - // row pass - dct_pass(bias_1, 17); - - { - // pack - __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 - __m128i p1 = _mm_packus_epi16(row2, row3); - __m128i p2 = _mm_packus_epi16(row4, row5); - __m128i p3 = _mm_packus_epi16(row6, row7); - - // 8bit 8x8 transpose pass 1 - dct_interleave8(p0, p2); // a0e0a1e1... - dct_interleave8(p1, p3); // c0g0c1g1... - - // transpose pass 2 - dct_interleave8(p0, p1); // a0c0e0g0... - dct_interleave8(p2, p3); // b0d0f0h0... - - // transpose pass 3 - dct_interleave8(p0, p2); // a0b0c0d0... - dct_interleave8(p1, p3); // a4b4c4d4... - - // store - _mm_storel_epi64((__m128i*) out, p0); out += out_stride; - _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i*) out, p2); out += out_stride; - _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i*) out, p1); out += out_stride; - _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; - _mm_storel_epi64((__m128i*) out, p3); out += out_stride; - _mm_storel_epi64((__m128i*) out, _mm_shuffle_epi32(p3, 0x4e)); - } - -#undef dct_const -#undef dct_rot -#undef dct_widen -#undef dct_wadd -#undef dct_wsub -#undef dct_bfly32o -#undef dct_interleave8 -#undef dct_interleave16 -#undef dct_pass -} - -#endif // STBI_SSE2 - -#ifdef STBI_NEON - -// NEON integer IDCT. should produce bit-identical -// results to the generic C version. -static void stbi__idct_simd(stbi_uc* out, int out_stride, short data[64]) -{ - int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; - - int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); - int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); - int16x4_t rot0_2 = vdup_n_s16(stbi__f2f(0.765366865f)); - int16x4_t rot1_0 = vdup_n_s16(stbi__f2f(1.175875602f)); - int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); - int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); - int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); - int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); - int16x4_t rot3_0 = vdup_n_s16(stbi__f2f(0.298631336f)); - int16x4_t rot3_1 = vdup_n_s16(stbi__f2f(2.053119869f)); - int16x4_t rot3_2 = vdup_n_s16(stbi__f2f(3.072711026f)); - int16x4_t rot3_3 = vdup_n_s16(stbi__f2f(1.501321110f)); - -#define dct_long_mul(out, inq, coeff) \ - int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \ - int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff) - -#define dct_long_mac(out, acc, inq, coeff) \ - int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \ - int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff) - -#define dct_widen(out, inq) \ - int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \ - int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12) - - // wide add -#define dct_wadd(out, a, b) \ - int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \ - int32x4_t out##_h = vaddq_s32(a##_h, b##_h) - -// wide sub -#define dct_wsub(out, a, b) \ - int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \ - int32x4_t out##_h = vsubq_s32(a##_h, b##_h) - -// butterfly a/b, then shift using "shiftop" by "s" and pack -#define dct_bfly32o(out0,out1, a,b,shiftop,s) \ - { \ - dct_wadd(sum, a, b); \ - dct_wsub(dif, a, b); \ - out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \ - out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \ - } - -#define dct_pass(shiftop, shift) \ - { \ - /* even part */ \ - int16x8_t sum26 = vaddq_s16(row2, row6); \ - dct_long_mul(p1e, sum26, rot0_0); \ - dct_long_mac(t2e, p1e, row6, rot0_1); \ - dct_long_mac(t3e, p1e, row2, rot0_2); \ - int16x8_t sum04 = vaddq_s16(row0, row4); \ - int16x8_t dif04 = vsubq_s16(row0, row4); \ - dct_widen(t0e, sum04); \ - dct_widen(t1e, dif04); \ - dct_wadd(x0, t0e, t3e); \ - dct_wsub(x3, t0e, t3e); \ - dct_wadd(x1, t1e, t2e); \ - dct_wsub(x2, t1e, t2e); \ - /* odd part */ \ - int16x8_t sum15 = vaddq_s16(row1, row5); \ - int16x8_t sum17 = vaddq_s16(row1, row7); \ - int16x8_t sum35 = vaddq_s16(row3, row5); \ - int16x8_t sum37 = vaddq_s16(row3, row7); \ - int16x8_t sumodd = vaddq_s16(sum17, sum35); \ - dct_long_mul(p5o, sumodd, rot1_0); \ - dct_long_mac(p1o, p5o, sum17, rot1_1); \ - dct_long_mac(p2o, p5o, sum35, rot1_2); \ - dct_long_mul(p3o, sum37, rot2_0); \ - dct_long_mul(p4o, sum15, rot2_1); \ - dct_wadd(sump13o, p1o, p3o); \ - dct_wadd(sump24o, p2o, p4o); \ - dct_wadd(sump23o, p2o, p3o); \ - dct_wadd(sump14o, p1o, p4o); \ - dct_long_mac(x4, sump13o, row7, rot3_0); \ - dct_long_mac(x5, sump24o, row5, rot3_1); \ - dct_long_mac(x6, sump23o, row3, rot3_2); \ - dct_long_mac(x7, sump14o, row1, rot3_3); \ - dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \ - dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \ - dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \ - dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \ - } - - // load - row0 = vld1q_s16(data + 0 * 8); - row1 = vld1q_s16(data + 1 * 8); - row2 = vld1q_s16(data + 2 * 8); - row3 = vld1q_s16(data + 3 * 8); - row4 = vld1q_s16(data + 4 * 8); - row5 = vld1q_s16(data + 5 * 8); - row6 = vld1q_s16(data + 6 * 8); - row7 = vld1q_s16(data + 7 * 8); - - // add DC bias - row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); - - // column pass - dct_pass(vrshrn_n_s32, 10); - - // 16bit 8x8 transpose - { - // these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. - // whether compilers actually get this is another story, sadly. -#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; } -#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); } -#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); } - - // pass 1 - dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 - dct_trn16(row2, row3); - dct_trn16(row4, row5); - dct_trn16(row6, row7); - - // pass 2 - dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 - dct_trn32(row1, row3); - dct_trn32(row4, row6); - dct_trn32(row5, row7); - - // pass 3 - dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 - dct_trn64(row1, row5); - dct_trn64(row2, row6); - dct_trn64(row3, row7); - -#undef dct_trn16 -#undef dct_trn32 -#undef dct_trn64 - } - - // row pass - // vrshrn_n_s32 only supports shifts up to 16, we need - // 17. so do a non-rounding shift of 16 first then follow - // up with a rounding shift by 1. - dct_pass(vshrn_n_s32, 16); - - { - // pack and round - uint8x8_t p0 = vqrshrun_n_s16(row0, 1); - uint8x8_t p1 = vqrshrun_n_s16(row1, 1); - uint8x8_t p2 = vqrshrun_n_s16(row2, 1); - uint8x8_t p3 = vqrshrun_n_s16(row3, 1); - uint8x8_t p4 = vqrshrun_n_s16(row4, 1); - uint8x8_t p5 = vqrshrun_n_s16(row5, 1); - uint8x8_t p6 = vqrshrun_n_s16(row6, 1); - uint8x8_t p7 = vqrshrun_n_s16(row7, 1); - - // again, these can translate into one instruction, but often don't. -#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; } -#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); } -#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); } - - // sadly can't use interleaved stores here since we only write - // 8 bytes to each scan line! - - // 8x8 8-bit transpose pass 1 - dct_trn8_8(p0, p1); - dct_trn8_8(p2, p3); - dct_trn8_8(p4, p5); - dct_trn8_8(p6, p7); - - // pass 2 - dct_trn8_16(p0, p2); - dct_trn8_16(p1, p3); - dct_trn8_16(p4, p6); - dct_trn8_16(p5, p7); - - // pass 3 - dct_trn8_32(p0, p4); - dct_trn8_32(p1, p5); - dct_trn8_32(p2, p6); - dct_trn8_32(p3, p7); - - // store - vst1_u8(out, p0); out += out_stride; - vst1_u8(out, p1); out += out_stride; - vst1_u8(out, p2); out += out_stride; - vst1_u8(out, p3); out += out_stride; - vst1_u8(out, p4); out += out_stride; - vst1_u8(out, p5); out += out_stride; - vst1_u8(out, p6); out += out_stride; - vst1_u8(out, p7); - -#undef dct_trn8_8 -#undef dct_trn8_16 -#undef dct_trn8_32 - } - -#undef dct_long_mul -#undef dct_long_mac -#undef dct_widen -#undef dct_wadd -#undef dct_wsub -#undef dct_bfly32o -#undef dct_pass -} - -#endif // STBI_NEON - -#define STBI__MARKER_none 0xff -// if there's a pending marker from the entropy stream, return that -// otherwise, fetch from the stream and get a marker. if there's no -// marker, return 0xff, which is never a valid marker value -static stbi_uc stbi__get_marker(stbi__jpeg* j) -{ - stbi_uc x; - if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } - x = stbi__get8(j->s); - if (x != 0xff) return STBI__MARKER_none; - while (x == 0xff) - x = stbi__get8(j->s); // consume repeated 0xff fill bytes - return x; -} - -// in each scan, we'll have scan_n components, and the order -// of the components is specified by order[] -#define STBI__RESTART(x) ((x) >= 0xd0 && (x) <= 0xd7) - -// after a restart interval, stbi__jpeg_reset the entropy decoder and -// the dc prediction -static void stbi__jpeg_reset(stbi__jpeg* j) -{ - j->code_bits = 0; - j->code_buffer = 0; - j->nomore = 0; - j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; - j->marker = STBI__MARKER_none; - j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; - j->eob_run = 0; - // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, - // since we don't even allow 1<<30 pixels -} - -static int stbi__parse_entropy_coded_data(stbi__jpeg* z) -{ - stbi__jpeg_reset(z); - if (!z->progressive) { - if (z->scan_n == 1) { - int i, j; - STBI_SIMD_ALIGN(short, data[64]); - int n = z->order[0]; - // non-interleaved data, we just need to process one block at a time, - // in trivial scanline order - // number of blocks to do just depends on how many actual "pixels" this - // component has, independent of interleaved MCU blocking and such - int w = (z->img_comp[n].x + 7) >> 3; - int h = (z->img_comp[n].y + 7) >> 3; - for (j = 0; j < h; ++j) { - for (i = 0; i < w; ++i) { - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block(z, data, z->huff_dc + z->img_comp[n].hd, z->huff_ac + ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; - z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * j * 8 + i * 8, z->img_comp[n].w2, data); - // every data block is an MCU, so countdown the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - // if it's NOT a restart, then just bail, so we get corrupt data - // rather than no data - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } - } - } - return 1; - } - else { // interleaved - int i, j, k, x, y; - STBI_SIMD_ALIGN(short, data[64]); - for (j = 0; j < z->img_mcu_y; ++j) { - for (i = 0; i < z->img_mcu_x; ++i) { - // scan an interleaved mcu... process scan_n components in order - for (k = 0; k < z->scan_n; ++k) { - int n = z->order[k]; - // scan out an mcu's worth of this component; that's just determined - // by the basic H and V specified for the component - for (y = 0; y < z->img_comp[n].v; ++y) { - for (x = 0; x < z->img_comp[n].h; ++x) { - int x2 = (i * z->img_comp[n].h + x) * 8; - int y2 = (j * z->img_comp[n].v + y) * 8; - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block(z, data, z->huff_dc + z->img_comp[n].hd, z->huff_ac + ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; - z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * y2 + x2, z->img_comp[n].w2, data); - } - } - } - // after all interleaved components, that's an interleaved MCU, - // so now count down the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } - } - } - return 1; - } - } - else { - if (z->scan_n == 1) { - int i, j; - int n = z->order[0]; - // non-interleaved data, we just need to process one block at a time, - // in trivial scanline order - // number of blocks to do just depends on how many actual "pixels" this - // component has, independent of interleaved MCU blocking and such - int w = (z->img_comp[n].x + 7) >> 3; - int h = (z->img_comp[n].y + 7) >> 3; - for (j = 0; j < h; ++j) { - for (i = 0; i < w; ++i) { - short* data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); - if (z->spec_start == 0) { - if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) - return 0; - } - else { - int ha = z->img_comp[n].ha; - if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) - return 0; - } - // every data block is an MCU, so countdown the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } - } - } - return 1; - } - else { // interleaved - int i, j, k, x, y; - for (j = 0; j < z->img_mcu_y; ++j) { - for (i = 0; i < z->img_mcu_x; ++i) { - // scan an interleaved mcu... process scan_n components in order - for (k = 0; k < z->scan_n; ++k) { - int n = z->order[k]; - // scan out an mcu's worth of this component; that's just determined - // by the basic H and V specified for the component - for (y = 0; y < z->img_comp[n].v; ++y) { - for (x = 0; x < z->img_comp[n].h; ++x) { - int x2 = (i * z->img_comp[n].h + x); - int y2 = (j * z->img_comp[n].v + y); - short* data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); - if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) - return 0; - } - } - } - // after all interleaved components, that's an interleaved MCU, - // so now count down the restart interval - if (--z->todo <= 0) { - if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); - if (!STBI__RESTART(z->marker)) return 1; - stbi__jpeg_reset(z); - } - } - } - return 1; - } - } -} - -static void stbi__jpeg_dequantize(short* data, stbi__uint16* dequant) -{ - int i; - for (i = 0; i < 64; ++i) - data[i] *= dequant[i]; -} - -static void stbi__jpeg_finish(stbi__jpeg* z) -{ - if (z->progressive) { - // dequantize and idct the data - int i, j, n; - for (n = 0; n < z->s->img_n; ++n) { - int w = (z->img_comp[n].x + 7) >> 3; - int h = (z->img_comp[n].y + 7) >> 3; - for (j = 0; j < h; ++j) { - for (i = 0; i < w; ++i) { - short* data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); - stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); - z->idct_block_kernel(z->img_comp[n].data + z->img_comp[n].w2 * j * 8 + i * 8, z->img_comp[n].w2, data); - } - } - } - } -} - -static int stbi__process_marker(stbi__jpeg* z, int m) -{ - int L; - switch (m) { - case STBI__MARKER_none: // no marker found - return stbi__err("expected marker", "Corrupt JPEG"); - - case 0xDD: // DRI - specify restart interval - if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len", "Corrupt JPEG"); - z->restart_interval = stbi__get16be(z->s); - return 1; - - case 0xDB: // DQT - define quantization table - L = stbi__get16be(z->s) - 2; - while (L > 0) { - int q = stbi__get8(z->s); - int p = q >> 4, sixteen = (p != 0); - int t = q & 15, i; - if (p != 0 && p != 1) return stbi__err("bad DQT type", "Corrupt JPEG"); - if (t > 3) return stbi__err("bad DQT table", "Corrupt JPEG"); - - for (i = 0; i < 64; ++i) - z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); - L -= (sixteen ? 129 : 65); - } - return L == 0; - - case 0xC4: // DHT - define huffman table - L = stbi__get16be(z->s) - 2; - while (L > 0) { - stbi_uc* v; - int sizes[16], i, n = 0; - int q = stbi__get8(z->s); - int tc = q >> 4; - int th = q & 15; - if (tc > 1 || th > 3) return stbi__err("bad DHT header", "Corrupt JPEG"); - for (i = 0; i < 16; ++i) { - sizes[i] = stbi__get8(z->s); - n += sizes[i]; - } - L -= 17; - if (tc == 0) { - if (!stbi__build_huffman(z->huff_dc + th, sizes)) return 0; - v = z->huff_dc[th].values; - } - else { - if (!stbi__build_huffman(z->huff_ac + th, sizes)) return 0; - v = z->huff_ac[th].values; - } - for (i = 0; i < n; ++i) - v[i] = stbi__get8(z->s); - if (tc != 0) - stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); - L -= n; - } - return L == 0; - } - - // check for comment block or APP blocks - if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { - L = stbi__get16be(z->s); - if (L < 2) { - if (m == 0xFE) - return stbi__err("bad COM len", "Corrupt JPEG"); - else - return stbi__err("bad APP len", "Corrupt JPEG"); - } - L -= 2; - - if (m == 0xE0 && L >= 5) { // JFIF APP0 segment - static const unsigned char tag[5] = { 'J','F','I','F','\0' }; - int ok = 1; - int i; - for (i = 0; i < 5; ++i) - if (stbi__get8(z->s) != tag[i]) - ok = 0; - L -= 5; - if (ok) - z->jfif = 1; - } - else if (m == 0xEE && L >= 12) { // Adobe APP14 segment - static const unsigned char tag[6] = { 'A','d','o','b','e','\0' }; - int ok = 1; - int i; - for (i = 0; i < 6; ++i) - if (stbi__get8(z->s) != tag[i]) - ok = 0; - L -= 6; - if (ok) { - stbi__get8(z->s); // version - stbi__get16be(z->s); // flags0 - stbi__get16be(z->s); // flags1 - z->app14_color_transform = stbi__get8(z->s); // color transform - L -= 6; - } - } - - stbi__skip(z->s, L); - return 1; - } - - return stbi__err("unknown marker", "Corrupt JPEG"); -} - -// after we see SOS -static int stbi__process_scan_header(stbi__jpeg* z) -{ - int i; - int Ls = stbi__get16be(z->s); - z->scan_n = stbi__get8(z->s); - if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int)z->s->img_n) return stbi__err("bad SOS component count", "Corrupt JPEG"); - if (Ls != 6 + 2 * z->scan_n) return stbi__err("bad SOS len", "Corrupt JPEG"); - for (i = 0; i < z->scan_n; ++i) { - int id = stbi__get8(z->s), which; - int q = stbi__get8(z->s); - for (which = 0; which < z->s->img_n; ++which) - if (z->img_comp[which].id == id) - break; - if (which == z->s->img_n) return 0; // no match - z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff", "Corrupt JPEG"); - z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff", "Corrupt JPEG"); - z->order[i] = which; - } - - { - int aa; - z->spec_start = stbi__get8(z->s); - z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 - aa = stbi__get8(z->s); - z->succ_high = (aa >> 4); - z->succ_low = (aa & 15); - if (z->progressive) { - if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) - return stbi__err("bad SOS", "Corrupt JPEG"); - } - else { - if (z->spec_start != 0) return stbi__err("bad SOS", "Corrupt JPEG"); - if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS", "Corrupt JPEG"); - z->spec_end = 63; - } - } - - return 1; -} - -static int stbi__free_jpeg_components(stbi__jpeg* z, int ncomp, int why) -{ - int i; - for (i = 0; i < ncomp; ++i) { - if (z->img_comp[i].raw_data) { - STBI_FREE(z->img_comp[i].raw_data); - z->img_comp[i].raw_data = NULL; - z->img_comp[i].data = NULL; - } - if (z->img_comp[i].raw_coeff) { - STBI_FREE(z->img_comp[i].raw_coeff); - z->img_comp[i].raw_coeff = 0; - z->img_comp[i].coeff = 0; - } - if (z->img_comp[i].linebuf) { - STBI_FREE(z->img_comp[i].linebuf); - z->img_comp[i].linebuf = NULL; - } - } - return why; -} - -static int stbi__process_frame_header(stbi__jpeg* z, int scan) -{ - stbi__context* s = z->s; - int Lf, p, i, q, h_max = 1, v_max = 1, c; - Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len", "Corrupt JPEG"); // JPEG - p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit", "JPEG format not supported: 8-bit only"); // JPEG baseline - s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG - s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width", "Corrupt JPEG"); // JPEG requires - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - c = stbi__get8(s); - if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count", "Corrupt JPEG"); - s->img_n = c; - for (i = 0; i < c; ++i) { - z->img_comp[i].data = NULL; - z->img_comp[i].linebuf = NULL; - } - - if (Lf != 8 + 3 * s->img_n) return stbi__err("bad SOF len", "Corrupt JPEG"); - - z->rgb = 0; - for (i = 0; i < s->img_n; ++i) { - static const unsigned char rgb[3] = { 'R', 'G', 'B' }; - z->img_comp[i].id = stbi__get8(s); - if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) - ++z->rgb; - q = stbi__get8(s); - z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H", "Corrupt JPEG"); - z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V", "Corrupt JPEG"); - z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ", "Corrupt JPEG"); - } - - if (scan != STBI__SCAN_load) return 1; - - if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); - - for (i = 0; i < s->img_n; ++i) { - if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; - if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; - } - - // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios - // and I've never seen a non-corrupted JPEG file actually use them - for (i = 0; i < s->img_n; ++i) { - if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H", "Corrupt JPEG"); - if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V", "Corrupt JPEG"); - } - - // compute interleaved mcu info - z->img_h_max = h_max; - z->img_v_max = v_max; - z->img_mcu_w = h_max * 8; - z->img_mcu_h = v_max * 8; - // these sizes can't be more than 17 bits - z->img_mcu_x = (s->img_x + z->img_mcu_w - 1) / z->img_mcu_w; - z->img_mcu_y = (s->img_y + z->img_mcu_h - 1) / z->img_mcu_h; - - for (i = 0; i < s->img_n; ++i) { - // number of effective pixels (e.g. for non-interleaved MCU) - z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max - 1) / h_max; - z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max - 1) / v_max; - // to simplify generation, we'll allocate enough memory to decode - // the bogus oversized data from using interleaved MCUs and their - // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't - // discard the extra data until colorspace conversion - // - // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) - // so these muls can't overflow with 32-bit ints (which we require) - z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; - z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; - z->img_comp[i].coeff = 0; - z->img_comp[i].raw_coeff = 0; - z->img_comp[i].linebuf = NULL; - z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); - if (z->img_comp[i].raw_data == NULL) - return stbi__free_jpeg_components(z, i + 1, stbi__err("outofmem", "Out of memory")); - // align blocks for idct using mmx/sse - z->img_comp[i].data = (stbi_uc*)(((size_t)z->img_comp[i].raw_data + 15) & ~15); - if (z->progressive) { - // w2, h2 are multiples of 8 (see above) - z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; - z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; - z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); - if (z->img_comp[i].raw_coeff == NULL) - return stbi__free_jpeg_components(z, i + 1, stbi__err("outofmem", "Out of memory")); - z->img_comp[i].coeff = (short*)(((size_t)z->img_comp[i].raw_coeff + 15) & ~15); - } - } - - return 1; -} - -// use comparisons since in some cases we handle more than one case (e.g. SOF) -#define stbi__DNL(x) ((x) == 0xdc) -#define stbi__SOI(x) ((x) == 0xd8) -#define stbi__EOI(x) ((x) == 0xd9) -#define stbi__SOF(x) ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2) -#define stbi__SOS(x) ((x) == 0xda) - -#define stbi__SOF_progressive(x) ((x) == 0xc2) - -static int stbi__decode_jpeg_header(stbi__jpeg* z, int scan) -{ - int m; - z->jfif = 0; - z->app14_color_transform = -1; // valid values are 0,1,2 - z->marker = STBI__MARKER_none; // initialize cached marker to empty - m = stbi__get_marker(z); - if (!stbi__SOI(m)) return stbi__err("no SOI", "Corrupt JPEG"); - if (scan == STBI__SCAN_type) return 1; - m = stbi__get_marker(z); - while (!stbi__SOF(m)) { - if (!stbi__process_marker(z, m)) return 0; - m = stbi__get_marker(z); - while (m == STBI__MARKER_none) { - // some files have extra padding after their blocks, so ok, we'll scan - if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); - m = stbi__get_marker(z); - } - } - z->progressive = stbi__SOF_progressive(m); - if (!stbi__process_frame_header(z, scan)) return 0; - return 1; -} - -// decode image to YCbCr format -static int stbi__decode_jpeg_image(stbi__jpeg* j) -{ - int m; - for (m = 0; m < 4; m++) { - j->img_comp[m].raw_data = NULL; - j->img_comp[m].raw_coeff = NULL; - } - j->restart_interval = 0; - if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; - m = stbi__get_marker(j); - while (!stbi__EOI(m)) { - if (stbi__SOS(m)) { - if (!stbi__process_scan_header(j)) return 0; - if (!stbi__parse_entropy_coded_data(j)) return 0; - if (j->marker == STBI__MARKER_none) { - // handle 0s at the end of image data from IP Kamera 9060 - while (!stbi__at_eof(j->s)) { - int x = stbi__get8(j->s); - if (x == 255) { - j->marker = stbi__get8(j->s); - break; - } - } - // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 - } - } - else if (stbi__DNL(m)) { - int Ld = stbi__get16be(j->s); - stbi__uint32 NL = stbi__get16be(j->s); - if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); - if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); - } - else { - if (!stbi__process_marker(j, m)) return 0; - } - m = stbi__get_marker(j); - } - if (j->progressive) - stbi__jpeg_finish(j); - return 1; -} - -// static jfif-centered resampling (across block boundaries) - -typedef stbi_uc* (*resample_row_func)(stbi_uc* out, stbi_uc* in0, stbi_uc* in1, - int w, int hs); - -#define stbi__div4(x) ((stbi_uc) ((x) >> 2)) - -static stbi_uc* resample_row_1(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - STBI_NOTUSED(out); - STBI_NOTUSED(in_far); - STBI_NOTUSED(w); - STBI_NOTUSED(hs); - return in_near; -} - -static stbi_uc* stbi__resample_row_v_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - // need to generate two samples vertically for every one in input - int i; - STBI_NOTUSED(hs); - for (i = 0; i < w; ++i) - out[i] = stbi__div4(3 * in_near[i] + in_far[i] + 2); - return out; -} - -static stbi_uc* stbi__resample_row_h_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - // need to generate two samples horizontally for every one in input - int i; - stbi_uc* input = in_near; - - if (w == 1) { - // if only one sample, can't do any interpolation - out[0] = out[1] = input[0]; - return out; - } - - out[0] = input[0]; - out[1] = stbi__div4(input[0] * 3 + input[1] + 2); - for (i = 1; i < w - 1; ++i) { - int n = 3 * input[i] + 2; - out[i * 2 + 0] = stbi__div4(n + input[i - 1]); - out[i * 2 + 1] = stbi__div4(n + input[i + 1]); - } - out[i * 2 + 0] = stbi__div4(input[w - 2] * 3 + input[w - 1] + 2); - out[i * 2 + 1] = input[w - 1]; - - STBI_NOTUSED(in_far); - STBI_NOTUSED(hs); - - return out; -} - -#define stbi__div16(x) ((stbi_uc) ((x) >> 4)) - -static stbi_uc* stbi__resample_row_hv_2(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - // need to generate 2x2 samples for every one in input - int i, t0, t1; - if (w == 1) { - out[0] = out[1] = stbi__div4(3 * in_near[0] + in_far[0] + 2); - return out; - } - - t1 = 3 * in_near[0] + in_far[0]; - out[0] = stbi__div4(t1 + 2); - for (i = 1; i < w; ++i) { - t0 = t1; - t1 = 3 * in_near[i] + in_far[i]; - out[i * 2 - 1] = stbi__div16(3 * t0 + t1 + 8); - out[i * 2] = stbi__div16(3 * t1 + t0 + 8); - } - out[w * 2 - 1] = stbi__div4(t1 + 2); - - STBI_NOTUSED(hs); - - return out; -} - -#if defined(STBI_SSE2) || defined(STBI_NEON) -static stbi_uc* stbi__resample_row_hv_2_simd(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - // need to generate 2x2 samples for every one in input - int i = 0, t0, t1; - - if (w == 1) { - out[0] = out[1] = stbi__div4(3 * in_near[0] + in_far[0] + 2); - return out; - } - - t1 = 3 * in_near[0] + in_far[0]; - // process groups of 8 pixels for as long as we can. - // note we can't handle the last pixel in a row in this loop - // because we need to handle the filter boundary conditions. - for (; i < ((w - 1) & ~7); i += 8) { -#if defined(STBI_SSE2) - // load and perform the vertical filtering pass - // this uses 3*x + y = 4*x + (y - x) - __m128i zero = _mm_setzero_si128(); - __m128i farb = _mm_loadl_epi64((__m128i*) (in_far + i)); - __m128i nearb = _mm_loadl_epi64((__m128i*) (in_near + i)); - __m128i farw = _mm_unpacklo_epi8(farb, zero); - __m128i nearw = _mm_unpacklo_epi8(nearb, zero); - __m128i diff = _mm_sub_epi16(farw, nearw); - __m128i nears = _mm_slli_epi16(nearw, 2); - __m128i curr = _mm_add_epi16(nears, diff); // current row - - // horizontal filter works the same based on shifted vers of current - // row. "prev" is current row shifted right by 1 pixel; we need to - // insert the previous pixel value (from t1). - // "next" is current row shifted left by 1 pixel, with first pixel - // of next block of 8 pixels added in. - __m128i prv0 = _mm_slli_si128(curr, 2); - __m128i nxt0 = _mm_srli_si128(curr, 2); - __m128i prev = _mm_insert_epi16(prv0, t1, 0); - __m128i next = _mm_insert_epi16(nxt0, 3 * in_near[i + 8] + in_far[i + 8], 7); - - // horizontal filter, polyphase implementation since it's convenient: - // even pixels = 3*cur + prev = cur*4 + (prev - cur) - // odd pixels = 3*cur + next = cur*4 + (next - cur) - // note the shared term. - __m128i bias = _mm_set1_epi16(8); - __m128i curs = _mm_slli_epi16(curr, 2); - __m128i prvd = _mm_sub_epi16(prev, curr); - __m128i nxtd = _mm_sub_epi16(next, curr); - __m128i curb = _mm_add_epi16(curs, bias); - __m128i even = _mm_add_epi16(prvd, curb); - __m128i odd = _mm_add_epi16(nxtd, curb); - - // interleave even and odd pixels, then undo scaling. - __m128i int0 = _mm_unpacklo_epi16(even, odd); - __m128i int1 = _mm_unpackhi_epi16(even, odd); - __m128i de0 = _mm_srli_epi16(int0, 4); - __m128i de1 = _mm_srli_epi16(int1, 4); - - // pack and write output - __m128i outv = _mm_packus_epi16(de0, de1); - _mm_storeu_si128((__m128i*) (out + i * 2), outv); -#elif defined(STBI_NEON) - // load and perform the vertical filtering pass - // this uses 3*x + y = 4*x + (y - x) - uint8x8_t farb = vld1_u8(in_far + i); - uint8x8_t nearb = vld1_u8(in_near + i); - int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); - int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); - int16x8_t curr = vaddq_s16(nears, diff); // current row - - // horizontal filter works the same based on shifted vers of current - // row. "prev" is current row shifted right by 1 pixel; we need to - // insert the previous pixel value (from t1). - // "next" is current row shifted left by 1 pixel, with first pixel - // of next block of 8 pixels added in. - int16x8_t prv0 = vextq_s16(curr, curr, 7); - int16x8_t nxt0 = vextq_s16(curr, curr, 1); - int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); - int16x8_t next = vsetq_lane_s16(3 * in_near[i + 8] + in_far[i + 8], nxt0, 7); - - // horizontal filter, polyphase implementation since it's convenient: - // even pixels = 3*cur + prev = cur*4 + (prev - cur) - // odd pixels = 3*cur + next = cur*4 + (next - cur) - // note the shared term. - int16x8_t curs = vshlq_n_s16(curr, 2); - int16x8_t prvd = vsubq_s16(prev, curr); - int16x8_t nxtd = vsubq_s16(next, curr); - int16x8_t even = vaddq_s16(curs, prvd); - int16x8_t odd = vaddq_s16(curs, nxtd); - - // undo scaling and round, then store with even/odd phases interleaved - uint8x8x2_t o; - o.val[0] = vqrshrun_n_s16(even, 4); - o.val[1] = vqrshrun_n_s16(odd, 4); - vst2_u8(out + i * 2, o); -#endif - - // "previous" value for next iter - t1 = 3 * in_near[i + 7] + in_far[i + 7]; - } - - t0 = t1; - t1 = 3 * in_near[i] + in_far[i]; - out[i * 2] = stbi__div16(3 * t1 + t0 + 8); - - for (++i; i < w; ++i) { - t0 = t1; - t1 = 3 * in_near[i] + in_far[i]; - out[i * 2 - 1] = stbi__div16(3 * t0 + t1 + 8); - out[i * 2] = stbi__div16(3 * t1 + t0 + 8); - } - out[w * 2 - 1] = stbi__div4(t1 + 2); - - STBI_NOTUSED(hs); - - return out; -} -#endif - -static stbi_uc* stbi__resample_row_generic(stbi_uc* out, stbi_uc* in_near, stbi_uc* in_far, int w, int hs) -{ - // resample with nearest-neighbor - int i, j; - STBI_NOTUSED(in_far); - for (i = 0; i < w; ++i) - for (j = 0; j < hs; ++j) - out[i * hs + j] = in_near[i]; - return out; -} - -// this is a reduced-precision calculation of YCbCr-to-RGB introduced -// to make sure the code produces the same results in both SIMD and scalar -#define stbi__float2fixed(x) (((int) ((x) * 4096.0f + 0.5f)) << 8) -static void stbi__YCbCr_to_RGB_row(stbi_uc* out, const stbi_uc* y, const stbi_uc* pcb, const stbi_uc* pcr, int count, int step) -{ - int i; - for (i = 0; i < count; ++i) { - int y_fixed = (y[i] << 20) + (1 << 19); // rounding - int r, g, b; - int cr = pcr[i] - 128; - int cb = pcb[i] - 128; - r = y_fixed + cr * stbi__float2fixed(1.40200f); - g = y_fixed + (cr * -stbi__float2fixed(0.71414f)) + ((cb * -stbi__float2fixed(0.34414f)) & 0xffff0000); - b = y_fixed + cb * stbi__float2fixed(1.77200f); - r >>= 20; - g >>= 20; - b >>= 20; - if ((unsigned)r > 255) { if (r < 0) r = 0; else r = 255; } - if ((unsigned)g > 255) { if (g < 0) g = 0; else g = 255; } - if ((unsigned)b > 255) { if (b < 0) b = 0; else b = 255; } - out[0] = (stbi_uc)r; - out[1] = (stbi_uc)g; - out[2] = (stbi_uc)b; - out[3] = 255; - out += step; - } -} - -#if defined(STBI_SSE2) || defined(STBI_NEON) -static void stbi__YCbCr_to_RGB_simd(stbi_uc* out, stbi_uc const* y, stbi_uc const* pcb, stbi_uc const* pcr, int count, int step) -{ - int i = 0; - -#ifdef STBI_SSE2 - // step == 3 is pretty ugly on the final interleave, and i'm not convinced - // it's useful in practice (you wouldn't use it for textures, for example). - // so just accelerate step == 4 case. - if (step == 4) { - // this is a fairly straightforward implementation and not super-optimized. - __m128i signflip = _mm_set1_epi8(-0x80); - __m128i cr_const0 = _mm_set1_epi16((short)(1.40200f * 4096.0f + 0.5f)); - __m128i cr_const1 = _mm_set1_epi16(-(short)(0.71414f * 4096.0f + 0.5f)); - __m128i cb_const0 = _mm_set1_epi16(-(short)(0.34414f * 4096.0f + 0.5f)); - __m128i cb_const1 = _mm_set1_epi16((short)(1.77200f * 4096.0f + 0.5f)); - __m128i y_bias = _mm_set1_epi8((char)(unsigned char)128); - __m128i xw = _mm_set1_epi16(255); // alpha channel - - for (; i + 7 < count; i += 8) { - // load - __m128i y_bytes = _mm_loadl_epi64((__m128i*) (y + i)); - __m128i cr_bytes = _mm_loadl_epi64((__m128i*) (pcr + i)); - __m128i cb_bytes = _mm_loadl_epi64((__m128i*) (pcb + i)); - __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 - __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 - - // unpack to short (and left-shift cr, cb by 8) - __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); - __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); - __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); - - // color transform - __m128i yws = _mm_srli_epi16(yw, 4); - __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); - __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); - __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); - __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); - __m128i rws = _mm_add_epi16(cr0, yws); - __m128i gwt = _mm_add_epi16(cb0, yws); - __m128i bws = _mm_add_epi16(yws, cb1); - __m128i gws = _mm_add_epi16(gwt, cr1); - - // descale - __m128i rw = _mm_srai_epi16(rws, 4); - __m128i bw = _mm_srai_epi16(bws, 4); - __m128i gw = _mm_srai_epi16(gws, 4); - - // back to byte, set up for transpose - __m128i brb = _mm_packus_epi16(rw, bw); - __m128i gxb = _mm_packus_epi16(gw, xw); - - // transpose to interleave channels - __m128i t0 = _mm_unpacklo_epi8(brb, gxb); - __m128i t1 = _mm_unpackhi_epi8(brb, gxb); - __m128i o0 = _mm_unpacklo_epi16(t0, t1); - __m128i o1 = _mm_unpackhi_epi16(t0, t1); - - // store - _mm_storeu_si128((__m128i*) (out + 0), o0); - _mm_storeu_si128((__m128i*) (out + 16), o1); - out += 32; - } - } -#endif - -#ifdef STBI_NEON - // in this version, step=3 support would be easy to add. but is there demand? - if (step == 4) { - // this is a fairly straightforward implementation and not super-optimized. - uint8x8_t signflip = vdup_n_u8(0x80); - int16x8_t cr_const0 = vdupq_n_s16((short)(1.40200f * 4096.0f + 0.5f)); - int16x8_t cr_const1 = vdupq_n_s16(-(short)(0.71414f * 4096.0f + 0.5f)); - int16x8_t cb_const0 = vdupq_n_s16(-(short)(0.34414f * 4096.0f + 0.5f)); - int16x8_t cb_const1 = vdupq_n_s16((short)(1.77200f * 4096.0f + 0.5f)); - - for (; i + 7 < count; i += 8) { - // load - uint8x8_t y_bytes = vld1_u8(y + i); - uint8x8_t cr_bytes = vld1_u8(pcr + i); - uint8x8_t cb_bytes = vld1_u8(pcb + i); - int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); - int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); - - // expand to s16 - int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); - int16x8_t crw = vshll_n_s8(cr_biased, 7); - int16x8_t cbw = vshll_n_s8(cb_biased, 7); - - // color transform - int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); - int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); - int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); - int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); - int16x8_t rws = vaddq_s16(yws, cr0); - int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); - int16x8_t bws = vaddq_s16(yws, cb1); - - // undo scaling, round, convert to byte - uint8x8x4_t o; - o.val[0] = vqrshrun_n_s16(rws, 4); - o.val[1] = vqrshrun_n_s16(gws, 4); - o.val[2] = vqrshrun_n_s16(bws, 4); - o.val[3] = vdup_n_u8(255); - - // store, interleaving r/g/b/a - vst4_u8(out, o); - out += 8 * 4; - } - } -#endif - - for (; i < count; ++i) { - int y_fixed = (y[i] << 20) + (1 << 19); // rounding - int r, g, b; - int cr = pcr[i] - 128; - int cb = pcb[i] - 128; - r = y_fixed + cr * stbi__float2fixed(1.40200f); - g = y_fixed + cr * -stbi__float2fixed(0.71414f) + ((cb * -stbi__float2fixed(0.34414f)) & 0xffff0000); - b = y_fixed + cb * stbi__float2fixed(1.77200f); - r >>= 20; - g >>= 20; - b >>= 20; - if ((unsigned)r > 255) { if (r < 0) r = 0; else r = 255; } - if ((unsigned)g > 255) { if (g < 0) g = 0; else g = 255; } - if ((unsigned)b > 255) { if (b < 0) b = 0; else b = 255; } - out[0] = (stbi_uc)r; - out[1] = (stbi_uc)g; - out[2] = (stbi_uc)b; - out[3] = 255; - out += step; - } -} -#endif - -// set up the kernels -static void stbi__setup_jpeg(stbi__jpeg* j) -{ - j->idct_block_kernel = stbi__idct_block; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; - -#ifdef STBI_SSE2 - if (stbi__sse2_available()) { - j->idct_block_kernel = stbi__idct_simd; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; - } -#endif - -#ifdef STBI_NEON - j->idct_block_kernel = stbi__idct_simd; - j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; - j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; -#endif -} - -// clean up the temporary component buffers -static void stbi__cleanup_jpeg(stbi__jpeg* j) -{ - stbi__free_jpeg_components(j, j->s->img_n, 0); -} - -typedef struct -{ - resample_row_func resample; - stbi_uc* line0, * line1; - int hs, vs; // expansion factor in each axis - int w_lores; // horizontal pixels pre-expansion - int ystep; // how far through vertical expansion we are - int ypos; // which pre-expansion row we're on -} stbi__resample; - -// fast 0..255 * 0..255 => 0..255 rounded multiplication -static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y) -{ - unsigned int t = x * y + 128; - return (stbi_uc)((t + (t >> 8)) >> 8); -} - -static stbi_uc* load_jpeg_image(stbi__jpeg* z, int* out_x, int* out_y, int* comp, int req_comp) -{ - int n, decode_n, is_rgb; - z->s->img_n = 0; // make stbi__cleanup_jpeg safe - - // validate req_comp - if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); - - // load a jpeg image from whichever source, but leave in YCbCr format - if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } - - // determine actual number of components to generate - n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; - - is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); - - if (z->s->img_n == 3 && n < 3 && !is_rgb) - decode_n = 1; - else - decode_n = z->s->img_n; - - // nothing to do if no components requested; check this now to avoid - // accessing uninitialized coutput[0] later - if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } - - // resample and color-convert - { - int k; - unsigned int i, j; - stbi_uc* output; - stbi_uc* coutput[4] = { NULL, NULL, NULL, NULL }; - - stbi__resample res_comp[4]; - - for (k = 0; k < decode_n; ++k) { - stbi__resample* r = &res_comp[k]; - - // allocate line buffer big enough for upsampling off the edges - // with upsample factor of 4 - z->img_comp[k].linebuf = (stbi_uc*)stbi__malloc(z->s->img_x + 3); - if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } - - r->hs = z->img_h_max / z->img_comp[k].h; - r->vs = z->img_v_max / z->img_comp[k].v; - r->ystep = r->vs >> 1; - r->w_lores = (z->s->img_x + r->hs - 1) / r->hs; - r->ypos = 0; - r->line0 = r->line1 = z->img_comp[k].data; - - if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; - else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; - else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; - else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; - else r->resample = stbi__resample_row_generic; - } - - // can't error after this so, this is safe - output = (stbi_uc*)stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); - if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } - - // now go ahead and resample - for (j = 0; j < z->s->img_y; ++j) { - stbi_uc* out = output + n * z->s->img_x * j; - for (k = 0; k < decode_n; ++k) { - stbi__resample* r = &res_comp[k]; - int y_bot = r->ystep >= (r->vs >> 1); - coutput[k] = r->resample(z->img_comp[k].linebuf, - y_bot ? r->line1 : r->line0, - y_bot ? r->line0 : r->line1, - r->w_lores, r->hs); - if (++r->ystep >= r->vs) { - r->ystep = 0; - r->line0 = r->line1; - if (++r->ypos < z->img_comp[k].y) - r->line1 += z->img_comp[k].w2; - } - } - if (n >= 3) { - stbi_uc* y = coutput[0]; - if (z->s->img_n == 3) { - if (is_rgb) { - for (i = 0; i < z->s->img_x; ++i) { - out[0] = y[i]; - out[1] = coutput[1][i]; - out[2] = coutput[2][i]; - out[3] = 255; - out += n; - } - } - else { - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - } - } - else if (z->s->img_n == 4) { - if (z->app14_color_transform == 0) { // CMYK - for (i = 0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - out[0] = stbi__blinn_8x8(coutput[0][i], m); - out[1] = stbi__blinn_8x8(coutput[1][i], m); - out[2] = stbi__blinn_8x8(coutput[2][i], m); - out[3] = 255; - out += n; - } - } - else if (z->app14_color_transform == 2) { // YCCK - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - for (i = 0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - out[0] = stbi__blinn_8x8(255 - out[0], m); - out[1] = stbi__blinn_8x8(255 - out[1], m); - out[2] = stbi__blinn_8x8(255 - out[2], m); - out += n; - } - } - else { // YCbCr + alpha? Ignore the fourth channel for now - z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); - } - } - else - for (i = 0; i < z->s->img_x; ++i) { - out[0] = out[1] = out[2] = y[i]; - out[3] = 255; // not used if n==3 - out += n; - } - } - else { - if (is_rgb) { - if (n == 1) - for (i = 0; i < z->s->img_x; ++i) - *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); - else { - for (i = 0; i < z->s->img_x; ++i, out += 2) { - out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); - out[1] = 255; - } - } - } - else if (z->s->img_n == 4 && z->app14_color_transform == 0) { - for (i = 0; i < z->s->img_x; ++i) { - stbi_uc m = coutput[3][i]; - stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); - stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); - stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); - out[0] = stbi__compute_y(r, g, b); - out[1] = 255; - out += n; - } - } - else if (z->s->img_n == 4 && z->app14_color_transform == 2) { - for (i = 0; i < z->s->img_x; ++i) { - out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); - out[1] = 255; - out += n; - } - } - else { - stbi_uc* y = coutput[0]; - if (n == 1) - for (i = 0; i < z->s->img_x; ++i) out[i] = y[i]; - else - for (i = 0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } - } - } - } - stbi__cleanup_jpeg(z); - *out_x = z->s->img_x; - *out_y = z->s->img_y; - if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output - return output; - } -} - -static void* stbi__jpeg_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - unsigned char* result; - stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); - if (!j) return stbi__errpuc("outofmem", "Out of memory"); - STBI_NOTUSED(ri); - j->s = s; - stbi__setup_jpeg(j); - result = load_jpeg_image(j, x, y, comp, req_comp); - STBI_FREE(j); - return result; -} - -static int stbi__jpeg_test(stbi__context* s) -{ - int r; - stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); - if (!j) return stbi__err("outofmem", "Out of memory"); - j->s = s; - stbi__setup_jpeg(j); - r = stbi__decode_jpeg_header(j, STBI__SCAN_type); - stbi__rewind(s); - STBI_FREE(j); - return r; -} - -static int stbi__jpeg_info_raw(stbi__jpeg* j, int* x, int* y, int* comp) -{ - if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { - stbi__rewind(j->s); - return 0; - } - if (x) *x = j->s->img_x; - if (y) *y = j->s->img_y; - if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; - return 1; -} - -static int stbi__jpeg_info(stbi__context* s, int* x, int* y, int* comp) -{ - int result; - stbi__jpeg* j = (stbi__jpeg*)(stbi__malloc(sizeof(stbi__jpeg))); - if (!j) return stbi__err("outofmem", "Out of memory"); - j->s = s; - result = stbi__jpeg_info_raw(j, x, y, comp); - STBI_FREE(j); - return result; -} -#endif - -// public domain zlib decode v0.2 Sean Barrett 2006-11-18 -// simple implementation -// - all input must be provided in an upfront buffer -// - all output is written to a single output buffer (can malloc/realloc) -// performance -// - fast huffman - -#ifndef STBI_NO_ZLIB - -// fast-way is faster to check than jpeg huffman, but slow way is slower -#define STBI__ZFAST_BITS 9 // accelerate all cases in default tables -#define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) -#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet - -// zlib-style huffman encoding -// (jpegs packs from left, zlib from right, so can't share code) -typedef struct -{ - stbi__uint16 fast[1 << STBI__ZFAST_BITS]; - stbi__uint16 firstcode[16]; - int maxcode[17]; - stbi__uint16 firstsymbol[16]; - stbi_uc size[STBI__ZNSYMS]; - stbi__uint16 value[STBI__ZNSYMS]; -} stbi__zhuffman; - -stbi_inline static int stbi__bitreverse16(int n) -{ - n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); - n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); - n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); - n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); - return n; -} - -stbi_inline static int stbi__bit_reverse(int v, int bits) -{ - STBI_ASSERT(bits <= 16); - // to bit reverse n bits, reverse 16 and shift - // e.g. 11 bits, bit reverse and shift away 5 - return stbi__bitreverse16(v) >> (16 - bits); -} - -static int stbi__zbuild_huffman(stbi__zhuffman* z, const stbi_uc* sizelist, int num) -{ - int i, k = 0; - int code, next_code[16], sizes[17]; - - // DEFLATE spec for generating codes - memset(sizes, 0, sizeof(sizes)); - memset(z->fast, 0, sizeof(z->fast)); - for (i = 0; i < num; ++i) - ++sizes[sizelist[i]]; - sizes[0] = 0; - for (i = 1; i < 16; ++i) - if (sizes[i] > (1 << i)) - return stbi__err("bad sizes", "Corrupt PNG"); - code = 0; - for (i = 1; i < 16; ++i) { - next_code[i] = code; - z->firstcode[i] = (stbi__uint16)code; - z->firstsymbol[i] = (stbi__uint16)k; - code = (code + sizes[i]); - if (sizes[i]) - if (code - 1 >= (1 << i)) return stbi__err("bad codelengths", "Corrupt PNG"); - z->maxcode[i] = code << (16 - i); // preshift for inner loop - code <<= 1; - k += sizes[i]; - } - z->maxcode[16] = 0x10000; // sentinel - for (i = 0; i < num; ++i) { - int s = sizelist[i]; - if (s) { - int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; - stbi__uint16 fastv = (stbi__uint16)((s << 9) | i); - z->size[c] = (stbi_uc)s; - z->value[c] = (stbi__uint16)i; - if (s <= STBI__ZFAST_BITS) { - int j = stbi__bit_reverse(next_code[s], s); - while (j < (1 << STBI__ZFAST_BITS)) { - z->fast[j] = fastv; - j += (1 << s); - } - } - ++next_code[s]; - } - } - return 1; -} - -// zlib-from-memory implementation for PNG reading -// because PNG allows splitting the zlib stream arbitrarily, -// and it's annoying structurally to have PNG call ZLIB call PNG, -// we require PNG read all the IDATs and combine them into a single -// memory buffer - -typedef struct -{ - stbi_uc* zbuffer, * zbuffer_end; - int num_bits; - stbi__uint32 code_buffer; - - char* zout; - char* zout_start; - char* zout_end; - int z_expandable; - - stbi__zhuffman z_length, z_distance; -} stbi__zbuf; - -stbi_inline static int stbi__zeof(stbi__zbuf* z) -{ - return (z->zbuffer >= z->zbuffer_end); -} - -stbi_inline static stbi_uc stbi__zget8(stbi__zbuf* z) -{ - return stbi__zeof(z) ? 0 : *z->zbuffer++; -} - -static void stbi__fill_bits(stbi__zbuf* z) -{ - do { - if (z->code_buffer >= (1U << z->num_bits)) { - z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ - return; - } - z->code_buffer |= (unsigned int)stbi__zget8(z) << z->num_bits; - z->num_bits += 8; - } while (z->num_bits <= 24); -} - -stbi_inline static unsigned int stbi__zreceive(stbi__zbuf* z, int n) -{ - unsigned int k; - if (z->num_bits < n) stbi__fill_bits(z); - k = z->code_buffer & ((1 << n) - 1); - z->code_buffer >>= n; - z->num_bits -= n; - return k; -} - -static int stbi__zhuffman_decode_slowpath(stbi__zbuf* a, stbi__zhuffman* z) -{ - int b, s, k; - // not resolved by fast table, so compute it the slow way - // use jpeg approach, which requires MSbits at top - k = stbi__bit_reverse(a->code_buffer, 16); - for (s = STBI__ZFAST_BITS + 1; ; ++s) - if (k < z->maxcode[s]) - break; - if (s >= 16) return -1; // invalid code! - // code size is s, so: - b = (k >> (16 - s)) - z->firstcode[s] + z->firstsymbol[s]; - if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! - if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. - a->code_buffer >>= s; - a->num_bits -= s; - return z->value[b]; -} - -stbi_inline static int stbi__zhuffman_decode(stbi__zbuf* a, stbi__zhuffman* z) -{ - int b, s; - if (a->num_bits < 16) { - if (stbi__zeof(a)) { - return -1; /* report error for unexpected end of data. */ - } - stbi__fill_bits(a); - } - b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; - if (b) { - s = b >> 9; - a->code_buffer >>= s; - a->num_bits -= s; - return b & 511; - } - return stbi__zhuffman_decode_slowpath(a, z); -} - -static int stbi__zexpand(stbi__zbuf* z, char* zout, int n) // need to make room for n bytes -{ - char* q; - unsigned int cur, limit, old_limit; - z->zout = zout; - if (!z->z_expandable) return stbi__err("output buffer limit", "Corrupt PNG"); - cur = (unsigned int)(z->zout - z->zout_start); - limit = old_limit = (unsigned)(z->zout_end - z->zout_start); - if (UINT_MAX - cur < (unsigned)n) return stbi__err("outofmem", "Out of memory"); - while (cur + n > limit) { - if (limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); - limit *= 2; - } - q = (char*)STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); - STBI_NOTUSED(old_limit); - if (q == NULL) return stbi__err("outofmem", "Out of memory"); - z->zout_start = q; - z->zout = q + cur; - z->zout_end = q + limit; - return 1; -} - -static const int stbi__zlength_base[31] = { - 3,4,5,6,7,8,9,10,11,13, - 15,17,19,23,27,31,35,43,51,59, - 67,83,99,115,131,163,195,227,258,0,0 }; - -static const int stbi__zlength_extra[31] = -{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; - -static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, -257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0 }; - -static const int stbi__zdist_extra[32] = -{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13 }; - -static int stbi__parse_huffman_block(stbi__zbuf* a) -{ - char* zout = a->zout; - for (;;) { - int z = stbi__zhuffman_decode(a, &a->z_length); - if (z < 256) { - if (z < 0) return stbi__err("bad huffman code", "Corrupt PNG"); // error in huffman codes - if (zout >= a->zout_end) { - if (!stbi__zexpand(a, zout, 1)) return 0; - zout = a->zout; - } - *zout++ = (char)z; - } - else { - stbi_uc* p; - int len, dist; - if (z == 256) { - a->zout = zout; - return 1; - } - z -= 257; - len = stbi__zlength_base[z]; - if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); - z = stbi__zhuffman_decode(a, &a->z_distance); - if (z < 0) return stbi__err("bad huffman code", "Corrupt PNG"); - dist = stbi__zdist_base[z]; - if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); - if (zout - a->zout_start < dist) return stbi__err("bad dist", "Corrupt PNG"); - if (zout + len > a->zout_end) { - if (!stbi__zexpand(a, zout, len)) return 0; - zout = a->zout; - } - p = (stbi_uc*)(zout - dist); - if (dist == 1) { // run of one byte; common in images. - stbi_uc v = *p; - if (len) { do *zout++ = v; while (--len); } - } - else { - if (len) { do *zout++ = *p++; while (--len); } - } - } - } -} - -static int stbi__compute_huffman_codes(stbi__zbuf* a) -{ - static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; - stbi__zhuffman z_codelength; - stbi_uc lencodes[286 + 32 + 137];//padding for maximum single op - stbi_uc codelength_sizes[19]; - int i, n; - - int hlit = stbi__zreceive(a, 5) + 257; - int hdist = stbi__zreceive(a, 5) + 1; - int hclen = stbi__zreceive(a, 4) + 4; - int ntot = hlit + hdist; - - memset(codelength_sizes, 0, sizeof(codelength_sizes)); - for (i = 0; i < hclen; ++i) { - int s = stbi__zreceive(a, 3); - codelength_sizes[length_dezigzag[i]] = (stbi_uc)s; - } - if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; - - n = 0; - while (n < ntot) { - int c = stbi__zhuffman_decode(a, &z_codelength); - if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); - if (c < 16) - lencodes[n++] = (stbi_uc)c; - else { - stbi_uc fill = 0; - if (c == 16) { - c = stbi__zreceive(a, 2) + 3; - if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); - fill = lencodes[n - 1]; - } - else if (c == 17) { - c = stbi__zreceive(a, 3) + 3; - } - else if (c == 18) { - c = stbi__zreceive(a, 7) + 11; - } - else { - return stbi__err("bad codelengths", "Corrupt PNG"); - } - if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); - memset(lencodes + n, fill, c); - n += c; - } - } - if (n != ntot) return stbi__err("bad codelengths", "Corrupt PNG"); - if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; - if (!stbi__zbuild_huffman(&a->z_distance, lencodes + hlit, hdist)) return 0; - return 1; -} - -static int stbi__parse_uncompressed_block(stbi__zbuf* a) -{ - stbi_uc header[4]; - int len, nlen, k; - if (a->num_bits & 7) - stbi__zreceive(a, a->num_bits & 7); // discard - // drain the bit-packed data into header - k = 0; - while (a->num_bits > 0) { - header[k++] = (stbi_uc)(a->code_buffer & 255); // suppress MSVC run-time check - a->code_buffer >>= 8; - a->num_bits -= 8; - } - if (a->num_bits < 0) return stbi__err("zlib corrupt", "Corrupt PNG"); - // now fill header the normal way - while (k < 4) - header[k++] = stbi__zget8(a); - len = header[1] * 256 + header[0]; - nlen = header[3] * 256 + header[2]; - if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt", "Corrupt PNG"); - if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer", "Corrupt PNG"); - if (a->zout + len > a->zout_end) - if (!stbi__zexpand(a, a->zout, len)) return 0; - memcpy(a->zout, a->zbuffer, len); - a->zbuffer += len; - a->zout += len; - return 1; -} - -static int stbi__parse_zlib_header(stbi__zbuf* a) -{ - int cmf = stbi__zget8(a); - int cm = cmf & 15; - /* int cinfo = cmf >> 4; */ - int flg = stbi__zget8(a); - if (stbi__zeof(a)) return stbi__err("bad zlib header", "Corrupt PNG"); // zlib spec - if ((cmf * 256 + flg) % 31 != 0) return stbi__err("bad zlib header", "Corrupt PNG"); // zlib spec - if (flg & 32) return stbi__err("no preset dict", "Corrupt PNG"); // preset dictionary not allowed in png - if (cm != 8) return stbi__err("bad compression", "Corrupt PNG"); // DEFLATE required for png - // window = 1 << (8 + cinfo)... but who cares, we fully buffer output - return 1; -} - -static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = -{ - 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, - 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, - 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, - 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, - 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, - 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, - 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, - 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, - 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8 -}; -static const stbi_uc stbi__zdefault_distance[32] = -{ - 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5 -}; -/* -Init algorithm: -{ - int i; // use <= to match clearly with spec - for (i=0; i <= 143; ++i) stbi__zdefault_length[i] = 8; - for ( ; i <= 255; ++i) stbi__zdefault_length[i] = 9; - for ( ; i <= 279; ++i) stbi__zdefault_length[i] = 7; - for ( ; i <= 287; ++i) stbi__zdefault_length[i] = 8; - - for (i=0; i <= 31; ++i) stbi__zdefault_distance[i] = 5; -} -*/ - -static int stbi__parse_zlib(stbi__zbuf* a, int parse_header) -{ - int final, type; - if (parse_header) - if (!stbi__parse_zlib_header(a)) return 0; - a->num_bits = 0; - a->code_buffer = 0; - do { - final = stbi__zreceive(a, 1); - type = stbi__zreceive(a, 2); - if (type == 0) { - if (!stbi__parse_uncompressed_block(a)) return 0; - } - else if (type == 3) { - return 0; - } - else { - if (type == 1) { - // use fixed code lengths - if (!stbi__zbuild_huffman(&a->z_length, stbi__zdefault_length, STBI__ZNSYMS)) return 0; - if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; - } - else { - if (!stbi__compute_huffman_codes(a)) return 0; - } - if (!stbi__parse_huffman_block(a)) return 0; - } - } while (!final); - return 1; -} - -static int stbi__do_zlib(stbi__zbuf* a, char* obuf, int olen, int exp, int parse_header) -{ - a->zout_start = obuf; - a->zout = obuf; - a->zout_end = obuf + olen; - a->z_expandable = exp; - - return stbi__parse_zlib(a, parse_header); -} - -STBIDEF char* stbi_zlib_decode_malloc_guesssize(const char* buffer, int len, int initial_size, int* outlen) -{ - stbi__zbuf a; - char* p = (char*)stbi__malloc(initial_size); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc*)buffer; - a.zbuffer_end = (stbi_uc*)buffer + len; - if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { - if (outlen) *outlen = (int)(a.zout - a.zout_start); - return a.zout_start; - } - else { - STBI_FREE(a.zout_start); - return NULL; - } -} - -STBIDEF char* stbi_zlib_decode_malloc(char const* buffer, int len, int* outlen) -{ - return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); -} - -STBIDEF char* stbi_zlib_decode_malloc_guesssize_headerflag(const char* buffer, int len, int initial_size, int* outlen, int parse_header) -{ - stbi__zbuf a; - char* p = (char*)stbi__malloc(initial_size); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc*)buffer; - a.zbuffer_end = (stbi_uc*)buffer + len; - if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { - if (outlen) *outlen = (int)(a.zout - a.zout_start); - return a.zout_start; - } - else { - STBI_FREE(a.zout_start); - return NULL; - } -} - -STBIDEF int stbi_zlib_decode_buffer(char* obuffer, int olen, char const* ibuffer, int ilen) -{ - stbi__zbuf a; - a.zbuffer = (stbi_uc*)ibuffer; - a.zbuffer_end = (stbi_uc*)ibuffer + ilen; - if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) - return (int)(a.zout - a.zout_start); - else - return -1; -} - -STBIDEF char* stbi_zlib_decode_noheader_malloc(char const* buffer, int len, int* outlen) -{ - stbi__zbuf a; - char* p = (char*)stbi__malloc(16384); - if (p == NULL) return NULL; - a.zbuffer = (stbi_uc*)buffer; - a.zbuffer_end = (stbi_uc*)buffer + len; - if (stbi__do_zlib(&a, p, 16384, 1, 0)) { - if (outlen) *outlen = (int)(a.zout - a.zout_start); - return a.zout_start; - } - else { - STBI_FREE(a.zout_start); - return NULL; - } -} - -STBIDEF int stbi_zlib_decode_noheader_buffer(char* obuffer, int olen, const char* ibuffer, int ilen) -{ - stbi__zbuf a; - a.zbuffer = (stbi_uc*)ibuffer; - a.zbuffer_end = (stbi_uc*)ibuffer + ilen; - if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) - return (int)(a.zout - a.zout_start); - else - return -1; -} -#endif - -// public domain "baseline" PNG decoder v0.10 Sean Barrett 2006-11-18 -// simple implementation -// - only 8-bit samples -// - no CRC checking -// - allocates lots of intermediate memory -// - avoids problem of streaming data between subsystems -// - avoids explicit window management -// performance -// - uses stb_zlib, a PD zlib implementation with fast huffman decoding - -#ifndef STBI_NO_PNG -typedef struct -{ - stbi__uint32 length; - stbi__uint32 type; -} stbi__pngchunk; - -static stbi__pngchunk stbi__get_chunk_header(stbi__context* s) -{ - stbi__pngchunk c; - c.length = stbi__get32be(s); - c.type = stbi__get32be(s); - return c; -} - -static int stbi__check_png_header(stbi__context* s) -{ - static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; - int i; - for (i = 0; i < 8; ++i) - if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig", "Not a PNG"); - return 1; -} - -typedef struct -{ - stbi__context* s; - stbi_uc* idata, * expanded, * out; - int depth; -} stbi__png; - - -enum { - STBI__F_none = 0, - STBI__F_sub = 1, - STBI__F_up = 2, - STBI__F_avg = 3, - STBI__F_paeth = 4, - // synthetic filters used for first scanline to avoid needing a dummy row of 0s - STBI__F_avg_first, - STBI__F_paeth_first -}; - -static stbi_uc first_row_filter[5] = -{ - STBI__F_none, - STBI__F_sub, - STBI__F_none, - STBI__F_avg_first, - STBI__F_paeth_first -}; - -static int stbi__paeth(int a, int b, int c) -{ - int p = a + b - c; - int pa = abs(p - a); - int pb = abs(p - b); - int pc = abs(p - c); - if (pa <= pb && pa <= pc) return a; - if (pb <= pc) return b; - return c; -} - -static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; - -// create the png data from post-deflated data -static int stbi__create_png_image_raw(stbi__png* a, stbi_uc* raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) -{ - int bytes = (depth == 16 ? 2 : 1); - stbi__context* s = a->s; - stbi__uint32 i, j, stride = x * out_n * bytes; - stbi__uint32 img_len, img_width_bytes; - int k; - int img_n = s->img_n; // copy it into a local for later - - int output_bytes = out_n * bytes; - int filter_bytes = img_n * bytes; - int width = x; - - STBI_ASSERT(out_n == s->img_n || out_n == s->img_n + 1); - a->out = (stbi_uc*)stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into - if (!a->out) return stbi__err("outofmem", "Out of memory"); - - if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); - img_width_bytes = (((img_n * x * depth) + 7) >> 3); - img_len = (img_width_bytes + 1) * y; - - // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, - // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), - // so just check for raw_len < img_len always. - if (raw_len < img_len) return stbi__err("not enough pixels", "Corrupt PNG"); - - for (j = 0; j < y; ++j) { - stbi_uc* cur = a->out + stride * j; - stbi_uc* prior; - int filter = *raw++; - - if (filter > 4) - return stbi__err("invalid filter", "Corrupt PNG"); - - if (depth < 8) { - if (img_width_bytes > x) return stbi__err("invalid width", "Corrupt PNG"); - cur += x * out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place - filter_bytes = 1; - width = img_width_bytes; - } - prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above - - // if first row, use special filter that doesn't sample previous row - if (j == 0) filter = first_row_filter[filter]; - - // handle first byte explicitly - for (k = 0; k < filter_bytes; ++k) { - switch (filter) { - case STBI__F_none: cur[k] = raw[k]; break; - case STBI__F_sub: cur[k] = raw[k]; break; - case STBI__F_up: cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; - case STBI__F_avg: cur[k] = STBI__BYTECAST(raw[k] + (prior[k] >> 1)); break; - case STBI__F_paeth: cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0, prior[k], 0)); break; - case STBI__F_avg_first: cur[k] = raw[k]; break; - case STBI__F_paeth_first: cur[k] = raw[k]; break; - } - } - - if (depth == 8) { - if (img_n != out_n) - cur[img_n] = 255; // first pixel - raw += img_n; - cur += out_n; - prior += out_n; - } - else if (depth == 16) { - if (img_n != out_n) { - cur[filter_bytes] = 255; // first pixel top byte - cur[filter_bytes + 1] = 255; // first pixel bottom byte - } - raw += filter_bytes; - cur += output_bytes; - prior += output_bytes; - } - else { - raw += 1; - cur += 1; - prior += 1; - } - - // this is a little gross, so that we don't switch per-pixel or per-component - if (depth < 8 || img_n == out_n) { - int nk = (width - 1) * filter_bytes; -#define STBI__CASE(f) \ - case f: \ - for (k=0; k < nk; ++k) - switch (filter) { - // "none" filter turns into a memcpy here; make that explicit. - case STBI__F_none: memcpy(cur, raw, nk); break; - STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k - filter_bytes]); } break; - STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; - STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k - filter_bytes]) >> 1)); } break; - STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - filter_bytes], prior[k], prior[k - filter_bytes])); } break; - STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k - filter_bytes] >> 1)); } break; - STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - filter_bytes], 0, 0)); } break; - } -#undef STBI__CASE - raw += nk; - } - else { - STBI_ASSERT(img_n + 1 == out_n); -#define STBI__CASE(f) \ - case f: \ - for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \ - for (k=0; k < filter_bytes; ++k) - switch (filter) { - STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; - STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k - output_bytes]); } break; - STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; - STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k - output_bytes]) >> 1)); } break; - STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - output_bytes], prior[k], prior[k - output_bytes])); } break; - STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k - output_bytes] >> 1)); } break; - STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k - output_bytes], 0, 0)); } break; - } -#undef STBI__CASE - - // the loop above sets the high byte of the pixels' alpha, but for - // 16 bit png files we also need the low byte set. we'll do that here. - if (depth == 16) { - cur = a->out + stride * j; // start at the beginning of the row again - for (i = 0; i < x; ++i, cur += output_bytes) { - cur[filter_bytes + 1] = 255; - } - } - } - } - - // we make a separate pass to expand bits to pixels; for performance, - // this could run two scanlines behind the above code, so it won't - // intefere with filtering but will still be in the cache. - if (depth < 8) { - for (j = 0; j < y; ++j) { - stbi_uc* cur = a->out + stride * j; - stbi_uc* in = a->out + stride * j + x * out_n - img_width_bytes; - // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit - // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop - stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range - - // note that the final byte might overshoot and write more data than desired. - // we can allocate enough data that this never writes out of memory, but it - // could also overwrite the next scanline. can it overwrite non-empty data - // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. - // so we need to explicitly clamp the final ones - - if (depth == 4) { - for (k = x * img_n; k >= 2; k -= 2, ++in) { - *cur++ = scale * ((*in >> 4)); - *cur++ = scale * ((*in) & 0x0f); - } - if (k > 0) *cur++ = scale * ((*in >> 4)); - } - else if (depth == 2) { - for (k = x * img_n; k >= 4; k -= 4, ++in) { - *cur++ = scale * ((*in >> 6)); - *cur++ = scale * ((*in >> 4) & 0x03); - *cur++ = scale * ((*in >> 2) & 0x03); - *cur++ = scale * ((*in) & 0x03); - } - if (k > 0) *cur++ = scale * ((*in >> 6)); - if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); - if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); - } - else if (depth == 1) { - for (k = x * img_n; k >= 8; k -= 8, ++in) { - *cur++ = scale * ((*in >> 7)); - *cur++ = scale * ((*in >> 6) & 0x01); - *cur++ = scale * ((*in >> 5) & 0x01); - *cur++ = scale * ((*in >> 4) & 0x01); - *cur++ = scale * ((*in >> 3) & 0x01); - *cur++ = scale * ((*in >> 2) & 0x01); - *cur++ = scale * ((*in >> 1) & 0x01); - *cur++ = scale * ((*in) & 0x01); - } - if (k > 0) *cur++ = scale * ((*in >> 7)); - if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); - if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); - if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); - if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); - if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); - if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); - } - if (img_n != out_n) { - int q; - // insert alpha = 255 - cur = a->out + stride * j; - if (img_n == 1) { - for (q = x - 1; q >= 0; --q) { - cur[q * 2 + 1] = 255; - cur[q * 2 + 0] = cur[q]; - } - } - else { - STBI_ASSERT(img_n == 3); - for (q = x - 1; q >= 0; --q) { - cur[q * 4 + 3] = 255; - cur[q * 4 + 2] = cur[q * 3 + 2]; - cur[q * 4 + 1] = cur[q * 3 + 1]; - cur[q * 4 + 0] = cur[q * 3 + 0]; - } - } - } - } - } - else if (depth == 16) { - // force the image data from big-endian to platform-native. - // this is done in a separate pass due to the decoding relying - // on the data being untouched, but could probably be done - // per-line during decode if care is taken. - stbi_uc* cur = a->out; - stbi__uint16* cur16 = (stbi__uint16*)cur; - - for (i = 0; i < x * y * out_n; ++i, cur16++, cur += 2) { - *cur16 = (cur[0] << 8) | cur[1]; - } - } - - return 1; -} - -static int stbi__create_png_image(stbi__png* a, stbi_uc* image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) -{ - int bytes = (depth == 16 ? 2 : 1); - int out_bytes = out_n * bytes; - stbi_uc* final; - int p; - if (!interlaced) - return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); - - // de-interlacing - final = (stbi_uc*)stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); - if (!final) return stbi__err("outofmem", "Out of memory"); - for (p = 0; p < 7; ++p) { - int xorig[] = { 0,4,0,2,0,1,0 }; - int yorig[] = { 0,0,4,0,2,0,1 }; - int xspc[] = { 8,8,4,4,2,2,1 }; - int yspc[] = { 8,8,8,4,4,2,2 }; - int i, j, x, y; - // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 - x = (a->s->img_x - xorig[p] + xspc[p] - 1) / xspc[p]; - y = (a->s->img_y - yorig[p] + yspc[p] - 1) / yspc[p]; - if (x && y) { - stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; - if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { - STBI_FREE(final); - return 0; - } - for (j = 0; j < y; ++j) { - for (i = 0; i < x; ++i) { - int out_y = j * yspc[p] + yorig[p]; - int out_x = i * xspc[p] + xorig[p]; - memcpy(final + out_y * a->s->img_x * out_bytes + out_x * out_bytes, - a->out + (j * x + i) * out_bytes, out_bytes); - } - } - STBI_FREE(a->out); - image_data += img_len; - image_data_len -= img_len; - } - } - a->out = final; - - return 1; -} - -static int stbi__compute_transparency(stbi__png* z, stbi_uc tc[3], int out_n) -{ - stbi__context* s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi_uc* p = z->out; - - // compute color-based transparency, assuming we've - // already got 255 as the alpha value in the output - STBI_ASSERT(out_n == 2 || out_n == 4); - - if (out_n == 2) { - for (i = 0; i < pixel_count; ++i) { - p[1] = (p[0] == tc[0] ? 0 : 255); - p += 2; - } - } - else { - for (i = 0; i < pixel_count; ++i) { - if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) - p[3] = 0; - p += 4; - } - } - return 1; -} - -static int stbi__compute_transparency16(stbi__png* z, stbi__uint16 tc[3], int out_n) -{ - stbi__context* s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi__uint16* p = (stbi__uint16*)z->out; - - // compute color-based transparency, assuming we've - // already got 65535 as the alpha value in the output - STBI_ASSERT(out_n == 2 || out_n == 4); - - if (out_n == 2) { - for (i = 0; i < pixel_count; ++i) { - p[1] = (p[0] == tc[0] ? 0 : 65535); - p += 2; - } - } - else { - for (i = 0; i < pixel_count; ++i) { - if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) - p[3] = 0; - p += 4; - } - } - return 1; -} - -static int stbi__expand_png_palette(stbi__png* a, stbi_uc* palette, int len, int pal_img_n) -{ - stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; - stbi_uc* p, * temp_out, * orig = a->out; - - p = (stbi_uc*)stbi__malloc_mad2(pixel_count, pal_img_n, 0); - if (p == NULL) return stbi__err("outofmem", "Out of memory"); - - // between here and free(out) below, exitting would leak - temp_out = p; - - if (pal_img_n == 3) { - for (i = 0; i < pixel_count; ++i) { - int n = orig[i] * 4; - p[0] = palette[n]; - p[1] = palette[n + 1]; - p[2] = palette[n + 2]; - p += 3; - } - } - else { - for (i = 0; i < pixel_count; ++i) { - int n = orig[i] * 4; - p[0] = palette[n]; - p[1] = palette[n + 1]; - p[2] = palette[n + 2]; - p[3] = palette[n + 3]; - p += 4; - } - } - STBI_FREE(a->out); - a->out = temp_out; - - STBI_NOTUSED(len); - - return 1; -} - -static int stbi__unpremultiply_on_load_global = 0; -static int stbi__de_iphone_flag_global = 0; - -STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) -{ - stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; -} - -STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) -{ - stbi__de_iphone_flag_global = flag_true_if_should_convert; -} - -#ifndef STBI_THREAD_LOCAL -#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global -#define stbi__de_iphone_flag stbi__de_iphone_flag_global -#else -static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; -static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; - -STBIDEF void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) -{ - stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; - stbi__unpremultiply_on_load_set = 1; -} - -STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) -{ - stbi__de_iphone_flag_local = flag_true_if_should_convert; - stbi__de_iphone_flag_set = 1; -} - -#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ - ? stbi__unpremultiply_on_load_local \ - : stbi__unpremultiply_on_load_global) -#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ - ? stbi__de_iphone_flag_local \ - : stbi__de_iphone_flag_global) -#endif // STBI_THREAD_LOCAL - -static void stbi__de_iphone(stbi__png* z) -{ - stbi__context* s = z->s; - stbi__uint32 i, pixel_count = s->img_x * s->img_y; - stbi_uc* p = z->out; - - if (s->img_out_n == 3) { // convert bgr to rgb - for (i = 0; i < pixel_count; ++i) { - stbi_uc t = p[0]; - p[0] = p[2]; - p[2] = t; - p += 3; - } - } - else { - STBI_ASSERT(s->img_out_n == 4); - if (stbi__unpremultiply_on_load) { - // convert bgr to rgb and unpremultiply - for (i = 0; i < pixel_count; ++i) { - stbi_uc a = p[3]; - stbi_uc t = p[0]; - if (a) { - stbi_uc half = a / 2; - p[0] = (p[2] * 255 + half) / a; - p[1] = (p[1] * 255 + half) / a; - p[2] = (t * 255 + half) / a; - } - else { - p[0] = p[2]; - p[2] = t; - } - p += 4; - } - } - else { - // convert bgr to rgb - for (i = 0; i < pixel_count; ++i) { - stbi_uc t = p[0]; - p[0] = p[2]; - p[2] = t; - p += 4; - } - } - } -} - -#define STBI__PNG_TYPE(a,b,c,d) (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d)) - -static int stbi__parse_png_file(stbi__png* z, int scan, int req_comp) -{ - stbi_uc palette[1024], pal_img_n = 0; - stbi_uc has_trans = 0, tc[3] = { 0 }; - stbi__uint16 tc16[3]; - stbi__uint32 ioff = 0, idata_limit = 0, i, pal_len = 0; - int first = 1, k, interlace = 0, color = 0, is_iphone = 0; - stbi__context* s = z->s; - - z->expanded = NULL; - z->idata = NULL; - z->out = NULL; - - if (!stbi__check_png_header(s)) return 0; - - if (scan == STBI__SCAN_type) return 1; - - for (;;) { - stbi__pngchunk c = stbi__get_chunk_header(s); - switch (c.type) { - case STBI__PNG_TYPE('C', 'g', 'B', 'I'): - is_iphone = 1; - stbi__skip(s, c.length); - break; - case STBI__PNG_TYPE('I', 'H', 'D', 'R'): { - int comp, filter; - if (!first) return stbi__err("multiple IHDR", "Corrupt PNG"); - first = 0; - if (c.length != 13) return stbi__err("bad IHDR len", "Corrupt PNG"); - s->img_x = stbi__get32be(s); - s->img_y = stbi__get32be(s); - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only", "PNG not supported: 1/2/4/8/16-bit only"); - color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype", "Corrupt PNG"); - if (color == 3 && z->depth == 16) return stbi__err("bad ctype", "Corrupt PNG"); - if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype", "Corrupt PNG"); - comp = stbi__get8(s); if (comp) return stbi__err("bad comp method", "Corrupt PNG"); - filter = stbi__get8(s); if (filter) return stbi__err("bad filter method", "Corrupt PNG"); - interlace = stbi__get8(s); if (interlace > 1) return stbi__err("bad interlace method", "Corrupt PNG"); - if (!s->img_x || !s->img_y) return stbi__err("0-pixel image", "Corrupt PNG"); - if (!pal_img_n) { - s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); - if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); - if (scan == STBI__SCAN_header) return 1; - } - else { - // if paletted, then pal_n is our final components, and - // img_n is # components to decompress/filter. - s->img_n = 1; - if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large", "Corrupt PNG"); - // if SCAN_header, have to scan to see if we have a tRNS - } - break; - } - - case STBI__PNG_TYPE('P', 'L', 'T', 'E'): { - if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (c.length > 256 * 3) return stbi__err("invalid PLTE", "Corrupt PNG"); - pal_len = c.length / 3; - if (pal_len * 3 != c.length) return stbi__err("invalid PLTE", "Corrupt PNG"); - for (i = 0; i < pal_len; ++i) { - palette[i * 4 + 0] = stbi__get8(s); - palette[i * 4 + 1] = stbi__get8(s); - palette[i * 4 + 2] = stbi__get8(s); - palette[i * 4 + 3] = 255; - } - break; - } - - case STBI__PNG_TYPE('t', 'R', 'N', 'S'): { - if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (z->idata) return stbi__err("tRNS after IDAT", "Corrupt PNG"); - if (pal_img_n) { - if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } - if (pal_len == 0) return stbi__err("tRNS before PLTE", "Corrupt PNG"); - if (c.length > pal_len) return stbi__err("bad tRNS len", "Corrupt PNG"); - pal_img_n = 4; - for (i = 0; i < c.length; ++i) - palette[i * 4 + 3] = stbi__get8(s); - } - else { - if (!(s->img_n & 1)) return stbi__err("tRNS with alpha", "Corrupt PNG"); - if (c.length != (stbi__uint32)s->img_n * 2) return stbi__err("bad tRNS len", "Corrupt PNG"); - has_trans = 1; - if (z->depth == 16) { - for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is - } - else { - for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger - } - } - break; - } - - case STBI__PNG_TYPE('I', 'D', 'A', 'T'): { - if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (pal_img_n && !pal_len) return stbi__err("no PLTE", "Corrupt PNG"); - if (scan == STBI__SCAN_header) { s->img_n = pal_img_n; return 1; } - if ((int)(ioff + c.length) < (int)ioff) return 0; - if (ioff + c.length > idata_limit) { - stbi__uint32 idata_limit_old = idata_limit; - stbi_uc* p; - if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096; - while (ioff + c.length > idata_limit) - idata_limit *= 2; - STBI_NOTUSED(idata_limit_old); - p = (stbi_uc*)STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory"); - z->idata = p; - } - if (!stbi__getn(s, z->idata + ioff, c.length)) return stbi__err("outofdata", "Corrupt PNG"); - ioff += c.length; - break; - } - - case STBI__PNG_TYPE('I', 'E', 'N', 'D'): { - stbi__uint32 raw_len, bpl; - if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if (scan != STBI__SCAN_load) return 1; - if (z->idata == NULL) return stbi__err("no IDAT", "Corrupt PNG"); - // initial guess for decoded data size to avoid unnecessary reallocs - bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component - raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */; - z->expanded = (stbi_uc*)stbi_zlib_decode_malloc_guesssize_headerflag((char*)z->idata, ioff, raw_len, (int*)&raw_len, !is_iphone); - if (z->expanded == NULL) return 0; // zlib should set error - STBI_FREE(z->idata); z->idata = NULL; - if ((req_comp == s->img_n + 1 && req_comp != 3 && !pal_img_n) || has_trans) - s->img_out_n = s->img_n + 1; - else - s->img_out_n = s->img_n; - if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0; - if (has_trans) { - if (z->depth == 16) { - if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0; - } - else { - if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0; - } - } - if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2) - stbi__de_iphone(z); - if (pal_img_n) { - // pal_img_n == 3 or 4 - s->img_n = pal_img_n; // record the actual colors we had - s->img_out_n = pal_img_n; - if (req_comp >= 3) s->img_out_n = req_comp; - if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n)) - return 0; - } - else if (has_trans) { - // non-paletted image with tRNS -> source image has (constant) alpha - ++s->img_n; - } - STBI_FREE(z->expanded); z->expanded = NULL; - // end of PNG chunk, read and skip CRC - stbi__get32be(s); - return 1; - } - - default: - // if critical, fail - if (first) return stbi__err("first not IHDR", "Corrupt PNG"); - if ((c.type & (1 << 29)) == 0) { -#ifndef STBI_NO_FAILURE_STRINGS - // not threadsafe - static char invalid_chunk[] = "XXXX PNG chunk not known"; - invalid_chunk[0] = STBI__BYTECAST(c.type >> 24); - invalid_chunk[1] = STBI__BYTECAST(c.type >> 16); - invalid_chunk[2] = STBI__BYTECAST(c.type >> 8); - invalid_chunk[3] = STBI__BYTECAST(c.type >> 0); -#endif - return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type"); - } - stbi__skip(s, c.length); - break; - } - // end of PNG chunk, read and skip CRC - stbi__get32be(s); - } -} - -static void* stbi__do_png(stbi__png* p, int* x, int* y, int* n, int req_comp, stbi__result_info* ri) -{ - void* result = NULL; - if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); - if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) { - if (p->depth <= 8) - ri->bits_per_channel = 8; - else if (p->depth == 16) - ri->bits_per_channel = 16; - else - return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color depth"); - result = p->out; - p->out = NULL; - if (req_comp && req_comp != p->s->img_out_n) { - if (ri->bits_per_channel == 8) - result = stbi__convert_format((unsigned char*)result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); - else - result = stbi__convert_format16((stbi__uint16*)result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); - p->s->img_out_n = req_comp; - if (result == NULL) return result; - } - *x = p->s->img_x; - *y = p->s->img_y; - if (n) *n = p->s->img_n; - } - STBI_FREE(p->out); p->out = NULL; - STBI_FREE(p->expanded); p->expanded = NULL; - STBI_FREE(p->idata); p->idata = NULL; - - return result; -} - -static void* stbi__png_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - stbi__png p; - p.s = s; - return stbi__do_png(&p, x, y, comp, req_comp, ri); -} - -static int stbi__png_test(stbi__context* s) -{ - int r; - r = stbi__check_png_header(s); - stbi__rewind(s); - return r; -} - -static int stbi__png_info_raw(stbi__png* p, int* x, int* y, int* comp) -{ - if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) { - stbi__rewind(p->s); - return 0; - } - if (x) *x = p->s->img_x; - if (y) *y = p->s->img_y; - if (comp) *comp = p->s->img_n; - return 1; -} - -static int stbi__png_info(stbi__context* s, int* x, int* y, int* comp) -{ - stbi__png p; - p.s = s; - return stbi__png_info_raw(&p, x, y, comp); -} - -static int stbi__png_is16(stbi__context* s) -{ - stbi__png p; - p.s = s; - if (!stbi__png_info_raw(&p, NULL, NULL, NULL)) - return 0; - if (p.depth != 16) { - stbi__rewind(p.s); - return 0; - } - return 1; -} -#endif - -// Microsoft/Windows BMP image - -#ifndef STBI_NO_BMP -static int stbi__bmp_test_raw(stbi__context* s) -{ - int r; - int sz; - if (stbi__get8(s) != 'B') return 0; - if (stbi__get8(s) != 'M') return 0; - stbi__get32le(s); // discard filesize - stbi__get16le(s); // discard reserved - stbi__get16le(s); // discard reserved - stbi__get32le(s); // discard data offset - sz = stbi__get32le(s); - r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124); - return r; -} - -static int stbi__bmp_test(stbi__context* s) -{ - int r = stbi__bmp_test_raw(s); - stbi__rewind(s); - return r; -} - - -// returns 0..31 for the highest set bit -static int stbi__high_bit(unsigned int z) -{ - int n = 0; - if (z == 0) return -1; - if (z >= 0x10000) { n += 16; z >>= 16; } - if (z >= 0x00100) { n += 8; z >>= 8; } - if (z >= 0x00010) { n += 4; z >>= 4; } - if (z >= 0x00004) { n += 2; z >>= 2; } - if (z >= 0x00002) { n += 1;/* >>= 1;*/ } - return n; -} - -static int stbi__bitcount(unsigned int a) -{ - a = (a & 0x55555555) + ((a >> 1) & 0x55555555); // max 2 - a = (a & 0x33333333) + ((a >> 2) & 0x33333333); // max 4 - a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits - a = (a + (a >> 8)); // max 16 per 8 bits - a = (a + (a >> 16)); // max 32 per 8 bits - return a & 0xff; -} - -// extract an arbitrarily-aligned N-bit value (N=bits) -// from v, and then make it 8-bits long and fractionally -// extend it to full full range. -static int stbi__shiftsigned(unsigned int v, int shift, int bits) -{ - static unsigned int mul_table[9] = { - 0, - 0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/, - 0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/, - }; - static unsigned int shift_table[9] = { - 0, 0,0,1,0,2,4,6,0, - }; - if (shift < 0) - v <<= -shift; - else - v >>= shift; - STBI_ASSERT(v < 256); - v >>= (8 - bits); - STBI_ASSERT(bits >= 0 && bits <= 8); - return (int)((unsigned)v * mul_table[bits]) >> shift_table[bits]; -} - -typedef struct -{ - int bpp, offset, hsz; - unsigned int mr, mg, mb, ma, all_a; - int extra_read; -} stbi__bmp_data; - -static int stbi__bmp_set_mask_defaults(stbi__bmp_data* info, int compress) -{ - // BI_BITFIELDS specifies masks explicitly, don't override - if (compress == 3) - return 1; - - if (compress == 0) { - if (info->bpp == 16) { - info->mr = 31u << 10; - info->mg = 31u << 5; - info->mb = 31u << 0; - } - else if (info->bpp == 32) { - info->mr = 0xffu << 16; - info->mg = 0xffu << 8; - info->mb = 0xffu << 0; - info->ma = 0xffu << 24; - info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 - } - else { - // otherwise, use defaults, which is all-0 - info->mr = info->mg = info->mb = info->ma = 0; - } - return 1; - } - return 0; // error -} - -static void* stbi__bmp_parse_header(stbi__context* s, stbi__bmp_data* info) -{ - int hsz; - if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP"); - stbi__get32le(s); // discard filesize - stbi__get16le(s); // discard reserved - stbi__get16le(s); // discard reserved - info->offset = stbi__get32le(s); - info->hsz = hsz = stbi__get32le(s); - info->mr = info->mg = info->mb = info->ma = 0; - info->extra_read = 14; - - if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); - - if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown"); - if (hsz == 12) { - s->img_x = stbi__get16le(s); - s->img_y = stbi__get16le(s); - } - else { - s->img_x = stbi__get32le(s); - s->img_y = stbi__get32le(s); - } - if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP"); - info->bpp = stbi__get16le(s); - if (hsz != 12) { - int compress = stbi__get32le(s); - if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); - if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes - if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel - stbi__get32le(s); // discard sizeof - stbi__get32le(s); // discard hres - stbi__get32le(s); // discard vres - stbi__get32le(s); // discard colorsused - stbi__get32le(s); // discard max important - if (hsz == 40 || hsz == 56) { - if (hsz == 56) { - stbi__get32le(s); - stbi__get32le(s); - stbi__get32le(s); - stbi__get32le(s); - } - if (info->bpp == 16 || info->bpp == 32) { - if (compress == 0) { - stbi__bmp_set_mask_defaults(info, compress); - } - else if (compress == 3) { - info->mr = stbi__get32le(s); - info->mg = stbi__get32le(s); - info->mb = stbi__get32le(s); - info->extra_read += 12; - // not documented, but generated by photoshop and handled by mspaint - if (info->mr == info->mg && info->mg == info->mb) { - // ?!?!? - return stbi__errpuc("bad BMP", "bad BMP"); - } - } - else - return stbi__errpuc("bad BMP", "bad BMP"); - } - } - else { - // V4/V5 header - int i; - if (hsz != 108 && hsz != 124) - return stbi__errpuc("bad BMP", "bad BMP"); - info->mr = stbi__get32le(s); - info->mg = stbi__get32le(s); - info->mb = stbi__get32le(s); - info->ma = stbi__get32le(s); - if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs - stbi__bmp_set_mask_defaults(info, compress); - stbi__get32le(s); // discard color space - for (i = 0; i < 12; ++i) - stbi__get32le(s); // discard color space parameters - if (hsz == 124) { - stbi__get32le(s); // discard rendering intent - stbi__get32le(s); // discard offset of profile data - stbi__get32le(s); // discard size of profile data - stbi__get32le(s); // discard reserved - } - } - } - return (void*)1; -} - - -static void* stbi__bmp_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - stbi_uc* out; - unsigned int mr = 0, mg = 0, mb = 0, ma = 0, all_a; - stbi_uc pal[256][4]; - int psize = 0, i, j, width; - int flip_vertically, pad, target; - stbi__bmp_data info; - STBI_NOTUSED(ri); - - info.all_a = 255; - if (stbi__bmp_parse_header(s, &info) == NULL) - return NULL; // error code already set - - flip_vertically = ((int)s->img_y) > 0; - s->img_y = abs((int)s->img_y); - - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - - mr = info.mr; - mg = info.mg; - mb = info.mb; - ma = info.ma; - all_a = info.all_a; - - if (info.hsz == 12) { - if (info.bpp < 24) - psize = (info.offset - info.extra_read - 24) / 3; - } - else { - if (info.bpp < 16) - psize = (info.offset - info.extra_read - info.hsz) >> 2; - } - if (psize == 0) { - if (info.offset != s->callback_already_read + (s->img_buffer - s->img_buffer_original)) { - return stbi__errpuc("bad offset", "Corrupt BMP"); - } - } - - if (info.bpp == 24 && ma == 0xff000000) - s->img_n = 3; - else - s->img_n = ma ? 4 : 3; - if (req_comp && req_comp >= 3) // we can directly decode 3 or 4 - target = req_comp; - else - target = s->img_n; // if they want monochrome, we'll post-convert - - // sanity-check size - if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0)) - return stbi__errpuc("too large", "Corrupt BMP"); - - out = (stbi_uc*)stbi__malloc_mad3(target, s->img_x, s->img_y, 0); - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - if (info.bpp < 16) { - int z = 0; - if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); } - for (i = 0; i < psize; ++i) { - pal[i][2] = stbi__get8(s); - pal[i][1] = stbi__get8(s); - pal[i][0] = stbi__get8(s); - if (info.hsz != 12) stbi__get8(s); - pal[i][3] = 255; - } - stbi__skip(s, info.offset - info.extra_read - info.hsz - psize * (info.hsz == 12 ? 3 : 4)); - if (info.bpp == 1) width = (s->img_x + 7) >> 3; - else if (info.bpp == 4) width = (s->img_x + 1) >> 1; - else if (info.bpp == 8) width = s->img_x; - else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); } - pad = (-width) & 3; - if (info.bpp == 1) { - for (j = 0; j < (int)s->img_y; ++j) { - int bit_offset = 7, v = stbi__get8(s); - for (i = 0; i < (int)s->img_x; ++i) { - int color = (v >> bit_offset) & 0x1; - out[z++] = pal[color][0]; - out[z++] = pal[color][1]; - out[z++] = pal[color][2]; - if (target == 4) out[z++] = 255; - if (i + 1 == (int)s->img_x) break; - if ((--bit_offset) < 0) { - bit_offset = 7; - v = stbi__get8(s); - } - } - stbi__skip(s, pad); - } - } - else { - for (j = 0; j < (int)s->img_y; ++j) { - for (i = 0; i < (int)s->img_x; i += 2) { - int v = stbi__get8(s), v2 = 0; - if (info.bpp == 4) { - v2 = v & 15; - v >>= 4; - } - out[z++] = pal[v][0]; - out[z++] = pal[v][1]; - out[z++] = pal[v][2]; - if (target == 4) out[z++] = 255; - if (i + 1 == (int)s->img_x) break; - v = (info.bpp == 8) ? stbi__get8(s) : v2; - out[z++] = pal[v][0]; - out[z++] = pal[v][1]; - out[z++] = pal[v][2]; - if (target == 4) out[z++] = 255; - } - stbi__skip(s, pad); - } - } - } - else { - int rshift = 0, gshift = 0, bshift = 0, ashift = 0, rcount = 0, gcount = 0, bcount = 0, acount = 0; - int z = 0; - int easy = 0; - stbi__skip(s, info.offset - info.extra_read - info.hsz); - if (info.bpp == 24) width = 3 * s->img_x; - else if (info.bpp == 16) width = 2 * s->img_x; - else /* bpp = 32 and pad = 0 */ width = 0; - pad = (-width) & 3; - if (info.bpp == 24) { - easy = 1; - } - else if (info.bpp == 32) { - if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000) - easy = 2; - } - if (!easy) { - if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } - // right shift amt to put high bit in position #7 - rshift = stbi__high_bit(mr) - 7; rcount = stbi__bitcount(mr); - gshift = stbi__high_bit(mg) - 7; gcount = stbi__bitcount(mg); - bshift = stbi__high_bit(mb) - 7; bcount = stbi__bitcount(mb); - ashift = stbi__high_bit(ma) - 7; acount = stbi__bitcount(ma); - if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } - } - for (j = 0; j < (int)s->img_y; ++j) { - if (easy) { - for (i = 0; i < (int)s->img_x; ++i) { - unsigned char a; - out[z + 2] = stbi__get8(s); - out[z + 1] = stbi__get8(s); - out[z + 0] = stbi__get8(s); - z += 3; - a = (easy == 2 ? stbi__get8(s) : 255); - all_a |= a; - if (target == 4) out[z++] = a; - } - } - else { - int bpp = info.bpp; - for (i = 0; i < (int)s->img_x; ++i) { - stbi__uint32 v = (bpp == 16 ? (stbi__uint32)stbi__get16le(s) : stbi__get32le(s)); - unsigned int a; - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount)); - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount)); - out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount)); - a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255); - all_a |= a; - if (target == 4) out[z++] = STBI__BYTECAST(a); - } - } - stbi__skip(s, pad); - } - } - - // if alpha channel is all 0s, replace with all 255s - if (target == 4 && all_a == 0) - for (i = 4 * s->img_x * s->img_y - 1; i >= 0; i -= 4) - out[i] = 255; - - if (flip_vertically) { - stbi_uc t; - for (j = 0; j < (int)s->img_y >> 1; ++j) { - stbi_uc* p1 = out + j * s->img_x * target; - stbi_uc* p2 = out + (s->img_y - 1 - j) * s->img_x * target; - for (i = 0; i < (int)s->img_x * target; ++i) { - t = p1[i]; p1[i] = p2[i]; p2[i] = t; - } - } - } - - if (req_comp && req_comp != target) { - out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } - - *x = s->img_x; - *y = s->img_y; - if (comp) *comp = s->img_n; - return out; -} -#endif - -// Targa Truevision - TGA -// by Jonathan Dummer -#ifndef STBI_NO_TGA -// returns STBI_rgb or whatever, 0 on error -static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16) -{ - // only RGB or RGBA (incl. 16bit) or grey allowed - if (is_rgb16) *is_rgb16 = 0; - switch (bits_per_pixel) { - case 8: return STBI_grey; - case 16: if (is_grey) return STBI_grey_alpha; - // fallthrough - case 15: if (is_rgb16) *is_rgb16 = 1; - return STBI_rgb; - case 24: // fallthrough - case 32: return bits_per_pixel / 8; - default: return 0; - } -} - -static int stbi__tga_info(stbi__context* s, int* x, int* y, int* comp) -{ - int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp; - int sz, tga_colormap_type; - stbi__get8(s); // discard Offset - tga_colormap_type = stbi__get8(s); // colormap type - if (tga_colormap_type > 1) { - stbi__rewind(s); - return 0; // only RGB or indexed allowed - } - tga_image_type = stbi__get8(s); // image type - if (tga_colormap_type == 1) { // colormapped (paletted) image - if (tga_image_type != 1 && tga_image_type != 9) { - stbi__rewind(s); - return 0; - } - stbi__skip(s, 4); // skip index of first colormap entry and number of entries - sz = stbi__get8(s); // check bits per palette color entry - if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) { - stbi__rewind(s); - return 0; - } - stbi__skip(s, 4); // skip image x and y origin - tga_colormap_bpp = sz; - } - else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE - if ((tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11)) { - stbi__rewind(s); - return 0; // only RGB or grey allowed, +/- RLE - } - stbi__skip(s, 9); // skip colormap specification and image x/y origin - tga_colormap_bpp = 0; - } - tga_w = stbi__get16le(s); - if (tga_w < 1) { - stbi__rewind(s); - return 0; // test width - } - tga_h = stbi__get16le(s); - if (tga_h < 1) { - stbi__rewind(s); - return 0; // test height - } - tga_bits_per_pixel = stbi__get8(s); // bits per pixel - stbi__get8(s); // ignore alpha bits - if (tga_colormap_bpp != 0) { - if ((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) { - // when using a colormap, tga_bits_per_pixel is the size of the indexes - // I don't think anything but 8 or 16bit indexes makes sense - stbi__rewind(s); - return 0; - } - tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL); - } - else { - tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL); - } - if (!tga_comp) { - stbi__rewind(s); - return 0; - } - if (x) *x = tga_w; - if (y) *y = tga_h; - if (comp) *comp = tga_comp; - return 1; // seems to have passed everything -} - -static int stbi__tga_test(stbi__context* s) -{ - int res = 0; - int sz, tga_color_type; - stbi__get8(s); // discard Offset - tga_color_type = stbi__get8(s); // color type - if (tga_color_type > 1) goto errorEnd; // only RGB or indexed allowed - sz = stbi__get8(s); // image type - if (tga_color_type == 1) { // colormapped (paletted) image - if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9 - stbi__skip(s, 4); // skip index of first colormap entry and number of entries - sz = stbi__get8(s); // check bits per palette color entry - if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) goto errorEnd; - stbi__skip(s, 4); // skip image x and y origin - } - else { // "normal" image w/o colormap - if ((sz != 2) && (sz != 3) && (sz != 10) && (sz != 11)) goto errorEnd; // only RGB or grey allowed, +/- RLE - stbi__skip(s, 9); // skip colormap specification and image x/y origin - } - if (stbi__get16le(s) < 1) goto errorEnd; // test width - if (stbi__get16le(s) < 1) goto errorEnd; // test height - sz = stbi__get8(s); // bits per pixel - if ((tga_color_type == 1) && (sz != 8) && (sz != 16)) goto errorEnd; // for colormapped images, bpp is size of an index - if ((sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32)) goto errorEnd; - - res = 1; // if we got this far, everything's good and we can return 1 instead of 0 - -errorEnd: - stbi__rewind(s); - return res; -} - -// read 16bit value and convert to 24bit RGB -static void stbi__tga_read_rgb16(stbi__context* s, stbi_uc* out) -{ - stbi__uint16 px = (stbi__uint16)stbi__get16le(s); - stbi__uint16 fiveBitMask = 31; - // we have 3 channels with 5bits each - int r = (px >> 10) & fiveBitMask; - int g = (px >> 5) & fiveBitMask; - int b = px & fiveBitMask; - // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later - out[0] = (stbi_uc)((r * 255) / 31); - out[1] = (stbi_uc)((g * 255) / 31); - out[2] = (stbi_uc)((b * 255) / 31); - - // some people claim that the most significant bit might be used for alpha - // (possibly if an alpha-bit is set in the "image descriptor byte") - // but that only made 16bit test images completely translucent.. - // so let's treat all 15 and 16bit TGAs as RGB with no alpha. -} - -static void* stbi__tga_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - // read in the TGA header stuff - int tga_offset = stbi__get8(s); - int tga_indexed = stbi__get8(s); - int tga_image_type = stbi__get8(s); - int tga_is_RLE = 0; - int tga_palette_start = stbi__get16le(s); - int tga_palette_len = stbi__get16le(s); - int tga_palette_bits = stbi__get8(s); - int tga_x_origin = stbi__get16le(s); - int tga_y_origin = stbi__get16le(s); - int tga_width = stbi__get16le(s); - int tga_height = stbi__get16le(s); - int tga_bits_per_pixel = stbi__get8(s); - int tga_comp, tga_rgb16 = 0; - int tga_inverted = stbi__get8(s); - // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?) - // image data - unsigned char* tga_data; - unsigned char* tga_palette = NULL; - int i, j; - unsigned char raw_data[4] = { 0 }; - int RLE_count = 0; - int RLE_repeating = 0; - int read_next_pixel = 1; - STBI_NOTUSED(ri); - STBI_NOTUSED(tga_x_origin); // @TODO - STBI_NOTUSED(tga_y_origin); // @TODO - - if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - - // do a tiny bit of precessing - if (tga_image_type >= 8) - { - tga_image_type -= 8; - tga_is_RLE = 1; - } - tga_inverted = 1 - ((tga_inverted >> 5) & 1); - - // If I'm paletted, then I'll use the number of bits from the palette - if (tga_indexed) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16); - else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16); - - if (!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency - return stbi__errpuc("bad format", "Can't find out TGA pixelformat"); - - // tga info - *x = tga_width; - *y = tga_height; - if (comp) *comp = tga_comp; - - if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0)) - return stbi__errpuc("too large", "Corrupt TGA"); - - tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0); - if (!tga_data) return stbi__errpuc("outofmem", "Out of memory"); - - // skip to the data's starting position (offset usually = 0) - stbi__skip(s, tga_offset); - - if (!tga_indexed && !tga_is_RLE && !tga_rgb16) { - for (i = 0; i < tga_height; ++i) { - int row = tga_inverted ? tga_height - i - 1 : i; - stbi_uc* tga_row = tga_data + row * tga_width * tga_comp; - stbi__getn(s, tga_row, tga_width * tga_comp); - } - } - else { - // do I need to load a palette? - if (tga_indexed) - { - if (tga_palette_len == 0) { /* you have to have at least one entry! */ - STBI_FREE(tga_data); - return stbi__errpuc("bad palette", "Corrupt TGA"); - } - - // any data to skip? (offset usually = 0) - stbi__skip(s, tga_palette_start); - // load the palette - tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0); - if (!tga_palette) { - STBI_FREE(tga_data); - return stbi__errpuc("outofmem", "Out of memory"); - } - if (tga_rgb16) { - stbi_uc* pal_entry = tga_palette; - STBI_ASSERT(tga_comp == STBI_rgb); - for (i = 0; i < tga_palette_len; ++i) { - stbi__tga_read_rgb16(s, pal_entry); - pal_entry += tga_comp; - } - } - else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) { - STBI_FREE(tga_data); - STBI_FREE(tga_palette); - return stbi__errpuc("bad palette", "Corrupt TGA"); - } - } - // load the data - for (i = 0; i < tga_width * tga_height; ++i) - { - // if I'm in RLE mode, do I need to get a RLE stbi__pngchunk? - if (tga_is_RLE) - { - if (RLE_count == 0) - { - // yep, get the next byte as a RLE command - int RLE_cmd = stbi__get8(s); - RLE_count = 1 + (RLE_cmd & 127); - RLE_repeating = RLE_cmd >> 7; - read_next_pixel = 1; - } - else if (!RLE_repeating) - { - read_next_pixel = 1; - } - } - else - { - read_next_pixel = 1; - } - // OK, if I need to read a pixel, do it now - if (read_next_pixel) - { - // load however much data we did have - if (tga_indexed) - { - // read in index, then perform the lookup - int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s); - if (pal_idx >= tga_palette_len) { - // invalid index - pal_idx = 0; - } - pal_idx *= tga_comp; - for (j = 0; j < tga_comp; ++j) { - raw_data[j] = tga_palette[pal_idx + j]; - } - } - else if (tga_rgb16) { - STBI_ASSERT(tga_comp == STBI_rgb); - stbi__tga_read_rgb16(s, raw_data); - } - else { - // read in the data raw - for (j = 0; j < tga_comp; ++j) { - raw_data[j] = stbi__get8(s); - } - } - // clear the reading flag for the next pixel - read_next_pixel = 0; - } // end of reading a pixel - - // copy data - for (j = 0; j < tga_comp; ++j) - tga_data[i * tga_comp + j] = raw_data[j]; - - // in case we're in RLE mode, keep counting down - --RLE_count; - } - // do I need to invert the image? - if (tga_inverted) - { - for (j = 0; j * 2 < tga_height; ++j) - { - int index1 = j * tga_width * tga_comp; - int index2 = (tga_height - 1 - j) * tga_width * tga_comp; - for (i = tga_width * tga_comp; i > 0; --i) - { - unsigned char temp = tga_data[index1]; - tga_data[index1] = tga_data[index2]; - tga_data[index2] = temp; - ++index1; - ++index2; - } - } - } - // clear my palette, if I had one - if (tga_palette != NULL) - { - STBI_FREE(tga_palette); - } - } - - // swap RGB - if the source data was RGB16, it already is in the right order - if (tga_comp >= 3 && !tga_rgb16) - { - unsigned char* tga_pixel = tga_data; - for (i = 0; i < tga_width * tga_height; ++i) - { - unsigned char temp = tga_pixel[0]; - tga_pixel[0] = tga_pixel[2]; - tga_pixel[2] = temp; - tga_pixel += tga_comp; - } - } - - // convert to target component count - if (req_comp && req_comp != tga_comp) - tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height); - - // the things I do to get rid of an error message, and yet keep - // Microsoft's C compilers happy... [8^( - tga_palette_start = tga_palette_len = tga_palette_bits = - tga_x_origin = tga_y_origin = 0; - STBI_NOTUSED(tga_palette_start); - // OK, done - return tga_data; -} -#endif - -// ************************************************************************************************* -// Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB - -#ifndef STBI_NO_PSD -static int stbi__psd_test(stbi__context* s) -{ - int r = (stbi__get32be(s) == 0x38425053); - stbi__rewind(s); - return r; -} - -static int stbi__psd_decode_rle(stbi__context* s, stbi_uc* p, int pixelCount) -{ - int count, nleft, len; - - count = 0; - while ((nleft = pixelCount - count) > 0) { - len = stbi__get8(s); - if (len == 128) { - // No-op. - } - else if (len < 128) { - // Copy next len+1 bytes literally. - len++; - if (len > nleft) return 0; // corrupt data - count += len; - while (len) { - *p = stbi__get8(s); - p += 4; - len--; - } - } - else if (len > 128) { - stbi_uc val; - // Next -len+1 bytes in the dest are replicated from next source byte. - // (Interpret len as a negative 8-bit int.) - len = 257 - len; - if (len > nleft) return 0; // corrupt data - val = stbi__get8(s); - count += len; - while (len) { - *p = val; - p += 4; - len--; - } - } - } - - return 1; -} - -static void* stbi__psd_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri, int bpc) -{ - int pixelCount; - int channelCount, compression; - int channel, i; - int bitdepth; - int w, h; - stbi_uc* out; - STBI_NOTUSED(ri); - - // Check identifier - if (stbi__get32be(s) != 0x38425053) // "8BPS" - return stbi__errpuc("not PSD", "Corrupt PSD image"); - - // Check file type version. - if (stbi__get16be(s) != 1) - return stbi__errpuc("wrong version", "Unsupported version of PSD image"); - - // Skip 6 reserved bytes. - stbi__skip(s, 6); - - // Read the number of channels (R, G, B, A, etc). - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) - return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image"); - - // Read the rows and columns of the image. - h = stbi__get32be(s); - w = stbi__get32be(s); - - if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - - // Make sure the depth is 8 bits. - bitdepth = stbi__get16be(s); - if (bitdepth != 8 && bitdepth != 16) - return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit"); - - // Make sure the color mode is RGB. - // Valid options are: - // 0: Bitmap - // 1: Grayscale - // 2: Indexed color - // 3: RGB color - // 4: CMYK color - // 7: Multichannel - // 8: Duotone - // 9: Lab color - if (stbi__get16be(s) != 3) - return stbi__errpuc("wrong color format", "PSD is not in RGB color format"); - - // Skip the Mode Data. (It's the palette for indexed color; other info for other modes.) - stbi__skip(s, stbi__get32be(s)); - - // Skip the image resources. (resolution, pen tool paths, etc) - stbi__skip(s, stbi__get32be(s)); - - // Skip the reserved data. - stbi__skip(s, stbi__get32be(s)); - - // Find out if the data is compressed. - // Known values: - // 0: no compression - // 1: RLE compressed - compression = stbi__get16be(s); - if (compression > 1) - return stbi__errpuc("bad compression", "PSD has an unknown compression format"); - - // Check size - if (!stbi__mad3sizes_valid(4, w, h, 0)) - return stbi__errpuc("too large", "Corrupt PSD"); - - // Create the destination image. - - if (!compression && bitdepth == 16 && bpc == 16) { - out = (stbi_uc*)stbi__malloc_mad3(8, w, h, 0); - ri->bits_per_channel = 16; - } - else - out = (stbi_uc*)stbi__malloc(4 * w * h); - - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - pixelCount = w * h; - - // Initialize the data to zero. - //memset( out, 0, pixelCount * 4 ); - - // Finally, the image data. - if (compression) { - // RLE as used by .PSD and .TIFF - // Loop until you get the number of unpacked bytes you are expecting: - // Read the next source byte into n. - // If n is between 0 and 127 inclusive, copy the next n+1 bytes literally. - // Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times. - // Else if n is 128, noop. - // Endloop - - // The RLE-compressed data is preceded by a 2-byte data count for each row in the data, - // which we're going to just skip. - stbi__skip(s, h * channelCount * 2); - - // Read the RLE data by channel. - for (channel = 0; channel < 4; channel++) { - stbi_uc* p; - - p = out + channel; - if (channel >= channelCount) { - // Fill this channel with default data. - for (i = 0; i < pixelCount; i++, p += 4) - *p = (channel == 3 ? 255 : 0); - } - else { - // Read the RLE data. - if (!stbi__psd_decode_rle(s, p, pixelCount)) { - STBI_FREE(out); - return stbi__errpuc("corrupt", "bad RLE data"); - } - } - } - - } - else { - // We're at the raw image data. It's each channel in order (Red, Green, Blue, Alpha, ...) - // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image. - - // Read the data by channel. - for (channel = 0; channel < 4; channel++) { - if (channel >= channelCount) { - // Fill this channel with default data. - if (bitdepth == 16 && bpc == 16) { - stbi__uint16* q = ((stbi__uint16*)out) + channel; - stbi__uint16 val = channel == 3 ? 65535 : 0; - for (i = 0; i < pixelCount; i++, q += 4) - *q = val; - } - else { - stbi_uc* p = out + channel; - stbi_uc val = channel == 3 ? 255 : 0; - for (i = 0; i < pixelCount; i++, p += 4) - *p = val; - } - } - else { - if (ri->bits_per_channel == 16) { // output bpc - stbi__uint16* q = ((stbi__uint16*)out) + channel; - for (i = 0; i < pixelCount; i++, q += 4) - *q = (stbi__uint16)stbi__get16be(s); - } - else { - stbi_uc* p = out + channel; - if (bitdepth == 16) { // input bpc - for (i = 0; i < pixelCount; i++, p += 4) - *p = (stbi_uc)(stbi__get16be(s) >> 8); - } - else { - for (i = 0; i < pixelCount; i++, p += 4) - *p = stbi__get8(s); - } - } - } - } - } - - // remove weird white matte from PSD - if (channelCount >= 4) { - if (ri->bits_per_channel == 16) { - for (i = 0; i < w * h; ++i) { - stbi__uint16* pixel = (stbi__uint16*)out + 4 * i; - if (pixel[3] != 0 && pixel[3] != 65535) { - float a = pixel[3] / 65535.0f; - float ra = 1.0f / a; - float inv_a = 65535.0f * (1 - ra); - pixel[0] = (stbi__uint16)(pixel[0] * ra + inv_a); - pixel[1] = (stbi__uint16)(pixel[1] * ra + inv_a); - pixel[2] = (stbi__uint16)(pixel[2] * ra + inv_a); - } - } - } - else { - for (i = 0; i < w * h; ++i) { - unsigned char* pixel = out + 4 * i; - if (pixel[3] != 0 && pixel[3] != 255) { - float a = pixel[3] / 255.0f; - float ra = 1.0f / a; - float inv_a = 255.0f * (1 - ra); - pixel[0] = (unsigned char)(pixel[0] * ra + inv_a); - pixel[1] = (unsigned char)(pixel[1] * ra + inv_a); - pixel[2] = (unsigned char)(pixel[2] * ra + inv_a); - } - } - } - } - - // convert to desired output format - if (req_comp && req_comp != 4) { - if (ri->bits_per_channel == 16) - out = (stbi_uc*)stbi__convert_format16((stbi__uint16*)out, 4, req_comp, w, h); - else - out = stbi__convert_format(out, 4, req_comp, w, h); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } - - if (comp) *comp = 4; - *y = h; - *x = w; - - return out; -} -#endif - -// ************************************************************************************************* -// Softimage PIC loader -// by Tom Seddon -// -// See http://softimage.wiki.softimage.com/index.php/INFO:_PIC_file_format -// See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/ - -#ifndef STBI_NO_PIC -static int stbi__pic_is4(stbi__context* s, const char* str) -{ - int i; - for (i = 0; i < 4; ++i) - if (stbi__get8(s) != (stbi_uc)str[i]) - return 0; - - return 1; -} - -static int stbi__pic_test_core(stbi__context* s) -{ - int i; - - if (!stbi__pic_is4(s, "\x53\x80\xF6\x34")) - return 0; - - for (i = 0; i < 84; ++i) - stbi__get8(s); - - if (!stbi__pic_is4(s, "PICT")) - return 0; - - return 1; -} - -typedef struct -{ - stbi_uc size, type, channel; -} stbi__pic_packet; - -static stbi_uc* stbi__readval(stbi__context* s, int channel, stbi_uc* dest) -{ - int mask = 0x80, i; - - for (i = 0; i < 4; ++i, mask >>= 1) { - if (channel & mask) { - if (stbi__at_eof(s)) return stbi__errpuc("bad file", "PIC file too short"); - dest[i] = stbi__get8(s); - } - } - - return dest; -} - -static void stbi__copyval(int channel, stbi_uc* dest, const stbi_uc* src) -{ - int mask = 0x80, i; - - for (i = 0; i < 4; ++i, mask >>= 1) - if (channel & mask) - dest[i] = src[i]; -} - -static stbi_uc* stbi__pic_load_core(stbi__context* s, int width, int height, int* comp, stbi_uc* result) -{ - int act_comp = 0, num_packets = 0, y, chained; - stbi__pic_packet packets[10]; - - // this will (should...) cater for even some bizarre stuff like having data - // for the same channel in multiple packets. - do { - stbi__pic_packet* packet; - - if (num_packets == sizeof(packets) / sizeof(packets[0])) - return stbi__errpuc("bad format", "too many packets"); - - packet = &packets[num_packets++]; - - chained = stbi__get8(s); - packet->size = stbi__get8(s); - packet->type = stbi__get8(s); - packet->channel = stbi__get8(s); - - act_comp |= packet->channel; - - if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (reading packets)"); - if (packet->size != 8) return stbi__errpuc("bad format", "packet isn't 8bpp"); - } while (chained); - - *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel? - - for (y = 0; y < height; ++y) { - int packet_idx; - - for (packet_idx = 0; packet_idx < num_packets; ++packet_idx) { - stbi__pic_packet* packet = &packets[packet_idx]; - stbi_uc* dest = result + y * width * 4; - - switch (packet->type) { - default: - return stbi__errpuc("bad format", "packet has bad compression type"); - - case 0: {//uncompressed - int x; - - for (x = 0; x < width; ++x, dest += 4) - if (!stbi__readval(s, packet->channel, dest)) - return 0; - break; - } - - case 1://Pure RLE - { - int left = width, i; - - while (left > 0) { - stbi_uc count, value[4]; - - count = stbi__get8(s); - if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (pure read count)"); - - if (count > left) - count = (stbi_uc)left; - - if (!stbi__readval(s, packet->channel, value)) return 0; - - for (i = 0; i < count; ++i, dest += 4) - stbi__copyval(packet->channel, dest, value); - left -= count; - } - } - break; - - case 2: {//Mixed RLE - int left = width; - while (left > 0) { - int count = stbi__get8(s), i; - if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (mixed read count)"); - - if (count >= 128) { // Repeated - stbi_uc value[4]; - - if (count == 128) - count = stbi__get16be(s); - else - count -= 127; - if (count > left) - return stbi__errpuc("bad file", "scanline overrun"); - - if (!stbi__readval(s, packet->channel, value)) - return 0; - - for (i = 0; i < count; ++i, dest += 4) - stbi__copyval(packet->channel, dest, value); - } - else { // Raw - ++count; - if (count > left) return stbi__errpuc("bad file", "scanline overrun"); - - for (i = 0; i < count; ++i, dest += 4) - if (!stbi__readval(s, packet->channel, dest)) - return 0; - } - left -= count; - } - break; - } - } - } - } - - return result; -} - -static void* stbi__pic_load(stbi__context* s, int* px, int* py, int* comp, int req_comp, stbi__result_info* ri) -{ - stbi_uc* result; - int i, x, y, internal_comp; - STBI_NOTUSED(ri); - - if (!comp) comp = &internal_comp; - - for (i = 0; i < 92; ++i) - stbi__get8(s); - - x = stbi__get16be(s); - y = stbi__get16be(s); - - if (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - - if (stbi__at_eof(s)) return stbi__errpuc("bad file", "file too short (pic header)"); - if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode"); - - stbi__get32be(s); //skip `ratio' - stbi__get16be(s); //skip `fields' - stbi__get16be(s); //skip `pad' - - // intermediate buffer is RGBA - result = (stbi_uc*)stbi__malloc_mad3(x, y, 4, 0); - if (!result) return stbi__errpuc("outofmem", "Out of memory"); - memset(result, 0xff, x * y * 4); - - if (!stbi__pic_load_core(s, x, y, comp, result)) { - STBI_FREE(result); - result = 0; - } - *px = x; - *py = y; - if (req_comp == 0) req_comp = *comp; - result = stbi__convert_format(result, 4, req_comp, x, y); - - return result; -} - -static int stbi__pic_test(stbi__context* s) -{ - int r = stbi__pic_test_core(s); - stbi__rewind(s); - return r; -} -#endif - -// ************************************************************************************************* -// GIF loader -- public domain by Jean-Marc Lienher -- simplified/shrunk by stb - -#ifndef STBI_NO_GIF -typedef struct -{ - stbi__int16 prefix; - stbi_uc first; - stbi_uc suffix; -} stbi__gif_lzw; - -typedef struct -{ - int w, h; - stbi_uc* out; // output buffer (always 4 components) - stbi_uc* background; // The current "background" as far as a gif is concerned - stbi_uc* history; - int flags, bgindex, ratio, transparent, eflags; - stbi_uc pal[256][4]; - stbi_uc lpal[256][4]; - stbi__gif_lzw codes[8192]; - stbi_uc* color_table; - int parse, step; - int lflags; - int start_x, start_y; - int max_x, max_y; - int cur_x, cur_y; - int line_size; - int delay; -} stbi__gif; - -static int stbi__gif_test_raw(stbi__context* s) -{ - int sz; - if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0; - sz = stbi__get8(s); - if (sz != '9' && sz != '7') return 0; - if (stbi__get8(s) != 'a') return 0; - return 1; -} - -static int stbi__gif_test(stbi__context* s) -{ - int r = stbi__gif_test_raw(s); - stbi__rewind(s); - return r; -} - -static void stbi__gif_parse_colortable(stbi__context* s, stbi_uc pal[256][4], int num_entries, int transp) -{ - int i; - for (i = 0; i < num_entries; ++i) { - pal[i][2] = stbi__get8(s); - pal[i][1] = stbi__get8(s); - pal[i][0] = stbi__get8(s); - pal[i][3] = transp == i ? 0 : 255; - } -} - -static int stbi__gif_header(stbi__context* s, stbi__gif* g, int* comp, int is_info) -{ - stbi_uc version; - if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') - return stbi__err("not GIF", "Corrupt GIF"); - - version = stbi__get8(s); - if (version != '7' && version != '9') return stbi__err("not GIF", "Corrupt GIF"); - if (stbi__get8(s) != 'a') return stbi__err("not GIF", "Corrupt GIF"); - - stbi__g_failure_reason = ""; - g->w = stbi__get16le(s); - g->h = stbi__get16le(s); - g->flags = stbi__get8(s); - g->bgindex = stbi__get8(s); - g->ratio = stbi__get8(s); - g->transparent = -1; - - if (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large", "Very large image (corrupt?)"); - - if (comp != 0) *comp = 4; // can't actually tell whether it's 3 or 4 until we parse the comments - - if (is_info) return 1; - - if (g->flags & 0x80) - stbi__gif_parse_colortable(s, g->pal, 2 << (g->flags & 7), -1); - - return 1; -} - -static int stbi__gif_info_raw(stbi__context* s, int* x, int* y, int* comp) -{ - stbi__gif* g = (stbi__gif*)stbi__malloc(sizeof(stbi__gif)); - if (!g) return stbi__err("outofmem", "Out of memory"); - if (!stbi__gif_header(s, g, comp, 1)) { - STBI_FREE(g); - stbi__rewind(s); - return 0; - } - if (x) *x = g->w; - if (y) *y = g->h; - STBI_FREE(g); - return 1; -} - -static void stbi__out_gif_code(stbi__gif* g, stbi__uint16 code) -{ - stbi_uc* p, * c; - int idx; - - // recurse to decode the prefixes, since the linked-list is backwards, - // and working backwards through an interleaved image would be nasty - if (g->codes[code].prefix >= 0) - stbi__out_gif_code(g, g->codes[code].prefix); - - if (g->cur_y >= g->max_y) return; - - idx = g->cur_x + g->cur_y; - p = &g->out[idx]; - g->history[idx / 4] = 1; - - c = &g->color_table[g->codes[code].suffix * 4]; - if (c[3] > 128) { // don't render transparent pixels; - p[0] = c[2]; - p[1] = c[1]; - p[2] = c[0]; - p[3] = c[3]; - } - g->cur_x += 4; - - if (g->cur_x >= g->max_x) { - g->cur_x = g->start_x; - g->cur_y += g->step; - - while (g->cur_y >= g->max_y && g->parse > 0) { - g->step = (1 << g->parse) * g->line_size; - g->cur_y = g->start_y + (g->step >> 1); - --g->parse; - } - } -} - -static stbi_uc* stbi__process_gif_raster(stbi__context* s, stbi__gif* g) -{ - stbi_uc lzw_cs; - stbi__int32 len, init_code; - stbi__uint32 first; - stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear; - stbi__gif_lzw* p; - - lzw_cs = stbi__get8(s); - if (lzw_cs > 12) return NULL; - clear = 1 << lzw_cs; - first = 1; - codesize = lzw_cs + 1; - codemask = (1 << codesize) - 1; - bits = 0; - valid_bits = 0; - for (init_code = 0; init_code < clear; init_code++) { - g->codes[init_code].prefix = -1; - g->codes[init_code].first = (stbi_uc)init_code; - g->codes[init_code].suffix = (stbi_uc)init_code; - } - - // support no starting clear code - avail = clear + 2; - oldcode = -1; - - len = 0; - for (;;) { - if (valid_bits < codesize) { - if (len == 0) { - len = stbi__get8(s); // start new block - if (len == 0) - return g->out; - } - --len; - bits |= (stbi__int32)stbi__get8(s) << valid_bits; - valid_bits += 8; - } - else { - stbi__int32 code = bits & codemask; - bits >>= codesize; - valid_bits -= codesize; - // @OPTIMIZE: is there some way we can accelerate the non-clear path? - if (code == clear) { // clear code - codesize = lzw_cs + 1; - codemask = (1 << codesize) - 1; - avail = clear + 2; - oldcode = -1; - first = 0; - } - else if (code == clear + 1) { // end of stream code - stbi__skip(s, len); - while ((len = stbi__get8(s)) > 0) - stbi__skip(s, len); - return g->out; - } - else if (code <= avail) { - if (first) { - return stbi__errpuc("no clear code", "Corrupt GIF"); - } - - if (oldcode >= 0) { - p = &g->codes[avail++]; - if (avail > 8192) { - return stbi__errpuc("too many codes", "Corrupt GIF"); - } - - p->prefix = (stbi__int16)oldcode; - p->first = g->codes[oldcode].first; - p->suffix = (code == avail) ? p->first : g->codes[code].first; - } - else if (code == avail) - return stbi__errpuc("illegal code in raster", "Corrupt GIF"); - - stbi__out_gif_code(g, (stbi__uint16)code); - - if ((avail & codemask) == 0 && avail <= 0x0FFF) { - codesize++; - codemask = (1 << codesize) - 1; - } - - oldcode = code; - } - else { - return stbi__errpuc("illegal code in raster", "Corrupt GIF"); - } - } - } -} - -// this function is designed to support animated gifs, although stb_image doesn't support it -// two back is the image from two frames ago, used for a very specific disposal format -static stbi_uc* stbi__gif_load_next(stbi__context* s, stbi__gif* g, int* comp, int req_comp, stbi_uc* two_back) -{ - int dispose; - int first_frame; - int pi; - int pcount; - STBI_NOTUSED(req_comp); - - // on first frame, any non-written pixels get the background colour (non-transparent) - first_frame = 0; - if (g->out == 0) { - if (!stbi__gif_header(s, g, comp, 0)) return 0; // stbi__g_failure_reason set by stbi__gif_header - if (!stbi__mad3sizes_valid(4, g->w, g->h, 0)) - return stbi__errpuc("too large", "GIF image is too large"); - pcount = g->w * g->h; - g->out = (stbi_uc*)stbi__malloc(4 * pcount); - g->background = (stbi_uc*)stbi__malloc(4 * pcount); - g->history = (stbi_uc*)stbi__malloc(pcount); - if (!g->out || !g->background || !g->history) - return stbi__errpuc("outofmem", "Out of memory"); - - // image is treated as "transparent" at the start - ie, nothing overwrites the current background; - // background colour is only used for pixels that are not rendered first frame, after that "background" - // color refers to the color that was there the previous frame. - memset(g->out, 0x00, 4 * pcount); - memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent) - memset(g->history, 0x00, pcount); // pixels that were affected previous frame - first_frame = 1; - } - else { - // second frame - how do we dispose of the previous one? - dispose = (g->eflags & 0x1C) >> 2; - pcount = g->w * g->h; - - if ((dispose == 3) && (two_back == 0)) { - dispose = 2; // if I don't have an image to revert back to, default to the old background - } - - if (dispose == 3) { // use previous graphic - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi]) { - memcpy(&g->out[pi * 4], &two_back[pi * 4], 4); - } - } - } - else if (dispose == 2) { - // restore what was changed last frame to background before that frame; - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi]) { - memcpy(&g->out[pi * 4], &g->background[pi * 4], 4); - } - } - } - else { - // This is a non-disposal case eithe way, so just - // leave the pixels as is, and they will become the new background - // 1: do not dispose - // 0: not specified. - } - - // background is what out is after the undoing of the previou frame; - memcpy(g->background, g->out, 4 * g->w * g->h); - } - - // clear my history; - memset(g->history, 0x00, g->w * g->h); // pixels that were affected previous frame - - for (;;) { - int tag = stbi__get8(s); - switch (tag) { - case 0x2C: /* Image Descriptor */ - { - stbi__int32 x, y, w, h; - stbi_uc* o; - - x = stbi__get16le(s); - y = stbi__get16le(s); - w = stbi__get16le(s); - h = stbi__get16le(s); - if (((x + w) > (g->w)) || ((y + h) > (g->h))) - return stbi__errpuc("bad Image Descriptor", "Corrupt GIF"); - - g->line_size = g->w * 4; - g->start_x = x * 4; - g->start_y = y * g->line_size; - g->max_x = g->start_x + w * 4; - g->max_y = g->start_y + h * g->line_size; - g->cur_x = g->start_x; - g->cur_y = g->start_y; - - // if the width of the specified rectangle is 0, that means - // we may not see *any* pixels or the image is malformed; - // to make sure this is caught, move the current y down to - // max_y (which is what out_gif_code checks). - if (w == 0) - g->cur_y = g->max_y; - - g->lflags = stbi__get8(s); - - if (g->lflags & 0x40) { - g->step = 8 * g->line_size; // first interlaced spacing - g->parse = 3; - } - else { - g->step = g->line_size; - g->parse = 0; - } - - if (g->lflags & 0x80) { - stbi__gif_parse_colortable(s, g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1); - g->color_table = (stbi_uc*)g->lpal; - } - else if (g->flags & 0x80) { - g->color_table = (stbi_uc*)g->pal; - } - else - return stbi__errpuc("missing color table", "Corrupt GIF"); - - o = stbi__process_gif_raster(s, g); - if (!o) return NULL; - - // if this was the first frame, - pcount = g->w * g->h; - if (first_frame && (g->bgindex > 0)) { - // if first frame, any pixel not drawn to gets the background color - for (pi = 0; pi < pcount; ++pi) { - if (g->history[pi] == 0) { - g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; - memcpy(&g->out[pi * 4], &g->pal[g->bgindex], 4); - } - } - } - - return o; - } - - case 0x21: // Comment Extension. - { - int len; - int ext = stbi__get8(s); - if (ext == 0xF9) { // Graphic Control Extension. - len = stbi__get8(s); - if (len == 4) { - g->eflags = stbi__get8(s); - g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths. - - // unset old transparent - if (g->transparent >= 0) { - g->pal[g->transparent][3] = 255; - } - if (g->eflags & 0x01) { - g->transparent = stbi__get8(s); - if (g->transparent >= 0) { - g->pal[g->transparent][3] = 0; - } - } - else { - // don't need transparent - stbi__skip(s, 1); - g->transparent = -1; - } - } - else { - stbi__skip(s, len); - break; - } - } - while ((len = stbi__get8(s)) != 0) { - stbi__skip(s, len); - } - break; - } - - case 0x3B: // gif stream termination code - return (stbi_uc*)s; // using '1' causes warning on some compilers - - default: - return stbi__errpuc("unknown code", "Corrupt GIF"); - } - } -} - -static void* stbi__load_gif_main_outofmem(stbi__gif* g, stbi_uc* out, int** delays) -{ - STBI_FREE(g->out); - STBI_FREE(g->history); - STBI_FREE(g->background); - - if (out) STBI_FREE(out); - if (delays && *delays) STBI_FREE(*delays); - return stbi__errpuc("outofmem", "Out of memory"); -} - -static void* stbi__load_gif_main(stbi__context* s, int** delays, int* x, int* y, int* z, int* comp, int req_comp) -{ - if (stbi__gif_test(s)) { - int layers = 0; - stbi_uc* u = 0; - stbi_uc* out = 0; - stbi_uc* two_back = 0; - stbi__gif g; - int stride; - int out_size = 0; - int delays_size = 0; - - STBI_NOTUSED(out_size); - STBI_NOTUSED(delays_size); - - memset(&g, 0, sizeof(g)); - if (delays) { - *delays = 0; - } - - do { - u = stbi__gif_load_next(s, &g, comp, req_comp, two_back); - if (u == (stbi_uc*)s) u = 0; // end of animated gif marker - - if (u) { - *x = g.w; - *y = g.h; - ++layers; - stride = g.w * g.h * 4; - - if (out) { - void* tmp = (stbi_uc*)STBI_REALLOC_SIZED(out, out_size, layers * stride); - if (!tmp) - return stbi__load_gif_main_outofmem(&g, out, delays); - else { - out = (stbi_uc*)tmp; - out_size = layers * stride; - } - - if (delays) { - int* new_delays = (int*)STBI_REALLOC_SIZED(*delays, delays_size, sizeof(int) * layers); - if (!new_delays) - return stbi__load_gif_main_outofmem(&g, out, delays); - *delays = new_delays; - delays_size = layers * sizeof(int); - } - } - else { - out = (stbi_uc*)stbi__malloc(layers * stride); - if (!out) - return stbi__load_gif_main_outofmem(&g, out, delays); - out_size = layers * stride; - if (delays) { - *delays = (int*)stbi__malloc(layers * sizeof(int)); - if (!*delays) - return stbi__load_gif_main_outofmem(&g, out, delays); - delays_size = layers * sizeof(int); - } - } - memcpy(out + ((layers - 1) * stride), u, stride); - if (layers >= 2) { - two_back = out - 2 * stride; - } - - if (delays) { - (*delays)[layers - 1U] = g.delay; - } - } - } while (u != 0); - - // free temp buffer; - STBI_FREE(g.out); - STBI_FREE(g.history); - STBI_FREE(g.background); - - // do the final conversion after loading everything; - if (req_comp && req_comp != 4) - out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h); - - *z = layers; - return out; - } - else { - return stbi__errpuc("not GIF", "Image was not as a gif type."); - } -} - -static void* stbi__gif_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - stbi_uc* u = 0; - stbi__gif g; - memset(&g, 0, sizeof(g)); - STBI_NOTUSED(ri); - - u = stbi__gif_load_next(s, &g, comp, req_comp, 0); - if (u == (stbi_uc*)s) u = 0; // end of animated gif marker - if (u) { - *x = g.w; - *y = g.h; - - // moved conversion to after successful load so that the same - // can be done for multiple frames. - if (req_comp && req_comp != 4) - u = stbi__convert_format(u, 4, req_comp, g.w, g.h); - } - else if (g.out) { - // if there was an error and we allocated an image buffer, free it! - STBI_FREE(g.out); - } - - // free buffers needed for multiple frame loading; - STBI_FREE(g.history); - STBI_FREE(g.background); - - return u; -} - -static int stbi__gif_info(stbi__context* s, int* x, int* y, int* comp) -{ - return stbi__gif_info_raw(s, x, y, comp); -} -#endif - -// ************************************************************************************************* -// Radiance RGBE HDR loader -// originally by Nicolas Schulz -#ifndef STBI_NO_HDR -static int stbi__hdr_test_core(stbi__context* s, const char* signature) -{ - int i; - for (i = 0; signature[i]; ++i) - if (stbi__get8(s) != signature[i]) - return 0; - stbi__rewind(s); - return 1; -} - -static int stbi__hdr_test(stbi__context* s) -{ - int r = stbi__hdr_test_core(s, "#?RADIANCE\n"); - stbi__rewind(s); - if (!r) { - r = stbi__hdr_test_core(s, "#?RGBE\n"); - stbi__rewind(s); - } - return r; -} - -#define STBI__HDR_BUFLEN 1024 -static char* stbi__hdr_gettoken(stbi__context* z, char* buffer) -{ - int len = 0; - char c = '\0'; - - c = (char)stbi__get8(z); - - while (!stbi__at_eof(z) && c != '\n') { - buffer[len++] = c; - if (len == STBI__HDR_BUFLEN - 1) { - // flush to end of line - while (!stbi__at_eof(z) && stbi__get8(z) != '\n') - ; - break; - } - c = (char)stbi__get8(z); - } - - buffer[len] = 0; - return buffer; -} - -static void stbi__hdr_convert(float* output, stbi_uc* input, int req_comp) -{ - if (input[3] != 0) { - float f1; - // Exponent - f1 = (float)ldexp(1.0f, input[3] - (int)(128 + 8)); - if (req_comp <= 2) - output[0] = (input[0] + input[1] + input[2]) * f1 / 3; - else { - output[0] = input[0] * f1; - output[1] = input[1] * f1; - output[2] = input[2] * f1; - } - if (req_comp == 2) output[1] = 1; - if (req_comp == 4) output[3] = 1; - } - else { - switch (req_comp) { - case 4: output[3] = 1; /* fallthrough */ - case 3: output[0] = output[1] = output[2] = 0; - break; - case 2: output[1] = 1; /* fallthrough */ - case 1: output[0] = 0; - break; - } - } -} - -static float* stbi__hdr_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - char buffer[STBI__HDR_BUFLEN]; - char* token; - int valid = 0; - int width, height; - stbi_uc* scanline; - float* hdr_data; - int len; - unsigned char count, value; - int i, j, k, c1, c2, z; - const char* headerToken; - STBI_NOTUSED(ri); - - // Check identifier - headerToken = stbi__hdr_gettoken(s, buffer); - if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0) - return stbi__errpf("not HDR", "Corrupt HDR image"); - - // Parse header - for (;;) { - token = stbi__hdr_gettoken(s, buffer); - if (token[0] == 0) break; - if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; - } - - if (!valid) return stbi__errpf("unsupported format", "Unsupported HDR format"); - - // Parse width and height - // can't use sscanf() if we're not using stdio! - token = stbi__hdr_gettoken(s, buffer); - if (strncmp(token, "-Y ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); - token += 3; - height = (int)strtol(token, &token, 10); - while (*token == ' ') ++token; - if (strncmp(token, "+X ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); - token += 3; - width = (int)strtol(token, NULL, 10); - - if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large", "Very large image (corrupt?)"); - if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large", "Very large image (corrupt?)"); - - *x = width; - *y = height; - - if (comp) *comp = 3; - if (req_comp == 0) req_comp = 3; - - if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0)) - return stbi__errpf("too large", "HDR image is too large"); - - // Read data - hdr_data = (float*)stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0); - if (!hdr_data) - return stbi__errpf("outofmem", "Out of memory"); - - // Load image data - // image data is stored as some number of sca - if (width < 8 || width >= 32768) { - // Read flat data - for (j = 0; j < height; ++j) { - for (i = 0; i < width; ++i) { - stbi_uc rgbe[4]; - main_decode_loop: - stbi__getn(s, rgbe, 4); - stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp); - } - } - } - else { - // Read RLE-encoded data - scanline = NULL; - - for (j = 0; j < height; ++j) { - c1 = stbi__get8(s); - c2 = stbi__get8(s); - len = stbi__get8(s); - if (c1 != 2 || c2 != 2 || (len & 0x80)) { - // not run-length encoded, so we have to actually use THIS data as a decoded - // pixel (note this can't be a valid pixel--one of RGB must be >= 128) - stbi_uc rgbe[4]; - rgbe[0] = (stbi_uc)c1; - rgbe[1] = (stbi_uc)c2; - rgbe[2] = (stbi_uc)len; - rgbe[3] = (stbi_uc)stbi__get8(s); - stbi__hdr_convert(hdr_data, rgbe, req_comp); - i = 1; - j = 0; - STBI_FREE(scanline); - goto main_decode_loop; // yes, this makes no sense - } - len <<= 8; - len |= stbi__get8(s); - if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); } - if (scanline == NULL) { - scanline = (stbi_uc*)stbi__malloc_mad2(width, 4, 0); - if (!scanline) { - STBI_FREE(hdr_data); - return stbi__errpf("outofmem", "Out of memory"); - } - } - - for (k = 0; k < 4; ++k) { - int nleft; - i = 0; - while ((nleft = width - i) > 0) { - count = stbi__get8(s); - if (count > 128) { - // Run - value = stbi__get8(s); - count -= 128; - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } - for (z = 0; z < count; ++z) - scanline[i++ * 4 + k] = value; - } - else { - // Dump - if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } - for (z = 0; z < count; ++z) - scanline[i++ * 4 + k] = stbi__get8(s); - } - } - } - for (i = 0; i < width; ++i) - stbi__hdr_convert(hdr_data + (j * width + i) * req_comp, scanline + i * 4, req_comp); - } - if (scanline) - STBI_FREE(scanline); - } - - return hdr_data; -} - -static int stbi__hdr_info(stbi__context* s, int* x, int* y, int* comp) -{ - char buffer[STBI__HDR_BUFLEN]; - char* token; - int valid = 0; - int dummy; - - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; - - if (stbi__hdr_test(s) == 0) { - stbi__rewind(s); - return 0; - } - - for (;;) { - token = stbi__hdr_gettoken(s, buffer); - if (token[0] == 0) break; - if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; - } - - if (!valid) { - stbi__rewind(s); - return 0; - } - token = stbi__hdr_gettoken(s, buffer); - if (strncmp(token, "-Y ", 3)) { - stbi__rewind(s); - return 0; - } - token += 3; - *y = (int)strtol(token, &token, 10); - while (*token == ' ') ++token; - if (strncmp(token, "+X ", 3)) { - stbi__rewind(s); - return 0; - } - token += 3; - *x = (int)strtol(token, NULL, 10); - *comp = 3; - return 1; -} -#endif // STBI_NO_HDR - -#ifndef STBI_NO_BMP -static int stbi__bmp_info(stbi__context* s, int* x, int* y, int* comp) -{ - void* p; - stbi__bmp_data info; - - info.all_a = 255; - p = stbi__bmp_parse_header(s, &info); - if (p == NULL) { - stbi__rewind(s); - return 0; - } - if (x) *x = s->img_x; - if (y) *y = s->img_y; - if (comp) { - if (info.bpp == 24 && info.ma == 0xff000000) - *comp = 3; - else - *comp = info.ma ? 4 : 3; - } - return 1; -} -#endif - -#ifndef STBI_NO_PSD -static int stbi__psd_info(stbi__context* s, int* x, int* y, int* comp) -{ - int channelCount, dummy, depth; - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; - if (stbi__get32be(s) != 0x38425053) { - stbi__rewind(s); - return 0; - } - if (stbi__get16be(s) != 1) { - stbi__rewind(s); - return 0; - } - stbi__skip(s, 6); - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) { - stbi__rewind(s); - return 0; - } - *y = stbi__get32be(s); - *x = stbi__get32be(s); - depth = stbi__get16be(s); - if (depth != 8 && depth != 16) { - stbi__rewind(s); - return 0; - } - if (stbi__get16be(s) != 3) { - stbi__rewind(s); - return 0; - } - *comp = 4; - return 1; -} - -static int stbi__psd_is16(stbi__context* s) -{ - int channelCount, depth; - if (stbi__get32be(s) != 0x38425053) { - stbi__rewind(s); - return 0; - } - if (stbi__get16be(s) != 1) { - stbi__rewind(s); - return 0; - } - stbi__skip(s, 6); - channelCount = stbi__get16be(s); - if (channelCount < 0 || channelCount > 16) { - stbi__rewind(s); - return 0; - } - STBI_NOTUSED(stbi__get32be(s)); - STBI_NOTUSED(stbi__get32be(s)); - depth = stbi__get16be(s); - if (depth != 16) { - stbi__rewind(s); - return 0; - } - return 1; -} -#endif - -#ifndef STBI_NO_PIC -static int stbi__pic_info(stbi__context* s, int* x, int* y, int* comp) -{ - int act_comp = 0, num_packets = 0, chained, dummy; - stbi__pic_packet packets[10]; - - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; - - if (!stbi__pic_is4(s, "\x53\x80\xF6\x34")) { - stbi__rewind(s); - return 0; - } - - stbi__skip(s, 88); - - *x = stbi__get16be(s); - *y = stbi__get16be(s); - if (stbi__at_eof(s)) { - stbi__rewind(s); - return 0; - } - if ((*x) != 0 && (1 << 28) / (*x) < (*y)) { - stbi__rewind(s); - return 0; - } - - stbi__skip(s, 8); - - do { - stbi__pic_packet* packet; - - if (num_packets == sizeof(packets) / sizeof(packets[0])) - return 0; - - packet = &packets[num_packets++]; - chained = stbi__get8(s); - packet->size = stbi__get8(s); - packet->type = stbi__get8(s); - packet->channel = stbi__get8(s); - act_comp |= packet->channel; - - if (stbi__at_eof(s)) { - stbi__rewind(s); - return 0; - } - if (packet->size != 8) { - stbi__rewind(s); - return 0; - } - } while (chained); - - *comp = (act_comp & 0x10 ? 4 : 3); - - return 1; -} -#endif - -// ************************************************************************************************* -// Portable Gray Map and Portable Pixel Map loader -// by Ken Miller -// -// PGM: http://netpbm.sourceforge.net/doc/pgm.html -// PPM: http://netpbm.sourceforge.net/doc/ppm.html -// -// Known limitations: -// Does not support comments in the header section -// Does not support ASCII image data (formats P2 and P3) - -#ifndef STBI_NO_PNM - -static int stbi__pnm_test(stbi__context* s) -{ - char p, t; - p = (char)stbi__get8(s); - t = (char)stbi__get8(s); - if (p != 'P' || (t != '5' && t != '6')) { - stbi__rewind(s); - return 0; - } - return 1; -} - -static void* stbi__pnm_load(stbi__context* s, int* x, int* y, int* comp, int req_comp, stbi__result_info* ri) -{ - stbi_uc* out; - STBI_NOTUSED(ri); - - ri->bits_per_channel = stbi__pnm_info(s, (int*)&s->img_x, (int*)&s->img_y, (int*)&s->img_n); - if (ri->bits_per_channel == 0) - return 0; - - if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large", "Very large image (corrupt?)"); - - *x = s->img_x; - *y = s->img_y; - if (comp) *comp = s->img_n; - - if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) - return stbi__errpuc("too large", "PNM too large"); - - out = (stbi_uc*)stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); - if (!out) return stbi__errpuc("outofmem", "Out of memory"); - stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8)); - - if (req_comp && req_comp != s->img_n) { - out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); - if (out == NULL) return out; // stbi__convert_format frees input on failure - } - return out; -} - -static int stbi__pnm_isspace(char c) -{ - return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r'; -} - -static void stbi__pnm_skip_whitespace(stbi__context* s, char* c) -{ - for (;;) { - while (!stbi__at_eof(s) && stbi__pnm_isspace(*c)) - *c = (char)stbi__get8(s); - - if (stbi__at_eof(s) || *c != '#') - break; - - while (!stbi__at_eof(s) && *c != '\n' && *c != '\r') - *c = (char)stbi__get8(s); - } -} - -static int stbi__pnm_isdigit(char c) -{ - return c >= '0' && c <= '9'; -} - -static int stbi__pnm_getinteger(stbi__context* s, char* c) -{ - int value = 0; - - while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { - value = value * 10 + (*c - '0'); - *c = (char)stbi__get8(s); - } - - return value; -} - -static int stbi__pnm_info(stbi__context* s, int* x, int* y, int* comp) -{ - int maxv, dummy; - char c, p, t; - - if (!x) x = &dummy; - if (!y) y = &dummy; - if (!comp) comp = &dummy; - - stbi__rewind(s); - - // Get identifier - p = (char)stbi__get8(s); - t = (char)stbi__get8(s); - if (p != 'P' || (t != '5' && t != '6')) { - stbi__rewind(s); - return 0; - } - - *comp = (t == '6') ? 3 : 1; // '5' is 1-component .pgm; '6' is 3-component .ppm - - c = (char)stbi__get8(s); - stbi__pnm_skip_whitespace(s, &c); - - *x = stbi__pnm_getinteger(s, &c); // read width - stbi__pnm_skip_whitespace(s, &c); - - *y = stbi__pnm_getinteger(s, &c); // read height - stbi__pnm_skip_whitespace(s, &c); - - maxv = stbi__pnm_getinteger(s, &c); // read max value - if (maxv > 65535) - return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); - else if (maxv > 255) - return 16; - else - return 8; -} - -static int stbi__pnm_is16(stbi__context* s) -{ - if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) - return 1; - return 0; -} -#endif - -static int stbi__info_main(stbi__context* s, int* x, int* y, int* comp) -{ -#ifndef STBI_NO_JPEG - if (stbi__jpeg_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_PNG - if (stbi__png_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_GIF - if (stbi__gif_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_BMP - if (stbi__bmp_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_PSD - if (stbi__psd_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_PIC - if (stbi__pic_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_PNM - if (stbi__pnm_info(s, x, y, comp)) return 1; -#endif - -#ifndef STBI_NO_HDR - if (stbi__hdr_info(s, x, y, comp)) return 1; -#endif - - // test tga last because it's a crappy test! -#ifndef STBI_NO_TGA - if (stbi__tga_info(s, x, y, comp)) - return 1; -#endif - return stbi__err("unknown image type", "Image not of any known type, or corrupt"); -} - -static int stbi__is_16_main(stbi__context* s) -{ -#ifndef STBI_NO_PNG - if (stbi__png_is16(s)) return 1; -#endif - -#ifndef STBI_NO_PSD - if (stbi__psd_is16(s)) return 1; -#endif - -#ifndef STBI_NO_PNM - if (stbi__pnm_is16(s)) return 1; -#endif - return 0; -} - -#ifndef STBI_NO_STDIO -STBIDEF int stbi_info(char const* filename, int* x, int* y, int* comp) -{ - FILE* f = stbi__fopen(filename, "rb"); - int result; - if (!f) return stbi__err("can't fopen", "Unable to open file"); - result = stbi_info_from_file(f, x, y, comp); - fclose(f); - return result; -} - -STBIDEF int stbi_info_from_file(FILE* f, int* x, int* y, int* comp) -{ - int r; - stbi__context s; - long pos = ftell(f); - stbi__start_file(&s, f); - r = stbi__info_main(&s, x, y, comp); - fseek(f, pos, SEEK_SET); - return r; -} - -STBIDEF int stbi_is_16_bit(char const* filename) -{ - FILE* f = stbi__fopen(filename, "rb"); - int result; - if (!f) return stbi__err("can't fopen", "Unable to open file"); - result = stbi_is_16_bit_from_file(f); - fclose(f); - return result; -} - -STBIDEF int stbi_is_16_bit_from_file(FILE* f) -{ - int r; - stbi__context s; - long pos = ftell(f); - stbi__start_file(&s, f); - r = stbi__is_16_main(&s); - fseek(f, pos, SEEK_SET); - return r; -} -#endif // !STBI_NO_STDIO - -STBIDEF int stbi_info_from_memory(stbi_uc const* buffer, int len, int* x, int* y, int* comp) -{ - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__info_main(&s, x, y, comp); -} - -STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const* c, void* user, int* x, int* y, int* comp) -{ - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)c, user); - return stbi__info_main(&s, x, y, comp); -} - -STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const* buffer, int len) -{ - stbi__context s; - stbi__start_mem(&s, buffer, len); - return stbi__is_16_main(&s); -} - -STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const* c, void* user) -{ - stbi__context s; - stbi__start_callbacks(&s, (stbi_io_callbacks*)c, user); - return stbi__is_16_main(&s); -} - -#endif // STB_IMAGE_IMPLEMENTATION - -/* - revision history: - 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs - 2.19 (2018-02-11) fix warning - 2.18 (2018-01-30) fix warnings - 2.17 (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug - 1-bit BMP - *_is_16_bit api - avoid warnings - 2.16 (2017-07-23) all functions have 16-bit variants; - STBI_NO_STDIO works again; - compilation fixes; - fix rounding in unpremultiply; - optimize vertical flip; - disable raw_len validation; - documentation fixes - 2.15 (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode; - warning fixes; disable run-time SSE detection on gcc; - uniform handling of optional "return" values; - thread-safe initialization of zlib tables - 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs - 2.13 (2016-11-29) add 16-bit API, only supported for PNG right now - 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes - 2.11 (2016-04-02) allocate large structures on the stack - remove white matting for transparent PSD - fix reported channel count for PNG & BMP - re-enable SSE2 in non-gcc 64-bit - support RGB-formatted JPEG - read 16-bit PNGs (only as 8-bit) - 2.10 (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED - 2.09 (2016-01-16) allow comments in PNM files - 16-bit-per-pixel TGA (not bit-per-component) - info() for TGA could break due to .hdr handling - info() for BMP to shares code instead of sloppy parse - can use STBI_REALLOC_SIZED if allocator doesn't support realloc - code cleanup - 2.08 (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA - 2.07 (2015-09-13) fix compiler warnings - partial animated GIF support - limited 16-bpc PSD support - #ifdef unused functions - bug with < 92 byte PIC,PNM,HDR,TGA - 2.06 (2015-04-19) fix bug where PSD returns wrong '*comp' value - 2.05 (2015-04-19) fix bug in progressive JPEG handling, fix warning - 2.04 (2015-04-15) try to re-enable SIMD on MinGW 64-bit - 2.03 (2015-04-12) extra corruption checking (mmozeiko) - stbi_set_flip_vertically_on_load (nguillemot) - fix NEON support; fix mingw support - 2.02 (2015-01-19) fix incorrect assert, fix warning - 2.01 (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2 - 2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG - 2.00 (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg) - progressive JPEG (stb) - PGM/PPM support (Ken Miller) - STBI_MALLOC,STBI_REALLOC,STBI_FREE - GIF bugfix -- seemingly never worked - STBI_NO_*, STBI_ONLY_* - 1.48 (2014-12-14) fix incorrectly-named assert() - 1.47 (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb) - optimize PNG (ryg) - fix bug in interlaced PNG with user-specified channel count (stb) - 1.46 (2014-08-26) - fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG - 1.45 (2014-08-16) - fix MSVC-ARM internal compiler error by wrapping malloc - 1.44 (2014-08-07) - various warning fixes from Ronny Chevalier - 1.43 (2014-07-15) - fix MSVC-only compiler problem in code changed in 1.42 - 1.42 (2014-07-09) - don't define _CRT_SECURE_NO_WARNINGS (affects user code) - fixes to stbi__cleanup_jpeg path - added STBI_ASSERT to avoid requiring assert.h - 1.41 (2014-06-25) - fix search&replace from 1.36 that messed up comments/error messages - 1.40 (2014-06-22) - fix gcc struct-initialization warning - 1.39 (2014-06-15) - fix to TGA optimization when req_comp != number of components in TGA; - fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite) - add support for BMP version 5 (more ignored fields) - 1.38 (2014-06-06) - suppress MSVC warnings on integer casts truncating values - fix accidental rename of 'skip' field of I/O - 1.37 (2014-06-04) - remove duplicate typedef - 1.36 (2014-06-03) - convert to header file single-file library - if de-iphone isn't set, load iphone images color-swapped instead of returning NULL - 1.35 (2014-05-27) - various warnings - fix broken STBI_SIMD path - fix bug where stbi_load_from_file no longer left file pointer in correct place - fix broken non-easy path for 32-bit BMP (possibly never used) - TGA optimization by Arseny Kapoulkine - 1.34 (unknown) - use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case - 1.33 (2011-07-14) - make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements - 1.32 (2011-07-13) - support for "info" function for all supported filetypes (SpartanJ) - 1.31 (2011-06-20) - a few more leak fixes, bug in PNG handling (SpartanJ) - 1.30 (2011-06-11) - added ability to load files via callbacks to accomidate custom input streams (Ben Wenger) - removed deprecated format-specific test/load functions - removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway - error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha) - fix inefficiency in decoding 32-bit BMP (David Woo) - 1.29 (2010-08-16) - various warning fixes from Aurelien Pocheville - 1.28 (2010-08-01) - fix bug in GIF palette transparency (SpartanJ) - 1.27 (2010-08-01) - cast-to-stbi_uc to fix warnings - 1.26 (2010-07-24) - fix bug in file buffering for PNG reported by SpartanJ - 1.25 (2010-07-17) - refix trans_data warning (Won Chun) - 1.24 (2010-07-12) - perf improvements reading from files on platforms with lock-heavy fgetc() - minor perf improvements for jpeg - deprecated type-specific functions so we'll get feedback if they're needed - attempt to fix trans_data warning (Won Chun) - 1.23 fixed bug in iPhone support - 1.22 (2010-07-10) - removed image *writing* support - stbi_info support from Jetro Lauha - GIF support from Jean-Marc Lienher - iPhone PNG-extensions from James Brown - warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva) - 1.21 fix use of 'stbi_uc' in header (reported by jon blow) - 1.20 added support for Softimage PIC, by Tom Seddon - 1.19 bug in interlaced PNG corruption check (found by ryg) - 1.18 (2008-08-02) - fix a threading bug (local mutable static) - 1.17 support interlaced PNG - 1.16 major bugfix - stbi__convert_format converted one too many pixels - 1.15 initialize some fields for thread safety - 1.14 fix threadsafe conversion bug - header-file-only version (#define STBI_HEADER_FILE_ONLY before including) - 1.13 threadsafe - 1.12 const qualifiers in the API - 1.11 Support installable IDCT, colorspace conversion routines - 1.10 Fixes for 64-bit (don't use "unsigned long") - optimized upsampling by Fabian "ryg" Giesen - 1.09 Fix format-conversion for PSD code (bad global variables!) - 1.08 Thatcher Ulrich's PSD code integrated by Nicolas Schulz - 1.07 attempt to fix C++ warning/errors again - 1.06 attempt to fix C++ warning/errors again - 1.05 fix TGA loading to return correct *comp and use good luminance calc - 1.04 default float alpha is 1, not 255; use 'void *' for stbi_image_free - 1.03 bugfixes to STBI_NO_STDIO, STBI_NO_HDR - 1.02 support for (subset of) HDR files, float interface for preferred access to them - 1.01 fix bug: possible bug in handling right-side up bmps... not sure - fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all - 1.00 interface to zlib that skips zlib header - 0.99 correct handling of alpha in palette - 0.98 TGA loader by lonesock; dynamically add loaders (untested) - 0.97 jpeg errors on too large a file; also catch another malloc failure - 0.96 fix detection of invalid v value - particleman@mollyrocket forum - 0.95 during header scan, seek to markers in case of padding - 0.94 STBI_NO_STDIO to disable stdio usage; rename all #defines the same - 0.93 handle jpegtran output; verbose errors - 0.92 read 4,8,16,24,32-bit BMP files of several formats - 0.91 output 24-bit Windows 3.0 BMP files - 0.90 fix a few more warnings; bump version number to approach 1.0 - 0.61 bugfixes due to Marc LeBlanc, Christopher Lloyd - 0.60 fix compiling as c++ - 0.59 fix warnings: merge Dave Moore's -Wall fixes - 0.58 fix bug: zlib uncompressed mode len/nlen was wrong endian - 0.57 fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available - 0.56 fix bug: zlib uncompressed mode len vs. nlen - 0.55 fix bug: restart_interval not initialized to 0 - 0.54 allow NULL for 'int *comp' - 0.53 fix bug in png 3->4; speedup png decoding - 0.52 png handles req_comp=3,4 directly; minor cleanup; jpeg comments - 0.51 obey req_comp requests, 1-component jpegs return as 1-component, - on 'test' only check type, not whether we support this variant - 0.50 (2006-11-19) - first released version -*/ - - -/* ------------------------------------------------------------------------------- -This software is available under 2 licenses -- choose whichever you prefer. ------------------------------------------------------------------------------- -ALTERNATIVE A - MIT License -Copyright (c) 2017 Sean Barrett -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies -of the Software, and to permit persons to whom the Software is furnished to do -so, subject to the following conditions: -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. ------------------------------------------------------------------------------- -ALTERNATIVE B - Public Domain (www.unlicense.org) -This is free and unencumbered software released into the public domain. -Anyone is free to copy, modify, publish, use, compile, sell, or distribute this -software, either in source code form or as a compiled binary, for any purpose, -commercial or non-commercial, and by any means. -In jurisdictions that recognize copyright laws, the author or authors of this -software dedicate any and all copyright interest in the software to the public -domain. We make this dedication for the benefit of the public at large and to -the detriment of our heirs and successors. We intend this dedication to be an -overt act of relinquishment in perpetuity of all present and future rights to -this software under copyright law. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN -ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION -WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ------------------------------------------------------------------------------- -*/ \ No newline at end of file