From 2c643aa704abd3b728c2f9d1cbb8b554e1626efa Mon Sep 17 00:00:00 2001 From: Nigel Tao Date: Thu, 14 May 2020 21:44:03 +1000 Subject: [PATCH] Add example/convert-to-nia --- doc/changelog.md | 1 + example/convert-to-nia/convert-to-nia.c | 557 ++++++++++++++++++++++++ test/data/animated-red-blue.nia | Bin 0 -> 49272 bytes test/data/hippopotamus.nie | Bin 0 -> 4048 bytes 4 files changed, 558 insertions(+) create mode 100644 example/convert-to-nia/convert-to-nia.c create mode 100644 test/data/animated-red-blue.nia create mode 100644 test/data/hippopotamus.nie diff --git a/doc/changelog.md b/doc/changelog.md index d4532cfd..c80763d8 100644 --- a/doc/changelog.md +++ b/doc/changelog.md @@ -8,6 +8,7 @@ - Added `base` library support for UTF-8. - Added `base` library support for `atoi`-like string conversion. - Added `endwhile` syntax. +- Added `example/convert-to-nia`. - Added `example/imageviewer`. - Added `example/jsonptr`. - Added `std/bmp`. diff --git a/example/convert-to-nia/convert-to-nia.c b/example/convert-to-nia/convert-to-nia.c new file mode 100644 index 00000000..c8a79278 --- /dev/null +++ b/example/convert-to-nia/convert-to-nia.c @@ -0,0 +1,557 @@ +// Copyright 2020 The Wuffs Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// https://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// ---------------- + +/* +convert-to-nia converts an image from stdin (e.g. in the BMP, GIF, JPEG or PNG +format) to stdout (in the NIA/NIE format). + +See the "const char* g_usage" string below for details. +*/ + +#include +#include +#include + +// Wuffs ships as a "single file C library" or "header file library" as per +// https://github.com/nothings/stb/blob/master/docs/stb_howto.txt +// +// To use that single file as a "foo.c"-like implementation, instead of a +// "foo.h"-like header, #define WUFFS_IMPLEMENTATION before #include'ing or +// compiling it. +#define WUFFS_IMPLEMENTATION + +// Defining the WUFFS_CONFIG__MODULE* macros are optional, but it lets users of +// release/c/etc.c whitelist which parts of Wuffs to build. That file contains +// the entire Wuffs standard library, implementing a variety of codecs and file +// formats. Without this macro definition, an optimizing compiler or linker may +// very well discard Wuffs code for unused codecs, but listing the Wuffs +// modules we use makes that process explicit. Preprocessing means that such +// code simply isn't compiled. +#define WUFFS_CONFIG__MODULES +#define WUFFS_CONFIG__MODULE__BASE +#define WUFFS_CONFIG__MODULE__BMP +#define WUFFS_CONFIG__MODULE__GIF +#define WUFFS_CONFIG__MODULE__LZW +#define WUFFS_CONFIG__MODULE__WBMP + +// If building this program in an environment that doesn't easily accommodate +// relative includes, you can use the script/inline-c-relative-includes.go +// program to generate a stand-alone C file. +#include "../../release/c/wuffs-unsupported-snapshot.c" + +// ---- + +#if defined(__linux__) +#include +#include +#include +#include +#define WUFFS_EXAMPLE_USE_SECCOMP +#endif + +#define TRY(error_msg) \ + do { \ + const char* z = error_msg; \ + if (z) { \ + return z; \ + } \ + } while (false) + +static const char* g_usage = + "Usage: convert-to-nia -flags < src.img > dst.nia\n" + "\n" + "Flags:\n" + " -1 -first-frame-only\n" + " -fail-if-unsandboxed\n" + "\n" + "convert-to-nia converts an image from stdin (e.g. in the BMP, GIF, JPEG\n" + "or PNG format) to stdout (in the NIA format, or in the NIE format if\n" + "the -first-frame-only flag is given).\n" + "\n" + "NIA/NIE is a trivial animated/still image file format, specified at\n" + "https://github.com/google/wuffs/blob/master/doc/spec/nie-spec.md\n" + "\n" + "The -fail-if-unsandboxed flag causes the program to exit if it does not\n" + "self-impose a sandbox. On Linux, it self-imposes a SECCOMP_MODE_STRICT\n" + "sandbox, regardless of whether this flag was set."; + +// ---- + +#define STDIN_FD 0 +#define STDOUT_FD 1 +#define STDERR_FD 2 + +bool g_sandboxed = false; + +wuffs_base__pixel_buffer g_pixbuf = {0}; +wuffs_base__slice_u8 g_pixbuf_slice = {0}; +wuffs_base__slice_u8 g_pixbuf_backup_slice = {0}; +wuffs_base__io_buffer g_src = {0}; +wuffs_base__slice_u8 g_workbuf_slice = {0}; + +wuffs_base__image_config g_image_config = {0}; +wuffs_base__frame_config g_frame_config = {0}; +uint32_t g_width = 0; +uint32_t g_height = 0; + +wuffs_base__image_decoder* g_image_decoder = NULL; +union { + wuffs_bmp__decoder bmp; + wuffs_gif__decoder gif; + wuffs_wbmp__decoder wbmp; +} g_potential_decoders; + +// ---- + +#define BYTES_PER_PIXEL 4 + +#ifndef MAX_DIMENSION +#define MAX_DIMENSION 65535 +#endif + +#ifndef SRC_BUFFER_ARRAY_SIZE +#define SRC_BUFFER_ARRAY_SIZE (64 * 1024) +#endif + +#ifndef WORKBUF_ARRAY_SIZE +#define WORKBUF_ARRAY_SIZE (1024 * 1024) +#endif + +#ifndef PIXBUF_ARRAY_SIZE +#define PIXBUF_ARRAY_SIZE (256 * 1024 * 1024) +#endif + +uint8_t g_src_buffer_array[SRC_BUFFER_ARRAY_SIZE] = {0}; +uint8_t g_workbuf_array[WORKBUF_ARRAY_SIZE] = {0}; +uint8_t g_pixbuf_array[PIXBUF_ARRAY_SIZE] = {0}; + +// ---- + +struct { + int remaining_argc; + char** remaining_argv; + + bool fail_if_unsandboxed; + bool first_frame_only; +} g_flags = {0}; + +const char* // +parse_flags(int argc, char** argv) { + int c = (argc > 0) ? 1 : 0; // Skip argv[0], the program name. + for (; c < argc; c++) { + char* arg = argv[c]; + if (*arg++ != '-') { + break; + } + + // A double-dash "--foo" is equivalent to a single-dash "-foo". As special + // cases, a bare "-" is not a flag (some programs may interpret it as + // stdin) and a bare "--" means to stop parsing flags. + if (*arg == '\x00') { + break; + } else if (*arg == '-') { + arg++; + if (*arg == '\x00') { + c++; + break; + } + } + + if (!strcmp(arg, "fail-if-unsandboxed")) { + g_flags.fail_if_unsandboxed = true; + continue; + } + if (!strcmp(arg, "1") || !strcmp(arg, "first-frame-only")) { + g_flags.first_frame_only = true; + continue; + } + + return g_usage; + } + + g_flags.remaining_argc = argc - c; + g_flags.remaining_argv = argv + c; + return NULL; +} + +// ---- + +// ignore_return_value suppresses errors from -Wall -Werror. +static void // +ignore_return_value(int ignored) {} + +const char* // +read_more_src() { + if (g_src.meta.closed) { + return "main: unexpected end of file"; + } + wuffs_base__io_buffer__compact(&g_src); + ssize_t n = read(STDIN_FD, g_src.data.ptr + g_src.meta.wi, + g_src.data.len - g_src.meta.wi); + if (n > 0) { + g_src.meta.wi += n; + } else if (errno == 0) { + if (n < 0) { + return "main: unexpected negative-count read"; + } + g_src.meta.closed = true; + } else if (errno != EINTR) { + return strerror(errno); + } + return NULL; +} + +const char* // +load_image_type() { + while (g_src.meta.ri >= g_src.meta.wi) { + TRY(read_more_src()); + } + + wuffs_base__status status; + switch (g_src_buffer_array[0]) { + case '\x00': + status = wuffs_wbmp__decoder__initialize( + &g_potential_decoders.wbmp, sizeof g_potential_decoders.wbmp, + WUFFS_VERSION, WUFFS_INITIALIZE__DEFAULT_OPTIONS); + TRY(wuffs_base__status__message(&status)); + g_image_decoder = + wuffs_wbmp__decoder__upcast_as__wuffs_base__image_decoder( + &g_potential_decoders.wbmp); + break; + + case 'B': + status = wuffs_bmp__decoder__initialize( + &g_potential_decoders.bmp, sizeof g_potential_decoders.bmp, + WUFFS_VERSION, WUFFS_INITIALIZE__DEFAULT_OPTIONS); + TRY(wuffs_base__status__message(&status)); + g_image_decoder = + wuffs_bmp__decoder__upcast_as__wuffs_base__image_decoder( + &g_potential_decoders.bmp); + break; + + case 'G': + status = wuffs_gif__decoder__initialize( + &g_potential_decoders.gif, sizeof g_potential_decoders.gif, + WUFFS_VERSION, WUFFS_INITIALIZE__DEFAULT_OPTIONS); + TRY(wuffs_base__status__message(&status)); + g_image_decoder = + wuffs_gif__decoder__upcast_as__wuffs_base__image_decoder( + &g_potential_decoders.gif); + break; + + default: + return "main: unrecognized file format"; + } + return NULL; +} + +const char* // +load_image_config() { + // Decode the wuffs_base__image_config. + while (true) { + wuffs_base__status status = wuffs_base__image_decoder__decode_image_config( + g_image_decoder, &g_image_config, &g_src); + if (status.repr == NULL) { + break; + } else if (status.repr != wuffs_base__suspension__short_read) { + return wuffs_base__status__message(&status); + } + TRY(read_more_src()); + } + + // Read the dimensions. + uint32_t w = wuffs_base__pixel_config__width(&g_image_config.pixcfg); + uint32_t h = wuffs_base__pixel_config__height(&g_image_config.pixcfg); + if ((w > MAX_DIMENSION) || (h > MAX_DIMENSION)) { + return "main: image is too large"; + } + g_width = w; + g_height = h; + + // Override the image's native pixel format to be BGRA_NONPREMUL. + wuffs_base__pixel_config__set(&g_image_config.pixcfg, + WUFFS_BASE__PIXEL_FORMAT__BGRA_NONPREMUL, + WUFFS_BASE__PIXEL_SUBSAMPLING__NONE, w, h); + + // Configure the work buffer. + uint64_t workbuf_len = + wuffs_base__image_decoder__workbuf_len(g_image_decoder).max_incl; + if (workbuf_len > WORKBUF_ARRAY_SIZE) { + return "main: image is too large (to configure work buffer)"; + } + g_workbuf_slice.ptr = &g_workbuf_array[0]; + g_workbuf_slice.len = workbuf_len; + + // Configure the pixel buffer and (if there's capacity) its backup buffer. + uint64_t num_pixels = ((uint64_t)w) * ((uint64_t)h); + if (num_pixels > (PIXBUF_ARRAY_SIZE / BYTES_PER_PIXEL)) { + return "main: image is too large (to configure pixel buffer)"; + } + g_pixbuf_slice.ptr = &g_pixbuf_array[0]; + g_pixbuf_slice.len = num_pixels * BYTES_PER_PIXEL; + size_t pixbuf_array_remaining = PIXBUF_ARRAY_SIZE - g_pixbuf_slice.len; + if (pixbuf_array_remaining >= g_pixbuf_slice.len) { + g_pixbuf_backup_slice.ptr = &g_pixbuf_array[g_pixbuf_slice.len]; + g_pixbuf_backup_slice.len = g_pixbuf_slice.len; + } + + // Configure the wuffs_base__pixel_buffer struct. + wuffs_base__status status = wuffs_base__pixel_buffer__set_from_slice( + &g_pixbuf, &g_image_config.pixcfg, g_pixbuf_slice); + TRY(wuffs_base__status__message(&status)); + + wuffs_base__table_u8 tab = wuffs_base__pixel_buffer__plane(&g_pixbuf, 0); + if ((tab.width != (g_width * BYTES_PER_PIXEL)) || (tab.height != g_height)) { + return "main: inconsistent pixel buffer dimensions"; + } + + return NULL; +} + +void // +fill_rectangle(wuffs_base__rect_ie_u32 rect, + wuffs_base__color_u32_argb_premul color) { + if (rect.max_excl_x > g_width) { + rect.max_excl_x = g_width; + } + if (rect.max_excl_y > g_height) { + rect.max_excl_y = g_height; + } + uint32_t nonpremul = wuffs_base__nonpremul_u32_axxx(color); + wuffs_base__table_u8 tab = wuffs_base__pixel_buffer__plane(&g_pixbuf, 0); + + uint32_t y; + for (y = rect.min_incl_y; y < rect.max_excl_y; y++) { + uint8_t* p = + tab.ptr + (y * tab.stride) + (rect.min_incl_x * BYTES_PER_PIXEL); + uint32_t x; + for (x = rect.min_incl_x; x < rect.max_excl_x; x++) { + wuffs_base__store_u32le__no_bounds_check(p, nonpremul); + p += BYTES_PER_PIXEL; + } + } +} + +void // +print_nix_header(uint32_t magic_u32le) { + static const uint32_t version1_bn4_u32le = 0x346E62FF; + uint8_t data[16]; + wuffs_base__store_u32le__no_bounds_check(data + 0x00, magic_u32le); + wuffs_base__store_u32le__no_bounds_check(data + 0x04, version1_bn4_u32le); + wuffs_base__store_u32le__no_bounds_check(data + 0x08, g_width); + wuffs_base__store_u32le__no_bounds_check(data + 0x0C, g_height); + ignore_return_value(write(STDOUT_FD, &data[0], 16)); +} + +void // +print_nia_duration(wuffs_base__flicks duration) { + uint8_t data[8]; + wuffs_base__store_u64le__no_bounds_check(data + 0x00, duration); + ignore_return_value(write(STDOUT_FD, &data[0], 8)); +} + +void // +print_nie_frame() { + print_nix_header(0x45AFC36E); // "nïE" as a u32le. + wuffs_base__table_u8 tab = wuffs_base__pixel_buffer__plane(&g_pixbuf, 0); + if (tab.width == tab.stride) { + ignore_return_value(write(STDOUT_FD, tab.ptr, tab.width * tab.height)); + } else { + size_t y; + for (y = 0; y < tab.height; y++) { + ignore_return_value( + write(STDOUT_FD, tab.ptr + (y * tab.stride), tab.width)); + break; + } + } +} + +void // +print_nia_padding() { + if (g_width & g_height & 1) { + uint8_t data[4]; + wuffs_base__store_u32le__no_bounds_check(data + 0x00, 0); + ignore_return_value(write(STDOUT_FD, &data[0], 4)); + } +} + +void // +print_nia_footer() { + uint8_t data[8]; + wuffs_base__store_u32le__no_bounds_check( + data + 0x00, + wuffs_base__image_decoder__num_animation_loops(g_image_decoder)); + wuffs_base__store_u32le__no_bounds_check(data + 0x04, 0x80000000); + ignore_return_value(write(STDOUT_FD, &data[0], 8)); +} + +const char* // +main1(int argc, char** argv) { + TRY(parse_flags(argc, argv)); + if (g_flags.fail_if_unsandboxed && !g_sandboxed) { + return "main: unsandboxed"; + } + + g_src.data.ptr = g_src_buffer_array; + g_src.data.len = SRC_BUFFER_ARRAY_SIZE; + + TRY(load_image_type()); + TRY(load_image_config()); + if (!g_flags.first_frame_only) { + print_nix_header(0x41AFC36E); // "nïA" as a u32le. + } + + wuffs_base__flicks total_duration = 0; + while (true) { + // Decode the wuffs_base__frame_config. + while (true) { + wuffs_base__status dfc_status = + wuffs_base__image_decoder__decode_frame_config( + g_image_decoder, &g_frame_config, &g_src); + if (dfc_status.repr == NULL) { + break; + } else if (dfc_status.repr == wuffs_base__note__end_of_data) { + goto done; + } else if (dfc_status.repr != wuffs_base__suspension__short_read) { + return wuffs_base__status__message(&dfc_status); + } + TRY(read_more_src()); + } + + wuffs_base__flicks duration = + wuffs_base__frame_config__duration(&g_frame_config); + if (duration < 0) { + return "main: animation frame duration is negative"; + } else if (total_duration > (INT64_MAX - duration)) { + return "main: animation frame duration overflow"; + } + total_duration += duration; + if (!g_flags.first_frame_only) { + print_nia_duration(total_duration); + } + + if (wuffs_base__frame_config__index(&g_frame_config) == 0) { + fill_rectangle( + wuffs_base__pixel_config__bounds(&g_image_config.pixcfg), + wuffs_base__frame_config__background_color(&g_frame_config)); + } + + switch (wuffs_base__frame_config__disposal(&g_frame_config)) { + case WUFFS_BASE__ANIMATION_DISPOSAL__RESTORE_PREVIOUS: { + if (g_pixbuf_slice.len != g_pixbuf_backup_slice.len) { + return "main: image is too large (to configure pixel backup buffer)"; + } + memcpy(g_pixbuf_backup_slice.ptr, g_pixbuf_slice.ptr, + g_pixbuf_slice.len); + break; + } + } + + // Decode the frame (the pixels). + wuffs_base__status df_status; + while (true) { + df_status = wuffs_base__image_decoder__decode_frame( + g_image_decoder, &g_pixbuf, &g_src, + wuffs_base__frame_config__overwrite_instead_of_blend(&g_frame_config) + ? WUFFS_BASE__PIXEL_BLEND__SRC + : WUFFS_BASE__PIXEL_BLEND__SRC_OVER, + g_workbuf_slice, NULL); + if (df_status.repr != wuffs_base__suspension__short_read) { + break; + } + TRY(read_more_src()); + } + + print_nie_frame(); + + if (df_status.repr != NULL) { + return wuffs_base__status__message(&df_status); + } else if (g_flags.first_frame_only) { + return NULL; + } + print_nia_padding(); + + switch (wuffs_base__frame_config__disposal(&g_frame_config)) { + case WUFFS_BASE__ANIMATION_DISPOSAL__RESTORE_BACKGROUND: { + fill_rectangle( + wuffs_base__frame_config__bounds(&g_frame_config), + wuffs_base__frame_config__background_color(&g_frame_config)); + break; + } + case WUFFS_BASE__ANIMATION_DISPOSAL__RESTORE_PREVIOUS: { + if (g_pixbuf_slice.len != g_pixbuf_backup_slice.len) { + return "main: image is too large (to configure pixel backup buffer)"; + } + memcpy(g_pixbuf_slice.ptr, g_pixbuf_backup_slice.ptr, + g_pixbuf_slice.len); + break; + } + } + } + +done: + print_nia_footer(); + return NULL; +} + +int // +compute_exit_code(const char* status_msg) { + if (!status_msg) { + return 0; + } + size_t n; + if (status_msg == g_usage) { + n = strlen(status_msg); + } else { + n = strnlen(status_msg, 2047); + if (n >= 2047) { + status_msg = "main: internal error: error message is too long"; + n = strnlen(status_msg, 2047); + } + } + ignore_return_value(write(STDERR_FD, status_msg, n)); + ignore_return_value(write(STDERR_FD, "\n", 1)); + // Return an exit code of 1 for regular (forseen) errors, e.g. badly + // formatted or unsupported input. + // + // Return an exit code of 2 for internal (exceptional) errors, e.g. defensive + // run-time checks found that an internal invariant did not hold. + // + // Automated testing, including badly formatted inputs, can therefore + // discriminate between expected failure (exit code 1) and unexpected failure + // (other non-zero exit codes). Specifically, exit code 2 for internal + // invariant violation, exit code 139 (which is 128 + SIGSEGV on x86_64 + // linux) for a segmentation fault (e.g. null pointer dereference). + return strstr(status_msg, "internal error:") ? 2 : 1; +} + +int // +main(int argc, char** argv) { +#if defined(WUFFS_EXAMPLE_USE_SECCOMP) + prctl(PR_SET_SECCOMP, SECCOMP_MODE_STRICT); + g_sandboxed = true; +#endif + + int exit_code = compute_exit_code(main1(argc, argv)); + +#if defined(WUFFS_EXAMPLE_USE_SECCOMP) + // Call SYS_exit explicitly, instead of calling SYS_exit_group implicitly by + // either calling _exit or returning from main. SECCOMP_MODE_STRICT allows + // only SYS_exit. + syscall(SYS_exit, exit_code); +#endif + return exit_code; +} diff --git a/test/data/animated-red-blue.nia b/test/data/animated-red-blue.nia new file mode 100644 index 0000000000000000000000000000000000000000..0131e98bd1bfccd15cd377cf823a8b5251505799 GIT binary patch literal 49272 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 literal 0 HcmV?d00001 diff --git a/test/data/hippopotamus.nie b/test/data/hippopotamus.nie new file mode 100644 index 0000000000000000000000000000000000000000..b14c29e1615d370a6119aad2ad2d3a724a1739e2 GIT binary patch literal 4048 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 UL1ux>2H6F&7Zx_4xB`U_0HA4NiU0rr literal 0 HcmV?d00001