From 580b33efe867d348285785bcccd63681ec7ae962 Mon Sep 17 00:00:00 2001 From: AndrewNikkk Date: Mon, 16 Nov 2026 09:28:38 +0300 Subject: [PATCH] lab5 --- .dockerignore | 3 + .env.example | 25 +- CMakeLists.txt | 124 + CMakePresets.json | 26 + Dockerfile | 117 + Makefile | 24 +- README.md | 8 +- REPORT.md | 269 +- cmake/ImportMinioDeps.cmake | 55 + compose.yaml | 273 + docker-entrypoint.sh | 19 + evidence/README.md | 30 + evidence/async-suite.json | 313 + evidence/track2.json | 1311 ++++ evidence/upload-async.json | 21 + infra/mc/Dockerfile | 19 + infra/minio/Dockerfile | 22 + infra/minio/policy-attachments.json | 29 + infra/track2.md | 172 + infra/worker.md | 151 + lb/nginx.conf.template | 44 + migrations/001_init.sql | 33 + migrations/002_sessions.sql | 6 + migrations/003_idempotency.sql | 11 + migrations/004_attachments.sql | 22 + migrations/005_message_attachments.sql | 12 + migrations/006_direct_uploads.sql | 26 + migrations/007_direct_upload_staging.sql | 12 + migrations/008_async_attachments.sql | 21 + migrations/009_outbox.sql | 20 + migrations/010_staging_and_replay.sql | 22 + migrations/011_versioned_pipeline.sql | 41 + src/attachment_queue.cpp | 93 + src/attachment_queue.hpp | 27 + src/attachment_repo.cpp | 156 + src/attachment_repo.hpp | 28 + src/attachment_storage.hpp | 20 + src/auth.cpp | 39 + src/auth.hpp | 7 + src/chat_repo.cpp | 186 + src/chat_repo.hpp | 23 + src/cursor.hpp | 47 + src/db.cpp | 360 + src/db.hpp | 62 + src/direct_upload_repo.cpp | 292 + src/direct_upload_repo.hpp | 63 + src/errors.hpp | 15 + src/fault_injection.hpp | 42 + src/image_pipeline.cpp | 151 + src/image_pipeline.hpp | 25 + src/image_util.cpp | 90 + src/image_util.hpp | 41 + src/job_admin_main.cpp | 110 + src/job_repo.cpp | 137 + src/job_repo.hpp | 35 + src/main.cpp | 2352 ++++++ src/message_repo.cpp | 377 + src/message_repo.hpp | 38 + src/models.hpp | 86 + src/outbox.cpp | 65 + src/outbox.hpp | 26 + src/pg_session_repo.cpp | 66 + src/pg_session_repo.hpp | 18 + src/redis_pool.cpp | 216 + src/redis_pool.hpp | 59 + src/s3_client.cpp | 281 + src/s3_client.hpp | 71 + src/session_repo.cpp | 87 + src/session_repo.hpp | 18 + src/session_repo_base.hpp | 22 + src/staging_cleaner.cpp | 77 + src/staging_cleaner.hpp | 18 + src/user_repo.cpp | 100 + src/user_repo.hpp | 22 + src/worker_main.cpp | 220 + student-tests/README.md | 102 + student-tests/async_suite.py | 599 ++ student-tests/requirements.txt | 1 + student-tests/test_outbox_crash.sh | 4 + student-tests/test_pipeline_idempotency.sh | 4 + student-tests/test_reliability.sh | 4 + student-tests/test_thumbnail.py | 74 + student-tests/test_upload_async.sh | 4 + student-tests/test_variants.py | 77 + student-tests/test_worker_down.sh | 4 + student-tests/track2_suite.py | 385 + third_party/stb/README.md | 6 + third_party/stb/VERSION | 1 + third_party/stb/stb_image.h | 7988 ++++++++++++++++++++ third_party/stb/stb_image_resize.h | 2634 +++++++ third_party/stb/stb_image_write.h | 1724 +++++ tools/fixtures/320x200.png | Bin 0 -> 502 bytes tools/fixtures/small.jpg | Bin 0 -> 644 bytes tools/fixtures/tiny.jpg | Bin 0 -> 633 bytes tools/fixtures/tiny.png | Bin 0 -> 69 bytes tools/image_smoke.cpp | 111 + tools/s3_smoke.cpp | 35 + tools/thumbnail_smoke.cpp | 24 + tools/variants_smoke.cpp | 32 + 99 files changed, 23335 insertions(+), 27 deletions(-) create mode 100644 CMakeLists.txt create mode 100644 CMakePresets.json create mode 100644 Dockerfile create mode 100644 cmake/ImportMinioDeps.cmake create mode 100644 compose.yaml create mode 100644 docker-entrypoint.sh create mode 100644 evidence/async-suite.json create mode 100644 evidence/track2.json create mode 100644 evidence/upload-async.json create mode 100644 infra/mc/Dockerfile create mode 100644 infra/minio/Dockerfile create mode 100644 infra/minio/policy-attachments.json create mode 100644 infra/track2.md create mode 100644 infra/worker.md create mode 100644 lb/nginx.conf.template create mode 100644 migrations/001_init.sql create mode 100644 migrations/002_sessions.sql create mode 100644 migrations/003_idempotency.sql create mode 100644 migrations/004_attachments.sql create mode 100644 migrations/005_message_attachments.sql create mode 100644 migrations/006_direct_uploads.sql create mode 100644 migrations/007_direct_upload_staging.sql create mode 100644 migrations/008_async_attachments.sql create mode 100644 migrations/009_outbox.sql create mode 100644 migrations/010_staging_and_replay.sql create mode 100644 migrations/011_versioned_pipeline.sql create mode 100644 src/attachment_queue.cpp create mode 100644 src/attachment_queue.hpp create mode 100644 src/attachment_repo.cpp create mode 100644 src/attachment_repo.hpp create mode 100644 src/attachment_storage.hpp create mode 100644 src/auth.cpp create mode 100644 src/auth.hpp create mode 100644 src/chat_repo.cpp create mode 100644 src/chat_repo.hpp create mode 100644 src/cursor.hpp create mode 100644 src/db.cpp create mode 100644 src/db.hpp create mode 100644 src/direct_upload_repo.cpp create mode 100644 src/direct_upload_repo.hpp create mode 100644 src/errors.hpp create mode 100644 src/fault_injection.hpp create mode 100644 src/image_pipeline.cpp create mode 100644 src/image_pipeline.hpp create mode 100644 src/image_util.cpp create mode 100644 src/image_util.hpp create mode 100644 src/job_admin_main.cpp create mode 100644 src/job_repo.cpp create mode 100644 src/job_repo.hpp create mode 100644 src/main.cpp create mode 100644 src/message_repo.cpp create mode 100644 src/message_repo.hpp create mode 100644 src/models.hpp create mode 100644 src/outbox.cpp create mode 100644 src/outbox.hpp create mode 100644 src/pg_session_repo.cpp create mode 100644 src/pg_session_repo.hpp create mode 100644 src/redis_pool.cpp create mode 100644 src/redis_pool.hpp create mode 100644 src/s3_client.cpp create mode 100644 src/s3_client.hpp create mode 100644 src/session_repo.cpp create mode 100644 src/session_repo.hpp create mode 100644 src/session_repo_base.hpp create mode 100644 src/staging_cleaner.cpp create mode 100644 src/staging_cleaner.hpp create mode 100644 src/user_repo.cpp create mode 100644 src/user_repo.hpp create mode 100644 src/worker_main.cpp create mode 100644 student-tests/README.md create mode 100644 student-tests/async_suite.py create mode 100644 student-tests/requirements.txt create mode 100755 student-tests/test_outbox_crash.sh create mode 100755 student-tests/test_pipeline_idempotency.sh create mode 100755 student-tests/test_reliability.sh create mode 100644 student-tests/test_thumbnail.py create mode 100755 student-tests/test_upload_async.sh create mode 100644 student-tests/test_variants.py create mode 100755 student-tests/test_worker_down.sh create mode 100644 student-tests/track2_suite.py create mode 100644 third_party/stb/README.md create mode 100644 third_party/stb/VERSION create mode 100644 third_party/stb/stb_image.h create mode 100644 third_party/stb/stb_image_resize.h create mode 100644 third_party/stb/stb_image_write.h create mode 100644 tools/fixtures/320x200.png create mode 100644 tools/fixtures/small.jpg create mode 100644 tools/fixtures/tiny.jpg create mode 100644 tools/fixtures/tiny.png create mode 100644 tools/image_smoke.cpp create mode 100644 tools/s3_smoke.cpp create mode 100644 tools/thumbnail_smoke.cpp create mode 100644 tools/variants_smoke.cpp diff --git a/.dockerignore b/.dockerignore index bc16e556..99d0a7c8 100644 --- a/.dockerignore +++ b/.dockerignore @@ -18,3 +18,6 @@ __pycache__ node_modules evidence .DS_Store + +# Local build/test outputs can contain disposable credentials. +build/ diff --git a/.env.example b/.env.example index 119384b5..bb953db5 100644 --- a/.env.example +++ b/.env.example @@ -11,15 +11,32 @@ SESSION_STORE=postgres CACHE_URL_FILE=/run/secrets/cache_url API_REPLICAS=2 IDEMPOTENCY_TTL_SECONDS=86400 -S3_ENDPOINT=http://s3:9000 +S3_ENDPOINT=http://minio:9000 S3_REGION=us-east-1 S3_BUCKET=messenger-attachments S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key MAX_UPLOAD_BYTES=10485760 MAX_IMAGE_PIXELS=40000000 -BROKER_URL_FILE=/run/secrets/broker_url -WORKER_CONCURRENCY=2 -JOB_MAX_ATTEMPTS=5 +# Same Valkey instance serves sessions and Streams. +BROKER_URL_FILE=/run/secrets/cache_url +WORKER_CONCURRENCY=1 +# One initial attempt plus five retries. +JOB_MAX_ATTEMPTS=6 +JOB_RECLAIM_IDLE_MS=5000 +JOB_RETRY_BASE_MS=1000 +JOB_RETRY_MAX_MS=60000 JOB_TIMEOUT_SECONDS=60 STAGING_RETENTION_SECONDS=86400 +STAGING_CLEANUP_INTERVAL_SECONDS=60 + +# Local Compose bootstrap; choose your own values and matching secret files. +POSTGRES_USER=messenger +POSTGRES_PASSWORD=change_me_locally +POSTGRES_DB=messenger +MINIO_ROOT_USER=minioadmin +MINIO_ROOT_PASSWORD=change_me_minio_root_locally +MINIO_USER_ACCESS_KEY=messenger-s3 +MINIO_USER_SECRET_KEY=change_me_s3_user_locally +MAX_CONCURRENT_UPLOADS=3 +DIRECT_UPLOAD_TTL_SECONDS=300 diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 00000000..71e596da --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,124 @@ +cmake_minimum_required(VERSION 3.16) +project(mtusi_messenger CXX) + +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED ON) + +# Official MinIO C++ SDK (S3-compatible). Pinned tag; not a hand-rolled SigV4. +set(MTUSI_MINIO_CPP_VERSION "v0.3.0" CACHE STRING "minio-cpp git tag") + +find_package(Threads REQUIRED) +find_package(PkgConfig REQUIRED) + +pkg_check_modules(PQXX REQUIRED IMPORTED_TARGET libpqxx>=7.8) +pkg_check_modules(HIREDIS REQUIRED IMPORTED_TARGET hiredis) +pkg_check_modules(SODIUM REQUIRED IMPORTED_TARGET libsodium) +pkg_check_modules(EXIF REQUIRED IMPORTED_TARGET libexif) +pkg_check_modules(WEBP REQUIRED IMPORTED_TARGET libwebp) + +include("${CMAKE_CURRENT_SOURCE_DIR}/cmake/ImportMinioDeps.cmake") + +include(FetchContent) +set(MINIO_CPP_TEST OFF CACHE BOOL "" FORCE) +set(MINIO_CPP_MAKE_DOC OFF CACHE BOOL "" FORCE) +FetchContent_Declare( + miniocpp + GIT_REPOSITORY https://github.com/minio/minio-cpp.git + GIT_TAG ${MTUSI_MINIO_CPP_VERSION} + GIT_SHALLOW TRUE +) +# Inject find_package stubs before miniocpp configures. +function(_mtusi_provide_minio_find_packages) + # miniocpp calls find_package(unofficial-curlpp CONFIG) etc. + # We already created ALIAS targets; create tiny config files in a prefix. + set(_cfg_dir "${CMAKE_CURRENT_BINARY_DIR}/mtusi-minio-deps") + file(MAKE_DIRECTORY "${_cfg_dir}") + file(WRITE "${_cfg_dir}/unofficial-curlpp-config.cmake" "") + file(WRITE "${_cfg_dir}/unofficial-inih-config.cmake" "") + list(PREPEND CMAKE_PREFIX_PATH "${_cfg_dir}") + set(CMAKE_PREFIX_PATH "${CMAKE_PREFIX_PATH}" PARENT_SCOPE) +endfunction() +_mtusi_provide_minio_find_packages() + +FetchContent_GetProperties(miniocpp) +if(NOT miniocpp_POPULATED) + FetchContent_Populate(miniocpp) + # Neutralize CONFIG find_package calls by providing empty configs + targets. + set(CMAKE_FIND_PACKAGE_REDIRECTS_DIR "${CMAKE_CURRENT_BINARY_DIR}/mtusi-find-redirects") + file(MAKE_DIRECTORY "${CMAKE_FIND_PACKAGE_REDIRECTS_DIR}") + # CMake 3.24+ redirects; for older, patch via policy: set variables that + # make find_package(CONFIG) succeed when targets already exist. + set(unofficial-curlpp_DIR "${CMAKE_CURRENT_BINARY_DIR}/mtusi-minio-deps" CACHE PATH "" FORCE) + set(unofficial-inih_DIR "${CMAKE_CURRENT_BINARY_DIR}/mtusi-minio-deps" CACHE PATH "" FORCE) + # Provide package config bodies that are no-ops (targets already defined). + file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/mtusi-minio-deps/unofficial-curlpp-config.cmake" + "# provided by ImportMinioDeps.cmake\n") + file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/mtusi-minio-deps/unofficial-inih-config.cmake" + "# provided by ImportMinioDeps.cmake\n") + # Skip miniocpp install(EXPORT) — our INTERFACE system deps are not exportable. + set(CMAKE_SKIP_INSTALL_RULES ON) + add_subdirectory(${miniocpp_SOURCE_DIR} ${miniocpp_BINARY_DIR}) + set(CMAKE_SKIP_INSTALL_RULES OFF) +endif() + +add_library(messenger_core STATIC + src/db.cpp + src/auth.cpp + src/user_repo.cpp + src/chat_repo.cpp + src/message_repo.cpp + src/redis_pool.cpp + src/session_repo.cpp + src/pg_session_repo.cpp + src/s3_client.cpp + src/image_util.cpp + src/attachment_repo.cpp + src/attachment_queue.cpp + src/outbox.cpp + src/staging_cleaner.cpp + src/job_repo.cpp + src/image_pipeline.cpp + src/direct_upload_repo.cpp +) + +target_include_directories(messenger_core PUBLIC + src + ${CMAKE_CURRENT_SOURCE_DIR}/third_party/stb +) +target_compile_definitions(messenger_core PUBLIC + MTUSI_MINIO_CPP_VERSION="${MTUSI_MINIO_CPP_VERSION}" +) + +target_link_libraries(messenger_core PUBLIC + Threads::Threads + PkgConfig::PQXX + PkgConfig::HIREDIS + PkgConfig::SODIUM + PkgConfig::EXIF + PkgConfig::WEBP + miniocpp::miniocpp +) + +add_executable(messenger src/main.cpp) +target_link_libraries(messenger PRIVATE messenger_core) + +add_executable(worker src/worker_main.cpp) +target_link_libraries(worker PRIVATE messenger_core) + +add_executable(s3_smoke tools/s3_smoke.cpp) +target_link_libraries(s3_smoke PRIVATE messenger_core) + +add_executable(image_smoke tools/image_smoke.cpp) +target_link_libraries(image_smoke PRIVATE messenger_core) +target_compile_definitions(image_smoke PRIVATE + IMAGE_SMOKE_FIXTURES="${CMAKE_SOURCE_DIR}/tools/fixtures" +) + +add_executable(thumbnail_smoke tools/thumbnail_smoke.cpp) +target_link_libraries(thumbnail_smoke PRIVATE messenger_core) + +add_executable(variants_smoke tools/variants_smoke.cpp) +target_link_libraries(variants_smoke PRIVATE messenger_core) + +add_executable(job_admin src/job_admin_main.cpp) +target_link_libraries(job_admin PRIVATE messenger_core) diff --git a/CMakePresets.json b/CMakePresets.json new file mode 100644 index 00000000..b8f98853 --- /dev/null +++ b/CMakePresets.json @@ -0,0 +1,26 @@ +{ + "version": 6, + "cmakeMinimumRequired": { + "major": 3, + "minor": 16, + "patch": 0 + }, + "configurePresets": [ + { + "name": "release", + "displayName": "Release with minio-cpp", + "generator": "Unix Makefiles", + "binaryDir": "${sourceDir}/build", + "cacheVariables": { + "CMAKE_BUILD_TYPE": "Release", + "MTUSI_MINIO_CPP_VERSION": "v0.3.0" + } + } + ], + "buildPresets": [ + { + "name": "release", + "configurePreset": "release" + } + ] +} diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..70be020e --- /dev/null +++ b/Dockerfile @@ -0,0 +1,117 @@ +# Clean-clone build: Ubuntu 24.04 + libpqxx from a pinned git tag. +# S3 client: official minio-cpp v0.3.0 via FetchContent (library SigV4). +# No dependency on mtusi2026lab3-api or other prior-lab images. + +ARG PQXX_VERSION=7.10.0 +ARG MTUSI_MINIO_CPP_VERSION=v0.3.0 + +# --------------------------------------------------------------------------- +# Stage: build libpqxx into /opt/libpqxx +# --------------------------------------------------------------------------- +FROM ubuntu:24.04 AS pqxx +ARG PQXX_VERSION +ENV DEBIAN_FRONTEND=noninteractive +RUN apt-get update && apt-get install -y --no-install-recommends \ + build-essential cmake git ca-certificates pkg-config \ + libpq-dev \ + && rm -rf /var/lib/apt/lists/* + +WORKDIR /tmp +RUN git clone --depth 1 --branch "${PQXX_VERSION}" \ + https://github.com/jtv/libpqxx.git libpqxx-src \ + && cmake -S libpqxx-src -B libpqxx-build \ + -DCMAKE_BUILD_TYPE=Release \ + -DCMAKE_INSTALL_PREFIX=/opt/libpqxx \ + -DBUILD_SHARED_LIBS=ON \ + -DSKIP_BUILD_TEST=ON \ + && cmake --build libpqxx-build -j"$(nproc)" \ + && cmake --install libpqxx-build \ + && rm -rf /tmp/libpqxx-src /tmp/libpqxx-build + +# --------------------------------------------------------------------------- +# Stage: build messenger + worker + smokes +# --------------------------------------------------------------------------- +FROM ubuntu:24.04 AS builder +ARG MTUSI_MINIO_CPP_VERSION +ENV DEBIAN_FRONTEND=noninteractive +RUN apt-get update && apt-get install -y --no-install-recommends \ + build-essential cmake pkg-config git ca-certificates \ + libpq-dev \ + libhiredis-dev \ + libsodium-dev libexif-dev libwebp-dev \ + nlohmann-json3-dev \ + libcurl4-openssl-dev libssl-dev zlib1g-dev \ + libpugixml-dev \ + libcurlpp-dev \ + libinih-dev \ + && rm -rf /var/lib/apt/lists/* + +COPY --from=pqxx /opt/libpqxx /opt/libpqxx +ENV PKG_CONFIG_PATH=/opt/libpqxx/lib/pkgconfig:/opt/libpqxx/lib/x86_64-linux-gnu/pkgconfig +ENV LD_LIBRARY_PATH=/opt/libpqxx/lib:/opt/libpqxx/lib/x86_64-linux-gnu +ENV CMAKE_PREFIX_PATH=/opt/libpqxx + +WORKDIR /src +COPY CMakeLists.txt CMakePresets.json ./ +COPY cmake ./cmake +COPY src ./src +COPY tools ./tools +COPY migrations ./migrations +COPY third_party ./third_party + +RUN cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DMTUSI_MINIO_CPP_VERSION=${MTUSI_MINIO_CPP_VERSION} \ + && cmake --build build -j"$(nproc)" + +# --------------------------------------------------------------------------- +# Runtime +# --------------------------------------------------------------------------- +FROM ubuntu:24.04 +ENV DEBIAN_FRONTEND=noninteractive +RUN apt-get update && apt-get install -y --no-install-recommends \ + ca-certificates curl \ + libpq5 \ + libhiredis1.1.0 \ + libsodium23 libexif12 libwebp7 \ + libssl3t64 \ + libcurl4t64 \ + zlib1g \ + libpugixml1v5 \ + libcurlpp0t64 \ + libinih1 \ + libinireader0 \ + util-linux \ + && rm -rf /var/lib/apt/lists/* \ + && groupadd --gid 10001 app \ + && useradd --uid 10001 --gid app --shell /usr/sbin/nologin --no-create-home app + +COPY --from=pqxx /opt/libpqxx /opt/libpqxx +ENV LD_LIBRARY_PATH=/opt/libpqxx/lib:/opt/libpqxx/lib/x86_64-linux-gnu + +WORKDIR /app +COPY --from=builder /src/build/messenger /app/messenger +COPY --from=builder /src/build/worker /app/worker +COPY --from=builder /src/build/job_admin /app/job_admin +COPY --from=builder /src/build/s3_smoke /app/s3_smoke +COPY --from=builder /src/build/image_smoke /app/image_smoke +COPY --from=builder /src/build/thumbnail_smoke /app/thumbnail_smoke +COPY --from=builder /src/build/variants_smoke /app/variants_smoke +COPY --from=builder /src/migrations /app/migrations +COPY tools/fixtures /app/fixtures +COPY docker-entrypoint.sh /docker-entrypoint.sh + +RUN chmod 0755 /docker-entrypoint.sh \ + && chown -R app:app /app + +# Entrypoint starts as root to stage S3 secret files for uid 10001, then drops. +USER root +ENV APP_HOST=0.0.0.0 +ENV APP_PORT=8080 + +EXPOSE 8080 + +HEALTHCHECK --interval=5s --timeout=3s --start-period=20s --retries=3 \ + CMD curl -fsS http://127.0.0.1:8080/health/live || exit 1 + +ENTRYPOINT ["/docker-entrypoint.sh"] +CMD ["/app/messenger"] diff --git a/Makefile b/Makefile index 5d86d171..4aa389b4 100644 --- a/Makefile +++ b/Makefile @@ -1,13 +1,14 @@ PYTHON ?= python3 BASE_URL ?= http://localhost:8080 CA_FILE ?= +TEST_ARGS ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) -.PHONY: help check validate test load test-persistence test-failover +.PHONY: help check validate test load test-persistence test-failover test-async test-upload-async test-worker-down test-outbox-crash test-reliability test-track2 help: - @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" + @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; test-async: disposable Compose suite; load: synthetic writes" check: $(PYTHON) scripts/check_contract.py @@ -28,3 +29,22 @@ test-persistence: test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +# Creates/removes only a disposable Compose project with synthetic data. +test-async: + $(PYTHON) student-tests/async_suite.py all $(TEST_ARGS) + +test-upload-async: + PYTHON="$(PYTHON)" student-tests/test_upload_async.sh $(TEST_ARGS) + +test-worker-down: + PYTHON="$(PYTHON)" student-tests/test_worker_down.sh $(TEST_ARGS) + +test-outbox-crash: + PYTHON="$(PYTHON)" student-tests/test_outbox_crash.sh $(TEST_ARGS) + +test-reliability: + PYTHON="$(PYTHON)" student-tests/test_reliability.sh $(TEST_ARGS) + +test-track2: + PYTHON="$(PYTHON)" student-tests/test_pipeline_idempotency.sh $(TEST_ARGS) diff --git a/README.md b/README.md index 009d6997..51b379b2 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,13 @@ Отделить приём файла от тяжёлой обработки, корректно переживать повторную доставку и остановку worker. -Это **skeleton**, а не готовый сервер. Здесь есть задание, контракт и публичные проверки. Реализацию приложения, Dockerfile и требуемую инфраструктуру пишет студент. Язык и framework свободные; UI не обязателен. +В репозитории реализованы C++17 API и отдельный worker, Redis Streams, transactional outbox, +thumbnail/crop/WebP, retry, replay и очистка staging. Запуск — [REPORT.md](REPORT.md), +воспроизводимые проверки — [student-tests/README.md](student-tests/README.md). +Трек 2 уровня 5: [версии pipeline и исследование идемпотентности](infra/track2.md). + +Исходное задание поставлялось как **skeleton**. Ниже сохранены условия курса, +контракт и публичные проверки; UI не обязателен. [Карта курса](COURSE.md) · [Процесс fork/PR](CONTRIBUTING.md) · [OpenAPI](contracts/openapi.json) · [Семантика API](contracts/README.md) · [Проверки](tests/README.md) · [Отчёт](REPORT.md) · [Примеры JSON](contracts/examples.json) · [Памятка преподавателю](MAINTAINERS.md) diff --git a/REPORT.md b/REPORT.md index e98f75e9..63eac510 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,266 @@ # Отчёт — лабораторная 5 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: Никитин Андрей Александрович, БВТ2301 +- Целевой уровень: 5, трек 2 — доказанная идемпотентность versioned pipeline. +- Commit/PR реализации: +- Помощь ИИ: Codex, DeepSeek ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Linux amd64, Docker Engine с Compose v2, Python 3.10+, доступ к Ubuntu/GitHub +для первой сборки. API и worker собираются здесь из C++17; предыдущие lab-образы +не используются. При локальной CMake-сборке нужны зависимости из Dockerfile, +включая libpqxx >=7.8, hiredis, libsodium, libexif, libwebp и зависимости minio-cpp. + +Быстрая проверка в полностью отдельном стенде, без рабочего `.env` и secrets: + +```sh +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt -r student-tests/requirements.txt +make check validate PYTHON=.venv/bin/python +make test-async PYTHON=.venv/bin/python TEST_ARGS="--output evidence/async-suite.json" +``` + +Runner создаёт случайный Compose-проект, синтетические credentials и volumes, +проверяет сценарии и удаляет только собственный стенд. Подробнее: +[student-tests/README.md](student-tests/README.md). + +Для обычного локального стенда следующие команды предназначены для чистого +clone без существующих `.env`/secrets. Они генерируют случайные учебные пароли +и согласованные file-secrets, не печатая значения: + +```sh +python3 - <<'PY' +from pathlib import Path +import secrets +assert not Path('.env').exists() and not Path('secrets').exists(), 'Use existing local configuration' +text = Path('.env.example').read_text() +passwords = {k: secrets.token_hex(24) for k in + ('POSTGRES_PASSWORD', 'MINIO_ROOT_PASSWORD', 'MINIO_USER_SECRET_KEY')} +lines = [] +for line in text.splitlines(): + key = line.partition('=')[0] + lines.append(key + '=' + passwords[key] if key in passwords else line) +Path('.env').write_text('\n'.join(lines) + '\n') +Path('.env').chmod(0o600) +values = dict(line.split('=', 1) for line in lines if '=' in line and not line.startswith('#')) +Path('secrets').mkdir(mode=0o700) +files = { + 'database_url': 'postgresql://'+values['POSTGRES_USER']+':'+values['POSTGRES_PASSWORD']+'@db:5432/'+values['POSTGRES_DB'], + 'cache_url': 'redis://cache:6379/0', + 's3_access_key_id': values['MINIO_USER_ACCESS_KEY'], + 's3_secret_access_key': values['MINIO_USER_SECRET_KEY'], +} +for name, value in files.items(): + path = Path('secrets') / name + path.write_text(value + '\n') + path.chmod(0o644) # container uid 10001; the host parent directory is private +PY + +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +# Дождаться HTTP 200: +curl --fail http://localhost:8080/health/ready +make test +``` + +Миграции 001–011 выполняются API/worker при старте под общим advisory lock; +версия фиксируется в `schema_migrations`. MinIO init создаёт приватный bucket, +а user-init — ограниченного S3-пользователя и policy. Consumer group создаёт +worker с позиции 0. Init/migrations допускают повторный запуск с прежними volumes. + +Безопасная остановка: `docker compose down` — named volumes и локальные secrets +сохраняются. **Намеренный сброс только своего учебного стенда:** +`docker compose down --volumes` удаляет его PostgreSQL/Valkey/S3 данные. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab4, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Перенесены код и миграции lab4: пользователи, сессии, участники, сообщения, +keyset pagination, idempotency, S3 и проверка PNG/JPEG. Общие репозитории, +пулы, S3 и изображения собраны в статическую `messenger_core`. Отдельные +бинарники: `messenger`, `worker`, операторский `job_admin` и image smoke tools. + +| Роль | Compose service / версия | Persistence и доступ | +| --- | --- | --- | +| API | api, образ собирается из Dockerfile, 2 реплики по умолчанию | Только LB публикует основной HTTP :8080; credentials через file-secrets | +| Worker | worker, тот же образ, `/app/worker` | COUNT 1, одна работа за раз, 512 MiB, watchdog/restart | +| БД | db, postgres:16.15-alpine | pgdata, synchronous_commit включён | +| Брокер/Redis-сессии | cache, valkey/valkey:8.1.10-alpine | valkeydata, AOF yes, appendfsync always, без host-порта | +| S3 | minio, RELEASE.2025-04-22T22-12-26Z | miniodata, приватный bucket, без host-портов 9000/9001 | +| S3 bootstrap | minio-init / minio-user-init, mc RELEASE.2025-04-16T18-13-26Z | Root используется только bootstrap; API/worker — ограниченный пользователь | +| LB | lb, nginx:1.28.0-alpine | Доступ к API-репликам; :8080 | + +SDK MinIO закреплён v0.3.0, stb — commit +`013ac3beddff3dbffafd5177e7972067cd2b5083`. libwebp/libexif берутся из Ubuntu 24.04. +APT-пакеты не закреплены по отдельным версиям; ID протестированных образов есть +в evidence. В Docker context исключены `.env`, secrets, build и приватные файлы. + +### Upload и durable handoff + +Обязательный endpoint — `POST /api/v1/chats/{chat_id}/attachments?filename=…`, +сырые PNG/JPEG bytes, не multipart. Проверяются идентификация/доступ, filename, +MIME по содержимому, 10 MiB и 40 млн пикселей до полной распаковки. API проверяет +целостность, но resize/crop/WebP выполняет только worker. + +API PUT сохраняет оригинал в `staging/{chat_id}/{attachment_id}`. Затем одной +транзакцией сохраняются attachment queued, job и outbox. До COMMIT 202 не выдаётся. +Весь upload и PUT остаются синхронными; асинхронна дальнейшая обработка/публикация. +Возвращается неизменяемый снимок queued, даже если worker успеет раньше первого GET. + +Отдельный поток API выбирает до 32 due outbox через `FOR UPDATE SKIP LOCKED`, +делает XADD и фиксирует published=true. Его пулы независимы от HTTP. +COMMIT→XADD восстанавливается из outbox; XADD→COMMIT marker может дать дубль. +Доставка at least once; exactly-once не заявляется. `payload` соответствует +`contracts/jobs.schema.json`: IDs/служебные поля, без bytes, credentials или URL. + +В `.env.example` сессии PostgreSQL. При таком выборе брокер не нужен для upload +или readiness: проверяется PostgreSQL. При Redis-сессиях Redis остаётся синхронной +зависимостью аутентификации/readiness. Runtime readiness API не выполняет S3 HEAD; +S3 имеет отдельный service healthcheck, а upload не подтверждается при ошибке PUT. + +### Worker, изображения и повторы + +Worker читает consumer group `attachment-workers` через XREADGROUP, подбирает +pending через XAUTOCLAIM. Job защищена session advisory lock PostgreSQL, который +освобождается при смерти процесса. Размер/SHA-256 staging проверяются до эффектов. +Оригинал публикуется из проверенных bytes побайтно, включая возможный EXIF. + +Растр декодируется один раз, EXIF orientation применяется, alpha компонуется на +белый. Имена итоговых объектов детерминированы. Новые jobs создают три варианта: + +| Вариант | Геометрия | Кодирование | +| --- | --- | --- | +| thumbnail | Вписан в 256×256, без увеличения, floor/min 1 px | JPEG, v1 quality 85 / v2 quality 90 | +| crop | Центральный квадрат → 128×128, увеличение разрешено | JPEG, v1 quality 85 / v2 quality 90 | +| optimized | Вписан в 1280×1280, без увеличения, floor/min 1 px | lossy WebP, v1 quality 80 / v2 quality 90 | + +EXIF/ICC/XMP в варианты не переносятся. WebP не обязан быть меньше любого +маленького исходника. Ready/variants публикуются одной DB-транзакцией после всех +четырёх объектов (оригинал + варианты); затем ACK. Дубль ready проверяет объекты +и не изменяет результат. Метаданные/SHA оригинала всегда описывают исходные bytes. +Content идёт через авторизованный API; без ранее опубликованного результата +queued/processing/failed отвечают 409. При upgrade старый ready-снимок сохраняется +до успешного COMMIT новой версии. + +Временные ошибки сохраняют retries, next_attempt_at и следующий outbox атомарно; +после этого ACK старой доставки безопасен. Backoff: ceiling=min(max,base*2^(n-1)), +случайная задержка в [ceil(ceiling/2),ceiling], n — номер неудачи текущего +бюджета (retries-retry_base); defaults 1000/60000 ms. До due +не публикует publisher и не начинает worker. Попытки 1..6 ограничены; постоянный +invalid_image/source_mismatch сразу failed, исчерпание — processing_failed. +Failed виден в jobs, некорректные события — в `jobs:attachments:invalid`. +Watchdog (default 60 s) завершает зависший процесс с 124, Compose перезапускает его. + +Очистка staging и operator replay подробно описаны в [infra/worker.md](infra/worker.md). +Ready-staging удаляется после проверки результатов; live presigned URL откладывает +удаление до expiry. Failed/orphan retention — 86400 s, период GC — 60 s. +Queued/processing и PUT до DB COMMIT защищены, batch GC ограничен. Replay проверяет +source checksum, разрешён только failed с сохранённым staging, сохраняет job_id, +audit и новый outbox, не сбрасывая монотонный retries. После retention нужен новый upload. ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +Основная команда — `make test-async PYTHON=.venv/bin/python +TEST_ARGS="--no-build --output evidence/async-suite.json"` (после первой сборки). +Все воздействия относятся только к изолированному проекту. JSON содержит +контейнеры/StartedAt/volumes, observed checks и source SHA; secrets не сохраняются. -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +| Критерий | Воспроизводимый сценарий | Наблюдение / evidence | +| --- | --- | --- | +| POST 202, состояния, оригинал/thumbnail | test_upload_async.sh | queued наблюдается при остановленном worker; ready, bytes/SHA и реальный JPEG 256×160 проверены | +| Durable staging/queue, restart stores | test_worker_down.sh | сообщение с queued attachment; прежняя сессия и job переживают API/PostgreSQL/Valkey/MinIO restart с прежними volumes | +| Outbox COMMIT→publish | test_outbox_crash.sh | exit 86 в реальном API, committed outbox подхвачен после рестарта без нового POST | +| Publish→marker duplicate | test_outbox_crash.sh | два события одного job_id, один готовый набор вариантов | +| Crop/WebP, metadata/download/access | Все сценарии ready | Реальные JPEG 128×128 и WebP 320×200 fixture; размеры, MIME, SHA, отсутствие EXIF и доступ участников | +| DB atomicity и bounded retry | test_reliability.sh | ошибка INSERT outbox откатывает attachment/job; attempts 1..6, backoff/jitter/due и final failed | +| Replay/DLQ register | test_reliability.sh | повреждённый source не replay; audit, attempt 7, старое событие не повторяет эффект, ready replay отказан | +| Crash до ACK, stuck processing | test_reliability.sh | SIGKILL после S3 и watchdog: восстановление pending, тот же эффект | +| Ограниченная конкуренция/идемпотентность | test_reliability.sh | 2 worker на дублях, 2 API-публикатора на outbox, без второго набора вариантов | +| GC и retention | test_reliability.sh | ready/orphan/expired failed удаляются, queued/live presigned и PUT→COMMIT защищены | +| Память | test_reliability.sh | RGB PNG 8000×5000 обработан при 512 MiB без swap; это не измерение RSS всех возможных форматов | +| Публичный API | Завершение каждого shell-теста | Неизменённый tests/smoke.py проходит | +| Схемы | make check validate | Offline structure и полная OpenAPI 3.1 / JSON Schema validation проходят | -## Эксперименты и отказы +Сводка полного прогона: [evidence/async-suite.json](evidence/async-suite.json). +Финальный прогон 15.11.2026 (Europe/Moscow): Python 3.14.4, Pillow 12.1.1, +18 групп проверок, 121.048 s вместе с запуском/удалением стенда. +Cleanup контейнеров, volumes, сети и disposable credentials отдельно подтверждён. +Отдельный upload-прогон со сборкой: [evidence/upload-async.json](evidence/upload-async.json). +Геометрия/EXIF/alpha отдельно проверяются `test_thumbnail.py` и `test_variants.py`; +команды и зависимости — в student-tests/README.md. -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +## Методика и ограничения -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +Проверки функциональные, не нагрузочный эксперимент. Основной fixture — +320×200 PNG, 111817 bytes, SHA-256 из tests/fixtures/README.md. Memory fixture — +один синтетический 8-bit RGB PNG 40 млн пикселей. По умолчанию worker serial, +для дублей временно запущены 2 процесса; неограниченного prefetch нет. +В тестовом override API получает 512 MiB/1 CPU, timeout worker — 3 s, +retry base/max — 200/800 ms, GC — 1 s; рабочие defaults сохранены в Compose. +Фактические image IDs/лимиты и elapsed test run находятся в JSON evidence. +RPS, p50/p95/p99 и статистический memory benchmark не измерялись. -## Ограничения и следующие шаги +Не выдерживается потеря DB/S3/брокер volumes или самого единственного хоста; +это не HA-кластер. Сессии Redis при остановке общего Valkey недоступны, поэтому +outbox fault-tests используют PostgreSQL-сессии. При выключенных API-публикаторах +outbox/retry остаётся durable, но не публикуется до запуска API. Рабочий стенд +учебный HTTP; lab7 TLS и rate limiting сюда не входят. +Готовые записи предыдущих шагов сохраняют прежние варианты; обновление pipeline +не откатывает ready автоматически. Публикация кода/commit/PR не выполнялась. -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +## Уровень 5: трек 2 + +Гипотеза, инварианты, модель отказов, алгоритм защиты и границы результата: +[infra/track2.md](infra/track2.md). Для v1/v2 используются раздельные S3 namespaces, +unique jobs/results на attachment/version и повторная проверка desired version +под row lock перед переключением published pointer. Source/recipe захвачены из job; +carrier не может подменить версию записи БД. Legacy storage keys продолжают читаться. + +```sh +make test-track2 PYTHON=.venv/bin/python \ + TEST_ARGS="--output evidence/track2.json" +# Повтор уже собранного неизменённого кода: +make test-track2 PYTHON=.venv/bin/python \ + TEST_ARGS="--no-build --repetitions 3 --output evidence/track2.json" +``` + +Исследование использует три независимых холодных Compose-стенда и фиксированную +матрицу доставок/отказов. Каждый повтор включает 16 валидных uploads, 27 логических +jobs для версий 1/2 и проверки результатов после рестарта PostgreSQL/Valkey/MinIO/API. +Четыре crash points выполняются для обеих версий. Отдельно старый worker +останавливается до эффекта, после эффекта и после COMMIT; v2 завершается на втором +worker, затем тот же старый процесс возобновляется. Сравниваются actual S3 SHA, +метаданные, version pointer, PK counts и terminal states всех committed intents. + +Сводка итоговых повторов: [evidence/track2.json](evidence/track2.json). +В ней хранятся source/method SHA, image IDs, фактические Docker die exit codes, +хеши versioned объектов, результаты инвариантов и время каждого повтора. +Измерения RPS/p95/RSS не заявляются: это выбранный трек идемпотентности. + +| Повтор | Проверки | Attachments / jobs | Время со стендом, s | Итог | +| --- | --- | --- | --- | --- | +| 1 | 20 | 16 / 27 | 187.385 | PASS | +| 2 | 20 | 16 / 27 | 185.107 | PASS | +| 3 | 20 | 16 / 27 | 187.243 | PASS | + +Итог 15.11.2026 (Europe/Moscow): 48 принятых вложений, 81 committed job, +24 подтверждённых crash с exit code 86 и 9 возобновлений старого процесса после +публикации v2. Потерянных вложений, незавершённых jobs и дублей result rows — 0; +новый снимок не изменился после поздней работы v1. Все три стенда и их credentials +удалены. Гипотеза подтверждена в описанной модели отказов; исчерпывающий перебор +распределённых расписаний не выполнялся. + +Exactly-once доставка не заявляется: XADD/PUT могут повторяться после crash. +Защищён один логический результат `(attachment_id,pipeline_version,variant)` и +монотонное переключение опубликованного снимка. Изоляция ключей защищает bytes +v2 от поздних PUT v1; CAS защищает DB pointer от позднего COMMIT v1. Исторические +versioned outputs сохраняются, их retention пока не задан. Два HTTP-запроса +по versionless endpoint вокруг upgrade могут увидеть разные published snapshots; +обязательный API не расширен новым version-download контрактом. + +## Источники и библиотеки + +- [Контракт и состояния](contracts/README.md), [attachment-states](contracts/attachment-states.md), [jobs schema](contracts/jobs.schema.json). +- [minio-cpp v0.3.0](https://github.com/minio/minio-cpp/tree/v0.3.0), [hiredis](https://github.com/redis/hiredis), [libpqxx](https://github.com/jtv/libpqxx). +- [stb, закреплённый commit](https://github.com/nothings/stb/tree/013ac3beddff3dbffafd5177e7972067cd2b5083), [libwebp](https://github.com/webmproject/libwebp), [libexif](https://github.com/libexif/libexif). +- libsodium — KDF/сессии/контрольные суммы; Pillow — независимое декодирование в тестах. Код lab4 перенесён из соседнего репозитория diff --git a/cmake/ImportMinioDeps.cmake b/cmake/ImportMinioDeps.cmake new file mode 100644 index 00000000..7128a484 --- /dev/null +++ b/cmake/ImportMinioDeps.cmake @@ -0,0 +1,55 @@ +# Provide the imported target names expected by minio-cpp's CMakeLists +# (unofficial-curlpp / unofficial-inih) using system packages from apt. + +find_package(OpenSSL REQUIRED) +find_package(ZLIB REQUIRED) +find_package(CURL REQUIRED) + +# nlohmann_json (header-only; Ubuntu ships /usr/include/nlohmann/json.hpp) +if(NOT TARGET nlohmann_json::nlohmann_json) + find_package(nlohmann_json QUIET CONFIG) +endif() +if(NOT TARGET nlohmann_json::nlohmann_json) + add_library(nlohmann_json INTERFACE) + add_library(nlohmann_json::nlohmann_json ALIAS nlohmann_json) + find_path(NLOHMANN_JSON_INCLUDE_DIR nlohmann/json.hpp) + if(NOT NLOHMANN_JSON_INCLUDE_DIR) + message(FATAL_ERROR "nlohmann/json.hpp not found (install nlohmann-json3-dev)") + endif() + target_include_directories(nlohmann_json INTERFACE "${NLOHMANN_JSON_INCLUDE_DIR}") +endif() + +# pugixml +if(NOT TARGET pugixml) + find_package(pugixml QUIET CONFIG) +endif() +if(NOT TARGET pugixml AND NOT TARGET pugixml::pugixml) + pkg_check_modules(PUGIXML REQUIRED IMPORTED_TARGET pugixml) + add_library(pugixml INTERFACE) + target_link_libraries(pugixml INTERFACE PkgConfig::PUGIXML) +endif() +if(TARGET pugixml::pugixml AND NOT TARGET pugixml) + add_library(pugixml ALIAS pugixml::pugixml) +endif() + +# curlpp → unofficial::curlpp::curlpp +if(NOT TARGET unofficial::curlpp::curlpp) + find_library(CURLPP_LIBRARY NAMES curlpp REQUIRED) + find_path(CURLPP_INCLUDE_DIR curlpp/cURLpp.hpp REQUIRED) + add_library(unofficial_curlpp INTERFACE) + target_include_directories(unofficial_curlpp INTERFACE "${CURLPP_INCLUDE_DIR}") + target_link_libraries(unofficial_curlpp INTERFACE "${CURLPP_LIBRARY}" CURL::libcurl) + add_library(unofficial::curlpp::curlpp ALIAS unofficial_curlpp) +endif() + +# inih INIReader → unofficial::inih::inireader +if(NOT TARGET unofficial::inih::inireader) + find_library(INIREADER_LIBRARY NAMES INIReader REQUIRED) + find_library(INIH_LIBRARY NAMES inih REQUIRED) + find_path(INIREADER_INCLUDE_DIR INIReader.h REQUIRED) + add_library(unofficial_inih_inireader INTERFACE) + target_include_directories(unofficial_inih_inireader INTERFACE "${INIREADER_INCLUDE_DIR}") + target_link_libraries(unofficial_inih_inireader INTERFACE + "${INIREADER_LIBRARY}" "${INIH_LIBRARY}") + add_library(unofficial::inih::inireader ALIAS unofficial_inih_inireader) +endif() diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..61db7e94 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,273 @@ +services: + db: + image: postgres:16.15-alpine + command: postgres -c max_connections=200 -c shared_buffers=256MB + environment: + POSTGRES_USER: ${POSTGRES_USER} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} + POSTGRES_DB: ${POSTGRES_DB} + volumes: + - pgdata:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"] + interval: 5s + timeout: 3s + retries: 20 + start_period: 10s + cpus: ${DB_CPU_LIMIT:-1.0} + mem_limit: 512m + stop_grace_period: 20s + + cache: + image: valkey/valkey:8.1.10-alpine + command: ["valkey-server", "--appendonly", "yes", "--appendfsync", "always"] + volumes: + - valkeydata:/data + healthcheck: + test: ["CMD", "valkey-cli", "ping"] + interval: 5s + timeout: 3s + retries: 20 + start_period: 5s + cpus: "0.50" + mem_limit: 256m + stop_grace_period: 15s + + api: &api + build: . + image: mtusi2026lab5-api:local + depends_on: + db: + condition: service_healthy + cache: + condition: service_healthy + minio: + condition: service_healthy + minio-user-init: + condition: service_completed_successfully + environment: + APP_HOST: 0.0.0.0 + APP_PORT: "8080" + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + SESSION_STORE: ${SESSION_STORE:-redis} + DATABASE_URL_FILE: /run/secrets/database_url + CACHE_URL_FILE: /run/secrets/cache_url + BROKER_URL_FILE: /run/secrets/cache_url + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + DRAIN_SECONDS: ${DRAIN_SECONDS:-2} + HTTP_WORKERS: ${HTTP_WORKERS:-8} + DB_POOL_SIZE: ${DB_POOL_SIZE:-8} + S3_ENDPOINT: ${S3_ENDPOINT:-http://minio:9000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET} + S3_ACCESS_KEY_ID_FILE: /run/secrets/s3_access_key_id + S3_SECRET_ACCESS_KEY_FILE: /run/secrets/s3_secret_access_key + MAX_UPLOAD_BYTES: ${MAX_UPLOAD_BYTES:-10485760} + MAX_IMAGE_PIXELS: ${MAX_IMAGE_PIXELS:-40000000} + MAX_CONCURRENT_UPLOADS: ${MAX_CONCURRENT_UPLOADS:-3} + DIRECT_UPLOAD_TTL_SECONDS: ${DIRECT_UPLOAD_TTL_SECONDS:-300} + # Optional: sign URLs for a host-reachable MinIO (compose.presign.yaml). + S3_PRESIGN_ENDPOINT: ${S3_PRESIGN_ENDPOINT:-} + secrets: + - database_url + - cache_url + - s3_access_key_id + - s3_secret_access_key + healthcheck: + test: ["CMD", "curl", "-fsS", "http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 20s + deploy: + replicas: ${API_REPLICAS:-2} + resources: + limits: + cpus: ${API_CPU_LIMIT:-0.50} + memory: ${API_MEM_LIMIT:-256m} + cpus: ${API_CPU_LIMIT:-0.50} # для совместимости с docker compose up + mem_limit: ${API_MEM_LIMIT:-256m} + stop_grace_period: 15s + + worker: + <<: *api + # Keep the shared entrypoint: it stages secrets and drops root privileges. + entrypoint: ["/docker-entrypoint.sh", "/app/worker"] + command: [] + restart: unless-stopped + environment: + DATABASE_URL_FILE: /run/secrets/database_url + BROKER_URL_FILE: /run/secrets/cache_url + S3_ENDPOINT: ${S3_ENDPOINT:-http://minio:9000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET} + S3_ACCESS_KEY_ID_FILE: /run/secrets/s3_access_key_id + S3_SECRET_ACCESS_KEY_FILE: /run/secrets/s3_secret_access_key + JOB_MAX_ATTEMPTS: ${JOB_MAX_ATTEMPTS:-6} + JOB_RECLAIM_IDLE_MS: ${JOB_RECLAIM_IDLE_MS:-5000} + JOB_RETRY_BASE_MS: ${JOB_RETRY_BASE_MS:-1000} + JOB_RETRY_MAX_MS: ${JOB_RETRY_MAX_MS:-60000} + JOB_TIMEOUT_SECONDS: ${JOB_TIMEOUT_SECONDS:-60} + STAGING_RETENTION_SECONDS: ${STAGING_RETENTION_SECONDS:-86400} + STAGING_CLEANUP_INTERVAL_SECONDS: ${STAGING_CLEANUP_INTERVAL_SECONDS:-60} + healthcheck: + disable: true + deploy: + replicas: 1 + resources: + limits: + cpus: "0.50" + memory: 512m + cpus: "0.50" + mem_limit: 512m + + lb: + image: nginx:1.28.0-alpine + depends_on: + api: + condition: service_healthy + ports: + - "8080:8080" + environment: + NGINX_WORKERS: ${NGINX_WORKERS:-1} + NGINX_ENVSUBST_TEMPLATE_DIR: /etc/nginx/templates + NGINX_ENVSUBST_OUTPUT_DIR: /etc/nginx + NGINX_ENVSUBST_FILTER: "^NGINX_" + volumes: + - ./lb/nginx.conf.template:/etc/nginx/templates/nginx.conf.template:ro + healthcheck: + test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 10s + cpus: ${LB_CPU_LIMIT:-0.25} + mem_limit: 128m + stop_grace_period: 10s + + # Private S3-compatible store. Ports 9000/9001 are NOT published to the host. + # Image: pinned MinIO RELEASE.2025-04-22T22-12-26Z via local Dockerfile + # (official binary from GitHub; docker.io hub may be unreachable). + minio: + build: + context: ./infra/minio + args: + MINIO_VERSION: RELEASE.2025-04-22T22-12-26Z + image: mtusi2026lab5-minio:RELEASE.2025-04-22T22-12-26Z + command: ["server", "/data", "--console-address", ":9001"] + environment: + MINIO_ROOT_USER: ${MINIO_ROOT_USER} + MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD} + volumes: + - miniodata:/data + healthcheck: + test: ["CMD", "curl", "-f", "http://127.0.0.1:9000/minio/health/live"] + interval: 5s + timeout: 5s + retries: 20 + start_period: 15s + cpus: ${MINIO_CPU_LIMIT:-0.50} + mem_limit: ${MINIO_MEM_LIMIT:-512m} + stop_grace_period: 15s + + # Idempotent bucket bootstrap: create if missing, force private ACL. + minio-init: + build: + context: ./infra/mc + args: + MC_VERSION: RELEASE.2025-04-16T18-13-26Z + image: mtusi2026lab5-mc:RELEASE.2025-04-16T18-13-26Z + depends_on: + minio: + condition: service_healthy + environment: + MINIO_ROOT_USER: ${MINIO_ROOT_USER} + MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD} + S3_BUCKET: ${S3_BUCKET} + S3_ENDPOINT: ${S3_ENDPOINT:-http://minio:9000} + entrypoint: ["/bin/sh", "-c"] + command: + - | + set -eu + echo "minio-init: waiting for endpoint $$S3_ENDPOINT" + i=0 + until mc alias set local "$$S3_ENDPOINT" "$$MINIO_ROOT_USER" "$$MINIO_ROOT_PASSWORD" >/dev/null 2>&1; do + i=$$((i + 1)) + if [ "$$i" -ge 30 ]; then + echo "minio-init: cannot reach MinIO" >&2 + exit 1 + fi + sleep 1 + done + mc mb --ignore-existing "local/$$S3_BUCKET" + mc anonymous set none "local/$$S3_BUCKET" + echo "minio-init: bucket listing:" + mc ls "local/$$S3_BUCKET" || true + echo "minio-init: bucket $$S3_BUCKET ready (anonymous=none)" + restart: "no" + + # Idempotent limited S3 user for the API (not MinIO root). + minio-user-init: + image: mtusi2026lab5-mc:RELEASE.2025-04-16T18-13-26Z + depends_on: + minio: + condition: service_healthy + minio-init: + condition: service_completed_successfully + environment: + MINIO_ROOT_USER: ${MINIO_ROOT_USER} + MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD} + MINIO_USER_ACCESS_KEY: ${MINIO_USER_ACCESS_KEY} + MINIO_USER_SECRET_KEY: ${MINIO_USER_SECRET_KEY} + S3_BUCKET: ${S3_BUCKET} + S3_ENDPOINT: ${S3_ENDPOINT:-http://minio:9000} + POLICY_NAME: messenger-attachments-rw + volumes: + - ./infra/minio/policy-attachments.json:/policy.template.json:ro + entrypoint: ["/bin/sh", "-c"] + command: + - | + set -eu + echo "minio-user-init: alias $$S3_ENDPOINT" + i=0 + until mc alias set local "$$S3_ENDPOINT" "$$MINIO_ROOT_USER" "$$MINIO_ROOT_PASSWORD" >/dev/null 2>&1; do + i=$$((i + 1)) + if [ "$$i" -ge 30 ]; then + echo "minio-user-init: cannot reach MinIO" >&2 + exit 1 + fi + sleep 1 + done + + sed "s/__S3_BUCKET__/$$S3_BUCKET/g" /policy.template.json > /tmp/policy.json + + if mc admin policy info local "$$POLICY_NAME" >/dev/null 2>&1; then + mc admin policy remove local "$$POLICY_NAME" >/dev/null 2>&1 || true + fi + mc admin policy create local "$$POLICY_NAME" /tmp/policy.json + + if mc admin user info local "$$MINIO_USER_ACCESS_KEY" >/dev/null 2>&1; then + echo "minio-user-init: user $$MINIO_USER_ACCESS_KEY already exists" + else + mc admin user add local "$$MINIO_USER_ACCESS_KEY" "$$MINIO_USER_SECRET_KEY" + echo "minio-user-init: user $$MINIO_USER_ACCESS_KEY created" + fi + + mc admin policy attach local "$$POLICY_NAME" --user "$$MINIO_USER_ACCESS_KEY" >/dev/null 2>&1 || true + echo "minio-user-init: policy $$POLICY_NAME attached to $$MINIO_USER_ACCESS_KEY" + restart: "no" + +secrets: + database_url: + file: ./secrets/database_url + cache_url: + file: ./secrets/cache_url + s3_access_key_id: + file: ./secrets/s3_access_key_id + s3_secret_access_key: + file: ./secrets/s3_secret_access_key + +volumes: + pgdata: {} + valkeydata: {} + miniodata: {} diff --git a/docker-entrypoint.sh b/docker-entrypoint.sh new file mode 100644 index 00000000..55567ef2 --- /dev/null +++ b/docker-entrypoint.sh @@ -0,0 +1,19 @@ +#!/bin/sh +set -eu +# Docker Compose file-secrets keep host mode bits; app runs as uid 10001. +# Copy S3 credentials into an app-owned path before dropping privileges. +if [ "$(id -u)" = "0" ]; then + mkdir -p /tmp/app-secrets + if [ -r /run/secrets/s3_access_key_id ]; then + cp /run/secrets/s3_access_key_id /tmp/app-secrets/s3_access_key_id + fi + if [ -r /run/secrets/s3_secret_access_key ]; then + cp /run/secrets/s3_secret_access_key /tmp/app-secrets/s3_secret_access_key + fi + chown -R 10001:10001 /tmp/app-secrets + chmod 0400 /tmp/app-secrets/* 2>/dev/null || true + export S3_ACCESS_KEY_ID_FILE=/tmp/app-secrets/s3_access_key_id + export S3_SECRET_ACCESS_KEY_FILE=/tmp/app-secrets/s3_secret_access_key + exec setpriv --reuid=10001 --regid=10001 --clear-groups -- "$@" +fi +exec "$@" diff --git a/evidence/README.md b/evidence/README.md index 8df70015..d052639e 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -3,3 +3,33 @@ Храните небольшие обезличенные результаты: команды и stdout проверок, JSON/CSV агрегатов нагрузки, EXPLAIN, dashboard JSON, текст разбора отказа. Укажите дату, commit, аппаратные лимиты и профиль нагрузки. Не добавляйте .env, session tokens, cookies, приватные ключи, credentials, реальные сообщения, raw dumps и signed URLs. Для скриншотов скрывайте секреты. Большие логи/бинарные traces сохраняйте отдельно по правилам преподавателя; одного скриншота без методики недостаточно. + +## Lab5: итоговый функциональный прогон + +- [async-suite.json](async-suite.json): `make test-async PYTHON=build/.venv/bin/python TEST_ARGS="--no-build --output evidence/async-suite.json"`. +- Результат: PASS, 18 групп проверок, 121.048 s (подъём и удаление стенда включены), Python 3.14.4, Pillow 12.1.1. +- JSON фиксирует source SHA-256, image/container IDs, StartedAt/volumes до и после рестартов, лимиты и наблюдения fault-tests. +- [upload-async.json](upload-async.json): отдельный успешный запуск shell-теста с предварительной сборкой образов. + +Методика, профиль и ограничения: [REPORT.md](../REPORT.md) и +[student-tests/README.md](../student-tests/README.md). Это функциональные проверки; +нагрузочные перцентили не измерялись. Трек 2 уровня 5 проверен отдельно ниже. Credentials и +ресурсы disposable-проектов удалены после проверок. + +## Уровень 5: трек 2 + +[track2.json](track2.json): три независимых повтора, по 20 групп проверок — PASS. +Время со стартом/удалением стенда: 187.385 / 185.107 / 187.243 s. +Всего 48 принятых attachments, 81 committed job, 24 реальных crash с exit code 86, +9 возобновлений старого worker после публикации v2. Потерь, незавершённых jobs, +дублей логических результатов и перезаписей v2 старой версией не обнаружено. +Методика и ограничения: [infra/track2.md](../infra/track2.md). JSON содержит source +и method SHA-256, image IDs, object SHA и фактические коды падений. + +```sh +make test-track2 PYTHON=build/.venv/bin/python \ + TEST_ARGS="--no-build --repetitions 3 --output evidence/track2.json" +``` + +Три изолированных проекта и их credentials удалены. Гарантия касается +логического versioned результата: физические XADD/PUT могут повторяться. diff --git a/evidence/async-suite.json b/evidence/async-suite.json new file mode 100644 index 00000000..1a33bdd2 --- /dev/null +++ b/evidence/async-suite.json @@ -0,0 +1,313 @@ +{ + "scenario": "all", + "project": "lab5teste6c77bd21515", + "source_sha256": "60094f93be259bc3b3f6d6ec922dbdfbcb126f7587b1ba8e77158ce52b9c4795", + "python": "3.14.4", + "pillow": "12.1.1", + "started_at": "2026-11-14T23:17:29.320266+00:00", + "passed": true, + "cleanup": "removed own project and volumes; disposable secrets deleted", + "events": [ + { + "check": "isolated stack started", + "project": "lab5teste6c77bd21515", + "containers": { + "api": [ + { + "id": "004a042f3938ea83bb36133ac530ce3f35494bda8f5a5747edfc173bb8bae7cd", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:17:37.538664566Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "worker": [ + { + "id": "efe87e1c4e29124cb99105a8e252d8e9882bfd0b3f3fa0617d35e549fd0e5ba9", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:17:37.325636872Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "6be56781aef8cca2c9edbeaef847ea0a5220245cca7842b8c02652082fc3ee0d", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:17:30.462343085Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_pgdata" + ] + } + ], + "cache": [ + { + "id": "f562a69df006bdee697532eaed6a944d0193b4094ba0ff40f832226aefaa1c42", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:17:30.261027338Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5teste6c77bd21515_valkeydata" + ] + } + ], + "minio": [ + { + "id": "3411bb6744c61e30770404239ac3e62f935db50c38959fd6ba913c62ee8019cc", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:17:30.054292532Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_miniodata" + ] + } + ] + } + }, + { + "check": "upload 202 -> GET queued -> ready, original and 3 variants verified", + "attachment_id": "81cc30ca-4c28-4453-8eb5-c8959785a113" + }, + { + "check": "worker down: accepted job/session survive API, PostgreSQL, Valkey and S3 restart", + "attachment_id": "d5ec1997-a35d-426e-8fde-607333c2609a", + "before": { + "api": [ + { + "id": "004a042f3938ea83bb36133ac530ce3f35494bda8f5a5747edfc173bb8bae7cd", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:17:37.538664566Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "6be56781aef8cca2c9edbeaef847ea0a5220245cca7842b8c02652082fc3ee0d", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:17:30.462343085Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_pgdata" + ] + } + ], + "cache": [ + { + "id": "f562a69df006bdee697532eaed6a944d0193b4094ba0ff40f832226aefaa1c42", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:17:30.261027338Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5teste6c77bd21515_valkeydata" + ] + } + ], + "minio": [ + { + "id": "3411bb6744c61e30770404239ac3e62f935db50c38959fd6ba913c62ee8019cc", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:17:30.054292532Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_miniodata" + ] + } + ] + }, + "after": { + "api": [ + { + "id": "004a042f3938ea83bb36133ac530ce3f35494bda8f5a5747edfc173bb8bae7cd", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:17:53.593930727Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "6be56781aef8cca2c9edbeaef847ea0a5220245cca7842b8c02652082fc3ee0d", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:17:47.099866146Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_pgdata" + ] + } + ], + "cache": [ + { + "id": "f562a69df006bdee697532eaed6a944d0193b4094ba0ff40f832226aefaa1c42", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:17:47.044747087Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5teste6c77bd21515_valkeydata" + ] + } + ], + "minio": [ + { + "id": "3411bb6744c61e30770404239ac3e62f935db50c38959fd6ba913c62ee8019cc", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:17:47.081708096Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5teste6c77bd21515_miniodata" + ] + } + ] + } + }, + { + "check": "broker down: upload 202 and offline API restart preserve outbox" + }, + { + "check": "crash after COMMIT before XADD: same attachment/job recovers without new POST", + "attachment_id": "715b3027-4756-4425-a170-6329fe19bb2e", + "exit_code": 86 + }, + { + "check": "crash after XADD before published marker: duplicate delivery, one ready effect", + "attachment_id": "bb925d74-c11c-40f8-a4c8-ae26daadb23b", + "stream_deliveries": 2, + "exit_code": 86 + }, + { + "check": "attachment/job/outbox transaction rolls back on outbox INSERT failure" + }, + { + "check": "backoff+jitter persisted, attempts 1..6, no early processing, finite failed", + "delays": [ + { + "attempt": 2, + "delay_ms": 193.0 + }, + { + "attempt": 3, + "delay_ms": 296.0 + }, + { + "attempt": 4, + "delay_ms": 722.0 + }, + { + "attempt": 5, + "delay_ms": 772.0 + }, + { + "attempt": 6, + "delay_ms": 742.0 + } + ] + }, + { + "check": "audited replay verifies SHA, keeps job_id, fences stale events, refuses queued/ready", + "job_id": "b2b5743c-bbd1-40f1-91bc-d663797335f9" + }, + { + "check": "SIGKILL after S3 before COMMIT/ACK: pending recovers the same effect", + "attachment_id": "92851587-7299-4bcd-9be2-33be1ca4b7c8" + }, + { + "check": "watchdog bounds hung processing and Compose restarts worker", + "restart_count_before": 0, + "restart_count_after": 1 + }, + { + "check": "two workers serialize duplicate processing; variants and ready metadata stay unique", + "workers": [ + { + "id": "efe87e1c4e29124cb99105a8e252d8e9882bfd0b3f3fa0617d35e549fd0e5ba9", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:18:52.539090243Z", + "exit_code": 0, + "restart_count": 1, + "memory_limit_bytes": 536870912, + "volumes": [] + }, + { + "id": "879ccd8c40bf96073dc9ff006ecb39c3ee27bb78698b887667505e57de248afe", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:18:56.32044115Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "stream_deliveries": 5 + }, + { + "check": "two API publishers drain outbox with SKIP LOCKED", + "apis": [ + { + "id": "dfb6a357bace91557e4f593f1ad397e0f09fd3675456a174af5997e01f06070d", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:18:20.837454075Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + }, + { + "id": "237addf1f14359024ddd076325a28650d544f2a0bda3de04d705ec16bafec983", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:19:03.201241928Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "jobs": 8 + }, + { + "check": "retention deletes orphan/ready staging, protects queued and live presigned source" + }, + { + "check": "GC/upload race: PUT-before-COMMIT source is protected" + }, + { + "check": "expired failed staging is collected; replay refuses cleaned source" + }, + { + "check": "40M pixel RGB PNG produces three variants with 512 MiB and no swap", + "pixels": 40000000, + "memory_limit_bytes": 536870912, + "swap_bytes": 0 + }, + { + "check": "unchanged lab5 public smoke passed" + } + ], + "elapsed_seconds": 121.048 +} diff --git a/evidence/track2.json b/evidence/track2.json new file mode 100644 index 00000000..1c0744e4 --- /dev/null +++ b/evidence/track2.json @@ -0,0 +1,1311 @@ +{ + "track": 2, + "hypothesis": "at-least-once delivery plus versioned keys and fenced publication preserve one logical result and reject stale publication", + "source_sha256": "60094f93be259bc3b3f6d6ec922dbdfbcb126f7587b1ba8e77158ce52b9c4795", + "method_sha256": "573644f7571e3a26f845a342c2d1261b013ef4694a1236293b283ab316fc2482", + "python": "3.14.4", + "pillow": "12.1.1", + "started_at": "2026-11-14T23:20:06.167428+00:00", + "passed": true, + "trials": [ + { + "number": 1, + "project": "lab5test85cf93474474", + "passed": true, + "cleanup": "own project and credentials removed", + "events": [ + { + "check": "isolated stack started", + "project": "lab5test85cf93474474", + "containers": { + "api": [ + { + "id": "70bc24b53e8a1c0d2b637386780bb8bbecba7eca50a3f6d7fe719bc1214e1096", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:20:15.031796856Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "worker": [ + { + "id": "fa194807f4158ed113fd751a3497f61f4d4512b906f84e00586323485df15bd4", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:20:15.36146595Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "569ea965ad49146b0b8e0773357d5261a91fba327a5288e25703e11963c2a8ea", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:20:07.138829485Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_pgdata" + ] + } + ], + "cache": [ + { + "id": "6241c5b983c6d14d254211870a292e90e06ed2e7c4661a4a706c154595f897d8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:20:06.942983253Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test85cf93474474_valkeydata" + ] + } + ], + "minio": [ + { + "id": "83fa6ad38a2f025586a0481751126716a32bbd393675fac53b6767e6864dc1d7", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:20:07.350760985Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_miniodata" + ] + } + ] + } + }, + { + "check": "track2 legacy migration preserves ready and enforces version/job/result constraints" + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 1, + "job_id": "29298d15-5f60-4de3-a732-cf090801e786", + "attachment_id": "6640406e-beee-4ba9-9368-7bcb0c15cdc1", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6640406e-beee-4ba9-9368-7bcb0c15cdc1/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6640406e-beee-4ba9-9368-7bcb0c15cdc1/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6640406e-beee-4ba9-9368-7bcb0c15cdc1/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6640406e-beee-4ba9-9368-7bcb0c15cdc1/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 1, + "job_id": "3991e7d3-681f-4f95-8418-ff35a1593c58", + "attachment_id": "d45c365c-f0b5-48b5-a2d9-eaeadbd510d2", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/d45c365c-f0b5-48b5-a2d9-eaeadbd510d2/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/d45c365c-f0b5-48b5-a2d9-eaeadbd510d2/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/d45c365c-f0b5-48b5-a2d9-eaeadbd510d2/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/d45c365c-f0b5-48b5-a2d9-eaeadbd510d2/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 1, + "job_id": "d5cb2147-4612-451a-b20d-070ff2586ba8", + "attachment_id": "c8a42cbf-bbfa-42e9-8c79-5a8178542eec", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c8a42cbf-bbfa-42e9-8c79-5a8178542eec/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c8a42cbf-bbfa-42e9-8c79-5a8178542eec/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c8a42cbf-bbfa-42e9-8c79-5a8178542eec/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c8a42cbf-bbfa-42e9-8c79-5a8178542eec/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 1, + "job_id": "95816ce3-3e61-449a-9c48-7676e5c60b17", + "attachment_id": "dab6747d-9826-404e-a923-4a9f26dd0b75", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/dab6747d-9826-404e-a923-4a9f26dd0b75/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/dab6747d-9826-404e-a923-4a9f26dd0b75/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/dab6747d-9826-404e-a923-4a9f26dd0b75/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/dab6747d-9826-404e-a923-4a9f26dd0b75/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 2, + "job_id": "01592c61-3ea4-4dbc-8004-56f3c9abe4f9", + "attachment_id": "79019721-a806-4ba4-865a-d8271473aad2", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/79019721-a806-4ba4-865a-d8271473aad2/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/79019721-a806-4ba4-865a-d8271473aad2/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/79019721-a806-4ba4-865a-d8271473aad2/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/79019721-a806-4ba4-865a-d8271473aad2/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 2, + "job_id": "5bfac65c-eb1d-4f18-82d3-fd5a9f673a27", + "attachment_id": "66c241ae-4387-4d31-ab94-e4695f9df6a4", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/66c241ae-4387-4d31-ab94-e4695f9df6a4/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/66c241ae-4387-4d31-ab94-e4695f9df6a4/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/66c241ae-4387-4d31-ab94-e4695f9df6a4/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/66c241ae-4387-4d31-ab94-e4695f9df6a4/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 2, + "job_id": "6aedbf7d-75ec-49bb-ba1d-bd363ba50744", + "attachment_id": "b5a13730-8829-44de-8d42-28d1232cedda", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b5a13730-8829-44de-8d42-28d1232cedda/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b5a13730-8829-44de-8d42-28d1232cedda/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b5a13730-8829-44de-8d42-28d1232cedda/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b5a13730-8829-44de-8d42-28d1232cedda/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 2, + "job_id": "4f097e28-27e3-4d59-b0d7-4fb4da0f81c2", + "attachment_id": "35492af9-e021-422f-bf3b-4b4c00a0271f", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/35492af9-e021-422f-bf3b-4b4c00a0271f/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/35492af9-e021-422f-bf3b-4b4c00a0271f/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/35492af9-e021-422f-bf3b-4b4c00a0271f/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/35492af9-e021-422f-bf3b-4b4c00a0271f/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 duplicate delivery", + "deliveries": 5, + "logical_results": 1, + "objects": 4, + "attachment_id": "1507ed8b-1f7a-4497-90ef-fac65d10e43a", + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/1507ed8b-1f7a-4497-90ef-fac65d10e43a/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/1507ed8b-1f7a-4497-90ef-fac65d10e43a/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/1507ed8b-1f7a-4497-90ef-fac65d10e43a/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/1507ed8b-1f7a-4497-90ef-fac65d10e43a/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 1, + 2, + 1, + 2 + ], + "attachment_id": "b6197a0c-5566-413c-b95b-1c5733e5f9b0", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b6197a0c-5566-413c-b95b-1c5733e5f9b0/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b6197a0c-5566-413c-b95b-1c5733e5f9b0/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b6197a0c-5566-413c-b95b-1c5733e5f9b0/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/b6197a0c-5566-413c-b95b-1c5733e5f9b0/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 2, + 1, + 2, + 1 + ], + "attachment_id": "c72bdb23-fdc1-4427-80ee-7231eebbe2f9", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c72bdb23-fdc1-4427-80ee-7231eebbe2f9/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c72bdb23-fdc1-4427-80ee-7231eebbe2f9/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c72bdb23-fdc1-4427-80ee-7231eebbe2f9/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/c72bdb23-fdc1-4427-80ee-7231eebbe2f9/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 old ready job after new version", + "attachment_id": "6db048b8-f5fc-455a-b0df-85d369abdbc6", + "published_version": 2, + "old_result_unchanged": true, + "new_result_unchanged": true, + "upgrade_requests": 1, + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6db048b8-f5fc-455a-b0df-85d369abdbc6/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6db048b8-f5fc-455a-b0df-85d369abdbc6/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6db048b8-f5fc-455a-b0df-85d369abdbc6/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/6db048b8-f5fc-455a-b0df-85d369abdbc6/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_before_effect", + "attachment_id": "175be5c7-028d-402f-9175-d2986f624acc", + "old_job": "ac4e325d-a2f2-48ed-bc6c-14d21fef49e9", + "new_job": "b43d036a-b2e4-468c-8988-3d69084cce66", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/175be5c7-028d-402f-9175-d2986f624acc/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/175be5c7-028d-402f-9175-d2986f624acc/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/175be5c7-028d-402f-9175-d2986f624acc/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/175be5c7-028d-402f-9175-d2986f624acc/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_effect", + "attachment_id": "84016685-f5f9-4311-a607-8fc56394250a", + "old_job": "8fb8e4ce-b282-46e5-8135-9c6d73e1187d", + "new_job": "5a664147-4b3b-4571-8668-09998569e4f8", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/84016685-f5f9-4311-a607-8fc56394250a/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/84016685-f5f9-4311-a607-8fc56394250a/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/84016685-f5f9-4311-a607-8fc56394250a/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/84016685-f5f9-4311-a607-8fc56394250a/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_commit", + "attachment_id": "3f1b71c8-e8ac-4f56-b9e3-c98dd7e0ae6b", + "old_job": "11966c8d-76c9-4113-affa-347919a938d9", + "new_job": "a71ceff0-7c46-4ae7-bd97-deb5bcbc6122", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "ready", + "object_hashes": { + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/3f1b71c8-e8ac-4f56-b9e3-c98dd7e0ae6b/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/3f1b71c8-e8ac-4f56-b9e3-c98dd7e0ae6b/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/3f1b71c8-e8ac-4f56-b9e3-c98dd7e0ae6b/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/57ca1703-0421-437f-a1c4-9e55f14ecf68/3f1b71c8-e8ac-4f56-b9e3-c98dd7e0ae6b/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 failed upgrade preserves v1; explicit replay publishes v2", + "attachment_id": "5bada000-f8a4-499d-af31-35489ce88186", + "job_id": "031ea669-7a23-46bd-b923-e5958d82fb7f" + }, + { + "check": "track2 invariants survive persistent-store restart", + "accepted_attachments": 16, + "committed_jobs": 27, + "lost_attachments": 0, + "unfinished_jobs": 0, + "duplicate_results": 0, + "snapshots_unchanged": true, + "before": { + "db": [ + { + "id": "569ea965ad49146b0b8e0773357d5261a91fba327a5288e25703e11963c2a8ea", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:20:07.138829485Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_pgdata" + ] + } + ], + "cache": [ + { + "id": "6241c5b983c6d14d254211870a292e90e06ed2e7c4661a4a706c154595f897d8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:22:02.456240911Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test85cf93474474_valkeydata" + ] + } + ], + "minio": [ + { + "id": "83fa6ad38a2f025586a0481751126716a32bbd393675fac53b6767e6864dc1d7", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:20:07.350760985Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_miniodata" + ] + } + ] + }, + "after": { + "db": [ + { + "id": "569ea965ad49146b0b8e0773357d5261a91fba327a5288e25703e11963c2a8ea", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:22:53.530067554Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_pgdata" + ] + } + ], + "cache": [ + { + "id": "6241c5b983c6d14d254211870a292e90e06ed2e7c4661a4a706c154595f897d8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:22:53.48844501Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test85cf93474474_valkeydata" + ] + } + ], + "minio": [ + { + "id": "83fa6ad38a2f025586a0481751126716a32bbd393675fac53b6767e6864dc1d7", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:22:53.513927143Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test85cf93474474_miniodata" + ] + } + ] + } + }, + { + "check": "unchanged lab5 public smoke passed" + } + ], + "elapsed_seconds": 187.385 + }, + { + "number": 2, + "project": "lab5testf2769d1aa0c0", + "passed": true, + "cleanup": "own project and credentials removed", + "events": [ + { + "check": "isolated stack started", + "project": "lab5testf2769d1aa0c0", + "containers": { + "api": [ + { + "id": "f9dc66cfb990fed6eec392ae4cee2402d9a29790a7fad20357805d3a8200dfb3", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:23:22.748513068Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "worker": [ + { + "id": "383e7229a11dd4e1f33537ebe1c6161bc043263cd9365a6bfdbeaa04bafec77e", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:23:22.51629303Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "0d3df4a663ff34a4dab321f698d48b16e5f24f8734e872d6d7c05223b19adeed", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:23:14.584239226Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_pgdata" + ] + } + ], + "cache": [ + { + "id": "f1e1b88b44d235635a61126016a43d296709cc03e85a978d6710cdda2d529af8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:23:14.366621711Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5testf2769d1aa0c0_valkeydata" + ] + } + ], + "minio": [ + { + "id": "c13a6a7516cd69292bd297cb1d5606e872e03c6d5ed9b73f68ab645e9c1ca452", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:23:14.788060789Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_miniodata" + ] + } + ] + } + }, + { + "check": "track2 legacy migration preserves ready and enforces version/job/result constraints" + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 1, + "job_id": "47ba0b08-35ef-4737-8454-0914c31fdb3f", + "attachment_id": "aad8bf1f-ebf6-4056-a423-e442b7216c1e", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/aad8bf1f-ebf6-4056-a423-e442b7216c1e/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/aad8bf1f-ebf6-4056-a423-e442b7216c1e/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/aad8bf1f-ebf6-4056-a423-e442b7216c1e/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/aad8bf1f-ebf6-4056-a423-e442b7216c1e/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 1, + "job_id": "ddfa0288-1d02-44ac-b98b-e520d9adb54a", + "attachment_id": "bc5c5af7-2287-42e2-bd9a-d99868feed88", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/bc5c5af7-2287-42e2-bd9a-d99868feed88/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/bc5c5af7-2287-42e2-bd9a-d99868feed88/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/bc5c5af7-2287-42e2-bd9a-d99868feed88/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/bc5c5af7-2287-42e2-bd9a-d99868feed88/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 1, + "job_id": "7ba95003-e1d0-42e0-8b9c-61db5db34010", + "attachment_id": "fa2d425f-6da1-4e18-bad1-cc8a7da33027", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/fa2d425f-6da1-4e18-bad1-cc8a7da33027/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/fa2d425f-6da1-4e18-bad1-cc8a7da33027/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/fa2d425f-6da1-4e18-bad1-cc8a7da33027/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/fa2d425f-6da1-4e18-bad1-cc8a7da33027/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 1, + "job_id": "016e89ca-70f3-4dd1-8def-a6fe8a9270b9", + "attachment_id": "2d63cf72-cc3a-43b6-b5d1-f509a969634a", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/2d63cf72-cc3a-43b6-b5d1-f509a969634a/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/2d63cf72-cc3a-43b6-b5d1-f509a969634a/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/2d63cf72-cc3a-43b6-b5d1-f509a969634a/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/2d63cf72-cc3a-43b6-b5d1-f509a969634a/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 2, + "job_id": "4009dd34-026b-495e-8cbd-70e73b93d231", + "attachment_id": "af23a70a-76df-4022-a941-4efe06f7686e", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/af23a70a-76df-4022-a941-4efe06f7686e/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/af23a70a-76df-4022-a941-4efe06f7686e/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/af23a70a-76df-4022-a941-4efe06f7686e/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/af23a70a-76df-4022-a941-4efe06f7686e/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 2, + "job_id": "356d465e-b97b-4913-889c-6a9032c77ad3", + "attachment_id": "03f71969-d9cc-4f93-9851-30a952d40b07", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/03f71969-d9cc-4f93-9851-30a952d40b07/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/03f71969-d9cc-4f93-9851-30a952d40b07/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/03f71969-d9cc-4f93-9851-30a952d40b07/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/03f71969-d9cc-4f93-9851-30a952d40b07/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 2, + "job_id": "c774cb9e-7ff5-4bfc-8fd6-33698796be8d", + "attachment_id": "f9a20e5f-e0f5-435d-86b8-8d60368b505a", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/f9a20e5f-e0f5-435d-86b8-8d60368b505a/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/f9a20e5f-e0f5-435d-86b8-8d60368b505a/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/f9a20e5f-e0f5-435d-86b8-8d60368b505a/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/f9a20e5f-e0f5-435d-86b8-8d60368b505a/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 2, + "job_id": "2de67b3f-82ce-4724-bb9f-3de61079140a", + "attachment_id": "c1ea06e2-0052-48e8-904b-033e2fb8c31d", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/c1ea06e2-0052-48e8-904b-033e2fb8c31d/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/c1ea06e2-0052-48e8-904b-033e2fb8c31d/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/c1ea06e2-0052-48e8-904b-033e2fb8c31d/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/c1ea06e2-0052-48e8-904b-033e2fb8c31d/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 duplicate delivery", + "deliveries": 5, + "logical_results": 1, + "objects": 4, + "attachment_id": "0426a2e1-55dc-43a4-ba7c-bd3e23883054", + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/0426a2e1-55dc-43a4-ba7c-bd3e23883054/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/0426a2e1-55dc-43a4-ba7c-bd3e23883054/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/0426a2e1-55dc-43a4-ba7c-bd3e23883054/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/0426a2e1-55dc-43a4-ba7c-bd3e23883054/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 1, + 2, + 1, + 2 + ], + "attachment_id": "ba2f769e-10e1-46c5-a17f-23c5147b6815", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/ba2f769e-10e1-46c5-a17f-23c5147b6815/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/ba2f769e-10e1-46c5-a17f-23c5147b6815/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/ba2f769e-10e1-46c5-a17f-23c5147b6815/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/ba2f769e-10e1-46c5-a17f-23c5147b6815/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 2, + 1, + 2, + 1 + ], + "attachment_id": "b6c962d6-6a6f-405d-b7fb-ef96a2468166", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/b6c962d6-6a6f-405d-b7fb-ef96a2468166/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/b6c962d6-6a6f-405d-b7fb-ef96a2468166/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/b6c962d6-6a6f-405d-b7fb-ef96a2468166/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/b6c962d6-6a6f-405d-b7fb-ef96a2468166/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 old ready job after new version", + "attachment_id": "a6fa193b-90b8-422d-bcaf-71334ac5c2fe", + "published_version": 2, + "old_result_unchanged": true, + "new_result_unchanged": true, + "upgrade_requests": 1, + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a6fa193b-90b8-422d-bcaf-71334ac5c2fe/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a6fa193b-90b8-422d-bcaf-71334ac5c2fe/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a6fa193b-90b8-422d-bcaf-71334ac5c2fe/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a6fa193b-90b8-422d-bcaf-71334ac5c2fe/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_before_effect", + "attachment_id": "a621f16d-4ab0-4e3e-9f79-d05802043b9e", + "old_job": "79c6c497-d159-4ca7-a00b-5f454e20d58b", + "new_job": "8d087f3d-1cf1-4b84-b59b-4e58adfdb6ae", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a621f16d-4ab0-4e3e-9f79-d05802043b9e/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a621f16d-4ab0-4e3e-9f79-d05802043b9e/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a621f16d-4ab0-4e3e-9f79-d05802043b9e/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/a621f16d-4ab0-4e3e-9f79-d05802043b9e/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_effect", + "attachment_id": "9bb19609-de2f-4a92-bc80-39c82208b866", + "old_job": "e5796e3e-65dc-4e22-bc40-dd56c88ed67c", + "new_job": "89e11e4d-cfa1-466f-967a-02fec48cc4eb", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/9bb19609-de2f-4a92-bc80-39c82208b866/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/9bb19609-de2f-4a92-bc80-39c82208b866/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/9bb19609-de2f-4a92-bc80-39c82208b866/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/9bb19609-de2f-4a92-bc80-39c82208b866/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_commit", + "attachment_id": "1010bd1a-602a-4e42-81fe-f250fca6dd3c", + "old_job": "e10a2c90-3cd2-41cd-9033-5b0a28e9de51", + "new_job": "41f3cbe5-5e47-44d0-b347-d464c99fa7ff", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "ready", + "object_hashes": { + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/1010bd1a-602a-4e42-81fe-f250fca6dd3c/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/1010bd1a-602a-4e42-81fe-f250fca6dd3c/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/1010bd1a-602a-4e42-81fe-f250fca6dd3c/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/55375de9-7d6b-4987-aa5c-8fea40b12516/1010bd1a-602a-4e42-81fe-f250fca6dd3c/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 failed upgrade preserves v1; explicit replay publishes v2", + "attachment_id": "417c4f2e-4c92-414f-8d01-351d7aac5af1", + "job_id": "aff9c406-72df-4316-8c24-661068a7141c" + }, + { + "check": "track2 invariants survive persistent-store restart", + "accepted_attachments": 16, + "committed_jobs": 27, + "lost_attachments": 0, + "unfinished_jobs": 0, + "duplicate_results": 0, + "snapshots_unchanged": true, + "before": { + "db": [ + { + "id": "0d3df4a663ff34a4dab321f698d48b16e5f24f8734e872d6d7c05223b19adeed", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:23:14.584239226Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_pgdata" + ] + } + ], + "cache": [ + { + "id": "f1e1b88b44d235635a61126016a43d296709cc03e85a978d6710cdda2d529af8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:25:08.241809224Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5testf2769d1aa0c0_valkeydata" + ] + } + ], + "minio": [ + { + "id": "c13a6a7516cd69292bd297cb1d5606e872e03c6d5ed9b73f68ab645e9c1ca452", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:23:14.788060789Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_miniodata" + ] + } + ] + }, + "after": { + "db": [ + { + "id": "0d3df4a663ff34a4dab321f698d48b16e5f24f8734e872d6d7c05223b19adeed", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:25:59.158550135Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_pgdata" + ] + } + ], + "cache": [ + { + "id": "f1e1b88b44d235635a61126016a43d296709cc03e85a978d6710cdda2d529af8", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:25:59.171162552Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5testf2769d1aa0c0_valkeydata" + ] + } + ], + "minio": [ + { + "id": "c13a6a7516cd69292bd297cb1d5606e872e03c6d5ed9b73f68ab645e9c1ca452", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:25:59.196369388Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5testf2769d1aa0c0_miniodata" + ] + } + ] + } + }, + { + "check": "unchanged lab5 public smoke passed" + } + ], + "elapsed_seconds": 185.107 + }, + { + "number": 3, + "project": "lab5test5d62c41113aa", + "passed": true, + "cleanup": "own project and credentials removed", + "events": [ + { + "check": "isolated stack started", + "project": "lab5test5d62c41113aa", + "containers": { + "api": [ + { + "id": "26b721fe2b899835bfc09b6a6995f53c2abb69aad6e6bff00b996eca04ac3618", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:26:27.391183111Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "worker": [ + { + "id": "5d8c93569da2afc275f440eca530c28abf00fed478ee324e1f94aa35a9ab9d62", + "image": "sha256:301ec25bc35502f8e47d845720acad46ef5d19a206b568457df08d6d42ca2a47", + "started_at": "2026-11-14T23:26:27.156949562Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [] + } + ], + "db": [ + { + "id": "eb65983952e31a71f4ff5b7ec9c7f5a23ec86e13e44215b22c6b9b474d0ba5a2", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:26:19.443746867Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_pgdata" + ] + } + ], + "cache": [ + { + "id": "5e873fcc822e9fda617f71bbb07df88844d2c5313a218444441d446d1d39f0a1", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:26:19.640661177Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test5d62c41113aa_valkeydata" + ] + } + ], + "minio": [ + { + "id": "b3c6e9bcba98af2c26cdc5c57bc34204b9cfa6a8822eb01805ff178a82bc1525", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:26:19.837209173Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_miniodata" + ] + } + ] + } + }, + { + "check": "track2 legacy migration preserves ready and enforces version/job/result constraints" + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 1, + "job_id": "887f95c0-f066-48f0-8a4a-3a277b5bfbb0", + "attachment_id": "b37dfb94-95f9-44dc-a40f-b388106dd067", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b37dfb94-95f9-44dc-a40f-b388106dd067/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b37dfb94-95f9-44dc-a40f-b388106dd067/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b37dfb94-95f9-44dc-a40f-b388106dd067/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b37dfb94-95f9-44dc-a40f-b388106dd067/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 1, + "job_id": "aba12f6a-38df-4eb1-a38b-662183741b2f", + "attachment_id": "cf219f6f-7e00-4190-978b-00a6ac57bd40", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/cf219f6f-7e00-4190-978b-00a6ac57bd40/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/cf219f6f-7e00-4190-978b-00a6ac57bd40/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/cf219f6f-7e00-4190-978b-00a6ac57bd40/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/cf219f6f-7e00-4190-978b-00a6ac57bd40/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 1, + "job_id": "ee2167ac-269f-42b3-87ca-6d0ebe306c7f", + "attachment_id": "bb30048f-1553-4351-9f33-b2f93b502cef", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/bb30048f-1553-4351-9f33-b2f93b502cef/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/bb30048f-1553-4351-9f33-b2f93b502cef/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/bb30048f-1553-4351-9f33-b2f93b502cef/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/bb30048f-1553-4351-9f33-b2f93b502cef/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 1, + "job_id": "d48ea0c9-3115-4332-9671-93ef68377997", + "attachment_id": "20c35c44-a4c3-4282-81b3-9ee44bb40411", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/20c35c44-a4c3-4282-81b3-9ee44bb40411/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/20c35c44-a4c3-4282-81b3-9ee44bb40411/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/20c35c44-a4c3-4282-81b3-9ee44bb40411/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/20c35c44-a4c3-4282-81b3-9ee44bb40411/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_effect", + "pipeline_version": 2, + "job_id": "fa6e15bd-ad79-4911-a842-537bb7d5a10d", + "attachment_id": "26372baf-a6ae-482b-b2ab-0d54e6a8502a", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/26372baf-a6ae-482b-b2ab-0d54e6a8502a/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/26372baf-a6ae-482b-b2ab-0d54e6a8502a/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/26372baf-a6ae-482b-b2ab-0d54e6a8502a/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/26372baf-a6ae-482b-b2ab-0d54e6a8502a/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_effect", + "pipeline_version": 2, + "job_id": "004d224e-3c77-4d54-a7ff-8e9c5937139a", + "attachment_id": "784f596f-5710-41e4-bd0b-907d87c606ab", + "logical_results": 1, + "retries": 1, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/784f596f-5710-41e4-bd0b-907d87c606ab/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/784f596f-5710-41e4-bd0b-907d87c606ab/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/784f596f-5710-41e4-bd0b-907d87c606ab/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/784f596f-5710-41e4-bd0b-907d87c606ab/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_after_commit", + "pipeline_version": 2, + "job_id": "d481eb5e-10c7-4ba0-a1af-56814d46d172", + "attachment_id": "b86d0320-cc88-4bb9-9edf-b8d3478daf3d", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b86d0320-cc88-4bb9-9edf-b8d3478daf3d/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b86d0320-cc88-4bb9-9edf-b8d3478daf3d/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b86d0320-cc88-4bb9-9edf-b8d3478daf3d/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/b86d0320-cc88-4bb9-9edf-b8d3478daf3d/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 crash recovery", + "point": "worker_before_ack", + "pipeline_version": 2, + "job_id": "575e2550-b267-428b-8dcd-c4a2922f139a", + "attachment_id": "063ffe02-8669-4eb9-a18b-61fae763f8c2", + "logical_results": 1, + "retries": 0, + "observed_exit_codes": [ + "86" + ], + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/063ffe02-8669-4eb9-a18b-61fae763f8c2/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/063ffe02-8669-4eb9-a18b-61fae763f8c2/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/063ffe02-8669-4eb9-a18b-61fae763f8c2/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/063ffe02-8669-4eb9-a18b-61fae763f8c2/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 duplicate delivery", + "deliveries": 5, + "logical_results": 1, + "objects": 4, + "attachment_id": "456eb6df-fe6f-468f-9fee-4c3008fc8bf3", + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/456eb6df-fe6f-468f-9fee-4c3008fc8bf3/v1/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/456eb6df-fe6f-468f-9fee-4c3008fc8bf3/v1/thumbnail.jpg": "024bfc84ce26125deee0733b9e66ae01ed6fbe7f68616e09b5f66f407d446db4", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/456eb6df-fe6f-468f-9fee-4c3008fc8bf3/v1/crop.jpg": "4577b019ab7da05f274e1168d59619b6628ba4c0676c5bf53b6706d3db0984b2", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/456eb6df-fe6f-468f-9fee-4c3008fc8bf3/v1/optimized.webp": "e71a69780d4412d252116e6980344b6ffb364dbb3b30533dd790bda41a9683c7" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 1, + 2, + 1, + 2 + ], + "attachment_id": "79e17fc4-e52b-4bf4-99a4-bddcbcf84670", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/79e17fc4-e52b-4bf4-99a4-bddcbcf84670/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/79e17fc4-e52b-4bf4-99a4-bddcbcf84670/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/79e17fc4-e52b-4bf4-99a4-bddcbcf84670/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/79e17fc4-e52b-4bf4-99a4-bddcbcf84670/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 reordered versions", + "delivery_order": [ + 2, + 1, + 2, + 1 + ], + "attachment_id": "35653baa-af0e-443d-ad64-b9f020ed3025", + "old_job_status": "superseded", + "published_version": 2, + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/35653baa-af0e-443d-ad64-b9f020ed3025/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/35653baa-af0e-443d-ad64-b9f020ed3025/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/35653baa-af0e-443d-ad64-b9f020ed3025/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/35653baa-af0e-443d-ad64-b9f020ed3025/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 old ready job after new version", + "attachment_id": "ba57b76d-eb32-4520-92b7-dde3cd11056d", + "published_version": 2, + "old_result_unchanged": true, + "new_result_unchanged": true, + "upgrade_requests": 1, + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/ba57b76d-eb32-4520-92b7-dde3cd11056d/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/ba57b76d-eb32-4520-92b7-dde3cd11056d/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/ba57b76d-eb32-4520-92b7-dde3cd11056d/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/ba57b76d-eb32-4520-92b7-dde3cd11056d/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_before_effect", + "attachment_id": "103e3fe6-fcbf-4393-89f2-0cef13bf8abe", + "old_job": "3c99f516-0b94-4b15-b3a9-64662652488b", + "new_job": "69e7b02b-8eee-49d8-96eb-f34767f993f0", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/103e3fe6-fcbf-4393-89f2-0cef13bf8abe/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/103e3fe6-fcbf-4393-89f2-0cef13bf8abe/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/103e3fe6-fcbf-4393-89f2-0cef13bf8abe/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/103e3fe6-fcbf-4393-89f2-0cef13bf8abe/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_effect", + "attachment_id": "6683ca22-56a9-40a7-b7f0-b384235f3602", + "old_job": "bb0804d7-9f68-4f36-92d4-a77c3b9d9da3", + "new_job": "3717d7a7-ae2f-4e88-9d42-848670af509a", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "superseded", + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/6683ca22-56a9-40a7-b7f0-b384235f3602/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/6683ca22-56a9-40a7-b7f0-b384235f3602/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/6683ca22-56a9-40a7-b7f0-b384235f3602/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/6683ca22-56a9-40a7-b7f0-b384235f3602/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 paused old worker resumes after v2 ready", + "point": "worker_after_commit", + "attachment_id": "e59b8522-295f-49c9-b211-f42751dd19d5", + "old_job": "c2727854-ca7c-4d69-98bd-c4225b767e78", + "new_job": "5225490f-7b00-4127-b050-b17e71a31be4", + "old_worker_resumed": true, + "published_version": 2, + "old_status": "ready", + "object_hashes": { + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/e59b8522-295f-49c9-b211-f42751dd19d5/v2/original": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/e59b8522-295f-49c9-b211-f42751dd19d5/v2/thumbnail.jpg": "e89acdeee3b77c8159fc84760392898a2b99e6db450d5503cc1d6df6098754d6", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/e59b8522-295f-49c9-b211-f42751dd19d5/v2/crop.jpg": "322b05608fa15d5fbac4afebb4e35cbde475a4d548ac41b965ac9d4b51771699", + "attachments/85b3bf66-202b-40ed-8b4a-b211988a015d/e59b8522-295f-49c9-b211-f42751dd19d5/v2/optimized.webp": "e32e812e02171965eb373f9a7e49239c0cea50059818b3ed1983332a28cdfc94" + } + }, + { + "check": "track2 failed upgrade preserves v1; explicit replay publishes v2", + "attachment_id": "28137b12-3366-4466-9923-9642fddda79f", + "job_id": "0e8e91f8-9f20-495c-a659-9a364d74edc4" + }, + { + "check": "track2 invariants survive persistent-store restart", + "accepted_attachments": 16, + "committed_jobs": 27, + "lost_attachments": 0, + "unfinished_jobs": 0, + "duplicate_results": 0, + "snapshots_unchanged": true, + "before": { + "db": [ + { + "id": "eb65983952e31a71f4ff5b7ec9c7f5a23ec86e13e44215b22c6b9b474d0ba5a2", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:26:19.443746867Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_pgdata" + ] + } + ], + "cache": [ + { + "id": "5e873fcc822e9fda617f71bbb07df88844d2c5313a218444441d446d1d39f0a1", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:28:14.206175251Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test5d62c41113aa_valkeydata" + ] + } + ], + "minio": [ + { + "id": "b3c6e9bcba98af2c26cdc5c57bc34204b9cfa6a8822eb01805ff178a82bc1525", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:26:19.837209173Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_miniodata" + ] + } + ] + }, + "after": { + "db": [ + { + "id": "eb65983952e31a71f4ff5b7ec9c7f5a23ec86e13e44215b22c6b9b474d0ba5a2", + "image": "sha256:f4610795587492cd4fb887c2dc3de301b813278bb6f616992061141b5f15ac36", + "started_at": "2026-11-14T23:29:05.892315869Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_pgdata" + ] + } + ], + "cache": [ + { + "id": "5e873fcc822e9fda617f71bbb07df88844d2c5313a218444441d446d1d39f0a1", + "image": "sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507", + "started_at": "2026-11-14T23:29:05.927847324Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 268435456, + "volumes": [ + "lab5test5d62c41113aa_valkeydata" + ] + } + ], + "minio": [ + { + "id": "b3c6e9bcba98af2c26cdc5c57bc34204b9cfa6a8822eb01805ff178a82bc1525", + "image": "sha256:1fc9d7f3aae16d7573c9784271f15a05d483a1c33d6af4e417a89c1825141cfe", + "started_at": "2026-11-14T23:29:05.899139428Z", + "exit_code": 0, + "restart_count": 0, + "memory_limit_bytes": 536870912, + "volumes": [ + "lab5test5d62c41113aa_miniodata" + ] + } + ] + } + }, + { + "check": "unchanged lab5 public smoke passed" + } + ], + "elapsed_seconds": 187.243 + } + ] +} diff --git a/evidence/upload-async.json b/evidence/upload-async.json new file mode 100644 index 00000000..3a184a5f --- /dev/null +++ b/evidence/upload-async.json @@ -0,0 +1,21 @@ +{ + "scenario": "upload", + "project": "lab5test37f0067cc042", + "started_at": "2026-11-14T22:14:32.221211+00:00", + "passed": true, + "cleanup": "removed own project and volumes; disposable secrets deleted", + "events": [ + { + "check": "isolated stack started", + "project": "lab5test37f0067cc042" + }, + { + "check": "upload 202 -> GET queued -> ready, original and 3 variants verified", + "attachment_id": "ba5b7e16-cead-4dc7-a208-40cf0de8518d" + }, + { + "check": "unchanged lab5 public smoke passed" + } + ], + "elapsed_seconds": 27.777 +} diff --git a/infra/mc/Dockerfile b/infra/mc/Dockerfile new file mode 100644 index 00000000..bc68d58b --- /dev/null +++ b/infra/mc/Dockerfile @@ -0,0 +1,19 @@ +# Local MinIO Client (mc) from the official GitHub release binary (pinned). +# Fallback when docker.io/minio/mc cannot be pulled. +FROM ubuntu:24.04 + +ARG MC_VERSION=RELEASE.2025-04-16T18-13-26Z + +RUN apt-get update && apt-get install -y --no-install-recommends \ + ca-certificates curl \ + && curl -fsSL -o /tmp/mc.bin \ + "https://github.com/minio/mc/releases/download/${MC_VERSION}/mc.linux-amd64.${MC_VERSION}" \ + && curl -fsSL -o /tmp/mc.sha256sum \ + "https://github.com/minio/mc/releases/download/${MC_VERSION}/mc.linux-amd64.${MC_VERSION}.sha256sum" \ + && expected="$(awk '{print $1}' /tmp/mc.sha256sum)" \ + && echo "${expected} /tmp/mc.bin" | sha256sum -c - \ + && install -m 0755 /tmp/mc.bin /usr/local/bin/mc \ + && rm -f /tmp/mc.bin /tmp/mc.sha256sum \ + && rm -rf /var/lib/apt/lists/* + +ENTRYPOINT ["mc"] diff --git a/infra/minio/Dockerfile b/infra/minio/Dockerfile new file mode 100644 index 00000000..23d07271 --- /dev/null +++ b/infra/minio/Dockerfile @@ -0,0 +1,22 @@ +# Local MinIO image from the official GitHub release binary (pinned). +# Fallback when docker.io/minio/minio cannot be pulled. +FROM ubuntu:24.04 + +ARG MINIO_VERSION=RELEASE.2025-04-22T22-12-26Z + +RUN apt-get update && apt-get install -y --no-install-recommends \ + ca-certificates curl \ + && curl -fsSL -o /tmp/minio.bin \ + "https://github.com/minio/minio/releases/download/${MINIO_VERSION}/minio.linux-amd64.${MINIO_VERSION}" \ + && curl -fsSL -o /tmp/minio.sha256sum \ + "https://github.com/minio/minio/releases/download/${MINIO_VERSION}/minio.linux-amd64.${MINIO_VERSION}.sha256sum" \ + && expected="$(awk '{print $1}' /tmp/minio.sha256sum)" \ + && echo "${expected} /tmp/minio.bin" | sha256sum -c - \ + && install -m 0755 /tmp/minio.bin /usr/local/bin/minio \ + && rm -f /tmp/minio.bin /tmp/minio.sha256sum \ + && rm -rf /var/lib/apt/lists/* + +VOLUME ["/data"] +EXPOSE 9000 9001 +ENTRYPOINT ["minio"] +CMD ["server", "/data", "--console-address", ":9001"] diff --git a/infra/minio/policy-attachments.json b/infra/minio/policy-attachments.json new file mode 100644 index 00000000..69b4ca4d --- /dev/null +++ b/infra/minio/policy-attachments.json @@ -0,0 +1,29 @@ +{ + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "s3:ListBucketMultipartUploads", + "s3:GetBucketLocation", + "s3:ListBucket" + ], + "Resource": [ + "arn:aws:s3:::__S3_BUCKET__" + ] + }, + { + "Effect": "Allow", + "Action": [ + "s3:PutObject", + "s3:GetObject", + "s3:DeleteObject", + "s3:AbortMultipartUpload", + "s3:ListMultipartUploadParts" + ], + "Resource": [ + "arn:aws:s3:::__S3_BUCKET__/*" + ] + } + ] +} diff --git a/infra/track2.md b/infra/track2.md new file mode 100644 index 00000000..bfa8db24 --- /dev/null +++ b/infra/track2.md @@ -0,0 +1,172 @@ +# Трек 2: versioned pipeline и идемпотентный эффект + +## Гипотеза и модель отказов + +При повторной/переставленной доставке и crash worker в выбранных границах, +устойчиво принятое валидное вложение получает ready актуальной запрошенной версии. +Дубль не создаёт второй логический результат, а устаревшая доставка или уже +работающий старый worker не изменяет опубликованные объекты/метаданные новой версии. + +Модель: PostgreSQL — источник истины и атомарной публикации, Redis Streams — +at least once, S3 PUT одного объекта атомарен. Volumes сохраняются; API publisher +и worker после сбоя возвращаются. Оригинал и алгоритм каждой версии неизменны. +Проверяется фиксированный набор отказов, а не все возможные распределённые истории. + +## Версии и границы публикации + +Миграция 011 добавляет: + +- `attachments.pipeline_version` — последняя запрошенная версия; +- `attachments.published_version` — версия текущего complete ready-снимка; +- `jobs.pipeline_version/source_key`, unique `(attachment_id,pipeline_version)`; +- `attachment_results` с PK `(attachment_id,pipeline_version)` и одним полным + набором метаданных; INSERT не заменяет существующий результат; +- `pipeline_requests` — actor/reason/job_id запроса новой версии. + +Job ID стабилен при redelivery/retry/replay одной версии. Новая версия — новая +логическая job. Wire schema остаётся `schema_version=1`, type +`attachment.process.v1`; поле pipeline_version различает рецепты обработки. +Обязательные OpenAPI и jobs schema не менялись. Внутренние storage_key из JSONB +не включаются в публичный JSON Attachment/Variant. + +| Pipeline | JPEG thumbnail/crop | WebP optimized | Геометрия/alpha/EXIF | +| --- | --- | --- | --- | +| v1, default новых uploads | quality 85 | quality 80 | Как в основном контракте | +| v2, операторский upgrade | quality 90 | quality 90 | Та же геометрия; EXIF orientation, white alpha, metadata stripped | + +Разница версий проверяется реальными различающимися SHA вариантов одного fixture. +Изменение рецепта/зависимостей, влияющее на bytes, требует новой версии; эксперимент +использует один и тот же image ID для обеих версий. + +Результаты новых jobs: + +```text +attachments/{chat_id}/{attachment_id}/v{pipeline_version}/original +attachments/{chat_id}/{attachment_id}/v{pipeline_version}/thumbnail.jpg +attachments/{chat_id}/{attachment_id}/v{pipeline_version}/crop.jpg +attachments/{chat_id}/{attachment_id}/v{pipeline_version}/optimized.webp +``` + +Ключ эффекта — `(attachment_id,pipeline_version,variant)`, включая original. +Legacy ready-записи мигрируются без изменения прежних ключей/метаданных; +download поддерживает старые варианты без внутреннего storage_key. + +Worker сверяет version carrier с версией job в БД. Source key и рецепт захватываются +из job до обработки. Поэтому поздний worker не выбирает пути из новой версии +attachment. Jobs старее последней запрошенной версии отбрасываются до S3; queued/ +processing становятся superseded, история ready/failed сохраняется. + +После S3 worker повторно блокирует job/attachment. В одной транзакции сохраняется +versioned result и переключается публичный указатель **только если** desired +version по-прежнему равна версии job. Иначе старый завершившийся worker сохраняет +лишь свой исторический результат и получает superseded. Старые S3 PUT адресуют +только его namespace. Проверка до работы экономит ресурсы; проверка после работы +защищает от смены версии во время обработки. + +Если уже есть ready v1, запрос/обработка/неудача v2 не скрывает v1. Публичный +снимок и download переключаются на v2 после полного успешного COMMIT. Начальные +вложения без ready-снимка по-прежнему проходят queued/processing/ready/failed. +Upgrade использует сохранённый опубликованный original, поэтому удалённый staging +не препятствует новой версии. При overlapping initial jobs GC удерживает source, +пока на него ссылается queued/processing job любой версии. + +## Инварианты и аргумент защиты + +1. **Устойчивое намерение.** До 202 оригинал сохранён, attachment/job/outbox + зафиксированы. Upgrade также фиксирует version/job/audit/outbox атомарно. + В эксперименте каждая принятая attachment заканчивается актуальным ready; + каждая зафиксированная job — ready или явно superseded. +2. **Один логический результат версии.** Unique job и PK result допускают одну + запись версии. Worker создаёт ровно три различных variant metadata; четыре + детерминированных S3-ключа не размножаются от доставки/перезапуска. +3. **Изоляция bytes разных версий.** Recipe/source захвачены из job, carrier не + может подменить её версию. PUT v1 не адресует v2. Проверяется SHA каждого + объекта v2 до и после поздней работы v1. +4. **Монотонная публикация.** Запросы версий сериализуются по attachment и не + уменьшают desired version. Row lock + условная публикация проверяют актуальность + в той же транзакции, что меняет pointer. После v2 версия v1 не может совпасть + с desired и опубликоваться поверх неё. DB CHECK дополнительно требует + published_version <= pipeline_version. +5. **ACK после durable handoff.** Успех подтверждается после COMMIT, retry — после + COMMIT следующего outbox. Смерть до ACK оставляет pending. После COMMIT результата + redelivery не вычисляет его заново и не увеличивает retries. + +Повторные физические PUT/XADD возможны. Например, crash после PUT до DB COMMIT +оставляет объекты, которые retry запишет по тем же ключам. Гарантия относится к +логическому опубликованному эффекту, поэтому это **не exactly-once доставка**. + +## Операторский интерфейс + +```sh +docker compose exec -T api /docker-entrypoint.sh /app/job_admin upgrade ATTACHMENT_UUID \ + --version 2 --actor operator-name --reason "quality pipeline upgrade" +``` + +Ответ — JSON с job_id, pipeline_version и created. Повтор версии 2 возвращает тот +же job_id и created=false без новой audit/outbox. Понижение версии отвергается. +Failed текущей версии можно replay прежней командой; устаревшая failed job не +replay. При неудачном upgrade прежний ready сохраняется до успешного replay v2. +Административные действия доступны только оператору DB/S3 secrets, не через HTTP. + +## Воспроизводимый эксперимент + +```sh +make test-track2 PYTHON=.venv/bin/python \ + TEST_ARGS="--output evidence/track2.json" +# Для уже собранного неизменённого образа: добавить --no-build. +# Default — три независимых холодных стенда; --repetitions 1 для отладки. +``` + +Требования — student-tests/README.md. Каждый повтор создаёт свои DB/S3/Redis, +синтетический fixture sample.png (320×200, 111817 bytes), пользователей и IDs. +Worker serial; для состязания версий запускаются два процесса. COUNT 1, memory +512 MiB. Для fault-барьеров timeout 60 s, в обычном тестовом override — 3 s, +retry 200/800 ms, GC 1 s. Эти ускорения не меняют транзакционные guards. +Сводка хранит source/method SHA-256, реальные image IDs, object hashes, exit codes, +состояния и рестарты. Пароли, токены и signed URLs не сохраняются. + +| Проверка каждого повтора | Воздействие и проверяемый результат | +| --- | --- | +| Legacy migration | Схема уровня 4 → 011, ready/key не меняются; unique/CHECK ограничения работают | +| 8 crash случаев | 4 точки ниже для v1 и v2, наблюдается Docker die exitCode=86; результат один | +| Дубли текущей версии | Пять доставок, одна result row и четыре S3-объекта, retries=0 | +| Два порядка версий | [1,2,1,2] и [2,1,2,1] при desired=2; v1 superseded без S3, v2 ready | +| Поздняя готовая v1 | v1 ready → v2 ready → старые/новые дубли; оба архивных результата неизменны | +| Несовпадение carrier/job | Подмена версии старой job направляется в invalid register без эффекта | +| Три overlapping барьера | v1 приостановлена, v2 ready, тот же старый процесс возобновлён; v2 SHA/pointer прежние | +| Failed upgrade/replay | v2 исчерпывает retry, v1 остаётся доступна; replay публикует v2 | +| Рестарт хранилищ | Все принятые IDs/снимки сохраняются после PostgreSQL/Valkey/MinIO/API restart | +| Публичный smoke | Неизменённый API scenario проходит | + +Fault points, включаемые только через LAB_ENABLE_FAULT_INJECTION=1: + +| LAB_FAULT_POINT | Граница | Ожидаемые retries после восстановления | +| --- | --- | --- | +| worker_before_effect | Processing уже durable, до GET/PUT/encode | 1 | +| worker_after_effect | Все четыре PUT завершены, DB result ещё не опубликован | 1 | +| worker_after_commit | Result/pointer durable, до ACK | 0 | +| worker_before_ack | Объекты дополнительно проверены, перед XACK | 0 | + +LAB_FAULT_JOB_ID и LAB_FAULT_PIPELINE_VERSION выбирают ровно одну работу. +Default action — crash 86 один раз на container/job/point; marker сохраняется при +рестарте процесса. Action=pause создаёт barrier до появления release-файла; +watchdog остаётся включён. В normal Compose эти flags отсутствуют. + +В overlapping case проверяются before_effect, after_effect и after_commit. +Первый даёт реальные **PUT старой версии после публикации новой**; второй — поздний +старый DB COMMIT; третий подтверждает ready в БД и pending в Redis до позднего ACK. +Container ID/restart count доказывают, что старый процесс возобновился, а не был +заменён новым. Проверка действительного содержимого S3 дополняет состояние БД. + +## Границы результата + +Эксперимент не является модельчекером всех сетевых расписаний и не измеряет RPS/ +p95/RSS под нагрузкой. Не покрываются потеря volumes, произвольные изменения БД +оператором, недетерминированная замена алгоритма под тем же version number и +удаление опубликованных S3-объектов внешним процессом. Исторические versioned +outputs сохраняются; очистка staging не задаёт retention архивных версий. + +API показывает последний опубликованный снимок. Два отдельных HTTP-запроса, +разделённые upgrade COMMIT, могут увидеть разные версии; обязательный контракт +не расширялся version-specific download URL. Каждый опубликованный снимок в БД +и его versioned S3-объекты остаются отдельно проверяемыми оператором. diff --git a/infra/worker.md b/infra/worker.md new file mode 100644 index 00000000..1731de2d --- /dev/null +++ b/infra/worker.md @@ -0,0 +1,151 @@ +# Pipeline: уровни 3–5 + +API сохраняет bytes в приватном `staging/{chat_id}/{id}`. В одной транзакции +PostgreSQL создаются attachment, job и outbox. После COMMIT возвращается +снимок `202 queued`; HTTP-путь не обращается к брокеру. Presigned complete +использует ту же схему и при повторе не создаёт новую job/outbox-запись. + +В API работает отдельный поток-публикатор с собственными пулами соединений. +Раз в секунду он выбирает до 32 готовых строк через `FOR UPDATE SKIP LOCKED`, +делает XADD в `jobs:attachments` и ставит `published=true` в транзакции. +Несколько API-реплик могут публиковать одновременно. После XADD, но до +COMMIT отметки, возможен дубль; это доставка at least once, не exactly once. +Непубликованные строки переживают рестарт. Миграция 009 также создаёт +outbox-намерения для незавершённых jobs предыдущего шага. + +Поле `payload` Stream содержит JSON по `contracts/jobs.schema.json`, без bytes, +URL и credentials. `job_id` стабилен в пределах версии; поддерживаются pipeline_version 1 и 2. Для новой управляемой +попытки формируется новое событие с `attempt=jobs.retries+1`. Старое событие +не запускает более новую попытку преждевременно и не откатывает ready. + +Сессии могут храниться в PostgreSQL или Redis. При `SESSION_STORE=postgres` +API стартует и принимает upload даже при выключенном брокере; /health/ready +проверяет PostgreSQL. При Redis-сессиях Valkey остаётся синхронной зависимостью +аутентификации и readiness. S3 необходим для устойчивого приёма bytes до 202. + +## Worker и повторные попытки + +Worker — `/app/worker`, одна работа за раз. Consumer group `attachment-workers` +создаётся с позиции `0`, включая загрузки до первого старта worker. +XAUTOCLAIM подбирает pending после `JOB_RECLAIM_IDLE_MS` (по умолчанию 5000 ms). +Session advisory lock PostgreSQL на UUID job защищает эффект от одновременного +выполнения; смерть процесса освобождает lock. Незавершённый processing после +смерти worker считается неудачей и получает новый durable retry через outbox. + +Временная ошибка атомарно сохраняет `queued`, увеличенный retries, +`next_attempt_at` и следующую outbox-запись с `available_at=next_attempt_at`. +Только после этого старое событие получает ACK. Публикатор не публикует +событие до available_at, worker дополнительно проверяет due time в БД. +Backoff: ceiling=min(JOB_RETRY_MAX_MS, JOB_RETRY_BASE_MS * 2^(retries-retry_base-1)), +задержка равномерно выбирается от ceil(ceiling/2) до ceiling включительно. +Период публикатора может добавить до секунды к задержке при свободном стенде. + +`JOB_MAX_ATTEMPTS=6` означает начальную попытку и пять повторов. После шестой +неудачи текущего бюджета — failed/processing_failed и ACK. Невалидный исходник получает failed +сразу с безопасным кодом. Невалидные события регистрируются в +`jobs:attachments:invalid` с ID исходного события, без копирования bytes. + +Watchdog ограничивает всю обработку job (включая S3/БД/ACK) значением +`JOB_TIMEOUT_SECONDS` (по умолчанию 60). При превышении процесс завершается +с кодом 124. Compose `restart: unless-stopped` запускает его снова; pending и +advisory lock обеспечивают восстановление. При запуске без Compose оператор +должен обеспечить рестарт процесса. SIGTERM позволяет закончить текущую job +в пределах того же таймаута. Worker читает COUNT 1, память ограничена 512 MiB. + +## Изображения + +Worker сверяет размер и SHA-256 staging, проверяет лимит 10 MiB и 40 миллионов +пикселей до декодирования. libexif применяет EXIF orientation (включая PNG eXIf). +RGBA компонуется на белый фон. Thumbnail вписан в 256×256 без увеличения, +размеры округляются вниз, минимум 1 px. JPEG: stb, quality=85 для v1 / 90 для v2, EXIF не переносится. +Из того же декодированного RGB-растра формируются crop и optimized: + +- crop — центральный квадрат, затем JPEG 128×128 (маленький квадрат увеличивается); + при нечётной разнице отступ округляется вниз; +- optimized — lossy WebP quality=80 для v1 / 90 для v2, вписан в 1280×1280 без увеличения, + размеры округляются вниз, минимум 1 px. Используется libwebp WebPEncodeRGB, + EXIF/ICC/XMP не переносятся. Для WebP alpha также компонуется на белый. +Уменьшение размера каждого файла не гарантируется. +Заголовки stb закреплены commit из `third_party/stb/VERSION`. + +Новые outputs публикуются в `attachments/{chat_id}/{id}/v{version}/`: original, +thumbnail.jpg, crop.jpg, optimized.webp. Прежние `{id}_256.jpg` и другие legacy +keys остаются доступны через fallback для старых metadata. Статусы job/attachment и все три variants +публикуются атомарно только после сохранения всех объектов S3. Ready-дубль +проверяет наличие и размеры опубликованных объектов, делает ACK и сохраняет +прежние метаданные. Готовые записи предыдущих шагов сохраняют прежние варианты; +ready не откатывается в processing ради обновления pipeline. + +## Проверки и fault injection + +Отдельно thumbnail: `python3 student-tests/test_thumbnail.py --binary build/thumbnail_smoke`. +Для независимой проверки JPEG и EXIF нужен Pillow; `--workdir PATH` выбирает +каталог временных синтетических файлов. Новые варианты: `python3 student-tests/test_variants.py --binary build/variants_smoke`. +Публичный smoke: `make test`. + +Для локального теста crash предусмотрены два явных opt-in env: +`LAB_ENABLE_FAULT_INJECTION=1` и `LAB_FAULT_POINT=upload_after_commit` либо +`outbox_after_publish`. Первый завершает API с кодом 86 после COMMIT upload, +второй — после XADD до отметки published. Эти переменные не включены в Compose +по умолчанию и не управляются HTTP-запросом. Для детерминированного теста первого +окна остановите брокер, используйте PostgreSQL-сессии, вызовите upload; затем +перезапустите API без fault flags и верните брокер. Новый POST не нужен: та же +запись outbox будет опубликована и та же job завершится. Ответ при crash может +не дойти до клиента; это не отменяет уже зафиксированную транзакцию. + + +## Очистка staging + +После ready и проверки итоговых объектов worker удаляет staging. Если действует +presigned URL, удаление откладывается до `direct_uploads.expires_at`, чтобы URL +не мог сразу восстановить удалённый объект. Внутренний marker +`staging_cleaned_at` не меняет публичный `updated_at`. + +Раз в `STAGING_CLEANUP_INTERVAL_SECONDS` (по умолчанию 60) worker проверяет до +32 известных ready/истёкших failed исходников и до 100 объектов S3-prefix staging +с курсором. Для failed применяется retention от `attachments.updated_at`, для +orphan — от S3 LastModified; по умолчанию `STAGING_RETENTION_SECONDS=86400`. +Queued/processing защищены независимо от возраста. Действующие presigned-сессии +также защищены. Истёкшие failed и orphan удаляются; метаданные failed/audit остаются. +Ключи вне серверного формата `staging/{chat UUID}/{attachment UUID}` не удаляются. +При недоступности S3/БД очистка повторяется в следующем цикле; ready не откатывается. + +API удерживает PostgreSQL advisory xact lock на `staging:` от +PUT до COMMIT метаданных. GC берёт тот же lock неблокирующим образом и повторно +проверяет ссылки в БД. Поэтому пауза API после PUT до INSERT не превращает +текущую загрузку в удаляемый orphan. GC дополнительно сериализован с worker/replay +через job lock и row lock. При GC/COMMIT crash повторное удаление идемпотентно. +Рабочие исходники и последний staging при неполном ready-результате не удаляются. + +## Операторский replay + +Команда доступна только оператору с доступом к DB/S3 secrets контейнера; +публичного административного HTTP endpoint нет: + +```sh +docker compose exec -T api /docker-entrypoint.sh /app/job_admin replay JOB_UUID \ + --actor operator-name --reason "temporary storage failure fixed" +``` + +Replay принимает только failed job актуальной версии с сохранённым source, +сверяет его размер и SHA-256. Source — staging или immutable original предыдущей +версии. Отказ для queued/processing/ready, устаревшей версии и удалённого source. Под job +и row lock одной транзакцией записываются actor/reason/предыдущая ошибка в +`job_replays`, состояния queued и новый outbox. Job ID и ключи эффектов прежние для replay одной версии. +`retries` монотонен, `retry_base` задаёт начало нового бюджета попыток, поэтому +старые stream-события не выполняют новый replay. Повтор команды для уже queued +или ready отказывается без дополнительного audit/outbox. Actor — до 100 UTF-8 +байт, reason — до 500; не записывайте туда credentials. Реестр failed доступен +оператору в `jobs WHERE status='failed'`; журнал replay хранится в `job_replays`. +После удаления единственного staging source replay невозможен: нужен новый upload. +Upgrade с уже опубликованного original не зависит от staging retention. + + +## Versioned pipeline (трек 2) + +Миграция 011 и расширение worker/operator CLI описаны в [track2.md](track2.md). +Новые outputs используют `attachments/{chat}/{id}/v{version}/…`; legacy keys +продолжают читаться. Public JSON не раскрывает storage_key. Jobs уникальны по +attachment/version; version 2 меняет quality JPEG/WebP на 90. Старый ready остаётся +доступным до успешной атомарной публикации новой версии; ошибки upgrade наблюдаются +в jobs. GC не удаляет source, пока его использует active job любой версии. diff --git a/lb/nginx.conf.template b/lb/nginx.conf.template new file mode 100644 index 00000000..ac64896e --- /dev/null +++ b/lb/nginx.conf.template @@ -0,0 +1,44 @@ +worker_processes ${NGINX_WORKERS}; +error_log /dev/stderr warn; +pid /tmp/nginx.pid; + +events { + worker_connections 1024; +} + +http { + access_log off; + resolver 127.0.0.11 valid=2s ipv6=off; + resolver_timeout 2s; + + upstream api_upstream { + zone api_upstream 64k; + server api:8080 resolve max_fails=1 fail_timeout=5s; + keepalive 32; + } + + server { + listen 8080; + + # Lab4 attachments ≤10 MiB; allow a little headroom for multipart/headers. + client_max_body_size 12m; + client_body_timeout 60s; + + location / { + proxy_pass http://api_upstream; + proxy_http_version 1.1; + proxy_set_header Connection ""; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Forwarded-Host $host; + proxy_next_upstream error timeout http_502 http_503 http_504; + proxy_next_upstream_tries 2; + proxy_next_upstream_timeout 10s; + proxy_connect_timeout 2s; + # Uploads/downloads of ≤10 MiB need longer than JSON chat traffic. + proxy_read_timeout 120s; + proxy_send_timeout 120s; + } + } +} diff --git a/migrations/001_init.sql b/migrations/001_init.sql new file mode 100644 index 00000000..6c67477d --- /dev/null +++ b/migrations/001_init.sql @@ -0,0 +1,33 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL UNIQUE + CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + PRIMARY KEY (chat_id, user_id) +); + +CREATE INDEX chat_members_user_idx ON chat_members(user_id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users(id), + text text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE INDEX messages_chat_keyset_idx + ON messages (chat_id, created_at, id); \ No newline at end of file diff --git a/migrations/002_sessions.sql b/migrations/002_sessions.sql new file mode 100644 index 00000000..2ee49852 --- /dev/null +++ b/migrations/002_sessions.sql @@ -0,0 +1,6 @@ +CREATE TABLE sessions ( + token text PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + expires_at timestamptz NOT NULL +); +CREATE INDEX sessions_expires_at_idx ON sessions (expires_at); \ No newline at end of file diff --git a/migrations/003_idempotency.sql b/migrations/003_idempotency.sql new file mode 100644 index 00000000..2c847072 --- /dev/null +++ b/migrations/003_idempotency.sql @@ -0,0 +1,11 @@ +CREATE TABLE idempotency_keys ( + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + key text NOT NULL CHECK (key ~ '^[A-Za-z0-9._:-]{1,128}$'), + request_hash text NOT NULL, + message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (user_id, chat_id, key) +); + +CREATE INDEX idempotency_keys_created_at_idx ON idempotency_keys (created_at); \ No newline at end of file diff --git a/migrations/004_attachments.sql b/migrations/004_attachments.sql new file mode 100644 index 00000000..10446930 --- /dev/null +++ b/migrations/004_attachments.sql @@ -0,0 +1,22 @@ +CREATE TABLE attachments ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + owner_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + filename text NOT NULL + CHECK (char_length(filename) BETWEEN 1 AND 255), + content_type text NOT NULL + CHECK (content_type IN ('image/png', 'image/jpeg')), + size_bytes integer NOT NULL + CHECK (size_bytes >= 1 AND size_bytes <= 10485760), + sha256 text NOT NULL + CHECK (sha256 ~ '^[a-f0-9]{64}$'), + status text NOT NULL + CHECK (status IN ('ready')), + s3_key text NOT NULL UNIQUE, + error_code text NULL, + created_at timestamptz NOT NULL, + updated_at timestamptz NOT NULL +); + +CREATE INDEX attachments_chat_id_idx ON attachments (chat_id); +CREATE INDEX attachments_created_at_idx ON attachments (created_at); diff --git a/migrations/005_message_attachments.sql b/migrations/005_message_attachments.sql new file mode 100644 index 00000000..d1fa90a5 --- /dev/null +++ b/migrations/005_message_attachments.sql @@ -0,0 +1,12 @@ +CREATE TABLE message_attachments ( + message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE, + attachment_id uuid NOT NULL REFERENCES attachments(id), + position integer NOT NULL CHECK (position >= 0 AND position < 10), + PRIMARY KEY (message_id, attachment_id) +); + +CREATE INDEX message_attachments_attachment_idx + ON message_attachments (attachment_id); + +CREATE UNIQUE INDEX message_attachments_order_idx + ON message_attachments (message_id, position); diff --git a/migrations/006_direct_uploads.sql b/migrations/006_direct_uploads.sql new file mode 100644 index 00000000..2a97a7df --- /dev/null +++ b/migrations/006_direct_uploads.sql @@ -0,0 +1,26 @@ +-- Track 1 (grade 5): pending direct/presigned upload sessions. +-- Attachment rows stay status=ready only; incomplete uploads live here. +CREATE TABLE direct_uploads ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + owner_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + filename text NOT NULL + CHECK (char_length(filename) BETWEEN 1 AND 255), + content_type text NOT NULL + CHECK (content_type IN ('image/png', 'image/jpeg')), + expected_size integer NOT NULL + CHECK (expected_size >= 1 AND expected_size <= 10485760), + expected_sha256 text NOT NULL + CHECK (expected_sha256 ~ '^[a-f0-9]{64}$'), + s3_key text NOT NULL UNIQUE, + status text NOT NULL + CHECK (status IN ('pending', 'completed', 'aborted', 'expired')), + attachment_id uuid NULL REFERENCES attachments(id), + expires_at timestamptz NOT NULL, + created_at timestamptz NOT NULL, + updated_at timestamptz NOT NULL +); + +CREATE INDEX direct_uploads_status_expires_idx + ON direct_uploads (status, expires_at); +CREATE INDEX direct_uploads_owner_idx ON direct_uploads (owner_id); diff --git a/migrations/007_direct_upload_staging.sql b/migrations/007_direct_upload_staging.sql new file mode 100644 index 00000000..cd3d4220 --- /dev/null +++ b/migrations/007_direct_upload_staging.sql @@ -0,0 +1,12 @@ +-- Track 1: presigned PUT lands in staging/; complete copies to attachments/. +-- Existing rows keep the old key as staging so in-flight sessions still resolve. +ALTER TABLE direct_uploads ADD COLUMN staging_key text; + +UPDATE direct_uploads + SET staging_key = s3_key + WHERE staging_key IS NULL; + +ALTER TABLE direct_uploads ALTER COLUMN staging_key SET NOT NULL; + +ALTER TABLE direct_uploads + ADD CONSTRAINT direct_uploads_staging_key_key UNIQUE (staging_key); diff --git a/migrations/008_async_attachments.sql b/migrations/008_async_attachments.sql new file mode 100644 index 00000000..13abf2e3 --- /dev/null +++ b/migrations/008_async_attachments.sql @@ -0,0 +1,21 @@ +-- Keep existing lab4 originals ready; new jobs set queued explicitly. +ALTER TABLE attachments DROP CONSTRAINT attachments_status_check; +ALTER TABLE attachments + ADD CONSTRAINT attachments_status_check + CHECK (status IN ('queued', 'processing', 'ready', 'failed')), + ADD COLUMN variants jsonb NOT NULL DEFAULT '[]'::jsonb + CHECK (jsonb_typeof(variants) = 'array'); + +CREATE TABLE jobs ( + id uuid PRIMARY KEY, + attachment_id uuid NOT NULL UNIQUE + REFERENCES attachments(id) ON DELETE CASCADE, + status text NOT NULL DEFAULT 'queued' + CHECK (status IN ('queued', 'processing', 'ready', 'failed')), + retries integer NOT NULL DEFAULT 0 CHECK (retries >= 0), + error_code text, + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now() +); + +CREATE INDEX jobs_status_created_at_idx ON jobs (status, created_at); diff --git a/migrations/009_outbox.sql b/migrations/009_outbox.sql new file mode 100644 index 00000000..856ca17a --- /dev/null +++ b/migrations/009_outbox.sql @@ -0,0 +1,20 @@ +ALTER TABLE jobs ADD COLUMN next_attempt_at timestamptz NOT NULL DEFAULT now(); + +CREATE TABLE outbox ( + id bigserial PRIMARY KEY, + payload jsonb NOT NULL CHECK (jsonb_typeof(payload) = 'object'), + published boolean NOT NULL DEFAULT false, + created_at timestamptz NOT NULL DEFAULT now(), + available_at timestamptz NOT NULL DEFAULT now() +); + +CREATE INDEX outbox_pending_idx ON outbox (available_at, id) WHERE NOT published; + +-- Upgrade jobs accepted before outbox existed; duplicates are safe. +INSERT INTO outbox (payload, available_at) +SELECT jsonb_build_object( + 'schema_version', 1, 'type', 'attachment.process.v1', + 'job_id', id::text, 'attachment_id', attachment_id::text, + 'pipeline_version', 1, 'attempt', retries + 1, + 'created_at', to_char(created_at AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS"Z"') +), next_attempt_at FROM jobs WHERE status IN ('queued', 'processing'); diff --git a/migrations/010_staging_and_replay.sql b/migrations/010_staging_and_replay.sql new file mode 100644 index 00000000..94024671 --- /dev/null +++ b/migrations/010_staging_and_replay.sql @@ -0,0 +1,22 @@ +ALTER TABLE attachments + ADD COLUMN staging_key text, + ADD COLUMN staging_cleaned_at timestamptz; + +UPDATE attachments a SET staging_key='staging/' || a.chat_id::text || '/' || a.id::text +WHERE EXISTS (SELECT 1 FROM jobs j WHERE j.attachment_id=a.id); + +CREATE INDEX attachments_staging_cleanup_idx ON attachments(status, updated_at) +WHERE staging_key IS NOT NULL AND staging_cleaned_at IS NULL; + +ALTER TABLE jobs ADD COLUMN retry_base integer NOT NULL DEFAULT 0 + CHECK (retry_base >= 0 AND retry_base <= retries); + +CREATE TABLE job_replays ( + id bigserial PRIMARY KEY, + job_id uuid NOT NULL REFERENCES jobs(id), + actor text NOT NULL CHECK (char_length(actor) BETWEEN 1 AND 100), + reason text NOT NULL CHECK (char_length(reason) BETWEEN 1 AND 500), + previous_error_code text, + retries_before integer NOT NULL CHECK (retries_before >= 0), + created_at timestamptz NOT NULL DEFAULT now() +); diff --git a/migrations/011_versioned_pipeline.sql b/migrations/011_versioned_pipeline.sql new file mode 100644 index 00000000..2350d048 --- /dev/null +++ b/migrations/011_versioned_pipeline.sql @@ -0,0 +1,41 @@ +ALTER TABLE attachments + ADD COLUMN pipeline_version integer NOT NULL DEFAULT 1 CHECK (pipeline_version > 0), + ADD COLUMN published_version integer CHECK (published_version > 0), + ADD CONSTRAINT attachments_version_order CHECK (published_version <= pipeline_version); +UPDATE attachments SET published_version=1 WHERE status='ready'; + +ALTER TABLE jobs + ADD COLUMN pipeline_version integer NOT NULL DEFAULT 1 CHECK (pipeline_version > 0), + ADD COLUMN source_key text; +UPDATE jobs j SET source_key=a.s3_key FROM attachments a WHERE a.id=j.attachment_id; +ALTER TABLE jobs ALTER COLUMN source_key SET NOT NULL; +ALTER TABLE jobs DROP CONSTRAINT jobs_attachment_id_key; +ALTER TABLE jobs ADD CONSTRAINT jobs_attachment_version_key UNIQUE (attachment_id, pipeline_version); +ALTER TABLE jobs DROP CONSTRAINT jobs_status_check; +ALTER TABLE jobs ADD CONSTRAINT jobs_status_check + CHECK (status IN ('queued','processing','ready','failed','superseded')); + +-- One immutable logical result per (attachment, pipeline version). +CREATE TABLE attachment_results ( + attachment_id uuid NOT NULL REFERENCES attachments(id) ON DELETE CASCADE, + pipeline_version integer NOT NULL CHECK (pipeline_version > 0), + job_id uuid UNIQUE REFERENCES jobs(id), + original_key text NOT NULL, + variants jsonb NOT NULL CHECK (jsonb_typeof(variants)='array'), + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (attachment_id, pipeline_version) +); +INSERT INTO attachment_results(attachment_id,pipeline_version,job_id,original_key,variants) +SELECT a.id,1,j.id,a.s3_key,a.variants FROM attachments a +LEFT JOIN jobs j ON j.attachment_id=a.id AND j.pipeline_version=1 WHERE a.status='ready'; + +CREATE TABLE pipeline_requests ( + id bigserial PRIMARY KEY, + attachment_id uuid NOT NULL REFERENCES attachments(id), + pipeline_version integer NOT NULL CHECK (pipeline_version > 0), + job_id uuid NOT NULL UNIQUE REFERENCES jobs(id), + actor text NOT NULL CHECK (char_length(actor) BETWEEN 1 AND 100), + reason text NOT NULL CHECK (char_length(reason) BETWEEN 1 AND 500), + created_at timestamptz NOT NULL DEFAULT now(), + UNIQUE(attachment_id,pipeline_version) +); diff --git a/src/attachment_queue.cpp b/src/attachment_queue.cpp new file mode 100644 index 00000000..e22256ff --- /dev/null +++ b/src/attachment_queue.cpp @@ -0,0 +1,93 @@ +#include "attachment_queue.hpp" +#include "errors.hpp" + +#include + +void AttachmentQueue::publish(const std::string& payload) { + auto lease = pool_.acquire(); + std::unique_ptr reply( + static_cast(redisCommand( + lease.ctx(), "XADD jobs:attachments * payload %b", + payload.data(), payload.size())), &freeReplyObject); + if (!reply || reply->type != REDIS_REPLY_STRING || reply->len == 0) { + throw DependencyUnavailable("attachment queue publish failed"); + } +} + +namespace { +using Reply = std::unique_ptr; +Reply checked(redisReply* reply) { + Reply owned(reply, &freeReplyObject); + if (!owned || owned->type == REDIS_REPLY_ERROR) { + throw DependencyUnavailable("attachment stream command failed"); + } + return owned; +} +JobDelivery delivery(const redisReply* entry) { + if (entry->type != REDIS_REPLY_ARRAY || entry->elements != 2 || + entry->element[0]->type != REDIS_REPLY_STRING || + entry->element[1]->type != REDIS_REPLY_ARRAY) { + throw DependencyUnavailable("invalid stream response"); + } + JobDelivery result{std::string(entry->element[0]->str, entry->element[0]->len), {}}; + const auto* fields = entry->element[1]; + for (std::size_t i = 0; i + 1 < fields->elements; i += 2) { + if (fields->element[i]->type == REDIS_REPLY_STRING && + std::string(fields->element[i]->str, fields->element[i]->len) == "payload" && + fields->element[i + 1]->type == REDIS_REPLY_STRING && fields->element[i + 1]->len <= 4096) { + result.payload.assign(fields->element[i + 1]->str, fields->element[i + 1]->len); + } + } + return result; +} +} // namespace + +void AttachmentQueue::ensure_group() { + auto lease = pool_.acquire(); + Reply reply(static_cast(redisCommand(lease.ctx(), + "XGROUP CREATE jobs:attachments attachment-workers 0 MKSTREAM")), &freeReplyObject); + if (!reply || (reply->type == REDIS_REPLY_ERROR && + std::string(reply->str, reply->len).rfind("BUSYGROUP", 0) != 0)) { + throw DependencyUnavailable("attachment consumer group unavailable"); + } +} + +std::optional AttachmentQueue::read(const std::string& consumer, int reclaim_idle_ms) { + auto lease = pool_.acquire(); + auto pending = checked(static_cast(redisCommand(lease.ctx(), + "XAUTOCLAIM jobs:attachments attachment-workers %s %d %s COUNT 1", + consumer.c_str(), reclaim_idle_ms, claim_cursor_.c_str()))); + if (pending->type != REDIS_REPLY_ARRAY || pending->elements < 2 || + pending->element[0]->type != REDIS_REPLY_STRING || + pending->element[1]->type != REDIS_REPLY_ARRAY) { + throw DependencyUnavailable("invalid pending response"); + } + claim_cursor_.assign(pending->element[0]->str, pending->element[0]->len); + if (pending->element[1]->elements) return delivery(pending->element[1]->element[0]); + auto fresh = checked(static_cast(redisCommand(lease.ctx(), + "XREADGROUP GROUP attachment-workers %s COUNT 1 BLOCK 1000 STREAMS jobs:attachments >", + consumer.c_str()))); + if (fresh->type == REDIS_REPLY_NIL) return std::nullopt; + if (fresh->type != REDIS_REPLY_ARRAY || fresh->elements != 1 || + fresh->element[0]->type != REDIS_REPLY_ARRAY || fresh->element[0]->elements != 2 || + fresh->element[0]->element[1]->type != REDIS_REPLY_ARRAY || + fresh->element[0]->element[1]->elements != 1) { + throw DependencyUnavailable("invalid stream read response"); + } + return delivery(fresh->element[0]->element[1]->element[0]); +} + +void AttachmentQueue::ack(const std::string& stream_id) { + auto lease = pool_.acquire(); + checked(static_cast(redisCommand(lease.ctx(), + "XACK jobs:attachments attachment-workers %s", stream_id.c_str()))); +} + +void AttachmentQueue::reject(const std::string& stream_id) { + { + auto lease = pool_.acquire(); + checked(static_cast(redisCommand(lease.ctx(), + "XADD jobs:attachments:invalid * stream_id %s error_code invalid_job", stream_id.c_str()))); + } + ack(stream_id); +} diff --git a/src/attachment_queue.hpp b/src/attachment_queue.hpp new file mode 100644 index 00000000..c2af5229 --- /dev/null +++ b/src/attachment_queue.hpp @@ -0,0 +1,27 @@ +#pragma once + +#include "redis_pool.hpp" + +#include +#include + +struct JobDelivery { + std::string stream_id; + std::string payload; +}; + +class AttachmentQueue { +public: + explicit AttachmentQueue(RedisPool& pool) : pool_(pool) {} + + void publish(const std::string& payload); + void ensure_group(); + std::optional read(const std::string& consumer, int reclaim_idle_ms); + void ack(const std::string& stream_id); + void reject(const std::string& stream_id); + bool ping() { return pool_.ping(); } + +private: + RedisPool& pool_; + std::string claim_cursor_ = "0-0"; +}; diff --git a/src/attachment_repo.cpp b/src/attachment_repo.cpp new file mode 100644 index 00000000..bfe11eef --- /dev/null +++ b/src/attachment_repo.cpp @@ -0,0 +1,156 @@ +#include "attachment_repo.hpp" +#include "outbox.hpp" + +#include +#include + +#include +#include +#include +#include + +namespace { + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()) + .count(); + return std::to_string(secs); +} + +Attachment row_to_attachment(const pqxx::row& r) { + Attachment a; + a.id = r["id"].as(); + a.chat_id = r["chat_id"].as(); + a.owner_id = r["owner_id"].as(); + a.filename = r["filename"].as(); + a.content_type = r["content_type"].as(); + a.size_bytes = r["size_bytes"].as(); + a.sha256 = r["sha256"].as(); + a.status = r["status"].as(); + a.s3_key = r["s3_key"].as(); + if (r["error_code"].is_null()) { + a.error_code = std::nullopt; + } else { + a.error_code = r["error_code"].as(); + } + a.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + a.updated_at = epoch_to_rfc3339(r["updated_at_epoch"].as()); + for (const auto& v : nlohmann::json::parse(r["variants"].as())) { + a.variants.push_back(Variant{v.at("name").get(), + v.at("content_type").get(), v.at("size_bytes").get(), + v.at("sha256").get(), v.at("width").get(), + v.at("height").get(), v.value("storage_key", "")}); + } + return a; +} + +constexpr const char* kAttachmentColumns = + "id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + "status, s3_key, error_code, variants, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch, " + "EXTRACT(EPOCH FROM updated_at)::bigint AS updated_at_epoch"; + +} // namespace + +Attachment AttachmentRepo::insert(const Attachment& in) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + const std::string ts = now_epoch_str(); + pqxx::result r; + if (in.error_code) { + r = tx.exec( + "INSERT INTO attachments (" + " id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + " status, s3_key, error_code, created_at, updated_at" + ") VALUES (" + " $1::uuid, $2::uuid, $3::uuid, $4, $5, $6, $7, $8, $9, $10, " + " to_timestamp($11::bigint), to_timestamp($12::bigint)" + ") RETURNING " + + std::string(kAttachmentColumns), + pqxx::params{in.id, in.chat_id, in.owner_id, in.filename, + in.content_type, in.size_bytes, in.sha256, in.status, + in.s3_key, *in.error_code, ts, ts}); + } else { + r = tx.exec( + "INSERT INTO attachments (" + " id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + " status, s3_key, error_code, created_at, updated_at" + ") VALUES (" + " $1::uuid, $2::uuid, $3::uuid, $4, $5, $6, $7, $8, $9, NULL, " + " to_timestamp($10::bigint), to_timestamp($11::bigint)" + ") RETURNING " + + std::string(kAttachmentColumns), + pqxx::params{in.id, in.chat_id, in.owner_id, in.filename, + in.content_type, in.size_bytes, in.sha256, in.status, + in.s3_key, ts, ts}); + } + tx.commit(); + return row_to_attachment(r[0]); +} + +std::optional AttachmentRepo::find_by_id(const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kAttachmentColumns) + + " FROM attachments WHERE id = $1::uuid", + pqxx::params{id}); + if (r.empty()) { + return std::nullopt; + } + return row_to_attachment(r[0]); +} + +Attachment AttachmentRepo::insert_queued(const Attachment& in, + const std::string& job_id, + const std::function& save_original) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + tx.exec("SELECT pg_advisory_xact_lock(hashtextextended('staging:' || $1::uuid::text, 0))", + pqxx::params{in.id}); + save_original(); + auto r = tx.exec( + "INSERT INTO attachments (" + "id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + "status, s3_key, staging_key, created_at, updated_at) VALUES (" + "$1::uuid, $2::uuid, $3::uuid, $4, $5, $6, $7, 'queued', $8, $8, now(), now()) " + "RETURNING " + std::string(kAttachmentColumns), + pqxx::params{in.id, in.chat_id, in.owner_id, in.filename, + in.content_type, in.size_bytes, in.sha256, in.s3_key}); + tx.exec("INSERT INTO jobs (id, attachment_id, source_key) VALUES ($1::uuid, $2::uuid, $3)", + pqxx::params{job_id, in.id, in.s3_key}); + enqueue_attachment_job(tx, job_id); + Attachment saved = row_to_attachment(r[0]); + tx.commit(); + return saved; +} + +bool AttachmentRepo::all_belong_to_chat(const std::string& chat_id, + const std::vector& ids) { + if (ids.empty()) { + return true; + } + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + for (const auto& id : ids) { + auto r = tx.exec( + "SELECT 1 FROM attachments " + "WHERE id = $1::uuid AND chat_id = $2::uuid AND status <> 'failed'", + pqxx::params{id, chat_id}); + if (r.empty()) { + return false; + } + } + return true; +} diff --git a/src/attachment_repo.hpp b/src/attachment_repo.hpp new file mode 100644 index 00000000..eaa40efb --- /dev/null +++ b/src/attachment_repo.hpp @@ -0,0 +1,28 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include +#include + +class AttachmentRepo { +public: + explicit AttachmentRepo(PgPool& pool) : pool_(pool) {} + + Attachment insert(const Attachment& a); + Attachment insert_queued(const Attachment& a, const std::string& job_id, + const std::function& save_original); + + std::optional find_by_id(const std::string& id); + + // All IDs must exist, belong to chat_id, and not have status=failed. + // Returns false if any id is missing/foreign/failed. + bool all_belong_to_chat(const std::string& chat_id, + const std::vector& ids); + +private: + PgPool& pool_; +}; diff --git a/src/attachment_storage.hpp b/src/attachment_storage.hpp new file mode 100644 index 00000000..4398f8f3 --- /dev/null +++ b/src/attachment_storage.hpp @@ -0,0 +1,20 @@ +#pragma once + +#include +#include + +inline std::string attachment_variant_key(const std::string& chat_id, + const std::string& id, + const std::string& variant) { + const char* suffix = variant == "thumbnail" ? "_256.jpg" : + variant == "crop" ? "_128.jpg" : + variant == "optimized" ? "_optimized.webp" : nullptr; + if (!suffix) throw std::invalid_argument("unknown variant"); + return "attachments/" + chat_id + "/" + id + suffix; +} + +inline std::string pipeline_prefix(const std::string& chat_id, const std::string& id, + int version) { + if (version < 1) throw std::invalid_argument("invalid pipeline version"); + return "attachments/" + chat_id + "/" + id + "/v" + std::to_string(version) + "/"; +} diff --git a/src/auth.cpp b/src/auth.cpp new file mode 100644 index 00000000..d6d8cf95 --- /dev/null +++ b/src/auth.cpp @@ -0,0 +1,39 @@ +#include "auth.hpp" + +#include +#include + + +namespace { +struct SodiumInit { + SodiumInit() { + if (sodium_init() < 0) { + throw std::runtime_error("sodium_init failed"); + } + } +}; + +const SodiumInit g_sodium_init; +} + + +std::string hash_password(const std::string& plain) { + char hashed[crypto_pwhash_STRBYTES]; + if (crypto_pwhash_str( + hashed, + plain.data(), plain.size(), + crypto_pwhash_OPSLIMIT_INTERACTIVE, + crypto_pwhash_MEMLIMIT_INTERACTIVE) != 0) { + throw std::runtime_error("crypto_pwhash_str failed (out of memory?)"); + } + return std::string(hashed); +} + +bool verify_password(const std::string& plain, const std::string& hash) { + if (hash.empty() || hash.size() >= crypto_pwhash_STRBYTES) { + return false; + } + return crypto_pwhash_str_verify( + hash.c_str(), + plain.data(), plain.size()) == 0; +} \ No newline at end of file diff --git a/src/auth.hpp b/src/auth.hpp new file mode 100644 index 00000000..639b0336 --- /dev/null +++ b/src/auth.hpp @@ -0,0 +1,7 @@ +#pragma once + +#include + +std::string hash_password(const std::string& plain); + +bool verify_password(const std::string& plain, const std::string& hash); \ No newline at end of file diff --git a/src/chat_repo.cpp b/src/chat_repo.cpp new file mode 100644 index 00000000..580fc71b --- /dev/null +++ b/src/chat_repo.cpp @@ -0,0 +1,186 @@ +#include "chat_repo.hpp" +#include "cursor.hpp" + +#include + +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +Chat row_to_chat(const pqxx::row& r) { + Chat c; + c.id = r["id"].as(); + c.title = r["title"].as(); + c.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return c; +} + +std::vector load_member_ids(pqxx::work& tx, + const std::string& chat_id) { + std::vector ids; + auto r = tx.exec( + "SELECT user_id FROM chat_members WHERE chat_id = $1 ORDER BY user_id", + pqxx::params{chat_id}); + ids.reserve(r.size()); + for (const auto& row : r) { + ids.push_back(row["user_id"].as()); + } + return ids; +} + +constexpr const char* kChatSelect = + "id, title, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +} + +std::optional ChatRepo::create(const std::string& title, + const std::vector& member_ids) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + const std::string chat_id = make_uuid(); + const std::string created = now_epoch_str(); + + try { + tx.exec( + "INSERT INTO chats (id, title, created_at) " + "VALUES ($1, $2, to_timestamp($3::bigint))", + pqxx::params{chat_id, title, created}); + + for (const auto& uid : member_ids) { + tx.exec( + "INSERT INTO chat_members (chat_id, user_id) VALUES ($1, $2)", + pqxx::params{chat_id, uid}); + } + } catch (const pqxx::foreign_key_violation&) { + tx.abort(); + return std::nullopt; + } catch (const pqxx::unique_violation&) { + tx.abort(); + return std::nullopt; + } + + auto r = tx.exec( + "SELECT " + std::string(kChatSelect) + " FROM chats WHERE id = $1", + pqxx::params{chat_id}); + Chat c = row_to_chat(r[0]); + c.member_ids = load_member_ids(tx, chat_id); + tx.commit(); + return c; +} + +std::optional ChatRepo::find_by_id(const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kChatSelect) + " FROM chats WHERE id = $1", + pqxx::params{id}); + if (r.empty()) { + tx.commit(); + return std::nullopt; + } + Chat c = row_to_chat(r[0]); + c.member_ids = load_member_ids(tx, id); + tx.commit(); + return c; +} + + +std::optional ChatRepo::list_for_user( + const std::string& user_id, + int limit, + const std::optional& cursor) { + + std::optional cur; + if (cursor) { + cur = parse_cursor(*cursor); + if (!cur) { + return std::nullopt; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + if (cur) { + auto owner_check = tx.exec( + "SELECT 1 FROM chats WHERE id = $1 AND id IN " + "(SELECT chat_id FROM chat_members WHERE user_id = $2)", + pqxx::params{cur->id, user_id}); + if (owner_check.empty()) { + tx.commit(); + return std::nullopt; + } + } + + std::string sql = + "SELECT " + std::string(kChatSelect) + ", " + kCreatedUsSql + " " + "FROM chats " + "WHERE id IN (SELECT chat_id FROM chat_members WHERE user_id = $1) "; + if (cur) { + sql += "AND (created_at, id) > (" + std::string(kCursorTimestampSql) + ", $4::uuid) "; + } + sql += "ORDER BY created_at ASC, id ASC LIMIT $2"; + + pqxx::result r; + if (cur) { + r = tx.exec(sql, pqxx::params{user_id, limit + 1, cur->created_us, cur->id}); + } else { + r = tx.exec(sql, pqxx::params{user_id, limit + 1}); + } + + ChatPage page; + const bool has_more = (static_cast(r.size()) > limit); + const int take = has_more ? limit : static_cast(r.size()); + page.items.reserve(take); + for (int i = 0; i < take; ++i) { + Chat c = row_to_chat(r[static_cast(i)]); + c.member_ids = load_member_ids(tx, c.id); + page.items.push_back(std::move(c)); + } + + if (has_more && take > 0) { + const auto& last = r[static_cast(take - 1)]; + page.next_cursor = make_cursor(last["created_us"].as(), + last["id"].as()); + } + + tx.commit(); + return page; +} \ No newline at end of file diff --git a/src/chat_repo.hpp b/src/chat_repo.hpp new file mode 100644 index 00000000..279e2661 --- /dev/null +++ b/src/chat_repo.hpp @@ -0,0 +1,23 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include + +class ChatRepo { +public: + explicit ChatRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& title, + const std::vector& member_ids); + + std::optional find_by_id(const std::string& id); + + std::optional list_for_user(const std::string& user_id, int limit, const std::optional& cursor); + +private: + PgPool& pool_; +}; \ No newline at end of file diff --git a/src/cursor.hpp b/src/cursor.hpp new file mode 100644 index 00000000..08f08504 --- /dev/null +++ b/src/cursor.hpp @@ -0,0 +1,47 @@ +#pragma once + +#include +#include +#include +#include +#include + +// Непрозрачный для клиента курсор keyset-пагинации: "|". +// Микросекунды сохраняют точный created_at строки, даже если в JSON время округлено до секунд. +struct Cursor { + std::string created_us; + std::string id; +}; + +// Выражение SQL, восстанавливающее timestamptz из created_us без потери точности. +constexpr const char* kCursorTimestampSql = + "(timestamptz 'epoch' + $3::bigint * interval '1 microsecond')"; + +constexpr const char* kCreatedUsSql = + "(EXTRACT(EPOCH FROM created_at) * 1000000)::bigint AS created_us"; + +inline bool is_uuid(const std::string& s) { + static const std::regex re( + "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-" + "[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + return std::regex_match(s, re); +} + +inline std::optional parse_cursor(const std::string& raw) { + const auto bar = raw.find('|'); + if (bar == std::string::npos) { + return std::nullopt; + } + Cursor c{raw.substr(0, bar), raw.substr(bar + 1)}; + const bool digits = !c.created_us.empty() && c.created_us.size() <= 18 && + std::all_of(c.created_us.begin(), c.created_us.end(), + [](unsigned char ch) { return std::isdigit(ch); }); + if (!digits || !is_uuid(c.id)) { + return std::nullopt; + } + return c; +} + +inline std::string make_cursor(const std::string& created_us, const std::string& id) { + return created_us + "|" + id; +} diff --git a/src/db.cpp b/src/db.cpp new file mode 100644 index 00000000..97312c40 --- /dev/null +++ b/src/db.cpp @@ -0,0 +1,360 @@ +#include "db.hpp" +#include "errors.hpp" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +namespace fs = std::filesystem; + + +namespace { + +constexpr int kConnectTimeoutSeconds = 2; +constexpr int kTcpUserTimeoutMs = 5000; +constexpr int kStatementTimeoutMs = 5000; +constexpr int kClientIoTimeoutSeconds = 5; +constexpr auto kAcquireTimeout = std::chrono::seconds(3); + +std::string add_conn_param(std::string conninfo, const std::string& key, + const std::string& value) { + if (conninfo.find(key + "=") != std::string::npos) { + return conninfo; + } + const bool is_url = conninfo.rfind("postgres://", 0) == 0 || + conninfo.rfind("postgresql://", 0) == 0; + if (is_url) { + conninfo += (conninfo.find('?') == std::string::npos ? "?" : "&"); + } else { + conninfo += " "; + } + return conninfo + key + "=" + value; +} + +bool is_alive(pqxx::connection* conn) { + std::promise done; + auto fut = done.get_future(); + std::thread th([conn, &done]() { + try { + pqxx::nontransaction tx(*conn); + tx.exec("SELECT 1"); + done.set_value(); + } catch (...) { + done.set_exception(std::current_exception()); + } + }); + if (fut.wait_for(std::chrono::seconds(kClientIoTimeoutSeconds)) != + std::future_status::ready) { + const int fd = conn->sock(); + if (fd >= 0) { + ::shutdown(fd, SHUT_RDWR); + } + th.join(); + return false; + } + th.join(); + try { + fut.get(); + return true; + } catch (...) { + return false; + } +} + +struct Migration { + int version; + std::string path; +}; + +constexpr int kMigrationsAdvisoryLockKey = 0x6d747573; + + +Migration parse_migration_name(const fs::path& p) { + const std::string name = p.filename().string(); + const auto dot = name.find('.'); + + if (dot == std::string::npos || name.substr(dot) != ".sql") { + throw std::runtime_error("migration file must end with .sql: " + name); + } + + const auto us = name.find('_'); + if (us == std::string::npos || us == 0) { + throw std::runtime_error( + "migration file must be named NNN_name.sql: " + name); + } + + const std::string num = name.substr(0, us); + if (!std::all_of(num.begin(), num.end(), + [](unsigned char c){ return std::isdigit(c); })) { + throw std::runtime_error( + "migration file prefix must be digits: " + name); + } + + Migration m; + m.version = std::stoi(num); + m.path = p.string(); + return m; +}} + + +void apply_migrations(pqxx::connection& conn, const std::string& dir) { + { + pqxx::work tx(conn); + tx.exec("SELECT pg_advisory_lock($1)", + pqxx::params{kMigrationsAdvisoryLockKey}); + tx.commit(); + } + std::clog << "migration advisory lock acquired\n"; + struct Unlock { + pqxx::connection& c; + ~Unlock() { + try { + pqxx::work tx(c); + tx.exec("SELECT pg_advisory_unlock($1)", + pqxx::params{kMigrationsAdvisoryLockKey}); + tx.commit(); + } catch (...) {} + } + } unlock_guard{conn}; + + { + pqxx::work tx(conn); + tx.exec( + "CREATE TABLE IF NOT EXISTS schema_migrations (" + " version int PRIMARY KEY," + " applied_at timestamptz NOT NULL DEFAULT now()" + ")"); + tx.commit(); + } + + if (!fs::exists(dir) || !fs::is_directory(dir)) { + throw std::runtime_error("migrations dir not found: " + dir); + } + std::vector files; + for (const auto& entry : fs::directory_iterator(dir)) { + if (entry.is_regular_file()) { + files.push_back(parse_migration_name(entry.path())); + } + } + std::sort(files.begin(), files.end(), + [](const Migration& a, const Migration& b){ + return a.version < b.version; + }); + + for (std::size_t i = 1; i < files.size(); ++i) { + if (files[i].version == files[i-1].version) { + throw std::runtime_error( + "duplicate migration version: " + std::to_string(files[i].version)); + } + } + + std::set applied; + { + pqxx::work tx(conn); + for (const auto& row : tx.exec("SELECT version FROM schema_migrations")) { + applied.insert(row[0].as()); + } + tx.commit(); + } + + for (const auto& m : files) { + if (applied.count(m.version)) { + continue; + } + + std::ifstream f(m.path, std::ios::binary); + if (!f) { + throw std::runtime_error("cannot open migration: " + m.path); + } + std::stringstream buf; + buf << f.rdbuf(); + const std::string sql = buf.str(); + + pqxx::work tx(conn); + tx.exec(sql); + tx.exec("INSERT INTO schema_migrations(version) VALUES ($1)", + m.version); + tx.commit(); + + std::clog << "applied migration " << m.version + << " (" << m.path << ")\n"; + } +} + + +std::string read_secret_file(const char* env_name) { + const char* path = std::getenv(env_name); + + if (path == nullptr || *path == '\0') { + throw std::runtime_error( + std::string("environment variable not set: ") + env_name); + } + + std::ifstream f(path, std::ios::binary); + if (!f) { + throw std::runtime_error( + std::string("cannot open secret file: ") + path); + } + + std::string s; + std::getline(f, s); + if (!s.empty() && s.back() == '\r') { + s.pop_back(); + } + + if (s.empty()) { + throw std::runtime_error( + std::string("secret file is empty: ") + path); + } + + return s; +} + + +bool is_dependency_failure(const std::exception& e) { + if (dynamic_cast(&e) != nullptr || + dynamic_cast(&e) != nullptr || + dynamic_cast(&e) != nullptr) { + return true; + } + if (const auto* sql = dynamic_cast(&e)) { + // 08xxx — ошибки соединения, 57xxx — отмена (statement_timeout) и остановка сервера. + const std::string& state = sql->sqlstate(); + return state.rfind("08", 0) == 0 || state.rfind("57", 0) == 0; + } + return false; +} + + +std::unique_ptr open_pg_connection(const std::string& conninfo, + bool statement_timeout) { + std::string full = add_conn_param(conninfo, "connect_timeout", + std::to_string(kConnectTimeoutSeconds)); + full = add_conn_param(full, "tcp_user_timeout", std::to_string(kTcpUserTimeoutMs)); + auto conn = std::make_unique(full); + const int fd = conn->sock(); + if (fd >= 0) { + timeval tv{}; + tv.tv_sec = kClientIoTimeoutSeconds; + tv.tv_usec = 0; + ::setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, sizeof(tv)); + ::setsockopt(fd, SOL_SOCKET, SO_SNDTIMEO, &tv, sizeof(tv)); + } + if (statement_timeout) { + pqxx::nontransaction tx(*conn); + tx.exec("SET statement_timeout = " + std::to_string(kStatementTimeoutMs)); + } + return conn; +} + + +PgPool::PgPool(std::string conninfo, std::size_t n) + : conninfo_(std::move(conninfo)) { + if (n == 0) { + throw std::runtime_error("PgPool: n must be > 0"); + } + all_.reserve(n); + idle_.reserve(n); + for (std::size_t i = 0; i < n; ++i) { + auto conn = open_pg_connection(conninfo_, true); + idle_.push_back(conn.get()); + all_.push_back(std::move(conn)); + } +} + + +PgPool::~PgPool() { + { + std::lock_guard lk(mu_); + shutting_down_ = true; + } + cv_.notify_all(); +} + + +pqxx::connection* PgPool::take() { + std::unique_lock lk(mu_); + if (!cv_.wait_for(lk, kAcquireTimeout, + [&]() { return shutting_down_ || !idle_.empty(); })) { + throw DependencyUnavailable("postgres pool: acquire timeout"); + } + if (shutting_down_) { + throw DependencyUnavailable("postgres pool is shutting down"); + } + pqxx::connection* conn = idle_.back(); + idle_.pop_back(); + lk.unlock(); + + if (is_alive(conn)) { + return conn; + } + + std::unique_ptr fresh; + try { + fresh = open_pg_connection(conninfo_, true); + } catch (const std::exception& e) { + // Мёртвое соединение возвращается в пул: следующий take() снова + // попробует переподключиться, и пул не теряет слот. + give_back(conn); + throw DependencyUnavailable(std::string("postgres reconnect failed: ") + e.what()); + } + + std::lock_guard lk2(mu_); + for (auto& up : all_) { + if (up.get() == conn) { + up = std::move(fresh); + return up.get(); + } + } + throw std::logic_error("PgPool: connection not owned by pool"); +} + + +void PgPool::give_back(pqxx::connection* conn) { + { + std::lock_guard lk(mu_); + idle_.push_back(conn); + } + cv_.notify_one(); +} + + +PgPool::Lease::Lease(PgPool& pool) : pool_(&pool), conn_(pool.take()) {} + +PgPool::Lease::~Lease() { + if (pool_ != nullptr && conn_ != nullptr) { + pool_->give_back(conn_); + } +} + +PgPool::Lease::Lease(Lease&& other) noexcept + : pool_(other.pool_), conn_(other.conn_) { + other.pool_ = nullptr; + other.conn_ = nullptr; +} + +PgPool::Lease PgPool::acquire() { + return Lease(*this); +} + +bool PgPool::ping() { + try { + auto lease = acquire(); + pqxx::work tx(*lease); + tx.exec("SELECT 1"); + tx.commit(); + return true; + } catch (...) { + return false; + } +} \ No newline at end of file diff --git a/src/db.hpp b/src/db.hpp new file mode 100644 index 00000000..bacfa92b --- /dev/null +++ b/src/db.hpp @@ -0,0 +1,62 @@ +#pragma once +#include + +#include + +#include +#include +#include +#include +#include + + +std::string read_secret_file(const char* env_name); + +std::unique_ptr open_pg_connection(const std::string& conninfo, + bool statement_timeout); + + +void apply_migrations(pqxx::connection& conn, const std::string& dir); + + +class PgPool { +public: + bool ping(); + PgPool(std::string conninfo, std::size_t n); + ~PgPool(); + + PgPool(const PgPool&) = delete; + PgPool& operator=(const PgPool&) = delete; + + class Lease { + public: + explicit Lease(PgPool& pool); + ~Lease(); + Lease(Lease&& other) noexcept; + Lease& operator=(Lease&&) = delete; + Lease(const Lease&) = delete; + Lease& operator=(const Lease&) = delete; + + pqxx::connection& operator*() const { return *conn_; } + pqxx::connection* operator->() const { return conn_; } + + private: + PgPool* pool_; + pqxx::connection* conn_; + }; + + Lease acquire(); + +private: + friend class Lease; + + pqxx::connection* take(); + void give_back(pqxx::connection* conn); + + std::string conninfo_; + std::vector> all_; + std::vector idle_; + std::mutex mu_; + std::condition_variable cv_; + bool shutting_down_ = false; +}; \ No newline at end of file diff --git a/src/direct_upload_repo.cpp b/src/direct_upload_repo.cpp new file mode 100644 index 00000000..d24b04c2 --- /dev/null +++ b/src/direct_upload_repo.cpp @@ -0,0 +1,292 @@ +#include "direct_upload_repo.hpp" +#include "outbox.hpp" + +#include +#include + +#include +#include +#include +#include + +namespace { + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()) + .count(); + return std::to_string(secs); +} + +DirectUpload row_to(const pqxx::row& r) { + DirectUpload d; + d.id = r["id"].as(); + d.chat_id = r["chat_id"].as(); + d.owner_id = r["owner_id"].as(); + d.filename = r["filename"].as(); + d.content_type = r["content_type"].as(); + d.expected_size = r["expected_size"].as(); + d.expected_sha256 = r["expected_sha256"].as(); + d.s3_key = r["s3_key"].as(); + d.staging_key = r["staging_key"].as(); + d.status = r["status"].as(); + d.overdue = r["overdue"].as(); + if (r["attachment_id"].is_null()) { + d.attachment_id = std::nullopt; + } else { + d.attachment_id = r["attachment_id"].as(); + } + d.expires_at = epoch_to_rfc3339(r["expires_at_epoch"].as()); + d.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + d.updated_at = epoch_to_rfc3339(r["updated_at_epoch"].as()); + return d; +} + +constexpr const char* kCols = + "id, chat_id, owner_id, filename, content_type, expected_size, " + "expected_sha256, s3_key, staging_key, status, attachment_id, " + "(status = 'pending' AND expires_at < now()) AS overdue, " + "EXTRACT(EPOCH FROM expires_at)::bigint AS expires_at_epoch, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch, " + "EXTRACT(EPOCH FROM updated_at)::bigint AS updated_at_epoch"; + +constexpr const char* kAttachmentColumns = + "id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + "status, s3_key, error_code, variants, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch, " + "EXTRACT(EPOCH FROM updated_at)::bigint AS updated_at_epoch"; + +Attachment attachment_from_row(const pqxx::row& r) { + Attachment a; + a.id = r["id"].as(); + a.chat_id = r["chat_id"].as(); + a.owner_id = r["owner_id"].as(); + a.filename = r["filename"].as(); + a.content_type = r["content_type"].as(); + a.size_bytes = r["size_bytes"].as(); + a.sha256 = r["sha256"].as(); + a.status = r["status"].as(); + a.s3_key = r["s3_key"].as(); + if (r["error_code"].is_null()) { + a.error_code = std::nullopt; + } else { + a.error_code = r["error_code"].as(); + } + a.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + a.updated_at = epoch_to_rfc3339(r["updated_at_epoch"].as()); + for (const auto& v : nlohmann::json::parse(r["variants"].as())) { + a.variants.push_back(Variant{v.at("name").get(), + v.at("content_type").get(), v.at("size_bytes").get(), + v.at("sha256").get(), v.at("width").get(), + v.at("height").get(), v.value("storage_key", "")}); + } + return a; +} + +} // namespace + +DirectUpload DirectUploadRepo::insert(const DirectUpload& in) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + const std::string ts = now_epoch_str(); + // expires_at is already an absolute epoch string from the caller. + auto r = tx.exec( + "INSERT INTO direct_uploads (" + " id, chat_id, owner_id, filename, content_type, expected_size, " + " expected_sha256, s3_key, staging_key, status, attachment_id, " + " expires_at, created_at, updated_at" + ") VALUES (" + " $1::uuid, $2::uuid, $3::uuid, $4, $5, $6, $7, $8, $9, $10, NULL, " + " to_timestamp($11::bigint), to_timestamp($12::bigint), " + " to_timestamp($13::bigint)" + ") RETURNING " + + std::string(kCols), + pqxx::params{in.id, in.chat_id, in.owner_id, in.filename, + in.content_type, in.expected_size, in.expected_sha256, + in.s3_key, in.staging_key, in.status, in.expires_at_epoch, + ts, ts}); + tx.commit(); + return row_to(r[0]); +} + +std::optional DirectUploadRepo::find_by_id( + const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kCols) + + " FROM direct_uploads WHERE id = $1::uuid", + pqxx::params{id}); + if (r.empty()) { + return std::nullopt; + } + return row_to(r[0]); +} + +std::optional DirectUploadRepo::mark_completed( + const std::string& id, const std::string& attachment_id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + const std::string ts = now_epoch_str(); + auto r = tx.exec( + "UPDATE direct_uploads SET status = 'completed', " + " attachment_id = $2::uuid, " + " updated_at = to_timestamp($3::bigint) " + "WHERE id = $1::uuid AND status = 'pending' " + "RETURNING " + + std::string(kCols), + pqxx::params{id, attachment_id, ts}); + if (r.empty()) { + return std::nullopt; + } + tx.commit(); + return row_to(r[0]); +} + +std::optional DirectUploadRepo::mark_aborted( + const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + const std::string ts = now_epoch_str(); + auto r = tx.exec( + "UPDATE direct_uploads SET status = 'aborted', " + " updated_at = to_timestamp($2::bigint) " + "WHERE id = $1::uuid AND status = 'pending' " + "RETURNING " + + std::string(kCols), + pqxx::params{id, ts}); + if (r.empty()) { + return std::nullopt; + } + tx.commit(); + return row_to(r[0]); +} + +std::vector DirectUploadRepo::expire_stale() { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + const std::string ts = now_epoch_str(); + auto r = tx.exec( + "UPDATE direct_uploads SET status = 'expired', " + " updated_at = to_timestamp($1::bigint) " + "WHERE status = 'pending' AND expires_at < now() " + "RETURNING " + + std::string(kCols), + pqxx::params{ts}); + tx.commit(); + std::vector out; + out.reserve(r.size()); + for (const auto& row : r) { + out.push_back(row_to(row)); + } + return out; +} + +std::vector DirectUploadRepo::pending_s3_keys() { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT staging_key FROM direct_uploads WHERE status = 'pending'"); + std::vector out; + out.reserve(r.size()); + for (const auto& row : r) { + out.push_back(row["staging_key"].as()); + } + return out; +} + +void DirectUploadRepo::with_lock(const std::function& fn) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + UploadLock lock(tx); + fn(lock); +} + +std::optional UploadLock::lock(const std::string& id) { + auto r = tx_.exec( + "SELECT " + std::string(kCols) + + " FROM direct_uploads WHERE id = $1::uuid FOR UPDATE", + pqxx::params{id}); + if (r.empty()) { + return std::nullopt; + } + return row_to(r[0]); +} + +std::optional UploadLock::find_attachment(const std::string& id) { + auto r = tx_.exec( + "SELECT " + std::string(kAttachmentColumns) + + " FROM attachments WHERE id = $1::uuid", + pqxx::params{id}); + if (r.empty()) { + return std::nullopt; + } + return attachment_from_row(r[0]); +} + +std::optional UploadLock::insert_queued(const Attachment& in, + bool& inserted) { + inserted = false; + const std::string ts = now_epoch_str(); + auto r = tx_.exec( + "INSERT INTO attachments (" + " id, chat_id, owner_id, filename, content_type, size_bytes, sha256, " + " status, s3_key, staging_key, error_code, created_at, updated_at" + ") VALUES (" + " $1::uuid, $2::uuid, $3::uuid, $4, $5, $6, $7, $8, $9, $9, NULL, " + " to_timestamp($10::bigint), to_timestamp($11::bigint)" + ") ON CONFLICT (id) DO NOTHING RETURNING " + + std::string(kAttachmentColumns), + pqxx::params{in.id, in.chat_id, in.owner_id, in.filename, + in.content_type, in.size_bytes, in.sha256, in.status, + in.s3_key, ts, ts}); + if (r.empty()) { + return std::nullopt; + } + tx_.exec("INSERT INTO jobs(id, attachment_id, source_key) VALUES($1::uuid, $1::uuid, $2)", + pqxx::params{in.id, in.s3_key}); + enqueue_attachment_job(tx_, in.id); + inserted = true; + return attachment_from_row(r[0]); +} + +void UploadLock::mark_completed(const std::string& id, + const std::string& attachment_id) { + const std::string ts = now_epoch_str(); + auto r = tx_.exec( + "UPDATE direct_uploads SET status = 'completed', " + " attachment_id = $2::uuid, " + " updated_at = to_timestamp($3::bigint) " + "WHERE id = $1::uuid AND status = 'pending'", + pqxx::params{id, attachment_id, ts}); + if (r.affected_rows() != 1) { + throw std::runtime_error("direct upload complete lost the pending row"); + } +} + +void UploadLock::mark_expired(const std::string& id) { + const std::string ts = now_epoch_str(); + tx_.exec( + "UPDATE direct_uploads SET status = 'expired', " + " updated_at = to_timestamp($2::bigint) " + "WHERE id = $1::uuid AND status = 'pending'", + pqxx::params{id, ts}); +} + +void UploadLock::commit() { + if (committed_) { + return; + } + tx_.commit(); + committed_ = true; +} diff --git a/src/direct_upload_repo.hpp b/src/direct_upload_repo.hpp new file mode 100644 index 00000000..8fa6f8c0 --- /dev/null +++ b/src/direct_upload_repo.hpp @@ -0,0 +1,63 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include +#include + +class UploadLock; + +class DirectUploadRepo { +public: + explicit DirectUploadRepo(PgPool& pool) : pool_(pool) {} + + DirectUpload insert(const DirectUpload& in); + + std::optional find_by_id(const std::string& id); + + // Mark completed and link attachment_id. Returns nullopt if not pending + // (or already finished / wrong owner handled by caller). + std::optional mark_completed(const std::string& id, + const std::string& attachment_id); + + std::optional mark_aborted(const std::string& id); + + // pending → expired where expires_at < now; returns expired rows. + std::vector expire_stale(); + + // Staging keys of still-pending sessions (orphan GC must keep these). + std::vector pending_s3_keys(); + + // One PG transaction. Callback may call S3 while the row lock is held. + // Commit explicitly via UploadLock::commit(); otherwise the work rolls back. + void with_lock(const std::function& fn); + +private: + PgPool& pool_; +}; + +// Row lock for a single complete(). Not safe to use after with_lock returns. +class UploadLock { +public: + std::optional lock(const std::string& id); + + std::optional find_attachment(const std::string& id); + + // Inserts attachment and its job in this transaction; job_id equals attachment id. + // ON CONFLICT (id) DO NOTHING. inserted=false and nullopt → row already exists. + std::optional insert_queued(const Attachment& in, bool& inserted); + + void mark_completed(const std::string& id, const std::string& attachment_id); + void mark_expired(const std::string& id); + void commit(); + +private: + friend class DirectUploadRepo; + explicit UploadLock(pqxx::work& tx) : tx_(tx) {} + + pqxx::work& tx_; + bool committed_ = false; +}; diff --git a/src/errors.hpp b/src/errors.hpp new file mode 100644 index 00000000..85899576 --- /dev/null +++ b/src/errors.hpp @@ -0,0 +1,15 @@ +#pragma once + +#include +#include + +// PostgreSQL или Valkey недоступны либо не ответили вовремя: клиент получает 503. +struct DependencyUnavailable : std::runtime_error { + using std::runtime_error::runtime_error; +}; + +struct AttachmentFailed : std::runtime_error { + AttachmentFailed() : std::runtime_error("attachment processing failed") {} +}; + +bool is_dependency_failure(const std::exception& e); diff --git a/src/fault_injection.hpp b/src/fault_injection.hpp new file mode 100644 index 00000000..85dea36f --- /dev/null +++ b/src/fault_injection.hpp @@ -0,0 +1,42 @@ +#pragma once + +#include +#include + +// Explicit local-test opt-in; no HTTP parameter can enable fault injection. +inline void lab_crash_at(const char* point) { + const char* enabled = std::getenv("LAB_ENABLE_FAULT_INJECTION"); + const char* selected = std::getenv("LAB_FAULT_POINT"); + if (enabled && std::strcmp(enabled, "1") == 0 && selected && + std::strcmp(selected, point) == 0) std::_Exit(86); +} + +#include +#include +#include +#include +#include + +// One injection per container/job/point; marker survives a process restart. +inline void lab_worker_fault(const char* point, const std::string& job_id, int version) { + const char* enabled = std::getenv("LAB_ENABLE_FAULT_INJECTION"); + const char* selected = std::getenv("LAB_FAULT_POINT"); + if (!enabled || std::strcmp(enabled, "1") || !selected || std::strcmp(selected, point)) return; + const char* job = std::getenv("LAB_FAULT_JOB_ID"); + const char* target_version = std::getenv("LAB_FAULT_PIPELINE_VERSION"); + if ((job && job_id != job) || (target_version && std::to_string(version) != target_version)) return; + const std::string base = "/tmp/lab-fault/" + std::string(point) + "." + job_id; + std::filesystem::create_directories("/tmp/lab-fault"); + if (std::filesystem::exists(base + ".reached")) return; + std::ofstream marker(base + ".reached"); + marker << version << '\n'; + marker.close(); + const char* action = std::getenv("LAB_FAULT_ACTION"); + if (action && std::strcmp(action, "pause") == 0) { + while (!std::filesystem::exists(base + ".release")) { + std::this_thread::sleep_for(std::chrono::milliseconds(25)); + } + } else { + std::_Exit(86); + } +} diff --git a/src/image_pipeline.cpp b/src/image_pipeline.cpp new file mode 100644 index 00000000..23d3e612 --- /dev/null +++ b/src/image_pipeline.cpp @@ -0,0 +1,151 @@ +#include "image_pipeline.hpp" +#include "image_util.hpp" + +#include +#define STB_IMAGE_RESIZE_IMPLEMENTATION +#include +#define STB_IMAGE_WRITE_IMPLEMENTATION +#include +#include +#include + +#include +#include +#include + +namespace { +int orientation(const std::vector& bytes) { + const unsigned char* data = bytes.data(); + std::size_t size = bytes.size(); + std::vector exif; + // PNG eXIf stores a TIFF header without the JPEG Exif prefix. + if (size >= 8 && std::memcmp(data, "\x89PNG\r\n\x1a\n", 8) == 0) { + for (std::size_t pos = 8; pos + 12 <= size;) { + const std::uint32_t len = (std::uint32_t(data[pos]) << 24) | + (std::uint32_t(data[pos + 1]) << 16) | + (std::uint32_t(data[pos + 2]) << 8) | data[pos + 3]; + if (len > size - pos - 12) break; + if (std::memcmp(data + pos + 4, "eXIf", 4) == 0) { + exif.assign({'E', 'x', 'i', 'f', 0, 0}); + exif.insert(exif.end(), data + pos + 8, data + pos + 8 + len); + data = exif.data(); + size = exif.size(); + break; + } + pos += std::size_t(len) + 12; + } + } + std::unique_ptr metadata( + exif_data_new_from_data(data, static_cast(size)), exif_data_unref); + if (!metadata) return 1; + const auto* entry = exif_content_get_entry(metadata->ifd[EXIF_IFD_0], EXIF_TAG_ORIENTATION); + if (!entry || entry->format != EXIF_FORMAT_SHORT || entry->size < 2) return 1; + const int result = exif_get_short(entry->data, exif_data_get_byte_order(metadata.get())); + return result >= 1 && result <= 8 ? result : 1; +} +struct Raster { + std::vector pixels; + int width; + int height; +}; + +Raster decode(const std::vector& bytes) { + const ImageLimits limits; + if (bytes.empty() || bytes.size() > static_cast(limits.max_bytes) || + !sniff_content_type(bytes.data(), bytes.size())) { + throw InvalidImage("invalid_image"); + } + int w = 0, h = 0, channels = 0; + if (!stbi_info_from_memory(bytes.data(), static_cast(bytes.size()), &w, &h, &channels) || + w <= 0 || h <= 0) throw InvalidImage("invalid_image"); + if (std::int64_t(w) * h > limits.max_pixels) throw InvalidImage("image_too_large"); + std::unique_ptr rgba( + stbi_load_from_memory(bytes.data(), static_cast(bytes.size()), &w, &h, &channels, 4), + stbi_image_free); + if (!rgba) throw InvalidImage("invalid_image"); + const int o = orientation(bytes); + const int width = o >= 5 ? h : w; + const int height = o >= 5 ? w : h; + std::vector rgb(std::size_t(width) * height * 3); + for (int y = 0; y < h; ++y) { + for (int x = 0; x < w; ++x) { + int dx = x, dy = y; + switch (o) { + case 2: dx = w - 1 - x; break; + case 3: dx = w - 1 - x; dy = h - 1 - y; break; + case 4: dy = h - 1 - y; break; + case 5: dx = y; dy = x; break; + case 6: dx = h - 1 - y; dy = x; break; + case 7: dx = h - 1 - y; dy = w - 1 - x; break; + case 8: dx = y; dy = w - 1 - x; break; + } + const auto* pixel = rgba.get() + (std::size_t(y) * w + x) * 4; + auto* target = rgb.data() + (std::size_t(dy) * width + dx) * 3; + for (int c = 0; c < 3; ++c) { + target[c] = static_cast( + (pixel[c] * pixel[3] + 255 * (255 - pixel[3]) + 127) / 255); + } + } + } + rgba.reset(); + return Raster{std::move(rgb), width, height}; +} + +Raster resize(const unsigned char* pixels, int width, int height, int stride, + int out_w, int out_h) { + Raster result{std::vector(std::size_t(out_w) * out_h * 3), out_w, out_h}; + if (!stbir_resize_uint8(pixels, width, height, stride, + result.pixels.data(), out_w, out_h, 0, 3)) { + throw std::runtime_error("resize failed"); + } + return result; +} + +Raster fit(const Raster& input, int limit) { + const int extent = std::max(input.width, input.height); + const int w = extent > limit ? std::max(1, std::int64_t(input.width) * limit / extent) : input.width; + const int h = extent > limit ? std::max(1, std::int64_t(input.height) * limit / extent) : input.height; + return resize(input.pixels.data(), input.width, input.height, 0, w, h); +} + +EncodedImage jpeg(const Raster& raster, int quality = 85) { + EncodedImage image{{}, raster.width, raster.height}; + const auto write = [](void* context, void* data, int size) { + static_cast(context)->append(static_cast(data), size); + }; + if (!stbi_write_jpg_to_func(write, &image.bytes, raster.width, raster.height, + 3, raster.pixels.data(), quality)) { + throw std::runtime_error("JPEG encoding failed"); + } + return image; +} + +EncodedImage webp(const Raster& raster, float quality) { + unsigned char* output = nullptr; + const auto size = WebPEncodeRGB(raster.pixels.data(), raster.width, raster.height, + raster.width * 3, quality, &output); + std::unique_ptr owned(output, WebPFree); + if (!size) throw std::runtime_error("WebP encoding failed"); + return EncodedImage{std::string(reinterpret_cast(output), size), + raster.width, raster.height}; +} +} // namespace + +EncodedImage make_thumbnail(const std::vector& bytes) { + return jpeg(fit(decode(bytes), 256)); +} + +std::vector make_variants(const std::vector& bytes, int version) { + if (version != 1 && version != 2) throw std::invalid_argument("unsupported pipeline version"); + const int quality = version == 1 ? 85 : 90; + const auto raster = decode(bytes); + std::vector result; + result.push_back({"thumbnail", "image/jpeg", jpeg(fit(raster, 256), quality)}); + const int side = std::min(raster.width, raster.height); + const int left = (raster.width - side) / 2; + const int top = (raster.height - side) / 2; + const auto* center = raster.pixels.data() + (std::size_t(top) * raster.width + left) * 3; + result.push_back({"crop", "image/jpeg", jpeg(resize(center, side, side, raster.width * 3, 128, 128), quality)}); + result.push_back({"optimized", "image/webp", webp(fit(raster, 1280), version == 1 ? 80.0f : 90.0f)}); + return result; +} diff --git a/src/image_pipeline.hpp b/src/image_pipeline.hpp new file mode 100644 index 00000000..5d3afdc4 --- /dev/null +++ b/src/image_pipeline.hpp @@ -0,0 +1,25 @@ +#pragma once + +#include +#include +#include +#include + +struct InvalidImage : std::runtime_error { + explicit InvalidImage(const char* code) : std::runtime_error(code) {} +}; + +struct EncodedImage { + std::string bytes; + int width; + int height; +}; + +struct EncodedVariant { + std::string name; + std::string content_type; + EncodedImage image; +}; + +std::vector make_variants(const std::vector& original, int version = 1); +EncodedImage make_thumbnail(const std::vector& original); diff --git a/src/image_util.cpp b/src/image_util.cpp new file mode 100644 index 00000000..92d8976e --- /dev/null +++ b/src/image_util.cpp @@ -0,0 +1,90 @@ +#include "image_util.hpp" + +#define STB_IMAGE_IMPLEMENTATION +#define STBI_NO_STDIO +#define STBI_ONLY_JPEG +#define STBI_ONLY_PNG +#include "stb_image.h" + +#include + +std::optional sniff_content_type(const std::uint8_t* data, + std::size_t len) { + if (!data || len < 3) { + return std::nullopt; + } + // JPEG: FF D8 FF + if (data[0] == 0xFF && data[1] == 0xD8 && data[2] == 0xFF) { + return std::string("image/jpeg"); + } + // PNG: 89 50 4E 47 + if (len >= 4 && data[0] == 0x89 && data[1] == 0x50 && data[2] == 0x4E && + data[3] == 0x47) { + return std::string("image/png"); + } + return std::nullopt; +} + +std::string_view image_reject_code(ImageReject r) { + switch (r) { + case ImageReject::unsupported_media_type: + return "unsupported_media_type"; + case ImageReject::payload_too_large: + return "payload_too_large"; + case ImageReject::invalid_image: + return "invalid_image"; + } + return "invalid_image"; +} + +std::optional validate_image(const std::uint8_t* data, + std::size_t len, + const ImageLimits& limits, + ImageInfo& out) { + if (!data || len == 0) { + return ImageReject::unsupported_media_type; + } + if (static_cast(len) > limits.max_bytes) { + return ImageReject::payload_too_large; + } + + auto sniffed = sniff_content_type(data, len); + if (!sniffed) { + return ImageReject::unsupported_media_type; + } + + int w = 0; + int h = 0; + int comp = 0; + if (!stbi_info_from_memory(reinterpret_cast(data), + static_cast(len), &w, &h, &comp)) { + return ImageReject::invalid_image; + } + if (w <= 0 || h <= 0) { + return ImageReject::invalid_image; + } + + const std::int64_t pixels = + static_cast(w) * static_cast(h); + if (pixels > limits.max_pixels) { + return ImageReject::payload_too_large; + } + + int load_w = 0; + int load_h = 0; + int load_comp = 0; + stbi_uc* decoded = stbi_load_from_memory( + reinterpret_cast(data), static_cast(len), &load_w, + &load_h, &load_comp, 0); + if (!decoded) { + return ImageReject::invalid_image; + } + // Integrity only — do not retain decoded raster. + stbi_image_free(decoded); + + out.content_type = *sniffed; + out.width = w; + out.height = h; + out.pixel_count = pixels; + return std::nullopt; +} diff --git a/src/image_util.hpp b/src/image_util.hpp new file mode 100644 index 00000000..f39a310f --- /dev/null +++ b/src/image_util.hpp @@ -0,0 +1,41 @@ +#pragma once + +#include +#include +#include +#include +#include + +struct ImageLimits { + std::int64_t max_bytes = 10'485'760; // 10 MiB + std::int64_t max_pixels = 40'000'000; // decoded width*height +}; + +enum class ImageReject { + unsupported_media_type, // → 415 + payload_too_large, // → 413 (bytes or pixels) + invalid_image, // → 415 (corrupt / undecodable) +}; + +struct ImageInfo { + std::string content_type; // image/png | image/jpeg + int width = 0; + int height = 0; + std::int64_t pixel_count = 0; +}; + +// Magic sniff only (does not decode). Returns nullopt if neither PNG nor JPEG. +std::optional sniff_content_type(const std::uint8_t* data, + std::size_t len); + +// Full validation pipeline from contracts: +// sniff → stbi_info (dims) → pixel limit → stbi_load (integrity) → free. +// On success fills `out`. On failure returns ImageReject; decoded pixels are +// never retained after return. +std::optional validate_image(const std::uint8_t* data, + std::size_t len, + const ImageLimits& limits, + ImageInfo& out); + +// Human-readable error_code for Attachment failed path / API body. +std::string_view image_reject_code(ImageReject r); diff --git a/src/job_admin_main.cpp b/src/job_admin_main.cpp new file mode 100644 index 00000000..e2fb96d7 --- /dev/null +++ b/src/job_admin_main.cpp @@ -0,0 +1,110 @@ +#include "db.hpp" +#include "outbox.hpp" +#include "s3_client.hpp" + +#include +#include +#include +#include + +namespace { +void verify_source(S3Client& s3, const std::string& key, std::size_t expected, + const std::string& checksum) { + crypto_hash_sha256_state state; + crypto_hash_sha256_init(&state); + std::size_t received = 0; + s3.get_object(key, [&](const char* data, std::size_t n) { + if (received > expected || n > expected - received) throw std::runtime_error("source mismatch"); + crypto_hash_sha256_update(&state, reinterpret_cast(data), n); + received += n; + }); + unsigned char digest[crypto_hash_sha256_BYTES]; + crypto_hash_sha256_final(&state, digest); + char hex[crypto_hash_sha256_BYTES * 2 + 1]; + sodium_bin2hex(hex, sizeof(hex), digest, sizeof(digest)); + if (received != expected || checksum != hex) throw std::runtime_error("source checksum mismatch"); +} +} + +int main(int argc, char** argv) { + const bool replay = argc == 7 && std::string(argv[1]) == "replay" && + std::string(argv[3]) == "--actor" && std::string(argv[5]) == "--reason"; + const bool upgrade = argc == 9 && std::string(argv[1]) == "upgrade" && + std::string(argv[3]) == "--version" && std::string(argv[5]) == "--actor" && + std::string(argv[7]) == "--reason"; + if (!replay && !upgrade) { + std::cerr << "usage: job_admin replay JOB_UUID --actor NAME --reason REASON\n" + " job_admin upgrade ATTACHMENT_UUID --version 2 --actor NAME --reason REASON\n"; + return 2; + } + const std::string id = argv[2], actor = argv[replay ? 4 : 6], reason = argv[replay ? 6 : 8]; + const std::regex uuid("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + if (!std::regex_match(id, uuid) || actor.empty() || actor.size() > 100 || reason.empty() || + reason.size() > 500 || actor.find_first_not_of(" \t\r\n") == std::string::npos || + reason.find_first_not_of(" \t\r\n") == std::string::npos) return 2; + if (upgrade && std::string(argv[4]) != "1" && std::string(argv[4]) != "2") return 2; + try { + if (sodium_init() < 0) return 1; + auto conn = open_pg_connection(read_secret_file("DATABASE_URL_FILE"), true); + S3Client s3(S3Client::from_env()); + pqxx::work tx(*conn); + if (upgrade) { + const int version = std::stoi(argv[4]); + tx.exec("SELECT pg_advisory_xact_lock(hashtextextended('pipeline:' || $1::uuid::text,0))", pqxx::params{id}); + auto rows = tx.exec("SELECT pipeline_version,s3_key,size_bytes,sha256 FROM attachments " + "WHERE id=$1::uuid FOR UPDATE", pqxx::params{id}); + if (rows.empty() || version < rows[0]["pipeline_version"].as()) return 1; + if (version == rows[0]["pipeline_version"].as()) { + const auto jobs = tx.exec("SELECT id FROM jobs WHERE attachment_id=$1::uuid AND pipeline_version=$2", + pqxx::params{id, version}); + if (jobs.empty()) return 1; + std::cout << nlohmann::json{{"job_id", jobs[0][0].as()}, + {"pipeline_version", version}, {"created", false}}.dump() << '\n'; + return 0; + } + const auto& row = rows[0]; + verify_source(s3, row["s3_key"].as(), row["size_bytes"].as(), row["sha256"].as()); + const auto job = tx.exec("INSERT INTO jobs(id,attachment_id,pipeline_version,source_key) " + "VALUES(gen_random_uuid(),$1::uuid,$2,$3) RETURNING id", + pqxx::params{id, version, row["s3_key"].as()})[0][0].as(); + tx.exec("UPDATE attachments SET pipeline_version=$2, " + "status=CASE WHEN published_version IS NULL THEN 'queued' ELSE status END, " + "error_code=CASE WHEN published_version IS NULL THEN NULL ELSE error_code END, " + "updated_at=CASE WHEN published_version IS NULL THEN now() ELSE updated_at END WHERE id=$1::uuid", + pqxx::params{id, version}); + tx.exec("INSERT INTO pipeline_requests(attachment_id,pipeline_version,job_id,actor,reason) " + "VALUES($1::uuid,$2,$3::uuid,$4,$5)", pqxx::params{id, version, job, actor, reason}); + enqueue_attachment_job(tx, job); + tx.commit(); + std::cout << nlohmann::json{{"job_id", job}, {"pipeline_version", version}, {"created", true}}.dump() << '\n'; + return 0; + } + if (!tx.exec("SELECT pg_try_advisory_xact_lock(hashtextextended($1::uuid::text,0))", + pqxx::params{id})[0][0].as()) return 1; + const auto rows = tx.exec( + "SELECT j.attachment_id,j.status,j.retries,j.source_key,j.pipeline_version, " + "a.pipeline_version AS desired_version,a.staging_cleaned_at,a.size_bytes,a.sha256 " + "FROM jobs j JOIN attachments a ON a.id=j.attachment_id " + "WHERE j.id=$1::uuid FOR UPDATE OF j,a", pqxx::params{id}); + if (rows.empty() || rows[0]["status"].as() != "failed" || + rows[0]["pipeline_version"].as() != rows[0]["desired_version"].as()) return 1; + const auto& row = rows[0]; + const std::string source = row["source_key"].as(); + if (source.rfind("staging/",0) == 0 && !row["staging_cleaned_at"].is_null()) return 1; + verify_source(s3, source, row["size_bytes"].as(), row["sha256"].as()); + tx.exec("INSERT INTO job_replays(job_id,actor,reason,previous_error_code,retries_before) " + "SELECT id,$2,$3,error_code,retries FROM jobs WHERE id=$1::uuid", pqxx::params{id, actor, reason}); + tx.exec("UPDATE jobs SET status='queued',retry_base=retries,error_code=NULL, " + "next_attempt_at=now(),updated_at=now() WHERE id=$1::uuid", pqxx::params{id}); + tx.exec("UPDATE attachments SET status='queued',s3_key=$2,error_code=NULL,variants='[]'::jsonb,updated_at=now() " + "WHERE id=$1::uuid AND published_version IS NULL", + pqxx::params{row["attachment_id"].as(), source}); + enqueue_attachment_job(tx, id); + tx.commit(); + std::cout << "replayed job=" << id << '\n'; + return 0; + } catch (const std::exception&) { + std::cerr << "operator action failed; transaction was not confirmed\n"; + return 1; + } +} diff --git a/src/job_repo.cpp b/src/job_repo.cpp new file mode 100644 index 00000000..71cabfb1 --- /dev/null +++ b/src/job_repo.cpp @@ -0,0 +1,137 @@ +#include "job_repo.hpp" +#include "image_pipeline.hpp" +#include "outbox.hpp" +#include "fault_injection.hpp" + +#include +#include +#include +#include + +JobRepo::Result JobRepo::run(const std::string& job_id, const std::string& attachment_id, + int version, int attempt, const std::function& process) { + auto lease = pool_.acquire(); + { + pqxx::nontransaction tx(*lease); + if (!tx.exec("SELECT pg_try_advisory_lock(hashtextextended($1::uuid::text, 0))", + pqxx::params{job_id})[0][0].as()) return Result::Busy; + } + struct Unlock { + pqxx::connection& conn; + const std::string& id; + ~Unlock() { + try { + pqxx::nontransaction tx(conn); + tx.exec("SELECT pg_advisory_unlock(hashtextextended($1::uuid::text, 0))", pqxx::params{id}); + } catch (...) {} + } + } unlock{*lease, job_id}; + JobInput input; + { + pqxx::work tx(*lease); + auto rows = tx.exec( + "SELECT j.status, j.retries, j.retry_base, j.source_key, j.pipeline_version AS job_version, " + "a.pipeline_version AS desired_version, j.next_attempt_at<=now() AS due, " + "a.status AS attachment_status FROM jobs j " + "JOIN attachments a ON a.id=j.attachment_id " + "WHERE j.id=$1::uuid AND j.attachment_id=$2::uuid FOR UPDATE OF j, a", + pqxx::params{job_id, attachment_id}); + if (rows.empty()) return Result::Missing; + const auto& row = rows[0]; + if (row["job_version"].as() != version) return Result::Missing; + const std::string status = row["status"].as(); + if (version < row["desired_version"].as() || status == "superseded") { + tx.exec("UPDATE jobs SET status='superseded', updated_at=now() " + "WHERE id=$1::uuid AND status IN ('queued','processing')", pqxx::params{job_id}); + tx.commit(); + return Result::Superseded; + } + if (version > row["desired_version"].as()) return Result::Missing; + if (status == "ready" || status == "failed") return Result::Done; + input = JobInput{version, row["source_key"].as()}; + const int retries = row["retries"].as(); + // A previous processing state with no advisory lock means its worker died. + if (status == "processing") { + return fail(tx, job_id, attachment_id, version, retries + 1, row["retry_base"].as(), "processing_failed", false); + } + // A newer attempt is already durable in outbox/the stream; discard an old delivery. + if (attempt < retries + 1) return Result::Scheduled; + if (attempt > retries + 1) return Result::Missing; + if (!row["due"].as()) return Result::Busy; + tx.exec("UPDATE jobs SET status='processing', error_code=NULL, updated_at=now() " + "WHERE id=$1::uuid", pqxx::params{job_id}); + tx.exec("UPDATE attachments SET status='processing', error_code=NULL, updated_at=now() " + "WHERE id=$1::uuid AND pipeline_version=$2 AND published_version IS NULL", + pqxx::params{attachment_id, version}); + tx.commit(); + } + try { + lab_worker_fault("worker_before_effect", job_id, version); + const JobResult result = process(input); + pqxx::work tx(*lease); + const auto current = tx.exec( + "SELECT a.pipeline_version FROM jobs j JOIN attachments a ON a.id=j.attachment_id " + "WHERE j.id=$1::uuid FOR UPDATE OF j,a", pqxx::params{job_id}); + tx.exec("INSERT INTO attachment_results(attachment_id,pipeline_version,job_id,original_key,variants) " + "VALUES($1::uuid,$2,$3::uuid,$4,$5::jsonb) ON CONFLICT DO NOTHING", + pqxx::params{attachment_id, version, job_id, result.original_key, result.variants_json}); + const bool publish = current[0][0].as() == version; + if (publish) { + // The pointer and complete result become visible in one transaction. + tx.exec("UPDATE attachments a SET status='ready', published_version=$2, " + "s3_key=r.original_key, variants=r.variants, error_code=NULL, updated_at=now() " + "FROM attachment_results r WHERE a.id=$1::uuid AND a.pipeline_version=$2 " + "AND r.attachment_id=a.id AND r.pipeline_version=$2", + pqxx::params{attachment_id, version}); + } + tx.exec("UPDATE jobs SET status=$2, error_code=NULL, updated_at=now() WHERE id=$1::uuid", + pqxx::params{job_id, publish ? "ready" : "superseded"}); + tx.commit(); + lab_worker_fault("worker_after_commit", job_id, version); + return publish ? Result::Done : Result::Superseded; + } catch (const std::exception& e) { + const auto* invalid = dynamic_cast(&e); + const std::string code = invalid ? invalid->what() : "processing_failed"; + pqxx::work tx(*lease); + auto rows = tx.exec("SELECT j.status,j.retries,j.retry_base,a.pipeline_version FROM jobs j " + "JOIN attachments a ON a.id=j.attachment_id WHERE j.id=$1::uuid FOR UPDATE OF j,a", + pqxx::params{job_id}); + if (rows.empty()) return Result::Missing; + if (rows[0]["pipeline_version"].as() != version) { + tx.exec("UPDATE jobs SET status='superseded',updated_at=now() WHERE id=$1::uuid " + "AND status IN ('queued','processing')", pqxx::params{job_id}); + tx.commit(); + return Result::Superseded; + } + const std::string status = rows[0]["status"].as(); + // A lost COMMIT reply must not roll back an already published ready result. + if (status == "ready" || status == "failed") return Result::Done; + return fail(tx, job_id, attachment_id, version, rows[0]["retries"].as() + 1, + rows[0]["retry_base"].as(), code, invalid != nullptr); + } +} + +JobRepo::Result JobRepo::fail(pqxx::work& tx, const std::string& job_id, + const std::string& attachment_id, int version, int retries, int retry_base, + const std::string& code, bool permanent) { + const bool failed = permanent || retries - retry_base >= policy_.max_attempts; + long long ceiling = policy_.base_delay_ms; + for (int i = 1; i < retries - retry_base; ++i) ceiling = std::min(policy_.max_delay_ms, ceiling * 2); + ceiling = std::min(policy_.max_delay_ms, ceiling); + thread_local std::mt19937 rng(std::random_device{}()); + const int delay = failed ? 0 : std::uniform_int_distribution( + static_cast((ceiling + 1) / 2), static_cast(ceiling))(rng); + tx.exec("UPDATE jobs SET status=$2, retries=$3, error_code=$4, " + "next_attempt_at=now()+($5::bigint * interval '1 millisecond'), updated_at=now() " + "WHERE id=$1::uuid", + pqxx::params{job_id, failed ? "failed" : "queued", retries, code, delay}); + tx.exec("UPDATE attachments SET status=$2, error_code=$3, updated_at=now() " + "WHERE id=$1::uuid AND status='processing' AND pipeline_version=$4 AND published_version IS NULL", + pqxx::params{attachment_id, failed ? "failed" : "queued", + failed ? std::optional(code) : std::nullopt, version}); + if (!failed) enqueue_attachment_job(tx, job_id); + tx.commit(); + std::clog << "job=" << job_id << " retries=" << retries << " error_code=" << code + << " retry_delay_ms=" << delay << '\n'; + return failed ? Result::Done : Result::Scheduled; +} diff --git a/src/job_repo.hpp b/src/job_repo.hpp new file mode 100644 index 00000000..d5e25bc2 --- /dev/null +++ b/src/job_repo.hpp @@ -0,0 +1,35 @@ +#pragma once + +#include "db.hpp" +#include +#include + +struct JobInput { + int pipeline_version; + std::string source_key; +}; + +struct JobResult { + std::string original_key; + std::string variants_json; +}; + +struct RetryPolicy { + int max_attempts = 6; + int base_delay_ms = 1000; + int max_delay_ms = 60000; +}; + +class JobRepo { +public: + enum class Result { Done, Scheduled, Busy, Missing, Superseded }; + JobRepo(PgPool& pool, RetryPolicy policy) : pool_(pool), policy_(policy) {} + Result run(const std::string& job_id, const std::string& attachment_id, + int version, int attempt, const std::function& process); +private: + Result fail(pqxx::work& tx, const std::string& job_id, + const std::string& attachment_id, int version, int retries, int retry_base, + const std::string& code, bool permanent); + PgPool& pool_; + RetryPolicy policy_; +}; diff --git a/src/main.cpp b/src/main.cpp new file mode 100644 index 00000000..7acf81db --- /dev/null +++ b/src/main.cpp @@ -0,0 +1,2352 @@ +#include "models.hpp" +#include "db.hpp" +#include "auth.hpp" +#include "user_repo.hpp" +#include "chat_repo.hpp" +#include "message_repo.hpp" +#include "attachment_repo.hpp" +#include "attachment_storage.hpp" +#include "outbox.hpp" +#include "fault_injection.hpp" +#include "direct_upload_repo.hpp" +#include "s3_client.hpp" +#include "image_util.hpp" +#include "redis_pool.hpp" +#include "session_repo.hpp" +#include "pg_session_repo.hpp" +#include "session_repo_base.hpp" +#include "errors.hpp" + +#include +#include +#include +#include +#include + + +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +static std::string g_instance_id; + +// Cap concurrent attachment uploads so RSS does not track HTTP_WORKERS × body. +static std::mutex g_up_mu; +static std::condition_variable g_up_cv; +static int g_up_active = 0; +static int g_up_max = 3; + +struct UploadSlot { + UploadSlot() { + std::unique_lock lk(g_up_mu); + g_up_cv.wait(lk, []() { return g_up_active < g_up_max; }); + ++g_up_active; + } + ~UploadSlot() { + { + std::lock_guard lk(g_up_mu); + --g_up_active; + } + // Return free heap pages to the OS so docker-stats RSS tracks the + // concurrent footprint instead of monotonic arena growth across uploads. + malloc_trim(0); + g_up_cv.notify_one(); + } + UploadSlot(const UploadSlot&) = delete; + UploadSlot& operator=(const UploadSlot&) = delete; +}; + +// Zero-copy istream over an existing contiguous buffer (no string copy). +struct MemBuf : std::streambuf { + MemBuf(const char* p, std::size_t n) { + auto* base = const_cast(p); + setg(base, base, base + n); + } +}; + +static std::string make_instance_id() { + const char* env = std::getenv("INSTANCE_ID"); + if (env && *env) { + return std::string(env); + } + const char* host = std::getenv("HOSTNAME"); + if (host && *host) { + return std::string(host); + } + static const char hex[] = "0123456789abcdef"; + std::random_device rd; + std::string s(8, '0'); + for (auto& c : s) c = hex[rd() & 0xf]; + return s; +} + + +static void send_all(int fd, const std::string& data) { + size_t sent = 0; + while (sent < data.size()) { + const ssize_t n = ::write(fd, data.data() + sent, data.size() - sent); + if (n <= 0) { + return; + } + sent += static_cast(n); + } +} + + +static std::string http_response(int status, const char* reason, + const std::string& request_id, + const std::string& body) { + std::string out; + out += "HTTP/1.1 " + std::to_string(status) + " " + reason + "\r\n"; + out += "Content-Type: application/json\r\n"; + out += "X-Request-Id: " + request_id + "\r\n"; + out += "X-Instance-Id: " + g_instance_id + "\r\n"; + out += "Content-Length: " + std::to_string(body.size()) + "\r\n"; + out += "Connection: close\r\n"; + out += "\r\n"; + out += body; + return out; +} + +static std::string http_no_content(const std::string& request_id) { + std::string out; + out += "HTTP/1.1 204 No Content\r\n"; + out += "X-Request-Id: " + request_id + "\r\n"; + out += "X-Instance-Id: " + g_instance_id + "\r\n"; + out += "Content-Length: 0\r\n"; + out += "Connection: close\r\n"; + out += "\r\n"; + return out; +} + + +static const char* status_reason(int status) { + switch (status) { + case 400: return "Bad Request"; + case 401: return "Unauthorized"; + case 404: return "Not Found"; + case 409: return "Conflict"; + case 413: return "Payload Too Large"; + case 415: return "Unsupported Media Type"; + case 500: return "Internal Server Error"; + case 503: return "Service Unavailable"; + default: return "Error"; + } +} + + +static std::string error_response(int status, + const std::string& code, + const std::string& message, + const std::string& request_id, + const std::string& www_authenticate = "") { + nlohmann::json j; + j["error"]["code"] = code; + j["error"]["message"] = message; + j["error"]["request_id"] = request_id; + const std::string body = j.dump(); + + std::string head = + "HTTP/1.1 " + std::to_string(status) + " " + + status_reason(status) + "\r\n" + "Content-Type: application/json\r\n" + "X-Request-Id: " + request_id + "\r\n" + + "X-Instance-Id: " + g_instance_id + "\r\n"; + if (status == 401 && !www_authenticate.empty()) { + head += "WWW-Authenticate: " + www_authenticate + "\r\n"; + } + head += "Content-Length: " + std::to_string(body.size()) + "\r\n"; + head += "Connection: close\r\n\r\n"; + return head + body; +} + + +static std::string failure_response(const std::exception& e, const char* what, + const std::string& request_id) { + if (dynamic_cast(&e)) { + return error_response(409, "conflict", "attachment processing failed", request_id); + } + std::clog << what << " failed: " << e.what() << "\n"; + if (is_dependency_failure(e)) { + return error_response(503, "unavailable", "service unavailable", request_id); + } + return error_response(500, "internal_error", "internal error", request_id); +} + + +static std::optional parse_json_object(const std::string& body) { + nlohmann::json j; + try { + j = nlohmann::json::parse(body); + } catch (const nlohmann::json::exception&) { + return std::nullopt; + } + + if (!j.is_object()) { + return std::nullopt; + } + return j; +} + + +static std::optional find_unexpected_key( + const nlohmann::json& j, + std::initializer_list allowed) { + for (const auto& [key, value] : j.items()) { + bool ok = false; + for (const char* a : allowed) { + if (key == a) { ok = true; break; } + } + + if (!ok) { + return key; + } + } + return std::nullopt; +} + + +static std::optional get_string_field( + const nlohmann::json& j, const char* key) { + auto it = j.find(key); + if (it == j.end() || !it->is_string()) { + return std::nullopt; + } + return it->get(); +} + +static std::optional get_int64_field( + const nlohmann::json& j, const char* key) { + auto it = j.find(key); + if (it == j.end() || !it->is_number_integer()) { + return std::nullopt; + } + return it->get(); +} + +static bool valid_sha256_hex(const std::string& s) { + if (s.size() != 64) { + return false; + } + for (char c : s) { + if (!((c >= '0' && c <= '9') || (c >= 'a' && c <= 'f'))) { + return false; + } + } + return true; +} + + +static std::optional> get_string_array( + const nlohmann::json& j, const char* key) { + auto it = j.find(key); + if (it == j.end() || !it->is_array()) { + return std::nullopt; + } + std::vector out; + out.reserve(it->size()); + for (const auto& item : *it) { + if (!item.is_string()) { + return std::nullopt; + } + out.push_back(item.get()); + } + return out; +} + +static bool parse_request_line(const std::string& first_line, + std::string& method, + std::string& path, + std::string& query) { + query.clear(); + const auto sp1 = first_line.find(' '); + if (sp1 == std::string::npos) { + return false; + } + + const auto sp2 = first_line.find(' ', sp1 + 1); + if (sp2 == std::string::npos) { + return false; + } + + method = first_line.substr(0, sp1); + path = first_line.substr(sp1 + 1, sp2 - sp1 - 1); + const auto q = path.find('?'); + if (q != std::string::npos) { + query = path.substr(q + 1); + path.resize(q); + } + return !method.empty() && !path.empty() && path[0] == '/'; +} + +static bool match_id_path(const std::string& path, + const std::string& prefix, + std::string& id) { + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + id = path.substr(prefix.size()); + return !id.empty() && id.find('/') == std::string::npos; +} + + +static bool match_chat_messages(const std::string& path, std::string& chat_id) { + const std::string prefix = "/api/v1/chats/"; + const std::string suffix = "/messages"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + chat_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !chat_id.empty() && chat_id.find('/') == std::string::npos; +} + +static bool match_chat_attachments(const std::string& path, std::string& chat_id) { + const std::string prefix = "/api/v1/chats/"; + const std::string suffix = "/attachments"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + chat_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !chat_id.empty() && chat_id.find('/') == std::string::npos; +} + +// Track 1 extension: POST /api/v1/chats/{id}/direct-uploads +static bool match_chat_direct_uploads(const std::string& path, + std::string& chat_id) { + const std::string prefix = "/api/v1/chats/"; + const std::string suffix = "/direct-uploads"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + chat_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !chat_id.empty() && chat_id.find('/') == std::string::npos; +} + +// POST /api/v1/direct-uploads/{id}/complete +static bool match_direct_upload_complete(const std::string& path, + std::string& upload_id) { + const std::string prefix = "/api/v1/direct-uploads/"; + const std::string suffix = "/complete"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + upload_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !upload_id.empty() && upload_id.find('/') == std::string::npos; +} + +static bool match_attachment_content(const std::string& path, + std::string& attachment_id) { + const std::string prefix = "/api/v1/attachments/"; + const std::string suffix = "/content"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + attachment_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !attachment_id.empty() && attachment_id.find('/') == std::string::npos; +} + + +static std::string to_lower(std::string s) { + for (char& c : s) { + c = static_cast(std::tolower(static_cast(c))); + } + return s; +} + + +static std::optional utf8_cps(const std::string& s) { + size_t i = 0; + size_t n = 0; + while (i < s.size()) { + const unsigned char c = static_cast(s[i]); + size_t w = 1; + if (c >= 0x80) { + if ((c & 0xE0) == 0xC0) w = 2; + else if ((c & 0xF0) == 0xE0) w = 3; + else if ((c & 0xF8) == 0xF0) w = 4; + else return std::nullopt; + if (i + w > s.size()) return std::nullopt; + for (size_t k = 1; k < w; ++k) { + if ((static_cast(s[i + k]) & 0xC0) != 0x80) { + return std::nullopt; + } + } + } + ++n; + i += w; + } + return n; +} + + +static bool cps_in_range(const std::string& s, size_t lo, size_t hi) { + const auto n = utf8_cps(s); + return n && *n >= lo && *n <= hi; +} + + +static std::unordered_map parse_headers( + const std::string& request, std::string::size_type after_first_line) { + std::unordered_map headers; + auto pos = after_first_line; + if (pos < request.size() && request.compare(pos, 2, "\r\n") == 0) { + pos += 2; + } + for (;;) { + const auto eol = request.find("\r\n", pos); + if (eol == std::string::npos || eol == pos) { + break; + } + const std::string line = request.substr(pos, eol - pos); + pos = eol + 2; + const auto colon = line.find(':'); + if (colon == std::string::npos) { + continue; + } + std::string name = to_lower(line.substr(0, colon)); + std::string value = line.substr(colon + 1); + while (!value.empty() && (value[0] == ' ' || value[0] == '\t')) { + value.erase(0, 1); + } + headers[name] = value; + } + return headers; +} + + +static std::string user_json(const User& user) { + nlohmann::json j; + j["id"] = user.id; + j["username"] = user.username; + j["display_name"] = user.display_name; + j["created_at"] = user.created_at; + return j.dump(); +} + + +static std::string attachment_json(const Attachment& a) { + nlohmann::json j; + j["id"] = a.id; + j["chat_id"] = a.chat_id; + j["owner_id"] = a.owner_id; + j["filename"] = a.filename; + j["content_type"] = a.content_type; + j["size_bytes"] = a.size_bytes; + j["sha256"] = a.sha256; + j["status"] = a.status; + j["variants"] = nlohmann::json::array(); + for (const auto& v : a.variants) { + j["variants"].push_back({{"name", v.name}, {"content_type", v.content_type}, + {"size_bytes", v.size_bytes}, {"sha256", v.sha256}, + {"width", v.width}, {"height", v.height}}); + } + if (a.error_code) { + j["error_code"] = *a.error_code; + } else { + j["error_code"] = nullptr; + } + j["created_at"] = a.created_at; + j["updated_at"] = a.updated_at; + return j.dump(); +} + +static std::string message_json(const Message& msg) { + nlohmann::json j; + j["id"] = msg.id; + j["chat_id"] = msg.chat_id; + j["sender_id"] = msg.sender_id; + j["text"] = msg.text; + j["created_at"] = msg.created_at; + j["attachment_ids"] = msg.attachment_ids; + return j.dump(); +} + + +static std::string chat_json(const Chat& chat) { + nlohmann::json j; + j["id"] = chat.id; + j["title"] = chat.title; + j["member_ids"] = chat.member_ids; + j["created_at"] = chat.created_at; + return j.dump(); +} + + +static std::string messages_page_json(const MessagePage& msgs) { + nlohmann::json j; + j["items"] = nlohmann::json::array(); + for (const auto& m : msgs.items) { + j["items"].push_back(nlohmann::json::parse(message_json(m))); + } + if (msgs.next_cursor) { + j["next_cursor"] = *msgs.next_cursor; + } else { + j["next_cursor"] = nullptr; + } + return j.dump(); +} + + +static std::string chats_page_json(const ChatPage& page) { + nlohmann::json j; + j["items"] = nlohmann::json::array(); + for (const auto& c : page.items) { + j["items"].push_back(nlohmann::json::parse(chat_json(c))); + } + if (page.next_cursor) { + j["next_cursor"] = *page.next_cursor; + } else { + j["next_cursor"] = nullptr; + } + return j.dump(); +} + + +static bool is_json_content_type(const std::string& raw) { + std::string s = to_lower(raw); + const auto sc = s.find(';'); + if (sc != std::string::npos) { + s.resize(sc); + } + while (!s.empty() && (s.back() == ' ' || s.back() == '\t')) { + s.pop_back(); + } + size_t a = 0; + while (a < s.size() && (s[a] == ' ' || s[a] == '\t')) { + ++a; + } + return s.substr(a) == "application/json"; +} + + +static int hex_val(char c) { + if (c >= '0' && c <= '9') return c - '0'; + if (c >= 'a' && c <= 'f') return c - 'a' + 10; + if (c >= 'A' && c <= 'F') return c - 'A' + 10; + return -1; +} + + +static bool json_content_type_ok( + const std::unordered_map& headers) { + const auto it = headers.find("content-type"); + return it != headers.end() && is_json_content_type(it->second); +} + +static std::string media_type_only(std::string ct) { + const auto semi = ct.find(';'); + if (semi != std::string::npos) { + ct.resize(semi); + } + while (!ct.empty() && (ct.back() == ' ' || ct.back() == '\t')) { + ct.pop_back(); + } + size_t a = 0; + while (a < ct.size() && (ct[a] == ' ' || ct[a] == '\t')) { + ++a; + } + return to_lower(ct.substr(a)); +} + +static std::optional image_content_type_declared( + const std::unordered_map& headers) { + const auto it = headers.find("content-type"); + if (it == headers.end()) { + return std::nullopt; + } + const std::string mt = media_type_only(it->second); + if (mt == "image/png" || mt == "image/jpeg") { + return mt; + } + return std::nullopt; +} + +// filename: 1–255 Unicode code points; no '/', '\\', NUL, or control chars. +static bool valid_attachment_filename(const std::string& s) { + const auto n = utf8_cps(s); + if (!n || *n < 1 || *n > 255) { + return false; + } + size_t i = 0; + while (i < s.size()) { + const unsigned char c = static_cast(s[i]); + uint32_t cp = c; + size_t w = 1; + if (c >= 0x80) { + if ((c & 0xE0) == 0xC0 && i + 1 < s.size()) { + w = 2; + cp = (static_cast(c & 0x1F) << 6) | + (static_cast(s[i + 1]) & 0x3F); + } else if ((c & 0xF0) == 0xE0 && i + 2 < s.size()) { + w = 3; + cp = (static_cast(c & 0x0F) << 12) | + ((static_cast(s[i + 1]) & 0x3F) << 6) | + (static_cast(s[i + 2]) & 0x3F); + } else if ((c & 0xF8) == 0xF0 && i + 3 < s.size()) { + w = 4; + cp = (static_cast(c & 0x07) << 18) | + ((static_cast(s[i + 1]) & 0x3F) << 12) | + ((static_cast(s[i + 2]) & 0x3F) << 6) | + (static_cast(s[i + 3]) & 0x3F); + } else { + return false; + } + } + if (cp == '/' || cp == '\\' || cp == 0 || + (cp < 0x20) || cp == 0x7F) { + return false; + } + i += w; + } + return true; +} + +static std::string make_uuid_v4() { + static std::mutex rng_mu; + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::lock_guard lock(rng_mu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +static std::string sha256_hex_bytes(const std::uint8_t* data, std::size_t len) { + unsigned char out[crypto_hash_sha256_BYTES]; + crypto_hash_sha256(out, data, len); + static const char hex[] = "0123456789abcdef"; + std::string r(sizeof(out) * 2, '0'); + for (std::size_t i = 0; i < sizeof(out); ++i) { + r[i * 2] = hex[out[i] >> 4]; + r[i * 2 + 1] = hex[out[i] & 0x0f]; + } + return r; +} + + +static bool contains_nul(const std::string& s) { + return s.find('\0') != std::string::npos; +} + +static bool is_unicode_space(uint32_t cp) { + if (cp <= 0x7F) { + return std::isspace(static_cast(cp)) != 0; + } + if (cp >= 0x2000 && cp <= 0x200A) { + return true; + } + switch (cp) { + case 0x00A0: + case 0x1680: + case 0x2028: + case 0x2029: + case 0x202F: + case 0x205F: + case 0x3000: + case 0xFEFF: + return true; + default: + return false; + } +} + +static bool is_blank(const std::string& s) { + size_t i = 0; + while (i < s.size()) { + const unsigned char c = static_cast(s[i]); + uint32_t cp = c; + size_t w = 1; + if (c >= 0x80) { + if ((c & 0xE0) == 0xC0 && i + 1 < s.size()) { + w = 2; + cp = (static_cast(c & 0x1F) << 6) + | (static_cast(s[i + 1]) & 0x3F); + } else if ((c & 0xF0) == 0xE0 && i + 2 < s.size()) { + w = 3; + cp = (static_cast(c & 0x0F) << 12) + | ((static_cast(s[i + 1]) & 0x3F) << 6) + | (static_cast(s[i + 2]) & 0x3F); + } else if ((c & 0xF8) == 0xF0 && i + 3 < s.size()) { + w = 4; + cp = (static_cast(c & 0x07) << 18) + | ((static_cast(s[i + 1]) & 0x3F) << 12) + | ((static_cast(s[i + 2]) & 0x3F) << 6) + | (static_cast(s[i + 3]) & 0x3F); + } else { + return false; + } + } + if (!is_unicode_space(cp)) { + return false; + } + i += w; + } + return true; +} + + +static bool valid_username(const std::string& s) { + static const std::regex re("^[a-z0-9_]{3,32}$"); + return std::regex_match(s, re); +} + + +static bool valid_uuid(const std::string& s) { + static const std::regex re( + "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-" + "[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + return std::regex_match(s, re); +} + +static bool valid_idempotency_key(const std::string& s) { + static const std::regex re("^[A-Za-z0-9._:-]{1,128}$"); + return std::regex_match(s, re); +} + + +static bool has_duplicate_ids(const std::vector& ids) { + std::unordered_set seen; + for (const auto& id : ids) { + if (!seen.insert(to_lower(id)).second) { + return true; + } + } + return false; +} + + +static std::string url_decode(const std::string& s) { + std::string out; + for (size_t i = 0; i < s.size(); ++i) { + if (s[i] == '%' && i + 2 < s.size()) { + const int hi = hex_val(s[i + 1]); + const int lo = hex_val(s[i + 2]); + if (hi >= 0 && lo >= 0) { + out.push_back(static_cast((hi << 4) | lo)); + i += 2; + continue; + } + } + out.push_back(s[i] == '+' ? ' ' : s[i]); + } + return out; +} + + +static std::unordered_map parse_query( + const std::string& query) { + std::unordered_map out; + size_t pos = 0; + while (pos < query.size()) { + auto amp = query.find('&', pos); + if (amp == std::string::npos) { + amp = query.size(); + } + const auto pair = query.substr(pos, amp - pos); + const auto eq = pair.find('='); + if (eq != std::string::npos) { + out[url_decode(pair.substr(0, eq))] = + url_decode(pair.substr(eq + 1)); + } + pos = amp + 1; + } + return out; +} + + +static std::atomic g_listen{-1}; +static std::atomic g_stop{false}; +static std::atomic g_draining{false}; +static std::mutex g_live_mu; +static std::unordered_set g_live; + +static void set_timeouts(int fd) { + // Allow larger attachment uploads (≤10 MiB) without premature timeout. + timeval tv{}; + tv.tv_sec = 60; + tv.tv_usec = 0; + ::setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, sizeof(tv)); + ::setsockopt(fd, SOL_SOCKET, SO_SNDTIMEO, &tv, sizeof(tv)); +} + +static void live_add(int fd) { + std::lock_guard lk(g_live_mu); + g_live.insert(fd); +} + +static void live_del(int fd) { + std::lock_guard lk(g_live_mu); + g_live.erase(fd); +} + +// Read HTTP request. Optional `before_large_body` runs once headers are known +// and Content-Length exceeds 256 KiB — used to take UploadSlot BEFORE the +// multi-MiB body is buffered (otherwise the semaphore cannot cap RSS). +static std::string read_request( + int client, + bool& too_large, + const std::function& before_large_body = + {}) { + too_large = false; + std::string request; + char buf[64 * 1024]; + // Lab4 attachment limit (also covers JSON endpoints). + constexpr std::size_t kMaxBody = 10'485'760; + constexpr std::size_t kGateBody = 256 * 1024; + bool headers_parsed = false; + bool gated = false; + bool has_cl = false; + std::size_t content_length = 0; + std::size_t hdr = std::string::npos; + for (;;) { + const ssize_t n = ::read(client, buf, sizeof(buf)); + if (n < 0) { + if (errno == EINTR) { + continue; + } + return {}; + } + if (n == 0) { + return request; + } + request.append(buf, static_cast(n)); + if (!headers_parsed) { + hdr = request.find("\r\n\r\n"); + if (hdr == std::string::npos) { + // Cap header size to avoid unbounded growth without body. + if (request.size() > 64 * 1024) { + too_large = true; + return {}; + } + continue; + } + headers_parsed = true; + // Search Content-Length only in headers — never to_lower() the body. + const std::string hdr_only = request.substr(0, hdr); + const auto cl = to_lower(hdr_only).find("content-length:"); + if (cl != std::string::npos) { + const auto line_end = hdr_only.find("\r\n", cl); + const auto colon = hdr_only.find(':', cl); + if (line_end != std::string::npos && colon < line_end) { + content_length = static_cast( + std::strtoull(hdr_only.c_str() + colon + 1, nullptr, 10)); + has_cl = true; + } + } + // Early reject on declared Content-Length (do not trust for final size). + // Still drain the declared body so reverse proxies (nginx) do not see + // a premature upstream close as 502 while they are writing the request. + if (has_cl && content_length > kMaxBody) { + too_large = true; + const std::size_t need = hdr + 4 + content_length; + std::size_t have = request.size(); + request.resize(hdr + 4); + while (have < need) { + const ssize_t n2 = ::read(client, buf, sizeof(buf)); + if (n2 < 0) { + if (errno == EINTR) { + continue; + } + break; + } + if (n2 == 0) { + break; + } + have += static_cast(n2); + } + return request; + } + if (!gated && before_large_body && has_cl && + content_length > kGateBody) { + gated = true; + const auto line_end = request.find("\r\n"); + const std::string first = + line_end == std::string::npos ? request.substr(0, hdr) + : request.substr(0, line_end); + std::string method; + std::string path; + std::string query; + if (parse_request_line(first, method, path, query)) { + before_large_body(method, path); + } + } + } + const std::size_t body_have = request.size() - (hdr + 4); + if (body_have > kMaxBody) { + too_large = true; + request.resize(hdr + 4); + return request; + } + // Without Content-Length treat body as empty (HTTP/1.1 clients send CL). + const auto need = hdr + 4 + (has_cl ? content_length : 0); + if (request.size() >= need) { + request.resize(need); + return request; + } + } +} + +static std::optional> parse_basic_auth( + const std::string& header_value) { + + static const std::string prefix = "Basic "; + if (header_value.size() <= prefix.size() || + header_value.compare(0, prefix.size(), prefix) != 0) { + return std::nullopt; + } + const std::string b64 = header_value.substr(prefix.size()); + + auto b64_val = [](char c) -> int { + if (c >= 'A' && c <= 'Z') return c - 'A'; + if (c >= 'a' && c <= 'z') return c - 'a' + 26; + if (c >= '0' && c <= '9') return c - '0' + 52; + if (c == '+') return 62; + if (c == '/') return 63; + return -1; + }; + + std::string decoded; + int buf = 0, bits = 0; + for (char c : b64) { + if (c == '=') break; + const int v = b64_val(c); + if (v < 0) return std::nullopt; + buf = (buf << 6) | v; + bits += 6; + if (bits >= 8) { + bits -= 8; + decoded.push_back(static_cast((buf >> bits) & 0xFF)); + } + } + + const auto colon = decoded.find(':'); + if (colon == std::string::npos) { + return std::nullopt; + } + return std::make_pair(decoded.substr(0, colon), + decoded.substr(colon + 1)); +} + +static void handle_client(int client, + std::atomic& request_n, + UserRepo& users, + ChatRepo& chats, + MessageRepo& messages, + AttachmentRepo& attachments, + DirectUploadRepo& direct_uploads, + S3Client* s3, + ISessionRepo& sessions, + PgPool& pg, + RedisPool* redis) { + bool too_large = false; + // Hold upload slot across body read + handler for attachment POSTs. + std::optional early_upload_slot; + const std::string request = read_request( + client, too_large, + [&](const std::string& method, const std::string& path) { + std::string chat_id; + if (method == "POST" && match_chat_attachments(path, chat_id) && + !early_upload_slot) { + early_upload_slot.emplace(); + } + }); + const unsigned nreq = ++request_n; + const std::string request_id = std::to_string(nreq); + + if (too_large) { + send_all(client, error_response(413, "payload_too_large", + "payload too large", request_id)); + live_del(client); + ::close(client); + return; + } + if (request.empty()) { + live_del(client); + ::close(client); + return; + } + + const auto line_end = request.find("\r\n"); + const std::string first_line = request.substr(0, line_end); + std::string method; + std::string path; + std::string query; + if (!parse_request_line(first_line, method, path, query)) { + send_all(client, error_response(400, "invalid_request", + "bad request line", request_id)); + live_del(client); + ::close(client); + return; + } + + const auto headers = parse_headers(request, line_end); + std::string user_id; + std::string bearer_token; + bool auth_backend_error = false; + { + auto it = headers.find("authorization"); + if (it != headers.end()) { + static const std::string prefix = "Bearer "; + const std::string& auth = it->second; + if (auth.size() > prefix.size() && + auth.compare(0, prefix.size(), prefix) == 0) { + bearer_token = auth.substr(prefix.size()); + } + } + if (!bearer_token.empty()) { + try { + auto found = sessions.lookup(bearer_token); + if (found) { + user_id = *found; + } + } catch (const std::exception& e) { + std::clog << "session lookup failed: " << e.what() << "\n"; + auth_backend_error = true; + } + } + } + auto send_auth_error = [&]() -> bool { + if (auth_backend_error) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + return true; + } + if (user_id.empty()) { + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + return true; + } + return false; + }; + // Сессия может пережить пользователя; недоступная БД — это 503, а не 401. + auto send_user_error = [&]() -> bool { + try { + if (users.find_by_id(user_id)) { + return false; + } + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_user", request_id)); + } + return true; + }; + + std::string chat_id; + std::string attachment_id; + std::string direct_upload_id; + + if (method == "GET" && path == "/health/live") { + send_all(client, http_response(200, "OK", request_id, "{\"status\":\"ok\"}")); + } + else if (method == "GET" && path == "/health/ready") { + if (g_draining.load()) { + send_all(client, error_response(503, "unavailable", + "shutting down", request_id)); + } else { + const bool pg_ok = pg.ping(); + const bool redis_ok = redis == nullptr || redis->ping(); + if (pg_ok && redis_ok) { + send_all(client, http_response(200, "OK", request_id, "{\"status\":\"ok\"}")); + } else { + std::clog << "readiness failed: pg=" << pg_ok + << " redis=" << redis_ok << "\n"; + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } + } + } + else if (method == "POST" && path == "/api/v1/auth/sessions") { + const auto body_at = request.find("\r\n\r\n"); + const std::string session_body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + if (!session_body.empty()) { + send_all(client, error_response(400, "invalid_request", + "body not allowed", request_id)); + } else { + auto it = headers.find("authorization"); + std::optional> creds; + if (it != headers.end()) { + creds = parse_basic_auth(it->second); + } + + const auto send_basic_401 = [&]() { + send_all(client, error_response( + 401, "unauthorized", "unauthorized", request_id, + "Basic realm=\"messenger\", charset=\"UTF-8\"")); + }; + + if (!creds) { + send_basic_401(); + } else { + const auto& username = creds->first; + const auto& password = creds->second; + try { + const auto user = users.find_by_username(username); + if (!user || !verify_password(password, user->password_hash)) { + send_basic_401(); + } else { + const auto created = sessions.create(user->id); + nlohmann::json j; + j["token"] = created.token; + j["token_type"] = "Bearer"; + const std::time_t t = static_cast( + created.expires_at); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + j["expires_at"] = out.str(); + j["user"] = nlohmann::json::parse(user_json(*user)); + send_all(client, http_response(201, "Created", + request_id, j.dump())); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_session", request_id)); + } + } + } + } + else if (method == "GET" && path == "/api/v1/users/me") { + if (send_auth_error()) { + } else { + try { + const auto user = users.find_by_id(user_id); + if (!user) { + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + } else { + send_all(client, http_response(200, "OK", request_id, + user_json(*user))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_user", request_id)); + } + } + } + else if (method == "POST" && path == "/api/v1/users") { + if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key( + *j, {"username", "display_name", "password"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto username = get_string_field(*j, "username"); + const auto display_name = get_string_field(*j, "display_name"); + const auto password = get_string_field(*j, "password"); + if (!username || !display_name || !password) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (!valid_username(*username) || + contains_nul(*display_name) || + is_blank(*display_name) || + !cps_in_range(*display_name, 1, 100)) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*password) || + !cps_in_range(*password, 12, 128)) { + send_all(client, error_response(400, "invalid_request", + "invalid password", request_id)); + } else { + std::string hash; + try { + hash = hash_password(*password); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "hash_password", request_id)); + } + if (!hash.empty()) { + try { + const auto created = users.create(*username, + *display_name, hash); + if (!created) { + send_all(client, error_response(409, "conflict", + "username taken", request_id)); + } else { + send_all(client, http_response(201, "Created", request_id, + user_json(*created))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_user", request_id)); + } + } + } + } + } + } + else if (method == "POST" && path == "/api/v1/chats") { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key(*j, {"title", "member_ids"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto title = get_string_field(*j, "title"); + const auto member_ids = get_string_array(*j, "member_ids"); + if (!title || !member_ids) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*title) || is_blank(*title) || + !cps_in_range(*title, 1, 100)) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (member_ids->empty() || member_ids->size() > 100) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else if (std::find(member_ids->begin(), member_ids->end(), + user_id) == member_ids->end()) { + send_all(client, error_response(400, "invalid_request", + "caller not in members", request_id)); + } else if (!std::all_of(member_ids->begin(), member_ids->end(), + valid_uuid)) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else if (has_duplicate_ids(*member_ids)) { + send_all(client, error_response(400, "invalid_request", + "duplicate members", request_id)); + } else { + try { + const auto created = chats.create(*title, *member_ids); + if (!created) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else { + send_all(client, http_response(201, "Created", request_id, + chat_json(*created))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_chat", request_id)); + } + } + } + } + } + else if (method == "POST" && match_chat_attachments(path, chat_id)) { + // Prefer the slot taken before buffering a large body; otherwise take + // one now (small uploads / missing Content-Length). + std::optional late_slot; + if (!early_upload_slot) { + late_slot.emplace(); + } + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else if (!s3) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto qparams = parse_query(query); + const auto fn_it = qparams.find("filename"); + if (fn_it == qparams.end() || + !valid_attachment_filename(fn_it->second)) { + send_all(client, error_response( + 400, "invalid_request", + "invalid filename", request_id)); + } else { + const auto declared = image_content_type_declared(headers); + if (!declared) { + send_all(client, error_response( + 415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const char* body_ptr = nullptr; + std::size_t body_len = 0; + if (body_at != std::string::npos) { + body_ptr = request.data() + body_at + 4; + body_len = request.size() - (body_at + 4); + } + if (body_len == 0 || body_ptr == nullptr) { + send_all(client, error_response( + 400, "invalid_request", + "empty body", request_id)); + } else { + ImageLimits lim; + if (const char* env = std::getenv("MAX_UPLOAD_BYTES")) { + try { + lim.max_bytes = std::stoll(env); + } catch (...) { + } + } + if (const char* env = std::getenv("MAX_IMAGE_PIXELS")) { + try { + lim.max_pixels = std::stoll(env); + } catch (...) { + } + } + ImageInfo info; + const auto* bytes = + reinterpret_cast( + body_ptr); + auto rej = validate_image( + bytes, body_len, lim, info); + if (rej == ImageReject::payload_too_large) { + send_all(client, error_response( + 413, "payload_too_large", + "payload too large", request_id)); + } else if (rej) { + send_all(client, error_response( + 415, "unsupported_media_type", + std::string(image_reject_code(*rej)), + request_id)); + } else if (info.content_type != *declared) { + // MIME spoof: declared CT ≠ magic. + send_all(client, error_response( + 415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + Attachment a; + a.id = make_uuid_v4(); + a.chat_id = chat_id; + a.owner_id = user_id; + a.filename = fn_it->second; + a.content_type = info.content_type; + a.size_bytes = + static_cast(body_len); + a.sha256 = sha256_hex_bytes( + bytes, body_len); + a.status = "queued"; + a.error_code = std::nullopt; + a.s3_key = "staging/" + chat_id + + "/" + a.id; + + MemBuf mem(body_ptr, body_len); + std::istream stream(&mem); + try { + const std::string job_id = make_uuid_v4(); + const Attachment saved = attachments.insert_queued(a, job_id, [&] { + s3->put_object(a.s3_key, stream, body_len, a.content_type); + }); + lab_crash_at("upload_after_commit"); + send_all(client, http_response( + 202, "Accepted", request_id, + attachment_json(saved))); + } catch (const std::exception& e) { + // Preserve staging when the DB COMMIT outcome is uncertain. + send_all(client, failure_response( + e, "upload_attachment", + request_id)); + } + } + } + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "upload_attachment", + request_id)); + } + } + } + else if (method == "POST" && match_chat_messages(path, chat_id)) { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key( + *j, {"text", "attachment_ids"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto text = get_string_field(*j, "text"); + std::vector attachment_ids; + bool attachment_ids_ok = true; + if (j->contains("attachment_ids")) { + const auto parsed = get_string_array(*j, "attachment_ids"); + if (!parsed) { + attachment_ids_ok = false; + } else { + attachment_ids = *parsed; + } + } + if (!text || !attachment_ids_ok) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*text) || + !cps_in_range(*text, 0, 4000) || + (attachment_ids.empty() && + (is_blank(*text) || !cps_in_range(*text, 1, 4000)))) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (attachment_ids.size() > 10) { + send_all(client, error_response(400, "invalid_request", + "too many attachments", request_id)); + } else if (!std::all_of(attachment_ids.begin(), attachment_ids.end(), + valid_uuid)) { + send_all(client, error_response(400, "invalid_request", + "invalid attachment ids", request_id)); + } else if (has_duplicate_ids(attachment_ids)) { + send_all(client, error_response(400, "invalid_request", + "duplicate attachment ids", request_id)); + } else { + const auto idem = headers.find("idempotency-key"); + if (idem == headers.end() || + !valid_idempotency_key(idem->second)) { + send_all(client, error_response( + 400, "invalid_request", + "invalid idempotency key", request_id)); + } else { + const auto created = messages.create_idempotent( + chat_id, user_id, *text, attachment_ids, idem->second); + if (created.status == CreateResult::Status::NotFound) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (created.status == + CreateResult::Status::KeyConflict) { + send_all(client, error_response( + 409, "conflict", + "idempotency key reused", request_id)); + } else if (!created.message) { + send_all(client, error_response( + 500, "internal_error", + "internal error", request_id)); + } else { + send_all(client, http_response( + 201, "Created", request_id, + message_json(*created.message))); + } + } + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "post_message", request_id)); + } + } + } + else if (method == "GET" && match_chat_messages(path, chat_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto params = parse_query(query); + int limit = 50; + bool bad_limit = false; + if (params.count("limit")) { + try { + std::size_t consumed = 0; + limit = std::stoi(params.at("limit"), &consumed); + if (consumed != params.at("limit").size() || + limit < 1 || limit > 100) { + bad_limit = true; + } + } catch (...) { + bad_limit = true; + } + } + std::optional cursor; + if (params.count("cursor")) { + cursor = params.at("cursor"); + } + if (bad_limit || (cursor && cursor->empty())) { + send_all(client, error_response(400, "invalid_request", + "bad query", request_id)); + } else { + const auto page = messages.list_page(chat_id, limit, cursor); + if (!page) { + send_all(client, error_response(400, "invalid_request", + "bad cursor", request_id)); + } else { + send_all(client, http_response(200, "OK", + request_id, + messages_page_json(*page))); + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "list_messages", request_id)); + } + } + } + else if (method == "GET" && path == "/api/v1/chats") { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else { + const auto params = parse_query(query); + int limit = 50; + bool bad_limit = false; + if (params.count("limit")) { + try { + std::size_t consumed = 0; + limit = std::stoi(params.at("limit"), &consumed); + if (consumed != params.at("limit").size() || + limit < 1 || limit > 100) { + bad_limit = true; + } + } catch (...) { + bad_limit = true; + } + } + std::optional cursor; + if (params.count("cursor")) { + cursor = params.at("cursor"); + } + if (bad_limit || (cursor && cursor->empty())) { + send_all(client, error_response(400, "invalid_request", + "bad query", request_id)); + } else { + try { + const auto page = chats.list_for_user(user_id, limit, cursor); + if (!page) { + send_all(client, error_response(400, "invalid_request", + "bad cursor", request_id)); + } else { + send_all(client, http_response(200, "OK", request_id, + chats_page_json(*page))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "list_chats", request_id)); + } + } + } + } + else if (method == "GET" && match_id_path(path, "/api/v1/chats/", chat_id)) { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + send_all(client, http_response(200, "OK", request_id, + chat_json(*chat))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_chat", request_id)); + } + } + } + else if (method == "GET" && match_attachment_content(path, attachment_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(attachment_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid attachment id", request_id)); + } else if (!s3) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } else { + bool response_headers_sent = false; + try { + const auto att = attachments.find_by_id(attachment_id); + if (!att) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto chat = chats.find_by_id(att->chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (att->status != "ready") { + send_all(client, error_response( + 409, "conflict", + "attachment not ready", request_id)); + } else { + const auto params = parse_query(query); + const auto it = params.find("variant"); + const std::string name = it == params.end() ? "original" : it->second; + std::string key = att->s3_key; + std::string content_type = att->content_type; + int size_bytes = att->size_bytes; + bool found = name == "original"; + for (const auto& v : att->variants) { + if (v.name == name) { + found = true; + content_type = v.content_type; + size_bytes = v.size_bytes; + key = v.storage_key.empty() ? attachment_variant_key(att->chat_id, att->id, name) : v.storage_key; + } + } + const bool valid = name == "original" || name == "thumbnail" || + name == "crop" || name == "optimized"; + std::int64_t object_size = 0; + std::string etag; + if (!valid) { + send_all(client, error_response( + 400, "invalid_request", "invalid variant", request_id)); + } else if (!found || !s3->stat_object(key, object_size, etag)) { + send_all(client, error_response( + 404, "not_found", "not found", request_id)); + } else if (object_size != size_bytes) { + send_all(client, error_response( + 500, "internal_error", "internal error", + request_id)); + } else { + std::string head = + "HTTP/1.1 200 OK\r\n" + "Content-Type: " + content_type + "\r\n" + "X-Request-Id: " + request_id + "\r\n" + "X-Instance-Id: " + g_instance_id + "\r\n" + "Content-Length: " + + std::to_string(size_bytes) + "\r\n" + "Connection: close\r\n" + "\r\n"; + response_headers_sent = true; + send_all(client, head); + s3->get_object(key, [&](const char* data, + std::size_t n) { + size_t sent = 0; + while (sent < n) { + const ssize_t w = ::write( + client, data + sent, n - sent); + if (w <= 0) { + throw std::runtime_error( + "content write failed"); + } + sent += static_cast(w); + } + }); + } + } + } + } catch (const std::exception& e) { + if (response_headers_sent) { + std::clog << "download_attachment stream failed: " + << e.what() << "\n"; + } else { + send_all(client, failure_response(e, "download_attachment", + request_id)); + } + } + } + } + else if (method == "GET" && + match_id_path(path, "/api/v1/attachments/", attachment_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(attachment_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid attachment id", request_id)); + } else { + try { + const auto att = attachments.find_by_id(attachment_id); + if (!att) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto chat = chats.find_by_id(att->chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + send_all(client, http_response(200, "OK", request_id, + attachment_json(*att))); + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "get_attachment", + request_id)); + } + } + } else if (method == "POST" && match_chat_direct_uploads(path, chat_id)) { + // Track 1: initiate presigned PUT (proxy POST /attachments stays mandatory). + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else if (!s3) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } else if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key( + *j, {"filename", "content_type", "size_bytes", + "sha256"})) { + send_all(client, error_response( + 400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto filename = get_string_field(*j, "filename"); + const auto ctype = get_string_field(*j, "content_type"); + const auto size_b = get_int64_field(*j, "size_bytes"); + const auto sha = get_string_field(*j, "sha256"); + std::int64_t max_bytes = 10485760; + if (const char* env = std::getenv("MAX_UPLOAD_BYTES")) { + try { + max_bytes = std::stoll(env); + } catch (...) { + } + } + int ttl = 300; + if (const char* env = + std::getenv("DIRECT_UPLOAD_TTL_SECONDS")) { + const int v = std::atoi(env); + if (v >= 30 && v <= 3600) { + ttl = v; + } + } + if (!filename || !valid_attachment_filename(*filename) || + !ctype || + (*ctype != "image/png" && *ctype != "image/jpeg") || + !size_b || *size_b < 1 || *size_b > max_bytes || + !sha || !valid_sha256_hex(*sha)) { + send_all(client, error_response( + 400, "invalid_request", "invalid fields", + request_id)); + } else { + DirectUpload d; + d.id = make_uuid_v4(); + d.chat_id = chat_id; + d.owner_id = user_id; + d.filename = *filename; + d.content_type = *ctype; + d.expected_size = static_cast(*size_b); + d.expected_sha256 = *sha; + d.s3_key = "attachments/" + chat_id + "/" + d.id; + d.staging_key = "staging/" + chat_id + "/" + d.id; + d.status = "pending"; + const auto now = std::chrono::system_clock::now(); + const auto secs = + std::chrono::duration_cast( + now.time_since_epoch()) + .count(); + d.expires_at_epoch = secs + ttl; + const DirectUpload saved = direct_uploads.insert(d); + const std::string url = s3->presign_put( + saved.staging_key, static_cast(ttl), + saved.content_type); + nlohmann::json out; + out["id"] = saved.id; + out["upload_url"] = url; + out["method"] = "PUT"; + out["headers"] = nlohmann::json::object(); + out["headers"]["Content-Type"] = saved.content_type; + out["expires_at"] = saved.expires_at; + out["size_bytes"] = saved.expected_size; + out["sha256"] = saved.expected_sha256; + out["filename"] = saved.filename; + out["content_type"] = saved.content_type; + send_all(client, http_response(201, "Created", + request_id, + out.dump())); + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "direct_upload_init", + request_id)); + } + } + } else if (method == "POST" && + match_direct_upload_complete(path, direct_upload_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(direct_upload_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid upload id", request_id)); + } else if (!s3) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } else { + try { + std::string response; + direct_uploads.with_lock([&](UploadLock& upload) { + const auto sess = upload.lock(direct_upload_id); + if (!sess || sess->owner_id != user_id) { + response = error_response(404, "not_found", "not found", + request_id); + return; + } + if (sess->status == "completed") { + const auto saved = upload.find_attachment( + sess->attachment_id.value_or(sess->id)); + if (!saved) { + throw std::runtime_error( + "completed upload has no attachment"); + } + upload.commit(); + const bool pending = saved->status == "queued" || saved->status == "processing"; + + response = http_response(pending ? 202 : 200, + pending ? "Accepted" : "OK", request_id, + attachment_json(*saved)); + return; + } + if (sess->status != "pending") { + response = error_response( + 409, "conflict", "upload session not pending", + request_id); + return; + } + if (sess->overdue) { + upload.mark_expired(sess->id); + upload.commit(); + response = error_response(410, "gone", + "upload session expired", + request_id); + return; + } + + std::int64_t obj_size = 0; + std::string etag; + if (!s3->stat_object(sess->staging_key, obj_size, etag)) { + upload.commit(); + response = error_response(409, "not_ready", + "upload object not ready", + request_id); + return; + } + if (obj_size != sess->expected_size) { + upload.commit(); + response = error_response(409, "hash_mismatch", + "uploaded object mismatch", + request_id); + return; + } + + std::vector buf; + buf.reserve(static_cast(obj_size)); + s3->get_object( + sess->staging_key, + [&](const char* data, std::size_t n) { + if (buf.size() > static_cast(sess->expected_size) || + n > static_cast(sess->expected_size) - buf.size()) { + throw std::runtime_error("staging object size changed"); + } + buf.insert(buf.end(), + reinterpret_cast(data), + reinterpret_cast(data) + n); + }); + if (static_cast(buf.size()) != + sess->expected_size || + sha256_hex_bytes(buf.data(), buf.size()) != + sess->expected_sha256) { + upload.commit(); + response = error_response(409, "hash_mismatch", + "uploaded object mismatch", + request_id); + return; + } + + ImageLimits lim; + if (const char* env = std::getenv("MAX_UPLOAD_BYTES")) { + try { + lim.max_bytes = std::stoll(env); + } catch (...) { + } + } + if (const char* env = std::getenv("MAX_IMAGE_PIXELS")) { + try { + lim.max_pixels = std::stoll(env); + } catch (...) { + } + } + ImageInfo info; + const auto rejection = + validate_image(buf.data(), buf.size(), lim, info); + if (rejection || info.content_type != sess->content_type) { + upload.commit(); + response = error_response(415, "unsupported_media_type", + "unsupported media type", + request_id); + return; + } + + Attachment a; + a.id = sess->id; + a.chat_id = sess->chat_id; + a.owner_id = sess->owner_id; + a.filename = sess->filename; + a.content_type = sess->content_type; + a.size_bytes = sess->expected_size; + a.sha256 = sess->expected_sha256; + a.status = "queued"; + a.s3_key = sess->staging_key; + bool inserted = false; + auto saved = upload.insert_queued(a, inserted); + if (!saved) { + saved = upload.find_attachment(a.id); + } + if (!saved) { + throw std::runtime_error( + "attachment insert conflict without existing row"); + } + upload.mark_completed(sess->id, saved->id); + upload.commit(); + lab_crash_at("upload_after_commit"); + response = http_response(202, "Accepted", request_id, + attachment_json(*saved)); + }); + send_all(client, response); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "direct_upload_complete", + request_id)); + } + } + } else if (method == "DELETE" && + match_id_path(path, "/api/v1/direct-uploads/", + direct_upload_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + } else if (!valid_uuid(direct_upload_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid upload id", request_id)); + } else { + try { + auto sess = direct_uploads.find_by_id(direct_upload_id); + if (!sess || sess->owner_id != user_id) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (sess->status != "pending") { + send_all(client, error_response( + 409, "conflict", + "upload session not pending", request_id)); + } else { + direct_uploads.mark_aborted(sess->id); + if (s3) { + try { + std::int64_t sz = 0; + std::string et; + if (s3->stat_object(sess->staging_key, sz, et)) { + s3->delete_object(sess->staging_key); + } + } catch (const std::exception& de) { + std::clog << "abort DeleteObject failed: " + << de.what() << "\n"; + } + } + send_all(client, http_no_content(request_id)); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "direct_upload_abort", + request_id)); + } + } + } else if (method == "DELETE" && path == "/api/v1/auth/sessions/current") { + if (send_auth_error()) { + } else { + try { + sessions.revoke(bearer_token); + send_all(client, http_no_content(request_id)); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "revoke_session", request_id)); + } + } + } + else { + send_all(client, error_response(404, "not_found", "not found", request_id)); + } + + live_del(client); + ::close(client); +} + +int env_or_default(const char* name, int fallback) { + const char* raw = std::getenv(name); + if (raw == nullptr || raw[0] == '\0') { + return fallback; + } + char* end = nullptr; + errno = 0; + const long value = std::strtol(raw, &end, 10); + if (end == raw || *end != '\0' || errno != 0 || value < 1 || value > 4096) { + return fallback; + } + return static_cast(value); +} + +int main() { + const char* host_env = std::getenv("APP_HOST"); + const char* port_env = std::getenv("APP_PORT"); + const char* host = host_env ? host_env : "0.0.0.0"; + const int port = port_env ? std::atoi(port_env) : 8080; + g_instance_id = make_instance_id(); + std::clog << "instance id: " << g_instance_id << "\n"; + + sigset_t set; + sigemptyset(&set); + sigaddset(&set, SIGTERM); + sigaddset(&set, SIGINT); + if (pthread_sigmask(SIG_BLOCK, &set, nullptr) != 0) { + std::cerr << "pthread_sigmask failed" << std::endl; + return 1; + } + + const std::string db_url = read_secret_file("DATABASE_URL_FILE"); + std::clog << "connecting to db...\n"; + { + auto conn = open_pg_connection(db_url, false); + std::clog << "applying migrations...\n"; + apply_migrations(*conn, "./migrations"); + std::clog << "migrations ok\n"; + } + + const int pool_n = env_or_default("DB_POOL_SIZE", 8); + PgPool pool(db_url, pool_n); + std::clog << "pg pool ready (" << pool_n << " connections)\n"; + + if (sodium_init() < 0) { + std::cerr << "sodium_init failed\n"; + return 1; + } + + UserRepo users(pool); + ChatRepo chats(pool); + MessageRepo messages(pool); + AttachmentRepo attachments(pool); + DirectUploadRepo direct_uploads(pool); + + std::unique_ptr s3; + try { + s3 = std::make_unique(S3Client::from_env()); + std::clog << "s3 client ready bucket=" << s3->bucket() << "\n"; + } catch (const std::exception& e) { + std::cerr << "s3 init failed: " << e.what() << "\n"; + return 1; + } + + const char* ttl_env = std::getenv("SESSION_TTL_SECONDS"); + const int ttl_seconds = ttl_env ? std::atoi(ttl_env) : 3600; + + const char* store_env = std::getenv("SESSION_STORE"); + const std::string store = store_env ? store_env : "redis"; + + std::unique_ptr redis_pool; + std::unique_ptr sessions; + if (store == "postgres") { + sessions = std::make_unique(pool, ttl_seconds); + std::clog << "session store: postgres\n"; + } else if (store == "redis") { + redis_pool = std::make_unique(read_secret_file("CACHE_URL_FILE"), 4); + std::clog << "redis pool ready (4 connections)\n"; + sessions = std::make_unique(*redis_pool, ttl_seconds); + std::clog << "session store: redis\n"; + } else { + throw std::runtime_error("unknown SESSION_STORE: " + store); + } + std::clog << "session ttl: " << ttl_seconds << "s\n"; + + const char* broker_file = std::getenv("BROKER_URL_FILE"); + const std::string broker_url = read_secret_file( + broker_file && *broker_file ? "BROKER_URL_FILE" : "CACHE_URL_FILE"); + + const int fd = ::socket(AF_INET, SOCK_STREAM, 0); + if (fd < 0) { + std::cerr << "socket failed" << std::endl; + return 1; + } + + const int yes = 1; + ::setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, &yes, sizeof(yes)); + + sockaddr_in addr{}; + addr.sin_family = AF_INET; + addr.sin_port = htons(static_cast(port)); + if (::inet_pton(AF_INET, host, &addr.sin_addr) != 1) { + std::cerr << "invalid APP_HOST" << std::endl; + ::close(fd); + return 1; + } + + if (::bind(fd, reinterpret_cast(&addr), sizeof(addr)) != 0) { + std::cerr << "bind failed on " << host << ":" << port << std::endl; + ::close(fd); + return 1; + } + + if (::listen(fd, 16) != 0) { + std::cerr << "listen failed" << std::endl; + ::close(fd); + return 1; + } + + g_listen.store(fd); + + std::clog << "listening on " << host << ":" << port << std::endl; + + OutboxPublisher publisher(db_url, broker_url); + + std::atomic request_n{0}; + std::mutex q_mu; + std::condition_variable q_cv; + std::queue q; + const int workers_n = env_or_default("HTTP_WORKERS", 8); + std::clog << "http workers: " << workers_n << "\n"; + if (const char* v = std::getenv("MAX_CONCURRENT_UPLOADS")) { + const int n = std::atoi(v); + if (n >= 1 && n <= 32) { + g_up_max = n; + } + } + std::clog << "max concurrent uploads: " << g_up_max << "\n"; + std::vector workers; + for (int i = 0; i < workers_n; ++i) { + workers.emplace_back([&]() { + for (;;) { + int client = -1; + { + std::unique_lock lk(q_mu); + q_cv.wait(lk, [&]() { return g_stop.load() || !q.empty(); }); + if (g_stop.load() && q.empty()) { + return; + } + client = q.front(); + q.pop(); + } + try { + handle_client(client, request_n, users, chats, messages, + attachments, direct_uploads, s3.get(), + *sessions, pool, redis_pool.get()); + } catch (const std::exception& e) { + std::clog << "unhandled request error: " << e.what() << "\n"; + send_all(client, error_response(500, "internal_error", + "internal error", + std::to_string(request_n.load()))); + live_del(client); + ::close(client); + } catch (...) { + live_del(client); + ::close(client); + } + } + }); + } + + std::thread signal_thread([&]() { + int sig = 0; + if (sigwait(&set, &sig) != 0) { + return; + } + g_draining.store(true); + int drain_seconds = 2; + if (const char* env = std::getenv("DRAIN_SECONDS")) { + if (*env) { + drain_seconds = std::atoi(env); + if (drain_seconds < 0) { + drain_seconds = 0; + } else if (drain_seconds > 30) { + drain_seconds = 30; + } + } + } + std::clog << "draining: /health/ready is 503 for " + << drain_seconds << "s before listen socket closes\n"; + if (drain_seconds > 0) { + ::sleep(static_cast(drain_seconds)); + } + g_stop.store(true); + const int lfd = g_listen.load(); + if (lfd >= 0) { + ::shutdown(lfd, SHUT_RDWR); + } + }); + + for (;;) { + const int client = ::accept(fd, nullptr, nullptr); + if (client < 0) { + if (g_stop.load()) { + std::clog << "shutting down\n"; + break; + } + std::cerr << "accept failed\n"; + break; + } + set_timeouts(client); + live_add(client); + { + std::lock_guard lk(q_mu); + q.push(client); + } + q_cv.notify_one(); + } + { + std::lock_guard lk(q_mu); + g_stop.store(true); + } + q_cv.notify_all(); + for (auto& t : workers) { + t.join(); + } + signal_thread.detach(); + + ::close(fd); + std::clog << "stopped\n"; + return 0; +} \ No newline at end of file diff --git a/src/message_repo.cpp b/src/message_repo.cpp new file mode 100644 index 00000000..973beca3 --- /dev/null +++ b/src/message_repo.cpp @@ -0,0 +1,377 @@ +#include "message_repo.hpp" +#include "cursor.hpp" +#include "errors.hpp" + +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mutex rng_mu; + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::lock_guard lock(rng_mu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string sha256_hex(const std::string& s) { + unsigned char out[crypto_hash_sha256_BYTES]; + crypto_hash_sha256(out, reinterpret_cast(s.data()), s.size()); + static const char hex[] = "0123456789abcdef"; + std::string r; + r.resize(sizeof(out) * 2); + for (std::size_t i = 0; i < sizeof(out); ++i) { + r[i * 2] = hex[out[i] >> 4]; + r[i * 2 + 1] = hex[out[i] & 0x0f]; + } + return r; +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +Message row_to_message(const pqxx::row& r) { + Message m; + m.id = r["id"].as(); + m.chat_id = r["chat_id"].as(); + m.sender_id = r["sender_id"].as(); + m.text = r["text"].as(); + m.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return m; +} + +constexpr const char* kMessageSelect = + "id, chat_id, sender_id, text, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +std::string canonical_message_body(const std::string& text, + const std::vector& attachment_ids) { + std::ostringstream out; + out << "text=" << text << "\nattachment_ids="; + for (std::size_t i = 0; i < attachment_ids.size(); ++i) { + if (i > 0) { + out << ','; + } + out << attachment_ids[i]; + } + return out.str(); +} + +int idempotency_ttl_seconds() { + const char* env = std::getenv("IDEMPOTENCY_TTL_SECONDS"); + if (env == nullptr || *env == '\0') { + return 86400; + } + try { + const int v = std::stoi(env); + if (v <= 0) { + return 86400; + } + return v; + } catch (...) { + return 86400; + } +} + +bool attachments_belong_to_chat(pqxx::work& tx, + const std::string& chat_id, + const std::vector& attachment_ids) { + bool failed = false; + for (const auto& id : attachment_ids) { + auto r = tx.exec( + "SELECT status FROM attachments " + "WHERE id = $1 AND chat_id = $2 FOR SHARE", + pqxx::params{id, chat_id}); + if (r.empty()) { + return false; + } + failed = failed || r[0]["status"].as() == "failed"; + } + if (failed) { + throw AttachmentFailed(); + } + return true; +} + +void link_attachments(pqxx::work& tx, + const std::string& message_id, + const std::vector& attachment_ids) { + for (std::size_t i = 0; i < attachment_ids.size(); ++i) { + tx.exec( + "INSERT INTO message_attachments (message_id, attachment_id, position) " + "VALUES ($1, $2, $3)", + pqxx::params{message_id, attachment_ids[i], static_cast(i)}); + } +} + +std::vector load_attachment_ids(pqxx::work& tx, + const std::string& message_id) { + auto r = tx.exec( + "SELECT attachment_id FROM message_attachments " + "WHERE message_id = $1 ORDER BY position ASC", + pqxx::params{message_id}); + std::vector ids; + ids.reserve(r.size()); + for (const auto& row : r) { + ids.push_back(row["attachment_id"].as()); + } + return ids; +} + +void fill_attachment_ids(pqxx::work& tx, Message& m) { + m.attachment_ids = load_attachment_ids(tx, m.id); +} + +void fill_attachment_ids(pqxx::work& tx, std::vector& items) { + for (auto& m : items) { + fill_attachment_ids(tx, m); + } +} + +Message insert_message(pqxx::work& tx, + const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::vector& attachment_ids) { + const std::string id = make_uuid(); + const std::string created = now_epoch_str(); + auto r = tx.exec( + "INSERT INTO messages (id, chat_id, sender_id, text, created_at) " + "VALUES ($1, $2, $3, $4, to_timestamp($5::bigint)) " + "RETURNING " + std::string(kMessageSelect), + pqxx::params{id, chat_id, sender_id, text, created}); + Message m = row_to_message(r[0]); + link_attachments(tx, m.id, attachment_ids); + m.attachment_ids = attachment_ids; + return m; +} + +bool insert_idempotency_key(pqxx::work& tx, + const std::string& user_id, + const std::string& chat_id, + const std::string& idem_key, + const std::string& request_hash, + const std::string& message_id) { + auto inserted = tx.exec( + "INSERT INTO idempotency_keys " + "(user_id, chat_id, key, request_hash, message_id) " + "VALUES ($1, $2, $3, $4, $5) " + "ON CONFLICT (user_id, chat_id, key) DO NOTHING " + "RETURNING message_id", + pqxx::params{user_id, chat_id, idem_key, request_hash, message_id}); + return !inserted.empty(); +} + +Message load_message(pqxx::work& tx, const std::string& message_id) { + auto r = tx.exec( + "SELECT " + std::string(kMessageSelect) + " FROM messages WHERE id = $1", + pqxx::params{message_id}); + if (r.empty()) { + throw std::runtime_error("idempotent message row is missing"); + } + Message m = row_to_message(r[0]); + fill_attachment_ids(tx, m); + return m; +} + +} // namespace + +std::optional MessageRepo::create(const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::vector& attachment_ids) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + auto member_check = tx.exec( + "SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", + pqxx::params{chat_id, sender_id}); + if (member_check.empty()) { + tx.commit(); + return std::nullopt; + } + if (!attachments_belong_to_chat(tx, chat_id, attachment_ids)) { + tx.commit(); + return std::nullopt; + } + + Message created = insert_message(tx, chat_id, sender_id, text, attachment_ids); + tx.commit(); + return created; +} + +std::optional MessageRepo::list_page( + const std::string& chat_id, + int limit, + const std::optional& cursor) { + + std::optional cur; + if (cursor) { + cur = parse_cursor(*cursor); + if (!cur) { + return std::nullopt; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + if (cur) { + auto owner_check = tx.exec( + "SELECT 1 FROM messages WHERE id = $1 AND chat_id = $2", + pqxx::params{cur->id, chat_id}); + if (owner_check.empty()) { + tx.commit(); + return std::nullopt; + } + } + + std::string sql = + "SELECT " + std::string(kMessageSelect) + ", " + kCreatedUsSql + " " + "FROM messages " + "WHERE chat_id = $1 "; + if (cur) { + sql += "AND (created_at, id) > (" + std::string(kCursorTimestampSql) + ", $4::uuid) "; + } + sql += "ORDER BY created_at ASC, id ASC LIMIT $2"; + + pqxx::result r; + if (cur) { + r = tx.exec(sql, pqxx::params{chat_id, limit + 1, cur->created_us, cur->id}); + } else { + r = tx.exec(sql, pqxx::params{chat_id, limit + 1}); + } + + MessagePage page; + const bool has_more = (static_cast(r.size()) > limit); + const int take = has_more ? limit : static_cast(r.size()); + page.items.reserve(take); + for (int i = 0; i < take; ++i) { + page.items.push_back(row_to_message(r[static_cast(i)])); + } + fill_attachment_ids(tx, page.items); + + if (has_more && take > 0) { + const auto& last = r[static_cast(take - 1)]; + page.next_cursor = make_cursor(last["created_us"].as(), + last["id"].as()); + } + + tx.commit(); + return page; +} + +CreateResult MessageRepo::create_idempotent( + const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::vector& attachment_ids, + const std::string& idem_key) { + const int ttl = idempotency_ttl_seconds(); + const std::string hash = sha256_hex(canonical_message_body(text, attachment_ids)); + + for (int attempt = 0; attempt < 3; ++attempt) { + { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + auto member_check = tx.exec( + "SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", + pqxx::params{chat_id, sender_id}); + if (member_check.empty()) { + tx.commit(); + return CreateResult{CreateResult::Status::NotFound, std::nullopt}; + } + if (!attachments_belong_to_chat(tx, chat_id, attachment_ids)) { + tx.commit(); + return CreateResult{CreateResult::Status::NotFound, std::nullopt}; + } + + const Message created = + insert_message(tx, chat_id, sender_id, text, attachment_ids); + if (insert_idempotency_key(tx, sender_id, chat_id, idem_key, hash, + created.id)) { + tx.commit(); + return CreateResult{CreateResult::Status::Created, created}; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto existing = tx.exec( + "SELECT request_hash, message_id, " + "EXTRACT(EPOCH FROM (now() - created_at))::bigint AS age_seconds " + "FROM idempotency_keys " + "WHERE user_id = $1 AND chat_id = $2 AND key = $3 " + "FOR UPDATE", + pqxx::params{sender_id, chat_id, idem_key}); + if (existing.empty()) { + tx.commit(); + continue; + } + + const std::string existing_hash = existing[0]["request_hash"].as(); + const long long age = existing[0]["age_seconds"].as(); + const std::string message_id = existing[0]["message_id"].as(); + if (age < ttl) { + if (existing_hash != hash) { + tx.commit(); + return CreateResult{CreateResult::Status::KeyConflict, std::nullopt}; + } + const Message replayed = load_message(tx, message_id); + tx.commit(); + return CreateResult{CreateResult::Status::Replayed, replayed}; + } + + tx.exec( + "DELETE FROM idempotency_keys " + "WHERE user_id = $1 AND chat_id = $2 AND key = $3", + pqxx::params{sender_id, chat_id, idem_key}); + if (!attachments_belong_to_chat(tx, chat_id, attachment_ids)) { + tx.commit(); + return CreateResult{CreateResult::Status::NotFound, std::nullopt}; + } + const Message created = + insert_message(tx, chat_id, sender_id, text, attachment_ids); + if (insert_idempotency_key(tx, sender_id, chat_id, idem_key, hash, + created.id)) { + tx.commit(); + return CreateResult{CreateResult::Status::Created, created}; + } + } + + throw std::runtime_error("idempotency retry exhausted"); +} diff --git a/src/message_repo.hpp b/src/message_repo.hpp new file mode 100644 index 00000000..ea4dbf1b --- /dev/null +++ b/src/message_repo.hpp @@ -0,0 +1,38 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include + +struct CreateResult { + enum class Status { Created, Replayed, NotFound, KeyConflict }; + Status status; + std::optional message; +}; + +class MessageRepo { +public: + explicit MessageRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::vector& attachment_ids); + + std::optional list_page( + const std::string& chat_id, + int limit, + const std::optional& cursor); + + CreateResult create_idempotent(const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::vector& attachment_ids, + const std::string& idem_key); + +private: + PgPool& pool_; +}; diff --git a/src/models.hpp b/src/models.hpp new file mode 100644 index 00000000..ffdbb315 --- /dev/null +++ b/src/models.hpp @@ -0,0 +1,86 @@ +#pragma once + +#include +#include +#include + +struct User { + std::string id; + std::string username; + std::string display_name; + std::string password_hash; + std::string created_at; +}; + +struct Chat { + std::string id; + std::string title; + std::vector member_ids; + std::string created_at; +}; + +struct Message { + std::string id; + std::string chat_id; + std::string sender_id; + std::string text; + std::string created_at; + std::vector attachment_ids; +}; + +struct MessagePage { + std::vector items; + std::optional next_cursor; +}; + +struct ChatPage { + std::vector items; + std::optional next_cursor; +}; + +// Public metadata; storage keys are derived internally. +struct Variant { + std::string name; + std::string content_type; + int size_bytes = 0; + std::string sha256; + int width = 0; + int height = 0; + std::string storage_key; // internal; filtered from API JSON +}; + +struct Attachment { + std::string id; + std::string chat_id; + std::string owner_id; + std::string filename; + std::string content_type; + int size_bytes = 0; + std::string sha256; + std::string status; // queued|processing|ready|failed + std::vector variants; + std::optional error_code; + std::string s3_key; // internal; never exposed in API JSON + std::string created_at; + std::string updated_at; +}; + +// Track 1: pending presigned PUT session (not a public attachment until complete). +struct DirectUpload { + std::string id; + std::string chat_id; + std::string owner_id; + std::string filename; + std::string content_type; + int expected_size = 0; + std::string expected_sha256; + std::string s3_key; // final key: attachments/{chat}/{id} + std::string staging_key; // presigned PUT target: staging/{chat}/{id} + std::string status; // pending|completed|aborted|expired + bool overdue = false; // pending && expires_at < now(); not a column + std::optional attachment_id; + std::string expires_at; // RFC3339 for JSON + long long expires_at_epoch = 0; // for INSERT + std::string created_at; + std::string updated_at; +}; diff --git a/src/outbox.cpp b/src/outbox.cpp new file mode 100644 index 00000000..a6f3db40 --- /dev/null +++ b/src/outbox.cpp @@ -0,0 +1,65 @@ +#include "outbox.hpp" +#include "attachment_queue.hpp" +#include "fault_injection.hpp" + +#include +#include +#include + +void enqueue_attachment_job(pqxx::work& tx, const std::string& job_id) { + const auto rows = tx.exec( + "INSERT INTO outbox(payload, available_at) " + "SELECT jsonb_build_object('schema_version', 1, 'type', 'attachment.process.v1', " + "'job_id', id::text, 'attachment_id', attachment_id::text, 'pipeline_version', pipeline_version, " + "'attempt', retries + 1, 'created_at', " + "to_char(created_at AT TIME ZONE 'UTC', 'YYYY-MM-DD\"T\"HH24:MI:SS\"Z\"')), " + "next_attempt_at FROM jobs WHERE id=$1::uuid RETURNING id", pqxx::params{job_id}); + if (rows.size() != 1) throw std::runtime_error("outbox job missing"); +} + +OutboxPublisher::OutboxPublisher(std::string db_url, std::string broker_url) + : thread_([this, db_url = std::move(db_url), broker_url = std::move(broker_url)] { + run(db_url, broker_url); + }) {} + +OutboxPublisher::~OutboxPublisher() { + stopping_.store(true); + cv_.notify_all(); + thread_.join(); +} + +bool OutboxPublisher::wait_interval() { + std::unique_lock lock(mutex_); + return cv_.wait_for(lock, std::chrono::seconds(1), [this] { return stopping_.load(); }); +} + +void OutboxPublisher::run(const std::string& db_url, const std::string& broker_url) { + while (!stopping_.load()) { + try { + // Dedicated pools keep broker failure/reconnect off the HTTP path. + PgPool pg(db_url, 1); + RedisPool redis(broker_url, 1); + AttachmentQueue queue(redis); + while (!stopping_.load()) { + { + auto lease = pg.acquire(); + pqxx::work tx(*lease); + const auto rows = tx.exec( + "SELECT id, payload FROM outbox WHERE NOT published AND available_at<=now() " + "ORDER BY available_at, id LIMIT 32 FOR UPDATE SKIP LOCKED"); + for (const auto& row : rows) { + queue.publish(row["payload"].as()); + lab_crash_at("outbox_after_publish"); + tx.exec("UPDATE outbox SET published=true WHERE id=$1", + pqxx::params{row["id"].as()}); + } + tx.commit(); + } + if (wait_interval()) break; + } + } catch (const std::exception&) { + std::clog << "outbox publish unavailable; durable rows will be retried\n"; + if (wait_interval()) break; + } + } +} diff --git a/src/outbox.hpp b/src/outbox.hpp new file mode 100644 index 00000000..987e1e3f --- /dev/null +++ b/src/outbox.hpp @@ -0,0 +1,26 @@ +#pragma once + +#include "db.hpp" +#include +#include +#include +#include +#include + +// Must share the transaction that inserts/updates the job. +void enqueue_attachment_job(pqxx::work& tx, const std::string& job_id); + +class OutboxPublisher { +public: + OutboxPublisher(std::string db_url, std::string broker_url); + ~OutboxPublisher(); + OutboxPublisher(const OutboxPublisher&) = delete; + OutboxPublisher& operator=(const OutboxPublisher&) = delete; +private: + void run(const std::string& db_url, const std::string& broker_url); + bool wait_interval(); + std::atomic stopping_{false}; + std::mutex mutex_; + std::condition_variable cv_; + std::thread thread_; +}; diff --git a/src/pg_session_repo.cpp b/src/pg_session_repo.cpp new file mode 100644 index 00000000..507f2ddd --- /dev/null +++ b/src/pg_session_repo.cpp @@ -0,0 +1,66 @@ +#include "pg_session_repo.hpp" + +#include +#include + +#include +#include +#include + +namespace { + +std::string random_token_hex() { + unsigned char buf[32]; + randombytes_buf(buf, sizeof(buf)); + static const char hex[] = "0123456789abcdef"; + std::string out; + out.resize(sizeof(buf) * 2); + for (std::size_t i = 0; i < sizeof(buf); ++i) { + out[i * 2] = hex[buf[i] >> 4]; + out[i * 2 + 1] = hex[buf[i] & 0x0f]; + } + return out; +} + +std::int64_t now_unix() { + return static_cast(std::time(nullptr)); +} + +} + +ISessionRepo::Created PgSessionRepo::create(const std::string& user_id) { + const std::string token = random_token_hex(); + const std::int64_t exp = now_unix() + ttl_; + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + tx.exec( + "INSERT INTO sessions (token, user_id, expires_at) " + "VALUES ($1, $2, to_timestamp($3::bigint))", + pqxx::params{token, user_id, exp}); + tx.commit(); + + return Created{token, exp}; +} + +std::optional PgSessionRepo::lookup(const std::string& token) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT user_id FROM sessions " + "WHERE token = $1 AND expires_at > now()", + pqxx::params{token}); + tx.commit(); + if (r.empty()) return std::nullopt; + return r[0]["user_id"].as(); +} + +bool PgSessionRepo::revoke(const std::string& token) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "DELETE FROM sessions WHERE token = $1", + pqxx::params{token}); + tx.commit(); + return r.affected_rows() > 0; +} \ No newline at end of file diff --git a/src/pg_session_repo.hpp b/src/pg_session_repo.hpp new file mode 100644 index 00000000..ed005fec --- /dev/null +++ b/src/pg_session_repo.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include "db.hpp" +#include "session_repo_base.hpp" + +class PgSessionRepo : public ISessionRepo { +public: + PgSessionRepo(PgPool& pool, int ttl_seconds) + : pool_(pool), ttl_(ttl_seconds) {} + + Created create(const std::string& user_id) override; + std::optional lookup(const std::string& token) override; + bool revoke(const std::string& token) override; + +private: + PgPool& pool_; + int ttl_; +}; \ No newline at end of file diff --git a/src/redis_pool.cpp b/src/redis_pool.cpp new file mode 100644 index 00000000..035b5f20 --- /dev/null +++ b/src/redis_pool.cpp @@ -0,0 +1,216 @@ +#include "redis_pool.hpp" +#include "errors.hpp" + +#include +#include +#include +#include + +namespace { + +constexpr timeval kConnectTimeout{2, 0}; +constexpr timeval kCommandTimeout{2, 0}; +constexpr auto kAcquireTimeout = std::chrono::seconds(3); + +struct RedisUrl { + std::string host = "127.0.0.1"; + int port = 6379; + std::string password; + int db = 0; +}; + +RedisUrl parse_redis_url(const std::string& url) { + RedisUrl out; + const std::string prefix = "redis://"; + if (url.compare(0, prefix.size(), prefix) != 0) { + throw std::runtime_error("redis url must start with redis://"); + } + std::string rest = url.substr(prefix.size()); + + const auto slash = rest.find('/'); + if (slash != std::string::npos) { + const std::string db_str = rest.substr(slash + 1); + rest.resize(slash); + if (!db_str.empty()) { + out.db = std::atoi(db_str.c_str()); + } + } + + const auto at = rest.find('@'); + std::string hostport = rest; + if (at != std::string::npos) { + const std::string creds = rest.substr(0, at); + hostport = rest.substr(at + 1); + const auto colon = creds.find(':'); + if (colon != std::string::npos) { + out.password = creds.substr(colon + 1); + } else { + out.password = creds; + } + } + + const auto colon = hostport.find(':'); + if (colon == std::string::npos) { + out.host = hostport; + } else { + out.host = hostport.substr(0, colon); + out.port = std::atoi(hostport.substr(colon + 1).c_str()); + } + + return out; +} + +redisContext* make_connection(const RedisUrl& u) { + redisContext* c = redisConnectWithTimeout(u.host.c_str(), u.port, kConnectTimeout); + if (c == nullptr) { + throw std::runtime_error("redisConnect: allocation failed"); + } + if (c->err) { + const std::string err = c->errstr; + redisFree(c); + throw DependencyUnavailable("redisConnect failed: " + err); + } + if (redisSetTimeout(c, kCommandTimeout) != REDIS_OK) { + redisFree(c); + throw DependencyUnavailable("redisSetTimeout failed"); + } + if (!u.password.empty()) { + redisReply* r = static_cast( + redisCommand(c, "AUTH %s", u.password.c_str())); + if (r == nullptr) { + redisFree(c); + throw std::runtime_error("redis AUTH: no reply"); + } + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + redisFree(c); + throw std::runtime_error("redis AUTH failed"); + } + } + if (u.db != 0) { + redisReply* r = static_cast( + redisCommand(c, "SELECT %d", u.db)); + if (r == nullptr) { + redisFree(c); + throw std::runtime_error("redis SELECT: no reply"); + } + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + redisFree(c); + throw std::runtime_error("redis SELECT failed"); + } + } + return c; +} + +} + +RedisPool::RedisPool(std::string url, std::size_t n) + : url_(std::move(url)) { + if (n == 0) { + throw std::runtime_error("RedisPool: n must be > 0"); + } + const RedisUrl parsed = parse_redis_url(url_); + all_.reserve(n); + idle_.reserve(n); + for (std::size_t i = 0; i < n; ++i) { + ConnPtr c(make_connection(parsed)); + idle_.push_back(c.get()); + all_.push_back(std::move(c)); + } +} + +RedisPool::~RedisPool() { + { + std::lock_guard lk(mu_); + shutting_down_ = true; + } + cv_.notify_all(); +} + +RedisPool::Lease::Lease(RedisPool& pool) + : pool_(&pool), ctx_(pool.take()) {} + +RedisPool::Lease::~Lease() { + if (pool_ != nullptr && ctx_ != nullptr) { + pool_->give_back(ctx_); + } +} + +RedisPool::Lease::Lease(Lease&& other) noexcept + : pool_(other.pool_), ctx_(other.ctx_) { + other.pool_ = nullptr; + other.ctx_ = nullptr; +} + +RedisPool::Lease RedisPool::acquire() { + return Lease(*this); +} + +redisContext* RedisPool::take() { + std::unique_lock lk(mu_); + if (!cv_.wait_for(lk, kAcquireTimeout, + [&]() { return shutting_down_ || !idle_.empty(); })) { + throw DependencyUnavailable("redis pool: acquire timeout"); + } + if (shutting_down_) { + throw DependencyUnavailable("redis pool is shutting down"); + } + redisContext* c = idle_.back(); + idle_.pop_back(); + lk.unlock(); + + bool alive = false; + if (!c->err) { + redisReply* r = static_cast(redisCommand(c, "PING")); + if (r != nullptr && r->type == REDIS_REPLY_STATUS) { + alive = true; + } + if (r != nullptr) freeReplyObject(r); + } + if (alive) { + return c; + } + + ConnPtr fresh; + try { + fresh.reset(make_connection(parse_redis_url(url_))); + } catch (const std::exception& e) { + // Слот возвращается в пул, иначе после нескольких неудач пул опустеет навсегда. + give_back(c); + throw DependencyUnavailable(std::string("redis reconnect failed: ") + e.what()); + } + + std::lock_guard lk2(mu_); + for (auto& up : all_) { + if (up.get() == c) { + up = std::move(fresh); + return up.get(); + } + } + throw std::logic_error("RedisPool: connection not owned by pool"); +} + +void RedisPool::give_back(redisContext* c) { + { + std::lock_guard lk(mu_); + idle_.push_back(c); + } + cv_.notify_one(); +} + +bool RedisPool::ping() { + try { + auto lease = acquire(); + redisContext* c = lease.ctx(); + redisReply* r = static_cast(redisCommand(c, "PING")); + if (r == nullptr) return false; + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + return ok; + } catch (...) { + return false; + } +} \ No newline at end of file diff --git a/src/redis_pool.hpp b/src/redis_pool.hpp new file mode 100644 index 00000000..00323151 --- /dev/null +++ b/src/redis_pool.hpp @@ -0,0 +1,59 @@ +#pragma once + +#include + +#include +#include +#include +#include +#include +#include + +class RedisPool { +public: + RedisPool(std::string url, std::size_t n); + ~RedisPool(); + + RedisPool(const RedisPool&) = delete; + RedisPool& operator=(const RedisPool&) = delete; + + class Lease { + public: + explicit Lease(RedisPool& pool); + ~Lease(); + Lease(Lease&& other) noexcept; + Lease& operator=(Lease&&) = delete; + Lease(const Lease&) = delete; + Lease& operator=(const Lease&) = delete; + + redisContext* ctx() const { return ctx_; } + + private: + RedisPool* pool_; + redisContext* ctx_; + }; + + Lease acquire(); + + bool ping(); + +private: + friend class Lease; + + struct RedisDeleter { + void operator()(redisContext* c) const noexcept { + if (c != nullptr) ::redisFree(c); + } + }; + using ConnPtr = std::unique_ptr; + + redisContext* take(); + void give_back(redisContext* c); + + std::string url_; + std::vector all_; + std::vector idle_; + std::mutex mu_; + std::condition_variable cv_; + bool shutting_down_ = false; +}; \ No newline at end of file diff --git a/src/s3_client.cpp b/src/s3_client.cpp new file mode 100644 index 00000000..8b0aee4f --- /dev/null +++ b/src/s3_client.cpp @@ -0,0 +1,281 @@ +#include "s3_client.hpp" + +#include +#include +#include +#include +#include + +#include +#include +#include + +namespace { + +std::string read_file_trim(const std::string& path) { + std::ifstream in(path); + if (!in) { + throw std::runtime_error("cannot open secret/file: " + path); + } + std::string s((std::istreambuf_iterator(in)), + std::istreambuf_iterator()); + while (!s.empty() && (s.back() == '\n' || s.back() == '\r' || s.back() == ' ')) { + s.pop_back(); + } + return s; +} + +std::string env_or(const char* key, const char* fallback = "") { + const char* v = std::getenv(key); + return (v && *v) ? std::string(v) : std::string(fallback); +} + +void parse_endpoint(const std::string& endpoint, std::string& host, unsigned& port, + bool& https) { + https = true; + host = endpoint; + port = 0; + if (host.rfind("http://", 0) == 0) { + https = false; + host = host.substr(7); + } else if (host.rfind("https://", 0) == 0) { + https = true; + host = host.substr(8); + } + // strip path + const auto slash = host.find('/'); + if (slash != std::string::npos) { + host = host.substr(0, slash); + } + const auto colon = host.rfind(':'); + if (colon != std::string::npos) { + port = static_cast(std::stoul(host.substr(colon + 1))); + host = host.substr(0, colon); + } + if (port == 0) { + port = https ? 443u : 80u; + } +} + +} // namespace + +struct S3Client::Impl { + minio::s3::BaseUrl base_url; + minio::s3::BaseUrl presign_url; + std::unique_ptr provider; + std::unique_ptr client; + std::unique_ptr presign_client; // null → use client +}; + +S3Client::Config S3Client::from_env() { + Config c; + // Ops endpoint (Stat/Get/Put/Delete). Presign may use S3_PRESIGN_ENDPOINT + // (read in ctor) so signed Host matches the client-reachable address. + c.endpoint = env_or("S3_ENDPOINT", "http://minio:9000"); + c.region = env_or("S3_REGION", "us-east-1"); + c.bucket = env_or("S3_BUCKET"); + if (c.bucket.empty()) { + throw std::runtime_error("S3_BUCKET is required"); + } + + const std::string key_file = env_or("S3_ACCESS_KEY_ID_FILE"); + const std::string secret_file = env_or("S3_SECRET_ACCESS_KEY_FILE"); + if (key_file.empty() || secret_file.empty()) { + throw std::runtime_error( + "S3_ACCESS_KEY_ID_FILE and S3_SECRET_ACCESS_KEY_FILE are required"); + } + c.access_key = read_file_trim(key_file); + c.secret_key = read_file_trim(secret_file); + if (c.access_key.empty() || c.secret_key.empty()) { + throw std::runtime_error("S3 credentials files are empty"); + } + return c; +} + +S3Client::S3Client(Config cfg) : cfg_(std::move(cfg)), impl_(std::make_unique()) { + if (cfg_.endpoint.empty() || cfg_.bucket.empty() || + cfg_.access_key.empty() || cfg_.secret_key.empty()) { + throw std::runtime_error("S3Client: incomplete config"); + } + + std::string host; + unsigned port = 0; + bool https = false; + parse_endpoint(cfg_.endpoint, host, port, https); + + impl_->base_url = minio::s3::BaseUrl(host, https, cfg_.region); + impl_->base_url.port = port; + // MinIO requires path-style addressing. + impl_->base_url.virtual_style = false; + + impl_->provider = std::make_unique( + cfg_.access_key, cfg_.secret_key); + impl_->client = + std::make_unique(impl_->base_url, impl_->provider.get()); + + // Separate BaseUrl for presigning when S3_PRESIGN_ENDPOINT differs. + const std::string presign_ep = env_or("S3_PRESIGN_ENDPOINT"); + if (!presign_ep.empty() && presign_ep != cfg_.endpoint) { + std::string ph; + unsigned pp = 0; + bool phttps = false; + parse_endpoint(presign_ep, ph, pp, phttps); + impl_->presign_url = minio::s3::BaseUrl(ph, phttps, cfg_.region); + impl_->presign_url.port = pp; + impl_->presign_url.virtual_style = false; + impl_->presign_client = std::make_unique( + impl_->presign_url, impl_->provider.get()); + } +} + +S3Client::~S3Client() = default; + +void S3Client::put_object(const std::string& key, + std::istream& body, + std::int64_t size_bytes, + const std::string& content_type) { + if (size_bytes < 0) { + throw std::invalid_argument("put_object: negative size"); + } + + // part_size=0 → library chooses multipart sizing; streams from `body`. + minio::s3::PutObjectArgs args(body, static_cast(size_bytes), 0); + args.bucket = cfg_.bucket; + args.object = key; + if (!content_type.empty()) { + args.content_type = content_type; + } + + minio::s3::PutObjectResponse resp = impl_->client->PutObject(args); + if (!resp) { + throw std::runtime_error("S3 PutObject failed: " + resp.Error().String()); + } +} + +void S3Client::get_object(const std::string& key, std::ostream& out) { + get_object(key, [&](const char* data, std::size_t n) { + out.write(data, static_cast(n)); + if (!out) { + throw std::runtime_error("get_object: write failed"); + } + }); +} + +std::int64_t S3Client::get_object( + const std::string& key, + const std::function& on_chunk) { + std::int64_t total = 0; + minio::s3::GetObjectArgs args; + args.bucket = cfg_.bucket; + args.object = key; + args.datafunc = [&](minio::http::DataFunctionArgs da) -> bool { + on_chunk(da.datachunk.data(), da.datachunk.size()); + total += static_cast(da.datachunk.size()); + return true; + }; + + minio::s3::GetObjectResponse resp = impl_->client->GetObject(args); + if (!resp) { + throw std::runtime_error("S3 GetObject failed: " + resp.Error().String()); + } + return total; +} + +void S3Client::copy_object(const std::string& src_key, + const std::string& dst_key) { + if (src_key.empty() || dst_key.empty() || src_key == dst_key) { + throw std::invalid_argument("copy_object: bad keys"); + } + minio::s3::CopyObjectArgs args; + args.bucket = cfg_.bucket; + args.object = dst_key; + args.source.bucket = cfg_.bucket; + args.source.object = src_key; + minio::s3::CopyObjectResponse resp = impl_->client->CopyObject(args); + if (!resp) { + throw std::runtime_error("S3 CopyObject failed: " + resp.Error().String()); + } +} + +void S3Client::delete_object(const std::string& key) { + minio::s3::RemoveObjectArgs args; + args.bucket = cfg_.bucket; + args.object = key; + minio::s3::RemoveObjectResponse resp = impl_->client->RemoveObject(args); + if (!resp) { + throw std::runtime_error("S3 DeleteObject failed: " + resp.Error().String()); + } +} + +bool S3Client::stat_object(const std::string& key, std::int64_t& size_bytes, + std::string& etag) { + minio::s3::StatObjectArgs args; + args.bucket = cfg_.bucket; + args.object = key; + minio::s3::StatObjectResponse resp = impl_->client->StatObject(args); + if (!resp) { + // NoSuchKey / Not Found → absent + const std::string err = resp.Error().String(); + if (resp.code == "NoSuchKey" || resp.status_code == 404) { + return false; + } + throw std::runtime_error("S3 StatObject failed: " + err); + } + size_bytes = static_cast(resp.size); + etag = resp.etag; + return true; +} + +std::string S3Client::presign_put(const std::string& key, + unsigned expiry_seconds, + const std::string& content_type) { + if (expiry_seconds < 1 || expiry_seconds > 7 * 24 * 3600u) { + throw std::invalid_argument("presign_put: bad expiry"); + } + minio::s3::Client* c = + impl_->presign_client ? impl_->presign_client.get() : impl_->client.get(); + + // Note: minio-cpp query-presign signs method/host/path/query only — it does + // not bind Content-Type into the signature. Clients should still send + // Content-Type so the object metadata is correct; complete() re-validates + // magic/sha256 against the session. + (void)content_type; + minio::s3::GetPresignedObjectUrlArgs args; + args.bucket = cfg_.bucket; + args.object = key; + args.method = minio::http::Method::kPut; + args.expiry_seconds = expiry_seconds; + + minio::s3::GetPresignedObjectUrlResponse resp = c->GetPresignedObjectUrl(args); + if (!resp) { + throw std::runtime_error("S3 PresignPut failed: " + resp.Error().String()); + } + return resp.url; +} + +std::vector S3Client::old_staging(const std::string& cursor, + int retention_seconds, + std::string& next_cursor) { + minio::s3::ListObjectsArgs args; + args.bucket = cfg_.bucket; + args.prefix = "staging/"; + args.recursive = true; + args.max_keys = 100; + args.start_after = cursor; + auto cutoff = minio::utils::UtcTime::Now(); + cutoff.Add(-retention_seconds); + auto result = impl_->client->ListObjects(args); + std::vector keys; + next_cursor.clear(); + for (int count = 0; result && count < 100; ++count) { + const auto& item = *result; + if (!item) throw std::runtime_error("S3 staging listing failed"); + if (!item.is_prefix && item.last_modified <= cutoff) keys.push_back(item.name); + if (count == 99) { + next_cursor = item.name; + break; + } + ++result; + } + return keys; +} diff --git a/src/s3_client.hpp b/src/s3_client.hpp new file mode 100644 index 00000000..aea8b012 --- /dev/null +++ b/src/s3_client.hpp @@ -0,0 +1,71 @@ +#pragma once + +#include +#include +#include +#include +#include +#include +#include + +// Thin wrapper over AWS SDK for C++ (S3 only). Credentials and SigV4 come from +// the SDK — no hand-rolled signing. + +class S3Client { +public: + struct Config { + std::string endpoint; // e.g. http://minio:9000 + std::string region; // e.g. us-east-1 + std::string bucket; + std::string access_key; + std::string secret_key; + }; + + explicit S3Client(Config cfg); + ~S3Client(); + + S3Client(const S3Client&) = delete; + S3Client& operator=(const S3Client&) = delete; + + static Config from_env(); + + const std::string& bucket() const { return cfg_.bucket; } + + // Stream upload. `body` must yield exactly `size_bytes` bytes. + void put_object(const std::string& key, + std::istream& body, + std::int64_t size_bytes, + const std::string& content_type); + + // Stream download into `out` (chunked reads from SDK body stream). + void get_object(const std::string& key, std::ostream& out); + + // Stream download with a consumer callback (chunk, size). Returns total bytes. + std::int64_t get_object(const std::string& key, + const std::function& on_chunk); + + void delete_object(const std::string& key); + + // At most 100 entries examined per call; cursor wraps to empty at end. + std::vector old_staging(const std::string& cursor, + int retention_seconds, std::string& next_cursor); + + // Server-side copy inside the bucket (complete: staging → final). + void copy_object(const std::string& src_key, const std::string& dst_key); + + // HeadObject-style metadata. Returns false if the object does not exist. + bool stat_object(const std::string& key, std::int64_t& size_bytes, + std::string& etag); + + // Presigned PUT URL via minio-cpp (SigV4). Optional required Content-Type + // is bound into the signature when non-empty. + // expiry_seconds: typically 60–600 for Track 1. + std::string presign_put(const std::string& key, + unsigned expiry_seconds, + const std::string& content_type); + +private: + struct Impl; + Config cfg_; + std::unique_ptr impl_; +}; diff --git a/src/session_repo.cpp b/src/session_repo.cpp new file mode 100644 index 00000000..28f1edbb --- /dev/null +++ b/src/session_repo.cpp @@ -0,0 +1,87 @@ +#include "session_repo.hpp" +#include "errors.hpp" + +#include + +#include +#include +#include +#include + +namespace { + +std::string random_token_hex() { + unsigned char buf[32]; + randombytes_buf(buf, sizeof(buf)); + static const char hex[] = "0123456789abcdef"; + std::string out; + out.resize(sizeof(buf) * 2); + for (std::size_t i = 0; i < sizeof(buf); ++i) { + out[i * 2] = hex[buf[i] >> 4]; + out[i * 2 + 1] = hex[buf[i] & 0x0f]; + } + return out; +} + +std::int64_t now_unix() { + return static_cast(std::time(nullptr)); +} + +redisReply* check_reply(redisContext* c, redisReply* r) { + if (r == nullptr) { + const std::string err = c->err ? c->errstr : "no reply"; + throw DependencyUnavailable("redis command failed: " + err); + } + return r; +} + +} + +ISessionRepo::Created SessionRepo::create(const std::string& user_id) { + const std::string token = random_token_hex(); + const std::int64_t exp = now_unix() + ttl_; + + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "SET session:%s %s EX %d", + token.c_str(), user_id.c_str(), ttl_)); + check_reply(c, r); + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + throw std::runtime_error("redis SET returned non-status"); + } + + return Created{token, exp}; +} + +std::optional SessionRepo::lookup(const std::string& token) { + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "GET session:%s", token.c_str())); + check_reply(c, r); + + std::optional out; + if (r->type == REDIS_REPLY_STRING) { + out = std::string(r->str, r->len); + } + freeReplyObject(r); + return out; +} + +bool SessionRepo::revoke(const std::string& token) { + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "DEL session:%s", token.c_str())); + check_reply(c, r); + + const bool existed = (r->type == REDIS_REPLY_INTEGER && r->integer == 1); + freeReplyObject(r); + return existed; +} \ No newline at end of file diff --git a/src/session_repo.hpp b/src/session_repo.hpp new file mode 100644 index 00000000..550eae6b --- /dev/null +++ b/src/session_repo.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include "redis_pool.hpp" +#include "session_repo_base.hpp" + +class SessionRepo : public ISessionRepo { +public: + SessionRepo(RedisPool& pool, int ttl_seconds) + : pool_(pool), ttl_(ttl_seconds) {} + + Created create(const std::string& user_id) override; + std::optional lookup(const std::string& token) override; + bool revoke(const std::string& token) override; + +private: + RedisPool& pool_; + int ttl_; +}; \ No newline at end of file diff --git a/src/session_repo_base.hpp b/src/session_repo_base.hpp new file mode 100644 index 00000000..4a685ba2 --- /dev/null +++ b/src/session_repo_base.hpp @@ -0,0 +1,22 @@ +#pragma once + +#include +#include +#include + + +class ISessionRepo { +public: + virtual ~ISessionRepo() = default; + + struct Created { + std::string token; + std::int64_t expires_at; // unix-время в секундах UTC + }; + + virtual Created create(const std::string& user_id) = 0; + + virtual std::optional lookup(const std::string& token) = 0; + + virtual bool revoke(const std::string& token) = 0; +}; \ No newline at end of file diff --git a/src/staging_cleaner.cpp b/src/staging_cleaner.cpp new file mode 100644 index 00000000..b4767f58 --- /dev/null +++ b/src/staging_cleaner.cpp @@ -0,0 +1,77 @@ +#include "staging_cleaner.hpp" +#include "attachment_storage.hpp" + +#include +#include + +void StagingCleaner::clean(const std::string& key) { + static const std::regex pattern( + "^staging/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/" + "([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"); + std::smatch match; + if (!std::regex_match(key, match, pattern)) return; + const std::string id = match[1]; + auto lease = pg_.acquire(); + pqxx::work tx(*lease); + if (!tx.exec("SELECT pg_try_advisory_xact_lock(hashtextextended('staging:' || $1::uuid::text, 0))", + pqxx::params{id})[0][0].as()) return; + auto rows = tx.exec( + "SELECT a.chat_id, a.staging_key, a.s3_key, a.size_bytes, a.variants, a.status, j.id AS job_id, " + "a.updated_at < now()-($2::bigint * interval '1 second') AS expired " + "FROM attachments a LEFT JOIN jobs j ON j.attachment_id=a.id AND j.pipeline_version=a.pipeline_version " + "WHERE a.id=$1::uuid FOR UPDATE OF a SKIP LOCKED", pqxx::params{id, retention_seconds_}); + if (rows.empty()) { + // An existing locked row is not an orphan. + if (!tx.exec("SELECT 1 FROM attachments WHERE id=$1::uuid", pqxx::params{id}).empty()) return; + } else { + const auto& row = rows[0]; + if (row["staging_key"].is_null() || row["staging_key"].as() != key) return; + const std::string status = row["status"].as(); + if (status != "ready" && !(status == "failed" && row["expired"].as())) return; + if (!row["job_id"].is_null() && !tx.exec( + "SELECT pg_try_advisory_xact_lock(hashtextextended($1::uuid::text, 0))", + pqxx::params{row["job_id"].as()})[0][0].as()) return; + if (!tx.exec("SELECT 1 FROM jobs WHERE attachment_id=$1::uuid AND source_key=$2 " + "AND status IN ('queued','processing')", pqxx::params{id,key}).empty()) return; + if (status == "ready") { + std::int64_t size = 0; + std::string etag; + if (!s3_.stat_object(row["s3_key"].as(), size, etag) || + size != row["size_bytes"].as()) return; + for (const auto& variant : nlohmann::json::parse(row["variants"].as())) { + const std::string object_key = variant.value("storage_key", + attachment_variant_key(row["chat_id"].as(), id, variant.at("name").get())); + if (!s3_.stat_object(object_key, size, etag) || + size != variant.at("size_bytes").get()) return; + } + } + } + // A still-valid presigned URL can recreate the key: wait for its expiry. + if (!tx.exec("SELECT 1 FROM direct_uploads WHERE staging_key=$1 AND expires_at>now()", + pqxx::params{key}).empty()) return; + s3_.delete_object(key); + if (!rows.empty()) { + // Internal cleanup does not change public metadata/updated_at. + tx.exec("UPDATE attachments SET staging_cleaned_at=now() WHERE id=$1::uuid", pqxx::params{id}); + } + tx.commit(); +} + +void StagingCleaner::sweep() { + std::vector known; + { + auto lease = pg_.acquire(); + pqxx::work tx(*lease); + for (const auto& row : tx.exec( + "SELECT staging_key FROM attachments WHERE staging_key IS NOT NULL " + "AND staging_cleaned_at IS NULL AND (status='ready' OR " + "(status='failed' AND updated_at()); + } + } + for (const auto& key : known) clean(key); + std::string next; + for (const auto& key : s3_.old_staging(cursor_, retention_seconds_, next)) clean(key); + cursor_ = std::move(next); +} diff --git a/src/staging_cleaner.hpp b/src/staging_cleaner.hpp new file mode 100644 index 00000000..12e261ae --- /dev/null +++ b/src/staging_cleaner.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include "db.hpp" +#include "s3_client.hpp" +#include + +class StagingCleaner { +public: + StagingCleaner(PgPool& pg, S3Client& s3, int retention_seconds) + : pg_(pg), s3_(s3), retention_seconds_(retention_seconds) {} + void clean(const std::string& key); + void sweep(); +private: + PgPool& pg_; + S3Client& s3_; + int retention_seconds_; + std::string cursor_; +}; diff --git a/src/user_repo.cpp b/src/user_repo.cpp new file mode 100644 index 00000000..2cc4bc9c --- /dev/null +++ b/src/user_repo.cpp @@ -0,0 +1,100 @@ +#include "user_repo.hpp" + +#include + +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +User row_to_user(const pqxx::row& r) { + User u; + u.id = r["id"].as(); + u.username = r["username"].as(); + u.display_name = r["display_name"].as(); + u.password_hash = r["password_hash"].as(); + u.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return u; +} + +constexpr const char* kUserColumns = + "id, username, display_name, password_hash, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +} + +std::optional UserRepo::create(const std::string& username, + const std::string& display_name, + const std::string& password_hash) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + try { + const std::string id = make_uuid(); + auto r = tx.exec( + "INSERT INTO users (id, username, display_name, password_hash, created_at) " + "VALUES ($1, $2, $3, $4, to_timestamp($5::bigint)) " + "RETURNING " + std::string(kUserColumns), + pqxx::params{id, username, display_name, password_hash, now_epoch_str()}); + tx.commit(); + return row_to_user(r[0]); + } catch (const pqxx::unique_violation&) { + tx.abort(); + return std::nullopt; + } +} + +std::optional UserRepo::find_by_id(const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kUserColumns) + " FROM users WHERE id = $1", + pqxx::params{id}); + tx.commit(); + if (r.empty()) return std::nullopt; + return row_to_user(r[0]); +} + +std::optional UserRepo::find_by_username(const std::string& username) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kUserColumns) + " FROM users WHERE username = $1", + pqxx::params{username}); + tx.commit(); + if (r.empty()) return std::nullopt; + return row_to_user(r[0]); +} \ No newline at end of file diff --git a/src/user_repo.hpp b/src/user_repo.hpp new file mode 100644 index 00000000..b8cbada2 --- /dev/null +++ b/src/user_repo.hpp @@ -0,0 +1,22 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include + +class UserRepo { +public: + explicit UserRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& username, + const std::string& display_name, + const std::string& password_hash); + + std::optional find_by_id(const std::string& id); + std::optional find_by_username(const std::string& username); + +private: + PgPool& pool_; +}; \ No newline at end of file diff --git a/src/worker_main.cpp b/src/worker_main.cpp new file mode 100644 index 00000000..01fdd470 --- /dev/null +++ b/src/worker_main.cpp @@ -0,0 +1,220 @@ +#include "attachment_queue.hpp" +#include "attachment_repo.hpp" +#include "attachment_storage.hpp" +#include "staging_cleaner.hpp" +#include "image_pipeline.hpp" +#include "job_repo.hpp" +#include "fault_injection.hpp" +#include "s3_client.hpp" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +namespace { +volatile std::sig_atomic_t stop_requested = 0; +void stop(int) { stop_requested = 1; } + +class Watchdog { +public: + explicit Watchdog(int seconds) : seconds_(seconds), thread_([this] { + while (!stopping_.load()) { + const auto deadline = deadline_.load(); + if (deadline && now_ms() >= deadline) { + std::cerr << "worker job timed out; exiting for durable recovery\n"; + std::_Exit(124); + } + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + } + }) {} + ~Watchdog() { stopping_.store(true); thread_.join(); } + void arm() { deadline_.store(now_ms() + seconds_ * 1000LL); } + void clear() { deadline_.store(0); } +private: + static long long now_ms() { + return std::chrono::duration_cast( + std::chrono::steady_clock::now().time_since_epoch()).count(); + } + int seconds_; + std::atomic deadline_{0}; + std::atomic stopping_{false}; + std::thread thread_; +}; + +struct Deadline { + Watchdog& timer; + explicit Deadline(Watchdog& timer) : timer(timer) { timer.arm(); } + ~Deadline() { timer.clear(); } +}; + +int setting(const char* name, int fallback, int minimum, int maximum) { + const char* value = std::getenv(name); + if (!value) return fallback; + std::size_t end = 0; + const int result = std::stoi(value, &end); + if (value[end] || result < minimum || result > maximum) { + throw std::runtime_error("invalid worker setting"); + } + return result; +} + +std::string sha256(const std::string& bytes) { + unsigned char hash[crypto_hash_sha256_BYTES]; + crypto_hash_sha256(hash, reinterpret_cast(bytes.data()), bytes.size()); + char hex[crypto_hash_sha256_BYTES * 2 + 1]; + sodium_bin2hex(hex, sizeof(hex), hash, sizeof(hash)); + return hex; +} + +bool valid_job(const nlohmann::json& j) { + static const std::regex uuid("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + return j.is_object() && j.value("schema_version", 0) == 1 && + j.value("type", "") == "attachment.process.v1" && j.value("pipeline_version", 0) >= 1 && j.value("pipeline_version", 0) <= 2 && + j.value("attempt", 0) >= 1 && j.contains("created_at") && j.at("created_at").is_string() && + std::regex_match(j.value("job_id", ""), uuid) && + std::regex_match(j.value("attachment_id", ""), uuid); +} + +void verify_ready(S3Client& s3, const Attachment& a) { + std::int64_t size = 0; + std::string etag; + if (!s3.stat_object(a.s3_key, size, etag) || size != a.size_bytes) { + throw std::runtime_error("ready original missing"); + } + bool thumbnail = false; + for (const auto& v : a.variants) { + thumbnail = thumbnail || v.name == "thumbnail"; + if (!s3.stat_object((v.storage_key.empty() ? attachment_variant_key(a.chat_id, a.id, v.name) : v.storage_key), size, etag) || + size != v.size_bytes) throw std::runtime_error("ready variant missing"); + } + if (!thumbnail) throw std::runtime_error("ready thumbnail missing"); +} +} // namespace + +int main() { + std::signal(SIGTERM, stop); + std::signal(SIGINT, stop); + try { + if (sodium_init() < 0) return 1; + const RetryPolicy retry{ + setting("JOB_MAX_ATTEMPTS", 6, 1, 100), + setting("JOB_RETRY_BASE_MS", 1000, 1, 3600000), + setting("JOB_RETRY_MAX_MS", 60000, 1, 3600000)}; + if (retry.base_delay_ms > retry.max_delay_ms) throw std::runtime_error("invalid retry policy"); + const int timeout = setting("JOB_TIMEOUT_SECONDS", 60, 1, 3600); + const int cleanup_interval = setting("STAGING_CLEANUP_INTERVAL_SECONDS", 60, 1, 86400); + const int retention = setting("STAGING_RETENTION_SECONDS", 86400, 1, 31536000); + const int reclaim_idle = setting("JOB_RECLAIM_IDLE_MS", 5000, 1000, 3600000); + const auto db_url = read_secret_file("DATABASE_URL_FILE"); + { + auto conn = open_pg_connection(db_url, false); + apply_migrations(*conn, "./migrations"); + } + PgPool pg(db_url, 2); + AttachmentRepo attachments(pg); + JobRepo jobs(pg, retry); + const char* broker_file = std::getenv("BROKER_URL_FILE"); + RedisPool redis(read_secret_file( + broker_file && *broker_file ? "BROKER_URL_FILE" : "CACHE_URL_FILE"), 2); + AttachmentQueue queue(redis); + S3Client s3(S3Client::from_env()); + char random[33]; + unsigned char entropy[16]; + randombytes_buf(entropy, sizeof(entropy)); + sodium_bin2hex(random, sizeof(random), entropy, sizeof(entropy)); + const std::string consumer = "worker-" + std::string(random); + std::clog << "worker started consumer=" << consumer << " max_attempts=" << retry.max_attempts << '\n'; + StagingCleaner cleaner(pg, s3, retention); + Watchdog watchdog(timeout); + auto next_sweep = std::chrono::steady_clock::now(); + while (!stop_requested) { + try { + if (std::chrono::steady_clock::now() >= next_sweep) { + next_sweep = std::chrono::steady_clock::now() + std::chrono::seconds(cleanup_interval); + Deadline deadline(watchdog); + cleaner.sweep(); + } + queue.ensure_group(); + const auto message = queue.read(consumer, reclaim_idle); + if (!message) continue; + nlohmann::json j; + bool valid = false; + try { + j = nlohmann::json::parse(message->payload); + valid = valid_job(j); + } catch (const nlohmann::json::exception&) {} + if (!valid) { + queue.reject(message->stream_id); + continue; + } + const std::string id = j.at("attachment_id").get(); + Deadline deadline(watchdog); + const auto result = jobs.run(j.at("job_id").get(), id, + j.at("pipeline_version").get(), j.at("attempt").get(), [&](const JobInput& input) { + const auto a = attachments.find_by_id(id); + if (!a) throw std::runtime_error("attachment missing"); + std::string original; + original.reserve(a->size_bytes); + s3.get_object(input.source_key, [&](const char* data, std::size_t n) { + if (original.size() > static_cast(a->size_bytes) || + n > static_cast(a->size_bytes) - original.size()) { + throw InvalidImage("source_mismatch"); + } + original.append(data, n); + }); + if (original.size() != static_cast(a->size_bytes) || + sha256(original) != a->sha256) throw InvalidImage("source_mismatch"); + const auto images = make_variants(std::vector(original.begin(), original.end()), input.pipeline_version); + const std::string prefix = pipeline_prefix(a->chat_id, a->id, input.pipeline_version); + const std::string key = prefix + "original"; + // Publish verified bytes even if a presigned staging key changes. + std::istringstream source(original); + s3.put_object(key, source, original.size(), a->content_type); + nlohmann::json variants = nlohmann::json::array(); + for (const auto& v : images) { + std::istringstream body(v.image.bytes); + const std::string variant_key = prefix + v.name + (v.content_type == "image/webp" ? ".webp" : ".jpg"); + s3.put_object(variant_key, body, + v.image.bytes.size(), v.content_type); + variants.push_back({{"name", v.name}, {"content_type", v.content_type}, + {"size_bytes", v.image.bytes.size()}, {"sha256", sha256(v.image.bytes)}, + {"width", v.image.width}, {"height", v.image.height}, {"storage_key", variant_key}}); + } + lab_worker_fault("worker_after_effect", j.at("job_id").get(), input.pipeline_version); + return JobResult{key, variants.dump()}; + }); + if (result == JobRepo::Result::Missing) { + queue.reject(message->stream_id); + } else if (result == JobRepo::Result::Done) { + const auto a = attachments.find_by_id(id); + if (a && a->status == "ready") verify_ready(s3, *a); + lab_worker_fault("worker_before_ack", j.at("job_id").get(), j.at("pipeline_version").get()); + queue.ack(message->stream_id); + if (a && a->status == "ready") cleaner.clean("staging/" + a->chat_id + "/" + a->id); + } else if (result == JobRepo::Result::Superseded) { + queue.ack(message->stream_id); + } else if (result == JobRepo::Result::Scheduled) { + // ACK only after the next attempt was committed to outbox. + queue.ack(message->stream_id); + } + // Busy remains pending; an active job is protected by its advisory lock. + } catch (const std::exception&) { + std::clog << "worker operation failed; delivery remains pending\n"; + std::this_thread::sleep_for(std::chrono::seconds(1)); + } + } + return 0; + } catch (const std::exception&) { + std::cerr << "worker initialization failed\n"; + return 1; + } +} diff --git a/student-tests/README.md b/student-tests/README.md new file mode 100644 index 00000000..df90e87a --- /dev/null +++ b/student-tests/README.md @@ -0,0 +1,102 @@ +# Проверки реализации lab5 + +Нужны Linux amd64, Docker Engine с Compose v2, Python 3.10+ и Pillow. Полный прогон +создаёт только синтетические данные. Для сборки нужен доступ к пакетным +репозиториям Ubuntu и закреплённым исходникам GitHub. + +```sh +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt -r student-tests/requirements.txt +make check validate PYTHON=.venv/bin/python +make test-async PYTHON=.venv/bin/python TEST_ARGS="--output evidence/async-suite.json" +``` + +Первый запуск собирает API/worker, MinIO и mc из этого репозитория. При повторе +можно добавить `--no-build`, если исходники и Dockerfiles не изменились. +Полный тест занимает несколько минут; отдельное ожидание ready ограничено 60 s. +Тесты запускайте последовательно: они кратковременно меняют состояние своих +API/брокеров и используют ресурсы Docker, хотя имена проектов изолированы. + +## Отдельные сценарии + +После активации venv или с `PYTHON=.venv/bin/python`: + +```sh +student-tests/test_upload_async.sh --no-build --output evidence/upload-async.json +student-tests/test_worker_down.sh --no-build --output evidence/worker-down.json +student-tests/test_outbox_crash.sh --no-build --output evidence/outbox-crash.json +student-tests/test_reliability.sh --no-build --output evidence/reliability.json +``` + +Эквивалентные Make targets: `test-upload-async`, `test-worker-down`, +`test-outbox-crash`, `test-reliability`; параметры передаются через `TEST_ARGS`. +Каждый сценарий заканчивается неизменённым публичным `tests/smoke.py`. + +- `test_upload_async.sh`: worker остановлен → POST 202 со снимком queued → + GET queued и content 409 → worker запущен → ready. Проверяются исходные bytes, + SHA-256, реальные JPEG/WebP, размеры и метаданные всех трёх вариантов, доступ + другого участника и отказ постороннему. Остановка делает GET queued + детерминированным: при работающем worker контракт разрешает первый GET ready. +- `test_worker_down.sh`: дополнительно создаёт сообщение с queued-вложением, + перезапускает PostgreSQL, Valkey, MinIO и API с сохранением volumes, + проверяет прежнюю сессию/вложение и запускает worker. В JSON evidence есть + реальные container IDs, StartedAt и имена volumes до/после рестарта. +- `test_outbox_crash.sh`: API принимает upload с выключенным брокером; + API падает с exit 86 после COMMIT до XADD; затем отдельно падает после XADD + до published=true. После рестарта та же job завершается без нового POST; + повтор события не создаёт второго эффекта. Используются PostgreSQL-сессии, + поэтому остановка Valkey не отключает синхронную аутентификацию. +- `test_reliability.sh`: атомарный rollback outbox; шесть попыток с backoff/jitter + и проверкой due time; replay с checksum и audit; устаревшее событие; + SIGKILL после S3 до COMMIT/ACK; watchdog; конкурентные дубли у двух worker; + два API-публикатора; retention, presigned complete и гонка GC/upload; + RGB PNG на 40 млн пикселей при 512 MiB без swap. Для GC/upload проверяется, + что DB INSERT всё ещё находится в паузе до и после S3-пробы; наблюдение после + COMMIT не принимается как доказательство гонки. + +## Изоляция и результаты + +Общий runner `async_suite.py` создаёт случайный `lab5test…` Compose-проект, +частный каталог `build/student-tests/`, свои env/credentials/volumes и +случайный loopback-порт API. Основной LB не запускается. Рабочие `.env`, secrets, +volumes и сервисы других проектов не используются. Экспортированные S3/Compose +переменные не могут перенаправить тестовый стенд во внешнее хранилище. + +В `finally` удаляются только собственные контейнеры/volumes и файлы credentials. +Каталог с диагностикой остаётся в игнорируемом build. `build/` исключён и из +Docker build context. При ошибке cleanup runner сообщает точное имя своего +проекта; не применяйте глобальный prune. Обрыв питания/SIGKILL самого runner +может потребовать удаления его проекта оператором. + +`--output` сохраняет только итог, проверки, ID синтетических объектов, +идентификаторы контейнеров/образов, лимиты, время и SHA-256 исходников. Пароли, +Bearer-токены, подписанные URL и HTTP bodies в evidence не записываются. +Проверки header/JSON используют неизменённые публичные helpers; Pillow независимо +декодирует изображения. Измерение RSS/нагрузки не выполняется: memory case +подтверждает завершение одного RGB fixture при заданном cgroup limit. + +## Геометрия изображений отдельно + +Если binaries собраны локально с зависимостями из Dockerfile: + +```sh +.venv/bin/python student-tests/test_thumbnail.py --binary build/thumbnail_smoke +.venv/bin/python student-tests/test_variants.py --binary build/variants_smoke +``` + +Второй тест также проверяет центральный crop, WebP без увеличения, округление, +EXIF orientation 1–8 для JPEG/PNG, большой PNG eXIf, alpha и удаление metadata. + + +## Уровень 5, трек 2 + +```sh +make test-track2 PYTHON=.venv/bin/python TEST_ARGS="--output evidence/track2.json" +# Если образы уже собраны из текущих исходников: +PYTHON=.venv/bin/python student-tests/test_pipeline_idempotency.sh --no-build +``` + +Default — 3 независимых повтора; `--repetitions 1` запускает отладочный прогон. +Методика, гипотеза, fault-точки и инварианты: [infra/track2.md](../infra/track2.md). +Используется тот же isolated runner и независимая проверка images; сохраняется +отдельный evidence с source/method hashes и SHA объектов каждой версии. diff --git a/student-tests/async_suite.py b/student-tests/async_suite.py new file mode 100644 index 00000000..c095bb2d --- /dev/null +++ b/student-tests/async_suite.py @@ -0,0 +1,599 @@ +#!/usr/bin/env python3 +"""Disposable Compose integration tests. Never operates on an existing project.""" +import argparse +import concurrent.futures +import contextlib +import datetime as dt +import hashlib +import http.client +import io +import json +import os +import re +from pathlib import Path +import secrets +import shlex +import subprocess +import sys +import time +import uuid + +from PIL import Image, __version__ as pillow_version + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / 'tests')) +from client import Client, Failure, check + + +def wait_for(predicate, label, timeout=60): + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + value = predicate() + if value: + return value + time.sleep(0.2) + raise Failure('timeout: ' + label) + + +class Stack: + def __init__(self): + self.project = 'lab5test' + uuid.uuid4().hex[:12] + self.directory = ROOT / 'build' / 'student-tests' / self.project + self.directory.mkdir(parents=True, mode=0o700) + self.events = [] + self.client = None + self.probe_name = None + self.store_ids = {} + self.base_files = ['-f', str(ROOT / 'compose.yaml'), '-f', str(self.directory / 'compose.json')] + values = { + 'POSTGRES_USER': 'messenger', 'POSTGRES_DB': 'messenger', + 'POSTGRES_PASSWORD': secrets.token_hex(24), + 'MINIO_ROOT_USER': 'lab5-test-root', 'MINIO_ROOT_PASSWORD': secrets.token_hex(24), + 'MINIO_USER_ACCESS_KEY': 'lab5-test-access', 'MINIO_USER_SECRET_KEY': secrets.token_hex(24), + 'S3_BUCKET': 'lab5-tests', 'SESSION_STORE': 'postgres', 'API_REPLICAS': '1', + 'DB_POOL_SIZE': '2', 'HTTP_WORKERS': '2', 'DRAIN_SECONDS': '0', + 'API_CPU_LIMIT': '1.0', 'API_MEM_LIMIT': '512m', 'MINIO_CPU_LIMIT': '1.0', + } + self.command_env = os.environ.copy() + # An exported S3_ENDPOINT must never redirect a disposable test to another store. + for name in re.findall(r'\$\{([A-Za-z_]\w*)', (ROOT / 'compose.yaml').read_text()): + self.command_env.pop(name, None) + self.env_file = self.directory / 'test.env' + self.env_file.write_text(''.join(k + '=' + v + '\n' for k, v in values.items())) + self.env_file.chmod(0o600) + credentials = { + 'database_url': 'postgresql://messenger:' + values['POSTGRES_PASSWORD'] + '@db:5432/messenger', + 'cache_url': 'redis://cache:6379/0', 's3_access_key_id': values['MINIO_USER_ACCESS_KEY'], + 's3_secret_access_key': values['MINIO_USER_SECRET_KEY'], + } + self.secret_files = [] + for name, value in credentials.items(): + path = self.directory / name + path.write_text(value + '\n') + path.chmod(0o644) # Bind-mounted files must be readable by container uid 10001. + self.secret_files.append(path) + override = { + 'services': { + 'api': {'ports': ['127.0.0.1::8080'], 'deploy': {'replicas': 1}, + 'healthcheck': {'interval': '1s', 'start_period': '1s', 'retries': 60}}, + 'worker': {'environment': { + 'JOB_RECLAIM_IDLE_MS': '1000', 'JOB_RETRY_BASE_MS': '200', + 'JOB_RETRY_MAX_MS': '800', 'JOB_TIMEOUT_SECONDS': '3', + 'STAGING_RETENTION_SECONDS': '30', 'STAGING_CLEANUP_INTERVAL_SECONDS': '1', + }}, + }, + 'secrets': {name: {'file': str(self.directory / name)} for name in credentials}, + } + (self.directory / 'compose.json').write_text(json.dumps(override)) + self.prefix = ['docker', 'compose', '--project-directory', str(ROOT), '-p', self.project, + '--env-file', str(self.env_file)] + + def command(self, args, label, data=None, allow_failure=False, timeout=180): + result = subprocess.run(args, input=data, stdout=subprocess.PIPE, stderr=subprocess.PIPE, + cwd=ROOT, timeout=timeout, env=self.command_env) + if result.returncode and not allow_failure: + with (self.directory / 'control.log').open('ab') as log: + log.write(result.stdout + result.stderr) + raise Failure(label + ' failed; diagnostic: ' + str(self.directory / 'control.log')) + return result + + def dc(self, *args, fault=None, data=None, allow_failure=False, timeout=180): + files = self.base_files.copy() + if fault: + path = self.directory / ('fault-' + fault + '.json') + path.write_text(json.dumps({'services': {'api': {'environment': { + 'LAB_ENABLE_FAULT_INJECTION': '1', 'LAB_FAULT_POINT': fault}}}})) + files += ['-f', str(path)] + result = self.command(self.prefix + files + list(args), 'Compose ' + args[0], + data=data, allow_failure=allow_failure, timeout=timeout) + return result.stdout.decode().strip() + + def record(self, name, **fields): + self.events.append({'check': name, **fields}) + print('PASS:', name, flush=True) + + def start(self, build): + self.dc('config', '--quiet') + if build: + self.dc('build', 'api', 'minio', 'minio-init', timeout=1800) + self.dc('up', '-d', '--wait', '--wait-timeout', '120', 'api', 'worker', timeout=180) + self.refresh() + self.store_ids = {name: self.dc('ps', '-q', name) for name in ('db', 'cache')} + self.record('isolated stack started', project=self.project, + containers={name: self.inspect(name) for name in ('api', 'worker', 'db', 'cache', 'minio')}) + + def refresh(self): + address = self.dc('port', '--index', '1', 'api', '8080') + if self.client is None: + self.client = Client('http://' + address, timeout=10) + else: + self.client.base = 'http://' + address + def healthy(): + try: + self.client.call('GET', '/health/ready', schema='Health') + return True + except (Failure, http.client.HTTPException): + return False + wait_for(healthy, 'API readiness') + + def sql(self, query): + # These containers are restarted, never recreated, during a run. + args = ['docker', 'exec', '-i', self.store_ids['db'], 'psql', '-X', '-v', + 'ON_ERROR_STOP=1', '-U', 'messenger', '-d', 'messenger', '-Atqc', query] + return self.command(args, 'test SQL').stdout.decode().strip() + + def redis(self, *args): + command = ['docker', 'exec', '-i', self.store_ids['cache'], 'valkey-cli', '--json', *args] + return json.loads(self.command(command, 'test Redis').stdout) + + def inspect(self, service): + ids = self.dc('ps', '-a', '-q', service).splitlines() + if not ids: + return [] + raw = self.command(['docker', 'inspect', *ids], 'inspect containers').stdout + return [{'id': x['Id'], 'image': x['Image'], 'started_at': x['State']['StartedAt'], + 'exit_code': x['State']['ExitCode'], 'restart_count': x['RestartCount'], + 'memory_limit_bytes': x['HostConfig']['Memory'], + 'volumes': sorted(m['Name'] for m in x['Mounts'] if m['Type'] == 'volume')} + for x in json.loads(raw)] + + def wait_store(self, service): + def healthy(): + cid = self.dc('ps', '-q', service) + result = self.command(['docker', 'inspect', '--format', + '{{.State.Health.Status}}', cid], 'store health') + return result.stdout.decode().strip() == 'healthy' + wait_for(healthy, service + ' health', timeout=90) + + def recreate_api(self, fault=None): + self.dc('up', '-d', '--no-deps', '--force-recreate', 'api', fault=fault) + self.refresh() + + def mc(self, command, data=None, allow_failure=False): + if self.probe_name is None: + self.probe_name = self.project + '-mc-probe' + script = ('mc alias set local "$S3_ENDPOINT" "$MINIO_ROOT_USER" ' + '"$MINIO_ROOT_PASSWORD" >/dev/null; touch /tmp/probe-ready; exec sleep infinity') + self.dc('run', '--rm', '-d', '--no-deps', '--name', self.probe_name, + '--entrypoint', '/bin/sh', 'minio-user-init', '-ec', script) + wait_for(lambda: self.command(['docker', 'exec', self.probe_name, 'test', '-f', + '/tmp/probe-ready'], 'MinIO probe readiness', + allow_failure=True).returncode == 0, + 'MinIO probe readiness', timeout=30) + return self.command(['docker', 'exec', '-i', self.probe_name, '/bin/sh', '-ec', command], + 'MinIO test action', data=data, allow_failure=allow_failure) + + def exists(self, key): + result = self.mc('mc stat "local/$S3_BUCKET/"' + shlex.quote(key), allow_failure=True) + return result.returncode == 0 + + def replay(self, job_id, success): + args = self.prefix + self.base_files + ['exec', '-T', 'api', '/docker-entrypoint.sh', + '/app/job_admin', 'replay', job_id, '--actor', 'integration-test', + '--reason', 'temporary failure fixed'] + result = self.command(args, 'operator replay', allow_failure=True) + check((result.returncode == 0) == success, 'unexpected replay outcome') + + def close(self): + try: + if self.probe_name: + self.command(['docker', 'rm', '-f', self.probe_name], 'remove own MinIO probe', + allow_failure=True) + self.dc('down', '--volumes', '--remove-orphans', timeout=120) + finally: + for path in [self.env_file, *self.secret_files]: + path.unlink(missing_ok=True) + + +class Suite: + def __init__(self, stack): + self.stack = stack + self.c = stack.client + self.alice, self.bob, self.eve, self.chat = self.c.bootstrap() + self.content = (ROOT / 'tests/fixtures/sample.png').read_bytes() + + def upload(self, expected=202): + result = self.c.call('POST', '/api/v1/chats/' + self.chat['id'] + '/attachments?filename=sample.png', + expected, actor=self.alice, raw=self.content, + headers={'Content-Type': 'image/png'}, schema='Attachment' if expected == 202 else None) + if expected != 202: + return result + att = result['json'] + check(att['status'] == 'queued' and att['variants'] == [] and att['error_code'] is None, + '202 snapshot must be queued without variants') + check(att['sha256'] == hashlib.sha256(self.content).hexdigest() and + att['size_bytes'] == len(self.content), 'upload original metadata mismatch') + return att + + def metadata(self, att): + return self.c.call('GET', '/api/v1/attachments/' + att['id'], actor=self.alice, + schema='Attachment')['json'] + + def job(self, att): + return self.stack.sql("SELECT id FROM jobs WHERE attachment_id='" + att['id'] + "'") + + def key(self, att): + return 'staging/' + self.chat['id'] + '/' + att['id'] + + def ready(self, att): + ready = self.c.wait_ready(self.alice, att, wait_seconds=60) + check(ready['error_code'] is None, 'ready has error_code') + variants = {v['name']: v for v in ready['variants']} + check(len(ready['variants']) == 3 and set(variants) == {'thumbnail', 'crop', 'optimized'}, + 'ready must publish exactly three variants') + path = '/api/v1/attachments/' + att['id'] + '/content' + original = self.c.call('GET', path, actor=self.bob) + check(original['bytes'] == self.content and original['headers'].get_content_type() == 'image/png', + 'original differs') + for name, size, mime, fmt in [('thumbnail', (256, 160), 'image/jpeg', 'JPEG'), + ('crop', (128, 128), 'image/jpeg', 'JPEG'), + ('optimized', (320, 200), 'image/webp', 'WEBP')]: + result = self.c.call('GET', path + '?variant=' + name, actor=self.bob) + v = variants[name] + with Image.open(io.BytesIO(result['bytes'])) as image: + image.load() + check(image.format == fmt and image.size == size and not image.getexif(), + 'actual variant image mismatch: ' + name) + check(result['headers'].get_content_type() == mime and + len(result['bytes']) == v['size_bytes'] and + hashlib.sha256(result['bytes']).hexdigest() == v['sha256'] and + (v['width'], v['height']) == size, 'variant metadata mismatch: ' + name) + for suffix in ('', '/content?variant=optimized'): + self.c.call('GET', '/api/v1/attachments/' + att['id'] + suffix, 404, actor=self.eve) + return ready + + def events(self, att): + events = [] + for _, fields in self.stack.redis('XRANGE', 'jobs:attachments', '-', '+'): + values = dict(zip(fields[::2], fields[1::2])) + with contextlib.suppress(ValueError, KeyError, AttributeError): + payload = json.loads(values['payload']) + if payload.get('attachment_id') == att['id']: + events.append(payload) + return events + + def pending_empty(self): + return self.stack.redis('XPENDING', 'jobs:attachments', 'attachment-workers')[0] == 0 + + def upload_async(self): + s = self.stack + s.dc('stop', 'worker') + att = self.upload() + check(self.metadata(att)['status'] == 'queued', 'GET must be queued with stopped worker') + self.c.call('GET', '/api/v1/attachments/' + att['id'] + '/content', 409, actor=self.alice) + s.dc('start', 'worker') + self.ready(att) + s.record('upload 202 -> GET queued -> ready, original and 3 variants verified', attachment_id=att['id']) + + def worker_down(self): + s = self.stack + s.dc('stop', 'worker') + att = self.upload() + check(self.metadata(att)['status'] == 'queued', 'worker-down upload was processed') + self.c.message(self.alice, self.chat, '', attachments=[att['id']]) + before = {name: s.inspect(name) for name in ('api', 'db', 'cache', 'minio')} + s.dc('restart', 'db', 'cache', 'minio') + for name in ('db', 'cache', 'minio'): + s.wait_store(name) + s.dc('restart', 'api') + s.refresh() + check(self.metadata(att)['status'] == 'queued', 'accepted job lost after store/API restart') + after = {name: s.inspect(name) for name in before} + for name in before: + check(before[name][0]['started_at'] != after[name][0]['started_at'], name + ' did not restart') + check(before[name][0]['volumes'] == after[name][0]['volumes'], name + ' changed volumes') + s.dc('start', 'worker') + self.ready(att) + s.record('worker down: accepted job/session survive API, PostgreSQL, Valkey and S3 restart', + attachment_id=att['id'], before=before, after=after) + + def outbox_crash(self): + s = self.stack + s.dc('stop', 'worker', 'cache') + att = self.upload() + check(self.metadata(att)['status'] == 'queued', 'broker-down upload not queued') + s.dc('restart', 'api'); s.refresh() + check(self.metadata(att)['status'] == 'queued', 'outbox lost on offline restart') + s.dc('start', 'cache', 'worker'); self.ready(att) + s.record('broker down: upload 202 and offline API restart preserve outbox') + s.dc('stop', 'worker', 'cache') + s.recreate_api('upload_after_commit') + before = int(s.sql('SELECT count(*) FROM attachments')) + try: + self.upload() + except (Failure, http.client.HTTPException): + pass + else: + raise Failure('upload fault did not terminate API') + wait_for(lambda: s.inspect('api')[0]['exit_code'] == 86, 'upload crash exit 86') + check(int(s.sql('SELECT count(*) FROM attachments')) == before + 1, 'crash transaction absent') + att = {'id': s.sql('SELECT id FROM attachments ORDER BY created_at DESC LIMIT 1')} + check(s.sql("SELECT count(*) FROM outbox WHERE NOT published AND payload->>'attachment_id'='" + + att['id'] + "'") == '1', 'committed outbox intent absent') + s.recreate_api() + check(self.metadata(att)['status'] == 'queued', 'crash attachment missing') + s.dc('start', 'cache', 'worker'); self.ready(att) + s.record('crash after COMMIT before XADD: same attachment/job recovers without new POST', + attachment_id=att['id'], exit_code=86) + s.dc('stop', 'worker', 'cache') + att = self.upload() + s.recreate_api('outbox_after_publish'); s.dc('start', 'cache') + wait_for(lambda: s.inspect('api')[0]['exit_code'] == 86, 'publisher crash exit 86') + check(len(self.events(att)) == 1, 'XADD did not precede injected crash') + check(s.sql("SELECT count(*) FROM outbox WHERE NOT published AND payload->>'attachment_id'='" + + att['id'] + "'") == '1', 'publisher committed marker before crash') + s.recreate_api() + wait_for(lambda: len(self.events(att)) == 2, 'outbox redelivery') + s.dc('start', 'worker'); self.ready(att) + check(s.sql("SELECT retries FROM jobs WHERE id='" + self.job(att) + "'") == '0', + 'publisher duplicate caused an extra processing attempt') + s.record('crash after XADD before published marker: duplicate delivery, one ready effect', + attachment_id=att['id'], stream_deliveries=2, exit_code=86) + + def retry_replay(self): + s = self.stack + counts = s.sql('SELECT (SELECT count(*) FROM attachments), (SELECT count(*) FROM jobs), (SELECT count(*) FROM outbox)') + s.sql("CREATE FUNCTION test_reject_outbox() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN RAISE EXCEPTION 'test failure'; END $$; CREATE TRIGGER test_reject_outbox BEFORE INSERT ON outbox FOR EACH ROW EXECUTE FUNCTION test_reject_outbox()") + self.upload(expected=500) + check(s.sql('SELECT (SELECT count(*) FROM attachments), (SELECT count(*) FROM jobs), (SELECT count(*) FROM outbox)') == counts, + 'outbox failure did not roll back all metadata') + s.sql('DROP TRIGGER test_reject_outbox ON outbox; DROP FUNCTION test_reject_outbox()') + s.record('attachment/job/outbox transaction rolls back on outbox INSERT failure') + s.sql("CREATE TABLE test_attempts(job_id uuid, attempt int, observed_at timestamptz, due_at timestamptz); CREATE FUNCTION test_audit_attempt() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.status='processing' AND OLD.status<>'processing' THEN INSERT INTO test_attempts VALUES(NEW.id,NEW.retries+1,now(),NEW.next_attempt_at); END IF; RETURN NEW; END $$; CREATE TRIGGER test_audit_attempt AFTER UPDATE ON jobs FOR EACH ROW EXECUTE FUNCTION test_audit_attempt()") + s.sql("CREATE FUNCTION test_reject_ready() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.status='ready' THEN RAISE EXCEPTION 'test failure'; END IF; RETURN NEW; END $$; CREATE TRIGGER test_reject_ready BEFORE UPDATE ON attachments FOR EACH ROW EXECUTE FUNCTION test_reject_ready()") + att = self.upload() + wait_for(lambda: self.metadata(att)['status'] == 'failed', 'retry exhaustion') + s.dc('stop', 'worker') + s.sql('DROP TRIGGER test_reject_ready ON attachments; DROP FUNCTION test_reject_ready()') + job = self.job(att) + check(s.sql("SELECT retries FROM jobs WHERE id='" + job + "'") == '6', 'retry limit not enforced') + check(self.metadata(att)['error_code'] == 'processing_failed', 'failed error_code absent') + check([p['attempt'] for p in self.events(att)] == list(range(1, 7)), 'managed attempts differ') + check(s.sql("SELECT count(*) FROM test_attempts WHERE job_id='" + job + "' AND observed_at>'attempt', EXTRACT(EPOCH FROM (available_at-created_at))*1000 " + "FROM outbox WHERE payload->>'job_id'='" + job + "' ORDER BY id") + for row in rows.splitlines()[1:]: + attempt, delay = row.split('|'); attempt, delay = int(attempt), float(delay) + ceiling = min(800, 200 * 2 ** (attempt - 2)) + check(ceiling / 2 <= delay <= ceiling, 'backoff/jitter outside configured range') + delays.append({'attempt': attempt, 'delay_ms': delay}) + self.c.call('GET', '/api/v1/attachments/' + att['id'] + '/content', 409, actor=self.alice) + s.record('backoff+jitter persisted, attempts 1..6, no early processing, finite failed', delays=delays) + # Corrupt bytes of the same size: replay must check SHA, not only HEAD/length. + key = shlex.quote(self.key(att)) + s.mc('mc pipe "local/$S3_BUCKET/"' + key, data=bytes(len(self.content))) + s.replay(job, False) + check(s.sql("SELECT count(*) FROM job_replays WHERE job_id='" + job + "'") == '0', + 'rejected replay changed audit') + s.mc('mc pipe "local/$S3_BUCKET/"' + key, data=self.content) + s.replay(job, True) + s.replay(job, False) + s.redis('XADD', 'jobs:attachments', '*', 'payload', json.dumps(self.events(att)[0])) + s.dc('start', 'worker'); self.ready(att) + s.replay(job, False) + check(s.sql("SELECT retry_base,retries FROM jobs WHERE id='" + job + "'") == '6|6', + 'replay reset monotonic retry count') + check(max(p['attempt'] for p in self.events(att)) == 7, 'replay did not enqueue next managed attempt') + check(s.sql("SELECT actor,retries_before FROM job_replays WHERE job_id='" + job + "'") == 'integration-test|6', + 'replay audit mismatch') + s.record('audited replay verifies SHA, keeps job_id, fences stale events, refuses queued/ready', job_id=job) + + def worker_crashes(self): + s = self.stack + s.sql("CREATE FUNCTION test_pause_ready() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.status='ready' THEN PERFORM pg_sleep(10); END IF; RETURN NEW; END $$; CREATE TRIGGER test_pause_ready BEFORE UPDATE ON attachments FOR EACH ROW EXECUTE FUNCTION test_pause_ready()") + att = self.upload() + wait_for(lambda: s.sql("SELECT count(*) FROM pg_stat_activity WHERE wait_event='PgSleep' AND query LIKE 'UPDATE attachments a SET status=%'") == '1', + 'worker after S3 before result COMMIT') + s.dc('kill', '-s', 'SIGKILL', 'worker') + s.sql('DROP TRIGGER test_pause_ready ON attachments; DROP FUNCTION test_pause_ready()') + check(s.exists('attachments/' + self.chat['id'] + '/' + att['id'] + '/v1/optimized.webp'), + 'worker had not saved the final variant before crash') + s.dc('start', 'worker'); self.ready(att) + check(int(s.sql("SELECT retries FROM jobs WHERE id='" + self.job(att) + "'")) >= 1, + 'crashed processing not counted') + s.record('SIGKILL after S3 before COMMIT/ACK: pending recovers the same effect', attachment_id=att['id']) + before = s.inspect('worker')[0]['restart_count'] + s.sql("CREATE FUNCTION test_pause_ready() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.status='ready' THEN PERFORM pg_sleep(10); END IF; RETURN NEW; END $$; CREATE TRIGGER test_pause_ready BEFORE UPDATE ON attachments FOR EACH ROW EXECUTE FUNCTION test_pause_ready()") + att = self.upload() + wait_for(lambda: s.inspect('worker')[0]['restart_count'] > before, 'watchdog restart') + s.sql('DROP TRIGGER test_pause_ready ON attachments; DROP FUNCTION test_pause_ready()') + self.ready(att) + check('timed out' in s.dc('logs', '--no-color', 'worker'), 'watchdog timeout not observed') + s.record('watchdog bounds hung processing and Compose restarts worker', + restart_count_before=before, restart_count_after=s.inspect('worker')[0]['restart_count']) + + def duplicates_publishers(self): + s = self.stack + s.dc('up', '-d', '--no-deps', '--scale', 'worker=2', 'worker') + s.sql("CREATE FUNCTION test_pause_ready() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.status='ready' THEN PERFORM pg_sleep(1); END IF; RETURN NEW; END $$; CREATE TRIGGER test_pause_ready BEFORE UPDATE ON attachments FOR EACH ROW EXECUTE FUNCTION test_pause_ready()") + att = self.upload() + wait_for(lambda: self.events(att), 'initial stream event') + for _ in range(4): + s.redis('XADD', 'jobs:attachments', '*', 'payload', json.dumps(self.events(att)[0])) + ready = self.ready(att) + s.sql('DROP TRIGGER test_pause_ready ON attachments; DROP FUNCTION test_pause_ready()') + wait_for(self.pending_empty, 'duplicate ACKs') + check(self.metadata(att) == ready, 'duplicate changed ready metadata') + check(s.sql("SELECT retries FROM jobs WHERE id='" + self.job(att) + "'") == '0', 'duplicate became a retry') + s.record('two workers serialize duplicate processing; variants and ready metadata stay unique', + workers=s.inspect('worker'), stream_deliveries=len(self.events(att))) + s.dc('up', '-d', '--no-deps', '--scale', 'worker=1', 'worker') + s.dc('stop', 'worker', 'cache') + items = [self.upload() for _ in range(8)] + s.dc('up', '-d', '--no-deps', '--scale', 'api=2', 'api'); s.refresh() + s.dc('start', 'cache') + wait_for(lambda: s.sql('SELECT count(*) FROM outbox WHERE NOT published') == '0', 'concurrent publishers') + check(all(len(self.events(att)) == 1 for att in items), 'healthy publishers duplicated outbox rows') + s.dc('start', 'worker') + for att in items: + self.ready(att) + s.record('two API publishers drain outbox with SKIP LOCKED', apis=s.inspect('api'), jobs=len(items)) + s.dc('up', '-d', '--no-deps', '--scale', 'api=1', 'api'); s.refresh() + + def cleanup_races(self): + s = self.stack + # Short retention only inside this disposable project. + path = s.directory / 'cleanup.json' + path.write_text(json.dumps({'services': {'worker': {'environment': {'STAGING_RETENTION_SECONDS': '1'}}}})) + s.command(s.prefix + s.base_files + ['-f', str(path), 'up', '-d', '--no-deps', '--force-recreate', 'worker'], + 'enable test retention') + s.dc('stop', 'cache') + att = self.upload() + direct = self.c.call('POST', '/api/v1/chats/' + self.chat['id'] + '/direct-uploads', 201, + actor=self.alice, body={'filename': 'sample.png', 'content_type': 'image/png', + 'size_bytes': len(self.content), 'sha256': hashlib.sha256(self.content).hexdigest()}) + direct = json.loads(direct['bytes']) + s.command(s.prefix + s.base_files + ['exec', '-T', 'api', 'curl', '-fsS', '-X', 'PUT', + '-H', 'Content-Type: image/png', '--data-binary', '@-', direct['upload_url']], + 'presigned upload', data=self.content) + direct_key = 'staging/' + self.chat['id'] + '/' + direct['id'] + orphan = 'staging/' + self.chat['id'] + '/' + str(uuid.uuid4()) + s.mc('mc pipe "local/$S3_BUCKET/"' + shlex.quote(orphan), data=self.content) + wait_for(lambda: not s.exists(orphan), 'orphan retention', timeout=30) + check(s.exists(self.key(att)) and s.exists(direct_key), 'GC deleted an active upload') + s.dc('start', 'cache'); ready = self.ready(att) + wait_for(lambda: s.sql("SELECT staging_cleaned_at IS NOT NULL FROM attachments WHERE id='" + att['id'] + "'") == 't', + 'ready staging cleanup') + check(not s.exists(self.key(att)) and self.metadata(att) == ready, 'ready cleanup changed content/metadata') + complete_path = '/api/v1/direct-uploads/' + direct['id'] + '/complete' + direct_att = self.c.call('POST', complete_path, 202, actor=self.alice, schema='Attachment')['json'] + self.ready(direct_att) + check(s.exists(direct_key), 'GC deleted a key while its presigned URL is valid') + self.c.call('POST', complete_path, 200, actor=self.alice, schema='Attachment') + check(s.sql("SELECT count(*) FROM outbox WHERE payload->>'attachment_id'='" + direct['id'] + "'") == '1', + 'presigned completion replay duplicated outbox') + s.record('retention deletes orphan/ready staging, protects queued and live presigned source') + # Hold an API upload in INSERT after its PUT. GC must respect its advisory lock. + listing = 'mc ls --json "local/$S3_BUCKET/staging/"' + shlex.quote(self.chat['id'] + '/') + old_keys = {json.loads(line)['key'] for line in s.mc(listing).stdout.splitlines()} + s.sql("CREATE FUNCTION test_pause_upload() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN PERFORM pg_sleep(4); RETURN NEW; END $$; CREATE TRIGGER test_pause_upload BEFORE INSERT ON attachments FOR EACH ROW EXECUTE FUNCTION test_pause_upload()") + with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor: + future = executor.submit(self.upload) + wait_for(lambda: s.sql("SELECT count(*) FROM pg_stat_activity WHERE wait_event='PgSleep' AND query LIKE 'INSERT INTO attachments%'") == '1', + 'API paused after PUT') + current = {json.loads(line)['key'] for line in s.mc(listing).stdout.splitlines()} + new_key = next(iter(current - old_keys)) + time.sleep(2.2) + phase_query = "SELECT count(*) FROM pg_stat_activity WHERE wait_event='PgSleep' AND query LIKE 'INSERT INTO attachments%'" + check(s.sql(phase_query) == '1', 'GC race probe missed the pre-COMMIT window') + present = s.exists('staging/' + self.chat['id'] + '/' + new_key) + check(s.sql(phase_query) == '1', 'GC race probe crossed the COMMIT boundary') + check(present, 'GC deleted uncommitted upload') + raced = future.result() + s.sql('DROP TRIGGER test_pause_upload ON attachments; DROP FUNCTION test_pause_upload()') + self.ready(raced) + s.record('GC/upload race: PUT-before-COMMIT source is protected') + s.dc('stop', 'cache'); expired = self.upload() + s.sql("UPDATE jobs SET status='failed', retries=1, error_code='processing_failed' WHERE attachment_id='" + expired['id'] + "'; " + "UPDATE attachments SET status='failed', error_code='processing_failed', updated_at=now()-interval '1 day' WHERE id='" + expired['id'] + "'") + wait_for(lambda: s.sql("SELECT staging_cleaned_at IS NOT NULL FROM attachments WHERE id='" + expired['id'] + "'") == 't', + 'failed retention') + check(not s.exists(self.key(expired)), 'expired failed source retained') + s.replay(self.job(expired), False) + s.dc('start', 'cache') + s.record('expired failed staging is collected; replay refuses cleaned source') + + def memory(self): + s = self.stack + image = s.directory / '40m.png' + with Image.new('RGB', (8000, 5000), (30, 140, 200)) as fixture: + fixture.save(image) + image_id = s.inspect('api')[0]['image'] + args = ['docker', 'run', '--rm', '--network', 'none', '--memory', '512m', '--memory-swap', '512m', + '--user', str(os.getuid()) + ':' + str(os.getgid()), + '-v', str(s.directory) + ':/work', '--entrypoint', '/app/variants_smoke', image_id, + '/work/40m.png', '/work/40m-output'] + s.command(args, '40M pixel memory boundary', timeout=120) + for name, size in [('thumbnail.jpg', (256, 160)), ('crop.jpg', (128, 128)), ('optimized.webp', (1280, 800))]: + with Image.open(s.directory / '40m-output' / name) as result: + result.load() + check(result.size == size, 'large fixture output mismatch') + s.record('40M pixel RGB PNG produces three variants with 512 MiB and no swap', pixels=40000000, + memory_limit_bytes=512 * 1024 * 1024, swap_bytes=0) + + def reliability(self): + self.retry_replay() + self.worker_crashes() + self.duplicates_publishers() + self.cleanup_races() + self.memory() + + def public_smoke(self): + self.stack.command([sys.executable, str(ROOT / 'tests/smoke.py'), '--base-url', self.c.base], + 'public smoke', timeout=180) + self.stack.record('unchanged lab5 public smoke passed') + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('scenario', choices=['upload', 'worker_down', 'outbox', 'reliability', 'all']) + parser.add_argument('--no-build', action='store_true', help='reuse images built from this repository') + parser.add_argument('--output', type=Path, help='sanitized JSON evidence (no credentials/tokens)') + args = parser.parse_args() + stack = Stack() + started = time.monotonic() + digest = hashlib.sha256() + source_files = [ROOT / name for name in ('CMakeLists.txt', 'Dockerfile', 'compose.yaml', '.dockerignore')] + for folder in ('src', 'migrations', 'third_party'): + source_files += [p for p in (ROOT / folder).rglob('*') if p.is_file()] + for path in sorted(source_files): + digest.update(str(path.relative_to(ROOT)).encode() + b'\0' + path.read_bytes()) + result = {'scenario': args.scenario, 'project': stack.project, + 'source_sha256': digest.hexdigest(), 'python': sys.version.split()[0], 'pillow': pillow_version, + 'started_at': dt.datetime.now(dt.timezone.utc).isoformat(), 'passed': False} + failed = False + try: + stack.start(build=not args.no_build) + suite = Suite(stack) + scenarios = ['upload_async', 'worker_down', 'outbox_crash', 'reliability'] if args.scenario == 'all' else [ + {'upload': 'upload_async', 'worker_down': 'worker_down', 'outbox': 'outbox_crash', 'reliability': 'reliability'}[args.scenario]] + for scenario in scenarios: + getattr(suite, scenario)() + suite.public_smoke() + result['passed'] = True + except (Failure, OSError, ValueError, http.client.HTTPException, subprocess.TimeoutExpired) as error: + failed = True + # Do not print command argv, HTTP bodies or environment on failure. + result['error'] = str(error) if isinstance(error, Failure) else type(error).__name__ + print('FAIL:', result['error'], file=sys.stderr) + finally: + try: + stack.close() + result['cleanup'] = 'removed own project and volumes; disposable secrets deleted' + except (Failure, OSError, subprocess.TimeoutExpired): + failed = True + result['passed'] = False + result['cleanup'] = 'FAILED; remove only project ' + stack.project + print('FAIL: cleanup of own project ' + stack.project, file=sys.stderr) + result['events'] = stack.events + result['elapsed_seconds'] = round(time.monotonic() - started, 3) + if args.output: + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text(json.dumps(result, ensure_ascii=False, indent=2) + '\n') + return 1 if failed else 0 + + +if __name__ == '__main__': + raise SystemExit(main()) diff --git a/student-tests/requirements.txt b/student-tests/requirements.txt new file mode 100644 index 00000000..96fb13d9 --- /dev/null +++ b/student-tests/requirements.txt @@ -0,0 +1 @@ +Pillow==12.1.1 diff --git a/student-tests/test_outbox_crash.sh b/student-tests/test_outbox_crash.sh new file mode 100755 index 00000000..0cf905bd --- /dev/null +++ b/student-tests/test_outbox_crash.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) +exec "${PYTHON:-python3}" "$script_dir/async_suite.py" outbox "$@" diff --git a/student-tests/test_pipeline_idempotency.sh b/student-tests/test_pipeline_idempotency.sh new file mode 100755 index 00000000..8031e124 --- /dev/null +++ b/student-tests/test_pipeline_idempotency.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) +exec "${PYTHON:-python3}" "$script_dir/track2_suite.py" "$@" diff --git a/student-tests/test_reliability.sh b/student-tests/test_reliability.sh new file mode 100755 index 00000000..419d44a7 --- /dev/null +++ b/student-tests/test_reliability.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) +exec "${PYTHON:-python3}" "$script_dir/async_suite.py" reliability "$@" diff --git a/student-tests/test_thumbnail.py b/student-tests/test_thumbnail.py new file mode 100644 index 00000000..e3918229 --- /dev/null +++ b/student-tests/test_thumbnail.py @@ -0,0 +1,74 @@ +#!/usr/bin/env python3 +"""Run against thumbnail_smoke; requires Pillow for independent JPEG inspection.""" +import argparse +import subprocess +import struct +import zlib +import tempfile +from pathlib import Path +from PIL import Image, ImageOps + + +def run(binary, directory): + original = Image.new('RGB', (80, 40)) + for color, box in [((250, 0, 0), (0, 0, 40, 20)), + ((0, 250, 0), (40, 0, 80, 20)), + ((0, 0, 250), (0, 20, 40, 40)), + ((250, 250, 0), (40, 20, 80, 40))]: + original.paste(color, box) + + def convert(source): + target = directory / (source.stem + '-thumbnail.jpg') + subprocess.run([binary, str(source), str(target)], check=True, capture_output=True) + result = Image.open(target) + assert result.format == 'JPEG' + assert not result.getexif() + return result + + for suffix in ('jpg', 'png'): + for orientation in range(1, 9): + source = directory / f'orientation{orientation}.{suffix}' + exif = Image.Exif() + exif[274] = orientation + original.save(source, exif=exif, **({'quality': 100, 'subsampling': 0} if suffix == 'jpg' else {})) + expected = ImageOps.exif_transpose(Image.open(source)).convert('RGB') + actual = convert(source) + assert actual.size == expected.size, (source, actual.size, expected.size) + for x, y in [(actual.width // 4, actual.height // 4), + (3 * actual.width // 4, 3 * actual.height // 4)]: + assert max(abs(a - b) for a, b in zip(actual.getpixel((x, y)), expected.getpixel((x, y)))) < 15 + + for name, size, expected in [('standard', (320, 200), (256, 160)), + ('round', (501, 333), (256, 170)), + ('thin', (1, 300), (1, 256)), + ('small', (17, 11), (17, 11))]: + source = directory / (name + '.png') + Image.new('RGB', size, (30, 110, 200)).save(source) + assert convert(source).size == expected + for alpha, expected in [(0, (255, 255, 255)), (128, (255, 127, 127))]: + source = directory / f'alpha{alpha}.png' + Image.new('RGBA', (10, 10), (255, 0, 0, alpha)).save(source) + actual = convert(source).getpixel((5, 5)) + assert max(abs(a - b) for a, b in zip(actual, expected)) <= 3 + source = directory / 'pixel-limit.png' + Image.new('RGB', (1, 1)).save(source) + data = bytearray(source.read_bytes()) + data[16:24] = struct.pack('>II', 8000, 5001) + data[29:33] = struct.pack('>I', zlib.crc32(data[12:29])) + source.write_bytes(data) + rejected = subprocess.run([binary, str(source), str(directory / 'large.jpg')], capture_output=True) + assert rejected.returncode != 0 and b'image_too_large' in rejected.stderr + source = directory / 'invalid.png' + source.write_bytes(b'not an image') + assert subprocess.run([binary, str(source), str(directory / 'invalid.jpg')], capture_output=True).returncode != 0 + print('PASS: JPEG dimensions, rounding, no upscale, all 8 EXIF orientations (JPEG/PNG), white alpha, pre-decode pixel limit, corrupt input') + + +if __name__ == '__main__': + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--binary', default='build/thumbnail_smoke') + parser.add_argument('--workdir') + args = parser.parse_args() + binary = str(Path(args.binary).resolve()) + with tempfile.TemporaryDirectory(dir=str(Path(args.workdir).resolve()) if args.workdir else None) as directory: + run(binary, Path(directory)) diff --git a/student-tests/test_upload_async.sh b/student-tests/test_upload_async.sh new file mode 100755 index 00000000..d070f5aa --- /dev/null +++ b/student-tests/test_upload_async.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) +exec "${PYTHON:-python3}" "$script_dir/async_suite.py" upload "$@" diff --git a/student-tests/test_variants.py b/student-tests/test_variants.py new file mode 100644 index 00000000..7cf76507 --- /dev/null +++ b/student-tests/test_variants.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python3 +"""Independent inspection of crop/WebP through variants_smoke (requires Pillow).""" +import argparse +import json +import subprocess +import tempfile +from pathlib import Path +from PIL import Image, ImageOps + + +def run(binary, directory): + def convert(source): + output = directory / (source.stem + '-' + source.suffix[1:]) + command = subprocess.run([binary, str(source), str(output)], check=True, capture_output=True) + manifest = json.loads(command.stdout) + result = {} + for name, extension, fmt in [('thumbnail', 'jpg', 'JPEG'), ('crop', 'jpg', 'JPEG'), ('optimized', 'webp', 'WEBP')]: + path = output / (name + '.' + extension) + img = Image.open(path) + assert img.format == fmt and not img.getexif() + assert img.size == (manifest[name]['width'], manifest[name]['height']) + assert path.stat().st_size == manifest[name]['size_bytes'] + result[name] = img + return result + + for size, optimized in [((320, 200), (320, 200)), ((2560, 1600), (1280, 800)), + ((17, 11), (17, 11)), ((1, 300), (1, 300)), + ((2001, 1333), (1280, 852))]: + source = directory / f'fit{size[0]}x{size[1]}.png' + Image.new('RGB', size, (40, 180, 80)).save(source) + images = convert(source) + assert images['crop'].size == (128, 128) + assert images['optimized'].size == optimized + # Cropping must discard both outer strips and keep the centered square. + source = directory / 'center.png' + image = Image.new('RGB', (200, 100), (255, 0, 0)) + image.paste((0, 220, 0), (50, 0, 150, 100)) + image.paste((0, 0, 255), (150, 0, 200, 100)) + image.save(source) + cropped = convert(source)['crop'] + for point in [(5, 5), (64, 64), (122, 122)]: + assert max(abs(a-b) for a, b in zip(cropped.getpixel(point), (0, 220, 0))) < 10 + + image = Image.new('RGB', (80, 40)) + for color, box in [((250, 0, 0), (0, 0, 40, 20)), ((0, 250, 0), (40, 0, 80, 20)), + ((0, 0, 250), (0, 20, 40, 40)), ((250, 250, 0), (40, 20, 80, 40))]: + image.paste(color, box) + for suffix in ('jpg', 'png'): + for orientation in range(1, 9): + source = directory / f'orientation{orientation}.{suffix}' + exif = Image.Exif(); exif[274] = orientation + image.save(source, exif=exif, **({'quality': 100, 'subsampling': 0} if suffix == 'jpg' else {})) + expected = ImageOps.exif_transpose(Image.open(source)).convert('RGB') + result = convert(source) + actual = result['optimized'] + assert actual.size == expected.size + for x, y in [(actual.width // 4, actual.height // 4), (3 * actual.width // 4, 3 * actual.height // 4)]: + assert max(abs(a-b) for a,b in zip(actual.getpixel((x,y)),expected.getpixel((x,y)))) < 20 + source = directory / 'large-exif.png' + exif = Image.Exif(); exif[274] = 6; exif[37510] = b'A' * 70000 + image.save(source, exif=exif) + assert convert(source)['optimized'].size == (40, 80) + for alpha, color in [(0, (255, 255, 255)), (128, (255, 127, 127))]: + source = directory / f'alpha{alpha}.png' + Image.new('RGBA', (10, 10), (255, 0, 0, alpha)).save(source) + for image in convert(source).values(): + assert max(abs(a-b) for a,b in zip(image.getpixel((5,5)),color)) <= 6 + print('PASS: 3 variants, centered/upscaled crop, WebP fit/rounding/no upscale, EXIF stripped, orientations, alpha') + + +if __name__ == '__main__': + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--binary', default='build/variants_smoke') + parser.add_argument('--workdir') + args = parser.parse_args() + with tempfile.TemporaryDirectory(dir=str(Path(args.workdir).resolve()) if args.workdir else None) as directory: + run(str(Path(args.binary).resolve()), Path(directory)) diff --git a/student-tests/test_worker_down.sh b/student-tests/test_worker_down.sh new file mode 100755 index 00000000..a810de17 --- /dev/null +++ b/student-tests/test_worker_down.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) +exec "${PYTHON:-python3}" "$script_dir/async_suite.py" worker_down "$@" diff --git a/student-tests/track2_suite.py b/student-tests/track2_suite.py new file mode 100644 index 00000000..9f2f752b --- /dev/null +++ b/student-tests/track2_suite.py @@ -0,0 +1,385 @@ +#!/usr/bin/env python3 +"""Track 2: reproducible version/delivery/crash experiment on disposable stacks.""" +import argparse +import contextlib +import datetime as dt +import hashlib +import http.client +import json +from pathlib import Path +import shlex +import subprocess +import sys +import time +import uuid + +from async_suite import Stack, Suite, ROOT, Failure, check, wait_for, pillow_version + + +class Experiment(Suite): + def __init__(self, stack): + super().__init__(stack) + self.accepted = [] + self.intents = set() + + def upload(self, expected=202): + att = super().upload(expected) + if expected == 202: + self.accepted.append(att) + self.intents.add(self.job_for(att, 1)) + return att + + def job_for(self, att, version): + return self.stack.sql("SELECT id FROM jobs WHERE attachment_id='" + att['id'] + "' AND pipeline_version=" + str(version)) + + def payload(self, job): + return json.loads(self.stack.sql("SELECT payload FROM outbox WHERE payload->>'job_id'='" + job + "' ORDER BY id LIMIT 1")) + + def inject(self, payload): + self.stack.redis('XADD', 'jobs:attachments', '*', 'payload', json.dumps(payload)) + + def upgrade(self, att, created=True): + s = self.stack + result = s.command(s.prefix + s.base_files + ['exec', '-T', 'api', '/docker-entrypoint.sh', + '/app/job_admin', 'upgrade', att['id'], '--version', '2', '--actor', 'track2', + '--reason', 'quality pipeline version 2'], 'upgrade request') + data = json.loads(result.stdout) + uuid.UUID(data['job_id']) + check(data['created'] == created and data['pipeline_version'] == 2, 'upgrade idempotence mismatch') + self.intents.add(data['job_id']) + return data['job_id'] + + def ready_version(self, att, version): + s = self.stack + wait_for(lambda: s.sql("SELECT published_version FROM attachments WHERE id='" + att['id'] + "'") == str(version), + 'published pipeline ' + str(version)) + return self.ready(att) + + def result(self, att, version): + raw = self.stack.sql("SELECT row_to_json(r) FROM attachment_results r WHERE attachment_id='" + + att['id'] + "' AND pipeline_version=" + str(version)) + return json.loads(raw) if raw else None + + def keys(self, att, version): + prefix = 'attachments/' + self.chat['id'] + '/' + att['id'] + '/v' + str(version) + '/' + result = self.stack.mc('mc ls --json "local/$S3_BUCKET/"' + shlex.quote(prefix)) + return sorted(json.loads(line)['key'] for line in result.stdout.splitlines()) + + def snapshot(self, att, version): + result = self.result(att, version) + check(result is not None, 'published logical result missing') + keys = {result['original_key']: hashlib.sha256(self.content).hexdigest()} + names = [v['name'] for v in result['variants']] + check(len(names) == len(set(names)) == 3, 'duplicate logical variants') + for v in result['variants']: + keys[v['storage_key']] = v['sha256'] + check(len(keys) == 4, 'object keys collide') + for key, expected in keys.items(): + data = self.stack.mc('mc cat "local/$S3_BUCKET/"' + shlex.quote(key)).stdout + check(hashlib.sha256(data).hexdigest() == expected, 'S3 bytes differ from immutable result') + check(self.keys(att, version) == ['crop.jpg', 'optimized.webp', 'original', 'thumbnail.jpg'], + 'version has extra/missing S3 objects') + return {'metadata': result, 'objects_sha256': keys} + + def worker_ids(self): + return self.stack.dc('ps', '-q', 'worker').splitlines() + + def marker(self, cid, point, job): + return self.stack.command(['docker', 'exec', cid, 'test', '-f', + '/tmp/lab-fault/' + point + '.' + job + '.reached'], 'fault marker', allow_failure=True).returncode == 0 + + def release(self, cid, point, job): + self.stack.command(['docker', 'exec', cid, 'touch', + '/tmp/lab-fault/' + point + '.' + job + '.release'], 'release paused worker') + + @contextlib.contextmanager + def fault(self, point, job, version, action='crash'): + s = self.stack + s.dc('stop', 'worker') + path = s.directory / 'worker-fault.json' + path.write_text(json.dumps({'services': {'worker': {'environment': { + 'JOB_TIMEOUT_SECONDS': '60', 'LAB_ENABLE_FAULT_INJECTION': '1', + 'LAB_FAULT_POINT': point, 'LAB_FAULT_ACTION': action, + 'LAB_FAULT_JOB_ID': job, 'LAB_FAULT_PIPELINE_VERSION': str(version), + }}}})) + previous = s.base_files.copy() + s.base_files += ['-f', str(path)] + try: + s.dc('up', '-d', '--no-deps', '--force-recreate', '--scale', 'worker=1', 'worker') + cid = self.worker_ids()[0] + yield cid + finally: + s.base_files = previous + s.dc('up', '-d', '--no-deps', '--force-recreate', '--scale', 'worker=1', 'worker') + + def crash_case(self, version, point): + s = self.stack + att = self.upload() + if version == 2: + self.ready_version(att, 1) + s.dc('stop', 'worker') + job = self.upgrade(att) + else: + # The worker must not consume the new job before fault configuration. + job = self.job_for(att, 1) + since = dt.datetime.now(dt.timezone.utc).isoformat() + with self.fault(point, job, version) as cid: + wait_for(lambda: self.marker(cid, point, job), point + ' reached') + wait_for(lambda: s.inspect('worker')[0]['restart_count'] >= 1, 'injected crash restart') + until = dt.datetime.now(dt.timezone.utc).isoformat() + deaths = s.command(['docker', 'events', '--since', since, '--until', until, + '--filter', 'container=' + cid, '--filter', 'event=die', '--format', '{{json .}}'], + 'observed worker death') + exit_codes = [json.loads(line)['Actor']['Attributes'].get('exitCode') + for line in deaths.stdout.splitlines()] + check('86' in exit_codes, 'injected exit 86 not observed in Docker events') + ready = self.ready_version(att, version) + retries = int(s.sql("SELECT retries FROM jobs WHERE id='" + job + "'")) + check(retries == (1 if point in ('worker_before_effect', 'worker_after_effect') else 0), + 'crash boundary counted the wrong managed attempt') + wait_for(self.pending_empty, 'ACK after crash recovery') + snapshot = self.snapshot(att, version) + check(s.sql("SELECT count(*) FROM attachment_results WHERE job_id='" + job + "'") == '1', + 'crash duplicated logical result') + for _ in range(2): + self.inject(self.payload(job)) + wait_for(self.pending_empty, 'duplicate ACKs') + check(self.metadata(att) == ready and self.snapshot(att, version) == snapshot, + 'completed duplicate changed result') + s.record('track2 crash recovery', point=point, pipeline_version=version, job_id=job, + attachment_id=att['id'], logical_results=1, retries=retries, observed_exit_codes=exit_codes, object_hashes=snapshot['objects_sha256']) + + def crash_matrix(self): + for version in (1, 2): + for point in ('worker_before_effect', 'worker_after_effect', 'worker_after_commit', 'worker_before_ack'): + self.stack.dc('stop', 'worker') + if version == 2: + self.stack.dc('start', 'worker') + self.crash_case(version, point) + + def duplicate_and_reorder(self): + s = self.stack + s.dc('stop', 'worker') + att = self.upload(); job = self.job_for(att, 1) + wait_for(lambda: self.events(att), 'initial duplicate payload') + for _ in range(4): + self.inject(self.payload(job)) + s.dc('start', 'worker') + ready = self.ready_version(att, 1); wait_for(self.pending_empty, 'duplicate drain') + snapshot = self.snapshot(att, 1) + check(s.sql("SELECT retries FROM jobs WHERE id='" + job + "'") == '0', 'duplicate created a new managed attempt') + check(self.metadata(att) == ready, 'duplicate changed ready timestamp') + s.record('track2 duplicate delivery', deliveries=5, logical_results=1, objects=4, + attachment_id=att['id'], object_hashes=snapshot['objects_sha256']) + for order in ([1, 2, 1, 2], [2, 1, 2, 1]): + s.dc('stop', 'worker', 'cache') + att = self.upload(); old_job = self.job_for(att, 1); new_job = self.upgrade(att) + # Delay normal publishing; native XADD below models the selected delivery order. + s.sql("UPDATE outbox SET available_at=now()+interval '1 hour' WHERE payload->>'attachment_id'='" + att['id'] + "'") + s.dc('start', 'cache') + payloads = {1: self.payload(old_job), 2: self.payload(new_job)} + for version in order: + self.inject(payloads[version]) + s.sql("UPDATE outbox SET published=true WHERE payload->>'attachment_id'='" + att['id'] + "'") + s.dc('start', 'worker'); self.ready_version(att, 2) + wait_for(lambda: s.sql("SELECT status FROM jobs WHERE id='" + old_job + "'") == 'superseded', 'obsolete job discard') + wait_for(self.pending_empty, 'reordered events drain') + snapshot = self.snapshot(att, 2) + check(self.result(att, 1) is None and self.keys(att, 1) == [], 'obsolete queued job performed an effect') + s.record('track2 reordered versions', delivery_order=order, attachment_id=att['id'], + old_job_status='superseded', published_version=2, object_hashes=snapshot['objects_sha256']) + + def stale_ready(self): + s = self.stack + att = self.upload(); first = self.ready_version(att, 1); old_job = self.job_for(att, 1) + wait_for(lambda: s.sql("SELECT staging_cleaned_at IS NOT NULL FROM attachments WHERE id='" + att['id'] + "'") == 't', 'initial staging cleanup') + old = self.snapshot(att, 1) + job = self.upgrade(att) + check(self.upgrade(att, created=False) == job, 'same version created a second job') + current = self.ready_version(att, 2); new = self.snapshot(att, 2) + check(first['variants'][2]['sha256'] != current['variants'][2]['sha256'], 'v2 does not change the image algorithm') + check(s.sql("SELECT source_key FROM jobs WHERE id='" + job + "'") == old['metadata']['original_key'], + 'upgrade depends on deleted staging') + for version in (1, 2, 1, 1, 2): + self.inject(self.payload(old_job if version == 1 else job)) + invalid_before = s.redis('XLEN', 'jobs:attachments:invalid') + forged = self.payload(old_job); forged['pipeline_version'] = 2 + self.inject(forged) + wait_for(lambda: s.redis('XLEN', 'jobs:attachments:invalid') == invalid_before + 1, + 'carrier/database version mismatch rejected') + wait_for(self.pending_empty, 'late old events') + check(self.metadata(att) == current and self.snapshot(att, 2) == new and self.snapshot(att, 1) == old, + 'late version rewrote immutable data') + check(s.sql("SELECT count(*) FROM pipeline_requests WHERE attachment_id='" + att['id'] + "'") == '1', 'upgrade audit duplicated') + s.record('track2 old ready job after new version', attachment_id=att['id'], published_version=2, + old_result_unchanged=True, new_result_unchanged=True, upgrade_requests=1, + object_hashes=new['objects_sha256']) + + def late_worker(self, point): + s = self.stack + s.dc('stop', 'worker'); att = self.upload(); old_job = self.job_for(att, 1) + with self.fault(point, old_job, 1, action='pause') as cid: + wait_for(lambda: self.marker(cid, point, old_job), 'old worker barrier') + if point == 'worker_after_commit': + check(s.sql("SELECT published_version FROM attachments WHERE id='" + att['id'] + "'") == '1', 'commit barrier is before COMMIT') + check(s.redis('XPENDING', 'jobs:attachments', 'attachment-workers')[0] >= 1, 'commit barrier is after ACK') + if point == 'worker_before_effect': + check(self.keys(att, 1) == [], 'before-effect barrier has written S3') + else: + check(len(self.keys(att, 1)) == 4, 'after-effect barrier lacks S3 data') + new_job = self.upgrade(att) + # Same fault config/filter; the second worker handles only the independent v2 job. + s.dc('up', '-d', '--no-deps', '--scale', 'worker=2', 'worker') + check(cid in self.worker_ids(), 'scaling replaced the paused old worker') + current = self.ready_version(att, 2); snapshot = self.snapshot(att, 2) + if point == 'worker_before_effect': + check(s.exists(self.key(att)), 'GC removed an in-flight version source') + before = next(x for x in s.inspect('worker') if x['id'].startswith(cid))['restart_count'] + self.release(cid, point, old_job) + expected = 'ready' if point == 'worker_after_commit' else 'superseded' + wait_for(lambda: s.sql("SELECT status FROM jobs WHERE id='" + old_job + "'") == expected, 'late old worker finishes') + wait_for(self.pending_empty, 'late old ACK') + after = next(x for x in s.inspect('worker') if x['id'].startswith(cid))['restart_count'] + check(before == after == 0, 'old worker restarted instead of resuming') + check(self.metadata(att) == current and self.snapshot(att, 2) == snapshot, + 'late old worker replaced new published result') + check(len(self.keys(att, 1)) == 4, 'old worker did not execute its version effect') + s.record('track2 paused old worker resumes after v2 ready', point=point, + attachment_id=att['id'], old_job=old_job, new_job=new_job, + old_worker_resumed=True, published_version=2, old_status=expected, + object_hashes=snapshot['objects_sha256']) + + def failed_upgrade(self): + s = self.stack + att = self.upload(); first = self.ready_version(att, 1) + s.sql("CREATE FUNCTION test_reject_v2() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN IF NEW.published_version=2 THEN RAISE EXCEPTION 'test failure'; END IF; RETURN NEW; END $$; CREATE TRIGGER test_reject_v2 BEFORE UPDATE ON attachments FOR EACH ROW EXECUTE FUNCTION test_reject_v2()") + job = self.upgrade(att) + wait_for(lambda: s.sql("SELECT status FROM jobs WHERE id='" + job + "'") == 'failed', 'failed v2 upgrade') + check(self.metadata(att) == first, 'failed upgrade hides previous ready result') + s.sql('DROP TRIGGER test_reject_v2 ON attachments; DROP FUNCTION test_reject_v2()') + s.replay(job, True) + current = self.ready_version(att, 2) + check(current['variants'] != first['variants'], 'replayed v2 did not replace v1') + self.snapshot(att, 2) + s.record('track2 failed upgrade preserves v1; explicit replay publishes v2', attachment_id=att['id'], job_id=job) + + def invariants_and_restart(self): + s = self.stack + before = {a['id']: self.metadata(a) for a in self.accepted} + stores_before = {name: s.inspect(name) for name in ('db', 'cache', 'minio')} + s.dc('stop', 'worker'); s.dc('restart', 'db', 'cache', 'minio') + for name in stores_before: + s.wait_store(name) + s.dc('restart', 'api'); s.refresh(); s.dc('start', 'worker') + for att in self.accepted: + check(self.metadata(att) == before[att['id']], 'confirmed attachment/result lost after restart') + self.ready(att) + check(s.sql("SELECT count(*) FROM attachment_results WHERE attachment_id='" + att['id'] + + "' AND pipeline_version=(SELECT published_version FROM attachments WHERE id='" + att['id'] + "')") == '1', + 'current result not unique') + for job in self.intents: + check(s.sql("SELECT status FROM jobs WHERE id='" + job + "'") in ('ready', 'superseded'), 'committed intent lost or unfinished') + check(s.sql('SELECT count(*) FROM attachments WHERE published_version>pipeline_version') == '0', 'version order violated') + check(s.sql('SELECT count(*) FROM (SELECT attachment_id,pipeline_version,count(*) FROM attachment_results GROUP BY 1,2 HAVING count(*)>1) x') == '0', + 'logical result duplicated') + after = {name: s.inspect(name) for name in stores_before} + for name in stores_before: + check(stores_before[name][0]['started_at'] != after[name][0]['started_at'] and + stores_before[name][0]['volumes'] == after[name][0]['volumes'], 'store restart did not preserve volumes') + s.record('track2 invariants survive persistent-store restart', accepted_attachments=len(self.accepted), + committed_jobs=len(self.intents), lost_attachments=0, unfinished_jobs=0, + duplicate_results=0, snapshots_unchanged=True, before=stores_before, after=after) + + def migration(self): + s = self.stack + s.sql('CREATE DATABASE track2_legacy') + sql = ''.join(p.read_text() + '\n' for p in sorted((ROOT / 'migrations').glob('*.sql')) + if int(p.name.split('_')[0]) <= 10) + sql += """ +INSERT INTO users VALUES ('00000000-0000-4000-8000-000000000001','legacy_user','Legacy','test',now()); +INSERT INTO chats VALUES ('00000000-0000-4000-8000-000000000002','Legacy',now()); +INSERT INTO attachments(id,chat_id,owner_id,filename,content_type,size_bytes,sha256,status,s3_key,created_at,updated_at) +VALUES('00000000-0000-4000-8000-000000000003','00000000-0000-4000-8000-000000000002','00000000-0000-4000-8000-000000000001','legacy.png','image/png',1,repeat('a',64),'ready','attachments/legacy',now(),now()); +INSERT INTO jobs(id,attachment_id,status) VALUES('00000000-0000-4000-8000-000000000004','00000000-0000-4000-8000-000000000003','ready'); +""" + sql += (ROOT / 'migrations/011_versioned_pipeline.sql').read_text() + sql += """ +DO $$ BEGIN +IF NOT EXISTS(SELECT 1 FROM attachments WHERE status='ready' AND published_version=1 AND s3_key='attachments/legacy') THEN RAISE EXCEPTION 'legacy result changed'; END IF; +IF NOT EXISTS(SELECT 1 FROM attachment_results WHERE pipeline_version=1 AND original_key='attachments/legacy') THEN RAISE EXCEPTION 'legacy result missing'; END IF; +END $$; +UPDATE attachments SET pipeline_version=2; +INSERT INTO jobs(id,attachment_id,pipeline_version,source_key) VALUES('00000000-0000-4000-8000-000000000005','00000000-0000-4000-8000-000000000003',2,'attachments/legacy'); +DO $$ BEGIN +BEGIN UPDATE attachments SET published_version=3; RAISE EXCEPTION 'invalid pointer accepted'; EXCEPTION WHEN check_violation THEN NULL; END; +BEGIN INSERT INTO jobs(id,attachment_id,pipeline_version,source_key) VALUES('00000000-0000-4000-8000-000000000006','00000000-0000-4000-8000-000000000003',2,'attachments/legacy'); RAISE EXCEPTION 'duplicate logical job accepted'; EXCEPTION WHEN unique_violation THEN NULL; END; +BEGIN INSERT INTO attachment_results(attachment_id,pipeline_version,original_key,variants) SELECT attachment_id,pipeline_version,original_key,variants FROM attachment_results; RAISE EXCEPTION 'duplicate result accepted'; EXCEPTION WHEN unique_violation THEN NULL; END; +END $$; +""" + s.command(['docker', 'exec', '-i', s.store_ids['db'], 'psql', '-X', '-v', 'ON_ERROR_STOP=1', + '-U', 'messenger', '-d', 'track2_legacy'], 'legacy pipeline migration', data=sql.encode()) + s.sql('DROP DATABASE track2_legacy') + s.record('track2 legacy migration preserves ready and enforces version/job/result constraints') + + def run(self): + self.migration() + self.crash_matrix() + self.duplicate_and_reorder() + self.stale_ready() + for point in ('worker_before_effect', 'worker_after_effect', 'worker_after_commit'): + self.late_worker(point) + self.failed_upgrade() + self.invariants_and_restart() + self.public_smoke() + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--repetitions', type=int, default=3) + parser.add_argument('--no-build', action='store_true') + parser.add_argument('--output', type=Path, default=ROOT / 'evidence/track2.json') + args = parser.parse_args() + if not 1 <= args.repetitions <= 10: + parser.error('repetitions must be 1..10') + # Reuse the same fingerprint definition as the functional suite. + digest = hashlib.sha256() + files = [ROOT / n for n in ('CMakeLists.txt', 'Dockerfile', 'compose.yaml', '.dockerignore')] + for folder in ('src', 'migrations', 'third_party'): + files += [p for p in (ROOT / folder).rglob('*') if p.is_file()] + for path in sorted(files): + digest.update(str(path.relative_to(ROOT)).encode() + b'\0' + path.read_bytes()) + report = {'track': 2, 'hypothesis': 'at-least-once delivery plus versioned keys and fenced publication preserve one logical result and reject stale publication', + 'source_sha256': digest.hexdigest(), + 'method_sha256': hashlib.sha256(Path(__file__).read_bytes() + (ROOT / 'student-tests/async_suite.py').read_bytes()).hexdigest(), + 'python': sys.version.split()[0], 'pillow': pillow_version, + 'started_at': dt.datetime.now(dt.timezone.utc).isoformat(), 'passed': False, 'trials': []} + failure = False + for number in range(1, args.repetitions + 1): + stack = Stack(); trial = {'number': number, 'project': stack.project, 'passed': False} + started = time.monotonic() + try: + stack.start(build=not args.no_build and number == 1) + experiment = Experiment(stack); experiment.run() + trial['passed'] = True + except (Failure, OSError, ValueError, http.client.HTTPException, subprocess.TimeoutExpired) as error: + failure = True + trial['error'] = str(error) if isinstance(error, Failure) else type(error).__name__ + print('FAIL:', trial['error'], file=sys.stderr) + finally: + try: + stack.close(); trial['cleanup'] = 'own project and credentials removed' + except (Failure, OSError, subprocess.TimeoutExpired): + failure = True; trial['passed'] = False; trial['cleanup'] = 'FAILED: ' + stack.project + trial['events'] = stack.events; trial['elapsed_seconds'] = round(time.monotonic()-started, 3) + report['trials'].append(trial) + report['passed'] = not failure and len(report['trials']) == args.repetitions + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text(json.dumps(report, ensure_ascii=False, indent=2) + '\n') + if failure: + break + print('PASS: track2 trial', number, flush=True) + return 1 if failure else 0 + + +if __name__ == '__main__': + raise SystemExit(main()) diff --git a/third_party/stb/README.md b/third_party/stb/README.md new file mode 100644 index 00000000..f54db670 --- /dev/null +++ b/third_party/stb/README.md @@ -0,0 +1,6 @@ +Headers from https://github.com/nothings/stb at the commit in VERSION: +- stb_image.h: PNG/JPEG validation and decoding +- deprecated/stb_image_resize.h: aspect-preserving resize +- stb_image_write.h: JPEG encoding (quality 85) + +Each header includes its upstream license. diff --git a/third_party/stb/VERSION b/third_party/stb/VERSION new file mode 100644 index 00000000..adcd1f5a --- /dev/null +++ b/third_party/stb/VERSION @@ -0,0 +1 @@ +013ac3beddff3dbffafd5177e7972067cd2b5083 diff --git a/third_party/stb/stb_image.h b/third_party/stb/stb_image.h new file mode 100644 index 00000000..9eedabed --- /dev/null +++ b/third_party/stb/stb_image.h @@ -0,0 +1,7988 @@ +/* stb_image - v2.30 - 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.30 (2024-05-31) avoid erroneous gcc warning + 2.29 (2023-05-xx) optimizations + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 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 Neil Bickford 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 + +#if defined(_MSC_VER) || defined(__SYMBIAN32__) +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 + +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two ints fits in a signed short, 0 on overflow. +static int stbi__mul2shorts_valid(int a, int b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + +// 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); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } + 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]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; + 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); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + + 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); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + 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); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing + 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; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + 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 + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + 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; + + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + 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 + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + 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]; + } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! + 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; +} + +static stbi_uc stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + stbi_uc x = stbi__get8(j->s); + while (x == 0xff) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + +// 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 ) { + j->marker = stbi__skip_jpeg_junk_at_end(j); + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); + } 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"); + m = stbi__get_marker(j); + } else { + if (!stbi__process_marker(j, m)) return 1; + 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"); + memset(j, 0, sizeof(stbi__jpeg)); + 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"); + memset(j, 0, sizeof(stbi__jpeg)); + 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"); + memset(j, 0, sizeof(stbi__jpeg)); + 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; + int hit_zeof_once; + 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)) { + if (!a->hit_zeof_once) { + // This is the first time we hit eof, insert 16 extra padding btis + // to allow us to keep going; if we actually consume any of them + // though, that is invalid data. This is caught later. + a->hit_zeof_once = 1; + a->num_bits += 16; // add 16 implicit zero bits + } else { + // We already inserted our extra 16 padding bits and are again + // out, this stream is actually prematurely terminated. + return -1; + } + } else { + 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; + if (a->hit_zeof_once && a->num_bits < 16) { + // The first time we hit zeof, we inserted 16 extra zero bits into our bit + // buffer so the decoder can just do its speculative decoding. But if we + // actually consumed any of those bits (which is the case when num_bits < 16), + // the stream actually read past the end so it is malformed. + return stbi__err("unexpected end","Corrupt PNG"); + } + return 1; + } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data + 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 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data + 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 (len > a->zout_end - zout) { + 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; + a->hit_zeof_once = 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 filter used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_sub // Paeth with b=c=0 turns out to be equivalent to sub +}; + +static int stbi__paeth(int a, int b, int c) +{ + // This formulation looks very different from the reference in the PNG spec, but is + // actually equivalent and has favorable data dependencies and admits straightforward + // generation of branch-free code, which helps performance significantly. + int thresh = c*3 - (a + b); + int lo = a < b ? a : b; + int hi = a < b ? b : a; + int t0 = (hi <= thresh) ? lo : c; + int t1 = (thresh <= lo) ? hi : t0; + return t1; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// adds an extra all-255 alpha channel +// dest == src is legal +// img_n must be 1 or 3 +static void stbi__create_png_alpha_expand8(stbi_uc *dest, stbi_uc *src, stbi__uint32 x, int img_n) +{ + int i; + // must process data backwards since we allow dest==src + if (img_n == 1) { + for (i=x-1; i >= 0; --i) { + dest[i*2+1] = 255; + dest[i*2+0] = src[i]; + } + } else { + STBI_ASSERT(img_n == 3); + for (i=x-1; i >= 0; --i) { + dest[i*4+3] = 255; + dest[i*4+2] = src[i*3+2]; + dest[i*4+1] = src[i*3+1]; + dest[i*4+0] = src[i*3+0]; + } + } +} + +// 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; + stbi_uc *filter_buf; + int all_ok = 1; + 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"); + + // note: error exits here don't need to clean up a->out individually, + // stbi__do_png always does on error. + 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); + if (!stbi__mad2sizes_valid(img_width_bytes, y, img_width_bytes)) return stbi__err("too large", "Corrupt PNG"); + 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"); + + // Allocate two scan lines worth of filter workspace buffer. + filter_buf = (stbi_uc *) stbi__malloc_mad2(img_width_bytes, 2, 0); + if (!filter_buf) return stbi__err("outofmem", "Out of memory"); + + // Filtering for low-bit-depth images + if (depth < 8) { + filter_bytes = 1; + width = img_width_bytes; + } + + for (j=0; j < y; ++j) { + // cur/prior filter buffers alternate + stbi_uc *cur = filter_buf + (j & 1)*img_width_bytes; + stbi_uc *prior = filter_buf + (~j & 1)*img_width_bytes; + stbi_uc *dest = a->out + stride*j; + int nk = width * filter_bytes; + int filter = *raw++; + + // check filter type + if (filter > 4) { + all_ok = stbi__err("invalid filter","Corrupt PNG"); + break; + } + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // perform actual filtering + switch (filter) { + case STBI__F_none: + memcpy(cur, raw, nk); + break; + case STBI__F_sub: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); + break; + case STBI__F_up: + for (k = 0; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); + break; + case STBI__F_avg: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); + break; + case STBI__F_paeth: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); // prior[k] == stbi__paeth(0,prior[k],0) + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes], prior[k], prior[k-filter_bytes])); + break; + case STBI__F_avg_first: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); + break; + } + + raw += nk; + + // expand decoded bits in cur to dest, also adding an extra alpha channel if desired + if (depth < 8) { + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + stbi_uc *in = cur; + stbi_uc *out = dest; + stbi_uc inb = 0; + stbi__uint32 nsmp = x*img_n; + + // expand bits to bytes first + if (depth == 4) { + for (i=0; i < nsmp; ++i) { + if ((i & 1) == 0) inb = *in++; + *out++ = scale * (inb >> 4); + inb <<= 4; + } + } else if (depth == 2) { + for (i=0; i < nsmp; ++i) { + if ((i & 3) == 0) inb = *in++; + *out++ = scale * (inb >> 6); + inb <<= 2; + } + } else { + STBI_ASSERT(depth == 1); + for (i=0; i < nsmp; ++i) { + if ((i & 7) == 0) inb = *in++; + *out++ = scale * (inb >> 7); + inb <<= 1; + } + } + + // insert alpha=255 values if desired + if (img_n != out_n) + stbi__create_png_alpha_expand8(dest, dest, x, img_n); + } else if (depth == 8) { + if (img_n == out_n) + memcpy(dest, cur, x*img_n); + else + stbi__create_png_alpha_expand8(dest, cur, x, img_n); + } else if (depth == 16) { + // convert the image data from big-endian to platform-native + stbi__uint16 *dest16 = (stbi__uint16*)dest; + stbi__uint32 nsmp = x*img_n; + + if (img_n == out_n) { + for (i = 0; i < nsmp; ++i, ++dest16, cur += 2) + *dest16 = (cur[0] << 8) | cur[1]; + } else { + STBI_ASSERT(img_n+1 == out_n); + if (img_n == 1) { + for (i = 0; i < x; ++i, dest16 += 2, cur += 2) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = 0xffff; + } + } else { + STBI_ASSERT(img_n == 3); + for (i = 0; i < x; ++i, dest16 += 4, cur += 6) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = (cur[2] << 8) | cur[3]; + dest16[2] = (cur[4] << 8) | cur[5]; + dest16[3] = 0xffff; + } + } + } + } + } + + STBI_FREE(filter_buf); + if (!all_ok) return 0; + + 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_set_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"); + } 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"); + } + // even with 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; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } + if (z->depth == 16) { + for (k = 0; k < s->img_n && k < 3; ++k) // extra loop test to suppress false GCC warning + tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n && k < 3; ++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) { + // header scan definitely stops at first IDAT + if (pal_img_n) + s->img_n = pal_img_n; + return 1; + } + if (c.length > (1u << 30)) return stbi__err("IDAT size limit", "IDAT section larger than 2^30 bytes"); + 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) { + // accept some number of extra bytes after the header, but if the offset points either to before + // the header ends or implies a large amount of extra data, reject the file as malformed + int bytes_read_so_far = s->callback_already_read + (int)(s->img_buffer - s->img_buffer_original); + int header_limit = 1024; // max we actually read is below 256 bytes currently. + int extra_data_limit = 256*4; // what ordinarily goes here is a palette; 256 entries*4 bytes is its max size. + if (bytes_read_so_far <= 0 || bytes_read_so_far > header_limit) { + return stbi__errpuc("bad header", "Corrupt BMP"); + } + // we established that bytes_read_so_far is positive and sensible. + // the first half of this test rejects offsets that are either too small positives, or + // negative, and guarantees that info.offset >= bytes_read_so_far > 0. this in turn + // ensures the number computed in the second half of the test can't overflow. + if (info.offset < bytes_read_so_far || info.offset - bytes_read_so_far > extra_data_limit) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } else { + stbi__skip(s, info.offset - bytes_read_so_far); + } + } + + 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; ytype) { + default: + return stbi__errpuc("bad format","packet has bad compression type"); + + case 0: {//uncompressed + int x; + + for(x=0;xchannel,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; ichannel,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;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; + } + } + } + } + + 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 == 0) || (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 == 0) || (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"); + if (!stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8))) { + STBI_FREE(out); + return stbi__errpuc("bad PNM", "PNM file truncated"); + } + + if (req_comp && req_comp != s->img_n) { + if (ri->bits_per_channel == 16) { + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, s->img_n, req_comp, s->img_x, s->img_y); + } else { + 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); + if((value > 214748364) || (value == 214748364 && *c > '7')) + return stbi__err("integer parse overflow", "Parsing an integer in the PPM header overflowed a 32-bit int"); + } + + 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 + if(*x == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + *y = stbi__pnm_getinteger(s, &c); // read height + if (*y == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + 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. +------------------------------------------------------------------------------ +*/ diff --git a/third_party/stb/stb_image_resize.h b/third_party/stb/stb_image_resize.h new file mode 100644 index 00000000..ef9e6fe8 --- /dev/null +++ b/third_party/stb/stb_image_resize.h @@ -0,0 +1,2634 @@ +/* stb_image_resize - v0.97 - public domain image resizing + by Jorge L Rodriguez (@VinoBS) - 2014 + http://github.com/nothings/stb + + Written with emphasis on usability, portability, and efficiency. (No + SIMD or threads, so it be easily outperformed by libs that use those.) + Only scaling and translation is supported, no rotations or shears. + Easy API downsamples w/Mitchell filter, upsamples w/cubic interpolation. + + COMPILING & LINKING + In one C/C++ file that #includes this file, do this: + #define STB_IMAGE_RESIZE_IMPLEMENTATION + before the #include. That will create the implementation in that file. + + QUICKSTART + stbir_resize_uint8( input_pixels , in_w , in_h , 0, + output_pixels, out_w, out_h, 0, num_channels) + stbir_resize_float(...) + stbir_resize_uint8_srgb( input_pixels , in_w , in_h , 0, + output_pixels, out_w, out_h, 0, + num_channels , alpha_chan , 0) + stbir_resize_uint8_srgb_edgemode( + input_pixels , in_w , in_h , 0, + output_pixels, out_w, out_h, 0, + num_channels , alpha_chan , 0, STBIR_EDGE_CLAMP) + // WRAP/REFLECT/ZERO + + FULL API + See the "header file" section of the source for API documentation. + + ADDITIONAL DOCUMENTATION + + SRGB & FLOATING POINT REPRESENTATION + The sRGB functions presume IEEE floating point. If you do not have + IEEE floating point, define STBIR_NON_IEEE_FLOAT. This will use + a slower implementation. + + MEMORY ALLOCATION + The resize functions here perform a single memory allocation using + malloc. To control the memory allocation, before the #include that + triggers the implementation, do: + + #define STBIR_MALLOC(size,context) ... + #define STBIR_FREE(ptr,context) ... + + Each resize function makes exactly one call to malloc/free, so to use + temp memory, store the temp memory in the context and return that. + + ASSERT + Define STBIR_ASSERT(boolval) to override assert() and not use assert.h + + OPTIMIZATION + Define STBIR_SATURATE_INT to compute clamp values in-range using + integer operations instead of float operations. This may be faster + on some platforms. + + DEFAULT FILTERS + For functions which don't provide explicit control over what filters + to use, you can change the compile-time defaults with + + #define STBIR_DEFAULT_FILTER_UPSAMPLE STBIR_FILTER_something + #define STBIR_DEFAULT_FILTER_DOWNSAMPLE STBIR_FILTER_something + + See stbir_filter in the header-file section for the list of filters. + + NEW FILTERS + A number of 1D filter kernels are used. For a list of + supported filters see the stbir_filter enum. To add a new filter, + write a filter function and add it to stbir__filter_info_table. + + PROGRESS + For interactive use with slow resize operations, you can install + a progress-report callback: + + #define STBIR_PROGRESS_REPORT(val) some_func(val) + + The parameter val is a float which goes from 0 to 1 as progress is made. + + For example: + + static void my_progress_report(float progress); + #define STBIR_PROGRESS_REPORT(val) my_progress_report(val) + + #define STB_IMAGE_RESIZE_IMPLEMENTATION + #include "stb_image_resize.h" + + static void my_progress_report(float progress) + { + printf("Progress: %f%%\n", progress*100); + } + + MAX CHANNELS + If your image has more than 64 channels, define STBIR_MAX_CHANNELS + to the max you'll have. + + ALPHA CHANNEL + Most of the resizing functions provide the ability to control how + the alpha channel of an image is processed. The important things + to know about this: + + 1. The best mathematically-behaved version of alpha to use is + called "premultiplied alpha", in which the other color channels + have had the alpha value multiplied in. If you use premultiplied + alpha, linear filtering (such as image resampling done by this + library, or performed in texture units on GPUs) does the "right + thing". While premultiplied alpha is standard in the movie CGI + industry, it is still uncommon in the videogame/real-time world. + + If you linearly filter non-premultiplied alpha, strange effects + occur. (For example, the 50/50 average of 99% transparent bright green + and 1% transparent black produces 50% transparent dark green when + non-premultiplied, whereas premultiplied it produces 50% + transparent near-black. The former introduces green energy + that doesn't exist in the source image.) + + 2. Artists should not edit premultiplied-alpha images; artists + want non-premultiplied alpha images. Thus, art tools generally output + non-premultiplied alpha images. + + 3. You will get best results in most cases by converting images + to premultiplied alpha before processing them mathematically. + + 4. If you pass the flag STBIR_FLAG_ALPHA_PREMULTIPLIED, the + resizer does not do anything special for the alpha channel; + it is resampled identically to other channels. This produces + the correct results for premultiplied-alpha images, but produces + less-than-ideal results for non-premultiplied-alpha images. + + 5. If you do not pass the flag STBIR_FLAG_ALPHA_PREMULTIPLIED, + then the resizer weights the contribution of input pixels + based on their alpha values, or, equivalently, it multiplies + the alpha value into the color channels, resamples, then divides + by the resultant alpha value. Input pixels which have alpha=0 do + not contribute at all to output pixels unless _all_ of the input + pixels affecting that output pixel have alpha=0, in which case + the result for that pixel is the same as it would be without + STBIR_FLAG_ALPHA_PREMULTIPLIED. However, this is only true for + input images in integer formats. For input images in float format, + input pixels with alpha=0 have no effect, and output pixels + which have alpha=0 will be 0 in all channels. (For float images, + you can manually achieve the same result by adding a tiny epsilon + value to the alpha channel of every image, and then subtracting + or clamping it at the end.) + + 6. You can suppress the behavior described in #5 and make + all-0-alpha pixels have 0 in all channels by #defining + STBIR_NO_ALPHA_EPSILON. + + 7. You can separately control whether the alpha channel is + interpreted as linear or affected by the colorspace. By default + it is linear; you almost never want to apply the colorspace. + (For example, graphics hardware does not apply sRGB conversion + to the alpha channel.) + + CONTRIBUTORS + Jorge L Rodriguez: Implementation + Sean Barrett: API design, optimizations + Aras Pranckevicius: bugfix + Nathan Reed: warning fixes + + REVISIONS + 0.97 (2020-02-02) fixed warning + 0.96 (2019-03-04) fixed warnings + 0.95 (2017-07-23) fixed warnings + 0.94 (2017-03-18) fixed warnings + 0.93 (2017-03-03) fixed bug with certain combinations of heights + 0.92 (2017-01-02) fix integer overflow on large (>2GB) images + 0.91 (2016-04-02) fix warnings; fix handling of subpixel regions + 0.90 (2014-09-17) first released version + + LICENSE + See end of file for license information. + + TODO + Don't decode all of the image data when only processing a partial tile + Don't use full-width decode buffers when only processing a partial tile + When processing wide images, break processing into tiles so data fits in L1 cache + Installable filters? + Resize that respects alpha test coverage + (Reference code: FloatImage::alphaTestCoverage and FloatImage::scaleAlphaToCoverage: + https://code.google.com/p/nvidia-texture-tools/source/browse/trunk/src/nvimage/FloatImage.cpp ) +*/ + +#ifndef STBIR_INCLUDE_STB_IMAGE_RESIZE_H +#define STBIR_INCLUDE_STB_IMAGE_RESIZE_H + +#ifdef _MSC_VER +typedef unsigned char stbir_uint8; +typedef unsigned short stbir_uint16; +typedef unsigned int stbir_uint32; +#else +#include +typedef uint8_t stbir_uint8; +typedef uint16_t stbir_uint16; +typedef uint32_t stbir_uint32; +#endif + +#ifndef STBIRDEF +#ifdef STB_IMAGE_RESIZE_STATIC +#define STBIRDEF static +#else +#ifdef __cplusplus +#define STBIRDEF extern "C" +#else +#define STBIRDEF extern +#endif +#endif +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// Easy-to-use API: +// +// * "input pixels" points to an array of image data with 'num_channels' channels (e.g. RGB=3, RGBA=4) +// * input_w is input image width (x-axis), input_h is input image height (y-axis) +// * stride is the offset between successive rows of image data in memory, in bytes. you can +// specify 0 to mean packed continuously in memory +// * alpha channel is treated identically to other channels. +// * colorspace is linear or sRGB as specified by function name +// * returned result is 1 for success or 0 in case of an error. +// #define STBIR_ASSERT() to trigger an assert on parameter validation errors. +// * Memory required grows approximately linearly with input and output size, but with +// discontinuities at input_w == output_w and input_h == output_h. +// * These functions use a "default" resampling filter defined at compile time. To change the filter, +// you can change the compile-time defaults by #defining STBIR_DEFAULT_FILTER_UPSAMPLE +// and STBIR_DEFAULT_FILTER_DOWNSAMPLE, or you can use the medium-complexity API. + +STBIRDEF int stbir_resize_uint8( const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels); + +STBIRDEF int stbir_resize_float( const float *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + float *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels); + + +// The following functions interpret image data as gamma-corrected sRGB. +// Specify STBIR_ALPHA_CHANNEL_NONE if you have no alpha channel, +// or otherwise provide the index of the alpha channel. Flags value +// of 0 will probably do the right thing if you're not sure what +// the flags mean. + +#define STBIR_ALPHA_CHANNEL_NONE -1 + +// Set this flag if your texture has premultiplied alpha. Otherwise, stbir will +// use alpha-weighted resampling (effectively premultiplying, resampling, +// then unpremultiplying). +#define STBIR_FLAG_ALPHA_PREMULTIPLIED (1 << 0) +// The specified alpha channel should be handled as gamma-corrected value even +// when doing sRGB operations. +#define STBIR_FLAG_ALPHA_USES_COLORSPACE (1 << 1) + +STBIRDEF int stbir_resize_uint8_srgb(const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags); + + +typedef enum +{ + STBIR_EDGE_CLAMP = 1, + STBIR_EDGE_REFLECT = 2, + STBIR_EDGE_WRAP = 3, + STBIR_EDGE_ZERO = 4, +} stbir_edge; + +// This function adds the ability to specify how requests to sample off the edge of the image are handled. +STBIRDEF int stbir_resize_uint8_srgb_edgemode(const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode); + +////////////////////////////////////////////////////////////////////////////// +// +// Medium-complexity API +// +// This extends the easy-to-use API as follows: +// +// * Alpha-channel can be processed separately +// * If alpha_channel is not STBIR_ALPHA_CHANNEL_NONE +// * Alpha channel will not be gamma corrected (unless flags&STBIR_FLAG_GAMMA_CORRECT) +// * Filters will be weighted by alpha channel (unless flags&STBIR_FLAG_ALPHA_PREMULTIPLIED) +// * Filter can be selected explicitly +// * uint16 image type +// * sRGB colorspace available for all types +// * context parameter for passing to STBIR_MALLOC + +typedef enum +{ + STBIR_FILTER_DEFAULT = 0, // use same filter type that easy-to-use API chooses + STBIR_FILTER_BOX = 1, // A trapezoid w/1-pixel wide ramps, same result as box for integer scale ratios + STBIR_FILTER_TRIANGLE = 2, // On upsampling, produces same results as bilinear texture filtering + STBIR_FILTER_CUBICBSPLINE = 3, // The cubic b-spline (aka Mitchell-Netrevalli with B=1,C=0), gaussian-esque + STBIR_FILTER_CATMULLROM = 4, // An interpolating cubic spline + STBIR_FILTER_MITCHELL = 5, // Mitchell-Netrevalli filter with B=1/3, C=1/3 +} stbir_filter; + +typedef enum +{ + STBIR_COLORSPACE_LINEAR, + STBIR_COLORSPACE_SRGB, + + STBIR_MAX_COLORSPACES, +} stbir_colorspace; + +// The following functions are all identical except for the type of the image data + +STBIRDEF int stbir_resize_uint8_generic( const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context); + +STBIRDEF int stbir_resize_uint16_generic(const stbir_uint16 *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + stbir_uint16 *output_pixels , int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context); + +STBIRDEF int stbir_resize_float_generic( const float *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + float *output_pixels , int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context); + + + +////////////////////////////////////////////////////////////////////////////// +// +// Full-complexity API +// +// This extends the medium API as follows: +// +// * uint32 image type +// * not typesafe +// * separate filter types for each axis +// * separate edge modes for each axis +// * can specify scale explicitly for subpixel correctness +// * can specify image source tile using texture coordinates + +typedef enum +{ + STBIR_TYPE_UINT8 , + STBIR_TYPE_UINT16, + STBIR_TYPE_UINT32, + STBIR_TYPE_FLOAT , + + STBIR_MAX_TYPES +} stbir_datatype; + +STBIRDEF int stbir_resize( const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context); + +STBIRDEF int stbir_resize_subpixel(const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context, + float x_scale, float y_scale, + float x_offset, float y_offset); + +STBIRDEF int stbir_resize_region( const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context, + float s0, float t0, float s1, float t1); +// (s0, t0) & (s1, t1) are the top-left and bottom right corner (uv addressing style: [0, 1]x[0, 1]) of a region of the input image to use. + +// +// +//// end header file ///////////////////////////////////////////////////// +#endif // STBIR_INCLUDE_STB_IMAGE_RESIZE_H + + + + + +#ifdef STB_IMAGE_RESIZE_IMPLEMENTATION + +#ifndef STBIR_ASSERT +#include +#define STBIR_ASSERT(x) assert(x) +#endif + +// For memset +#include + +#include + +#ifndef STBIR_MALLOC +#include +// use comma operator to evaluate c, to avoid "unused parameter" warnings +#define STBIR_MALLOC(size,c) ((void)(c), malloc(size)) +#define STBIR_FREE(ptr,c) ((void)(c), free(ptr)) +#endif + +#ifndef _MSC_VER +#ifdef __cplusplus +#define stbir__inline inline +#else +#define stbir__inline +#endif +#else +#define stbir__inline __forceinline +#endif + + +// should produce compiler error if size is wrong +typedef unsigned char stbir__validate_uint32[sizeof(stbir_uint32) == 4 ? 1 : -1]; + +#ifdef _MSC_VER +#define STBIR__NOTUSED(v) (void)(v) +#else +#define STBIR__NOTUSED(v) (void)sizeof(v) +#endif + +#define STBIR__ARRAY_SIZE(a) (sizeof((a))/sizeof((a)[0])) + +#ifndef STBIR_DEFAULT_FILTER_UPSAMPLE +#define STBIR_DEFAULT_FILTER_UPSAMPLE STBIR_FILTER_CATMULLROM +#endif + +#ifndef STBIR_DEFAULT_FILTER_DOWNSAMPLE +#define STBIR_DEFAULT_FILTER_DOWNSAMPLE STBIR_FILTER_MITCHELL +#endif + +#ifndef STBIR_PROGRESS_REPORT +#define STBIR_PROGRESS_REPORT(float_0_to_1) +#endif + +#ifndef STBIR_MAX_CHANNELS +#define STBIR_MAX_CHANNELS 64 +#endif + +#if STBIR_MAX_CHANNELS > 65536 +#error "Too many channels; STBIR_MAX_CHANNELS must be no more than 65536." +// because we store the indices in 16-bit variables +#endif + +// This value is added to alpha just before premultiplication to avoid +// zeroing out color values. It is equivalent to 2^-80. If you don't want +// that behavior (it may interfere if you have floating point images with +// very small alpha values) then you can define STBIR_NO_ALPHA_EPSILON to +// disable it. +#ifndef STBIR_ALPHA_EPSILON +#define STBIR_ALPHA_EPSILON ((float)1 / (1 << 20) / (1 << 20) / (1 << 20) / (1 << 20)) +#endif + + + +#ifdef _MSC_VER +#define STBIR__UNUSED_PARAM(v) (void)(v) +#else +#define STBIR__UNUSED_PARAM(v) (void)sizeof(v) +#endif + +// must match stbir_datatype +static unsigned char stbir__type_size[] = { + 1, // STBIR_TYPE_UINT8 + 2, // STBIR_TYPE_UINT16 + 4, // STBIR_TYPE_UINT32 + 4, // STBIR_TYPE_FLOAT +}; + +// Kernel function centered at 0 +typedef float (stbir__kernel_fn)(float x, float scale); +typedef float (stbir__support_fn)(float scale); + +typedef struct +{ + stbir__kernel_fn* kernel; + stbir__support_fn* support; +} stbir__filter_info; + +// When upsampling, the contributors are which source pixels contribute. +// When downsampling, the contributors are which destination pixels are contributed to. +typedef struct +{ + int n0; // First contributing pixel + int n1; // Last contributing pixel +} stbir__contributors; + +typedef struct +{ + const void* input_data; + int input_w; + int input_h; + int input_stride_bytes; + + void* output_data; + int output_w; + int output_h; + int output_stride_bytes; + + float s0, t0, s1, t1; + + float horizontal_shift; // Units: output pixels + float vertical_shift; // Units: output pixels + float horizontal_scale; + float vertical_scale; + + int channels; + int alpha_channel; + stbir_uint32 flags; + stbir_datatype type; + stbir_filter horizontal_filter; + stbir_filter vertical_filter; + stbir_edge edge_horizontal; + stbir_edge edge_vertical; + stbir_colorspace colorspace; + + stbir__contributors* horizontal_contributors; + float* horizontal_coefficients; + + stbir__contributors* vertical_contributors; + float* vertical_coefficients; + + int decode_buffer_pixels; + float* decode_buffer; + + float* horizontal_buffer; + + // cache these because ceil/floor are inexplicably showing up in profile + int horizontal_coefficient_width; + int vertical_coefficient_width; + int horizontal_filter_pixel_width; + int vertical_filter_pixel_width; + int horizontal_filter_pixel_margin; + int vertical_filter_pixel_margin; + int horizontal_num_contributors; + int vertical_num_contributors; + + int ring_buffer_length_bytes; // The length of an individual entry in the ring buffer. The total number of ring buffers is stbir__get_filter_pixel_width(filter) + int ring_buffer_num_entries; // Total number of entries in the ring buffer. + int ring_buffer_first_scanline; + int ring_buffer_last_scanline; + int ring_buffer_begin_index; // first_scanline is at this index in the ring buffer + float* ring_buffer; + + float* encode_buffer; // A temporary buffer to store floats so we don't lose precision while we do multiply-adds. + + int horizontal_contributors_size; + int horizontal_coefficients_size; + int vertical_contributors_size; + int vertical_coefficients_size; + int decode_buffer_size; + int horizontal_buffer_size; + int ring_buffer_size; + int encode_buffer_size; +} stbir__info; + + +static const float stbir__max_uint8_as_float = 255.0f; +static const float stbir__max_uint16_as_float = 65535.0f; +static const double stbir__max_uint32_as_float = 4294967295.0; + + +static stbir__inline int stbir__min(int a, int b) +{ + return a < b ? a : b; +} + +static stbir__inline float stbir__saturate(float x) +{ + if (x < 0) + return 0; + + if (x > 1) + return 1; + + return x; +} + +#ifdef STBIR_SATURATE_INT +static stbir__inline stbir_uint8 stbir__saturate8(int x) +{ + if ((unsigned int) x <= 255) + return x; + + if (x < 0) + return 0; + + return 255; +} + +static stbir__inline stbir_uint16 stbir__saturate16(int x) +{ + if ((unsigned int) x <= 65535) + return x; + + if (x < 0) + return 0; + + return 65535; +} +#endif + +static float stbir__srgb_uchar_to_linear_float[256] = { + 0.000000f, 0.000304f, 0.000607f, 0.000911f, 0.001214f, 0.001518f, 0.001821f, 0.002125f, 0.002428f, 0.002732f, 0.003035f, + 0.003347f, 0.003677f, 0.004025f, 0.004391f, 0.004777f, 0.005182f, 0.005605f, 0.006049f, 0.006512f, 0.006995f, 0.007499f, + 0.008023f, 0.008568f, 0.009134f, 0.009721f, 0.010330f, 0.010960f, 0.011612f, 0.012286f, 0.012983f, 0.013702f, 0.014444f, + 0.015209f, 0.015996f, 0.016807f, 0.017642f, 0.018500f, 0.019382f, 0.020289f, 0.021219f, 0.022174f, 0.023153f, 0.024158f, + 0.025187f, 0.026241f, 0.027321f, 0.028426f, 0.029557f, 0.030713f, 0.031896f, 0.033105f, 0.034340f, 0.035601f, 0.036889f, + 0.038204f, 0.039546f, 0.040915f, 0.042311f, 0.043735f, 0.045186f, 0.046665f, 0.048172f, 0.049707f, 0.051269f, 0.052861f, + 0.054480f, 0.056128f, 0.057805f, 0.059511f, 0.061246f, 0.063010f, 0.064803f, 0.066626f, 0.068478f, 0.070360f, 0.072272f, + 0.074214f, 0.076185f, 0.078187f, 0.080220f, 0.082283f, 0.084376f, 0.086500f, 0.088656f, 0.090842f, 0.093059f, 0.095307f, + 0.097587f, 0.099899f, 0.102242f, 0.104616f, 0.107023f, 0.109462f, 0.111932f, 0.114435f, 0.116971f, 0.119538f, 0.122139f, + 0.124772f, 0.127438f, 0.130136f, 0.132868f, 0.135633f, 0.138432f, 0.141263f, 0.144128f, 0.147027f, 0.149960f, 0.152926f, + 0.155926f, 0.158961f, 0.162029f, 0.165132f, 0.168269f, 0.171441f, 0.174647f, 0.177888f, 0.181164f, 0.184475f, 0.187821f, + 0.191202f, 0.194618f, 0.198069f, 0.201556f, 0.205079f, 0.208637f, 0.212231f, 0.215861f, 0.219526f, 0.223228f, 0.226966f, + 0.230740f, 0.234551f, 0.238398f, 0.242281f, 0.246201f, 0.250158f, 0.254152f, 0.258183f, 0.262251f, 0.266356f, 0.270498f, + 0.274677f, 0.278894f, 0.283149f, 0.287441f, 0.291771f, 0.296138f, 0.300544f, 0.304987f, 0.309469f, 0.313989f, 0.318547f, + 0.323143f, 0.327778f, 0.332452f, 0.337164f, 0.341914f, 0.346704f, 0.351533f, 0.356400f, 0.361307f, 0.366253f, 0.371238f, + 0.376262f, 0.381326f, 0.386430f, 0.391573f, 0.396755f, 0.401978f, 0.407240f, 0.412543f, 0.417885f, 0.423268f, 0.428691f, + 0.434154f, 0.439657f, 0.445201f, 0.450786f, 0.456411f, 0.462077f, 0.467784f, 0.473532f, 0.479320f, 0.485150f, 0.491021f, + 0.496933f, 0.502887f, 0.508881f, 0.514918f, 0.520996f, 0.527115f, 0.533276f, 0.539480f, 0.545725f, 0.552011f, 0.558340f, + 0.564712f, 0.571125f, 0.577581f, 0.584078f, 0.590619f, 0.597202f, 0.603827f, 0.610496f, 0.617207f, 0.623960f, 0.630757f, + 0.637597f, 0.644480f, 0.651406f, 0.658375f, 0.665387f, 0.672443f, 0.679543f, 0.686685f, 0.693872f, 0.701102f, 0.708376f, + 0.715694f, 0.723055f, 0.730461f, 0.737911f, 0.745404f, 0.752942f, 0.760525f, 0.768151f, 0.775822f, 0.783538f, 0.791298f, + 0.799103f, 0.806952f, 0.814847f, 0.822786f, 0.830770f, 0.838799f, 0.846873f, 0.854993f, 0.863157f, 0.871367f, 0.879622f, + 0.887923f, 0.896269f, 0.904661f, 0.913099f, 0.921582f, 0.930111f, 0.938686f, 0.947307f, 0.955974f, 0.964686f, 0.973445f, + 0.982251f, 0.991102f, 1.0f +}; + +static float stbir__srgb_to_linear(float f) +{ + if (f <= 0.04045f) + return f / 12.92f; + else + return (float)pow((f + 0.055f) / 1.055f, 2.4f); +} + +static float stbir__linear_to_srgb(float f) +{ + if (f <= 0.0031308f) + return f * 12.92f; + else + return 1.055f * (float)pow(f, 1 / 2.4f) - 0.055f; +} + +#ifndef STBIR_NON_IEEE_FLOAT +// From https://gist.github.com/rygorous/2203834 + +typedef union +{ + stbir_uint32 u; + float f; +} stbir__FP32; + +static const stbir_uint32 fp32_to_srgb8_tab4[104] = { + 0x0073000d, 0x007a000d, 0x0080000d, 0x0087000d, 0x008d000d, 0x0094000d, 0x009a000d, 0x00a1000d, + 0x00a7001a, 0x00b4001a, 0x00c1001a, 0x00ce001a, 0x00da001a, 0x00e7001a, 0x00f4001a, 0x0101001a, + 0x010e0033, 0x01280033, 0x01410033, 0x015b0033, 0x01750033, 0x018f0033, 0x01a80033, 0x01c20033, + 0x01dc0067, 0x020f0067, 0x02430067, 0x02760067, 0x02aa0067, 0x02dd0067, 0x03110067, 0x03440067, + 0x037800ce, 0x03df00ce, 0x044600ce, 0x04ad00ce, 0x051400ce, 0x057b00c5, 0x05dd00bc, 0x063b00b5, + 0x06970158, 0x07420142, 0x07e30130, 0x087b0120, 0x090b0112, 0x09940106, 0x0a1700fc, 0x0a9500f2, + 0x0b0f01cb, 0x0bf401ae, 0x0ccb0195, 0x0d950180, 0x0e56016e, 0x0f0d015e, 0x0fbc0150, 0x10630143, + 0x11070264, 0x1238023e, 0x1357021d, 0x14660201, 0x156601e9, 0x165a01d3, 0x174401c0, 0x182401af, + 0x18fe0331, 0x1a9602fe, 0x1c1502d2, 0x1d7e02ad, 0x1ed4028d, 0x201a0270, 0x21520256, 0x227d0240, + 0x239f0443, 0x25c003fe, 0x27bf03c4, 0x29a10392, 0x2b6a0367, 0x2d1d0341, 0x2ebe031f, 0x304d0300, + 0x31d105b0, 0x34a80555, 0x37520507, 0x39d504c5, 0x3c37048b, 0x3e7c0458, 0x40a8042a, 0x42bd0401, + 0x44c20798, 0x488e071e, 0x4c1c06b6, 0x4f76065d, 0x52a50610, 0x55ac05cc, 0x5892058f, 0x5b590559, + 0x5e0c0a23, 0x631c0980, 0x67db08f6, 0x6c55087f, 0x70940818, 0x74a007bd, 0x787d076c, 0x7c330723, +}; + +static stbir_uint8 stbir__linear_to_srgb_uchar(float in) +{ + static const stbir__FP32 almostone = { 0x3f7fffff }; // 1-eps + static const stbir__FP32 minval = { (127-13) << 23 }; + stbir_uint32 tab,bias,scale,t; + stbir__FP32 f; + + // Clamp to [2^(-13), 1-eps]; these two values map to 0 and 1, respectively. + // The tests are carefully written so that NaNs map to 0, same as in the reference + // implementation. + if (!(in > minval.f)) // written this way to catch NaNs + in = minval.f; + if (in > almostone.f) + in = almostone.f; + + // Do the table lookup and unpack bias, scale + f.f = in; + tab = fp32_to_srgb8_tab4[(f.u - minval.u) >> 20]; + bias = (tab >> 16) << 9; + scale = tab & 0xffff; + + // Grab next-highest mantissa bits and perform linear interpolation + t = (f.u >> 12) & 0xff; + return (unsigned char) ((bias + scale*t) >> 16); +} + +#else +// sRGB transition values, scaled by 1<<28 +static int stbir__srgb_offset_to_linear_scaled[256] = +{ + 0, 40738, 122216, 203693, 285170, 366648, 448125, 529603, + 611080, 692557, 774035, 855852, 942009, 1033024, 1128971, 1229926, + 1335959, 1447142, 1563542, 1685229, 1812268, 1944725, 2082664, 2226148, + 2375238, 2529996, 2690481, 2856753, 3028870, 3206888, 3390865, 3580856, + 3776916, 3979100, 4187460, 4402049, 4622919, 4850123, 5083710, 5323731, + 5570236, 5823273, 6082892, 6349140, 6622065, 6901714, 7188133, 7481369, + 7781466, 8088471, 8402427, 8723380, 9051372, 9386448, 9728650, 10078021, + 10434603, 10798439, 11169569, 11548036, 11933879, 12327139, 12727857, 13136073, + 13551826, 13975156, 14406100, 14844697, 15290987, 15745007, 16206795, 16676389, + 17153826, 17639142, 18132374, 18633560, 19142734, 19659934, 20185196, 20718552, + 21260042, 21809696, 22367554, 22933648, 23508010, 24090680, 24681686, 25281066, + 25888850, 26505076, 27129772, 27762974, 28404716, 29055026, 29713942, 30381490, + 31057708, 31742624, 32436272, 33138682, 33849884, 34569912, 35298800, 36036568, + 36783260, 37538896, 38303512, 39077136, 39859796, 40651528, 41452360, 42262316, + 43081432, 43909732, 44747252, 45594016, 46450052, 47315392, 48190064, 49074096, + 49967516, 50870356, 51782636, 52704392, 53635648, 54576432, 55526772, 56486700, + 57456236, 58435408, 59424248, 60422780, 61431036, 62449032, 63476804, 64514376, + 65561776, 66619028, 67686160, 68763192, 69850160, 70947088, 72053992, 73170912, + 74297864, 75434880, 76581976, 77739184, 78906536, 80084040, 81271736, 82469648, + 83677792, 84896192, 86124888, 87363888, 88613232, 89872928, 91143016, 92423512, + 93714432, 95015816, 96327688, 97650056, 98982952, 100326408, 101680440, 103045072, + 104420320, 105806224, 107202800, 108610064, 110028048, 111456776, 112896264, 114346544, + 115807632, 117279552, 118762328, 120255976, 121760536, 123276016, 124802440, 126339832, + 127888216, 129447616, 131018048, 132599544, 134192112, 135795792, 137410592, 139036528, + 140673648, 142321952, 143981456, 145652208, 147334208, 149027488, 150732064, 152447968, + 154175200, 155913792, 157663776, 159425168, 161197984, 162982240, 164777968, 166585184, + 168403904, 170234160, 172075968, 173929344, 175794320, 177670896, 179559120, 181458992, + 183370528, 185293776, 187228736, 189175424, 191133888, 193104112, 195086128, 197079968, + 199085648, 201103184, 203132592, 205173888, 207227120, 209292272, 211369392, 213458480, + 215559568, 217672656, 219797792, 221934976, 224084240, 226245600, 228419056, 230604656, + 232802400, 235012320, 237234432, 239468736, 241715280, 243974080, 246245120, 248528464, + 250824112, 253132064, 255452368, 257785040, 260130080, 262487520, 264857376, 267239664, +}; + +static stbir_uint8 stbir__linear_to_srgb_uchar(float f) +{ + int x = (int) (f * (1 << 28)); // has headroom so you don't need to clamp + int v = 0; + int i; + + // Refine the guess with a short binary search. + i = v + 128; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 64; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 32; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 16; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 8; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 4; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 2; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + i = v + 1; if (x >= stbir__srgb_offset_to_linear_scaled[i]) v = i; + + return (stbir_uint8) v; +} +#endif + +static float stbir__filter_trapezoid(float x, float scale) +{ + float halfscale = scale / 2; + float t = 0.5f + halfscale; + STBIR_ASSERT(scale <= 1); + + x = (float)fabs(x); + + if (x >= t) + return 0; + else + { + float r = 0.5f - halfscale; + if (x <= r) + return 1; + else + return (t - x) / scale; + } +} + +static float stbir__support_trapezoid(float scale) +{ + STBIR_ASSERT(scale <= 1); + return 0.5f + scale / 2; +} + +static float stbir__filter_triangle(float x, float s) +{ + STBIR__UNUSED_PARAM(s); + + x = (float)fabs(x); + + if (x <= 1.0f) + return 1 - x; + else + return 0; +} + +static float stbir__filter_cubic(float x, float s) +{ + STBIR__UNUSED_PARAM(s); + + x = (float)fabs(x); + + if (x < 1.0f) + return (4 + x*x*(3*x - 6))/6; + else if (x < 2.0f) + return (8 + x*(-12 + x*(6 - x)))/6; + + return (0.0f); +} + +static float stbir__filter_catmullrom(float x, float s) +{ + STBIR__UNUSED_PARAM(s); + + x = (float)fabs(x); + + if (x < 1.0f) + return 1 - x*x*(2.5f - 1.5f*x); + else if (x < 2.0f) + return 2 - x*(4 + x*(0.5f*x - 2.5f)); + + return (0.0f); +} + +static float stbir__filter_mitchell(float x, float s) +{ + STBIR__UNUSED_PARAM(s); + + x = (float)fabs(x); + + if (x < 1.0f) + return (16 + x*x*(21 * x - 36))/18; + else if (x < 2.0f) + return (32 + x*(-60 + x*(36 - 7*x)))/18; + + return (0.0f); +} + +static float stbir__support_zero(float s) +{ + STBIR__UNUSED_PARAM(s); + return 0; +} + +static float stbir__support_one(float s) +{ + STBIR__UNUSED_PARAM(s); + return 1; +} + +static float stbir__support_two(float s) +{ + STBIR__UNUSED_PARAM(s); + return 2; +} + +static stbir__filter_info stbir__filter_info_table[] = { + { NULL, stbir__support_zero }, + { stbir__filter_trapezoid, stbir__support_trapezoid }, + { stbir__filter_triangle, stbir__support_one }, + { stbir__filter_cubic, stbir__support_two }, + { stbir__filter_catmullrom, stbir__support_two }, + { stbir__filter_mitchell, stbir__support_two }, +}; + +stbir__inline static int stbir__use_upsampling(float ratio) +{ + return ratio > 1; +} + +stbir__inline static int stbir__use_width_upsampling(stbir__info* stbir_info) +{ + return stbir__use_upsampling(stbir_info->horizontal_scale); +} + +stbir__inline static int stbir__use_height_upsampling(stbir__info* stbir_info) +{ + return stbir__use_upsampling(stbir_info->vertical_scale); +} + +// This is the maximum number of input samples that can affect an output sample +// with the given filter +static int stbir__get_filter_pixel_width(stbir_filter filter, float scale) +{ + STBIR_ASSERT(filter != 0); + STBIR_ASSERT(filter < STBIR__ARRAY_SIZE(stbir__filter_info_table)); + + if (stbir__use_upsampling(scale)) + return (int)ceil(stbir__filter_info_table[filter].support(1/scale) * 2); + else + return (int)ceil(stbir__filter_info_table[filter].support(scale) * 2 / scale); +} + +// This is how much to expand buffers to account for filters seeking outside +// the image boundaries. +static int stbir__get_filter_pixel_margin(stbir_filter filter, float scale) +{ + return stbir__get_filter_pixel_width(filter, scale) / 2; +} + +static int stbir__get_coefficient_width(stbir_filter filter, float scale) +{ + if (stbir__use_upsampling(scale)) + return (int)ceil(stbir__filter_info_table[filter].support(1 / scale) * 2); + else + return (int)ceil(stbir__filter_info_table[filter].support(scale) * 2); +} + +static int stbir__get_contributors(float scale, stbir_filter filter, int input_size, int output_size) +{ + if (stbir__use_upsampling(scale)) + return output_size; + else + return (input_size + stbir__get_filter_pixel_margin(filter, scale) * 2); +} + +static int stbir__get_total_horizontal_coefficients(stbir__info* info) +{ + return info->horizontal_num_contributors + * stbir__get_coefficient_width (info->horizontal_filter, info->horizontal_scale); +} + +static int stbir__get_total_vertical_coefficients(stbir__info* info) +{ + return info->vertical_num_contributors + * stbir__get_coefficient_width (info->vertical_filter, info->vertical_scale); +} + +static stbir__contributors* stbir__get_contributor(stbir__contributors* contributors, int n) +{ + return &contributors[n]; +} + +// For perf reasons this code is duplicated in stbir__resample_horizontal_upsample/downsample, +// if you change it here change it there too. +static float* stbir__get_coefficient(float* coefficients, stbir_filter filter, float scale, int n, int c) +{ + int width = stbir__get_coefficient_width(filter, scale); + return &coefficients[width*n + c]; +} + +static int stbir__edge_wrap_slow(stbir_edge edge, int n, int max) +{ + switch (edge) + { + case STBIR_EDGE_ZERO: + return 0; // we'll decode the wrong pixel here, and then overwrite with 0s later + + case STBIR_EDGE_CLAMP: + if (n < 0) + return 0; + + if (n >= max) + return max - 1; + + return n; // NOTREACHED + + case STBIR_EDGE_REFLECT: + { + if (n < 0) + { + if (n < max) + return -n; + else + return max - 1; + } + + if (n >= max) + { + int max2 = max * 2; + if (n >= max2) + return 0; + else + return max2 - n - 1; + } + + return n; // NOTREACHED + } + + case STBIR_EDGE_WRAP: + if (n >= 0) + return (n % max); + else + { + int m = (-n) % max; + + if (m != 0) + m = max - m; + + return (m); + } + // NOTREACHED + + default: + STBIR_ASSERT(!"Unimplemented edge type"); + return 0; + } +} + +stbir__inline static int stbir__edge_wrap(stbir_edge edge, int n, int max) +{ + // avoid per-pixel switch + if (n >= 0 && n < max) + return n; + return stbir__edge_wrap_slow(edge, n, max); +} + +// What input pixels contribute to this output pixel? +static void stbir__calculate_sample_range_upsample(int n, float out_filter_radius, float scale_ratio, float out_shift, int* in_first_pixel, int* in_last_pixel, float* in_center_of_out) +{ + float out_pixel_center = (float)n + 0.5f; + float out_pixel_influence_lowerbound = out_pixel_center - out_filter_radius; + float out_pixel_influence_upperbound = out_pixel_center + out_filter_radius; + + float in_pixel_influence_lowerbound = (out_pixel_influence_lowerbound + out_shift) / scale_ratio; + float in_pixel_influence_upperbound = (out_pixel_influence_upperbound + out_shift) / scale_ratio; + + *in_center_of_out = (out_pixel_center + out_shift) / scale_ratio; + *in_first_pixel = (int)(floor(in_pixel_influence_lowerbound + 0.5)); + *in_last_pixel = (int)(floor(in_pixel_influence_upperbound - 0.5)); +} + +// What output pixels does this input pixel contribute to? +static void stbir__calculate_sample_range_downsample(int n, float in_pixels_radius, float scale_ratio, float out_shift, int* out_first_pixel, int* out_last_pixel, float* out_center_of_in) +{ + float in_pixel_center = (float)n + 0.5f; + float in_pixel_influence_lowerbound = in_pixel_center - in_pixels_radius; + float in_pixel_influence_upperbound = in_pixel_center + in_pixels_radius; + + float out_pixel_influence_lowerbound = in_pixel_influence_lowerbound * scale_ratio - out_shift; + float out_pixel_influence_upperbound = in_pixel_influence_upperbound * scale_ratio - out_shift; + + *out_center_of_in = in_pixel_center * scale_ratio - out_shift; + *out_first_pixel = (int)(floor(out_pixel_influence_lowerbound + 0.5)); + *out_last_pixel = (int)(floor(out_pixel_influence_upperbound - 0.5)); +} + +static void stbir__calculate_coefficients_upsample(stbir_filter filter, float scale, int in_first_pixel, int in_last_pixel, float in_center_of_out, stbir__contributors* contributor, float* coefficient_group) +{ + int i; + float total_filter = 0; + float filter_scale; + + STBIR_ASSERT(in_last_pixel - in_first_pixel <= (int)ceil(stbir__filter_info_table[filter].support(1/scale) * 2)); // Taken directly from stbir__get_coefficient_width() which we can't call because we don't know if we're horizontal or vertical. + + contributor->n0 = in_first_pixel; + contributor->n1 = in_last_pixel; + + STBIR_ASSERT(contributor->n1 >= contributor->n0); + + for (i = 0; i <= in_last_pixel - in_first_pixel; i++) + { + float in_pixel_center = (float)(i + in_first_pixel) + 0.5f; + coefficient_group[i] = stbir__filter_info_table[filter].kernel(in_center_of_out - in_pixel_center, 1 / scale); + + // If the coefficient is zero, skip it. (Don't do the <0 check here, we want the influence of those outside pixels.) + if (i == 0 && !coefficient_group[i]) + { + contributor->n0 = ++in_first_pixel; + i--; + continue; + } + + total_filter += coefficient_group[i]; + } + + // NOTE(fg): Not actually true in general, nor is there any reason to expect it should be. + // It would be true in exact math but is at best approximately true in floating-point math, + // and it would not make sense to try and put actual bounds on this here because it depends + // on the image aspect ratio which can get pretty extreme. + //STBIR_ASSERT(stbir__filter_info_table[filter].kernel((float)(in_last_pixel + 1) + 0.5f - in_center_of_out, 1/scale) == 0); + + STBIR_ASSERT(total_filter > 0.9); + STBIR_ASSERT(total_filter < 1.1f); // Make sure it's not way off. + + // Make sure the sum of all coefficients is 1. + filter_scale = 1 / total_filter; + + for (i = 0; i <= in_last_pixel - in_first_pixel; i++) + coefficient_group[i] *= filter_scale; + + for (i = in_last_pixel - in_first_pixel; i >= 0; i--) + { + if (coefficient_group[i]) + break; + + // This line has no weight. We can skip it. + contributor->n1 = contributor->n0 + i - 1; + } +} + +static void stbir__calculate_coefficients_downsample(stbir_filter filter, float scale_ratio, int out_first_pixel, int out_last_pixel, float out_center_of_in, stbir__contributors* contributor, float* coefficient_group) +{ + int i; + + STBIR_ASSERT(out_last_pixel - out_first_pixel <= (int)ceil(stbir__filter_info_table[filter].support(scale_ratio) * 2)); // Taken directly from stbir__get_coefficient_width() which we can't call because we don't know if we're horizontal or vertical. + + contributor->n0 = out_first_pixel; + contributor->n1 = out_last_pixel; + + STBIR_ASSERT(contributor->n1 >= contributor->n0); + + for (i = 0; i <= out_last_pixel - out_first_pixel; i++) + { + float out_pixel_center = (float)(i + out_first_pixel) + 0.5f; + float x = out_pixel_center - out_center_of_in; + coefficient_group[i] = stbir__filter_info_table[filter].kernel(x, scale_ratio) * scale_ratio; + } + + // NOTE(fg): Not actually true in general, nor is there any reason to expect it should be. + // It would be true in exact math but is at best approximately true in floating-point math, + // and it would not make sense to try and put actual bounds on this here because it depends + // on the image aspect ratio which can get pretty extreme. + //STBIR_ASSERT(stbir__filter_info_table[filter].kernel((float)(out_last_pixel + 1) + 0.5f - out_center_of_in, scale_ratio) == 0); + + for (i = out_last_pixel - out_first_pixel; i >= 0; i--) + { + if (coefficient_group[i]) + break; + + // This line has no weight. We can skip it. + contributor->n1 = contributor->n0 + i - 1; + } +} + +static void stbir__normalize_downsample_coefficients(stbir__contributors* contributors, float* coefficients, stbir_filter filter, float scale_ratio, int input_size, int output_size) +{ + int num_contributors = stbir__get_contributors(scale_ratio, filter, input_size, output_size); + int num_coefficients = stbir__get_coefficient_width(filter, scale_ratio); + int i, j; + int skip; + + for (i = 0; i < output_size; i++) + { + float scale; + float total = 0; + + for (j = 0; j < num_contributors; j++) + { + if (i >= contributors[j].n0 && i <= contributors[j].n1) + { + float coefficient = *stbir__get_coefficient(coefficients, filter, scale_ratio, j, i - contributors[j].n0); + total += coefficient; + } + else if (i < contributors[j].n0) + break; + } + + STBIR_ASSERT(total > 0.9f); + STBIR_ASSERT(total < 1.1f); + + scale = 1 / total; + + for (j = 0; j < num_contributors; j++) + { + if (i >= contributors[j].n0 && i <= contributors[j].n1) + *stbir__get_coefficient(coefficients, filter, scale_ratio, j, i - contributors[j].n0) *= scale; + else if (i < contributors[j].n0) + break; + } + } + + // Optimize: Skip zero coefficients and contributions outside of image bounds. + // Do this after normalizing because normalization depends on the n0/n1 values. + for (j = 0; j < num_contributors; j++) + { + int range, max, width; + + skip = 0; + while (*stbir__get_coefficient(coefficients, filter, scale_ratio, j, skip) == 0) + skip++; + + contributors[j].n0 += skip; + + while (contributors[j].n0 < 0) + { + contributors[j].n0++; + skip++; + } + + range = contributors[j].n1 - contributors[j].n0 + 1; + max = stbir__min(num_coefficients, range); + + width = stbir__get_coefficient_width(filter, scale_ratio); + for (i = 0; i < max; i++) + { + if (i + skip >= width) + break; + + *stbir__get_coefficient(coefficients, filter, scale_ratio, j, i) = *stbir__get_coefficient(coefficients, filter, scale_ratio, j, i + skip); + } + + continue; + } + + // Using min to avoid writing into invalid pixels. + for (i = 0; i < num_contributors; i++) + contributors[i].n1 = stbir__min(contributors[i].n1, output_size - 1); +} + +// Each scan line uses the same kernel values so we should calculate the kernel +// values once and then we can use them for every scan line. +static void stbir__calculate_filters(stbir__contributors* contributors, float* coefficients, stbir_filter filter, float scale_ratio, float shift, int input_size, int output_size) +{ + int n; + int total_contributors = stbir__get_contributors(scale_ratio, filter, input_size, output_size); + + if (stbir__use_upsampling(scale_ratio)) + { + float out_pixels_radius = stbir__filter_info_table[filter].support(1 / scale_ratio) * scale_ratio; + + // Looping through out pixels + for (n = 0; n < total_contributors; n++) + { + float in_center_of_out; // Center of the current out pixel in the in pixel space + int in_first_pixel, in_last_pixel; + + stbir__calculate_sample_range_upsample(n, out_pixels_radius, scale_ratio, shift, &in_first_pixel, &in_last_pixel, &in_center_of_out); + + stbir__calculate_coefficients_upsample(filter, scale_ratio, in_first_pixel, in_last_pixel, in_center_of_out, stbir__get_contributor(contributors, n), stbir__get_coefficient(coefficients, filter, scale_ratio, n, 0)); + } + } + else + { + float in_pixels_radius = stbir__filter_info_table[filter].support(scale_ratio) / scale_ratio; + + // Looping through in pixels + for (n = 0; n < total_contributors; n++) + { + float out_center_of_in; // Center of the current out pixel in the in pixel space + int out_first_pixel, out_last_pixel; + int n_adjusted = n - stbir__get_filter_pixel_margin(filter, scale_ratio); + + stbir__calculate_sample_range_downsample(n_adjusted, in_pixels_radius, scale_ratio, shift, &out_first_pixel, &out_last_pixel, &out_center_of_in); + + stbir__calculate_coefficients_downsample(filter, scale_ratio, out_first_pixel, out_last_pixel, out_center_of_in, stbir__get_contributor(contributors, n), stbir__get_coefficient(coefficients, filter, scale_ratio, n, 0)); + } + + stbir__normalize_downsample_coefficients(contributors, coefficients, filter, scale_ratio, input_size, output_size); + } +} + +static float* stbir__get_decode_buffer(stbir__info* stbir_info) +{ + // The 0 index of the decode buffer starts after the margin. This makes + // it okay to use negative indexes on the decode buffer. + return &stbir_info->decode_buffer[stbir_info->horizontal_filter_pixel_margin * stbir_info->channels]; +} + +#define STBIR__DECODE(type, colorspace) ((int)(type) * (STBIR_MAX_COLORSPACES) + (int)(colorspace)) + +static void stbir__decode_scanline(stbir__info* stbir_info, int n) +{ + int c; + int channels = stbir_info->channels; + int alpha_channel = stbir_info->alpha_channel; + int type = stbir_info->type; + int colorspace = stbir_info->colorspace; + int input_w = stbir_info->input_w; + size_t input_stride_bytes = stbir_info->input_stride_bytes; + float* decode_buffer = stbir__get_decode_buffer(stbir_info); + stbir_edge edge_horizontal = stbir_info->edge_horizontal; + stbir_edge edge_vertical = stbir_info->edge_vertical; + size_t in_buffer_row_offset = stbir__edge_wrap(edge_vertical, n, stbir_info->input_h) * input_stride_bytes; + const void* input_data = (char *) stbir_info->input_data + in_buffer_row_offset; + int max_x = input_w + stbir_info->horizontal_filter_pixel_margin; + int decode = STBIR__DECODE(type, colorspace); + + int x = -stbir_info->horizontal_filter_pixel_margin; + + // special handling for STBIR_EDGE_ZERO because it needs to return an item that doesn't appear in the input, + // and we want to avoid paying overhead on every pixel if not STBIR_EDGE_ZERO + if (edge_vertical == STBIR_EDGE_ZERO && (n < 0 || n >= stbir_info->input_h)) + { + for (; x < max_x; x++) + for (c = 0; c < channels; c++) + decode_buffer[x*channels + c] = 0; + return; + } + + switch (decode) + { + case STBIR__DECODE(STBIR_TYPE_UINT8, STBIR_COLORSPACE_LINEAR): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = ((float)((const unsigned char*)input_data)[input_pixel_index + c]) / stbir__max_uint8_as_float; + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT8, STBIR_COLORSPACE_SRGB): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = stbir__srgb_uchar_to_linear_float[((const unsigned char*)input_data)[input_pixel_index + c]]; + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + decode_buffer[decode_pixel_index + alpha_channel] = ((float)((const unsigned char*)input_data)[input_pixel_index + alpha_channel]) / stbir__max_uint8_as_float; + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT16, STBIR_COLORSPACE_LINEAR): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = ((float)((const unsigned short*)input_data)[input_pixel_index + c]) / stbir__max_uint16_as_float; + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT16, STBIR_COLORSPACE_SRGB): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = stbir__srgb_to_linear(((float)((const unsigned short*)input_data)[input_pixel_index + c]) / stbir__max_uint16_as_float); + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + decode_buffer[decode_pixel_index + alpha_channel] = ((float)((const unsigned short*)input_data)[input_pixel_index + alpha_channel]) / stbir__max_uint16_as_float; + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT32, STBIR_COLORSPACE_LINEAR): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = (float)(((double)((const unsigned int*)input_data)[input_pixel_index + c]) / stbir__max_uint32_as_float); + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT32, STBIR_COLORSPACE_SRGB): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = stbir__srgb_to_linear((float)(((double)((const unsigned int*)input_data)[input_pixel_index + c]) / stbir__max_uint32_as_float)); + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + decode_buffer[decode_pixel_index + alpha_channel] = (float)(((double)((const unsigned int*)input_data)[input_pixel_index + alpha_channel]) / stbir__max_uint32_as_float); + } + break; + + case STBIR__DECODE(STBIR_TYPE_FLOAT, STBIR_COLORSPACE_LINEAR): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = ((const float*)input_data)[input_pixel_index + c]; + } + break; + + case STBIR__DECODE(STBIR_TYPE_FLOAT, STBIR_COLORSPACE_SRGB): + for (; x < max_x; x++) + { + int decode_pixel_index = x * channels; + int input_pixel_index = stbir__edge_wrap(edge_horizontal, x, input_w) * channels; + for (c = 0; c < channels; c++) + decode_buffer[decode_pixel_index + c] = stbir__srgb_to_linear(((const float*)input_data)[input_pixel_index + c]); + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + decode_buffer[decode_pixel_index + alpha_channel] = ((const float*)input_data)[input_pixel_index + alpha_channel]; + } + + break; + + default: + STBIR_ASSERT(!"Unknown type/colorspace/channels combination."); + break; + } + + if (!(stbir_info->flags & STBIR_FLAG_ALPHA_PREMULTIPLIED)) + { + for (x = -stbir_info->horizontal_filter_pixel_margin; x < max_x; x++) + { + int decode_pixel_index = x * channels; + + // If the alpha value is 0 it will clobber the color values. Make sure it's not. + float alpha = decode_buffer[decode_pixel_index + alpha_channel]; +#ifndef STBIR_NO_ALPHA_EPSILON + if (stbir_info->type != STBIR_TYPE_FLOAT) { + alpha += STBIR_ALPHA_EPSILON; + decode_buffer[decode_pixel_index + alpha_channel] = alpha; + } +#endif + for (c = 0; c < channels; c++) + { + if (c == alpha_channel) + continue; + + decode_buffer[decode_pixel_index + c] *= alpha; + } + } + } + + if (edge_horizontal == STBIR_EDGE_ZERO) + { + for (x = -stbir_info->horizontal_filter_pixel_margin; x < 0; x++) + { + for (c = 0; c < channels; c++) + decode_buffer[x*channels + c] = 0; + } + for (x = input_w; x < max_x; x++) + { + for (c = 0; c < channels; c++) + decode_buffer[x*channels + c] = 0; + } + } +} + +static float* stbir__get_ring_buffer_entry(float* ring_buffer, int index, int ring_buffer_length) +{ + return &ring_buffer[index * ring_buffer_length]; +} + +static float* stbir__add_empty_ring_buffer_entry(stbir__info* stbir_info, int n) +{ + int ring_buffer_index; + float* ring_buffer; + + stbir_info->ring_buffer_last_scanline = n; + + if (stbir_info->ring_buffer_begin_index < 0) + { + ring_buffer_index = stbir_info->ring_buffer_begin_index = 0; + stbir_info->ring_buffer_first_scanline = n; + } + else + { + ring_buffer_index = (stbir_info->ring_buffer_begin_index + (stbir_info->ring_buffer_last_scanline - stbir_info->ring_buffer_first_scanline)) % stbir_info->ring_buffer_num_entries; + STBIR_ASSERT(ring_buffer_index != stbir_info->ring_buffer_begin_index); + } + + ring_buffer = stbir__get_ring_buffer_entry(stbir_info->ring_buffer, ring_buffer_index, stbir_info->ring_buffer_length_bytes / sizeof(float)); + memset(ring_buffer, 0, stbir_info->ring_buffer_length_bytes); + + return ring_buffer; +} + + +static void stbir__resample_horizontal_upsample(stbir__info* stbir_info, float* output_buffer) +{ + int x, k; + int output_w = stbir_info->output_w; + int channels = stbir_info->channels; + float* decode_buffer = stbir__get_decode_buffer(stbir_info); + stbir__contributors* horizontal_contributors = stbir_info->horizontal_contributors; + float* horizontal_coefficients = stbir_info->horizontal_coefficients; + int coefficient_width = stbir_info->horizontal_coefficient_width; + + for (x = 0; x < output_w; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int out_pixel_index = x * channels; + int coefficient_group = coefficient_width * x; + int coefficient_counter = 0; + + STBIR_ASSERT(n1 >= n0); + STBIR_ASSERT(n0 >= -stbir_info->horizontal_filter_pixel_margin); + STBIR_ASSERT(n1 >= -stbir_info->horizontal_filter_pixel_margin); + STBIR_ASSERT(n0 < stbir_info->input_w + stbir_info->horizontal_filter_pixel_margin); + STBIR_ASSERT(n1 < stbir_info->input_w + stbir_info->horizontal_filter_pixel_margin); + + switch (channels) { + case 1: + for (k = n0; k <= n1; k++) + { + int in_pixel_index = k * 1; + float coefficient = horizontal_coefficients[coefficient_group + coefficient_counter++]; + STBIR_ASSERT(coefficient != 0); + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + } + break; + case 2: + for (k = n0; k <= n1; k++) + { + int in_pixel_index = k * 2; + float coefficient = horizontal_coefficients[coefficient_group + coefficient_counter++]; + STBIR_ASSERT(coefficient != 0); + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + } + break; + case 3: + for (k = n0; k <= n1; k++) + { + int in_pixel_index = k * 3; + float coefficient = horizontal_coefficients[coefficient_group + coefficient_counter++]; + STBIR_ASSERT(coefficient != 0); + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + output_buffer[out_pixel_index + 2] += decode_buffer[in_pixel_index + 2] * coefficient; + } + break; + case 4: + for (k = n0; k <= n1; k++) + { + int in_pixel_index = k * 4; + float coefficient = horizontal_coefficients[coefficient_group + coefficient_counter++]; + STBIR_ASSERT(coefficient != 0); + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + output_buffer[out_pixel_index + 2] += decode_buffer[in_pixel_index + 2] * coefficient; + output_buffer[out_pixel_index + 3] += decode_buffer[in_pixel_index + 3] * coefficient; + } + break; + default: + for (k = n0; k <= n1; k++) + { + int in_pixel_index = k * channels; + float coefficient = horizontal_coefficients[coefficient_group + coefficient_counter++]; + int c; + STBIR_ASSERT(coefficient != 0); + for (c = 0; c < channels; c++) + output_buffer[out_pixel_index + c] += decode_buffer[in_pixel_index + c] * coefficient; + } + break; + } + } +} + +static void stbir__resample_horizontal_downsample(stbir__info* stbir_info, float* output_buffer) +{ + int x, k; + int input_w = stbir_info->input_w; + int channels = stbir_info->channels; + float* decode_buffer = stbir__get_decode_buffer(stbir_info); + stbir__contributors* horizontal_contributors = stbir_info->horizontal_contributors; + float* horizontal_coefficients = stbir_info->horizontal_coefficients; + int coefficient_width = stbir_info->horizontal_coefficient_width; + int filter_pixel_margin = stbir_info->horizontal_filter_pixel_margin; + int max_x = input_w + filter_pixel_margin * 2; + + STBIR_ASSERT(!stbir__use_width_upsampling(stbir_info)); + + switch (channels) { + case 1: + for (x = 0; x < max_x; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int in_x = x - filter_pixel_margin; + int in_pixel_index = in_x * 1; + int max_n = n1; + int coefficient_group = coefficient_width * x; + + for (k = n0; k <= max_n; k++) + { + int out_pixel_index = k * 1; + float coefficient = horizontal_coefficients[coefficient_group + k - n0]; + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + } + } + break; + + case 2: + for (x = 0; x < max_x; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int in_x = x - filter_pixel_margin; + int in_pixel_index = in_x * 2; + int max_n = n1; + int coefficient_group = coefficient_width * x; + + for (k = n0; k <= max_n; k++) + { + int out_pixel_index = k * 2; + float coefficient = horizontal_coefficients[coefficient_group + k - n0]; + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + } + } + break; + + case 3: + for (x = 0; x < max_x; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int in_x = x - filter_pixel_margin; + int in_pixel_index = in_x * 3; + int max_n = n1; + int coefficient_group = coefficient_width * x; + + for (k = n0; k <= max_n; k++) + { + int out_pixel_index = k * 3; + float coefficient = horizontal_coefficients[coefficient_group + k - n0]; + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + output_buffer[out_pixel_index + 2] += decode_buffer[in_pixel_index + 2] * coefficient; + } + } + break; + + case 4: + for (x = 0; x < max_x; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int in_x = x - filter_pixel_margin; + int in_pixel_index = in_x * 4; + int max_n = n1; + int coefficient_group = coefficient_width * x; + + for (k = n0; k <= max_n; k++) + { + int out_pixel_index = k * 4; + float coefficient = horizontal_coefficients[coefficient_group + k - n0]; + output_buffer[out_pixel_index + 0] += decode_buffer[in_pixel_index + 0] * coefficient; + output_buffer[out_pixel_index + 1] += decode_buffer[in_pixel_index + 1] * coefficient; + output_buffer[out_pixel_index + 2] += decode_buffer[in_pixel_index + 2] * coefficient; + output_buffer[out_pixel_index + 3] += decode_buffer[in_pixel_index + 3] * coefficient; + } + } + break; + + default: + for (x = 0; x < max_x; x++) + { + int n0 = horizontal_contributors[x].n0; + int n1 = horizontal_contributors[x].n1; + + int in_x = x - filter_pixel_margin; + int in_pixel_index = in_x * channels; + int max_n = n1; + int coefficient_group = coefficient_width * x; + + for (k = n0; k <= max_n; k++) + { + int c; + int out_pixel_index = k * channels; + float coefficient = horizontal_coefficients[coefficient_group + k - n0]; + for (c = 0; c < channels; c++) + output_buffer[out_pixel_index + c] += decode_buffer[in_pixel_index + c] * coefficient; + } + } + break; + } +} + +static void stbir__decode_and_resample_upsample(stbir__info* stbir_info, int n) +{ + // Decode the nth scanline from the source image into the decode buffer. + stbir__decode_scanline(stbir_info, n); + + // Now resample it into the ring buffer. + if (stbir__use_width_upsampling(stbir_info)) + stbir__resample_horizontal_upsample(stbir_info, stbir__add_empty_ring_buffer_entry(stbir_info, n)); + else + stbir__resample_horizontal_downsample(stbir_info, stbir__add_empty_ring_buffer_entry(stbir_info, n)); + + // Now it's sitting in the ring buffer ready to be used as source for the vertical sampling. +} + +static void stbir__decode_and_resample_downsample(stbir__info* stbir_info, int n) +{ + // Decode the nth scanline from the source image into the decode buffer. + stbir__decode_scanline(stbir_info, n); + + memset(stbir_info->horizontal_buffer, 0, stbir_info->output_w * stbir_info->channels * sizeof(float)); + + // Now resample it into the horizontal buffer. + if (stbir__use_width_upsampling(stbir_info)) + stbir__resample_horizontal_upsample(stbir_info, stbir_info->horizontal_buffer); + else + stbir__resample_horizontal_downsample(stbir_info, stbir_info->horizontal_buffer); + + // Now it's sitting in the horizontal buffer ready to be distributed into the ring buffers. +} + +// Get the specified scan line from the ring buffer. +static float* stbir__get_ring_buffer_scanline(int get_scanline, float* ring_buffer, int begin_index, int first_scanline, int ring_buffer_num_entries, int ring_buffer_length) +{ + int ring_buffer_index = (begin_index + (get_scanline - first_scanline)) % ring_buffer_num_entries; + return stbir__get_ring_buffer_entry(ring_buffer, ring_buffer_index, ring_buffer_length); +} + + +static void stbir__encode_scanline(stbir__info* stbir_info, int num_pixels, void *output_buffer, float *encode_buffer, int channels, int alpha_channel, int decode) +{ + int x; + int n; + int num_nonalpha; + stbir_uint16 nonalpha[STBIR_MAX_CHANNELS]; + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_PREMULTIPLIED)) + { + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + float alpha = encode_buffer[pixel_index + alpha_channel]; + float reciprocal_alpha = alpha ? 1.0f / alpha : 0; + + // unrolling this produced a 1% slowdown upscaling a large RGBA linear-space image on my machine - stb + for (n = 0; n < channels; n++) + if (n != alpha_channel) + encode_buffer[pixel_index + n] *= reciprocal_alpha; + + // We added in a small epsilon to prevent the color channel from being deleted with zero alpha. + // Because we only add it for integer types, it will automatically be discarded on integer + // conversion, so we don't need to subtract it back out (which would be problematic for + // numeric precision reasons). + } + } + + // build a table of all channels that need colorspace correction, so + // we don't perform colorspace correction on channels that don't need it. + for (x = 0, num_nonalpha = 0; x < channels; ++x) + { + if (x != alpha_channel || (stbir_info->flags & STBIR_FLAG_ALPHA_USES_COLORSPACE)) + { + nonalpha[num_nonalpha++] = (stbir_uint16)x; + } + } + + #define STBIR__ROUND_INT(f) ((int) ((f)+0.5)) + #define STBIR__ROUND_UINT(f) ((stbir_uint32) ((f)+0.5)) + + #ifdef STBIR__SATURATE_INT + #define STBIR__ENCODE_LINEAR8(f) stbir__saturate8 (STBIR__ROUND_INT((f) * stbir__max_uint8_as_float )) + #define STBIR__ENCODE_LINEAR16(f) stbir__saturate16(STBIR__ROUND_INT((f) * stbir__max_uint16_as_float)) + #else + #define STBIR__ENCODE_LINEAR8(f) (unsigned char ) STBIR__ROUND_INT(stbir__saturate(f) * stbir__max_uint8_as_float ) + #define STBIR__ENCODE_LINEAR16(f) (unsigned short) STBIR__ROUND_INT(stbir__saturate(f) * stbir__max_uint16_as_float) + #endif + + switch (decode) + { + case STBIR__DECODE(STBIR_TYPE_UINT8, STBIR_COLORSPACE_LINEAR): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < channels; n++) + { + int index = pixel_index + n; + ((unsigned char*)output_buffer)[index] = STBIR__ENCODE_LINEAR8(encode_buffer[index]); + } + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT8, STBIR_COLORSPACE_SRGB): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < num_nonalpha; n++) + { + int index = pixel_index + nonalpha[n]; + ((unsigned char*)output_buffer)[index] = stbir__linear_to_srgb_uchar(encode_buffer[index]); + } + + if (!(stbir_info->flags & STBIR_FLAG_ALPHA_USES_COLORSPACE)) + ((unsigned char *)output_buffer)[pixel_index + alpha_channel] = STBIR__ENCODE_LINEAR8(encode_buffer[pixel_index+alpha_channel]); + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT16, STBIR_COLORSPACE_LINEAR): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < channels; n++) + { + int index = pixel_index + n; + ((unsigned short*)output_buffer)[index] = STBIR__ENCODE_LINEAR16(encode_buffer[index]); + } + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT16, STBIR_COLORSPACE_SRGB): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < num_nonalpha; n++) + { + int index = pixel_index + nonalpha[n]; + ((unsigned short*)output_buffer)[index] = (unsigned short)STBIR__ROUND_INT(stbir__linear_to_srgb(stbir__saturate(encode_buffer[index])) * stbir__max_uint16_as_float); + } + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + ((unsigned short*)output_buffer)[pixel_index + alpha_channel] = STBIR__ENCODE_LINEAR16(encode_buffer[pixel_index + alpha_channel]); + } + + break; + + case STBIR__DECODE(STBIR_TYPE_UINT32, STBIR_COLORSPACE_LINEAR): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < channels; n++) + { + int index = pixel_index + n; + ((unsigned int*)output_buffer)[index] = (unsigned int)STBIR__ROUND_UINT(((double)stbir__saturate(encode_buffer[index])) * stbir__max_uint32_as_float); + } + } + break; + + case STBIR__DECODE(STBIR_TYPE_UINT32, STBIR_COLORSPACE_SRGB): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < num_nonalpha; n++) + { + int index = pixel_index + nonalpha[n]; + ((unsigned int*)output_buffer)[index] = (unsigned int)STBIR__ROUND_UINT(((double)stbir__linear_to_srgb(stbir__saturate(encode_buffer[index]))) * stbir__max_uint32_as_float); + } + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + ((unsigned int*)output_buffer)[pixel_index + alpha_channel] = (unsigned int)STBIR__ROUND_INT(((double)stbir__saturate(encode_buffer[pixel_index + alpha_channel])) * stbir__max_uint32_as_float); + } + break; + + case STBIR__DECODE(STBIR_TYPE_FLOAT, STBIR_COLORSPACE_LINEAR): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < channels; n++) + { + int index = pixel_index + n; + ((float*)output_buffer)[index] = encode_buffer[index]; + } + } + break; + + case STBIR__DECODE(STBIR_TYPE_FLOAT, STBIR_COLORSPACE_SRGB): + for (x=0; x < num_pixels; ++x) + { + int pixel_index = x*channels; + + for (n = 0; n < num_nonalpha; n++) + { + int index = pixel_index + nonalpha[n]; + ((float*)output_buffer)[index] = stbir__linear_to_srgb(encode_buffer[index]); + } + + if (!(stbir_info->flags&STBIR_FLAG_ALPHA_USES_COLORSPACE)) + ((float*)output_buffer)[pixel_index + alpha_channel] = encode_buffer[pixel_index + alpha_channel]; + } + break; + + default: + STBIR_ASSERT(!"Unknown type/colorspace/channels combination."); + break; + } +} + +static void stbir__resample_vertical_upsample(stbir__info* stbir_info, int n) +{ + int x, k; + int output_w = stbir_info->output_w; + stbir__contributors* vertical_contributors = stbir_info->vertical_contributors; + float* vertical_coefficients = stbir_info->vertical_coefficients; + int channels = stbir_info->channels; + int alpha_channel = stbir_info->alpha_channel; + int type = stbir_info->type; + int colorspace = stbir_info->colorspace; + int ring_buffer_entries = stbir_info->ring_buffer_num_entries; + void* output_data = stbir_info->output_data; + float* encode_buffer = stbir_info->encode_buffer; + int decode = STBIR__DECODE(type, colorspace); + int coefficient_width = stbir_info->vertical_coefficient_width; + int coefficient_counter; + int contributor = n; + + float* ring_buffer = stbir_info->ring_buffer; + int ring_buffer_begin_index = stbir_info->ring_buffer_begin_index; + int ring_buffer_first_scanline = stbir_info->ring_buffer_first_scanline; + int ring_buffer_length = stbir_info->ring_buffer_length_bytes/sizeof(float); + + int n0,n1, output_row_start; + int coefficient_group = coefficient_width * contributor; + + n0 = vertical_contributors[contributor].n0; + n1 = vertical_contributors[contributor].n1; + + output_row_start = n * stbir_info->output_stride_bytes; + + STBIR_ASSERT(stbir__use_height_upsampling(stbir_info)); + + memset(encode_buffer, 0, output_w * sizeof(float) * channels); + + // I tried reblocking this for better cache usage of encode_buffer + // (using x_outer, k, x_inner), but it lost speed. -- stb + + coefficient_counter = 0; + switch (channels) { + case 1: + for (k = n0; k <= n1; k++) + { + int coefficient_index = coefficient_counter++; + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + for (x = 0; x < output_w; ++x) + { + int in_pixel_index = x * 1; + encode_buffer[in_pixel_index + 0] += ring_buffer_entry[in_pixel_index + 0] * coefficient; + } + } + break; + case 2: + for (k = n0; k <= n1; k++) + { + int coefficient_index = coefficient_counter++; + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + for (x = 0; x < output_w; ++x) + { + int in_pixel_index = x * 2; + encode_buffer[in_pixel_index + 0] += ring_buffer_entry[in_pixel_index + 0] * coefficient; + encode_buffer[in_pixel_index + 1] += ring_buffer_entry[in_pixel_index + 1] * coefficient; + } + } + break; + case 3: + for (k = n0; k <= n1; k++) + { + int coefficient_index = coefficient_counter++; + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + for (x = 0; x < output_w; ++x) + { + int in_pixel_index = x * 3; + encode_buffer[in_pixel_index + 0] += ring_buffer_entry[in_pixel_index + 0] * coefficient; + encode_buffer[in_pixel_index + 1] += ring_buffer_entry[in_pixel_index + 1] * coefficient; + encode_buffer[in_pixel_index + 2] += ring_buffer_entry[in_pixel_index + 2] * coefficient; + } + } + break; + case 4: + for (k = n0; k <= n1; k++) + { + int coefficient_index = coefficient_counter++; + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + for (x = 0; x < output_w; ++x) + { + int in_pixel_index = x * 4; + encode_buffer[in_pixel_index + 0] += ring_buffer_entry[in_pixel_index + 0] * coefficient; + encode_buffer[in_pixel_index + 1] += ring_buffer_entry[in_pixel_index + 1] * coefficient; + encode_buffer[in_pixel_index + 2] += ring_buffer_entry[in_pixel_index + 2] * coefficient; + encode_buffer[in_pixel_index + 3] += ring_buffer_entry[in_pixel_index + 3] * coefficient; + } + } + break; + default: + for (k = n0; k <= n1; k++) + { + int coefficient_index = coefficient_counter++; + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + for (x = 0; x < output_w; ++x) + { + int in_pixel_index = x * channels; + int c; + for (c = 0; c < channels; c++) + encode_buffer[in_pixel_index + c] += ring_buffer_entry[in_pixel_index + c] * coefficient; + } + } + break; + } + stbir__encode_scanline(stbir_info, output_w, (char *) output_data + output_row_start, encode_buffer, channels, alpha_channel, decode); +} + +static void stbir__resample_vertical_downsample(stbir__info* stbir_info, int n) +{ + int x, k; + int output_w = stbir_info->output_w; + stbir__contributors* vertical_contributors = stbir_info->vertical_contributors; + float* vertical_coefficients = stbir_info->vertical_coefficients; + int channels = stbir_info->channels; + int ring_buffer_entries = stbir_info->ring_buffer_num_entries; + float* horizontal_buffer = stbir_info->horizontal_buffer; + int coefficient_width = stbir_info->vertical_coefficient_width; + int contributor = n + stbir_info->vertical_filter_pixel_margin; + + float* ring_buffer = stbir_info->ring_buffer; + int ring_buffer_begin_index = stbir_info->ring_buffer_begin_index; + int ring_buffer_first_scanline = stbir_info->ring_buffer_first_scanline; + int ring_buffer_length = stbir_info->ring_buffer_length_bytes/sizeof(float); + int n0,n1; + + n0 = vertical_contributors[contributor].n0; + n1 = vertical_contributors[contributor].n1; + + STBIR_ASSERT(!stbir__use_height_upsampling(stbir_info)); + + for (k = n0; k <= n1; k++) + { + int coefficient_index = k - n0; + int coefficient_group = coefficient_width * contributor; + float coefficient = vertical_coefficients[coefficient_group + coefficient_index]; + + float* ring_buffer_entry = stbir__get_ring_buffer_scanline(k, ring_buffer, ring_buffer_begin_index, ring_buffer_first_scanline, ring_buffer_entries, ring_buffer_length); + + switch (channels) { + case 1: + for (x = 0; x < output_w; x++) + { + int in_pixel_index = x * 1; + ring_buffer_entry[in_pixel_index + 0] += horizontal_buffer[in_pixel_index + 0] * coefficient; + } + break; + case 2: + for (x = 0; x < output_w; x++) + { + int in_pixel_index = x * 2; + ring_buffer_entry[in_pixel_index + 0] += horizontal_buffer[in_pixel_index + 0] * coefficient; + ring_buffer_entry[in_pixel_index + 1] += horizontal_buffer[in_pixel_index + 1] * coefficient; + } + break; + case 3: + for (x = 0; x < output_w; x++) + { + int in_pixel_index = x * 3; + ring_buffer_entry[in_pixel_index + 0] += horizontal_buffer[in_pixel_index + 0] * coefficient; + ring_buffer_entry[in_pixel_index + 1] += horizontal_buffer[in_pixel_index + 1] * coefficient; + ring_buffer_entry[in_pixel_index + 2] += horizontal_buffer[in_pixel_index + 2] * coefficient; + } + break; + case 4: + for (x = 0; x < output_w; x++) + { + int in_pixel_index = x * 4; + ring_buffer_entry[in_pixel_index + 0] += horizontal_buffer[in_pixel_index + 0] * coefficient; + ring_buffer_entry[in_pixel_index + 1] += horizontal_buffer[in_pixel_index + 1] * coefficient; + ring_buffer_entry[in_pixel_index + 2] += horizontal_buffer[in_pixel_index + 2] * coefficient; + ring_buffer_entry[in_pixel_index + 3] += horizontal_buffer[in_pixel_index + 3] * coefficient; + } + break; + default: + for (x = 0; x < output_w; x++) + { + int in_pixel_index = x * channels; + + int c; + for (c = 0; c < channels; c++) + ring_buffer_entry[in_pixel_index + c] += horizontal_buffer[in_pixel_index + c] * coefficient; + } + break; + } + } +} + +static void stbir__buffer_loop_upsample(stbir__info* stbir_info) +{ + int y; + float scale_ratio = stbir_info->vertical_scale; + float out_scanlines_radius = stbir__filter_info_table[stbir_info->vertical_filter].support(1/scale_ratio) * scale_ratio; + + STBIR_ASSERT(stbir__use_height_upsampling(stbir_info)); + + for (y = 0; y < stbir_info->output_h; y++) + { + float in_center_of_out = 0; // Center of the current out scanline in the in scanline space + int in_first_scanline = 0, in_last_scanline = 0; + + stbir__calculate_sample_range_upsample(y, out_scanlines_radius, scale_ratio, stbir_info->vertical_shift, &in_first_scanline, &in_last_scanline, &in_center_of_out); + + STBIR_ASSERT(in_last_scanline - in_first_scanline + 1 <= stbir_info->ring_buffer_num_entries); + + if (stbir_info->ring_buffer_begin_index >= 0) + { + // Get rid of whatever we don't need anymore. + while (in_first_scanline > stbir_info->ring_buffer_first_scanline) + { + if (stbir_info->ring_buffer_first_scanline == stbir_info->ring_buffer_last_scanline) + { + // We just popped the last scanline off the ring buffer. + // Reset it to the empty state. + stbir_info->ring_buffer_begin_index = -1; + stbir_info->ring_buffer_first_scanline = 0; + stbir_info->ring_buffer_last_scanline = 0; + break; + } + else + { + stbir_info->ring_buffer_first_scanline++; + stbir_info->ring_buffer_begin_index = (stbir_info->ring_buffer_begin_index + 1) % stbir_info->ring_buffer_num_entries; + } + } + } + + // Load in new ones. + if (stbir_info->ring_buffer_begin_index < 0) + stbir__decode_and_resample_upsample(stbir_info, in_first_scanline); + + while (in_last_scanline > stbir_info->ring_buffer_last_scanline) + stbir__decode_and_resample_upsample(stbir_info, stbir_info->ring_buffer_last_scanline + 1); + + // Now all buffers should be ready to write a row of vertical sampling. + stbir__resample_vertical_upsample(stbir_info, y); + + STBIR_PROGRESS_REPORT((float)y / stbir_info->output_h); + } +} + +static void stbir__empty_ring_buffer(stbir__info* stbir_info, int first_necessary_scanline) +{ + int output_stride_bytes = stbir_info->output_stride_bytes; + int channels = stbir_info->channels; + int alpha_channel = stbir_info->alpha_channel; + int type = stbir_info->type; + int colorspace = stbir_info->colorspace; + int output_w = stbir_info->output_w; + void* output_data = stbir_info->output_data; + int decode = STBIR__DECODE(type, colorspace); + + float* ring_buffer = stbir_info->ring_buffer; + int ring_buffer_length = stbir_info->ring_buffer_length_bytes/sizeof(float); + + if (stbir_info->ring_buffer_begin_index >= 0) + { + // Get rid of whatever we don't need anymore. + while (first_necessary_scanline > stbir_info->ring_buffer_first_scanline) + { + if (stbir_info->ring_buffer_first_scanline >= 0 && stbir_info->ring_buffer_first_scanline < stbir_info->output_h) + { + int output_row_start = stbir_info->ring_buffer_first_scanline * output_stride_bytes; + float* ring_buffer_entry = stbir__get_ring_buffer_entry(ring_buffer, stbir_info->ring_buffer_begin_index, ring_buffer_length); + stbir__encode_scanline(stbir_info, output_w, (char *) output_data + output_row_start, ring_buffer_entry, channels, alpha_channel, decode); + STBIR_PROGRESS_REPORT((float)stbir_info->ring_buffer_first_scanline / stbir_info->output_h); + } + + if (stbir_info->ring_buffer_first_scanline == stbir_info->ring_buffer_last_scanline) + { + // We just popped the last scanline off the ring buffer. + // Reset it to the empty state. + stbir_info->ring_buffer_begin_index = -1; + stbir_info->ring_buffer_first_scanline = 0; + stbir_info->ring_buffer_last_scanline = 0; + break; + } + else + { + stbir_info->ring_buffer_first_scanline++; + stbir_info->ring_buffer_begin_index = (stbir_info->ring_buffer_begin_index + 1) % stbir_info->ring_buffer_num_entries; + } + } + } +} + +static void stbir__buffer_loop_downsample(stbir__info* stbir_info) +{ + int y; + float scale_ratio = stbir_info->vertical_scale; + int output_h = stbir_info->output_h; + float in_pixels_radius = stbir__filter_info_table[stbir_info->vertical_filter].support(scale_ratio) / scale_ratio; + int pixel_margin = stbir_info->vertical_filter_pixel_margin; + int max_y = stbir_info->input_h + pixel_margin; + + STBIR_ASSERT(!stbir__use_height_upsampling(stbir_info)); + + for (y = -pixel_margin; y < max_y; y++) + { + float out_center_of_in; // Center of the current out scanline in the in scanline space + int out_first_scanline, out_last_scanline; + + stbir__calculate_sample_range_downsample(y, in_pixels_radius, scale_ratio, stbir_info->vertical_shift, &out_first_scanline, &out_last_scanline, &out_center_of_in); + + STBIR_ASSERT(out_last_scanline - out_first_scanline + 1 <= stbir_info->ring_buffer_num_entries); + + if (out_last_scanline < 0 || out_first_scanline >= output_h) + continue; + + stbir__empty_ring_buffer(stbir_info, out_first_scanline); + + stbir__decode_and_resample_downsample(stbir_info, y); + + // Load in new ones. + if (stbir_info->ring_buffer_begin_index < 0) + stbir__add_empty_ring_buffer_entry(stbir_info, out_first_scanline); + + while (out_last_scanline > stbir_info->ring_buffer_last_scanline) + stbir__add_empty_ring_buffer_entry(stbir_info, stbir_info->ring_buffer_last_scanline + 1); + + // Now the horizontal buffer is ready to write to all ring buffer rows. + stbir__resample_vertical_downsample(stbir_info, y); + } + + stbir__empty_ring_buffer(stbir_info, stbir_info->output_h); +} + +static void stbir__setup(stbir__info *info, int input_w, int input_h, int output_w, int output_h, int channels) +{ + info->input_w = input_w; + info->input_h = input_h; + info->output_w = output_w; + info->output_h = output_h; + info->channels = channels; +} + +static void stbir__calculate_transform(stbir__info *info, float s0, float t0, float s1, float t1, float *transform) +{ + info->s0 = s0; + info->t0 = t0; + info->s1 = s1; + info->t1 = t1; + + if (transform) + { + info->horizontal_scale = transform[0]; + info->vertical_scale = transform[1]; + info->horizontal_shift = transform[2]; + info->vertical_shift = transform[3]; + } + else + { + info->horizontal_scale = ((float)info->output_w / info->input_w) / (s1 - s0); + info->vertical_scale = ((float)info->output_h / info->input_h) / (t1 - t0); + + info->horizontal_shift = s0 * info->output_w / (s1 - s0); + info->vertical_shift = t0 * info->output_h / (t1 - t0); + } +} + +static void stbir__choose_filter(stbir__info *info, stbir_filter h_filter, stbir_filter v_filter) +{ + if (h_filter == 0) + h_filter = stbir__use_upsampling(info->horizontal_scale) ? STBIR_DEFAULT_FILTER_UPSAMPLE : STBIR_DEFAULT_FILTER_DOWNSAMPLE; + if (v_filter == 0) + v_filter = stbir__use_upsampling(info->vertical_scale) ? STBIR_DEFAULT_FILTER_UPSAMPLE : STBIR_DEFAULT_FILTER_DOWNSAMPLE; + info->horizontal_filter = h_filter; + info->vertical_filter = v_filter; +} + +static stbir_uint32 stbir__calculate_memory(stbir__info *info) +{ + int pixel_margin = stbir__get_filter_pixel_margin(info->horizontal_filter, info->horizontal_scale); + int filter_height = stbir__get_filter_pixel_width(info->vertical_filter, info->vertical_scale); + + info->horizontal_num_contributors = stbir__get_contributors(info->horizontal_scale, info->horizontal_filter, info->input_w, info->output_w); + info->vertical_num_contributors = stbir__get_contributors(info->vertical_scale , info->vertical_filter , info->input_h, info->output_h); + + // One extra entry because floating point precision problems sometimes cause an extra to be necessary. + info->ring_buffer_num_entries = filter_height + 1; + + info->horizontal_contributors_size = info->horizontal_num_contributors * sizeof(stbir__contributors); + info->horizontal_coefficients_size = stbir__get_total_horizontal_coefficients(info) * sizeof(float); + info->vertical_contributors_size = info->vertical_num_contributors * sizeof(stbir__contributors); + info->vertical_coefficients_size = stbir__get_total_vertical_coefficients(info) * sizeof(float); + info->decode_buffer_size = (info->input_w + pixel_margin * 2) * info->channels * sizeof(float); + info->horizontal_buffer_size = info->output_w * info->channels * sizeof(float); + info->ring_buffer_size = info->output_w * info->channels * info->ring_buffer_num_entries * sizeof(float); + info->encode_buffer_size = info->output_w * info->channels * sizeof(float); + + STBIR_ASSERT(info->horizontal_filter != 0); + STBIR_ASSERT(info->horizontal_filter < STBIR__ARRAY_SIZE(stbir__filter_info_table)); // this now happens too late + STBIR_ASSERT(info->vertical_filter != 0); + STBIR_ASSERT(info->vertical_filter < STBIR__ARRAY_SIZE(stbir__filter_info_table)); // this now happens too late + + if (stbir__use_height_upsampling(info)) + // The horizontal buffer is for when we're downsampling the height and we + // can't output the result of sampling the decode buffer directly into the + // ring buffers. + info->horizontal_buffer_size = 0; + else + // The encode buffer is to retain precision in the height upsampling method + // and isn't used when height downsampling. + info->encode_buffer_size = 0; + + return info->horizontal_contributors_size + info->horizontal_coefficients_size + + info->vertical_contributors_size + info->vertical_coefficients_size + + info->decode_buffer_size + info->horizontal_buffer_size + + info->ring_buffer_size + info->encode_buffer_size; +} + +static int stbir__resize_allocated(stbir__info *info, + const void* input_data, int input_stride_in_bytes, + void* output_data, int output_stride_in_bytes, + int alpha_channel, stbir_uint32 flags, stbir_datatype type, + stbir_edge edge_horizontal, stbir_edge edge_vertical, stbir_colorspace colorspace, + void* tempmem, size_t tempmem_size_in_bytes) +{ + size_t memory_required = stbir__calculate_memory(info); + + int width_stride_input = input_stride_in_bytes ? input_stride_in_bytes : info->channels * info->input_w * stbir__type_size[type]; + int width_stride_output = output_stride_in_bytes ? output_stride_in_bytes : info->channels * info->output_w * stbir__type_size[type]; + +#ifdef STBIR_DEBUG_OVERWRITE_TEST +#define OVERWRITE_ARRAY_SIZE 8 + unsigned char overwrite_output_before_pre[OVERWRITE_ARRAY_SIZE]; + unsigned char overwrite_tempmem_before_pre[OVERWRITE_ARRAY_SIZE]; + unsigned char overwrite_output_after_pre[OVERWRITE_ARRAY_SIZE]; + unsigned char overwrite_tempmem_after_pre[OVERWRITE_ARRAY_SIZE]; + + size_t begin_forbidden = width_stride_output * (info->output_h - 1) + info->output_w * info->channels * stbir__type_size[type]; + memcpy(overwrite_output_before_pre, &((unsigned char*)output_data)[-OVERWRITE_ARRAY_SIZE], OVERWRITE_ARRAY_SIZE); + memcpy(overwrite_output_after_pre, &((unsigned char*)output_data)[begin_forbidden], OVERWRITE_ARRAY_SIZE); + memcpy(overwrite_tempmem_before_pre, &((unsigned char*)tempmem)[-OVERWRITE_ARRAY_SIZE], OVERWRITE_ARRAY_SIZE); + memcpy(overwrite_tempmem_after_pre, &((unsigned char*)tempmem)[tempmem_size_in_bytes], OVERWRITE_ARRAY_SIZE); +#endif + + STBIR_ASSERT(info->channels >= 0); + STBIR_ASSERT(info->channels <= STBIR_MAX_CHANNELS); + + if (info->channels < 0 || info->channels > STBIR_MAX_CHANNELS) + return 0; + + STBIR_ASSERT(info->horizontal_filter < STBIR__ARRAY_SIZE(stbir__filter_info_table)); + STBIR_ASSERT(info->vertical_filter < STBIR__ARRAY_SIZE(stbir__filter_info_table)); + + if (info->horizontal_filter >= STBIR__ARRAY_SIZE(stbir__filter_info_table)) + return 0; + if (info->vertical_filter >= STBIR__ARRAY_SIZE(stbir__filter_info_table)) + return 0; + + if (alpha_channel < 0) + flags |= STBIR_FLAG_ALPHA_USES_COLORSPACE | STBIR_FLAG_ALPHA_PREMULTIPLIED; + + if (!(flags&STBIR_FLAG_ALPHA_USES_COLORSPACE) || !(flags&STBIR_FLAG_ALPHA_PREMULTIPLIED)) { + STBIR_ASSERT(alpha_channel >= 0 && alpha_channel < info->channels); + } + + if (alpha_channel >= info->channels) + return 0; + + STBIR_ASSERT(tempmem); + + if (!tempmem) + return 0; + + STBIR_ASSERT(tempmem_size_in_bytes >= memory_required); + + if (tempmem_size_in_bytes < memory_required) + return 0; + + memset(tempmem, 0, tempmem_size_in_bytes); + + info->input_data = input_data; + info->input_stride_bytes = width_stride_input; + + info->output_data = output_data; + info->output_stride_bytes = width_stride_output; + + info->alpha_channel = alpha_channel; + info->flags = flags; + info->type = type; + info->edge_horizontal = edge_horizontal; + info->edge_vertical = edge_vertical; + info->colorspace = colorspace; + + info->horizontal_coefficient_width = stbir__get_coefficient_width (info->horizontal_filter, info->horizontal_scale); + info->vertical_coefficient_width = stbir__get_coefficient_width (info->vertical_filter , info->vertical_scale ); + info->horizontal_filter_pixel_width = stbir__get_filter_pixel_width (info->horizontal_filter, info->horizontal_scale); + info->vertical_filter_pixel_width = stbir__get_filter_pixel_width (info->vertical_filter , info->vertical_scale ); + info->horizontal_filter_pixel_margin = stbir__get_filter_pixel_margin(info->horizontal_filter, info->horizontal_scale); + info->vertical_filter_pixel_margin = stbir__get_filter_pixel_margin(info->vertical_filter , info->vertical_scale ); + + info->ring_buffer_length_bytes = info->output_w * info->channels * sizeof(float); + info->decode_buffer_pixels = info->input_w + info->horizontal_filter_pixel_margin * 2; + +#define STBIR__NEXT_MEMPTR(current, newtype) (newtype*)(((unsigned char*)current) + current##_size) + + info->horizontal_contributors = (stbir__contributors *) tempmem; + info->horizontal_coefficients = STBIR__NEXT_MEMPTR(info->horizontal_contributors, float); + info->vertical_contributors = STBIR__NEXT_MEMPTR(info->horizontal_coefficients, stbir__contributors); + info->vertical_coefficients = STBIR__NEXT_MEMPTR(info->vertical_contributors, float); + info->decode_buffer = STBIR__NEXT_MEMPTR(info->vertical_coefficients, float); + + if (stbir__use_height_upsampling(info)) + { + info->horizontal_buffer = NULL; + info->ring_buffer = STBIR__NEXT_MEMPTR(info->decode_buffer, float); + info->encode_buffer = STBIR__NEXT_MEMPTR(info->ring_buffer, float); + + STBIR_ASSERT((size_t)STBIR__NEXT_MEMPTR(info->encode_buffer, unsigned char) == (size_t)tempmem + tempmem_size_in_bytes); + } + else + { + info->horizontal_buffer = STBIR__NEXT_MEMPTR(info->decode_buffer, float); + info->ring_buffer = STBIR__NEXT_MEMPTR(info->horizontal_buffer, float); + info->encode_buffer = NULL; + + STBIR_ASSERT((size_t)STBIR__NEXT_MEMPTR(info->ring_buffer, unsigned char) == (size_t)tempmem + tempmem_size_in_bytes); + } + +#undef STBIR__NEXT_MEMPTR + + // This signals that the ring buffer is empty + info->ring_buffer_begin_index = -1; + + stbir__calculate_filters(info->horizontal_contributors, info->horizontal_coefficients, info->horizontal_filter, info->horizontal_scale, info->horizontal_shift, info->input_w, info->output_w); + stbir__calculate_filters(info->vertical_contributors, info->vertical_coefficients, info->vertical_filter, info->vertical_scale, info->vertical_shift, info->input_h, info->output_h); + + STBIR_PROGRESS_REPORT(0); + + if (stbir__use_height_upsampling(info)) + stbir__buffer_loop_upsample(info); + else + stbir__buffer_loop_downsample(info); + + STBIR_PROGRESS_REPORT(1); + +#ifdef STBIR_DEBUG_OVERWRITE_TEST + STBIR_ASSERT(memcmp(overwrite_output_before_pre, &((unsigned char*)output_data)[-OVERWRITE_ARRAY_SIZE], OVERWRITE_ARRAY_SIZE) == 0); + STBIR_ASSERT(memcmp(overwrite_output_after_pre, &((unsigned char*)output_data)[begin_forbidden], OVERWRITE_ARRAY_SIZE) == 0); + STBIR_ASSERT(memcmp(overwrite_tempmem_before_pre, &((unsigned char*)tempmem)[-OVERWRITE_ARRAY_SIZE], OVERWRITE_ARRAY_SIZE) == 0); + STBIR_ASSERT(memcmp(overwrite_tempmem_after_pre, &((unsigned char*)tempmem)[tempmem_size_in_bytes], OVERWRITE_ARRAY_SIZE) == 0); +#endif + + return 1; +} + + +static int stbir__resize_arbitrary( + void *alloc_context, + const void* input_data, int input_w, int input_h, int input_stride_in_bytes, + void* output_data, int output_w, int output_h, int output_stride_in_bytes, + float s0, float t0, float s1, float t1, float *transform, + int channels, int alpha_channel, stbir_uint32 flags, stbir_datatype type, + stbir_filter h_filter, stbir_filter v_filter, + stbir_edge edge_horizontal, stbir_edge edge_vertical, stbir_colorspace colorspace) +{ + stbir__info info; + int result; + size_t memory_required; + void* extra_memory; + + stbir__setup(&info, input_w, input_h, output_w, output_h, channels); + stbir__calculate_transform(&info, s0,t0,s1,t1,transform); + stbir__choose_filter(&info, h_filter, v_filter); + memory_required = stbir__calculate_memory(&info); + extra_memory = STBIR_MALLOC(memory_required, alloc_context); + + if (!extra_memory) + return 0; + + result = stbir__resize_allocated(&info, input_data, input_stride_in_bytes, + output_data, output_stride_in_bytes, + alpha_channel, flags, type, + edge_horizontal, edge_vertical, + colorspace, extra_memory, memory_required); + + STBIR_FREE(extra_memory, alloc_context); + + return result; +} + +STBIRDEF int stbir_resize_uint8( const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels) +{ + return stbir__resize_arbitrary(NULL, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,-1,0, STBIR_TYPE_UINT8, STBIR_FILTER_DEFAULT, STBIR_FILTER_DEFAULT, + STBIR_EDGE_CLAMP, STBIR_EDGE_CLAMP, STBIR_COLORSPACE_LINEAR); +} + +STBIRDEF int stbir_resize_float( const float *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + float *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels) +{ + return stbir__resize_arbitrary(NULL, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,-1,0, STBIR_TYPE_FLOAT, STBIR_FILTER_DEFAULT, STBIR_FILTER_DEFAULT, + STBIR_EDGE_CLAMP, STBIR_EDGE_CLAMP, STBIR_COLORSPACE_LINEAR); +} + +STBIRDEF int stbir_resize_uint8_srgb(const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags) +{ + return stbir__resize_arbitrary(NULL, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, STBIR_TYPE_UINT8, STBIR_FILTER_DEFAULT, STBIR_FILTER_DEFAULT, + STBIR_EDGE_CLAMP, STBIR_EDGE_CLAMP, STBIR_COLORSPACE_SRGB); +} + +STBIRDEF int stbir_resize_uint8_srgb_edgemode(const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode) +{ + return stbir__resize_arbitrary(NULL, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, STBIR_TYPE_UINT8, STBIR_FILTER_DEFAULT, STBIR_FILTER_DEFAULT, + edge_wrap_mode, edge_wrap_mode, STBIR_COLORSPACE_SRGB); +} + +STBIRDEF int stbir_resize_uint8_generic( const unsigned char *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + unsigned char *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context) +{ + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, STBIR_TYPE_UINT8, filter, filter, + edge_wrap_mode, edge_wrap_mode, space); +} + +STBIRDEF int stbir_resize_uint16_generic(const stbir_uint16 *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + stbir_uint16 *output_pixels , int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context) +{ + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, STBIR_TYPE_UINT16, filter, filter, + edge_wrap_mode, edge_wrap_mode, space); +} + + +STBIRDEF int stbir_resize_float_generic( const float *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + float *output_pixels , int output_w, int output_h, int output_stride_in_bytes, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_wrap_mode, stbir_filter filter, stbir_colorspace space, + void *alloc_context) +{ + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, STBIR_TYPE_FLOAT, filter, filter, + edge_wrap_mode, edge_wrap_mode, space); +} + + +STBIRDEF int stbir_resize( const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context) +{ + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,NULL,num_channels,alpha_channel,flags, datatype, filter_horizontal, filter_vertical, + edge_mode_horizontal, edge_mode_vertical, space); +} + + +STBIRDEF int stbir_resize_subpixel(const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context, + float x_scale, float y_scale, + float x_offset, float y_offset) +{ + float transform[4]; + transform[0] = x_scale; + transform[1] = y_scale; + transform[2] = x_offset; + transform[3] = y_offset; + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + 0,0,1,1,transform,num_channels,alpha_channel,flags, datatype, filter_horizontal, filter_vertical, + edge_mode_horizontal, edge_mode_vertical, space); +} + +STBIRDEF int stbir_resize_region( const void *input_pixels , int input_w , int input_h , int input_stride_in_bytes, + void *output_pixels, int output_w, int output_h, int output_stride_in_bytes, + stbir_datatype datatype, + int num_channels, int alpha_channel, int flags, + stbir_edge edge_mode_horizontal, stbir_edge edge_mode_vertical, + stbir_filter filter_horizontal, stbir_filter filter_vertical, + stbir_colorspace space, void *alloc_context, + float s0, float t0, float s1, float t1) +{ + return stbir__resize_arbitrary(alloc_context, input_pixels, input_w, input_h, input_stride_in_bytes, + output_pixels, output_w, output_h, output_stride_in_bytes, + s0,t0,s1,t1,NULL,num_channels,alpha_channel,flags, datatype, filter_horizontal, filter_vertical, + edge_mode_horizontal, edge_mode_vertical, space); +} + +#endif // STB_IMAGE_RESIZE_IMPLEMENTATION + +/* +------------------------------------------------------------------------------ +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. +------------------------------------------------------------------------------ +*/ diff --git a/third_party/stb/stb_image_write.h b/third_party/stb/stb_image_write.h new file mode 100644 index 00000000..e4b32ed1 --- /dev/null +++ b/third_party/stb/stb_image_write.h @@ -0,0 +1,1724 @@ +/* stb_image_write - v1.16 - public domain - http://nothings.org/stb + writes out PNG/BMP/TGA/JPEG/HDR images to C stdio - Sean Barrett 2010-2015 + no warranty implied; use at your own risk + + Before #including, + + #define STB_IMAGE_WRITE_IMPLEMENTATION + + in the file that you want to have the implementation. + + Will probably not work correctly with strict-aliasing optimizations. + +ABOUT: + + This header file is a library for writing images to C stdio or a callback. + + The PNG output is not optimal; it is 20-50% larger than the file + written by a decent optimizing implementation; though providing a custom + zlib compress function (see STBIW_ZLIB_COMPRESS) can mitigate that. + This library is designed for source code compactness and simplicity, + not optimal image file size or run-time performance. + +BUILDING: + + You can #define STBIW_ASSERT(x) before the #include to avoid using assert.h. + You can #define STBIW_MALLOC(), STBIW_REALLOC(), and STBIW_FREE() to replace + malloc,realloc,free. + You can #define STBIW_MEMMOVE() to replace memmove() + You can #define STBIW_ZLIB_COMPRESS to use a custom zlib-style compress function + for PNG compression (instead of the builtin one), it must have the following signature: + unsigned char * my_compress(unsigned char *data, int data_len, int *out_len, int quality); + The returned data will be freed with STBIW_FREE() (free() by default), + so it must be heap allocated with STBIW_MALLOC() (malloc() by default), + +UNICODE: + + If compiling for Windows and you wish to use Unicode filenames, compile + with + #define STBIW_WINDOWS_UTF8 + and pass utf8-encoded filenames. Call stbiw_convert_wchar_to_utf8 to convert + Windows wchar_t filenames to utf8. + +USAGE: + + There are five functions, one for each image file format: + + int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes); + int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data); + int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data); + int stbi_write_jpg(char const *filename, int w, int h, int comp, const void *data, int quality); + int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data); + + void stbi_flip_vertically_on_write(int flag); // flag is non-zero to flip data vertically + + There are also five equivalent functions that use an arbitrary write function. You are + expected to open/close your file-equivalent before and after calling these: + + int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes); + int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); + int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); + int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data); + int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality); + + where the callback is: + void stbi_write_func(void *context, void *data, int size); + + You can configure it with these global variables: + int stbi_write_tga_with_rle; // defaults to true; set to 0 to disable RLE + int stbi_write_png_compression_level; // defaults to 8; set to higher for more compression + int stbi_write_force_png_filter; // defaults to -1; set to 0..5 to force a filter mode + + + You can define STBI_WRITE_NO_STDIO to disable the file variant of these + functions, so the library will not use stdio.h at all. However, this will + also disable HDR writing, because it requires stdio for formatted output. + + Each function returns 0 on failure and non-0 on success. + + The functions create an image file defined by the parameters. The image + is a rectangle of pixels stored from left-to-right, top-to-bottom. + Each pixel contains 'comp' channels of data stored interleaved with 8-bits + per channel, in the following order: 1=Y, 2=YA, 3=RGB, 4=RGBA. (Y is + monochrome color.) The rectangle is 'w' pixels wide and 'h' pixels tall. + The *data pointer points to the first byte of the top-left-most pixel. + For PNG, "stride_in_bytes" is the distance in bytes from the first byte of + a row of pixels to the first byte of the next row of pixels. + + PNG creates output files with the same number of components as the input. + The BMP format expands Y to RGB in the file format and does not + output alpha. + + PNG supports writing rectangles of data even when the bytes storing rows of + data are not consecutive in memory (e.g. sub-rectangles of a larger image), + by supplying the stride between the beginning of adjacent rows. The other + formats do not. (Thus you cannot write a native-format BMP through the BMP + writer, both because it is in BGR order and because it may have padding + at the end of the line.) + + PNG allows you to set the deflate compression level by setting the global + variable 'stbi_write_png_compression_level' (it defaults to 8). + + HDR expects linear float data. Since the format is always 32-bit rgb(e) + data, alpha (if provided) is discarded, and for monochrome data it is + replicated across all three channels. + + TGA supports RLE or non-RLE compressed data. To use non-RLE-compressed + data, set the global variable 'stbi_write_tga_with_rle' to 0. + + JPEG does ignore alpha channels in input data; quality is between 1 and 100. + Higher quality looks better but results in a bigger image. + JPEG baseline (no JPEG progressive). + +CREDITS: + + + Sean Barrett - PNG/BMP/TGA + Baldur Karlsson - HDR + Jean-Sebastien Guay - TGA monochrome + Tim Kelsey - misc enhancements + Alan Hickman - TGA RLE + Emmanuel Julien - initial file IO callback implementation + Jon Olick - original jo_jpeg.cpp code + Daniel Gibson - integrate JPEG, allow external zlib + Aarni Koskela - allow choosing PNG filter + + bugfixes: + github:Chribba + Guillaume Chereau + github:jry2 + github:romigrou + Sergio Gonzalez + Jonas Karlsson + Filip Wasil + Thatcher Ulrich + github:poppolopoppo + Patrick Boettcher + github:xeekworx + Cap Petschulat + Simon Rodriguez + Ivan Tikhonov + github:ignotion + Adam Schackart + Andrew Kensler + +LICENSE + + See end of file for license information. + +*/ + +#ifndef INCLUDE_STB_IMAGE_WRITE_H +#define INCLUDE_STB_IMAGE_WRITE_H + +#include + +// if STB_IMAGE_WRITE_STATIC causes problems, try defining STBIWDEF to 'inline' or 'static inline' +#ifndef STBIWDEF +#ifdef STB_IMAGE_WRITE_STATIC +#define STBIWDEF static +#else +#ifdef __cplusplus +#define STBIWDEF extern "C" +#else +#define STBIWDEF extern +#endif +#endif +#endif + +#ifndef STB_IMAGE_WRITE_STATIC // C++ forbids static forward declarations +STBIWDEF int stbi_write_tga_with_rle; +STBIWDEF int stbi_write_png_compression_level; +STBIWDEF int stbi_write_force_png_filter; +#endif + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes); +STBIWDEF int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data); +STBIWDEF int stbi_write_jpg(char const *filename, int x, int y, int comp, const void *data, int quality); + +#ifdef STBIW_WINDOWS_UTF8 +STBIWDEF int stbiw_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); +#endif +#endif + +typedef void stbi_write_func(void *context, void *data, int size); + +STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes); +STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data); +STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data); +STBIWDEF int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality); + +STBIWDEF void stbi_flip_vertically_on_write(int flip_boolean); + +#endif//INCLUDE_STB_IMAGE_WRITE_H + +#ifdef STB_IMAGE_WRITE_IMPLEMENTATION + +#ifdef _WIN32 + #ifndef _CRT_SECURE_NO_WARNINGS + #define _CRT_SECURE_NO_WARNINGS + #endif + #ifndef _CRT_NONSTDC_NO_DEPRECATE + #define _CRT_NONSTDC_NO_DEPRECATE + #endif +#endif + +#ifndef STBI_WRITE_NO_STDIO +#include +#endif // STBI_WRITE_NO_STDIO + +#include +#include +#include +#include + +#if defined(STBIW_MALLOC) && defined(STBIW_FREE) && (defined(STBIW_REALLOC) || defined(STBIW_REALLOC_SIZED)) +// ok +#elif !defined(STBIW_MALLOC) && !defined(STBIW_FREE) && !defined(STBIW_REALLOC) && !defined(STBIW_REALLOC_SIZED) +// ok +#else +#error "Must define all or none of STBIW_MALLOC, STBIW_FREE, and STBIW_REALLOC (or STBIW_REALLOC_SIZED)." +#endif + +#ifndef STBIW_MALLOC +#define STBIW_MALLOC(sz) malloc(sz) +#define STBIW_REALLOC(p,newsz) realloc(p,newsz) +#define STBIW_FREE(p) free(p) +#endif + +#ifndef STBIW_REALLOC_SIZED +#define STBIW_REALLOC_SIZED(p,oldsz,newsz) STBIW_REALLOC(p,newsz) +#endif + + +#ifndef STBIW_MEMMOVE +#define STBIW_MEMMOVE(a,b,sz) memmove(a,b,sz) +#endif + + +#ifndef STBIW_ASSERT +#include +#define STBIW_ASSERT(x) assert(x) +#endif + +#define STBIW_UCHAR(x) (unsigned char) ((x) & 0xff) + +#ifdef STB_IMAGE_WRITE_STATIC +static int stbi_write_png_compression_level = 8; +static int stbi_write_tga_with_rle = 1; +static int stbi_write_force_png_filter = -1; +#else +int stbi_write_png_compression_level = 8; +int stbi_write_tga_with_rle = 1; +int stbi_write_force_png_filter = -1; +#endif + +static int stbi__flip_vertically_on_write = 0; + +STBIWDEF void stbi_flip_vertically_on_write(int flag) +{ + stbi__flip_vertically_on_write = flag; +} + +typedef struct +{ + stbi_write_func *func; + void *context; + unsigned char buffer[64]; + int buf_used; +} stbi__write_context; + +// initialize a callback-based context +static void stbi__start_write_callbacks(stbi__write_context *s, stbi_write_func *c, void *context) +{ + s->func = c; + s->context = context; +} + +#ifndef STBI_WRITE_NO_STDIO + +static void stbi__stdio_write(void *context, void *data, int size) +{ + fwrite(data,1,size,(FILE*) context); +} + +#if defined(_WIN32) && defined(STBIW_WINDOWS_UTF8) +#ifdef __cplusplus +#define STBIW_EXTERN extern "C" +#else +#define STBIW_EXTERN extern +#endif +STBIW_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); +STBIW_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); + +STBIWDEF int stbiw_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 *stbiw__fopen(char const *filename, char const *mode) +{ + FILE *f; +#if defined(_WIN32) && defined(STBIW_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; +} + +static int stbi__start_write_file(stbi__write_context *s, const char *filename) +{ + FILE *f = stbiw__fopen(filename, "wb"); + stbi__start_write_callbacks(s, stbi__stdio_write, (void *) f); + return f != NULL; +} + +static void stbi__end_write_file(stbi__write_context *s) +{ + fclose((FILE *)s->context); +} + +#endif // !STBI_WRITE_NO_STDIO + +typedef unsigned int stbiw_uint32; +typedef int stb_image_write_test[sizeof(stbiw_uint32)==4 ? 1 : -1]; + +static void stbiw__writefv(stbi__write_context *s, const char *fmt, va_list v) +{ + while (*fmt) { + switch (*fmt++) { + case ' ': break; + case '1': { unsigned char x = STBIW_UCHAR(va_arg(v, int)); + s->func(s->context,&x,1); + break; } + case '2': { int x = va_arg(v,int); + unsigned char b[2]; + b[0] = STBIW_UCHAR(x); + b[1] = STBIW_UCHAR(x>>8); + s->func(s->context,b,2); + break; } + case '4': { stbiw_uint32 x = va_arg(v,int); + unsigned char b[4]; + b[0]=STBIW_UCHAR(x); + b[1]=STBIW_UCHAR(x>>8); + b[2]=STBIW_UCHAR(x>>16); + b[3]=STBIW_UCHAR(x>>24); + s->func(s->context,b,4); + break; } + default: + STBIW_ASSERT(0); + return; + } + } +} + +static void stbiw__writef(stbi__write_context *s, const char *fmt, ...) +{ + va_list v; + va_start(v, fmt); + stbiw__writefv(s, fmt, v); + va_end(v); +} + +static void stbiw__write_flush(stbi__write_context *s) +{ + if (s->buf_used) { + s->func(s->context, &s->buffer, s->buf_used); + s->buf_used = 0; + } +} + +static void stbiw__putc(stbi__write_context *s, unsigned char c) +{ + s->func(s->context, &c, 1); +} + +static void stbiw__write1(stbi__write_context *s, unsigned char a) +{ + if ((size_t)s->buf_used + 1 > sizeof(s->buffer)) + stbiw__write_flush(s); + s->buffer[s->buf_used++] = a; +} + +static void stbiw__write3(stbi__write_context *s, unsigned char a, unsigned char b, unsigned char c) +{ + int n; + if ((size_t)s->buf_used + 3 > sizeof(s->buffer)) + stbiw__write_flush(s); + n = s->buf_used; + s->buf_used = n+3; + s->buffer[n+0] = a; + s->buffer[n+1] = b; + s->buffer[n+2] = c; +} + +static void stbiw__write_pixel(stbi__write_context *s, int rgb_dir, int comp, int write_alpha, int expand_mono, unsigned char *d) +{ + unsigned char bg[3] = { 255, 0, 255}, px[3]; + int k; + + if (write_alpha < 0) + stbiw__write1(s, d[comp - 1]); + + switch (comp) { + case 2: // 2 pixels = mono + alpha, alpha is written separately, so same as 1-channel case + case 1: + if (expand_mono) + stbiw__write3(s, d[0], d[0], d[0]); // monochrome bmp + else + stbiw__write1(s, d[0]); // monochrome TGA + break; + case 4: + if (!write_alpha) { + // composite against pink background + for (k = 0; k < 3; ++k) + px[k] = bg[k] + ((d[k] - bg[k]) * d[3]) / 255; + stbiw__write3(s, px[1 - rgb_dir], px[1], px[1 + rgb_dir]); + break; + } + /* FALLTHROUGH */ + case 3: + stbiw__write3(s, d[1 - rgb_dir], d[1], d[1 + rgb_dir]); + break; + } + if (write_alpha > 0) + stbiw__write1(s, d[comp - 1]); +} + +static void stbiw__write_pixels(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, void *data, int write_alpha, int scanline_pad, int expand_mono) +{ + stbiw_uint32 zero = 0; + int i,j, j_end; + + if (y <= 0) + return; + + if (stbi__flip_vertically_on_write) + vdir *= -1; + + if (vdir < 0) { + j_end = -1; j = y-1; + } else { + j_end = y; j = 0; + } + + for (; j != j_end; j += vdir) { + for (i=0; i < x; ++i) { + unsigned char *d = (unsigned char *) data + (j*x+i)*comp; + stbiw__write_pixel(s, rgb_dir, comp, write_alpha, expand_mono, d); + } + stbiw__write_flush(s); + s->func(s->context, &zero, scanline_pad); + } +} + +static int stbiw__outfile(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, int expand_mono, void *data, int alpha, int pad, const char *fmt, ...) +{ + if (y < 0 || x < 0) { + return 0; + } else { + va_list v; + va_start(v, fmt); + stbiw__writefv(s, fmt, v); + va_end(v); + stbiw__write_pixels(s,rgb_dir,vdir,x,y,comp,data,alpha,pad, expand_mono); + return 1; + } +} + +static int stbi_write_bmp_core(stbi__write_context *s, int x, int y, int comp, const void *data) +{ + if (comp != 4) { + // write RGB bitmap + int pad = (-x*3) & 3; + return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *) data,0,pad, + "11 4 22 4" "4 44 22 444444", + 'B', 'M', 14+40+(x*3+pad)*y, 0,0, 14+40, // file header + 40, x,y, 1,24, 0,0,0,0,0,0); // bitmap header + } else { + // RGBA bitmaps need a v4 header + // use BI_BITFIELDS mode with 32bpp and alpha mask + // (straight BI_RGB with alpha mask doesn't work in most readers) + return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *)data,1,0, + "11 4 22 4" "4 44 22 444444 4444 4 444 444 444 444", + 'B', 'M', 14+108+x*y*4, 0, 0, 14+108, // file header + 108, x,y, 1,32, 3,0,0,0,0,0, 0xff0000,0xff00,0xff,0xff000000u, 0, 0,0,0, 0,0,0, 0,0,0, 0,0,0); // bitmap V4 header + } +} + +STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_bmp_core(&s, x, y, comp, data); +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_bmp(char const *filename, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_bmp_core(&s, x, y, comp, data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif //!STBI_WRITE_NO_STDIO + +static int stbi_write_tga_core(stbi__write_context *s, int x, int y, int comp, void *data) +{ + int has_alpha = (comp == 2 || comp == 4); + int colorbytes = has_alpha ? comp-1 : comp; + int format = colorbytes < 2 ? 3 : 2; // 3 color channels (RGB/RGBA) = 2, 1 color channel (Y/YA) = 3 + + if (y < 0 || x < 0) + return 0; + + if (!stbi_write_tga_with_rle) { + return stbiw__outfile(s, -1, -1, x, y, comp, 0, (void *) data, has_alpha, 0, + "111 221 2222 11", 0, 0, format, 0, 0, 0, 0, 0, x, y, (colorbytes + has_alpha) * 8, has_alpha * 8); + } else { + int i,j,k; + int jend, jdir; + + stbiw__writef(s, "111 221 2222 11", 0,0,format+8, 0,0,0, 0,0,x,y, (colorbytes + has_alpha) * 8, has_alpha * 8); + + if (stbi__flip_vertically_on_write) { + j = 0; + jend = y; + jdir = 1; + } else { + j = y-1; + jend = -1; + jdir = -1; + } + for (; j != jend; j += jdir) { + unsigned char *row = (unsigned char *) data + j * x * comp; + int len; + + for (i = 0; i < x; i += len) { + unsigned char *begin = row + i * comp; + int diff = 1; + len = 1; + + if (i < x - 1) { + ++len; + diff = memcmp(begin, row + (i + 1) * comp, comp); + if (diff) { + const unsigned char *prev = begin; + for (k = i + 2; k < x && len < 128; ++k) { + if (memcmp(prev, row + k * comp, comp)) { + prev += comp; + ++len; + } else { + --len; + break; + } + } + } else { + for (k = i + 2; k < x && len < 128; ++k) { + if (!memcmp(begin, row + k * comp, comp)) { + ++len; + } else { + break; + } + } + } + } + + if (diff) { + unsigned char header = STBIW_UCHAR(len - 1); + stbiw__write1(s, header); + for (k = 0; k < len; ++k) { + stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin + k * comp); + } + } else { + unsigned char header = STBIW_UCHAR(len - 129); + stbiw__write1(s, header); + stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin); + } + } + } + stbiw__write_flush(s); + } + return 1; +} + +STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_tga_core(&s, x, y, comp, (void *) data); +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_tga(char const *filename, int x, int y, int comp, const void *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_tga_core(&s, x, y, comp, (void *) data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif + +// ************************************************************************************************* +// Radiance RGBE HDR writer +// by Baldur Karlsson + +#define stbiw__max(a, b) ((a) > (b) ? (a) : (b)) + +#ifndef STBI_WRITE_NO_STDIO + +static void stbiw__linear_to_rgbe(unsigned char *rgbe, float *linear) +{ + int exponent; + float maxcomp = stbiw__max(linear[0], stbiw__max(linear[1], linear[2])); + + if (maxcomp < 1e-32f) { + rgbe[0] = rgbe[1] = rgbe[2] = rgbe[3] = 0; + } else { + float normalize = (float) frexp(maxcomp, &exponent) * 256.0f/maxcomp; + + rgbe[0] = (unsigned char)(linear[0] * normalize); + rgbe[1] = (unsigned char)(linear[1] * normalize); + rgbe[2] = (unsigned char)(linear[2] * normalize); + rgbe[3] = (unsigned char)(exponent + 128); + } +} + +static void stbiw__write_run_data(stbi__write_context *s, int length, unsigned char databyte) +{ + unsigned char lengthbyte = STBIW_UCHAR(length+128); + STBIW_ASSERT(length+128 <= 255); + s->func(s->context, &lengthbyte, 1); + s->func(s->context, &databyte, 1); +} + +static void stbiw__write_dump_data(stbi__write_context *s, int length, unsigned char *data) +{ + unsigned char lengthbyte = STBIW_UCHAR(length); + STBIW_ASSERT(length <= 128); // inconsistent with spec but consistent with official code + s->func(s->context, &lengthbyte, 1); + s->func(s->context, data, length); +} + +static void stbiw__write_hdr_scanline(stbi__write_context *s, int width, int ncomp, unsigned char *scratch, float *scanline) +{ + unsigned char scanlineheader[4] = { 2, 2, 0, 0 }; + unsigned char rgbe[4]; + float linear[3]; + int x; + + scanlineheader[2] = (width&0xff00)>>8; + scanlineheader[3] = (width&0x00ff); + + /* skip RLE for images too small or large */ + if (width < 8 || width >= 32768) { + for (x=0; x < width; x++) { + switch (ncomp) { + case 4: /* fallthrough */ + case 3: linear[2] = scanline[x*ncomp + 2]; + linear[1] = scanline[x*ncomp + 1]; + linear[0] = scanline[x*ncomp + 0]; + break; + default: + linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0]; + break; + } + stbiw__linear_to_rgbe(rgbe, linear); + s->func(s->context, rgbe, 4); + } + } else { + int c,r; + /* encode into scratch buffer */ + for (x=0; x < width; x++) { + switch(ncomp) { + case 4: /* fallthrough */ + case 3: linear[2] = scanline[x*ncomp + 2]; + linear[1] = scanline[x*ncomp + 1]; + linear[0] = scanline[x*ncomp + 0]; + break; + default: + linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0]; + break; + } + stbiw__linear_to_rgbe(rgbe, linear); + scratch[x + width*0] = rgbe[0]; + scratch[x + width*1] = rgbe[1]; + scratch[x + width*2] = rgbe[2]; + scratch[x + width*3] = rgbe[3]; + } + + s->func(s->context, scanlineheader, 4); + + /* RLE each component separately */ + for (c=0; c < 4; c++) { + unsigned char *comp = &scratch[width*c]; + + x = 0; + while (x < width) { + // find first run + r = x; + while (r+2 < width) { + if (comp[r] == comp[r+1] && comp[r] == comp[r+2]) + break; + ++r; + } + if (r+2 >= width) + r = width; + // dump up to first run + while (x < r) { + int len = r-x; + if (len > 128) len = 128; + stbiw__write_dump_data(s, len, &comp[x]); + x += len; + } + // if there's a run, output it + if (r+2 < width) { // same test as what we break out of in search loop, so only true if we break'd + // find next byte after run + while (r < width && comp[r] == comp[x]) + ++r; + // output run up to r + while (x < r) { + int len = r-x; + if (len > 127) len = 127; + stbiw__write_run_data(s, len, comp[x]); + x += len; + } + } + } + } + } +} + +static int stbi_write_hdr_core(stbi__write_context *s, int x, int y, int comp, float *data) +{ + if (y <= 0 || x <= 0 || data == NULL) + return 0; + else { + // Each component is stored separately. Allocate scratch space for full output scanline. + unsigned char *scratch = (unsigned char *) STBIW_MALLOC(x*4); + int i, len; + char buffer[128]; + char header[] = "#?RADIANCE\n# Written by stb_image_write.h\nFORMAT=32-bit_rle_rgbe\n"; + s->func(s->context, header, sizeof(header)-1); + +#ifdef __STDC_LIB_EXT1__ + len = sprintf_s(buffer, sizeof(buffer), "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x); +#else + len = sprintf(buffer, "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x); +#endif + s->func(s->context, buffer, len); + + for(i=0; i < y; i++) + stbiw__write_hdr_scanline(s, x, comp, scratch, data + comp*x*(stbi__flip_vertically_on_write ? y-1-i : i)); + STBIW_FREE(scratch); + return 1; + } +} + +STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const float *data) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_hdr_core(&s, x, y, comp, (float *) data); +} + +STBIWDEF int stbi_write_hdr(char const *filename, int x, int y, int comp, const float *data) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_hdr_core(&s, x, y, comp, (float *) data); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif // STBI_WRITE_NO_STDIO + + +////////////////////////////////////////////////////////////////////////////// +// +// PNG writer +// + +#ifndef STBIW_ZLIB_COMPRESS +// stretchy buffer; stbiw__sbpush() == vector<>::push_back() -- stbiw__sbcount() == vector<>::size() +#define stbiw__sbraw(a) ((int *) (void *) (a) - 2) +#define stbiw__sbm(a) stbiw__sbraw(a)[0] +#define stbiw__sbn(a) stbiw__sbraw(a)[1] + +#define stbiw__sbneedgrow(a,n) ((a)==0 || stbiw__sbn(a)+n >= stbiw__sbm(a)) +#define stbiw__sbmaybegrow(a,n) (stbiw__sbneedgrow(a,(n)) ? stbiw__sbgrow(a,n) : 0) +#define stbiw__sbgrow(a,n) stbiw__sbgrowf((void **) &(a), (n), sizeof(*(a))) + +#define stbiw__sbpush(a, v) (stbiw__sbmaybegrow(a,1), (a)[stbiw__sbn(a)++] = (v)) +#define stbiw__sbcount(a) ((a) ? stbiw__sbn(a) : 0) +#define stbiw__sbfree(a) ((a) ? STBIW_FREE(stbiw__sbraw(a)),0 : 0) + +static void *stbiw__sbgrowf(void **arr, int increment, int itemsize) +{ + int m = *arr ? 2*stbiw__sbm(*arr)+increment : increment+1; + void *p = STBIW_REALLOC_SIZED(*arr ? stbiw__sbraw(*arr) : 0, *arr ? (stbiw__sbm(*arr)*itemsize + sizeof(int)*2) : 0, itemsize * m + sizeof(int)*2); + STBIW_ASSERT(p); + if (p) { + if (!*arr) ((int *) p)[1] = 0; + *arr = (void *) ((int *) p + 2); + stbiw__sbm(*arr) = m; + } + return *arr; +} + +static unsigned char *stbiw__zlib_flushf(unsigned char *data, unsigned int *bitbuffer, int *bitcount) +{ + while (*bitcount >= 8) { + stbiw__sbpush(data, STBIW_UCHAR(*bitbuffer)); + *bitbuffer >>= 8; + *bitcount -= 8; + } + return data; +} + +static int stbiw__zlib_bitrev(int code, int codebits) +{ + int res=0; + while (codebits--) { + res = (res << 1) | (code & 1); + code >>= 1; + } + return res; +} + +static unsigned int stbiw__zlib_countm(unsigned char *a, unsigned char *b, int limit) +{ + int i; + for (i=0; i < limit && i < 258; ++i) + if (a[i] != b[i]) break; + return i; +} + +static unsigned int stbiw__zhash(unsigned char *data) +{ + stbiw_uint32 hash = data[0] + (data[1] << 8) + (data[2] << 16); + hash ^= hash << 3; + hash += hash >> 5; + hash ^= hash << 4; + hash += hash >> 17; + hash ^= hash << 25; + hash += hash >> 6; + return hash; +} + +#define stbiw__zlib_flush() (out = stbiw__zlib_flushf(out, &bitbuf, &bitcount)) +#define stbiw__zlib_add(code,codebits) \ + (bitbuf |= (code) << bitcount, bitcount += (codebits), stbiw__zlib_flush()) +#define stbiw__zlib_huffa(b,c) stbiw__zlib_add(stbiw__zlib_bitrev(b,c),c) +// default huffman tables +#define stbiw__zlib_huff1(n) stbiw__zlib_huffa(0x30 + (n), 8) +#define stbiw__zlib_huff2(n) stbiw__zlib_huffa(0x190 + (n)-144, 9) +#define stbiw__zlib_huff3(n) stbiw__zlib_huffa(0 + (n)-256,7) +#define stbiw__zlib_huff4(n) stbiw__zlib_huffa(0xc0 + (n)-280,8) +#define stbiw__zlib_huff(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : (n) <= 255 ? stbiw__zlib_huff2(n) : (n) <= 279 ? stbiw__zlib_huff3(n) : stbiw__zlib_huff4(n)) +#define stbiw__zlib_huffb(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : stbiw__zlib_huff2(n)) + +#define stbiw__ZHASH 16384 + +#endif // STBIW_ZLIB_COMPRESS + +STBIWDEF unsigned char * stbi_zlib_compress(unsigned char *data, int data_len, int *out_len, int quality) +{ +#ifdef STBIW_ZLIB_COMPRESS + // user provided a zlib compress implementation, use that + return STBIW_ZLIB_COMPRESS(data, data_len, out_len, quality); +#else // use builtin + static unsigned short lengthc[] = { 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, 259 }; + static unsigned char lengtheb[]= { 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 }; + static unsigned short distc[] = { 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, 32768 }; + static unsigned char disteb[] = { 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 }; + unsigned int bitbuf=0; + int i,j, bitcount=0; + unsigned char *out = NULL; + unsigned char ***hash_table = (unsigned char***) STBIW_MALLOC(stbiw__ZHASH * sizeof(unsigned char**)); + if (hash_table == NULL) + return NULL; + if (quality < 5) quality = 5; + + stbiw__sbpush(out, 0x78); // DEFLATE 32K window + stbiw__sbpush(out, 0x5e); // FLEVEL = 1 + stbiw__zlib_add(1,1); // BFINAL = 1 + stbiw__zlib_add(1,2); // BTYPE = 1 -- fixed huffman + + for (i=0; i < stbiw__ZHASH; ++i) + hash_table[i] = NULL; + + i=0; + while (i < data_len-3) { + // hash next 3 bytes of data to be compressed + int h = stbiw__zhash(data+i)&(stbiw__ZHASH-1), best=3; + unsigned char *bestloc = 0; + unsigned char **hlist = hash_table[h]; + int n = stbiw__sbcount(hlist); + for (j=0; j < n; ++j) { + if (hlist[j]-data > i-32768) { // if entry lies within window + int d = stbiw__zlib_countm(hlist[j], data+i, data_len-i); + if (d >= best) { best=d; bestloc=hlist[j]; } + } + } + // when hash table entry is too long, delete half the entries + if (hash_table[h] && stbiw__sbn(hash_table[h]) == 2*quality) { + STBIW_MEMMOVE(hash_table[h], hash_table[h]+quality, sizeof(hash_table[h][0])*quality); + stbiw__sbn(hash_table[h]) = quality; + } + stbiw__sbpush(hash_table[h],data+i); + + if (bestloc) { + // "lazy matching" - check match at *next* byte, and if it's better, do cur byte as literal + h = stbiw__zhash(data+i+1)&(stbiw__ZHASH-1); + hlist = hash_table[h]; + n = stbiw__sbcount(hlist); + for (j=0; j < n; ++j) { + if (hlist[j]-data > i-32767) { + int e = stbiw__zlib_countm(hlist[j], data+i+1, data_len-i-1); + if (e > best) { // if next match is better, bail on current match + bestloc = NULL; + break; + } + } + } + } + + if (bestloc) { + int d = (int) (data+i - bestloc); // distance back + STBIW_ASSERT(d <= 32767 && best <= 258); + for (j=0; best > lengthc[j+1]-1; ++j); + stbiw__zlib_huff(j+257); + if (lengtheb[j]) stbiw__zlib_add(best - lengthc[j], lengtheb[j]); + for (j=0; d > distc[j+1]-1; ++j); + stbiw__zlib_add(stbiw__zlib_bitrev(j,5),5); + if (disteb[j]) stbiw__zlib_add(d - distc[j], disteb[j]); + i += best; + } else { + stbiw__zlib_huffb(data[i]); + ++i; + } + } + // write out final bytes + for (;i < data_len; ++i) + stbiw__zlib_huffb(data[i]); + stbiw__zlib_huff(256); // end of block + // pad with 0 bits to byte boundary + while (bitcount) + stbiw__zlib_add(0,1); + + for (i=0; i < stbiw__ZHASH; ++i) + (void) stbiw__sbfree(hash_table[i]); + STBIW_FREE(hash_table); + + // store uncompressed instead if compression was worse + if (stbiw__sbn(out) > data_len + 2 + ((data_len+32766)/32767)*5) { + stbiw__sbn(out) = 2; // truncate to DEFLATE 32K window and FLEVEL = 1 + for (j = 0; j < data_len;) { + int blocklen = data_len - j; + if (blocklen > 32767) blocklen = 32767; + stbiw__sbpush(out, data_len - j == blocklen); // BFINAL = ?, BTYPE = 0 -- no compression + stbiw__sbpush(out, STBIW_UCHAR(blocklen)); // LEN + stbiw__sbpush(out, STBIW_UCHAR(blocklen >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(~blocklen)); // NLEN + stbiw__sbpush(out, STBIW_UCHAR(~blocklen >> 8)); + memcpy(out+stbiw__sbn(out), data+j, blocklen); + stbiw__sbn(out) += blocklen; + j += blocklen; + } + } + + { + // compute adler32 on input + unsigned int s1=1, s2=0; + int blocklen = (int) (data_len % 5552); + j=0; + while (j < data_len) { + for (i=0; i < blocklen; ++i) { s1 += data[j+i]; s2 += s1; } + s1 %= 65521; s2 %= 65521; + j += blocklen; + blocklen = 5552; + } + stbiw__sbpush(out, STBIW_UCHAR(s2 >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(s2)); + stbiw__sbpush(out, STBIW_UCHAR(s1 >> 8)); + stbiw__sbpush(out, STBIW_UCHAR(s1)); + } + *out_len = stbiw__sbn(out); + // make returned pointer freeable + STBIW_MEMMOVE(stbiw__sbraw(out), out, *out_len); + return (unsigned char *) stbiw__sbraw(out); +#endif // STBIW_ZLIB_COMPRESS +} + +static unsigned int stbiw__crc32(unsigned char *buffer, int len) +{ +#ifdef STBIW_CRC32 + return STBIW_CRC32(buffer, len); +#else + static unsigned int crc_table[256] = + { + 0x00000000, 0x77073096, 0xEE0E612C, 0x990951BA, 0x076DC419, 0x706AF48F, 0xE963A535, 0x9E6495A3, + 0x0eDB8832, 0x79DCB8A4, 0xE0D5E91E, 0x97D2D988, 0x09B64C2B, 0x7EB17CBD, 0xE7B82D07, 0x90BF1D91, + 0x1DB71064, 0x6AB020F2, 0xF3B97148, 0x84BE41DE, 0x1ADAD47D, 0x6DDDE4EB, 0xF4D4B551, 0x83D385C7, + 0x136C9856, 0x646BA8C0, 0xFD62F97A, 0x8A65C9EC, 0x14015C4F, 0x63066CD9, 0xFA0F3D63, 0x8D080DF5, + 0x3B6E20C8, 0x4C69105E, 0xD56041E4, 0xA2677172, 0x3C03E4D1, 0x4B04D447, 0xD20D85FD, 0xA50AB56B, + 0x35B5A8FA, 0x42B2986C, 0xDBBBC9D6, 0xACBCF940, 0x32D86CE3, 0x45DF5C75, 0xDCD60DCF, 0xABD13D59, + 0x26D930AC, 0x51DE003A, 0xC8D75180, 0xBFD06116, 0x21B4F4B5, 0x56B3C423, 0xCFBA9599, 0xB8BDA50F, + 0x2802B89E, 0x5F058808, 0xC60CD9B2, 0xB10BE924, 0x2F6F7C87, 0x58684C11, 0xC1611DAB, 0xB6662D3D, + 0x76DC4190, 0x01DB7106, 0x98D220BC, 0xEFD5102A, 0x71B18589, 0x06B6B51F, 0x9FBFE4A5, 0xE8B8D433, + 0x7807C9A2, 0x0F00F934, 0x9609A88E, 0xE10E9818, 0x7F6A0DBB, 0x086D3D2D, 0x91646C97, 0xE6635C01, + 0x6B6B51F4, 0x1C6C6162, 0x856530D8, 0xF262004E, 0x6C0695ED, 0x1B01A57B, 0x8208F4C1, 0xF50FC457, + 0x65B0D9C6, 0x12B7E950, 0x8BBEB8EA, 0xFCB9887C, 0x62DD1DDF, 0x15DA2D49, 0x8CD37CF3, 0xFBD44C65, + 0x4DB26158, 0x3AB551CE, 0xA3BC0074, 0xD4BB30E2, 0x4ADFA541, 0x3DD895D7, 0xA4D1C46D, 0xD3D6F4FB, + 0x4369E96A, 0x346ED9FC, 0xAD678846, 0xDA60B8D0, 0x44042D73, 0x33031DE5, 0xAA0A4C5F, 0xDD0D7CC9, + 0x5005713C, 0x270241AA, 0xBE0B1010, 0xC90C2086, 0x5768B525, 0x206F85B3, 0xB966D409, 0xCE61E49F, + 0x5EDEF90E, 0x29D9C998, 0xB0D09822, 0xC7D7A8B4, 0x59B33D17, 0x2EB40D81, 0xB7BD5C3B, 0xC0BA6CAD, + 0xEDB88320, 0x9ABFB3B6, 0x03B6E20C, 0x74B1D29A, 0xEAD54739, 0x9DD277AF, 0x04DB2615, 0x73DC1683, + 0xE3630B12, 0x94643B84, 0x0D6D6A3E, 0x7A6A5AA8, 0xE40ECF0B, 0x9309FF9D, 0x0A00AE27, 0x7D079EB1, + 0xF00F9344, 0x8708A3D2, 0x1E01F268, 0x6906C2FE, 0xF762575D, 0x806567CB, 0x196C3671, 0x6E6B06E7, + 0xFED41B76, 0x89D32BE0, 0x10DA7A5A, 0x67DD4ACC, 0xF9B9DF6F, 0x8EBEEFF9, 0x17B7BE43, 0x60B08ED5, + 0xD6D6A3E8, 0xA1D1937E, 0x38D8C2C4, 0x4FDFF252, 0xD1BB67F1, 0xA6BC5767, 0x3FB506DD, 0x48B2364B, + 0xD80D2BDA, 0xAF0A1B4C, 0x36034AF6, 0x41047A60, 0xDF60EFC3, 0xA867DF55, 0x316E8EEF, 0x4669BE79, + 0xCB61B38C, 0xBC66831A, 0x256FD2A0, 0x5268E236, 0xCC0C7795, 0xBB0B4703, 0x220216B9, 0x5505262F, + 0xC5BA3BBE, 0xB2BD0B28, 0x2BB45A92, 0x5CB36A04, 0xC2D7FFA7, 0xB5D0CF31, 0x2CD99E8B, 0x5BDEAE1D, + 0x9B64C2B0, 0xEC63F226, 0x756AA39C, 0x026D930A, 0x9C0906A9, 0xEB0E363F, 0x72076785, 0x05005713, + 0x95BF4A82, 0xE2B87A14, 0x7BB12BAE, 0x0CB61B38, 0x92D28E9B, 0xE5D5BE0D, 0x7CDCEFB7, 0x0BDBDF21, + 0x86D3D2D4, 0xF1D4E242, 0x68DDB3F8, 0x1FDA836E, 0x81BE16CD, 0xF6B9265B, 0x6FB077E1, 0x18B74777, + 0x88085AE6, 0xFF0F6A70, 0x66063BCA, 0x11010B5C, 0x8F659EFF, 0xF862AE69, 0x616BFFD3, 0x166CCF45, + 0xA00AE278, 0xD70DD2EE, 0x4E048354, 0x3903B3C2, 0xA7672661, 0xD06016F7, 0x4969474D, 0x3E6E77DB, + 0xAED16A4A, 0xD9D65ADC, 0x40DF0B66, 0x37D83BF0, 0xA9BCAE53, 0xDEBB9EC5, 0x47B2CF7F, 0x30B5FFE9, + 0xBDBDF21C, 0xCABAC28A, 0x53B39330, 0x24B4A3A6, 0xBAD03605, 0xCDD70693, 0x54DE5729, 0x23D967BF, + 0xB3667A2E, 0xC4614AB8, 0x5D681B02, 0x2A6F2B94, 0xB40BBE37, 0xC30C8EA1, 0x5A05DF1B, 0x2D02EF8D + }; + + unsigned int crc = ~0u; + int i; + for (i=0; i < len; ++i) + crc = (crc >> 8) ^ crc_table[buffer[i] ^ (crc & 0xff)]; + return ~crc; +#endif +} + +#define stbiw__wpng4(o,a,b,c,d) ((o)[0]=STBIW_UCHAR(a),(o)[1]=STBIW_UCHAR(b),(o)[2]=STBIW_UCHAR(c),(o)[3]=STBIW_UCHAR(d),(o)+=4) +#define stbiw__wp32(data,v) stbiw__wpng4(data, (v)>>24,(v)>>16,(v)>>8,(v)); +#define stbiw__wptag(data,s) stbiw__wpng4(data, s[0],s[1],s[2],s[3]) + +static void stbiw__wpcrc(unsigned char **data, int len) +{ + unsigned int crc = stbiw__crc32(*data - len - 4, len+4); + stbiw__wp32(*data, crc); +} + +static unsigned char stbiw__paeth(int a, int b, int c) +{ + int p = a + b - c, pa = abs(p-a), pb = abs(p-b), pc = abs(p-c); + if (pa <= pb && pa <= pc) return STBIW_UCHAR(a); + if (pb <= pc) return STBIW_UCHAR(b); + return STBIW_UCHAR(c); +} + +// @OPTIMIZE: provide an option that always forces left-predict or paeth predict +static void stbiw__encode_png_line(unsigned char *pixels, int stride_bytes, int width, int height, int y, int n, int filter_type, signed char *line_buffer) +{ + static int mapping[] = { 0,1,2,3,4 }; + static int firstmap[] = { 0,1,0,5,6 }; + int *mymap = (y != 0) ? mapping : firstmap; + int i; + int type = mymap[filter_type]; + unsigned char *z = pixels + stride_bytes * (stbi__flip_vertically_on_write ? height-1-y : y); + int signed_stride = stbi__flip_vertically_on_write ? -stride_bytes : stride_bytes; + + if (type==0) { + memcpy(line_buffer, z, width*n); + return; + } + + // first loop isn't optimized since it's just one pixel + for (i = 0; i < n; ++i) { + switch (type) { + case 1: line_buffer[i] = z[i]; break; + case 2: line_buffer[i] = z[i] - z[i-signed_stride]; break; + case 3: line_buffer[i] = z[i] - (z[i-signed_stride]>>1); break; + case 4: line_buffer[i] = (signed char) (z[i] - stbiw__paeth(0,z[i-signed_stride],0)); break; + case 5: line_buffer[i] = z[i]; break; + case 6: line_buffer[i] = z[i]; break; + } + } + switch (type) { + case 1: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-n]; break; + case 2: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-signed_stride]; break; + case 3: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - ((z[i-n] + z[i-signed_stride])>>1); break; + case 4: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], z[i-signed_stride], z[i-signed_stride-n]); break; + case 5: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - (z[i-n]>>1); break; + case 6: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], 0,0); break; + } +} + +STBIWDEF unsigned char *stbi_write_png_to_mem(const unsigned char *pixels, int stride_bytes, int x, int y, int n, int *out_len) +{ + int force_filter = stbi_write_force_png_filter; + int ctype[5] = { -1, 0, 4, 2, 6 }; + unsigned char sig[8] = { 137,80,78,71,13,10,26,10 }; + unsigned char *out,*o, *filt, *zlib; + signed char *line_buffer; + int j,zlen; + + if (stride_bytes == 0) + stride_bytes = x * n; + + if (force_filter >= 5) { + force_filter = -1; + } + + filt = (unsigned char *) STBIW_MALLOC((x*n+1) * y); if (!filt) return 0; + line_buffer = (signed char *) STBIW_MALLOC(x * n); if (!line_buffer) { STBIW_FREE(filt); return 0; } + for (j=0; j < y; ++j) { + int filter_type; + if (force_filter > -1) { + filter_type = force_filter; + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, force_filter, line_buffer); + } else { // Estimate the best filter by running through all of them: + int best_filter = 0, best_filter_val = 0x7fffffff, est, i; + for (filter_type = 0; filter_type < 5; filter_type++) { + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, filter_type, line_buffer); + + // Estimate the entropy of the line using this filter; the less, the better. + est = 0; + for (i = 0; i < x*n; ++i) { + est += abs((signed char) line_buffer[i]); + } + if (est < best_filter_val) { + best_filter_val = est; + best_filter = filter_type; + } + } + if (filter_type != best_filter) { // If the last iteration already got us the best filter, don't redo it + stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, best_filter, line_buffer); + filter_type = best_filter; + } + } + // when we get here, filter_type contains the filter type, and line_buffer contains the data + filt[j*(x*n+1)] = (unsigned char) filter_type; + STBIW_MEMMOVE(filt+j*(x*n+1)+1, line_buffer, x*n); + } + STBIW_FREE(line_buffer); + zlib = stbi_zlib_compress(filt, y*( x*n+1), &zlen, stbi_write_png_compression_level); + STBIW_FREE(filt); + if (!zlib) return 0; + + // each tag requires 12 bytes of overhead + out = (unsigned char *) STBIW_MALLOC(8 + 12+13 + 12+zlen + 12); + if (!out) return 0; + *out_len = 8 + 12+13 + 12+zlen + 12; + + o=out; + STBIW_MEMMOVE(o,sig,8); o+= 8; + stbiw__wp32(o, 13); // header length + stbiw__wptag(o, "IHDR"); + stbiw__wp32(o, x); + stbiw__wp32(o, y); + *o++ = 8; + *o++ = STBIW_UCHAR(ctype[n]); + *o++ = 0; + *o++ = 0; + *o++ = 0; + stbiw__wpcrc(&o,13); + + stbiw__wp32(o, zlen); + stbiw__wptag(o, "IDAT"); + STBIW_MEMMOVE(o, zlib, zlen); + o += zlen; + STBIW_FREE(zlib); + stbiw__wpcrc(&o, zlen); + + stbiw__wp32(o,0); + stbiw__wptag(o, "IEND"); + stbiw__wpcrc(&o,0); + + STBIW_ASSERT(o == out + *out_len); + + return out; +} + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_png(char const *filename, int x, int y, int comp, const void *data, int stride_bytes) +{ + FILE *f; + int len; + unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len); + if (png == NULL) return 0; + + f = stbiw__fopen(filename, "wb"); + if (!f) { STBIW_FREE(png); return 0; } + fwrite(png, 1, len, f); + fclose(f); + STBIW_FREE(png); + return 1; +} +#endif + +STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int stride_bytes) +{ + int len; + unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len); + if (png == NULL) return 0; + func(context, png, len); + STBIW_FREE(png); + return 1; +} + + +/* *************************************************************************** + * + * JPEG writer + * + * This is based on Jon Olick's jo_jpeg.cpp: + * public domain Simple, Minimalistic JPEG writer - http://www.jonolick.com/code.html + */ + +static const unsigned char stbiw__jpg_ZigZag[] = { 0,1,5,6,14,15,27,28,2,4,7,13,16,26,29,42,3,8,12,17,25,30,41,43,9,11,18, + 24,31,40,44,53,10,19,23,32,39,45,52,54,20,22,33,38,46,51,55,60,21,34,37,47,50,56,59,61,35,36,48,49,57,58,62,63 }; + +static void stbiw__jpg_writeBits(stbi__write_context *s, int *bitBufP, int *bitCntP, const unsigned short *bs) { + int bitBuf = *bitBufP, bitCnt = *bitCntP; + bitCnt += bs[1]; + bitBuf |= bs[0] << (24 - bitCnt); + while(bitCnt >= 8) { + unsigned char c = (bitBuf >> 16) & 255; + stbiw__putc(s, c); + if(c == 255) { + stbiw__putc(s, 0); + } + bitBuf <<= 8; + bitCnt -= 8; + } + *bitBufP = bitBuf; + *bitCntP = bitCnt; +} + +static void stbiw__jpg_DCT(float *d0p, float *d1p, float *d2p, float *d3p, float *d4p, float *d5p, float *d6p, float *d7p) { + float d0 = *d0p, d1 = *d1p, d2 = *d2p, d3 = *d3p, d4 = *d4p, d5 = *d5p, d6 = *d6p, d7 = *d7p; + float z1, z2, z3, z4, z5, z11, z13; + + float tmp0 = d0 + d7; + float tmp7 = d0 - d7; + float tmp1 = d1 + d6; + float tmp6 = d1 - d6; + float tmp2 = d2 + d5; + float tmp5 = d2 - d5; + float tmp3 = d3 + d4; + float tmp4 = d3 - d4; + + // Even part + float tmp10 = tmp0 + tmp3; // phase 2 + float tmp13 = tmp0 - tmp3; + float tmp11 = tmp1 + tmp2; + float tmp12 = tmp1 - tmp2; + + d0 = tmp10 + tmp11; // phase 3 + d4 = tmp10 - tmp11; + + z1 = (tmp12 + tmp13) * 0.707106781f; // c4 + d2 = tmp13 + z1; // phase 5 + d6 = tmp13 - z1; + + // Odd part + tmp10 = tmp4 + tmp5; // phase 2 + tmp11 = tmp5 + tmp6; + tmp12 = tmp6 + tmp7; + + // The rotator is modified from fig 4-8 to avoid extra negations. + z5 = (tmp10 - tmp12) * 0.382683433f; // c6 + z2 = tmp10 * 0.541196100f + z5; // c2-c6 + z4 = tmp12 * 1.306562965f + z5; // c2+c6 + z3 = tmp11 * 0.707106781f; // c4 + + z11 = tmp7 + z3; // phase 5 + z13 = tmp7 - z3; + + *d5p = z13 + z2; // phase 6 + *d3p = z13 - z2; + *d1p = z11 + z4; + *d7p = z11 - z4; + + *d0p = d0; *d2p = d2; *d4p = d4; *d6p = d6; +} + +static void stbiw__jpg_calcBits(int val, unsigned short bits[2]) { + int tmp1 = val < 0 ? -val : val; + val = val < 0 ? val-1 : val; + bits[1] = 1; + while(tmp1 >>= 1) { + ++bits[1]; + } + bits[0] = val & ((1<0)&&(DU[end0pos]==0); --end0pos) { + } + // end0pos = first element in reverse order !=0 + if(end0pos == 0) { + stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB); + return DU[0]; + } + for(i = 1; i <= end0pos; ++i) { + int startpos = i; + int nrzeroes; + unsigned short bits[2]; + for (; DU[i]==0 && i<=end0pos; ++i) { + } + nrzeroes = i-startpos; + if ( nrzeroes >= 16 ) { + int lng = nrzeroes>>4; + int nrmarker; + for (nrmarker=1; nrmarker <= lng; ++nrmarker) + stbiw__jpg_writeBits(s, bitBuf, bitCnt, M16zeroes); + nrzeroes &= 15; + } + stbiw__jpg_calcBits(DU[i], bits); + stbiw__jpg_writeBits(s, bitBuf, bitCnt, HTAC[(nrzeroes<<4)+bits[1]]); + stbiw__jpg_writeBits(s, bitBuf, bitCnt, bits); + } + if(end0pos != 63) { + stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB); + } + return DU[0]; +} + +static int stbi_write_jpg_core(stbi__write_context *s, int width, int height, int comp, const void* data, int quality) { + // Constants that don't pollute global namespace + static const unsigned char std_dc_luminance_nrcodes[] = {0,0,1,5,1,1,1,1,1,1,0,0,0,0,0,0,0}; + static const unsigned char std_dc_luminance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11}; + static const unsigned char std_ac_luminance_nrcodes[] = {0,0,2,1,3,3,2,4,3,5,5,4,4,0,0,1,0x7d}; + static const unsigned char std_ac_luminance_values[] = { + 0x01,0x02,0x03,0x00,0x04,0x11,0x05,0x12,0x21,0x31,0x41,0x06,0x13,0x51,0x61,0x07,0x22,0x71,0x14,0x32,0x81,0x91,0xa1,0x08, + 0x23,0x42,0xb1,0xc1,0x15,0x52,0xd1,0xf0,0x24,0x33,0x62,0x72,0x82,0x09,0x0a,0x16,0x17,0x18,0x19,0x1a,0x25,0x26,0x27,0x28, + 0x29,0x2a,0x34,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58,0x59, + 0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x83,0x84,0x85,0x86,0x87,0x88,0x89, + 0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4,0xb5,0xb6, + 0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda,0xe1,0xe2, + 0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf1,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa + }; + static const unsigned char std_dc_chrominance_nrcodes[] = {0,0,3,1,1,1,1,1,1,1,1,1,0,0,0,0,0}; + static const unsigned char std_dc_chrominance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11}; + static const unsigned char std_ac_chrominance_nrcodes[] = {0,0,2,1,2,4,4,3,4,7,5,4,4,0,1,2,0x77}; + static const unsigned char std_ac_chrominance_values[] = { + 0x00,0x01,0x02,0x03,0x11,0x04,0x05,0x21,0x31,0x06,0x12,0x41,0x51,0x07,0x61,0x71,0x13,0x22,0x32,0x81,0x08,0x14,0x42,0x91, + 0xa1,0xb1,0xc1,0x09,0x23,0x33,0x52,0xf0,0x15,0x62,0x72,0xd1,0x0a,0x16,0x24,0x34,0xe1,0x25,0xf1,0x17,0x18,0x19,0x1a,0x26, + 0x27,0x28,0x29,0x2a,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58, + 0x59,0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x82,0x83,0x84,0x85,0x86,0x87, + 0x88,0x89,0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4, + 0xb5,0xb6,0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda, + 0xe2,0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa + }; + // Huffman tables + static const unsigned short YDC_HT[256][2] = { {0,2},{2,3},{3,3},{4,3},{5,3},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9}}; + static const unsigned short UVDC_HT[256][2] = { {0,2},{1,2},{2,2},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9},{1022,10},{2046,11}}; + static const unsigned short YAC_HT[256][2] = { + {10,4},{0,2},{1,2},{4,3},{11,4},{26,5},{120,7},{248,8},{1014,10},{65410,16},{65411,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {12,4},{27,5},{121,7},{502,9},{2038,11},{65412,16},{65413,16},{65414,16},{65415,16},{65416,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {28,5},{249,8},{1015,10},{4084,12},{65417,16},{65418,16},{65419,16},{65420,16},{65421,16},{65422,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {58,6},{503,9},{4085,12},{65423,16},{65424,16},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {59,6},{1016,10},{65430,16},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {122,7},{2039,11},{65438,16},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {123,7},{4086,12},{65446,16},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {250,8},{4087,12},{65454,16},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {504,9},{32704,15},{65462,16},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {505,9},{65470,16},{65471,16},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {506,9},{65479,16},{65480,16},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1017,10},{65488,16},{65489,16},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1018,10},{65497,16},{65498,16},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2040,11},{65506,16},{65507,16},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {65515,16},{65516,16},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2041,11},{65525,16},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0} + }; + static const unsigned short UVAC_HT[256][2] = { + {0,2},{1,2},{4,3},{10,4},{24,5},{25,5},{56,6},{120,7},{500,9},{1014,10},{4084,12},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {11,4},{57,6},{246,8},{501,9},{2038,11},{4085,12},{65416,16},{65417,16},{65418,16},{65419,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {26,5},{247,8},{1015,10},{4086,12},{32706,15},{65420,16},{65421,16},{65422,16},{65423,16},{65424,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {27,5},{248,8},{1016,10},{4087,12},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{65430,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {58,6},{502,9},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{65438,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {59,6},{1017,10},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{65446,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {121,7},{2039,11},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{65454,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {122,7},{2040,11},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{65462,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {249,8},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{65470,16},{65471,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {503,9},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{65479,16},{65480,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {504,9},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{65488,16},{65489,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {505,9},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{65497,16},{65498,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {506,9},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{65506,16},{65507,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {2041,11},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{65515,16},{65516,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}, + {16352,14},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{65525,16},{0,0},{0,0},{0,0},{0,0},{0,0}, + {1018,10},{32707,15},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0} + }; + static const int YQT[] = {16,11,10,16,24,40,51,61,12,12,14,19,26,58,60,55,14,13,16,24,40,57,69,56,14,17,22,29,51,87,80,62,18,22, + 37,56,68,109,103,77,24,35,55,64,81,104,113,92,49,64,78,87,103,121,120,101,72,92,95,98,112,100,103,99}; + static const int UVQT[] = {17,18,24,47,99,99,99,99,18,21,26,66,99,99,99,99,24,26,56,99,99,99,99,99,47,66,99,99,99,99,99,99, + 99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99}; + static const float aasf[] = { 1.0f * 2.828427125f, 1.387039845f * 2.828427125f, 1.306562965f * 2.828427125f, 1.175875602f * 2.828427125f, + 1.0f * 2.828427125f, 0.785694958f * 2.828427125f, 0.541196100f * 2.828427125f, 0.275899379f * 2.828427125f }; + + int row, col, i, k, subsample; + float fdtbl_Y[64], fdtbl_UV[64]; + unsigned char YTable[64], UVTable[64]; + + if(!data || !width || !height || comp > 4 || comp < 1) { + return 0; + } + + quality = quality ? quality : 90; + subsample = quality <= 90 ? 1 : 0; + quality = quality < 1 ? 1 : quality > 100 ? 100 : quality; + quality = quality < 50 ? 5000 / quality : 200 - quality * 2; + + for(i = 0; i < 64; ++i) { + int uvti, yti = (YQT[i]*quality+50)/100; + YTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (yti < 1 ? 1 : yti > 255 ? 255 : yti); + uvti = (UVQT[i]*quality+50)/100; + UVTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (uvti < 1 ? 1 : uvti > 255 ? 255 : uvti); + } + + for(row = 0, k = 0; row < 8; ++row) { + for(col = 0; col < 8; ++col, ++k) { + fdtbl_Y[k] = 1 / (YTable [stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]); + fdtbl_UV[k] = 1 / (UVTable[stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]); + } + } + + // Write Headers + { + static const unsigned char head0[] = { 0xFF,0xD8,0xFF,0xE0,0,0x10,'J','F','I','F',0,1,1,0,0,1,0,1,0,0,0xFF,0xDB,0,0x84,0 }; + static const unsigned char head2[] = { 0xFF,0xDA,0,0xC,3,1,0,2,0x11,3,0x11,0,0x3F,0 }; + const unsigned char head1[] = { 0xFF,0xC0,0,0x11,8,(unsigned char)(height>>8),STBIW_UCHAR(height),(unsigned char)(width>>8),STBIW_UCHAR(width), + 3,1,(unsigned char)(subsample?0x22:0x11),0,2,0x11,1,3,0x11,1,0xFF,0xC4,0x01,0xA2,0 }; + s->func(s->context, (void*)head0, sizeof(head0)); + s->func(s->context, (void*)YTable, sizeof(YTable)); + stbiw__putc(s, 1); + s->func(s->context, UVTable, sizeof(UVTable)); + s->func(s->context, (void*)head1, sizeof(head1)); + s->func(s->context, (void*)(std_dc_luminance_nrcodes+1), sizeof(std_dc_luminance_nrcodes)-1); + s->func(s->context, (void*)std_dc_luminance_values, sizeof(std_dc_luminance_values)); + stbiw__putc(s, 0x10); // HTYACinfo + s->func(s->context, (void*)(std_ac_luminance_nrcodes+1), sizeof(std_ac_luminance_nrcodes)-1); + s->func(s->context, (void*)std_ac_luminance_values, sizeof(std_ac_luminance_values)); + stbiw__putc(s, 1); // HTUDCinfo + s->func(s->context, (void*)(std_dc_chrominance_nrcodes+1), sizeof(std_dc_chrominance_nrcodes)-1); + s->func(s->context, (void*)std_dc_chrominance_values, sizeof(std_dc_chrominance_values)); + stbiw__putc(s, 0x11); // HTUACinfo + s->func(s->context, (void*)(std_ac_chrominance_nrcodes+1), sizeof(std_ac_chrominance_nrcodes)-1); + s->func(s->context, (void*)std_ac_chrominance_values, sizeof(std_ac_chrominance_values)); + s->func(s->context, (void*)head2, sizeof(head2)); + } + + // Encode 8x8 macroblocks + { + static const unsigned short fillBits[] = {0x7F, 7}; + int DCY=0, DCU=0, DCV=0; + int bitBuf=0, bitCnt=0; + // comp == 2 is grey+alpha (alpha is ignored) + int ofsG = comp > 2 ? 1 : 0, ofsB = comp > 2 ? 2 : 0; + const unsigned char *dataR = (const unsigned char *)data; + const unsigned char *dataG = dataR + ofsG; + const unsigned char *dataB = dataR + ofsB; + int x, y, pos; + if(subsample) { + for(y = 0; y < height; y += 16) { + for(x = 0; x < width; x += 16) { + float Y[256], U[256], V[256]; + for(row = y, pos = 0; row < y+16; ++row) { + // row >= height => use last input row + int clamped_row = (row < height) ? row : height - 1; + int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp; + for(col = x; col < x+16; ++col, ++pos) { + // if col >= width => use pixel from last input column + int p = base_p + ((col < width) ? col : (width-1))*comp; + float r = dataR[p], g = dataG[p], b = dataB[p]; + Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128; + U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b; + V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b; + } + } + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+0, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+8, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+128, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+136, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT); + + // subsample U,V + { + float subU[64], subV[64]; + int yy, xx; + for(yy = 0, pos = 0; yy < 8; ++yy) { + for(xx = 0; xx < 8; ++xx, ++pos) { + int j = yy*32+xx*2; + subU[pos] = (U[j+0] + U[j+1] + U[j+16] + U[j+17]) * 0.25f; + subV[pos] = (V[j+0] + V[j+1] + V[j+16] + V[j+17]) * 0.25f; + } + } + DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subU, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT); + DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subV, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT); + } + } + } + } else { + for(y = 0; y < height; y += 8) { + for(x = 0; x < width; x += 8) { + float Y[64], U[64], V[64]; + for(row = y, pos = 0; row < y+8; ++row) { + // row >= height => use last input row + int clamped_row = (row < height) ? row : height - 1; + int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp; + for(col = x; col < x+8; ++col, ++pos) { + // if col >= width => use pixel from last input column + int p = base_p + ((col < width) ? col : (width-1))*comp; + float r = dataR[p], g = dataG[p], b = dataB[p]; + Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128; + U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b; + V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b; + } + } + + DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y, 8, fdtbl_Y, DCY, YDC_HT, YAC_HT); + DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, U, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT); + DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, V, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT); + } + } + } + + // Do the bit alignment of the EOI marker + stbiw__jpg_writeBits(s, &bitBuf, &bitCnt, fillBits); + } + + // EOI + stbiw__putc(s, 0xFF); + stbiw__putc(s, 0xD9); + + return 1; +} + +STBIWDEF int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality) +{ + stbi__write_context s = { 0 }; + stbi__start_write_callbacks(&s, func, context); + return stbi_write_jpg_core(&s, x, y, comp, (void *) data, quality); +} + + +#ifndef STBI_WRITE_NO_STDIO +STBIWDEF int stbi_write_jpg(char const *filename, int x, int y, int comp, const void *data, int quality) +{ + stbi__write_context s = { 0 }; + if (stbi__start_write_file(&s,filename)) { + int r = stbi_write_jpg_core(&s, x, y, comp, data, quality); + stbi__end_write_file(&s); + return r; + } else + return 0; +} +#endif + +#endif // STB_IMAGE_WRITE_IMPLEMENTATION + +/* Revision history + 1.16 (2021-07-11) + make Deflate code emit uncompressed blocks when it would otherwise expand + support writing BMPs with alpha channel + 1.15 (2020-07-13) unknown + 1.14 (2020-02-02) updated JPEG writer to downsample chroma channels + 1.13 + 1.12 + 1.11 (2019-08-11) + + 1.10 (2019-02-07) + support utf8 filenames in Windows; fix warnings and platform ifdefs + 1.09 (2018-02-11) + fix typo in zlib quality API, improve STB_I_W_STATIC in C++ + 1.08 (2018-01-29) + add stbi__flip_vertically_on_write, external zlib, zlib quality, choose PNG filter + 1.07 (2017-07-24) + doc fix + 1.06 (2017-07-23) + writing JPEG (using Jon Olick's code) + 1.05 ??? + 1.04 (2017-03-03) + monochrome BMP expansion + 1.03 ??? + 1.02 (2016-04-02) + avoid allocating large structures on the stack + 1.01 (2016-01-16) + STBIW_REALLOC_SIZED: support allocators with no realloc support + avoid race-condition in crc initialization + minor compile issues + 1.00 (2015-09-14) + installable file IO function + 0.99 (2015-09-13) + warning fixes; TGA rle support + 0.98 (2015-04-08) + added STBIW_MALLOC, STBIW_ASSERT etc + 0.97 (2015-01-18) + fixed HDR asserts, rewrote HDR rle logic + 0.96 (2015-01-17) + add HDR output + fix monochrome BMP + 0.95 (2014-08-17) + add monochrome TGA output + 0.94 (2014-05-31) + rename private functions to avoid conflicts with stb_image.h + 0.93 (2014-05-27) + warning fixes + 0.92 (2010-08-01) + casts to unsigned char to fix warnings + 0.91 (2010-07-17) + first public release + 0.90 first internal release +*/ + +/* +------------------------------------------------------------------------------ +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. +------------------------------------------------------------------------------ +*/ diff --git a/tools/fixtures/320x200.png b/tools/fixtures/320x200.png new file mode 100644 index 0000000000000000000000000000000000000000..1a40787ead633add21670ca23334e6ab5d582388 GIT binary patch literal 502 zcmeAS@N?(olHy`uVBq!ia0y~yU~~YoPjD~+NwKu`e}DpeJzX3_DsH{K?8wQ$z`=6x zbc)(xsnY`cS{gk!Y?!I{V5J8G8ygRggaim17$hWs@PPv$+|bC#+ziCbAO+YIH8dW? zs%Q-pvQaox85m$w1hfm;K9Ur{Tn%v)+$5OSAl8wj2=0G~o8Trzuwo4*R8=GeCD!nc a(Ya@H|4&2Ax(&eiWbkzLb6Mw<&;$VBk$``2_j6xdp@o1cgOJMMZh|#U;coyG6VInuyV4pa*FVB^NNrR z{vTivX!XqN1l2cOC(lau%ic3n%$}1|Xnp;}i+B-VC zCQY6)b=ve9GiNPYykzOJeA&aSFc^aar4&0 zM~|O8efIpt%U2&ieg5+G+xH(oe}VkP$iNKo7LbH^49#DHKz}i@urRZ*gZ#zFR1U<< zf-J0xhHOHPf$WKe!b(Ps93oB=7j8VrscandK{To8BA1wo$wSqTAg_UaMx4i*$nqK7 jV+eoUV&GwB1V$dSAcH-_pY@Bnv`%noENXyZ`~Noq+u6ul literal 0 HcmV?d00001 diff --git a/tools/fixtures/tiny.jpg b/tools/fixtures/tiny.jpg new file mode 100644 index 0000000000000000000000000000000000000000..39c449f61e4e697713d3c99d3daf213a554366a2 GIT binary patch literal 633 zcmex=``2_j6xdp@o1cgOJMMZh|#U;coyG6VInuyV4pa*FVB^NNrR z{vTivNsy6Qkn#T!26>=6SsB5A0SXwIfNo@C=iubx1}fMpz`(@F%*@2X z401J4buCbyfklv2NYT)dO*k--U8zvSsBz*#4rQl}2StM}eo!$^Dr(~75)+q@lu}hw z*U;25F*P%{u(Wb^admU|@bn4}2@MO6h>S{3Nli=7$jmA(DJ?6nsH|#kX>Duo=8f2KE_o9%~}YXK;@p d{B?_ghnW!=dCY`wr5A*;4 literal 0 HcmV?d00001 diff --git a/tools/image_smoke.cpp b/tools/image_smoke.cpp new file mode 100644 index 00000000..60f9a748 --- /dev/null +++ b/tools/image_smoke.cpp @@ -0,0 +1,111 @@ +// Step 5 smoke: PNG / JPEG / truncated PNG / non-image / size limit. +#include "image_util.hpp" + +#include +#include +#include +#include +#include +#include + +#ifndef IMAGE_SMOKE_FIXTURES +#define IMAGE_SMOKE_FIXTURES "tools/fixtures" +#endif + +namespace { + +std::vector read_all(const std::string& path) { + std::ifstream in(path, std::ios::binary); + if (!in) { + throw std::runtime_error("cannot open " + path); + } + return std::vector((std::istreambuf_iterator(in)), + std::istreambuf_iterator()); +} + +bool expect_ok(const char* name, const std::vector& bytes, + const char* want_ct) { + ImageLimits lim; + ImageInfo info; + auto rej = validate_image(bytes.data(), bytes.size(), lim, info); + if (rej) { + std::cerr << name << ": expected OK, got " << image_reject_code(*rej) + << "\n"; + return false; + } + if (info.content_type != want_ct) { + std::cerr << name << ": content_type " << info.content_type << "\n"; + return false; + } + std::cout << name << ": OK " << info.content_type << " " << info.width + << "x" << info.height << "\n"; + return true; +} + +bool expect_reject(const char* name, const std::vector& bytes, + ImageReject want) { + ImageLimits lim; + ImageInfo info; + auto rej = validate_image(bytes.data(), bytes.size(), lim, info); + if (!rej || *rej != want) { + std::cerr << name << ": expected " << image_reject_code(want) << ", got " + << (rej ? image_reject_code(*rej) : "OK") << "\n"; + return false; + } + std::cout << name << ": OK reject=" << image_reject_code(want) << "\n"; + return true; +} + +} // namespace + +int main(int argc, char** argv) { + try { + const std::string dir = + (argc > 1) ? argv[1] : std::string(IMAGE_SMOKE_FIXTURES); + const auto png = read_all(dir + "/tiny.png"); + const auto jpg = read_all(dir + "/tiny.jpg"); + + bool ok = true; + ok &= expect_ok("png", png, "image/png"); + ok &= expect_ok("jpeg", jpg, "image/jpeg"); + + std::vector trunc(png.begin(), + png.begin() + std::min(16, png.size())); + ok &= expect_reject("truncated_png", trunc, ImageReject::invalid_image); + + std::vector spoof = jpg; + spoof[0] = 'G'; + spoof[1] = 'I'; + spoof[2] = 'F'; + ok &= expect_reject("not_image", spoof, ImageReject::unsupported_media_type); + + ImageLimits tiny_lim; + tiny_lim.max_bytes = 10; + ImageInfo info; + auto rej = validate_image(png.data(), png.size(), tiny_lim, info); + if (!rej || *rej != ImageReject::payload_too_large) { + std::cerr << "max_bytes: FAIL\n"; + ok = false; + } else { + std::cout << "max_bytes: OK\n"; + } + + // JPEG bytes sniffed as jpeg regardless of any HTTP Content-Type. + auto sniffed = sniff_content_type(jpg.data(), jpg.size()); + if (!sniffed || *sniffed != "image/jpeg") { + std::cerr << "sniff_jpeg: FAIL\n"; + ok = false; + } else { + std::cout << "sniff_jpeg: OK (MIME spoof would be ignored)\n"; + } + + if (!ok) { + return 1; + } + std::cout << "image_smoke: OK\n"; + return 0; + } catch (const std::exception& e) { + std::cerr << "image_smoke: FAIL: " << e.what() << "\n"; + return 1; + } +} diff --git a/tools/s3_smoke.cpp b/tools/s3_smoke.cpp new file mode 100644 index 00000000..26cc1331 --- /dev/null +++ b/tools/s3_smoke.cpp @@ -0,0 +1,35 @@ +// Small smoke tool for step 4: put → get → delete against MinIO. +#include "s3_client.hpp" + +#include +#include +#include +#include +#include + +int main() { + try { + auto cfg = S3Client::from_env(); + S3Client s3(cfg); + + const std::string key = "smoke/step4.txt"; + const std::string payload = "lab4-s3-smoke-ok"; + std::istringstream in(payload); + s3.put_object(key, in, static_cast(payload.size()), + "text/plain"); + + std::ostringstream out; + s3.get_object(key, out); + if (out.str() != payload) { + std::cerr << "mismatch: got [" << out.str() << "]\n"; + return 2; + } + + s3.delete_object(key); + std::cout << "s3_smoke: OK bucket=" << cfg.bucket << " key=" << key << "\n"; + return 0; + } catch (const std::exception& e) { + std::cerr << "s3_smoke: FAIL: " << e.what() << "\n"; + return 1; + } +} diff --git a/tools/thumbnail_smoke.cpp b/tools/thumbnail_smoke.cpp new file mode 100644 index 00000000..1cb3c91d --- /dev/null +++ b/tools/thumbnail_smoke.cpp @@ -0,0 +1,24 @@ +#include "image_pipeline.hpp" +#include +#include +#include + +int main(int argc, char** argv) { + if (argc != 3) { + std::cerr << "usage: thumbnail_smoke INPUT OUTPUT.jpg\n"; + return 2; + } + try { + std::ifstream input(argv[1], std::ios::binary); + if (!input) return 1; + const std::vector bytes((std::istreambuf_iterator(input)), {}); + const auto image = make_thumbnail(bytes); + std::ofstream output(argv[2], std::ios::binary); + output.write(image.bytes.data(), image.bytes.size()); + if (!output) return 1; + std::cout << image.width << 'x' << image.height << '\n'; + } catch (const std::exception& e) { + std::cerr << e.what() << '\n'; + return 1; + } +} diff --git a/tools/variants_smoke.cpp b/tools/variants_smoke.cpp new file mode 100644 index 00000000..17aa8825 --- /dev/null +++ b/tools/variants_smoke.cpp @@ -0,0 +1,32 @@ +#include "image_pipeline.hpp" +#include +#include +#include +#include +#include + +int main(int argc, char** argv) { + if (argc != 3) return 2; + try { + std::ifstream input(argv[1], std::ios::binary); + if (!input) return 1; + const std::vector bytes((std::istreambuf_iterator(input)), {}); + const auto variants = make_variants(bytes); + std::filesystem::create_directories(argv[2]); + nlohmann::json manifest; + for (const auto& v : variants) { + const auto path = std::filesystem::path(argv[2]) / + (v.name + (v.content_type == "image/webp" ? ".webp" : ".jpg")); + std::ofstream out(path, std::ios::binary); + out.write(v.image.bytes.data(), v.image.bytes.size()); + if (!out) return 1; + manifest[v.name] = {{"width", v.image.width}, {"height", v.image.height}, + {"size_bytes", v.image.bytes.size()}}; + } + std::cout << manifest.dump() << '\n'; + return 0; + } catch (const std::exception& e) { + std::cerr << e.what() << '\n'; + return 1; + } +} -- 2.54.0