diff --git a/.clang-tidy b/.clang-tidy
new file mode 100644
index 00000000..d41bac60
--- /dev/null
+++ b/.clang-tidy
@@ -0,0 +1,3 @@
+---
+Checks: 'clang-diagnostic-*,clang-analyzer-*,-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,-clang-analyzer-security.insecureAPI.strcpy'
+HeaderFilterRegex: '.*'
diff --git a/ChangeLog b/ChangeLog
index 6ee80ec8..c044ce07 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,12 +3,16 @@ Version 2.13.0.9 (dev) not released yet
**Incompatible changes**
------------------------
-None so far
+- New `memfile` & `memfile_size` fields in `symbol` for use with new output
+ option `BARCODE_MEMORY_FILE`
Changes
-------
- BMP: lessen heap memory usage by only `malloc()`ing a row
- GIF: lessen heap memory usage by paging; use standard colour char map
+- Add `BARCODE_MEMORY_FILE` to `symbol->output_options` to allow outputting to
+ in-memory buffer `symbol->memfile` instead of to file `symbol->outfile`,
+ ticket #301
Bugs
----
diff --git a/README.clang-tidy b/README.clang-tidy
new file mode 100644
index 00000000..23eeee0d
--- /dev/null
+++ b/README.clang-tidy
@@ -0,0 +1,21 @@
+Current as of latest clang-tidy-18 from Ubuntu 22.04 apt package (2023-12-26)
+
+Requires cmake in "build" sub-directory with -DCMAKE_EXPORT_COMPILE_COMMANDS=ON (for "build/compile_commands.json")
+and -DCMAKE_BUILD_TYPE=Debug (so `assert()`s defined), and then make (for Qt generated includes).
+
+In project root directory (warning, slow):
+
+clang-tidy-18 backend/*.c frontend/*.c backend_qt/*.cpp frontend_qt/*.cpp -p build/compile_commands.json
+
+For "backend_tcl", which has no "compile_commands.json", specify the tcl include directory, e.g.
+
+clang-tidy-18 backend_tcl/*.c -- -I/usr/include/tcl8.6
+
+Options are in ".clang-tidy" (in the project root directory). The excluded checks are
+`clang-analyzer-security.insecureAPI.strcpy` (for `strcpy()`, `strcat()` etc), and
+`clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling` (for `sprintf()`).
+
+The test suite (cmake given -DZINT_TEST=ON) can also be analysed with an additional check disabled:
+
+clang-tidy-18 backend/tests/*.c frontend/tests/*.c backend_qt/tests/*.cpp \
+ -checks='-clang-analyzer-optin.performance.Padding' -p build/compile_commands.json
diff --git a/backend/CMakeLists.txt b/backend/CMakeLists.txt
index 7ab2b365..edf83d54 100644
--- a/backend/CMakeLists.txt
+++ b/backend/CMakeLists.txt
@@ -8,7 +8,7 @@ if(ZINT_USE_PNG)
find_package(PNG)
endif()
-set(zint_COMMON_SRCS common.c library.c large.c reedsol.c gs1.c eci.c general_field.c)
+set(zint_COMMON_SRCS common.c library.c large.c reedsol.c gs1.c eci.c filemem.c general_field.c)
set(zint_ONEDIM_SRCS bc412.c code.c code128.c 2of5.c upcean.c telepen.c medical.c plessey.c rss.c)
set(zint_POSTAL_SRCS postal.c auspost.c imail.c mailmark.c)
set(zint_TWODIM_SRCS code16k.c codablock.c dmatrix.c pdf417.c qr.c maxicode.c composite.c aztec.c code49.c code1.c gridmtx.c hanxin.c dotcode.c ultra.c)
diff --git a/backend/Makefile.mingw b/backend/Makefile.mingw
index 8aa750c1..905b0749 100644
--- a/backend/Makefile.mingw
+++ b/backend/Makefile.mingw
@@ -24,7 +24,7 @@ APP:=zint
DLL:=$(APP).dll
STATLIB:=lib$(APP).a
-COMMON_OBJ:= common.o library.o large.o reedsol.o gs1.o eci.o general_field.o sjis.o gb2312.o gb18030.o
+COMMON_OBJ:= common.o library.o large.o reedsol.o gs1.o eci.o filemem.o general_field.o sjis.o gb2312.o gb18030.o
ONEDIM_OBJ:= code.o code128.o 2of5.o upcean.o telepen.o medical.o plessey.o rss.o
POSTAL_OBJ:= postal.o auspost.o imail.o mailmark.o
TWODIM_OBJ:= code16k.o codablock.o dmatrix.o pdf417.o qr.o maxicode.o composite.o aztec.o code49.o code1.o gridmtx.o hanxin.o dotcode.o ultra.o
diff --git a/backend/bmp.c b/backend/bmp.c
index 4f0271e4..ef4e616d 100644
--- a/backend/bmp.c
+++ b/backend/bmp.c
@@ -33,11 +33,8 @@
#include <errno.h>
#include <math.h>
#include <stdio.h>
-#ifdef _MSC_VER
-#include <io.h>
-#include <fcntl.h>
-#endif
#include "common.h"
+#include "filemem.h"
#include "output.h"
#include "bmp.h" /* Bitmap header structure */
@@ -47,7 +44,8 @@ INTERNAL int bmp_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
int colour_count;
int resolution;
size_t row_size, data_offset, file_size;
- FILE *bmp_file;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
bitmap_file_header_t file_header;
bitmap_info_header_t info_header;
color_ref_t bg;
@@ -55,7 +53,6 @@ INTERNAL int bmp_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
color_ref_t palette[8];
int ultra_fg_index = 9;
unsigned char map[128];
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT; /* Suppress gcc -fanalyzer warning */
unsigned char *rowbuf;
(void) out_colour_get_rgb(symbol->fgcolour, &fg.red, &fg.green, &fg.blue, NULL /*alpha*/);
@@ -119,36 +116,25 @@ INTERNAL int bmp_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
info_header.important_colours = colour_count;
/* Open output file in binary mode */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "600: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- free(rowbuf);
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- bmp_file = stdout;
- } else {
- if (!(bmp_file = out_fopen(symbol->outfile, "wb"))) {
- sprintf(symbol->errtxt, "601: Could not open output file (%d: %.30s)", errno, strerror(errno));
- free(rowbuf);
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "601: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ free(rowbuf);
+ return ZINT_ERROR_FILE_ACCESS;
}
- fwrite(&file_header, sizeof(bitmap_file_header_t), 1, bmp_file);
- fwrite(&info_header, sizeof(bitmap_info_header_t), 1, bmp_file);
+ fm_write(&file_header, sizeof(bitmap_file_header_t), 1, fmp);
+ fm_write(&info_header, sizeof(bitmap_info_header_t), 1, fmp);
- fwrite(&bg, sizeof(color_ref_t), 1, bmp_file);
+ fm_write(&bg, sizeof(color_ref_t), 1, fmp);
if (bits_per_pixel == 4) {
for (i = 0; i < 8; i++) {
- fwrite(&palette[i], sizeof(color_ref_t), 1, bmp_file);
+ fm_write(&palette[i], sizeof(color_ref_t), 1, fmp);
}
if (ultra_fg_index == 9) {
- fwrite(&fg, sizeof(color_ref_t), 1, bmp_file);
+ fm_write(&fg, sizeof(color_ref_t), 1, fmp);
}
} else {
- fwrite(&fg, sizeof(color_ref_t), 1, bmp_file);
+ fm_write(&fg, sizeof(color_ref_t), 1, fmp);
}
/* Pixel Plotting */
@@ -159,7 +145,7 @@ INTERNAL int bmp_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
for (column = 0; column < symbol->bitmap_width; column++) {
rowbuf[column >> 1] |= map[pb[column]] << (!(column & 1) << 2);
}
- fwrite(rowbuf, 1, row_size, bmp_file);
+ fm_write(rowbuf, 1, row_size, fmp);
}
} else { /* bits_per_pixel == 1 */
for (row = 0; row < symbol->bitmap_height; row++) {
@@ -168,29 +154,20 @@ INTERNAL int bmp_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
for (column = 0; column < symbol->bitmap_width; column++) {
rowbuf[column >> 3] |= map[pb[column]] >> (column & 7);
}
- fwrite(rowbuf, 1, row_size, bmp_file);
+ fm_write(rowbuf, 1, row_size, fmp);
}
}
free(rowbuf);
- if (ferror(bmp_file)) {
- sprintf(symbol->errtxt, "603: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(bmp_file);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "603: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(bmp_file) != 0) {
- sprintf(symbol->errtxt, "604: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(bmp_file) != 0) {
- sprintf(symbol->errtxt, "605: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "605: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return 0;
diff --git a/backend/common.c b/backend/common.c
index cb6eab48..4bf6b981 100644
--- a/backend/common.c
+++ b/backend/common.c
@@ -606,6 +606,11 @@ INTERNAL char *debug_print_escape(const unsigned char *source, const int first_l
}
#ifdef ZINT_TEST
+/* Suppress gcc warning null destination pointer [-Wformat-overflow=] false-positive */
+#if defined(__GNUC__) && !defined(__clang__)
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wformat-overflow="
+#endif
/* Dumps hex-formatted codewords in symbol->errtxt (for use in testing) */
INTERNAL void debug_test_codeword_dump(struct zint_symbol *symbol, const unsigned char *codewords, const int length) {
int i, max = length, cnt_len = 0;
@@ -655,6 +660,9 @@ INTERNAL void debug_test_codeword_dump_int(struct zint_symbol *symbol, const int
}
symbol->errtxt[strlen(symbol->errtxt) - 1] = '\0'; /* Zap last space */
}
+#if defined(__GNUC__) && !defined(__clang__)
+#pragma GCC diagnostic pop
#endif
+#endif /*ZINT_TEST*/
/* vim: set ts=4 sw=4 et : */
diff --git a/backend/common.h b/backend/common.h
index c10d4efd..83a280e4 100644
--- a/backend/common.h
+++ b/backend/common.h
@@ -41,21 +41,37 @@ extern "C" {
#define ARRAY_SIZE(x) ((int) (sizeof(x) / sizeof((x)[0])))
#endif
-/* Determine if C89 (excluding MSVC, which doesn't define __STDC_VERSION__) */
-#if !defined(_MSC_VER) && (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199000L)
-#define ZINT_IS_C89
+/* Determine if C89 or C99 (excluding MSVC, which doesn't define __STDC_VERSION__) */
+#ifndef _MSC_VER
+# if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 199000L
+# define ZINT_IS_C89
+# elif __STDC_VERSION__ <= 199901L /* Actually includes pseudo-standards "C94/C95" as well */
+# define ZINT_IS_C99
+# endif
#endif
#ifdef _MSC_VER
# include <malloc.h>
# define z_alloca(nmemb) _alloca(nmemb)
#else
-# if defined(ZINT_IS_C89) || defined(__NuttX__) /* C89 or NuttX RTOS */
+# if defined(ZINT_IS_C89) || defined(ZINT_IS_C99) || defined(__NuttX__) /* C89 or C99 or NuttX RTOS */
# include <alloca.h>
# endif
# define z_alloca(nmemb) alloca(nmemb)
#endif
+#ifdef _MSC_VER
+# if _MSC_VER >= 1400 /* MSVC 2005 (C++ 8.0) */
+# define restrict __restrict
+# else
+# define restrict
+# endif
+#else
+# ifdef ZINT_IS_C89
+# define restrict
+# endif
+#endif
+
#ifdef _MSC_VER
typedef unsigned __int8 uint8_t;
typedef unsigned __int16 uint16_t;
diff --git a/backend/emf.c b/backend/emf.c
index 8dfe36c9..3551c6af 100644
--- a/backend/emf.c
+++ b/backend/emf.c
@@ -37,11 +37,8 @@
#include <stdio.h>
#include <assert.h>
#include <math.h>
-#ifdef _MSC_VER
-#include <io.h>
-#include <fcntl.h>
-#endif
#include "common.h"
+#include "filemem.h"
#include "output.h"
#include "emf.h"
@@ -164,7 +161,8 @@ static int emf_utfle_length(const unsigned char *input, const int length) {
INTERNAL int emf_plot(struct zint_symbol *symbol, int rotate_angle) {
int i;
- FILE *emf_file;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
unsigned char fgred, fggrn, fgblu, bgred, bggrn, bgblu, bgalpha;
int error_number = 0;
int rectangle_count, this_rectangle;
@@ -191,7 +189,6 @@ INTERNAL int emf_plot(struct zint_symbol *symbol, int rotate_angle) {
int draw_background = 1;
int bold;
const int upcean = is_upcean(symbol->symbology);
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT;
struct zint_vector_rect *rect;
struct zint_vector_circle *circ;
@@ -703,66 +700,56 @@ INTERNAL int emf_plot(struct zint_symbol *symbol, int rotate_angle) {
emr_header.emf_header.records = recordcount;
/* Send EMF data to file */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "642: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- emf_file = stdout;
- } else {
- if (!(emf_file = out_fopen(symbol->outfile, "wb"))) {
- sprintf(symbol->errtxt, "640: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "640: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
}
- fwrite(&emr_header, sizeof(emr_header_t), 1, emf_file);
+ fm_write(&emr_header, sizeof(emr_header_t), 1, fmp);
- fwrite(&emr_mapmode, sizeof(emr_mapmode_t), 1, emf_file);
+ fm_write(&emr_mapmode, sizeof(emr_mapmode_t), 1, fmp);
if (rotate_angle) {
- fwrite(&emr_setworldtransform, sizeof(emr_setworldtransform_t), 1, emf_file);
+ fm_write(&emr_setworldtransform, sizeof(emr_setworldtransform_t), 1, fmp);
}
- fwrite(&emr_createbrushindirect_bg, sizeof(emr_createbrushindirect_t), 1, emf_file);
+ fm_write(&emr_createbrushindirect_bg, sizeof(emr_createbrushindirect_t), 1, fmp);
if (symbol->symbology == BARCODE_ULTRA) {
for (i = 0; i < 9; i++) {
if (rectangle_bycolour[i]) {
- fwrite(&emr_createbrushindirect_colour[i], sizeof(emr_createbrushindirect_t), 1, emf_file);
+ fm_write(&emr_createbrushindirect_colour[i], sizeof(emr_createbrushindirect_t), 1, fmp);
}
}
} else {
- fwrite(&emr_createbrushindirect_fg, sizeof(emr_createbrushindirect_t), 1, emf_file);
+ fm_write(&emr_createbrushindirect_fg, sizeof(emr_createbrushindirect_t), 1, fmp);
}
- fwrite(&emr_createpen, sizeof(emr_createpen_t), 1, emf_file);
+ fm_write(&emr_createpen, sizeof(emr_createpen_t), 1, fmp);
if (symbol->vector->strings) {
- fwrite(&emr_extcreatefontindirectw, sizeof(emr_extcreatefontindirectw_t), 1, emf_file);
+ fm_write(&emr_extcreatefontindirectw, sizeof(emr_extcreatefontindirectw_t), 1, fmp);
if (fsize2) {
- fwrite(&emr_extcreatefontindirectw2, sizeof(emr_extcreatefontindirectw_t), 1, emf_file);
+ fm_write(&emr_extcreatefontindirectw2, sizeof(emr_extcreatefontindirectw_t), 1, fmp);
}
}
- fwrite(&emr_selectobject_bgbrush, sizeof(emr_selectobject_t), 1, emf_file);
- fwrite(&emr_selectobject_pen, sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_bgbrush, sizeof(emr_selectobject_t), 1, fmp);
+ fm_write(&emr_selectobject_pen, sizeof(emr_selectobject_t), 1, fmp);
if (draw_background) {
- fwrite(&background, sizeof(emr_rectangle_t), 1, emf_file);
+ fm_write(&background, sizeof(emr_rectangle_t), 1, fmp);
}
if (symbol->symbology == BARCODE_ULTRA) {
for (i = 0; i < 9; i++) {
if (rectangle_bycolour[i]) {
- fwrite(&emr_selectobject_colour[i], sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_colour[i], sizeof(emr_selectobject_t), 1, fmp);
rect = symbol->vector->rectangles;
this_rectangle = 0;
while (rect) {
if ((i == 0 && rect->colour == -1) || rect->colour == i) {
- fwrite(&rectangle[this_rectangle], sizeof(emr_rectangle_t), 1, emf_file);
+ fm_write(&rectangle[this_rectangle], sizeof(emr_rectangle_t), 1, fmp);
}
this_rectangle++;
rect = rect->next;
@@ -770,42 +757,42 @@ INTERNAL int emf_plot(struct zint_symbol *symbol, int rotate_angle) {
}
}
} else {
- fwrite(&emr_selectobject_fgbrush, sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_fgbrush, sizeof(emr_selectobject_t), 1, fmp);
/* Rectangles */
for (i = 0; i < rectangle_count; i++) {
- fwrite(&rectangle[i], sizeof(emr_rectangle_t), 1, emf_file);
+ fm_write(&rectangle[i], sizeof(emr_rectangle_t), 1, fmp);
}
}
/* Hexagons */
for (i = 0; i < hexagon_count; i++) {
- fwrite(&hexagon[i], sizeof(emr_polygon_t), 1, emf_file);
+ fm_write(&hexagon[i], sizeof(emr_polygon_t), 1, fmp);
}
/* Circles */
if (symbol->symbology == BARCODE_MAXICODE) {
/* Bullseye needed */
for (i = 0; i < circle_count; i++) {
- fwrite(&circle[i], sizeof(emr_ellipse_t), 1, emf_file);
+ fm_write(&circle[i], sizeof(emr_ellipse_t), 1, fmp);
if (i < circle_count - 1) {
if (i % 2) {
- fwrite(&emr_selectobject_fgbrush, sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_fgbrush, sizeof(emr_selectobject_t), 1, fmp);
} else {
- fwrite(&emr_selectobject_bgbrush, sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_bgbrush, sizeof(emr_selectobject_t), 1, fmp);
}
}
}
} else {
for (i = 0; i < circle_count; i++) {
- fwrite(&circle[i], sizeof(emr_ellipse_t), 1, emf_file);
+ fm_write(&circle[i], sizeof(emr_ellipse_t), 1, fmp);
}
}
/* Text */
if (string_count > 0) {
- fwrite(&emr_selectobject_font, sizeof(emr_selectobject_t), 1, emf_file);
- fwrite(&emr_settextcolor, sizeof(emr_settextcolor_t), 1, emf_file);
+ fm_write(&emr_selectobject_font, sizeof(emr_selectobject_t), 1, fmp);
+ fm_write(&emr_settextcolor, sizeof(emr_settextcolor_t), 1, fmp);
}
current_fsize = fsize;
@@ -813,43 +800,34 @@ INTERNAL int emf_plot(struct zint_symbol *symbol, int rotate_angle) {
for (i = 0; i < string_count; i++) {
if (text_fsizes[i] != current_fsize) {
current_fsize = text_fsizes[i];
- fwrite(&emr_selectobject_font2, sizeof(emr_selectobject_t), 1, emf_file);
+ fm_write(&emr_selectobject_font2, sizeof(emr_selectobject_t), 1, fmp);
}
if (text_haligns[i] != current_halign) {
current_halign = text_haligns[i];
if (current_halign == 0) {
- fwrite(&emr_settextalign_centre, sizeof(emr_settextalign_t), 1, emf_file);
+ fm_write(&emr_settextalign_centre, sizeof(emr_settextalign_t), 1, fmp);
} else if (current_halign == 1) {
- fwrite(&emr_settextalign_left, sizeof(emr_settextalign_t), 1, emf_file);
+ fm_write(&emr_settextalign_left, sizeof(emr_settextalign_t), 1, fmp);
} else {
- fwrite(&emr_settextalign_right, sizeof(emr_settextalign_t), 1, emf_file);
+ fm_write(&emr_settextalign_right, sizeof(emr_settextalign_t), 1, fmp);
}
}
- fwrite(&text[i], sizeof(emr_exttextoutw_t), 1, emf_file);
- fwrite(this_string[i], emf_bump_up(text[i].w_emr_text.chars), 1, emf_file);
+ fm_write(&text[i], sizeof(emr_exttextoutw_t), 1, fmp);
+ fm_write(this_string[i], emf_bump_up(text[i].w_emr_text.chars), 1, fmp);
free(this_string[i]);
}
- fwrite(&emr_eof, sizeof(emr_eof_t), 1, emf_file);
+ fm_write(&emr_eof, sizeof(emr_eof_t), 1, fmp);
- if (ferror(emf_file)) {
- sprintf(symbol->errtxt, "644: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(emf_file);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "644: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(emf_file) != 0) {
- sprintf(symbol->errtxt, "940: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(emf_file) != 0) {
- sprintf(symbol->errtxt, "941: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "941: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return error_number;
}
diff --git a/backend/filemem.c b/backend/filemem.c
new file mode 100644
index 00000000..c6e2175a
--- /dev/null
+++ b/backend/filemem.c
@@ -0,0 +1,464 @@
+/* filemem.c - write to file/memory abstraction */
+/*
+ libzint - the open source barcode library
+ Copyright (C) 2023 Robin Stuart <rstuart114@gmail.com>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+ 3. Neither the name of the project nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+ */
+/* SPDX-License-Identifier: BSD-3-Clause */
+
+#include <assert.h>
+#include <errno.h>
+#include <limits.h>
+#include <stdarg.h>
+#ifdef _MSC_VER
+#include <io.h>
+#include <fcntl.h>
+#endif
+
+#include "filemem.h"
+#include "output.h"
+
+#define FM_PAGE_SIZE 0x8000 /* 32k */
+
+#ifndef EOVERFLOW
+#define EOVERFLOW EINVAL
+#endif
+
+#if defined(_MSC_VER) && _MSC_VER < 1800 /* `va_copy()` not before MSVC 2013 (C++ 12.0) */
+# define va_copy(dest, src) (dest = src)
+#else
+# if defined(ZINT_IS_C89) && !defined(va_copy)
+# ifdef __GNUC__
+# define va_copy __va_copy /* Available with clang as well */
+# else
+# define va_copy(dest, src) (dest = src) /* Will fail if array (need `*dest = *src`) or something else */
+# endif
+# endif
+#endif
+
+/* Helper to set `err` only if not already set, returning 0 always for convenience */
+static int fm_seterr(struct filemem *restrict const fmp, const int err) {
+ if (fmp->err == 0) {
+ fmp->err = err;
+ }
+ return 0;
+}
+
+/* Helper to set position, syncing end marker */
+static void fm_setpos(struct filemem *restrict const fmp, const size_t pos) {
+ assert(pos <= fmp->memsize);
+ fmp->mempos = pos;
+ if (fmp->mempos > fmp->memend) {
+ fmp->memend = fmp->mempos;
+ }
+}
+
+/* Helper to clear memory buffer and associates */
+static void fm_clear_mem(struct filemem *restrict const fmp) {
+ if (fmp->mem) {
+ free(fmp->mem);
+ fmp->mem = NULL;
+ }
+ fmp->memsize = fmp->mempos = fmp->memend = 0;
+#ifdef FM_NO_VSNPRINTF
+ if (fmp->fp_null) {
+ (void) fclose(fmp->fp_null);
+ fmp->fp_null = NULL;
+ }
+#endif
+}
+
+/* `fopen()` if file, setup memory buffer if BARCODE_MEMORY_FILE, returning 1 on success, 0 on failure */
+INTERNAL int fm_open(struct filemem *restrict const fmp, struct zint_symbol *symbol, const char *mode) {
+ assert(fmp && symbol && mode);
+ fmp->fp = NULL;
+ fmp->mem = NULL;
+ fmp->memsize = fmp->mempos = fmp->memend = 0;
+ fmp->flags = symbol->output_options & (BARCODE_STDOUT | BARCODE_MEMORY_FILE);
+ fmp->err = 0;
+#ifdef FM_NO_VSNPRINTF
+ fmp->fp_null = NULL;
+#endif
+
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ if (!(fmp->mem = (unsigned char *) malloc(FM_PAGE_SIZE))) {
+ return fm_seterr(fmp, ENOMEM);
+ }
+ fmp->memsize = FM_PAGE_SIZE;
+ if (symbol->memfile) {
+ free(symbol->memfile);
+ symbol->memfile = NULL;
+ }
+ symbol->memfile_size = 0;
+ return 1;
+ }
+ if (fmp->flags & BARCODE_STDOUT) {
+#ifdef _MSC_VER
+ if (strchr(mode, 'b') != NULL && _setmode(_fileno(stdout), _O_BINARY) == -1) {
+ return fm_seterr(fmp, errno);
+ }
+#endif
+ fmp->fp = stdout;
+ return 1;
+ }
+ if (!(fmp->fp = out_fopen(symbol->outfile, mode))) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+/* Expand memory buffer, returning 1 on success, 0 on failure */
+static int fm_mem_expand(struct filemem *restrict const fmp, const size_t size) {
+ unsigned char *new_mem;
+ size_t new_size;
+
+ assert(fmp);
+ if (!fmp->mem) {
+ return fm_seterr(fmp, EINVAL);
+ }
+ if (size == 0) {
+ return 1;
+ }
+ if (fmp->mempos + size < fmp->memsize) { /* Fits? */
+ if (fmp->mempos + size <= fmp->mempos) { /* Check for overflow */
+ fm_clear_mem(fmp);
+ return fm_seterr(fmp, EOVERFLOW);
+ }
+ return 1;
+ }
+ new_size = fmp->memsize + (size < FM_PAGE_SIZE ? FM_PAGE_SIZE : size);
+ if (new_size <= fmp->memsize) { /* Check for overflow */
+ fm_clear_mem(fmp);
+ return fm_seterr(fmp, EOVERFLOW);
+ }
+ /* Protect against very large files & (Linux) OOM killer - cf `raster_malloc()` in "raster.c" */
+ if (new_size > 0x40000000 /*1GB*/ || !(new_mem = (unsigned char *) realloc(fmp->mem, new_size))) {
+ fm_clear_mem(fmp);
+ return fm_seterr(fmp, new_size > 0x40000000 ? EINVAL : ENOMEM);
+ }
+ fmp->mem = new_mem;
+ fmp->memsize = new_size;
+ return 1;
+}
+
+/* `fwrite()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_write(const void *restrict ptr, const size_t size, const size_t nitems,
+ struct filemem *restrict const fmp) {
+ assert(fmp && ptr);
+ if (fmp->err) {
+ return 0;
+ }
+ if (size == 0 || nitems == 0) {
+ return 1;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ const size_t tot_size = size * nitems;
+ if (tot_size / size != nitems) {
+ return fm_seterr(fmp, EOVERFLOW);
+ }
+ if (!fm_mem_expand(fmp, tot_size)) {
+ return 0;
+ }
+ memcpy(fmp->mem + fmp->mempos, ptr, tot_size);
+ fm_setpos(fmp, fmp->mempos + tot_size);
+ return 1;
+ }
+ if (fwrite(ptr, size, nitems, fmp->fp) == 0) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+/* `fputc()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_putc(const int ch, struct filemem *restrict const fmp) {
+ assert(fmp);
+ if (fmp->err) {
+ return 0;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ if (!fm_mem_expand(fmp, 1)) {
+ return 0;
+ }
+ fmp->mem[fmp->mempos] = (unsigned char) ch;
+ fm_setpos(fmp, fmp->mempos + 1);
+ return 1;
+ }
+ if (fputc(ch, fmp->fp) == EOF) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+/* `fputs()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_puts(const char *str, struct filemem *restrict const fmp) {
+ assert(fmp);
+ if (fmp->err) {
+ return 0;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ const size_t len = strlen(str);
+ if (!fm_mem_expand(fmp, len)) {
+ return 0;
+ }
+ memcpy(fmp->mem + fmp->mempos, str, len);
+ fm_setpos(fmp, fmp->mempos + len);
+ return 1;
+ }
+ if (fputs(str, fmp->fp) == EOF) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+#ifdef FM_NO_VSNPRINTF
+# ifdef _WIN32
+# define DEV_NULL "NUL"
+# else
+# define DEV_NULL "/dev/null"
+# endif
+#endif
+
+/* Helper to `printf()` into mem buffer */
+static int fm_vprintf(struct filemem *restrict const fmp, const char *fmt, va_list ap) {
+ va_list cpy;
+ int size, check;
+
+ /* Adapted from https://stackoverflow.com/a/52558247/664741 */
+#ifdef FM_NO_VSNPRINTF
+ if (!fmp->fp_null && !(fmp->fp_null = fopen(DEV_NULL, "wb"))) {
+ return fm_seterr(fmp, errno);
+ }
+#endif
+
+ va_copy(cpy, ap);
+ /* The clang-tidy warning is a bug https://github.com/llvm/llvm-project/issues/40656 */
+#ifdef FM_NO_VSNPRINTF
+ size = vfprintf(fmp->fp_null, fmt, cpy); /* NOLINT(clang-analyzer-valist.Uninitialized) */
+#else
+ size = vsnprintf(NULL, 0, fmt, cpy); /* NOLINT(clang-analyzer-valist.Uninitialized) */
+#endif
+ va_end(cpy);
+
+ if (size < 0) {
+ return fm_seterr(fmp, errno);
+ }
+
+ if (!fm_mem_expand(fmp, size + 1)) {
+ return 0;
+ }
+
+#ifdef FM_NO_VSNPRINTF
+ /* NOLINTNEXTLINE(clang-analyzer-valist.Uninitialized) - see above */
+ check = vsprintf((char *) fmp->mem + fmp->mempos, fmt, ap);
+#else
+ /* NOLINTNEXTLINE(clang-analyzer-valist.Uninitialized) - see above */
+ check = vsnprintf((char *) fmp->mem + fmp->mempos, size + 1, fmt, ap);
+#endif
+
+ (void)check;
+ assert(check == size);
+
+ fm_setpos(fmp, fmp->mempos + size);
+
+ return 1;
+}
+
+/* `fprintf()` to memory or file, returning 1 on success, 0 on failure */
+INTERNAL int fm_printf(struct filemem *restrict const fmp, const char *fmt, ...) {
+ va_list ap;
+ int ret;
+
+ assert(fmp && fmt);
+ if (fmp->err) {
+ return 0;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ va_start(ap, fmt);
+ ret = fm_vprintf(fmp, fmt, ap);
+ va_end(ap);
+ return ret;
+ }
+ va_start(ap, fmt);
+ ret = vfprintf(fmp->fp, fmt, ap) >= 0; /* NOLINT(clang-analyzer-valist.Uninitialized) - see above */
+ if (!ret) {
+ (void) fm_seterr(fmp, errno);
+ }
+ va_end(ap);
+ return ret != 0;
+}
+
+/* Output float without trailing zeroes to `fmp` with decimal pts `dp` (precision), returning 1 on success, 0 on
+ failure */
+INTERNAL int fm_putsf(const char *prefix, const int dp, const float arg, struct filemem *restrict const fmp) {
+ int i, end;
+ char buf[256]; /* Assuming `dp` reasonable */
+ const int len = sprintf(buf, "%.*f", dp, arg);
+
+ assert(fmp);
+ if (fmp->err) {
+ return 0;
+ }
+ if (prefix && *prefix) {
+ if (!fm_puts(prefix, fmp)) {
+ return 0;
+ }
+ }
+
+ /* Adapted from https://stackoverflow.com/a/36202854/664741 */
+ for (i = len - 1, end = len; i >= 0; i--) {
+ if (buf[i] == '0') {
+ if (end == i + 1) {
+ end = i;
+ }
+ } else if (!z_isdigit(buf[i]) && buf[i] != '-') { /* If not digit or minus then decimal point */
+ if (end == i + 1) {
+ end = i;
+ } else {
+ buf[i] = '.'; /* Overwrite any locale-specific setting for decimal point */
+ }
+ buf[end] = '\0';
+ break;
+ }
+ }
+
+ return fm_puts(buf, fmp);
+}
+
+/* `fclose()` if file, set `symbol->memfile` & `symbol->memfile_size` if memory, returning 1 on success, 0 on
+ failure */
+INTERNAL int fm_close(struct filemem *restrict const fmp, struct zint_symbol *symbol) {
+ assert(fmp && symbol);
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ if (fmp->err || !fmp->mem) {
+ fm_clear_mem(fmp);
+ return fm_seterr(fmp, EINVAL);
+ }
+ symbol->memfile_size = (int) fmp->mempos;
+ if ((size_t) symbol->memfile_size != fmp->mempos) {
+ fm_clear_mem(fmp);
+ symbol->memfile_size = 0;
+ return fm_seterr(fmp, EINVAL);
+ }
+ symbol->memfile = fmp->mem;
+ fmp->mem = NULL; /* Now belongs to `symbol` */
+ fm_clear_mem(fmp);
+ return 1;
+ }
+ if (fmp->err || !fmp->fp) {
+ if (!(fmp->flags & BARCODE_STDOUT) && fmp->fp) {
+ (void) fclose(fmp->fp);
+ }
+ return fm_seterr(fmp, EINVAL);
+ }
+ if (fmp->flags & BARCODE_STDOUT) {
+ if (fflush(fmp->fp) != 0) {
+ fmp->fp = NULL;
+ return fm_seterr(fmp, errno);
+ }
+ } else {
+ if (fclose(fmp->fp) != 0) {
+ fmp->fp = NULL;
+ return fm_seterr(fmp, errno);
+ }
+ }
+ fmp->fp = NULL;
+ return 1;
+}
+
+/* `fseek()` to file/memory offset, returning 1 if successful, 0 on failure */
+INTERNAL int fm_seek(struct filemem *restrict const fmp, const long offset, const int whence) {
+ assert(fmp);
+ if (fmp->err) {
+ return 0;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ const size_t start = whence == SEEK_SET ? 0 : whence == SEEK_CUR ? fmp->mempos : fmp->memend;
+ const size_t new_pos = start + offset;
+ if ((offset > 0 && new_pos <= start) || (offset < 0 && new_pos >= start)) { /* Check for over/underflow */
+ return fm_seterr(fmp, EINVAL);
+ }
+ if (!fm_mem_expand(fmp, new_pos)) {
+ return 0;
+ }
+ fm_setpos(fmp, new_pos);
+ return 1;
+ }
+ if (fseek(fmp->fp, offset, whence) != 0) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+/* `ftell()` returns current file/memory offset if successful, -1 on failure */
+INTERNAL long fm_tell(struct filemem *restrict const fmp) {
+ long ret;
+ assert(fmp);
+ if (fmp->err) {
+ return -1;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ if (!fmp->mem) {
+ (void) fm_seterr(fmp, ENOMEM);
+ return -1;
+ }
+ return (long) fmp->mempos;
+ }
+ ret = ftell(fmp->fp);
+ /* On many Linux distros `ftell()` returns LONG_MAX not -1 on error */
+ if (ret < 0 || ret == LONG_MAX) {
+ (void) fm_seterr(fmp, errno);
+ return -1;
+ }
+ return ret;
+}
+
+/* Return `err`, which uses `errno` values */
+INTERNAL int fm_error(struct filemem *restrict const fmp) {
+ assert(fmp);
+ return fmp->err;
+}
+
+/* `fflush()` if file, no-op (apart from error checking) if memory, returning 1 on success, 0 on failure
+ NOTE: don't use, included only for libpng compatibility */
+INTERNAL int fm_flush(struct filemem *restrict const fmp) {
+ assert(fmp);
+ if (fmp->err) {
+ return 0;
+ }
+ if (fmp->flags & BARCODE_MEMORY_FILE) {
+ if (!fmp->mem) {
+ return fm_seterr(fmp, EINVAL);
+ }
+ return 1;
+ }
+ if (fflush(fmp->fp) == EOF) {
+ return fm_seterr(fmp, errno);
+ }
+ return 1;
+}
+
+/* vim: set ts=4 sw=4 et : */
diff --git a/backend/filemem.h b/backend/filemem.h
new file mode 100644
index 00000000..e79e1647
--- /dev/null
+++ b/backend/filemem.h
@@ -0,0 +1,95 @@
+/* filemem.h - write to file/memory abstraction */
+/*
+ libzint - the open source barcode library
+ Copyright (C) 2023 Robin Stuart <rstuart114@gmail.com>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+ 3. Neither the name of the project nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+ */
+/* SPDX-License-Identifier: BSD-3-Clause */
+
+#ifndef Z_FILEMEM_H
+#define Z_FILEMEM_H
+
+#include <stdio.h>
+#include "common.h"
+
+/* Whether `vsnprintf()` available */
+#if (defined(_MSC_VER) && _MSC_VER < 1900) || defined(ZINT_IS_C89) /* Pre-MSVC 2015 (C++ 14.0) or C89 */
+#define FM_NO_VSNPRINTF
+#endif
+
+struct filemem {
+ FILE *fp;
+ unsigned char *mem;
+ size_t memsize; /* Size of `mem` buffer (capacity) */
+ size_t mempos; /* Current position */
+ size_t memend; /* For use by `fm_seek()`, points to highest `mempos` reached */
+ int flags; /* BARCODE_MEMORY_FILE or BARCODE_STDOUT */
+ int err; /* `errno` values, reset only on `fm_open()` */
+#ifdef FM_NO_VSNPRINTF
+ FILE *fp_null; /* Only used for BARCODE_MEMORY_FILE */
+#endif
+};
+
+/* `fopen()` if file, setup memory buffer if BARCODE_MEMORY_FILE, returning 1 on success, 0 on failure */
+INTERNAL int fm_open(struct filemem *restrict const fmp, struct zint_symbol *symbol, const char *mode);
+
+/* `fwrite()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_write(const void *restrict ptr, const size_t size, const size_t nitems,
+ struct filemem *restrict const fmp);
+
+/* `fputc()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_putc(const int ch, struct filemem *restrict const fmp);
+
+/* `fputs()` to file or memory, returning 1 on success, 0 on failure */
+INTERNAL int fm_puts(const char *str, struct filemem *restrict const fmp);
+
+/* `fprintf()` to memory or file, returning 1 on success, 0 on failure */
+INTERNAL int fm_printf(struct filemem *restrict const fmp, const char *format, ...);
+
+/* Output float without trailing zeroes to `fmp` with decimal pts `dp` (precision), returning 1 on success, 0 on
+ failure */
+INTERNAL int fm_putsf(const char *prefix, const int dp, const float arg, struct filemem *restrict const fmp);
+
+/* `fclose()` if file, set `symbol->memfile` & `symbol->memfile_size` if memory, returning 1 on success, 0 on
+ failure */
+INTERNAL int fm_close(struct filemem *restrict const fmp, struct zint_symbol *symbol);
+
+/* `fseek()` to file/memory offset, returning 1 on success, 0 on failure */
+INTERNAL int fm_seek(struct filemem *restrict const fmp, const long offset, const int whence);
+
+/* `ftell()` returns current file/memory offset if successful, -1 on failure */
+INTERNAL long fm_tell(struct filemem *restrict const fmp);
+
+/* Return `err`, which uses `errno` values */
+INTERNAL int fm_error(struct filemem *restrict const fmp);
+
+/* `fflush()` if file, no-op if memory, returning 1 on success, 0 on failure
+ NOTE: don't use, included only for libpng compatibility */
+INTERNAL int fm_flush(struct filemem *restrict const fmp);
+
+/* vim: set ts=4 sw=4 et : */
+#endif /* Z_FILEMEM_H */
diff --git a/backend/gif.c b/backend/gif.c
index 245e15ce..f892398b 100644
--- a/backend/gif.c
+++ b/backend/gif.c
@@ -32,18 +32,15 @@
#include <errno.h>
#include <stdio.h>
-#ifdef _MSC_VER
-#include <io.h>
-#include <fcntl.h>
-#endif
#include "common.h"
+#include "filemem.h"
#include "output.h"
/* Limit initial LZW buffer size to this in expectation that compressed data will fit for typical scalings */
#define GIF_LZW_PAGE_SIZE 0x100000 /* Megabyte */
typedef struct s_statestruct {
- FILE *file;
+ struct filemem *fmp;
unsigned char *pOut;
const unsigned char *pIn;
const unsigned char *pInEnd;
@@ -65,7 +62,7 @@ static void BufferNextByte(statestruct *pState) {
(pState->OutPosCur)++;
if (pState->fOutPaged && pState->OutPosCur + 2 >= pState->OutLength) {
/* Keep last 256 bytes so `OutByteCountPos` within range */
- fwrite(pState->pOut, 1, pState->OutPosCur - 256, pState->file);
+ fm_write(pState->pOut, 1, pState->OutPosCur - 256, pState->fmp);
memmove(pState->pOut, pState->pOut + pState->OutPosCur - 256, 256);
pState->OutByteCountPos -= pState->OutPosCur - 256;
pState->OutPosCur = 256;
@@ -241,6 +238,7 @@ static int gif_lzw(statestruct *pState, int paletteBitSize) {
* Called function to save in gif format
*/
INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf) {
+ struct filemem fm;
unsigned char outbuf[10];
unsigned short usTemp;
unsigned char paletteRGB[10][3];
@@ -250,7 +248,6 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
statestruct State;
int transparent_index;
int bgindex = -1, fgindex = -1;
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT;
static const unsigned char RGBUnused[3] = {0,0,0};
unsigned char RGBfg[3];
@@ -277,22 +274,14 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
return ZINT_ERROR_MEMORY;
}
+ State.fmp = &fm;
+
/* Open output file in binary mode */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "610: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- free(State.pOut);
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- State.file = stdout;
- } else {
- if (!(State.file = out_fopen(symbol->outfile, "wb"))) {
- sprintf(symbol->errtxt, "611: Could not open output file (%d: %.30s)", errno, strerror(errno));
- free(State.pOut);
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(State.fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "611: Could not open output file (%d: %.30s)", State.fmp->err,
+ strerror(State.fmp->err));
+ free(State.pOut);
+ return ZINT_ERROR_FILE_ACCESS;
}
/*
@@ -310,7 +299,6 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
* 'K': black
* '0' and '1' may be identical to one of the other values
*/
- paletteCount = 0;
memset(State.map, 0, sizeof(State.map));
if (symbol->symbology == BARCODE_ULTRA) {
static const unsigned char ultra_chars[8] = { 'W', 'C', 'B', 'M', 'R', 'Y', 'G', 'K' };
@@ -375,7 +363,7 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
if (transparent_index != -1)
outbuf[4] = '9';
- fwrite(outbuf, 1, 6, State.file);
+ fm_write(outbuf, 1, 6, State.fmp);
/* Screen Descriptor (7) */
/* Screen Width */
usTemp = (unsigned short) symbol->bitmap_width;
@@ -402,12 +390,12 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
outbuf[5] = bgindex == -1 ? 0 : bgindex;
/* Byte 7 must be 0x00 */
outbuf[6] = 0x00;
- fwrite(outbuf, 1, 7, State.file);
+ fm_write(outbuf, 1, 7, State.fmp);
/* Global Color Table (paletteSize*3) */
- fwrite(paletteRGB, 1, 3*paletteCount, State.file);
+ fm_write(paletteRGB, 1, 3*paletteCount, State.fmp);
/* add unused palette items to fill palette size */
for (i = paletteCount; i < paletteSize; i++) {
- fwrite(RGBUnused, 1, 3, State.file);
+ fm_write(RGBUnused, 1, 3, State.fmp);
}
/* Graphic control extension (8) */
@@ -435,7 +423,7 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
outbuf[6] = (unsigned char) transparent_index;
/* Block Terminator */
outbuf[7] = 0;
- fwrite(outbuf, 1, 8, State.file);
+ fm_write(outbuf, 1, 8, State.fmp);
}
/* Image Descriptor */
/* Image separator character = ',' */
@@ -458,41 +446,32 @@ INTERNAL int gif_pixel_plot(struct zint_symbol *symbol, unsigned char *pixelbuf)
* There is no local color table if its most significant bit is reset.
*/
outbuf[9] = 0x00;
- fwrite(outbuf, 1, 10, State.file);
+ fm_write(outbuf, 1, 10, State.fmp);
/* call lzw encoding */
if (!gif_lzw(&State, paletteBitSize)) {
free(State.pOut);
- if (!output_to_stdout) {
- (void) fclose(State.file);
- }
+ (void) fm_close(State.fmp, symbol);
strcpy(symbol->errtxt, "613: Insufficient memory for LZW buffer");
return ZINT_ERROR_MEMORY;
}
- fwrite((const char *) State.pOut, 1, State.OutPosCur, State.file);
+ fm_write((const char *) State.pOut, 1, State.OutPosCur, State.fmp);
free(State.pOut);
/* GIF terminator */
- fputc('\x3b', State.file);
+ fm_putc('\x3b', State.fmp);
- if (ferror(State.file)) {
- sprintf(symbol->errtxt, "615: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(State.file);
- }
+ if (fm_error(State.fmp)) {
+ sprintf(symbol->errtxt, "615: Incomplete write to output (%d: %.30s)", State.fmp->err,
+ strerror(State.fmp->err));
+ (void) fm_close(State.fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(State.file) != 0) {
- sprintf(symbol->errtxt, "616: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(State.file) != 0) {
- sprintf(symbol->errtxt, "617: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(State.fmp, symbol)) {
+ sprintf(symbol->errtxt, "617: Failure on closing output file (%d: %.30s)", State.fmp->err,
+ strerror(State.fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return 0;
diff --git a/backend/library.c b/backend/library.c
index 08221d42..c4283c40 100644
--- a/backend/library.c
+++ b/backend/library.c
@@ -75,6 +75,7 @@ static void set_symbol_defaults(struct zint_symbol *symbol) {
symbol->bitmap = NULL;
symbol->alphamap = NULL;
symbol->vector = NULL;
+ symbol->memfile = NULL;
}
/* Create and initialize a symbol structure */
@@ -115,6 +116,11 @@ void ZBarcode_Clear(struct zint_symbol *symbol) {
}
symbol->bitmap_width = 0;
symbol->bitmap_height = 0;
+ if (symbol->memfile != NULL) {
+ free(symbol->memfile);
+ symbol->memfile = NULL;
+ }
+ symbol->memfile_size = 0;
/* If there is a rendered version, ensure its memory is released */
vector_free(symbol);
@@ -130,6 +136,9 @@ void ZBarcode_Reset(struct zint_symbol *symbol) {
if (symbol->alphamap != NULL) {
free(symbol->alphamap);
}
+ if (symbol->memfile != NULL) {
+ free(symbol->memfile);
+ }
vector_free(symbol);
memset(symbol, 0, sizeof(*symbol));
@@ -144,6 +153,8 @@ void ZBarcode_Delete(struct zint_symbol *symbol) {
free(symbol->bitmap);
if (symbol->alphamap != NULL)
free(symbol->alphamap);
+ if (symbol->memfile != NULL)
+ free(symbol->memfile);
/* If there is a rendered version, ensure its memory is released */
vector_free(symbol);
@@ -1556,7 +1567,7 @@ int ZBarcode_Encode_File(struct zint_symbol *symbol, const char *filename) {
fileLen = ftell(file);
- /* On many Linux distros ftell() returns LONG_MAX not -1 on error */
+ /* On many Linux distros `ftell()` returns LONG_MAX not -1 on error */
if (fileLen <= 0 || fileLen == LONG_MAX) {
(void) fclose(file);
return error_tag(symbol, ZINT_ERROR_INVALID_DATA, "235: Input file empty or unseekable");
diff --git a/backend/output.c b/backend/output.c
index 79ef9309..3f7c80b0 100644
--- a/backend/output.c
+++ b/backend/output.c
@@ -997,34 +997,4 @@ INTERNAL FILE *out_fopen(const char filename[256], const char *mode) {
return outfile;
}
-/* Output float without trailing zeroes to `fp` with decimal pts `dp` (precision) */
-INTERNAL void out_putsf(const char *const prefix, const int dp, const float arg, FILE *fp) {
- int i, end;
- char buf[256]; /* Assuming `dp` reasonable */
- const int len = sprintf(buf, "%.*f", dp, arg);
-
- if (*prefix) {
- fputs(prefix, fp);
- }
-
- /* Adapted from https://stackoverflow.com/a/36202854/664741 */
- for (i = len - 1, end = len; i >= 0; i--) {
- if (buf[i] == '0') {
- if (end == i + 1) {
- end = i;
- }
- } else if (!z_isdigit(buf[i]) && buf[i] != '-') { /* If not digit or minus then decimal point */
- if (end == i + 1) {
- end = i;
- } else {
- buf[i] = '.'; /* Overwrite any locale-specific setting for decimal point */
- }
- buf[end] = '\0';
- break;
- }
- }
-
- fputs(buf, fp);
-}
-
/* vim: set ts=4 sw=4 et : */
diff --git a/backend/output.h b/backend/output.h
index 03080b43..6be9e158 100644
--- a/backend/output.h
+++ b/backend/output.h
@@ -77,9 +77,6 @@ INTERNAL FILE *out_fopen(const char filename[256], const char *mode);
INTERNAL FILE *out_win_fopen(const char *filename, const char *mode);
#endif
-/* Output float without trailing zeroes to `fp` with decimal pts `dp` (precision) */
-INTERNAL void out_putsf(const char *const prefix, const int dp, const float arg, FILE *fp);
-
#ifdef __cplusplus
}
#endif /* __cplusplus */
diff --git a/backend/pcx.c b/backend/pcx.c
index 4e6825ea..099deaba 100644
--- a/backend/pcx.c
+++ b/backend/pcx.c
@@ -33,11 +33,8 @@
#include <errno.h>
#include <math.h>
#include <stdio.h>
-#ifdef _MSC_VER
-#include <io.h>
-#include <fcntl.h>
-#endif
#include "common.h"
+#include "filemem.h"
#include "output.h"
#include "pcx.h" /* PCX header structure */
@@ -46,11 +43,11 @@ INTERNAL int pcx_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
unsigned char fgred, fggrn, fgblu, fgalpha, bgred, bggrn, bgblu, bgalpha;
int row, column, i, colour;
int run_count;
- FILE *pcx_file;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
pcx_header_t header;
unsigned char previous;
const unsigned char *pb;
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT; /* Suppress gcc -fanalyzer warning */
const int bytes_per_line = symbol->bitmap_width + (symbol->bitmap_width & 1); /* Must be even */
unsigned char *rle_row = (unsigned char *) z_alloca(bytes_per_line);
@@ -88,22 +85,12 @@ INTERNAL int pcx_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
}
/* Open output file in binary mode */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "620: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- pcx_file = stdout;
- } else {
- if (!(pcx_file = out_fopen(symbol->outfile, "wb"))) {
- sprintf(symbol->errtxt, "621: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "621: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
}
- fwrite(&header, sizeof(pcx_header_t), 1, pcx_file);
+ fm_write(&header, sizeof(pcx_header_t), 1, fmp);
for (row = 0, pb = pixelbuf; row < symbol->bitmap_height; row++, pb += symbol->bitmap_width) {
for (colour = 0; colour < header.number_of_planes; colour++) {
@@ -147,9 +134,9 @@ INTERNAL int pcx_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
} else {
if (run_count > 1 || (previous & 0xc0) == 0xc0) {
run_count += 0xc0;
- fputc(run_count, pcx_file);
+ fm_putc(run_count, fmp);
}
- fputc(previous, pcx_file);
+ fm_putc(previous, fmp);
previous = rle_row[column];
run_count = 1;
}
@@ -157,30 +144,21 @@ INTERNAL int pcx_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
if (run_count > 1 || (previous & 0xc0) == 0xc0) {
run_count += 0xc0;
- fputc(run_count, pcx_file);
+ fm_putc(run_count, fmp);
}
- fputc(previous, pcx_file);
+ fm_putc(previous, fmp);
}
}
- if (ferror(pcx_file)) {
- sprintf(symbol->errtxt, "622: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(pcx_file);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "622: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(pcx_file) != 0) {
- sprintf(symbol->errtxt, "623: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(pcx_file) != 0) {
- sprintf(symbol->errtxt, "624: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "624: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return 0;
diff --git a/backend/png.c b/backend/png.c
index f028a72e..68e2c248 100644
--- a/backend/png.c
+++ b/backend/png.c
@@ -35,16 +35,15 @@
#include <errno.h>
#include <math.h>
#include <stdio.h>
-#ifdef _MSC_VER
-#include <fcntl.h>
-#include <io.h>
-#endif
#include <png.h>
#include <zlib.h>
#include <setjmp.h>
#include "common.h"
+#include "filemem.h"
#include "output.h"
+/* Note using "wpng_" prefix not "png_" (except for `png_pixel_plot()`) to avoid clashing with libpng */
+
/* Note if change this need to change "backend/tests/test_png.c" definition also */
struct wpng_error_type {
struct zint_symbol *symbol;
@@ -72,8 +71,20 @@ INTERNAL void wpng_error_handler_test(png_structp png_ptr, png_const_charp msg)
}
#endif
+/* libpng write callback */
+static void wpng_write(png_structp png_ptr, png_bytep ptr, size_t size) {
+ struct filemem *fmp = (struct filemem *) png_get_io_ptr(png_ptr);
+ (void) fm_write(ptr, 1, size, fmp);
+}
+
+/* libpng flush callback */
+static void wpng_flush(png_structp png_ptr) {
+ struct filemem *fmp = (struct filemem *) png_get_io_ptr(png_ptr);
+ (void) fm_flush(fmp);
+}
+
/* Guestimate best compression strategy */
-static int guess_compression_strategy(struct zint_symbol *symbol, const unsigned char *pixelbuf) {
+static int wpng_guess_compression_strategy(struct zint_symbol *symbol, const unsigned char *pixelbuf) {
(void)pixelbuf;
/* TODO: Do properly */
@@ -94,7 +105,8 @@ static int guess_compression_strategy(struct zint_symbol *symbol, const unsigned
INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pixelbuf) {
struct wpng_error_type wpng_error;
- FILE *outfile;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
png_structp png_ptr;
png_infop info_ptr;
int i;
@@ -105,11 +117,10 @@ INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
png_color palette[32];
int num_palette;
unsigned char trans_alpha[32];
- int num_trans = 0;
+ int num_trans; /* Note initialize below to avoid gcc -Wclobbered warning due to `longjmp()` */
int bit_depth;
int compression_strategy;
const unsigned char *pb;
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT;
unsigned char *outdata = (unsigned char *) z_alloca(symbol->bitmap_width);
wpng_error.symbol = symbol;
@@ -117,6 +128,7 @@ INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
(void) out_colour_get_rgb(symbol->fgcolour, &fg.red, &fg.green, &fg.blue, &fg_alpha);
(void) out_colour_get_rgb(symbol->bgcolour, &bg.red, &bg.green, &bg.blue, &bg_alpha);
+ num_trans = 0;
if (symbol->symbology == BARCODE_ULTRA) {
static const unsigned char ultra_chars[8] = { 'W', 'C', 'B', 'M', 'R', 'Y', 'G', 'K' };
for (i = 0; i < 8; i++) {
@@ -199,28 +211,16 @@ INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
}
/* Open output file in binary mode */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "631: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- outfile = stdout;
- } else {
- if (!(outfile = out_fopen(symbol->outfile, "wb"))) {
- sprintf(symbol->errtxt, "632: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "632: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
}
/* Set up error handling routine as proc() above */
png_ptr = png_create_write_struct(PNG_LIBPNG_VER_STRING, &wpng_error, wpng_error_handler, NULL);
if (!png_ptr) {
strcpy(symbol->errtxt, "633: Insufficient memory for PNG write structure buffer");
- if (!output_to_stdout) {
- (void) fclose(outfile);
- }
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_MEMORY;
}
@@ -228,29 +228,25 @@ INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
if (!info_ptr) {
png_destroy_write_struct(&png_ptr, NULL);
strcpy(symbol->errtxt, "634: Insufficient memory for PNG info structure buffer");
- if (!output_to_stdout) {
- (void) fclose(outfile);
- }
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_MEMORY;
}
/* catch jumping here */
if (setjmp(wpng_error.jmpbuf)) {
png_destroy_write_struct(&png_ptr, &info_ptr);
- if (!output_to_stdout) {
- (void) fclose(outfile);
- }
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_MEMORY;
}
- /* open output file with libpng */
- png_init_io(png_ptr, outfile);
+ /* Set our output functions */
+ png_set_write_fn(png_ptr, fmp, wpng_write, wpng_flush);
/* set compression */
png_set_compression_level(png_ptr, 9);
/* Compression strategy can make a difference */
- compression_strategy = guess_compression_strategy(symbol, pixelbuf);
+ compression_strategy = wpng_guess_compression_strategy(symbol, pixelbuf);
if (compression_strategy != Z_DEFAULT_STRATEGY) {
png_set_compression_strategy(png_ptr, compression_strategy);
}
@@ -317,27 +313,23 @@ INTERNAL int png_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
/* make sure we have disengaged */
png_destroy_write_struct(&png_ptr, &info_ptr);
- if (ferror(outfile)) {
- sprintf(symbol->errtxt, "638: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(outfile);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "638: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(outfile) != 0) {
- sprintf(symbol->errtxt, "639: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(outfile) != 0) {
- sprintf(symbol->errtxt, "960: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "960: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return 0;
}
/* vim: set ts=4 sw=4 et : */
+#else
+#if defined(__clang__)
+/* Suppresses clang-tidy-18 "clang-diagnostic-empty-translation-unit" */
+typedef int wpng_make_clang_tidy_compilers_happy;
+#endif
#endif /* ZINT_NO_PNG */
diff --git a/backend/ps.c b/backend/ps.c
index b6500792..834b18ed 100644
--- a/backend/ps.c
+++ b/backend/ps.c
@@ -35,10 +35,11 @@
#include <math.h>
#include <stdio.h>
#include "common.h"
+#include "filemem.h"
#include "output.h"
/* Output Ultracode rectangle colour as PostScript setrgbcolor/setcmykcolor */
-static void ps_put_colour(const int is_rgb, const int colour, FILE *feps) {
+static void ps_put_colour(const int is_rgb, const int colour, struct filemem *const fmp) {
const int idx = colour >= 1 && colour <= 8 ? colour - 1 : 6 /*black*/;
if (is_rgb) {
/* Use RGB colour space */
@@ -52,8 +53,8 @@ static void ps_put_colour(const int is_rgb, const int colour, FILE *feps) {
"0 0 0", /* 6: Black (7) */
"1 1 1", /* 7: White (8) */
};
- fputs(ps_rgbs[idx], feps);
- fputs(" setrgbcolor\n", feps);
+ fm_puts(ps_rgbs[idx], fmp);
+ fm_puts(" setrgbcolor\n", fmp);
} else {
static const char ps_cmyks[8][8] = {
"1 0 0 0", /* 0: Cyan (1) */
@@ -65,8 +66,8 @@ static void ps_put_colour(const int is_rgb, const int colour, FILE *feps) {
"0 0 0 1", /* 6: Black (7) */
"0 0 0 0", /* 7: White (8) */
};
- fputs(ps_cmyks[idx], feps);
- fputs(" setcmykcolor\n", feps);
+ fm_puts(ps_cmyks[idx], fmp);
+ fm_puts(" setcmykcolor\n", fmp);
}
}
@@ -107,51 +108,52 @@ INTERNAL void ps_convert_test(const unsigned char *string, unsigned char *ps_str
#endif
/* Helper to output RGB colour */
-static void ps_put_rgbcolor(const float red, const float green, const float blue, FILE *feps) {
- out_putsf("", 2, red, feps);
- out_putsf(" ", 2, green, feps);
- out_putsf(" ", 2, blue, feps);
- fputs(" setrgbcolor\n", feps);
+static void ps_put_rgbcolor(const float red, const float green, const float blue,
+ struct filemem *const fmp) {
+ fm_putsf("", 2, red, fmp);
+ fm_putsf(" ", 2, green, fmp);
+ fm_putsf(" ", 2, blue, fmp);
+ fm_puts(" setrgbcolor\n", fmp);
}
/* Helper to output CMYK colour */
static void ps_put_cmykcolor(const float cyan, const float magenta, const float yellow, const float black,
- FILE *feps) {
- out_putsf("", 2, cyan, feps);
- out_putsf(" ", 2, magenta, feps);
- out_putsf(" ", 2, yellow, feps);
- out_putsf(" ", 2, black, feps);
- fputs(" setcmykcolor\n", feps);
+ struct filemem *const fmp) {
+ fm_putsf("", 2, cyan, fmp);
+ fm_putsf(" ", 2, magenta, fmp);
+ fm_putsf(" ", 2, yellow, fmp);
+ fm_putsf(" ", 2, black, fmp);
+ fm_puts(" setcmykcolor\n", fmp);
}
/* Helper to output rectangle */
static void ps_put_rect(const struct zint_symbol *symbol, const struct zint_vector_rect *rect, const int type,
- FILE *feps) {
+ struct filemem *const fmp) {
if (type == 0 || type == 1) {
- out_putsf("", 2, rect->height, feps);
- out_putsf(" ", 2, (symbol->vector->height - rect->y) - rect->height, feps);
+ fm_putsf("", 2, rect->height, fmp);
+ fm_putsf(" ", 2, (symbol->vector->height - rect->y) - rect->height, fmp);
}
- out_putsf(type == 0 ? " " : type == 1 ? " I " : type == 2 ? "I " : "", 2, rect->x, feps);
- out_putsf(" ", 2, rect->width, feps);
- fputs(" R\n", feps);
+ fm_putsf(type == 0 ? " " : type == 1 ? " I " : type == 2 ? "I " : "", 2, rect->x, fmp);
+ fm_putsf(" ", 2, rect->width, fmp);
+ fm_puts(" R\n", fmp);
}
/* Helper to output circle/disc */
static void ps_put_circle(const struct zint_symbol *symbol, const struct zint_vector_circle *circle,
- const float radius, const int type, FILE *feps) {
+ const float radius, const int type, struct filemem *const fmp) {
if (circle->width) {
- out_putsf("", 2, circle->x, feps);
- out_putsf(" ", 2, symbol->vector->height - circle->y, feps);
- out_putsf(" ", 4, radius, feps);
- out_putsf(" ", 4, circle->width, feps);
- fputs(" C\n", feps);
+ fm_putsf("", 2, circle->x, fmp);
+ fm_putsf(" ", 2, symbol->vector->height - circle->y, fmp);
+ fm_putsf(" ", 4, radius, fmp);
+ fm_putsf(" ", 4, circle->width, fmp);
+ fm_puts(" C\n", fmp);
} else {
if (type == 0 || type == 1) {
- out_putsf("", 2, symbol->vector->height - circle->y, feps);
- out_putsf(" ", 4, radius, feps);
+ fm_putsf("", 2, symbol->vector->height - circle->y, fmp);
+ fm_putsf(" ", 4, radius, fmp);
}
- out_putsf(type == 0 ? " " : type == 1 ? " I " : type == 2 ? "I " : "", 2, circle->x, feps);
- fputs(" D\n", feps);
+ fm_putsf(type == 0 ? " " : type == 1 ? " I " : type == 2 ? "I " : "", 2, circle->x, fmp);
+ fm_puts(" D\n", fmp);
}
}
@@ -168,7 +170,8 @@ static int ps_count_rectangles(const struct zint_symbol *symbol) {
}
INTERNAL int ps_plot(struct zint_symbol *symbol) {
- FILE *feps;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
unsigned char fgred, fggrn, fgblu, bgred, bggrn, bgblu, bgalpha;
int fgcyan, fgmagenta, fgyellow, fgblack, bgcyan, bgmagenta, bgyellow, bgblack;
float red_ink = 0.0f, green_ink = 0.0f, blue_ink = 0.0f; /* Suppress `-Wmaybe-uninitialized` */
@@ -190,21 +193,15 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
int iso_latin1 = 0;
int have_circles_with_width = 0, have_circles_without_width = 0;
const int upcean = is_upcean(symbol->symbology);
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT;
const int is_rgb = (symbol->output_options & CMYK_COLOUR) == 0;
if (symbol->vector == NULL) {
strcpy(symbol->errtxt, "646: Vector header NULL");
return ZINT_ERROR_INVALID_DATA;
}
-
- if (output_to_stdout) {
- feps = stdout;
- } else {
- if (!(feps = out_fopen(symbol->outfile, "w"))) {
- sprintf(symbol->errtxt, "645: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "w")) {
+ sprintf(symbol->errtxt, "645: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
}
if (is_rgb) {
@@ -266,52 +263,52 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
}
/* Start writing the header */
- fputs("%!PS-Adobe-3.0 EPSF-3.0\n", feps);
+ fm_puts("%!PS-Adobe-3.0 EPSF-3.0\n", fmp);
if (ZINT_VERSION_BUILD) {
- fprintf(feps, "%%%%Creator: Zint %d.%d.%d.%d\n",
+ fm_printf(fmp, "%%%%Creator: Zint %d.%d.%d.%d\n",
ZINT_VERSION_MAJOR, ZINT_VERSION_MINOR, ZINT_VERSION_RELEASE, ZINT_VERSION_BUILD);
} else {
- fprintf(feps, "%%%%Creator: Zint %d.%d.%d\n", ZINT_VERSION_MAJOR, ZINT_VERSION_MINOR, ZINT_VERSION_RELEASE);
+ fm_printf(fmp, "%%%%Creator: Zint %d.%d.%d\n", ZINT_VERSION_MAJOR, ZINT_VERSION_MINOR, ZINT_VERSION_RELEASE);
}
- fputs("%%Title: Zint Generated Symbol\n"
- "%%Pages: 0\n", feps);
- fprintf(feps, "%%%%BoundingBox: 0 0 %d %d\n",
+ fm_puts("%%Title: Zint Generated Symbol\n"
+ "%%Pages: 0\n", fmp);
+ fm_printf(fmp, "%%%%BoundingBox: 0 0 %d %d\n",
(int) ceilf(symbol->vector->width), (int) ceilf(symbol->vector->height));
- fputs("%%EndComments\n", feps);
+ fm_puts("%%EndComments\n", fmp);
/* Definitions */
if (have_circles_without_width) {
/* Disc: y radius x D */
- fputs("/D { newpath 3 1 roll 0 360 arc fill } bind def\n", feps);
+ fm_puts("/D { newpath 3 1 roll 0 360 arc fill } bind def\n", fmp);
}
if (have_circles_with_width) {
/* Circle (ring): x y radius width C (adapted from BWIPP renmaxicode.ps) */
- fputs("/C { newpath 4 1 roll 3 copy 0 360 arc closepath 4 -1 roll add 360 0 arcn closepath fill }"
- " bind def\n", feps);
+ fm_puts("/C { newpath 4 1 roll 3 copy 0 360 arc closepath 4 -1 roll add 360 0 arcn closepath fill }"
+ " bind def\n", fmp);
}
if (symbol->vector->hexagons) {
/* Hexagon: radius half_radius half_sqrt3_radius x y */
if (symbol->vector->hexagons->rotation == 0 || symbol->vector->hexagons->rotation == 180) {
- fputs("/H { newpath moveto 2 copy exch neg exch rmoveto 2 index neg 0 exch rlineto 2 copy neg rlineto"
+ fm_puts("/H { newpath moveto 2 copy exch neg exch rmoveto 2 index neg 0 exch rlineto 2 copy neg rlineto"
" 2 copy rlineto 3 -1 roll 0 exch rlineto exch neg exch rlineto closepath fill }"
- " bind def\n", feps);
+ " bind def\n", fmp);
} else {
- fputs("/H { newpath moveto 2 copy neg exch neg rmoveto 2 index 0 rlineto 2 copy exch rlineto"
+ fm_puts("/H { newpath moveto 2 copy neg exch neg rmoveto 2 index 0 rlineto 2 copy exch rlineto"
" 2 copy neg exch rlineto 3 -1 roll neg 0 rlineto neg exch neg rlineto closepath fill }"
- " bind def\n", feps);
+ " bind def\n", fmp);
}
/* Copy r hr hsr for repeat use without having to specify them subsequently */
- fputs("/J { 3 copy } bind def\n", feps);
+ fm_puts("/J { 3 copy } bind def\n", fmp);
/* TODO: Save repeating x also */
}
if (symbol->vector->rectangles || draw_background) {
/* Rectangle: h y x w */
- fputs("/R { newpath 4 1 roll exch moveto 1 index 0 rlineto 0 exch rlineto neg 0 rlineto closepath fill }"
- " bind def\n", feps);
+ fm_puts("/R { newpath 4 1 roll exch moveto 1 index 0 rlineto 0 exch rlineto neg 0 rlineto closepath fill }"
+ " bind def\n", fmp);
}
if (symbol->vector->rectangles || have_circles_without_width) {
/* Copy h y (rect) or y r (disc) for repeat use without having to specify them subsequently */
- fputs("/I { 2 copy } bind def\n", feps);
+ fm_puts("/I { 2 copy } bind def\n", fmp);
}
/* Now the actual representation */
@@ -319,21 +316,21 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
/* Background */
if (draw_background) {
if (is_rgb) {
- ps_put_rgbcolor(red_paper, green_paper, blue_paper, feps);
+ ps_put_rgbcolor(red_paper, green_paper, blue_paper, fmp);
} else {
- ps_put_cmykcolor(cyan_paper, magenta_paper, yellow_paper, black_paper, feps);
+ ps_put_cmykcolor(cyan_paper, magenta_paper, yellow_paper, black_paper, fmp);
}
- out_putsf("", 2, symbol->vector->height, feps);
- out_putsf(" 0 0 ", 2, symbol->vector->width, feps); /* y x w */
- fputs(" R\n", feps);
+ fm_putsf("", 2, symbol->vector->height, fmp);
+ fm_putsf(" 0 0 ", 2, symbol->vector->width, fmp); /* y x w */
+ fm_puts(" R\n", fmp);
}
if (symbol->symbology != BARCODE_ULTRA) {
if (is_rgb) {
- ps_put_rgbcolor(red_ink, green_ink, blue_ink, feps);
+ ps_put_rgbcolor(red_ink, green_ink, blue_ink, fmp);
} else {
- ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, feps);
+ ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, fmp);
}
}
@@ -362,22 +359,22 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
if (colour_rect_flag == 0) {
/* Set foreground colour */
if (is_rgb) {
- ps_put_rgbcolor(red_ink, green_ink, blue_ink, feps);
+ ps_put_rgbcolor(red_ink, green_ink, blue_ink, fmp);
} else {
- ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, feps);
+ ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, fmp);
}
colour_rect_flag = 1;
}
} else {
/* Set new colour */
- ps_put_colour(is_rgb, rect->colour, feps);
+ ps_put_colour(is_rgb, rect->colour, fmp);
}
}
if (i + 1 < u_i && rect->height == ultra_rects[i + 1]->height && rect->y == ultra_rects[i + 1]->y) {
- ps_put_rect(symbol, rect, type_latch ? 2 : 1, feps);
+ ps_put_rect(symbol, rect, type_latch ? 2 : 1, fmp);
type_latch = 1;
} else {
- ps_put_rect(symbol, rect, type_latch ? 3 : 0, feps);
+ ps_put_rect(symbol, rect, type_latch ? 3 : 0, fmp);
type_latch = 0;
}
}
@@ -385,10 +382,10 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
type_latch = 0;
for (rect = symbol->vector->rectangles; rect; rect = rect->next) {
if (rect->next && rect->height == rect->next->height && rect->y == rect->next->y) {
- ps_put_rect(symbol, rect, type_latch ? 2 : 1, feps);
+ ps_put_rect(symbol, rect, type_latch ? 2 : 1, fmp);
type_latch = 1;
} else {
- ps_put_rect(symbol, rect, type_latch ? 3 : 0, feps);
+ ps_put_rect(symbol, rect, type_latch ? 3 : 0, fmp);
type_latch = 0;
}
}
@@ -400,18 +397,18 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
float hy = symbol->vector->height - hex->y;
if (previous_diameter != hex->diameter) {
previous_diameter = hex->diameter;
- out_putsf("", 4, 0.5f * previous_diameter /*radius*/, feps);
- out_putsf(" ", 4, 0.43301270189221932338f * previous_diameter /*half_sqrt3_radius*/, feps);
- out_putsf(" ", 4, 0.25f * previous_diameter /*half_radius*/, feps);
- fputc('\n', feps);
+ fm_putsf("", 4, 0.5f * previous_diameter /*radius*/, fmp);
+ fm_putsf(" ", 4, 0.43301270189221932338f * previous_diameter /*half_sqrt3_radius*/, fmp);
+ fm_putsf(" ", 4, 0.25f * previous_diameter /*half_radius*/, fmp);
+ fm_putc('\n', fmp);
}
if (hex->next) {
- out_putsf("J ", 2, hex->x, feps);
+ fm_putsf("J ", 2, hex->x, fmp);
} else {
- out_putsf("", 2, hex->x, feps);
+ fm_putsf("", 2, hex->x, fmp);
}
- out_putsf(" ", 2, hy, feps);
- fputs(" H\n", feps);
+ fm_putsf(" ", 2, hy, fmp);
+ fm_puts(" H\n", fmp);
}
/* Circles */
@@ -425,25 +422,25 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
if (circle->colour) { /* Legacy - no longer used */
/* A 'white' circle */
if (is_rgb) {
- ps_put_rgbcolor(red_paper, green_paper, blue_paper, feps);
+ ps_put_rgbcolor(red_paper, green_paper, blue_paper, fmp);
} else {
- ps_put_cmykcolor(cyan_paper, magenta_paper, yellow_paper, black_paper, feps);
+ ps_put_cmykcolor(cyan_paper, magenta_paper, yellow_paper, black_paper, fmp);
}
- ps_put_circle(symbol, circle, radius, 0 /*type*/, feps);
+ ps_put_circle(symbol, circle, radius, 0 /*type*/, fmp);
if (circle->next) {
if (is_rgb) {
- ps_put_rgbcolor(red_ink, green_ink, blue_ink, feps);
+ ps_put_rgbcolor(red_ink, green_ink, blue_ink, fmp);
} else {
- ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, feps);
+ ps_put_cmykcolor(cyan_ink, magenta_ink, yellow_ink, black_ink, fmp);
}
}
} else {
/* A 'black' circle */
if (circle->next && circle->y == circle->next->y && circle->diameter == circle->next->diameter) {
- ps_put_circle(symbol, circle, radius, type_latch ? 2 : 1, feps);
+ ps_put_circle(symbol, circle, radius, type_latch ? 2 : 1, fmp);
type_latch = 1;
} else {
- ps_put_circle(symbol, circle, radius, type_latch ? 3 : 0, feps);
+ ps_put_circle(symbol, circle, radius, type_latch ? 3 : 0, fmp);
type_latch = 0;
}
}
@@ -465,70 +462,61 @@ INTERNAL int ps_plot(struct zint_symbol *symbol) {
}
if (iso_latin1) {
/* Change encoding to ISO 8859-1, see Postscript Language Reference Manual 2nd Edition Example 5.6 */
- fprintf(feps, "/%s findfont\n", font);
- fputs("dup length dict begin\n"
+ fm_printf(fmp, "/%s findfont\n", font);
+ fm_puts("dup length dict begin\n"
"{1 index /FID ne {def} {pop pop} ifelse} forall\n"
"/Encoding ISOLatin1Encoding def\n"
"currentdict\n"
"end\n"
- "/Helvetica-ISOLatin1 exch definefont pop\n", feps);
+ "/Helvetica-ISOLatin1 exch definefont pop\n", fmp);
font = "Helvetica-ISOLatin1";
}
do {
ps_convert(string->text, ps_string);
if (string->fsize != previous_fsize) {
- fprintf(feps, "/%s findfont", font);
+ fm_printf(fmp, "/%s findfont", font);
/* Compensate for Helvetica being smaller than Zint's OCR-B */
- out_putsf( " ", 2, upcean ? string->fsize * 1.07f : string->fsize, feps);
- fputs(" scalefont setfont\n", feps);
+ fm_putsf( " ", 2, upcean ? string->fsize * 1.07f : string->fsize, fmp);
+ fm_puts(" scalefont setfont\n", fmp);
previous_fsize = string->fsize;
}
/* Unhack the guard whitespace `gws_left_fudge`/`gws_right_fudge` hack */
if (upcean && string->halign == 1 && string->text[0] == '<') {
const float gws_left_fudge = symbol->scale < 0.1f ? 0.1f : symbol->scale; /* 0.5 * 2 * scale */
- out_putsf(" ", 2, string->x + gws_left_fudge, feps);
+ fm_putsf(" ", 2, string->x + gws_left_fudge, fmp);
} else if (upcean && string->halign == 2 && string->text[0] == '>') {
const float gws_right_fudge = symbol->scale < 0.1f ? 0.1f : symbol->scale; /* 0.5 * 2 * scale */
- out_putsf(" ", 2, string->x - gws_right_fudge, feps);
+ fm_putsf(" ", 2, string->x - gws_right_fudge, fmp);
} else {
- out_putsf(" ", 2, string->x, feps);
+ fm_putsf(" ", 2, string->x, fmp);
}
- out_putsf(" ", 2, symbol->vector->height - string->y, feps);
- fputs(" moveto\n", feps);
+ fm_putsf(" ", 2, symbol->vector->height - string->y, fmp);
+ fm_puts(" moveto\n", fmp);
if (string->rotation != 0) {
- fputs(" gsave\n", feps);
- fprintf(feps, " %d rotate\n", 360 - string->rotation);
+ fm_puts(" gsave\n", fmp);
+ fm_printf(fmp, " %d rotate\n", 360 - string->rotation);
}
if (string->halign == 0 || string->halign == 2) { /* Need width for middle or right align */
- fprintf(feps, " (%s) stringwidth pop" /* Returns "width height" - discard "height" */
+ fm_printf(fmp, " (%s) stringwidth pop" /* Returns "width height" - discard "height" */
" %s 0 rmoveto\n", ps_string, string->halign == 2 ? "neg" : "-2 div");
}
- fprintf(feps, " (%s) show\n", ps_string);
+ fm_printf(fmp, " (%s) show\n", ps_string);
if (string->rotation != 0) {
- fputs(" grestore\n", feps);
+ fm_puts(" grestore\n", fmp);
}
string = string->next;
} while (string);
}
- if (ferror(feps)) {
- sprintf(symbol->errtxt, "647: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(feps);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "647: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(feps) != 0) {
- sprintf(symbol->errtxt, "648: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(feps) != 0) {
- sprintf(symbol->errtxt, "649: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "649: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return error_number;
diff --git a/backend/qr.c b/backend/qr.c
index 68f8251d..49a6f647 100644
--- a/backend/qr.c
+++ b/backend/qr.c
@@ -827,7 +827,8 @@ static void qr_add_ecc(unsigned char fullstream[], const unsigned char datastrea
}
for (j = 0; j < length_this_block; j++) {
- data_block[j] = datastream[in_posn + j]; /* NOLINT false-positive popped up with clang-tidy 14.0.1 */
+ /* This false-positive popped up with clang-tidy 14.0.1 */
+ data_block[j] = datastream[in_posn + j]; /* NOLINT(clang-analyzer-core.uninitialized.Assign) */
}
rs_encode(&rs, length_this_block, data_block, ecc_block);
@@ -848,7 +849,8 @@ static void qr_add_ecc(unsigned char fullstream[], const unsigned char datastrea
}
for (j = 0; j < short_data_block_length; j++) {
- interleaved_data[(j * blocks) + i] = data_block[j]; /* NOLINT and another with clang-tidy 14.0.6 */
+ /* And another with clang-tidy 14.0.6 */
+ interleaved_data[(j * blocks) + i] = data_block[j]; /* NOLINT(clang-analyzer-core.uninitialized.Assign) */
}
if (i >= qty_short_blocks) {
diff --git a/backend/raster.c b/backend/raster.c
index c30bb8df..74f4ba18 100644
--- a/backend/raster.c
+++ b/backend/raster.c
@@ -244,12 +244,14 @@ static int save_raster_image_to_file(struct zint_symbol *symbol, const int image
#ifndef ZINT_NO_PNG
error_number = png_pixel_plot(symbol, rotated_pixbuf);
#else
- if (rotate_angle) {
- free(rotated_pixbuf);
- }
- return ZINT_ERROR_INVALID_OPTION;
+ error_number = ZINT_ERROR_INVALID_OPTION;
#endif
break;
+#if defined(__GNUC__) && !defined(__clang__) && defined(NDEBUG) && defined(ZINT_NO_PNG)
+/* Suppress gcc warning ‘<unknown>’ may be used uninitialized - only when Release and ZINT_NO_PNG */
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wmaybe-uninitialized"
+#endif
case OUT_PCX_FILE:
error_number = pcx_pixel_plot(symbol, rotated_pixbuf);
break;
@@ -262,6 +264,9 @@ static int save_raster_image_to_file(struct zint_symbol *symbol, const int image
default:
error_number = bmp_pixel_plot(symbol, rotated_pixbuf);
break;
+#if defined(__GNUC__) && !defined(__clang__) && defined(NDEBUG) && defined(ZINT_NO_PNG)
+#pragma GCC diagnostic pop
+#endif
}
if (rotate_angle) {
@@ -1417,6 +1422,10 @@ INTERNAL int plot_raster(struct zint_symbol *symbol, int rotate_angle, int file_
if (error != 0) {
return error;
}
+ if (symbol->rows <= 0) {
+ strcpy(symbol->errtxt, "664: No rows");
+ return ZINT_ERROR_INVALID_OPTION;
+ }
if (symbol->symbology == BARCODE_MAXICODE) {
error = plot_raster_maxicode(symbol, rotate_angle, file_type);
diff --git a/backend/svg.c b/backend/svg.c
index ebd396f7..57329e74 100644
--- a/backend/svg.c
+++ b/backend/svg.c
@@ -35,6 +35,7 @@
#include <stdio.h>
#include "common.h"
+#include "filemem.h"
#include "output.h"
#include "fonts/normal_woff2.h"
#include "fonts/upcean_woff2.h"
@@ -95,26 +96,27 @@ static void svg_make_html_friendly(const unsigned char *string, char *html_versi
}
/* Helper to output floating point attribute */
-static void svg_put_fattrib(const char *prefix, const int dp, const float val, FILE *fsvg) {
- out_putsf(prefix, dp, val, fsvg);
- fputc('"', fsvg);
+static void svg_put_fattrib(const char *prefix, const int dp, const float val, struct filemem *fmp) {
+ fm_putsf(prefix, dp, val, fmp);
+ fm_putc('"', fmp);
}
/* Helper to output opacity attribute attribute and close tag (maybe) */
-static void svg_put_opacity_close(const unsigned char alpha, const float val, const int close, FILE *fsvg) {
+static void svg_put_opacity_close(const unsigned char alpha, const float val, const int close, struct filemem *fmp) {
if (alpha != 0xff) {
- svg_put_fattrib(" opacity=\"", 3, val, fsvg);
+ svg_put_fattrib(" opacity=\"", 3, val, fmp);
}
if (close) {
- fputc('/', fsvg);
+ fm_putc('/', fmp);
}
- fputs(">\n", fsvg);
+ fm_puts(">\n", fmp);
}
INTERNAL int svg_plot(struct zint_symbol *symbol) {
static const char normal_font_family[] = "Arimo";
static const char upcean_font_family[] = "OCRB";
- FILE *fsvg;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
int error_number = 0;
float previous_diameter;
float radius, half_radius, half_sqrt3_radius;
@@ -135,7 +137,6 @@ INTERNAL int svg_plot(struct zint_symbol *symbol) {
int len, html_len;
const int upcean = is_upcean(symbol->symbology);
- const int output_to_stdout = symbol->output_options & BARCODE_STDOUT;
char *html_string;
(void) out_colour_get_rgb(symbol->fgcolour, &fgred, &fggreen, &fgblue, &fg_alpha);
@@ -175,69 +176,68 @@ INTERNAL int svg_plot(struct zint_symbol *symbol) {
strcpy(symbol->errtxt, "681: Vector header NULL");
return ZINT_ERROR_INVALID_DATA;
}
- if (output_to_stdout) {
- fsvg = stdout;
- } else {
- if (!(fsvg = out_fopen(symbol->outfile, "w"))) {
- sprintf(symbol->errtxt, "680: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "w")) {
+ sprintf(symbol->errtxt, "680: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
}
/* Start writing the header */
- fputs("<?xml version=\"1.0\" standalone=\"no\"?>\n"
+ fm_puts("<?xml version=\"1.0\" standalone=\"no\"?>\n"
"<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\" \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n",
- fsvg);
- fprintf(fsvg, "<svg width=\"%d\" height=\"%d\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\">\n",
+ fmp);
+ fm_printf(fmp, "<svg width=\"%d\" height=\"%d\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\">\n",
(int) ceilf(symbol->vector->width), (int) ceilf(symbol->vector->height));
- fputs(" <desc>Zint Generated Symbol</desc>\n", fsvg);
+ fm_puts(" <desc>Zint Generated Symbol</desc>\n", fmp);
if ((symbol->output_options & EMBED_VECTOR_FONT) && symbol->vector->strings) {
- fprintf(fsvg, " <style>@font-face {font-family:\"%s\"; src:url(data:font/woff2;base64,%s);}</style>\n",
- upcean ? "OCRB" : "Arimo", upcean ? upcean_woff2 : normal_woff2);
+ /* Split into `puts()` rather than one very large `printf()` */
+ fm_printf(fmp, " <style>@font-face {font-family:\"%s\"; src:url(data:font/woff2;base64,",
+ upcean ? "OCRB" : "Arimo");
+ fm_puts(upcean ? upcean_woff2 : normal_woff2, fmp);
+ fm_puts(");}</style>\n", fmp);
}
- fprintf(fsvg, " <g id=\"barcode\" fill=\"#%s\">\n", fgcolour_string);
+ fm_printf(fmp, " <g id=\"barcode\" fill=\"#%s\">\n", fgcolour_string);
if (bg_alpha != 0) {
- fprintf(fsvg, " <rect x=\"0\" y=\"0\" width=\"%d\" height=\"%d\" fill=\"#%s\"",
+ fm_printf(fmp, " <rect x=\"0\" y=\"0\" width=\"%d\" height=\"%d\" fill=\"#%s\"",
(int) ceilf(symbol->vector->width), (int) ceilf(symbol->vector->height), bgcolour_string);
- svg_put_opacity_close(bg_alpha, bg_alpha_opacity, 1 /*close*/, fsvg);
+ svg_put_opacity_close(bg_alpha, bg_alpha_opacity, 1 /*close*/, fmp);
}
if (symbol->vector->rectangles) {
int current_colour = 0;
rect = symbol->vector->rectangles;
- fputs(" <path d=\"", fsvg);
+ fm_puts(" <path d=\"", fmp);
while (rect) {
if (current_colour && rect->colour != current_colour) {
- fputc('"', fsvg);
+ fm_putc('"', fmp);
if (current_colour != -1) {
svg_pick_colour(current_colour, colour_code);
- fprintf(fsvg, " fill=\"#%s\"", colour_code);
+ fm_printf(fmp, " fill=\"#%s\"", colour_code);
}
- svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fsvg);
- fputs(" <path d=\"", fsvg);
+ svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fmp);
+ fm_puts(" <path d=\"", fmp);
}
current_colour = rect->colour;
- out_putsf("M", 2, rect->x, fsvg);
- out_putsf(" ", 2, rect->y, fsvg);
- out_putsf("h", 2, rect->width, fsvg);
- out_putsf("v", 2, rect->height, fsvg);
- out_putsf("h-", 2, rect->width, fsvg);
- fputs("Z", fsvg);
+ fm_putsf("M", 2, rect->x, fmp);
+ fm_putsf(" ", 2, rect->y, fmp);
+ fm_putsf("h", 2, rect->width, fmp);
+ fm_putsf("v", 2, rect->height, fmp);
+ fm_putsf("h-", 2, rect->width, fmp);
+ fm_puts("Z", fmp);
rect = rect->next;
}
- fputc('"', fsvg);
+ fm_putc('"', fmp);
if (current_colour != -1) {
svg_pick_colour(current_colour, colour_code);
- fprintf(fsvg, " fill=\"#%s\"", colour_code);
+ fm_printf(fmp, " fill=\"#%s\"", colour_code);
}
- svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fsvg);
+ svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fmp);
}
if (symbol->vector->hexagons) {
previous_diameter = radius = half_radius = half_sqrt3_radius = 0.0f;
hex = symbol->vector->hexagons;
- fputs(" <path d=\"", fsvg);
+ fm_puts(" <path d=\"", fmp);
while (hex) {
if (previous_diameter != hex->diameter) {
previous_diameter = hex->diameter;
@@ -246,37 +246,37 @@ INTERNAL int svg_plot(struct zint_symbol *symbol) {
half_sqrt3_radius = 0.43301270189221932338f * previous_diameter;
}
if ((hex->rotation == 0) || (hex->rotation == 180)) {
- out_putsf("M", 2, hex->x, fsvg);
- out_putsf(" ", 2, hex->y + radius, fsvg);
- out_putsf("L", 2, hex->x + half_sqrt3_radius, fsvg);
- out_putsf(" ", 2, hex->y + half_radius, fsvg);
- out_putsf("L", 2, hex->x + half_sqrt3_radius, fsvg);
- out_putsf(" ", 2, hex->y - half_radius, fsvg);
- out_putsf("L", 2, hex->x, fsvg);
- out_putsf(" ", 2, hex->y - radius, fsvg);
- out_putsf("L", 2, hex->x - half_sqrt3_radius, fsvg);
- out_putsf(" ", 2, hex->y - half_radius, fsvg);
- out_putsf("L", 2, hex->x - half_sqrt3_radius, fsvg);
- out_putsf(" ", 2, hex->y + half_radius, fsvg);
+ fm_putsf("M", 2, hex->x, fmp);
+ fm_putsf(" ", 2, hex->y + radius, fmp);
+ fm_putsf("L", 2, hex->x + half_sqrt3_radius, fmp);
+ fm_putsf(" ", 2, hex->y + half_radius, fmp);
+ fm_putsf("L", 2, hex->x + half_sqrt3_radius, fmp);
+ fm_putsf(" ", 2, hex->y - half_radius, fmp);
+ fm_putsf("L", 2, hex->x, fmp);
+ fm_putsf(" ", 2, hex->y - radius, fmp);
+ fm_putsf("L", 2, hex->x - half_sqrt3_radius, fmp);
+ fm_putsf(" ", 2, hex->y - half_radius, fmp);
+ fm_putsf("L", 2, hex->x - half_sqrt3_radius, fmp);
+ fm_putsf(" ", 2, hex->y + half_radius, fmp);
} else {
- out_putsf("M", 2, hex->x - radius, fsvg);
- out_putsf(" ", 2, hex->y, fsvg);
- out_putsf("L", 2, hex->x - half_radius, fsvg);
- out_putsf(" ", 2, hex->y + half_sqrt3_radius, fsvg);
- out_putsf("L", 2, hex->x + half_radius, fsvg);
- out_putsf(" ", 2, hex->y + half_sqrt3_radius, fsvg);
- out_putsf("L", 2, hex->x + radius, fsvg);
- out_putsf(" ", 2, hex->y, fsvg);
- out_putsf("L", 2, hex->x + half_radius, fsvg);
- out_putsf(" ", 2, hex->y - half_sqrt3_radius, fsvg);
- out_putsf("L", 2, hex->x - half_radius, fsvg);
- out_putsf(" ", 2, hex->y - half_sqrt3_radius, fsvg);
+ fm_putsf("M", 2, hex->x - radius, fmp);
+ fm_putsf(" ", 2, hex->y, fmp);
+ fm_putsf("L", 2, hex->x - half_radius, fmp);
+ fm_putsf(" ", 2, hex->y + half_sqrt3_radius, fmp);
+ fm_putsf("L", 2, hex->x + half_radius, fmp);
+ fm_putsf(" ", 2, hex->y + half_sqrt3_radius, fmp);
+ fm_putsf("L", 2, hex->x + radius, fmp);
+ fm_putsf(" ", 2, hex->y, fmp);
+ fm_putsf("L", 2, hex->x + half_radius, fmp);
+ fm_putsf(" ", 2, hex->y - half_sqrt3_radius, fmp);
+ fm_putsf("L", 2, hex->x - half_radius, fmp);
+ fm_putsf(" ", 2, hex->y - half_sqrt3_radius, fmp);
}
- fputc('Z', fsvg);
+ fm_putc('Z', fmp);
hex = hex->next;
}
- fputc('"', fsvg);
- svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fsvg);
+ fm_putc('"', fmp);
+ svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fmp);
}
previous_diameter = radius = 0.0f;
@@ -286,28 +286,28 @@ INTERNAL int svg_plot(struct zint_symbol *symbol) {
previous_diameter = circle->diameter;
radius = 0.5f * previous_diameter;
}
- fputs(" <circle", fsvg);
- svg_put_fattrib(" cx=\"", 2, circle->x, fsvg);
- svg_put_fattrib(" cy=\"", 2, circle->y, fsvg);
- svg_put_fattrib(" r=\"", circle->width ? 3 : 2, radius, fsvg);
+ fm_puts(" <circle", fmp);
+ svg_put_fattrib(" cx=\"", 2, circle->x, fmp);
+ svg_put_fattrib(" cy=\"", 2, circle->y, fmp);
+ svg_put_fattrib(" r=\"", circle->width ? 3 : 2, radius, fmp);
if (circle->colour) { /* Legacy - no longer used */
if (circle->width) {
- fprintf(fsvg, " stroke=\"#%s\"", bgcolour_string);
- svg_put_fattrib(" stroke-width=\"", 3, circle->width, fsvg);
- fputs(" fill=\"none\"", fsvg);
+ fm_printf(fmp, " stroke=\"#%s\"", bgcolour_string);
+ svg_put_fattrib(" stroke-width=\"", 3, circle->width, fmp);
+ fm_puts(" fill=\"none\"", fmp);
} else {
- fprintf(fsvg, " fill=\"#%s\"", bgcolour_string);
+ fm_printf(fmp, " fill=\"#%s\"", bgcolour_string);
}
/* This doesn't work how the user is likely to expect - more work needed! */
- svg_put_opacity_close(bg_alpha, bg_alpha_opacity, 1 /*close*/, fsvg);
+ svg_put_opacity_close(bg_alpha, bg_alpha_opacity, 1 /*close*/, fmp);
} else {
if (circle->width) {
- fprintf(fsvg, " stroke=\"#%s\"", fgcolour_string);
- svg_put_fattrib(" stroke-width=\"", 3, circle->width, fsvg);
- fputs(" fill=\"none\"", fsvg);
+ fm_printf(fmp, " stroke=\"#%s\"", fgcolour_string);
+ svg_put_fattrib(" stroke-width=\"", 3, circle->width, fmp);
+ fm_puts(" fill=\"none\"", fmp);
}
- svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fsvg);
+ svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 1 /*close*/, fmp);
}
circle = circle->next;
}
@@ -316,53 +316,44 @@ INTERNAL int svg_plot(struct zint_symbol *symbol) {
string = symbol->vector->strings;
while (string) {
const char *const halign = string->halign == 2 ? "end" : string->halign == 1 ? "start" : "middle";
- fputs(" <text", fsvg);
- svg_put_fattrib(" x=\"", 2, string->x, fsvg);
- svg_put_fattrib(" y=\"", 2, string->y, fsvg);
- fprintf(fsvg, " text-anchor=\"%s\"", halign);
+ fm_puts(" <text", fmp);
+ svg_put_fattrib(" x=\"", 2, string->x, fmp);
+ svg_put_fattrib(" y=\"", 2, string->y, fmp);
+ fm_printf(fmp, " text-anchor=\"%s\"", halign);
if (upcean) {
- fprintf(fsvg, " font-family=\"%s, monospace\"", upcean_font_family);
+ fm_printf(fmp, " font-family=\"%s, monospace\"", upcean_font_family);
} else {
- fprintf(fsvg, " font-family=\"%s, Arial, sans-serif\"", normal_font_family);
+ fm_printf(fmp, " font-family=\"%s, Arial, sans-serif\"", normal_font_family);
}
- svg_put_fattrib(" font-size=\"", 1, string->fsize, fsvg);
+ svg_put_fattrib(" font-size=\"", 1, string->fsize, fmp);
if (bold) {
- fputs(" font-weight=\"bold\"", fsvg);
+ fm_puts(" font-weight=\"bold\"", fmp);
}
if (string->rotation != 0) {
- fprintf(fsvg, " transform=\"rotate(%d", string->rotation);
- out_putsf(",", 2, string->x, fsvg);
- out_putsf(",", 2, string->y, fsvg);
- fputs(")\"", fsvg);
+ fm_printf(fmp, " transform=\"rotate(%d", string->rotation);
+ fm_putsf(",", 2, string->x, fmp);
+ fm_putsf(",", 2, string->y, fmp);
+ fm_puts(")\"", fmp);
}
- svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 0 /*close*/, fsvg);
+ svg_put_opacity_close(fg_alpha, fg_alpha_opacity, 0 /*close*/, fmp);
svg_make_html_friendly(string->text, html_string);
- fprintf(fsvg, " %s\n", html_string);
- fputs(" </text>\n", fsvg);
+ fm_printf(fmp, " %s\n", html_string);
+ fm_puts(" </text>\n", fmp);
string = string->next;
}
- fputs(" </g>\n"
- "</svg>\n", fsvg);
+ fm_puts(" </g>\n"
+ "</svg>\n", fmp);
- if (ferror(fsvg)) {
- sprintf(symbol->errtxt, "682: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(fsvg);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "682: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(fsvg) != 0) {
- sprintf(symbol->errtxt, "683: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (fclose(fsvg) != 0) {
- sprintf(symbol->errtxt, "684: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "684: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return error_number;
diff --git a/backend/tests/CMakeLists.txt b/backend/tests/CMakeLists.txt
index 1ab1b02a..94c4204f 100644
--- a/backend/tests/CMakeLists.txt
+++ b/backend/tests/CMakeLists.txt
@@ -58,6 +58,7 @@ zint_add_test(dmatrix test_dmatrix)
zint_add_test(dotcode test_dotcode)
zint_add_test(eci test_eci)
zint_add_test(emf test_emf)
+zint_add_test(filemem test_filemem)
zint_add_test(gb18030 test_gb18030)
zint_add_test(gb2312 test_gb2312)
zint_add_test(gif test_gif)
diff --git a/backend/tests/test_bmp.c b/backend/tests/test_bmp.c
index c63262c4..b98f015a 100644
--- a/backend/tests/test_bmp.c
+++ b/backend/tests/test_bmp.c
@@ -155,6 +155,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[4096];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[32768];
+ int filebuf_size;
const char *const have_identify = testUtilHaveIdentify();
@@ -220,7 +222,23 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, 0);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_codablock.c b/backend/tests/test_codablock.c
index a8cf4e57..eafd921a 100644
--- a/backend/tests/test_codablock.c
+++ b/backend/tests/test_codablock.c
@@ -590,7 +590,7 @@ static void test_fuzz(const testCtx *const p_ctx) {
};
struct item data[] = {
/* 0*/ { -1, -1, "\034\034I", 3, 0, 1, "" },
- /* 1*/ { 6, -2147483648,
+ /* 1*/ { 6, -2147483647 - 1 /*Suppress MSVC warning C4146*/,
"\134\000\377\153\143\163\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061\061"
"\071\065\062\000\000\000\000\061\061\061\061\061\061\366\366\366\366\366\366\366\366\366\366\007\366\366\366\366\366\366\366\061\061\061\061\061\061\061\061\061"
"\061\061\061\061\061\061\061\323\323\323\323\000\200\135\000\362\000\000\000\000\000\050\000\000\000\000\162\162\162\162\034\153\143\163\061\061\061\061\061\061"
diff --git a/backend/tests/test_emf.c b/backend/tests/test_emf.c
index ad590579..d96f9063 100644
--- a/backend/tests/test_emf.c
+++ b/backend/tests/test_emf.c
@@ -104,6 +104,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[1024];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[32768];
+ int filebuf_size;
int have_libreoffice = 0;
if (p_ctx->generate) {
@@ -182,7 +184,23 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- if (p_ctx->index == -1) assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, data[i].rotate_angle);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_filemem.c b/backend/tests/test_filemem.c
new file mode 100644
index 00000000..96d4a331
--- /dev/null
+++ b/backend/tests/test_filemem.c
@@ -0,0 +1,477 @@
+/*
+ libzint - the open source barcode library
+ Copyright (C) 2023 Robin Stuart <rstuart114@gmail.com>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+ 3. Neither the name of the project nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+ */
+/* SPDX-License-Identifier: BSD-3-Clause */
+
+#include <errno.h>
+#include <fcntl.h>
+#include <limits.h>
+#include <locale.h>
+#include <math.h>
+#include <sys/stat.h>
+#include "testcommon.h"
+#include "../common.h"
+#include "../filemem.h"
+
+static void test_svg(const testCtx *const p_ctx) {
+ int debug = p_ctx->debug;
+
+ struct item {
+ int symbology;
+ int output_options;
+ char *outfile;
+ char *data;
+ int length;
+ int ret;
+
+ char *expected;
+ };
+ /* s/\/\*[ 0-9]*\*\//\=printf("\/\*%3d*\/", line(".") - line("'<")): */
+ struct item data[] = {
+ /* 0*/ { BARCODE_CODE128, BARCODE_MEMORY_FILE, "out.svg", "ABCDEF", -1, 0,
+ "<?xml version=\"1.0\" standalone=\"no\"?>\n"
+ "<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\" \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n"
+ "<svg width=\"202\" height=\"117\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\">\n"
+ " <desc>Zint Generated Symbol</desc>\n"
+ " <g id=\"barcode\" fill=\"#000000\">\n"
+ " <rect x=\"0\" y=\"0\" width=\"202\" height=\"117\" fill=\"#FFFFFF\"/>\n"
+ " <path d=\"M0 0h4v100h-4ZM6 0h2v100h-2ZM12 0h2v100h-2ZM22 0h2v100h-2ZM26 0h2v100h-2ZM34 0h4v100h-4ZM44 0h2v100h-2ZM52 0h2v100h-2ZM56 0h4v100h-4ZM66 0h2v100h-2ZM74 0h2v100h-2ZM82 0h4v100h-4ZM88 0h2v100h-2ZM92 0h4v100h-4ZM102 0h2v100h-2ZM110 0h2v100h-2ZM118 0h4v100h-4ZM124 0h2v100h-2ZM132 0h2v100h-2ZM140 0h4v100h-4ZM150 0h2v100h-2ZM154 0h2v100h-2ZM158 0h4v100h-4ZM168 0h6v100h-6ZM176 0h4v100h-4ZM186 0h6v100h-6ZM194 0h2v100h-2ZM198 0h4v100h-4Z\"/>\n"
+ " <text x=\"101\" y=\"113.34\" text-anchor=\"middle\" font-family=\"Arimo, Arial, sans-serif\" font-size=\"14\">\n"
+ " ABCDEF\n"
+ " </text>\n"
+ " </g>\n"
+ "</svg>\n"
+ },
+ };
+ int data_size = ARRAY_SIZE(data);
+ int i, length, ret;
+ struct zint_symbol *symbol = NULL;
+
+ testStartSymbol("test_svg", &symbol);
+
+ for (i = 0; i < data_size; i++) {
+
+ if (testContinue(p_ctx, i)) continue;
+
+ symbol = ZBarcode_Create();
+ assert_nonnull(symbol, "Symbol not created\n");
+
+ length = testUtilSetSymbol(symbol, data[i].symbology, -1 /*input_mode*/, -1 /*eci*/, -1 /*option_1*/, -1, -1, data[i].output_options, data[i].data, data[i].length, debug);
+ strcpy(symbol->outfile, data[i].outfile);
+
+ ret = ZBarcode_Encode_and_Print(symbol, TU(data[i].data), length, 0);
+ assert_equal(ret, data[i].ret, "i:%d ZBarcode_Encode_and_Print(%d) ret %d != %d (%s)\n",
+ i, data[i].symbology, ret, data[i].ret, symbol->errtxt);
+
+ if (ret < ZINT_ERROR) {
+ const int expected_size = (int) strlen(data[i].expected);
+
+ assert_nonnull(symbol->memfile, "i:%d memfile NULL (%s)\n", i, symbol->errtxt);
+
+ assert_equal(symbol->memfile_size, expected_size, "i:%d memfile_size %d != %d (%s)\n",
+ i, symbol->memfile_size, expected_size, symbol->errtxt);
+ ret = memcmp(symbol->memfile, data[i].expected, symbol->memfile_size);
+ assert_zero(ret, "i:%d memcmp() %d != 0\n", i, ret);
+ } else {
+ assert_null(symbol->memfile, "i:%d memfile != NULL (%s)\n", i, symbol->errtxt);
+ assert_zero(symbol->memfile_size, "i:%d memfile_size != 0 (%s)\n", i, symbol->errtxt);
+ }
+
+ ZBarcode_Delete(symbol);
+ }
+
+ testFinish();
+}
+
+#ifndef _WIN32
+extern FILE *fmemopen(void *buf, size_t size, const char *mode);
+#endif
+
+static void test_putsf(const testCtx *const p_ctx) {
+ int debug = p_ctx->debug;
+
+ struct item {
+ const char *prefix;
+ int dp;
+ float arg;
+ const char *locale;
+ const char *expected;
+ };
+ /* s/\/\*[ 0-9]*\*\//\=printf("\/\*%3d*\/", line(".") - line("'<")): */
+ struct item data[] = {
+ /* 0*/ { "", 2, 1234.123, "", "1234.12" },
+ /* 1*/ { "", 3, 1234.123, "", "1234.123" },
+ /* 2*/ { "prefix ", 4, 1234.123, "", "prefix 1234.123" },
+ /* 3*/ { "", 2, -1234.126, "", "-1234.13" },
+ /* 4*/ { "", 2, 1234.1, "", "1234.1" },
+ /* 5*/ { "", 3, 1234.1, "", "1234.1" },
+ /* 6*/ { "", 4, 1234.1, "", "1234.1" },
+ /* 7*/ { "", 2, 1234.0, "", "1234" },
+ /* 8*/ { "", 2, -1234.0, "", "-1234" },
+ /* 9*/ { "", 3, 1234.1234, "de_DE.UTF-8", "1234.123" },
+ /* 10*/ { "", 4, -1234.1234, "de_DE.UTF-8", "-1234.1234" },
+ /* 11*/ { "prefix ", 4, -1234.1234, "de_DE.UTF-8", "prefix -1234.1234" },
+ };
+ int data_size = ARRAY_SIZE(data);
+ int i, j;
+
+ struct zint_symbol symbol_data = {0};
+ struct zint_symbol *const symbol = &symbol_data;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
+#ifndef _WIN32
+ FILE *fp;
+ char buf[512] = {0}; /* Suppress clang-16/17 run-time exception MemorySanitizer: use-of-uninitialized-value */
+#endif
+
+ testStart("test_putsf");
+
+ for (j = 0; j < 2; j++) { /* 1st `memfile`, then file */
+#ifdef _WIN32
+ if (j == 1) break; /* Skip file test on Windows */
+#endif
+ for (i = 0; i < data_size; i++) {
+ const char *locale = NULL;
+ int expected_size;
+
+ if (testContinue(p_ctx, i)) continue;
+
+ ZBarcode_Reset(symbol);
+ if (j == 1) {
+#ifndef _WIN32
+ buf[0] = '\0';
+ fp = fmemopen(buf, sizeof(buf), "w");
+ assert_nonnull(fp, "%d: fmemopen fail (%d, %s)\n", i, errno, strerror(errno));
+#endif
+ } else {
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ }
+ assert_nonzero(fm_open(fmp, symbol, "w"), "i:%d: fm_open fail (%d, %s)\n", i, fmp->err, strerror(fmp->err));
+ if (j == 1) {
+#ifndef _WIN32
+ /* Hack in `fmemopen()` fp */
+ assert_zero(fclose(fmp->fp), "i:%d fclose(fmp->fp) fail (%d, %s)\n", i, errno, strerror(errno));
+ fmp->fp = fp;
+#endif
+ }
+
+ if (data[i].locale && data[i].locale[0]) {
+ locale = setlocale(LC_ALL, data[i].locale);
+ if (!locale) { /* May not be available - warn unless quiet mode */
+ if (!(debug & ZINT_DEBUG_TEST_LESS_NOISY)) {
+ printf("i:%d: Warning: locale \"%s\" not available\n", i, data[i].locale);
+ }
+ }
+ }
+
+ fm_putsf(data[i].prefix, data[i].dp, data[i].arg, fmp);
+
+ assert_nonzero(fm_close(fmp, symbol), "i:%d: fm_close fail (%d, %s)\n", i, fmp->err, strerror(fmp->err));
+
+ if (locale) {
+ assert_nonnull(setlocale(LC_ALL, locale), "i:%d: setlocale(%s) restore fail (%d, %s)\n",
+ i, locale, errno, strerror(errno));
+ }
+
+ if (j == 1) {
+#ifndef _WIN32
+ assert_zero(strcmp(buf, data[i].expected), "%d: strcmp(%s, %s) != 0\n", i, buf, data[i].expected);
+#endif
+ } else {
+ expected_size = (int) strlen(data[i].expected);
+ assert_equal(symbol->memfile_size, expected_size, "i:%d: memfile_size %d != expected_size %d\n",
+ i, symbol->memfile_size, expected_size);
+ assert_nonnull(symbol->memfile, "i:%d memfile NULL\n", i);
+ assert_zero(memcmp(symbol->memfile, data[i].expected, expected_size), "i:%d: memcmp(%.*s, %.*s) != 0\n",
+ i, symbol->memfile_size, symbol->memfile, expected_size, data[i].expected);
+ }
+
+ ZBarcode_Clear(symbol);
+ }
+ }
+
+ testFinish();
+}
+
+static void test_printf(const testCtx *const p_ctx) {
+ int debug = p_ctx->debug;
+
+ int ret;
+ int j;
+ struct zint_symbol symbol_data = {0};
+ struct zint_symbol *const symbol = &symbol_data;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
+ const char outfile[] = "test_printf.tst";
+ unsigned char filebuf[32768];
+ int filebuf_size;
+
+ const char fmt1[] = "\n%s%04d\n\032\nwow\n\r\n%.2s\n"; /* '\032' SUB (^Z) */
+ const char expected1[] = "\ngosh0123\n\032\nwow\n\r\nge\n";
+#ifdef _WIN32
+ /* On Windows, non-binary (i.e. text) files, LF -> LF+CR (note, actual files only, not memfiles) */
+ const char expected1_text_file[] = "\r\ngosh0123\r\n\032\r\nwow\r\n\r\r\nge\r\n";
+#endif
+ const char *expected;
+ int expected_size;
+
+ (void)debug;
+
+ testStart("test_printf");
+
+ for (j = 0; j < 2; j++) { /* 1st memfile, then file */
+ ZBarcode_Reset(symbol);
+
+ /* Binary */
+ expected = expected1;
+ if (j == 1) {
+ strcpy(symbol->outfile, outfile);
+ } else {
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ }
+ ret = fm_open(fmp, symbol, "wb");
+ assert_equal(ret, 1, "fm_open ret %d != 1\n", ret);
+
+ ret = fm_printf(fmp, fmt1, "gosh", 123, "gee");
+ assert_equal(ret, 1, "fm_printf ret %d != 1\n", ret);
+
+ ret = fm_close(fmp, symbol);
+ assert_equal(ret, 1, "fm_close ret %d != 1\n", ret);
+
+ expected_size = (int) strlen(expected);
+
+ if (j == 1) {
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size);
+ assert_zero(ret, "testUtilReadFile(%s) %d != 0\n", symbol->outfile, ret);
+ assert_equal((int) filebuf_size, expected_size, "filebuf_size %d != %d\n", filebuf_size, expected_size);
+ assert_zero(memcmp(filebuf, expected, filebuf_size), "memcmp(%.*s, %s) != 0\n",
+ filebuf_size, filebuf, expected);
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "testUtilRemove(%s) != 0\n", symbol->outfile);
+ }
+ } else {
+ assert_nonnull(symbol->memfile, "memfile NULL (%d: %s)\n", fmp->err, strerror(fmp->err));
+ assert_equal(symbol->memfile_size, expected_size, "mempos %d != %d\n",
+ symbol->memfile_size, expected_size);
+ assert_zero(memcmp(symbol->memfile, expected, symbol->memfile_size), "memcmp(%.*s, %s) != 0\n",
+ symbol->memfile_size, symbol->memfile, expected);
+ }
+
+ /* Non-binary */
+ expected = expected1;
+ if (j == 1) {
+ strcpy(symbol->outfile, outfile);
+#ifdef _WIN32
+ expected = expected1_text_file;
+#endif
+ } else {
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ }
+ ret = fm_open(fmp, symbol, "w");
+ assert_equal(ret, 1, "fm_open ret %d != 1\n", ret);
+
+ ret = fm_printf(fmp, fmt1, "gosh", 123, "gee");
+ assert_equal(ret, 1, "fm_printf ret %d != 1\n", ret);
+
+ ret = fm_close(fmp, symbol);
+ assert_equal(ret, 1, "fm_close ret %d != 1\n", ret);
+
+ expected_size = (int) strlen(expected);
+
+ if (j == 1) {
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size);
+ assert_zero(ret, "testUtilReadFile(%s) %d != 0\n", symbol->outfile, ret);
+ assert_equal((int) filebuf_size, expected_size, "filebuf_size %d != %d\n", filebuf_size, expected_size);
+ assert_zero(memcmp(filebuf, expected, filebuf_size), "memcmp(%.*s, %s) != 0\n",
+ filebuf_size, filebuf, expected);
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "testUtilRemove(%s) != 0\n", symbol->outfile);
+ }
+ } else {
+ assert_nonnull(symbol->memfile, "mem NULL (%d: %s)\n", fmp->err, strerror(fmp->err));
+ assert_equal(symbol->memfile_size, expected_size, "mempos %d != %d\n",
+ symbol->memfile_size, expected_size);
+ assert_zero(memcmp(symbol->memfile, expected, symbol->memfile_size), "memcmp(%.*s, %s) != 0\n",
+ symbol->memfile_size, symbol->memfile, expected);
+ }
+
+ ZBarcode_Clear(symbol);
+ }
+
+ testFinish();
+}
+
+static void test_seek(const testCtx *const p_ctx) {
+ int debug = p_ctx->debug;
+
+ int ret;
+ int j;
+ struct zint_symbol symbol_data = {0};
+ struct zint_symbol *const symbol = &symbol_data;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
+ const char outfile[] = "test_seek.tst";
+
+ (void)debug;
+
+ testStart("test_seek");
+
+ for (j = 0; j < 2; j++) { /* 1st memfile, then file */
+ ZBarcode_Reset(symbol);
+
+ if (j == 1) {
+ strcpy(symbol->outfile, outfile);
+ } else {
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ }
+ ret = fm_open(fmp, symbol, "wb");
+ assert_equal(ret, 1, "j:%d fm_open ret %d != 1\n", j, ret);
+
+ ret = fm_puts("1234567890", fmp);
+ assert_equal(ret, 1, "j:%d fm_puts ret %d != 1\n", j, ret);
+ if (j != 1) {
+ assert_nonnull(fmp->mem, "mem NULL (%d: %s)\n", fmp->err, strerror(fmp->err));
+ assert_equal(fmp->mempos, 10, "mempos %d != 10\n", (int) fmp->mempos);
+ assert_zero(memcmp(fmp->mem, "1234567890", fmp->mempos), "memcmp fail\n");
+ }
+
+ ret = fm_seek(fmp, -10, SEEK_CUR);
+ assert_equal(ret, 1, "j:%d fm_seek ret %d != 1 (%d: %s)\n", j, ret, fmp->err, strerror(fmp->err));
+ ret = fm_error(fmp);
+ assert_zero(ret, "j:%d fm_error ret %d != 0\n", j, ret);
+ ret = (int) fm_tell(fmp);
+ assert_zero(ret, "j:%d fm_tell ret %d != 0\n", j, ret);
+
+ ret = fm_seek(fmp, 0, SEEK_END);
+ assert_equal(ret, 1, "j:%d fm_seek ret %d != 1\n", j, ret);
+ ret = fm_error(fmp);
+ assert_zero(ret, "j:%d fm_error ret %d != 0\n", j, ret);
+ ret = (int) fm_tell(fmp);
+ assert_equal(ret, 10, "j:%d fm_tell ret %d != 10\n", j, ret);
+
+ ret = fm_seek(fmp, -1, SEEK_SET);
+ assert_zero(ret, "j:%d fm_seek ret %d != 1\n", j, ret);
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+
+ ret = fm_close(fmp, symbol);
+ assert_zero(ret, "j:%d fm_close ret %d != 0\n", j, ret);
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+
+ if (j == 1) {
+ assert_zero(testUtilRemove(symbol->outfile), "testUtilRemove(%s) != 0\n", symbol->outfile);
+ }
+
+ ret = fm_open(fmp, symbol, "wb");
+ assert_equal(ret, 1, "j:%d fm_open ret %d != 1\n", j, ret);
+
+ ret = fm_seek(fmp, LONG_MAX, SEEK_CUR);
+ if (j == 1) { /* May work on some file systems */
+ if (ret == 0) {
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+ }
+ } else {
+ assert_zero(ret, "j:%d fm_seek ret %d != 0\n", j, ret);
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+ }
+
+ ret = fm_close(fmp, symbol);
+ if (j == 1) { /* See above */
+ if (ret == 0) {
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+ }
+ } else {
+ assert_zero(ret, "j:%d fm_close ret %d != 0\n", j, ret);
+ assert_equal(fmp->err, EINVAL, "j:%d fmp->err %d (%s) != EINVAL\n", j, fmp->err, strerror(fmp->err));
+ }
+
+ if (j == 1) {
+ assert_zero(testUtilRemove(symbol->outfile), "testUtilRemove(%s) != 0\n", symbol->outfile);
+ }
+
+ ZBarcode_Clear(symbol);
+ }
+
+ testFinish();
+}
+
+static void test_large(const testCtx *const p_ctx) {
+ int debug = p_ctx->debug;
+
+ int ret;
+ struct zint_symbol *symbol = NULL;
+ char data[] = "1";
+ int expected_size = 354879;
+
+ (void)debug;
+
+ testStart("test_large");
+
+ symbol = ZBarcode_Create();
+ assert_nonnull(symbol, "Symbol not created\n");
+
+ symbol->symbology = BARCODE_HANXIN;
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ strcpy(symbol->outfile, "out.gif"); /* Use GIF in case ZINT_NO_PNG */
+ symbol->option_2 = 84;
+ symbol->scale = 10.0f; /* Could go up to 86.5 (pixel buffer 0x3FB913B1, file size 8868579) but very very slow */
+
+ ret = ZBarcode_Encode_and_Print(symbol, TU(data), -1, 0);
+ assert_zero(ret, "ZBarcode_Encode_and_Print ret %d != 0 (%s)\n", ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "memfile NULL (%s)\n", symbol->errtxt);
+ assert_equal(symbol->memfile_size, expected_size, "memfile_size %d != expected %d\n",
+ symbol->memfile_size, expected_size);
+
+ symbol->scale = 87.0f; /* Too large (pixel buffer > 1GB) */
+ ret = ZBarcode_Print(symbol, 0);
+ assert_equal(ret, ZINT_ERROR_MEMORY, "ZBarcode_Print ret %d != ZINT_ERROR_MEMORY (%s)\n", ret, symbol->errtxt);
+
+ ZBarcode_Delete(symbol);
+
+ testFinish();
+}
+
+int main(int argc, char *argv[]) {
+
+ testFunction funcs[] = { /* name, func */
+ { "test_svg", test_svg },
+ { "test_putsf", test_putsf },
+ { "test_printf", test_printf },
+ { "test_seek", test_seek },
+ { "test_large", test_large },
+ };
+
+ testRun(argc, argv, funcs, ARRAY_SIZE(funcs));
+
+ testReport();
+
+ return 0;
+}
+
+/* vim: set ts=4 sw=4 et : */
+
diff --git a/backend/tests/test_gif.c b/backend/tests/test_gif.c
index 9b0578c1..3a351d3d 100644
--- a/backend/tests/test_gif.c
+++ b/backend/tests/test_gif.c
@@ -191,6 +191,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[4096];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[32768];
+ int filebuf_size;
const char *const have_identify = testUtilHaveIdentify();
@@ -268,7 +270,23 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, 0);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_output.c b/backend/tests/test_output.c
index 0e855e85..18159337 100644
--- a/backend/tests/test_output.c
+++ b/backend/tests/test_output.c
@@ -31,7 +31,6 @@
#include "testcommon.h"
#include "../output.h"
-#include <locale.h>
#ifdef _WIN32
#include <windows.h>
#include <direct.h>
@@ -411,82 +410,6 @@ static void test_fopen(const testCtx *const p_ctx) {
testFinish();
}
-#ifndef _WIN32
-extern FILE *fmemopen(void *buf, size_t size, const char *mode);
-#endif
-
-static void test_out_putsf(const testCtx *const p_ctx) {
- int debug = p_ctx->debug;
-
- struct item {
- const char *prefix;
- int dp;
- float arg;
- const char *locale;
- const char *expected;
- };
- /* s/\/\*[ 0-9]*\*\//\=printf("\/\*%3d*\/", line(".") - line("'<")): */
- struct item data[] = {
- /* 0*/ { "", 2, 1234.123, "", "1234.12" },
- /* 1*/ { "", 3, 1234.123, "", "1234.123" },
- /* 2*/ { "prefix ", 4, 1234.123, "", "prefix 1234.123" },
- /* 3*/ { "", 2, -1234.126, "", "-1234.13" },
- /* 4*/ { "", 2, 1234.1, "", "1234.1" },
- /* 5*/ { "", 3, 1234.1, "", "1234.1" },
- /* 6*/ { "", 4, 1234.1, "", "1234.1" },
- /* 7*/ { "", 2, 1234.0, "", "1234" },
- /* 8*/ { "", 2, -1234.0, "", "-1234" },
- /* 9*/ { "", 3, 1234.1234, "de_DE.UTF-8", "1234.123" },
- /* 10*/ { "", 4, -1234.1234, "de_DE.UTF-8", "-1234.1234" },
- /* 11*/ { "prefix ", 4, -1234.1234, "de_DE.UTF-8", "prefix -1234.1234" },
- };
- int data_size = ARRAY_SIZE(data);
- int i;
-
- FILE *fp;
- char buf[512] = {0}; /* Suppress clang-16/17 run-time exception MemorySanitizer: use-of-uninitialized-value */
-
- testStart("test_out_putsf");
-
-#ifdef _WIN32
- (void)i; (void)fp; (void)buf;
- testSkip("Test not implemented on Windows");
-#else
-
- for (i = 0; i < data_size; i++) {
- const char *locale = NULL;
-
- if (testContinue(p_ctx, i)) continue;
-
- buf[0] = '\0';
- fp = fmemopen(buf, sizeof(buf), "w");
- assert_nonnull(fp, "%d: fmemopen fail (%d, %s)\n", i, errno, strerror(errno));
-
- if (data[i].locale && data[i].locale[0]) {
- locale = setlocale(LC_ALL, data[i].locale);
- if (!locale) { /* May not be available - warn unless quiet mode */
- if (!(debug & ZINT_DEBUG_TEST_LESS_NOISY)) {
- printf("%d: Warning: locale \"%s\" not available\n", i, data[i].locale);
- }
- }
- }
-
- out_putsf(data[i].prefix, data[i].dp, data[i].arg, fp);
-
- assert_zero(fclose(fp), "%d: fclose fail (%d, %s)\n", i, errno, strerror(errno));
-
- if (locale) {
- assert_nonnull(setlocale(LC_ALL, locale), "%d: setlocale(%s) restore fail (%d, %s)\n",
- i, locale, errno, strerror(errno));
- }
-
- assert_zero(strcmp(buf, data[i].expected), "%d: strcmp(%s, %s) != 0\n", i, buf, data[i].expected);
- }
-
- testFinish();
-#endif /* _WIN32 */
-}
-
int main(int argc, char *argv[]) {
testFunction funcs[] = { /* name, func */
@@ -496,7 +419,6 @@ int main(int argc, char *argv[]) {
{ "test_quiet_zones", test_quiet_zones },
{ "test_set_whitespace_offsets", test_set_whitespace_offsets },
{ "test_fopen", test_fopen },
- { "test_out_putsf", test_out_putsf },
};
testRun(argc, argv, funcs, ARRAY_SIZE(funcs));
diff --git a/backend/tests/test_pcx.c b/backend/tests/test_pcx.c
index c75edf8b..bf4eaa60 100644
--- a/backend/tests/test_pcx.c
+++ b/backend/tests/test_pcx.c
@@ -65,6 +65,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[4096];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[36864];
+ int filebuf_size;
const char *const have_identify = testUtilHaveIdentify();
@@ -134,7 +136,23 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, 0);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_pdf417.c b/backend/tests/test_pdf417.c
index bd6532b9..ba1803db 100644
--- a/backend/tests/test_pdf417.c
+++ b/backend/tests/test_pdf417.c
@@ -144,8 +144,8 @@ static void test_options(const testCtx *const p_ctx) {
/* 9*/ { BARCODE_PDF417, -1, 10, -1, 0, { 0, 0, "" }, "12345", 0, 0, 3, 239, "", -1 }, /* ECC auto-set to 2, cols 10 */
/* 10*/ { BARCODE_PDF417, 9, -1, -1, 0, { 0, 0, "" }, "12345", ZINT_WARN_INVALID_OPTION, 0, 6, 103, "Warning 460: Security value out of range", -1 }, /* Invalid ECC, auto-set */
/* 11*/ { BARCODE_PDF417, -1, 31, -1, 0, { 0, 0, "" }, "12345", ZINT_WARN_INVALID_OPTION, 0, 6, 103, "Warning 461: Number of columns out of range (1 to 30)", 0 }, /* Invalid cols, auto-set */
- /* 12*/ { BARCODE_PDF417, -1, -1, 2, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, 0, 0, 0, "Error 466: Number of rows out of range (3 to 90)", -1 }, /* Invalid rows, error */
- /* 13*/ { BARCODE_PDF417, -1, -1, 91, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, 0, 0, 0, "Error 466: Number of rows out of range (3 to 90)", -1 }, /* Invalid rows, error */
+ /* 12*/ { BARCODE_PDF417, -1, -1, 2, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, ZINT_ERROR_INVALID_OPTION, 0, 0, "Error 466: Number of rows out of range (3 to 90)", -1 }, /* Invalid rows, error */
+ /* 13*/ { BARCODE_PDF417, -1, -1, 91, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, ZINT_ERROR_INVALID_OPTION, 0, 0, "Error 466: Number of rows out of range (3 to 90)", -1 }, /* Invalid rows, error */
/* 14*/ { BARCODE_PDF417, 9, -1, -1, WARN_FAIL_ALL, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, -1, 0, 0, "Error 460: Security value out of range", -1 }, /* Invalid ECC */
/* 15*/ { BARCODE_PDF417, -1, 31, -1, WARN_FAIL_ALL, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, -1, 0, 0, "Error 461: Number of columns out of range (1 to 30)", -1 }, /* Invalid cols */
/* 16*/ { BARCODE_PDF417, -1, 30, 31, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, -1, 0, 0, "Error 475: Columns x rows out of range (1 to 928)", -1 }, /* Rows * cols (930) > 928 */
@@ -160,11 +160,11 @@ static void test_options(const testCtx *const p_ctx) {
/* 25*/ { BARCODE_MICROPDF417, -1, 5, -1, WARN_FAIL_ALL, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, -1, 0, 0, "Error 468: Specified width out of range", -1 }, /* Invalid cols */
/* 26*/ { BARCODE_MICROPDF417, -1, 5, 3, 0, { 0, 0, "" }, "12345", ZINT_ERROR_INVALID_OPTION, -1, 0, 0, "Error 476: Cannot specify rows for MicroPDF417", -1 }, /* Rows option not available */
/* 27*/ { BARCODE_MICROPDF417, -1, 1, -1, 0, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLM", ZINT_WARN_INVALID_OPTION, 0, 17, 55, "Warning 469: Specified symbol size too small for data", -1 }, /* Cols 1 too small, auto-upped to 2 with warning */
- /* 28*/ { BARCODE_MICROPDF417, -1, 1, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLM", ZINT_ERROR_INVALID_OPTION, 0, 0, 0, "Error 469: Specified symbol size too small for data", -1 }, /* Cols 1 too small */
+ /* 28*/ { BARCODE_MICROPDF417, -1, 1, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLM", ZINT_ERROR_INVALID_OPTION, ZINT_ERROR_INVALID_OPTION, 0, 0, "Error 469: Specified symbol size too small for data", -1 }, /* Cols 1 too small */
/* 29*/ { BARCODE_MICROPDF417, -1, 2, -1, 0, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWX", ZINT_WARN_INVALID_OPTION, 0, 15, 99, "Warning 470: Specified symbol size too small for data", -1 }, /* Cols 2 too small, auto-upped to 4 with warning */
- /* 30*/ { BARCODE_MICROPDF417, -1, 2, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWX", ZINT_ERROR_INVALID_OPTION, 0, 0, 0, "Error 470: Specified symbol size too small for data", -1 }, /* Cols 2 too small */
+ /* 30*/ { BARCODE_MICROPDF417, -1, 2, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWX", ZINT_ERROR_INVALID_OPTION, ZINT_ERROR_INVALID_OPTION, 0, 0, "Error 470: Specified symbol size too small for data", -1 }, /* Cols 2 too small */
/* 31*/ { BARCODE_MICROPDF417, -1, 3, -1, 0, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKL", ZINT_WARN_INVALID_OPTION, 0, 32, 99, "Warning 471: Specified symbol size too small for data", -1 }, /* Cols 3 too small, auto-upped to 4 with warning */
- /* 32*/ { BARCODE_MICROPDF417, -1, 3, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKL", ZINT_ERROR_INVALID_OPTION, 0, 0, 0, "Error 471: Specified symbol size too small for data", -1 }, /* Cols 3 too small */
+ /* 32*/ { BARCODE_MICROPDF417, -1, 3, -1, WARN_FAIL_ALL, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKLMOPQRSTUVWXYZABCDEFGHIJKL", ZINT_ERROR_INVALID_OPTION, ZINT_ERROR_INVALID_OPTION, 0, 0, "Error 471: Specified symbol size too small for data", -1 }, /* Cols 3 too small */
/* 33*/ { BARCODE_PDF417, -1, 1, -1, 0, { 0, 0, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGH", ZINT_WARN_INVALID_OPTION, 0, 89, 103, "Warning 748: Columns increased from 1 to 2", -1 }, /* Cols 1 auto-upped to 2 just fits, now with warning */
/* 34*/ { BARCODE_PDF417, -1, 1, -1, 0, { 1, 2, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGH", ZINT_WARN_INVALID_OPTION, 0, 67, 120, "Warning 748: Columns increased from 1 to 3", -1 }, /* Cols 1 too small with Structured Append, used to fail, now auto-upped to 3 with warning */
/* 35*/ { BARCODE_PDF417, -1, 1, -1, 0, { 1, 2, "" }, "ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRST", ZINT_WARN_INVALID_OPTION, 0, 89, 103, "Warning 748: Columns increased from 1 to 2", -1 }, /* Cols 1 with Structured Append auto-upped to 2 just fits, now with warning */
diff --git a/backend/tests/test_png.c b/backend/tests/test_png.c
index 5a8ecac7..b8f5f497 100644
--- a/backend/tests/test_png.c
+++ b/backend/tests/test_png.c
@@ -239,6 +239,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[1024];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[32768];
+ int filebuf_size;
char *text;
const char *const have_identify = testUtilHaveIdentify();
@@ -330,7 +332,23 @@ static void test_print(const testCtx *const p_ctx) {
assert_zero(ret, "i:%d %s testUtilCmpPngs(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, 0);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_ps.c b/backend/tests/test_ps.c
index 927a076a..cd7fd801 100644
--- a/backend/tests/test_ps.c
+++ b/backend/tests/test_ps.c
@@ -117,8 +117,9 @@ static void test_print(const testCtx *const p_ctx) {
int i, length, ret;
struct zint_symbol *symbol = NULL;
- const char *data_dir = "/backend/tests/data/eps";
- const char *eps = "out.eps";
+ const char data_dir[] = "/backend/tests/data/eps";
+ const char eps[] = "out.eps";
+ const char memfile[] = "mem.eps";
char expected_file[1024];
char escaped[1024];
int escaped_size = 1024;
@@ -193,7 +194,25 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpEpss(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpEpss(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, data[i].rotate_angle);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_nonzero(symbol->memfile_size, "i:%d %s memfile_size 0\n", i, testUtilBarcodeName(data[i].symbology));
+
+ ret = testUtilWriteFile(memfile, symbol->memfile, symbol->memfile_size, "wb");
+ assert_zero(ret, "%d: testUtilWriteFile(%s) fail ret %d != 0\n", i, memfile, ret);
+
+ ret = testUtilCmpEpss(symbol->outfile, memfile);
+ assert_zero(ret, "i:%d %s testUtilCmpEpss(%s, %s) %d != 0\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, memfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ assert_zero(testUtilRemove(memfile), "i:%d testUtilRemove(%s) != 0\n", i, memfile);
+ }
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_svg.c b/backend/tests/test_svg.c
index 523d42c9..b5944d52 100644
--- a/backend/tests/test_svg.c
+++ b/backend/tests/test_svg.c
@@ -144,8 +144,9 @@ static void test_print(const testCtx *const p_ctx) {
int i, length, ret;
struct zint_symbol *symbol = NULL;
- const char *data_dir = "/backend/tests/data/svg";
- const char *svg = "out.svg";
+ const char data_dir[] = "/backend/tests/data/svg";
+ const char svg[] = "out.svg";
+ const char memfile[] = "mem.eps";
char expected_file[1024];
char escaped[1024];
int escaped_size = 1024;
@@ -240,7 +241,25 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpSvgs(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpSvgs(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, data[i].rotate_angle);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_nonzero(symbol->memfile_size, "i:%d %s memfile_size 0\n", i, testUtilBarcodeName(data[i].symbology));
+
+ ret = testUtilWriteFile(memfile, symbol->memfile, symbol->memfile_size, "wb");
+ assert_zero(ret, "%d: testUtilWriteFile(%s) fail ret %d != 0\n", i, memfile, ret);
+
+ ret = testUtilCmpSvgs(symbol->outfile, memfile);
+ assert_zero(ret, "i:%d %s testUtilCmpSvgs(%s, %s) %d != 0\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, memfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ assert_zero(testUtilRemove(memfile), "i:%d testUtilRemove(%s) != 0\n", i, memfile);
+ }
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/test_tif.c b/backend/tests/test_tif.c
index 9382aec1..ff1b8ec6 100644
--- a/backend/tests/test_tif.c
+++ b/backend/tests/test_tif.c
@@ -214,6 +214,8 @@ static void test_print(const testCtx *const p_ctx) {
char expected_file[1024];
char escaped[1024];
int escaped_size = 1024;
+ unsigned char filebuf[32768];
+ int filebuf_size;
char *text;
int have_tiffinfo = testUtilHaveTiffInfo();
@@ -301,7 +303,23 @@ static void test_print(const testCtx *const p_ctx) {
ret = testUtilCmpBins(symbol->outfile, expected_file);
assert_zero(ret, "i:%d %s testUtilCmpBins(%s, %s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, expected_file, ret);
- assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+
+ ret = testUtilReadFile(symbol->outfile, filebuf, sizeof(filebuf), &filebuf_size); /* For BARCODE_MEMORY_FILE */
+ assert_zero(ret, "i:%d %s testUtilReadFile(%s) %d != 0\n", i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret);
+
+ if (!(debug & ZINT_DEBUG_TEST_KEEP_OUTFILE)) {
+ assert_zero(testUtilRemove(symbol->outfile), "i:%d testUtilRemove(%s) != 0\n", i, symbol->outfile);
+ }
+
+ symbol->output_options |= BARCODE_MEMORY_FILE;
+ ret = ZBarcode_Print(symbol, 0);
+ assert_zero(ret, "i:%d %s ZBarcode_Print %s ret %d != 0 (%s)\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->outfile, ret, symbol->errtxt);
+ assert_nonnull(symbol->memfile, "i:%d %s memfile NULL\n", i, testUtilBarcodeName(data[i].symbology));
+ assert_equal(symbol->memfile_size, filebuf_size, "i:%d %s memfile_size %d != %d\n",
+ i, testUtilBarcodeName(data[i].symbology), symbol->memfile_size, filebuf_size);
+ assert_zero(memcmp(symbol->memfile, filebuf, symbol->memfile_size), "i:%d %s memcmp(memfile, filebuf) != 0\n",
+ i, testUtilBarcodeName(data[i].symbology));
}
ZBarcode_Delete(symbol);
diff --git a/backend/tests/testcommon.c b/backend/tests/testcommon.c
index 868e0afe..4876c0d9 100644
--- a/backend/tests/testcommon.c
+++ b/backend/tests/testcommon.c
@@ -1516,6 +1516,67 @@ int testUtilRmROFile(const char *filename) {
return testUtilRemove(filename);
}
+/* Read file into buffer */
+int testUtilReadFile(const char *filename, unsigned char *buffer, int buffer_size, int *p_size) {
+ long fileLen;
+ size_t n;
+ size_t nRead = 0;
+ FILE *fp = testUtilOpen(filename, "rb");
+ if (!fp) {
+ return 1;
+ }
+ if (fseek(fp, 0, SEEK_END) != 0) {
+ (void) fclose(fp);
+ return 2;
+ }
+ fileLen = ftell(fp);
+ if (fileLen <= 0 || fileLen == LONG_MAX) {
+ (void) fclose(fp);
+ return 3;
+ }
+ if (fseek(fp, 0, SEEK_SET) != 0) {
+ (void) fclose(fp);
+ return 4;
+ }
+ if (fileLen > (long) buffer_size) {
+ (void) fclose(fp);
+ return 5;
+ }
+ do {
+ n = fread(buffer + nRead, 1, fileLen - nRead, fp);
+ if (ferror(fp)) {
+ (void) fclose(fp);
+ return 6;
+ }
+ nRead += n;
+ } while (!feof(fp) && (0 < n) && ((long) nRead < fileLen));
+
+ if (fclose(fp) != 0) {
+ return 7;
+ }
+
+ *p_size = (int) nRead;
+
+ return 0;
+}
+
+/* Write file from buffer */
+int testUtilWriteFile(const char *filename, const unsigned char *buffer, const int buffer_size, const char *mode) {
+ FILE *fp = testUtilOpen(filename, mode);
+ if (!fp) {
+ return 1;
+ }
+ if (fwrite(buffer, 1, buffer_size, fp) == 0) {
+ (void) fclose(fp);
+ return 2;
+ }
+ if (fclose(fp) != 0) {
+ return 3;
+ }
+
+ return 0;
+}
+
/* Compare 2 PNG files */
int testUtilCmpPngs(const char *png1, const char *png2) {
int ret = -1;
@@ -3945,7 +4006,15 @@ int testUtilZXingCPPCmp(struct zint_symbol *symbol, char *msg, char *cmp_buf, in
int primary_len = (int) strlen(primary);
int maxi_len = 0;
if (symbol->option_2 >= 1 && symbol->option_2 <= 100) {
+/* Suppress gcc warning null destination pointer [-Wformat-overflow=] false-positive */
+#if defined(__GNUC__) && !defined(__clang__)
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wformat-overflow="
+#endif
sprintf(maxi, "[)>\03601\035%02d", symbol->option_2 - 1);
+#if defined(__GNUC__) && !defined(__clang__)
+#pragma GCC diagnostic pop
+#endif
maxi_len = (int) strlen(maxi);
}
#if 1
diff --git a/backend/tests/testcommon.h b/backend/tests/testcommon.h
index 13adfa81..a3be8c8e 100644
--- a/backend/tests/testcommon.h
+++ b/backend/tests/testcommon.h
@@ -57,7 +57,7 @@ extern "C" {
#define testutil_pclose(stream) _pclose(stream)
#else
#include <unistd.h>
-# if defined(ZINT_IS_C89)
+# if defined(ZINT_IS_C89) || defined(ZINT_IS_C99)
extern FILE *popen(const char *command, const char *type);
extern int pclose(FILE *stream);
# endif
@@ -174,6 +174,8 @@ int testUtilRmDir(const char *dirname);
int testUtilRename(const char *oldpath, const char *newpath);
int testUtilCreateROFile(const char *filename);
int testUtilRmROFile(const char *filename);
+int testUtilReadFile(const char *filename, unsigned char *buffer, int buffer_size, int *p_size);
+int testUtilWriteFile(const char *filename, const unsigned char *buffer, const int buffer_size, const char *mode);
int testUtilCmpPngs(const char *file1, const char *file2);
int testUtilCmpTxts(const char *txt1, const char *txt2);
diff --git a/backend/tests/tools/bwipp_dump.ps.tar.xz b/backend/tests/tools/bwipp_dump.ps.tar.xz
index c6e9dd36..439006b7 100644
Binary files a/backend/tests/tools/bwipp_dump.ps.tar.xz and b/backend/tests/tools/bwipp_dump.ps.tar.xz differ
diff --git a/backend/tif.c b/backend/tif.c
index 2b50df40..635a7d66 100644
--- a/backend/tif.c
+++ b/backend/tif.c
@@ -34,11 +34,8 @@
#include <errno.h>
#include <math.h>
#include <stdio.h>
-#ifdef _MSC_VER
-#include <io.h>
-#include <fcntl.h>
-#endif
#include "common.h"
+#include "filemem.h"
#include "output.h"
#include "tif.h"
#include "tif_lzw.h"
@@ -97,7 +94,8 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
int strip_row;
unsigned int bytes_put;
long total_bytes_put;
- FILE *tif_file;
+ struct filemem fm;
+ struct filemem *const fmp = &fm;
const unsigned char *pb;
int compression = TIF_NO_COMPRESSION;
tif_lzw_state lzw_state;
@@ -315,19 +313,11 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
}
/* Open output file in binary mode */
- if (output_to_stdout) {
-#ifdef _MSC_VER
- if (-1 == _setmode(_fileno(stdout), _O_BINARY)) {
- sprintf(symbol->errtxt, "671: Could not set stdout to binary (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
-#endif
- tif_file = stdout;
- } else {
- if (!(tif_file = out_fopen(symbol->outfile, "wb+"))) { /* '+' as use fseek/ftell() */
- sprintf(symbol->errtxt, "672: Could not open output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_ACCESS;
- }
+ if (!fm_open(fmp, symbol, "wb")) {
+ sprintf(symbol->errtxt, "672: Could not open output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_ACCESS;
+ }
+ if (!output_to_stdout) {
compression = TIF_LZW;
tif_lzw_init(&lzw_state);
}
@@ -341,7 +331,7 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
header.identity = 42;
header.offset = (uint32_t) free_memory;
- fwrite(&header, sizeof(tiff_header_t), 1, tif_file);
+ fm_write(&header, sizeof(tiff_header_t), 1, fmp);
total_bytes_put = sizeof(tiff_header_t);
/* Pixel data */
@@ -387,14 +377,14 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
if (strip_row == rows_per_strip || (strip == strip_count - 1 && strip_row == rows_last_strip)) {
/* End of strip */
if (compression == TIF_LZW) {
- file_pos = ftell(tif_file);
- if (!tif_lzw_encode(&lzw_state, tif_file, strip_buf, bytes_put)) { /* Only fails if can't malloc */
+ file_pos = fm_tell(fmp);
+ if (!tif_lzw_encode(&lzw_state, fmp, strip_buf, bytes_put)) { /* Only fails if can't malloc */
tif_lzw_cleanup(&lzw_state);
- (void) fclose(tif_file); /* Only use LZW if not STDOUT, so ok to close */
+ (void) fm_close(fmp, symbol);
strcpy(symbol->errtxt, "673: Failed to malloc LZW hash table");
return ZINT_ERROR_MEMORY;
}
- bytes_put = ftell(tif_file) - file_pos;
+ bytes_put = fm_tell(fmp) - file_pos;
if (bytes_put != strip_bytes[strip]) {
const int diff = bytes_put - strip_bytes[strip];
strip_bytes[strip] = bytes_put;
@@ -403,7 +393,7 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
}
}
} else {
- fwrite(strip_buf, 1, bytes_put, tif_file);
+ fm_write(strip_buf, 1, bytes_put, fmp);
}
strip++;
total_bytes_put += bytes_put;
@@ -415,27 +405,25 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
}
if (total_bytes_put & 1) {
- putc(0, tif_file); /* IFD must be on word boundary */
+ fm_putc(0, fmp); /* IFD must be on word boundary */
total_bytes_put++;
}
if (compression == TIF_LZW) {
tif_lzw_cleanup(&lzw_state);
- file_pos = ftell(tif_file);
- fseek(tif_file, 4, SEEK_SET);
+ file_pos = fm_tell(fmp);
+ fm_seek(fmp, 4, SEEK_SET);
free_memory = file_pos;
temp32 = (uint32_t) free_memory;
/* Shouldn't happen as `free_memory` checked above to be <= 0xffff0000 & should only decrease */
if (free_memory != temp32 || (long) free_memory != file_pos) {
strcpy(symbol->errtxt, "982: Output file size too big");
- if (!output_to_stdout) {
- (void) fclose(tif_file);
- }
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_MEMORY;
}
- fwrite(&temp32, 4, 1, tif_file);
- fseek(tif_file, file_pos, SEEK_SET);
+ fm_write(&temp32, 4, 1, fmp);
+ fm_seek(fmp, file_pos, SEEK_SET);
}
/* Image File Directory */
@@ -504,7 +492,7 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
tags[entries++].offset = strip_bytes[0];
} else {
update_offsets[offsets++] = entries;
- tags[entries++].offset = free_memory;
+ tags[entries++].offset = (uint32_t) free_memory;
free_memory += strip_count * 4;
}
@@ -512,14 +500,14 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
tags[entries].type = 5; /* RATIONAL */
tags[entries].count = 1;
update_offsets[offsets++] = entries;
- tags[entries++].offset = free_memory;
+ tags[entries++].offset = (uint32_t) free_memory;
free_memory += 8;
tags[entries].tag = 0x011b; /* YResolution */
tags[entries].type = 5; /* RATIONAL */
tags[entries].count = 1;
update_offsets[offsets++] = entries;
- tags[entries++].offset = free_memory;
+ tags[entries++].offset = (uint32_t) free_memory;
free_memory += 8;
tags[entries].tag = 0x0128; /* ResolutionUnit */
@@ -552,14 +540,14 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
tags[update_offsets[i]].offset += ifd_size;
}
- fwrite(&entries, sizeof(entries), 1, tif_file);
- fwrite(&tags, sizeof(tiff_tag_t), entries, tif_file);
- fwrite(&offset, sizeof(offset), 1, tif_file);
+ fm_write(&entries, sizeof(entries), 1, fmp);
+ fm_write(&tags, sizeof(tiff_tag_t), entries, fmp);
+ fm_write(&offset, sizeof(offset), 1, fmp);
total_bytes_put += ifd_size;
if (samples_per_pixel > 2) {
for (i = 0; i < samples_per_pixel; i++) {
- fwrite(&bits_per_sample, sizeof(bits_per_sample), 1, tif_file);
+ fm_write(&bits_per_sample, sizeof(bits_per_sample), 1, fmp);
}
total_bytes_put += sizeof(bits_per_sample) * samples_per_pixel;
}
@@ -567,66 +555,59 @@ INTERNAL int tif_pixel_plot(struct zint_symbol *symbol, const unsigned char *pix
if (strip_count != 1) {
/* Strip offsets */
for (i = 0; i < strip_count; i++) {
- fwrite(&strip_offset[i], 4, 1, tif_file);
+ fm_write(&strip_offset[i], 4, 1, fmp);
}
/* Strip byte lengths */
for (i = 0; i < strip_count; i++) {
- fwrite(&strip_bytes[i], 4, 1, tif_file);
+ fm_write(&strip_bytes[i], 4, 1, fmp);
}
total_bytes_put += strip_count * 8;
}
/* XResolution */
temp32 = symbol->dpmm ? symbol->dpmm : 72;
- fwrite(&temp32, 4, 1, tif_file);
+ fm_write(&temp32, 4, 1, fmp);
temp32 = symbol->dpmm ? 10 /*cm*/ : 1;
- fwrite(&temp32, 4, 1, tif_file);
+ fm_write(&temp32, 4, 1, fmp);
total_bytes_put += 8;
/* YResolution */
temp32 = symbol->dpmm ? symbol->dpmm : 72;
- fwrite(&temp32, 4, 1, tif_file);
+ fm_write(&temp32, 4, 1, fmp);
temp32 = symbol->dpmm ? 10 /*cm*/ : 1;
- fwrite(&temp32, 4, 1, tif_file);
+ fm_write(&temp32, 4, 1, fmp);
total_bytes_put += 8;
if (color_map_size) {
for (i = 0; i < color_map_size; i++) {
- fwrite(&color_map[i].red, 2, 1, tif_file);
+ fm_write(&color_map[i].red, 2, 1, fmp);
}
for (i = 0; i < color_map_size; i++) {
- fwrite(&color_map[i].green, 2, 1, tif_file);
+ fm_write(&color_map[i].green, 2, 1, fmp);
}
for (i = 0; i < color_map_size; i++) {
- fwrite(&color_map[i].blue, 2, 1, tif_file);
+ fm_write(&color_map[i].blue, 2, 1, fmp);
}
total_bytes_put += 6 * color_map_size;
}
- if (ferror(tif_file)) {
- sprintf(symbol->errtxt, "679: Incomplete write to output (%d: %.30s)", errno, strerror(errno));
- if (!output_to_stdout) {
- (void) fclose(tif_file);
- }
+ if (fm_error(fmp)) {
+ sprintf(symbol->errtxt, "679: Incomplete write to output (%d: %.30s)", fmp->err, strerror(fmp->err));
+ (void) fm_close(fmp, symbol);
return ZINT_ERROR_FILE_WRITE;
}
- if (output_to_stdout) {
- if (fflush(tif_file) != 0) {
- sprintf(symbol->errtxt, "980: Incomplete flush to output (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
- } else {
- if (ftell(tif_file) != total_bytes_put) {
- (void) fclose(tif_file);
+ if (!output_to_stdout) {
+ if (fm_tell(fmp) != total_bytes_put) {
+ (void) fm_close(fmp, symbol);
strcpy(symbol->errtxt, "674: Failed to write all output");
return ZINT_ERROR_FILE_WRITE;
}
- if (fclose(tif_file) != 0) {
- sprintf(symbol->errtxt, "981: Failure on closing output file (%d: %.30s)", errno, strerror(errno));
- return ZINT_ERROR_FILE_WRITE;
- }
+ }
+ if (!fm_close(fmp, symbol)) {
+ sprintf(symbol->errtxt, "981: Failure on closing output file (%d: %.30s)", fmp->err, strerror(fmp->err));
+ return ZINT_ERROR_FILE_WRITE;
}
return 0;
diff --git a/backend/tif_lzw.h b/backend/tif_lzw.h
index 06ce722a..75b73f3c 100644
--- a/backend/tif_lzw.h
+++ b/backend/tif_lzw.h
@@ -161,13 +161,13 @@ static void tif_lzw_cl_hash(tif_lzw_state *sp) {
}
/* Explicit 0xff masking to make icc -check=conversions happy */
-#define PutNextCode(op_file, c) { \
+#define PutNextCode(op_fmp, c) { \
nextdata = (nextdata << nbits) | c; \
nextbits += nbits; \
- putc((nextdata >> (nextbits - 8)) & 0xff, op_file); \
+ fm_putc((nextdata >> (nextbits - 8)) & 0xff, op_fmp); \
nextbits -= 8; \
if (nextbits >= 8) { \
- putc((nextdata >> (nextbits - 8)) & 0xff, op_file); \
+ fm_putc((nextdata >> (nextbits - 8)) & 0xff, op_fmp); \
nextbits -= 8; \
} \
outcount += nbits; \
@@ -187,7 +187,7 @@ static void tif_lzw_cl_hash(tif_lzw_state *sp) {
* are re-sized at this point, and a CODE_CLEAR is generated
* for the decoder.
*/
-static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char *bp, int cc) {
+static int tif_lzw_encode(tif_lzw_state *sp, struct filemem *op_fmp, const unsigned char *bp, int cc) {
register long fcode;
register tif_lzw_hash *hp;
register int h, c;
@@ -229,7 +229,7 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
ent = (tif_lzw_hcode) -1;
if (cc > 0) {
- PutNextCode(op_file, CODE_CLEAR);
+ PutNextCode(op_fmp, CODE_CLEAR);
ent = *bp++; cc--; incount++;
}
while (cc > 0) {
@@ -275,7 +275,7 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
/*
* New entry, emit code and add to table.
*/
- PutNextCode(op_file, ent);
+ PutNextCode(op_fmp, ent);
ent = (tif_lzw_hcode) c;
hp->code = (tif_lzw_hcode) (free_ent++);
hp->hash = fcode;
@@ -286,7 +286,7 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
incount = 0;
outcount = 0;
free_ent = CODE_FIRST;
- PutNextCode(op_file, CODE_CLEAR);
+ PutNextCode(op_fmp, CODE_CLEAR);
nbits = BITS_MIN;
maxcode = MAXCODE(BITS_MIN);
} else {
@@ -314,7 +314,7 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
incount = 0;
outcount = 0;
free_ent = CODE_FIRST;
- PutNextCode(op_file, CODE_CLEAR);
+ PutNextCode(op_fmp, CODE_CLEAR);
nbits = BITS_MIN;
maxcode = MAXCODE(BITS_MIN);
} else {
@@ -332,13 +332,13 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
*/
if (ent != (tif_lzw_hcode) -1) {
- PutNextCode(op_file, ent);
+ PutNextCode(op_fmp, ent);
free_ent++;
if (free_ent == CODE_MAX - 1) {
/* table is full, emit clear code and reset */
outcount = 0;
- PutNextCode(op_file, CODE_CLEAR);
+ PutNextCode(op_fmp, CODE_CLEAR);
nbits = BITS_MIN;
} else {
/*
@@ -351,10 +351,10 @@ static int tif_lzw_encode(tif_lzw_state *sp, FILE *op_file, const unsigned char
}
}
}
- PutNextCode(op_file, CODE_EOI);
+ PutNextCode(op_fmp, CODE_EOI);
/* Explicit 0xff masking to make icc -check=conversions happy */
if (nextbits > 0) {
- putc((nextdata << (8 - nextbits)) & 0xff, op_file);
+ fm_putc((nextdata << (8 - nextbits)) & 0xff, op_fmp);
}
return 1;
diff --git a/backend/vector.c b/backend/vector.c
index 71396d12..b95f4d54 100644
--- a/backend/vector.c
+++ b/backend/vector.c
@@ -409,8 +409,8 @@ INTERNAL int plot_vector(struct zint_symbol *symbol, int rotate_angle, int file_
const float descent_small = 0.948426545f; /* Arimo value for SMALL_TEXT (font height 5) */
/* For UPC/EAN only */
- float addon_row_yposn;
- float addon_row_height;
+ float addon_row_yposn = 0.0f; /* Suppress gcc -Wmaybe-uninitialized false positive */
+ float addon_row_height = 0.0f; /* Ditto */
int upcae_outside_font_height = 0; /* UPC-A/E outside digits font size */
const float gws_left_fudge = 0.5f; /* These make the guard whitespaces appear closer to the edge for SVG/qzint */
const float gws_right_fudge = 0.5f; /* (undone by EMF/EPS) */
@@ -443,6 +443,10 @@ INTERNAL int plot_vector(struct zint_symbol *symbol, int rotate_angle, int file_
if (error_number != 0) {
return error_number;
}
+ if (symbol->rows <= 0) {
+ strcpy(symbol->errtxt, "697: No rows");
+ return ZINT_ERROR_INVALID_OPTION;
+ }
/* Allocate memory */
vector = symbol->vector = (struct zint_vector *) malloc(sizeof(struct zint_vector));
diff --git a/backend/zint.h b/backend/zint.h
index a564fe59..e974eba0 100644
--- a/backend/zint.h
+++ b/backend/zint.h
@@ -131,6 +131,8 @@ extern "C" {
int bitmap_height; /* Height of bitmap image (raster output only) */
unsigned char *alphamap; /* Array of alpha values used (raster output only) */
struct zint_vector *vector; /* Pointer to vector header (vector output only) */
+ unsigned char *memfile; /* Pointer to in-memory file buffer if BARCODE_MEMORY_FILE (output only) */
+ int memfile_size; /* Length of in-memory file buffer (output only) */
};
/* Segment for use with `ZBarcode_Encode_Segs()` below */
@@ -273,25 +275,26 @@ extern "C" {
#define BARCODE_LAST 146 /* Max barcode number marker, not barcode */
/* Output options (`symbol->output_options`) */
-#define BARCODE_BIND_TOP 0x0001 /* Boundary bar above the symbol only (not below), does not affect stacking */
+#define BARCODE_BIND_TOP 0x00001 /* Boundary bar above the symbol only (not below), does not affect stacking */
/* Note: value was once used by the legacy (never-used) BARCODE_NO_ASCII */
-#define BARCODE_BIND 0x0002 /* Boundary bars above & below the symbol and between stacked symbols */
-#define BARCODE_BOX 0x0004 /* Box around symbol */
-#define BARCODE_STDOUT 0x0008 /* Output to stdout */
-#define READER_INIT 0x0010 /* Reader Initialisation (Programming) */
-#define SMALL_TEXT 0x0020 /* Use smaller font */
-#define BOLD_TEXT 0x0040 /* Use bold font */
-#define CMYK_COLOUR 0x0080 /* CMYK colour space (Encapsulated PostScript and TIF) */
-#define BARCODE_DOTTY_MODE 0x0100 /* Plot a matrix symbol using dots rather than squares */
-#define GS1_GS_SEPARATOR 0x0200 /* Use GS instead of FNC1 as GS1 separator (Data Matrix) */
-#define OUT_BUFFER_INTERMEDIATE 0x0400 /* Return ASCII values in bitmap buffer (OUT_BUFFER only) */
-#define BARCODE_QUIET_ZONES 0x0800 /* Add compliant quiet zones (additional to any specified whitespace) */
+#define BARCODE_BIND 0x00002 /* Boundary bars above & below the symbol and between stacked symbols */
+#define BARCODE_BOX 0x00004 /* Box around symbol */
+#define BARCODE_STDOUT 0x00008 /* Output to stdout */
+#define READER_INIT 0x00010 /* Reader Initialisation (Programming) */
+#define SMALL_TEXT 0x00020 /* Use smaller font */
+#define BOLD_TEXT 0x00040 /* Use bold font */
+#define CMYK_COLOUR 0x00080 /* CMYK colour space (Encapsulated PostScript and TIF) */
+#define BARCODE_DOTTY_MODE 0x00100 /* Plot a matrix symbol using dots rather than squares */
+#define GS1_GS_SEPARATOR 0x00200 /* Use GS instead of FNC1 as GS1 separator (Data Matrix) */
+#define OUT_BUFFER_INTERMEDIATE 0x00400 /* Return ASCII values in bitmap buffer (OUT_BUFFER only) */
+#define BARCODE_QUIET_ZONES 0x00800 /* Add compliant quiet zones (additional to any specified whitespace) */
/* Note: CODE16K, CODE49, CODABLOCKF, ITF14, EAN/UPC have default quiet zones
*/
-#define BARCODE_NO_QUIET_ZONES 0x1000 /* Disable quiet zones, notably those with defaults as listed above */
-#define COMPLIANT_HEIGHT 0x2000 /* Warn if height not compliant, or use standard height (if any) as default */
-#define EANUPC_GUARD_WHITESPACE 0x4000 /* Add quiet zone indicators ("<"/">") to HRT whitespace (EAN/UPC) */
-#define EMBED_VECTOR_FONT 0x8000 /* Embed font in vector output - currently only for SVG output */
+#define BARCODE_NO_QUIET_ZONES 0x01000 /* Disable quiet zones, notably those with defaults as listed above */
+#define COMPLIANT_HEIGHT 0x02000 /* Warn if height not compliant, or use standard height (if any) as default */
+#define EANUPC_GUARD_WHITESPACE 0x04000 /* Add quiet zone indicators ("<"/">") to HRT whitespace (EAN/UPC) */
+#define EMBED_VECTOR_FONT 0x08000 /* Embed font in vector output - currently only for SVG output */
+#define BARCODE_MEMORY_FILE 0x10000 /* Write output to in-memory buffer `memfile` instead of to `outfile` */
/* Input data types (`symbol->input_mode`) */
#define DATA_MODE 0 /* Binary */
diff --git a/backend_qt/backend_qt.pro b/backend_qt/backend_qt.pro
index bba1e6e7..c6578491 100644
--- a/backend_qt/backend_qt.pro
+++ b/backend_qt/backend_qt.pro
@@ -42,6 +42,7 @@ HEADERS += ../backend/aztec.h \
../backend/gb18030.h \
../backend/gb2312.h \
../backend/gbk.h \
+ ../backend/filemem.h \
../backend/general_field.h \
../backend/gridmtx.h \
../backend/gs1.h \
@@ -86,6 +87,7 @@ SOURCES += ../backend/2of5.c \
../backend/dotcode.c \
../backend/eci.c \
../backend/emf.c \
+ ../backend/filemem.c \
../backend/general_field.c \
../backend/gif.c \
../backend/gridmtx.c \
diff --git a/backend_qt/backend_vc8.pro b/backend_qt/backend_vc8.pro
index 7a13213a..36180d04 100644
--- a/backend_qt/backend_vc8.pro
+++ b/backend_qt/backend_vc8.pro
@@ -33,6 +33,7 @@ HEADERS += ../backend/aztec.h \
../backend/gb18030.h \
../backend/gb2312.h \
../backend/gbk.h \
+ ../backend/filemem.h \
../backend/general_field.h \
../backend/gridmtx.h \
../backend/gs1.h \
@@ -70,6 +71,7 @@ SOURCES += ../backend/2of5.c \
../backend/eci.c \
../backend/emf.c \
../backend/gridmtx.c \
+ ../backend/filemem.c \
../backend/general_field.c \
../backend/gif.c \
../backend/gs1.c \
diff --git a/backend_tcl/configure b/backend_tcl/configure
index 4d3251ea..752ed65c 100755
--- a/backend_tcl/configure
+++ b/backend_tcl/configure
@@ -5361,6 +5361,7 @@ printf "%s\n" "$ac_cv_c_bigendian" >&6; }
../backend/dotcode.c
../backend/eci.c
../backend/emf.c
+ ../backend/filemem.c
../backend/general_field.c
../backend/gif.c
../backend/gridmtx.c
diff --git a/backend_tcl/configure.ac b/backend_tcl/configure.ac
index e66a46d0..cb973b94 100644
--- a/backend_tcl/configure.ac
+++ b/backend_tcl/configure.ac
@@ -90,6 +90,7 @@ TEA_ADD_SOURCES([
../backend/dotcode.c
../backend/eci.c
../backend/emf.c
+ ../backend/filemem.c
../backend/general_field.c
../backend/gif.c
../backend/gridmtx.c
diff --git a/backend_tcl/zint_tcl.dsp b/backend_tcl/zint_tcl.dsp
index 7addf506..89b99d93 100644
--- a/backend_tcl/zint_tcl.dsp
+++ b/backend_tcl/zint_tcl.dsp
@@ -161,6 +161,10 @@ SOURCE=..\backend\emf.c
# End Source File
# Begin Source File
+SOURCE=..\backend\filemem.c
+# End Source File
+# Begin Source File
+
SOURCE=..\backend\general_field.c
# End Source File
# Begin Source File
diff --git a/docs/manual.html b/docs/manual.html
index d6aa0fa8..8f369c9b 100644
--- a/docs/manual.html
+++ b/docs/manual.html
@@ -464,27 +464,30 @@ Memory (raster)</a></li>
<li><a href="#buffering-symbols-in-memory-vector"
id="toc-buffering-symbols-in-memory-vector">5.5 Buffering Symbols in
Memory (vector)</a></li>
-<li><a href="#setting-options" id="toc-setting-options">5.6 Setting
+<li><a href="#buffering-symbols-in-memory-memfile"
+id="toc-buffering-symbols-in-memory-memfile">5.6 Buffering Symbols in
+Memory (memfile)</a></li>
+<li><a href="#setting-options" id="toc-setting-options">5.7 Setting
Options</a></li>
-<li><a href="#handling-errors" id="toc-handling-errors">5.7 Handling
+<li><a href="#handling-errors" id="toc-handling-errors">5.8 Handling
Errors</a></li>
<li><a href="#specifying-a-symbology"
-id="toc-specifying-a-symbology">5.8 Specifying a Symbology</a></li>
+id="toc-specifying-a-symbology">5.9 Specifying a Symbology</a></li>
<li><a href="#adjusting-output-options"
-id="toc-adjusting-output-options">5.9 Adjusting Output Options</a></li>
+id="toc-adjusting-output-options">5.10 Adjusting Output Options</a></li>
<li><a href="#setting-the-input-mode"
-id="toc-setting-the-input-mode">5.10 Setting the Input Mode</a></li>
-<li><a href="#multiple-segments-1" id="toc-multiple-segments-1">5.11
+id="toc-setting-the-input-mode">5.11 Setting the Input Mode</a></li>
+<li><a href="#multiple-segments-1" id="toc-multiple-segments-1">5.12
Multiple Segments</a></li>
-<li><a href="#scaling-helpers" id="toc-scaling-helpers">5.12 Scaling
+<li><a href="#scaling-helpers" id="toc-scaling-helpers">5.13 Scaling
Helpers</a></li>
<li><a href="#verifying-symbology-availability"
-id="toc-verifying-symbology-availability">5.13 Verifying Symbology
+id="toc-verifying-symbology-availability">5.14 Verifying Symbology
Availability</a></li>
<li><a href="#checking-symbology-capabilities"
-id="toc-checking-symbology-capabilities">5.14 Checking Symbology
+id="toc-checking-symbology-capabilities">5.15 Checking Symbology
Capabilities</a></li>
-<li><a href="#zint-version" id="toc-zint-version">5.15 Zint
+<li><a href="#zint-version" id="toc-zint-version">5.16 Zint
Version</a></li>
</ul></li>
<li><a href="#types-of-symbology" id="toc-types-of-symbology">6. Types
@@ -2197,7 +2200,7 @@ alt="zint -d "This Text" --fg=00FF0055" />
<figcaption
aria-hidden="true"><code>zint -d "This Text" --fg=00FF0055</code></figcaption>
</figure>
-<p>will produce a semi-transparent green foreground with standard
+<p>will produce a semi-transparent green foreground with a standard
(white) background. Note that transparency is treated differently by
raster and vector (SVG) output formats, as for vector output the
background will “shine through” a transparent foreground. For
@@ -3138,7 +3141,7 @@ example:</p>
<p>Note that when using the API, the input data is assumed to be 8-bit
binary unless the <code>input_mode</code> member of the
<code>zint_symbol</code> structure is set - see <a
-href="#setting-the-input-mode">5.10 Setting the Input Mode</a> for
+href="#setting-the-input-mode">5.11 Setting the Input Mode</a> for
details.</p>
<h2 id="encoding-and-printing-functions-in-depth">5.3 Encoding and
Printing Functions in Depth</h2>
@@ -3293,14 +3296,43 @@ available:</p>
<span id="cb63-22"><a href="#cb63-22" aria-hidden="true" tabindex="-1"></a><span class="cf">for</span> <span class="op">(</span>circle <span class="op">=</span> my_symbol<span class="op">-></span>vector<span class="op">-></span>circles<span class="op">;</span> circle<span class="op">;</span> circle <span class="op">=</span> circle<span class="op">-></span>next<span class="op">)</span> <span class="op">{</span></span>
<span id="cb63-23"><a href="#cb63-23" aria-hidden="true" tabindex="-1"></a> draw_circle<span class="op">(</span>circle<span class="op">-></span>x<span class="op">,</span> circle<span class="op">-></span>y<span class="op">,</span> circle<span class="op">-></span>diameter<span class="op">,</span> circle<span class="op">-></span>width<span class="op">);</span></span>
<span id="cb63-24"><a href="#cb63-24" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
-<h2 id="setting-options">5.6 Setting Options</h2>
+<h2 id="buffering-symbols-in-memory-memfile">5.6 Buffering Symbols in
+Memory (memfile)</h2>
+<p>Symbols can also be stored as “in-memory” file buffers by giving the
+<code>BARCODE_MEMORY_FILE</code> option to the
+<code>output_options</code> member, which saves the print output to
+member <code>memfile</code> instead of to the output file
+<code>outfile</code>. The length of the buffer is given in
+<code>memfile_size</code>. For instance:</p>
+<div class="sourceCode" id="cb64"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb64-1"><a href="#cb64-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
+<span id="cb64-2"><a href="#cb64-2" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><stdio.h></span></span>
+<span id="cb64-3"><a href="#cb64-3" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><string.h></span></span>
+<span id="cb64-4"><a href="#cb64-4" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
+<span id="cb64-5"><a href="#cb64-5" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
+<span id="cb64-6"><a href="#cb64-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
+<span id="cb64-7"><a href="#cb64-7" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
+<span id="cb64-8"><a href="#cb64-8" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>output_options <span class="op">|=</span> BARCODE_MEMORY_FILE<span class="op">;</span></span>
+<span id="cb64-9"><a href="#cb64-9" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Only the extension is used, to determine output format */</span></span>
+<span id="cb64-10"><a href="#cb64-10" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>outfile<span class="op">,</span> <span class="st">"mem.svg"</span><span class="op">);</span></span>
+<span id="cb64-11"><a href="#cb64-11" aria-hidden="true" tabindex="-1"></a> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> argv<span class="op">[</span><span class="dv">1</span><span class="op">],</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb64-12"><a href="#cb64-12" aria-hidden="true" tabindex="-1"></a> <span class="co">/* `my_symbol->memfile` now contains the SVG output */</span></span>
+<span id="cb64-13"><a href="#cb64-13" aria-hidden="true" tabindex="-1"></a> fwrite<span class="op">(</span>my_symbol<span class="op">-></span>memfile<span class="op">,</span> <span class="dv">1</span><span class="op">,</span> my_symbol<span class="op">-></span>memfile_size<span class="op">,</span> stdout<span class="op">);</span></span>
+<span id="cb64-14"><a href="#cb64-14" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
+<span id="cb64-15"><a href="#cb64-15" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
+<span id="cb64-16"><a href="#cb64-16" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<p>will print the SVG output to <code>stdout</code> (the file “mem.svg”
+is not created). This is particularly useful for the textual formats EPS
+and SVG,<a href="#fn7" class="footnote-ref" id="fnref7"
+role="doc-noteref"><sup>7</sup></a> allowing the output to be
+manipulated and processed by the client.</p>
+<h2 id="setting-options">5.7 Setting Options</h2>
<p>So far our application is not very useful unless we plan to only make
Code 128 symbols and we don’t mind that they only save to
-<code>"out.png"</code>. As with the CLI program, of course, these
-options can be altered. The way this is done is by altering the contents
-of the <code>zint_symbol</code> structure between the creation and
-encoding stages. The <code>zint_symbol</code> structure consists of the
-following members:</p>
+<code>"out.png"</code> (or to memory, as above). As with the CLI
+program, of course, these options can be altered. The way this is done
+is by altering the contents of the <code>zint_symbol</code> structure
+between the creation and encoding stages. The <code>zint_symbol</code>
+structure consists of the following members:</p>
<div id="tbl:api_structure_zint_symbol" class="tablenos">
<table id="tbl:api_structure_zint_symbol" data-tag="$ $">
<caption><span>Table <span class="math inline"> </span>:</span> API
@@ -3324,15 +3356,15 @@ Structure <code>zint_symbol</code> </caption>
<td style="text-align: left;"><code>symbology</code></td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">Symbol to use - see <a
-href="#specifying-a-symbology">5.8 Specifying a Symbology</a>.</td>
+href="#specifying-a-symbology">5.9 Specifying a Symbology</a>.</td>
<td style="text-align: left;"><code>BARCODE_CODE128</code></td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>height</code></td>
<td style="text-align: left;">float</td>
<td style="text-align: left;">Symbol height in X-dimensions, excluding
-fixed width-to-height symbols.<a href="#fn7" class="footnote-ref"
-id="fnref7" role="doc-noteref"><sup>7</sup></a></td>
+fixed width-to-height symbols.<a href="#fn8" class="footnote-ref"
+id="fnref8" role="doc-noteref"><sup>8</sup></a></td>
<td style="text-align: left;">Symbol dependent</td>
</tr>
<tr class="odd">
@@ -3366,7 +3398,7 @@ X-dimensions.</td>
<td style="text-align: left;"><code>output_options</code></td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">Set various output parameters - see <a
-href="#adjusting-output-options">5.9 Adjusting Output Options</a>.</td>
+href="#adjusting-output-options">5.10 Adjusting Output Options</a>.</td>
<td style="text-align: left;">0 (none)</td>
</tr>
<tr class="even">
@@ -3407,8 +3439,8 @@ resulting barcode symbol to. Must end in <code>.png</code>,
<code>.gif</code>, <code>.bmp</code>, <code>.emf</code>,
<code>.eps</code>, <code>.pcx</code>, <code>.svg</code>,
<code>.tif</code> or <code>.txt</code> followed by a terminating
-<code>NUL</code>.<a href="#fn8" class="footnote-ref" id="fnref8"
-role="doc-noteref"><sup>8</sup></a></td>
+<code>NUL</code>.<a href="#fn9" class="footnote-ref" id="fnref9"
+role="doc-noteref"><sup>9</sup></a></td>
<td style="text-align: left;"><code>"out.png"</code></td>
</tr>
<tr class="odd">
@@ -3447,7 +3479,7 @@ symbols, with a terminating <code>NUL</code>.</td>
<td style="text-align: left;"><code>input_mode</code></td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">Set encoding of input data - see <a
-href="#setting-the-input-mode">5.10 Setting the Input Mode</a>.</td>
+href="#setting-the-input-mode">5.11 Setting the Input Mode</a>.</td>
<td style="text-align: left;"><code>DATA_MODE</code></td>
</tr>
<tr class="odd">
@@ -3501,7 +3533,7 @@ symbols.</td>
<td style="text-align: left;"><code>warn_level</code></td>
<td style="text-align: left;">integer</td>
<td style="text-align: left;">Affects error/warning value returned by
-Zint API - see <a href="#handling-errors">5.7 Handling Errors</a>.</td>
+Zint API - see <a href="#handling-errors">5.8 Handling Errors</a>.</td>
<td style="text-align: left;"><code>WARN_DEFAULT</code></td>
</tr>
<tr class="odd">
@@ -3541,7 +3573,7 @@ with a terminating <code>NUL</code>.</td>
<td style="text-align: left;">character string</td>
<td style="text-align: left;">Error message in the event that an error
occurred, with a terminating <code>NUL</code> - see <a
-href="#handling-errors">5.7 Handling Errors</a>.</td>
+href="#handling-errors">5.8 Handling Errors</a>.</td>
<td style="text-align: left;">(output only)</td>
</tr>
<tr class="odd">
@@ -3583,31 +3615,46 @@ href="#buffering-symbols-in-memory-vector">5.5 Buffering Symbols in
Memory (vector)</a>.</td>
<td style="text-align: left;">(output only)</td>
</tr>
+<tr class="even">
+<td style="text-align: left;"><code>memfile</code></td>
+<td style="text-align: left;">pointer to unsigned character array</td>
+<td style="text-align: left;">Pointer to in-memory file buffer if
+<code>BARCODE_MEMORY_FILE</code> set in <code>output_options</code> -
+see <a href="#buffering-symbols-in-memory-memfile">5.6 Buffering Symbols
+in Memory (memfile)</a>.</td>
+<td style="text-align: left;">(output only)</td>
+</tr>
+<tr class="odd">
+<td style="text-align: left;"><code>memfile_size</code></td>
+<td style="text-align: left;">integer</td>
+<td style="text-align: left;">Length of in-memory file buffer.</td>
+<td style="text-align: left;">(output only)</td>
+</tr>
</tbody>
</table>
</div>
<p>To alter these values use the syntax shown in the example below. This
code has the same result as the previous example except the output is
now taller and plotted in green.</p>
-<div class="sourceCode" id="cb64"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb64-1"><a href="#cb64-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
-<span id="cb64-2"><a href="#cb64-2" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><string.h></span></span>
-<span id="cb64-3"><a href="#cb64-3" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
-<span id="cb64-4"><a href="#cb64-4" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
-<span id="cb64-5"><a href="#cb64-5" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
-<span id="cb64-6"><a href="#cb64-6" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
-<span id="cb64-7"><a href="#cb64-7" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>fgcolour<span class="op">,</span> <span class="st">"00ff00"</span><span class="op">);</span></span>
-<span id="cb64-8"><a href="#cb64-8" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>height <span class="op">=</span> <span class="fl">400.0</span><span class="bu">f</span><span class="op">;</span></span>
-<span id="cb64-9"><a href="#cb64-9" aria-hidden="true" tabindex="-1"></a> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> argv<span class="op">[</span><span class="dv">1</span><span class="op">],</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb64-10"><a href="#cb64-10" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
-<span id="cb64-11"><a href="#cb64-11" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
-<span id="cb64-12"><a href="#cb64-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<div class="sourceCode" id="cb65"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb65-1"><a href="#cb65-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
+<span id="cb65-2"><a href="#cb65-2" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><string.h></span></span>
+<span id="cb65-3"><a href="#cb65-3" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
+<span id="cb65-4"><a href="#cb65-4" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
+<span id="cb65-5"><a href="#cb65-5" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
+<span id="cb65-6"><a href="#cb65-6" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
+<span id="cb65-7"><a href="#cb65-7" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>fgcolour<span class="op">,</span> <span class="st">"00ff00"</span><span class="op">);</span></span>
+<span id="cb65-8"><a href="#cb65-8" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>height <span class="op">=</span> <span class="fl">400.0</span><span class="bu">f</span><span class="op">;</span></span>
+<span id="cb65-9"><a href="#cb65-9" aria-hidden="true" tabindex="-1"></a> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> argv<span class="op">[</span><span class="dv">1</span><span class="op">],</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb65-10"><a href="#cb65-10" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
+<span id="cb65-11"><a href="#cb65-11" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
+<span id="cb65-12"><a href="#cb65-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>Note that background removal for all outputs except BMP can be
achieved by setting the background alpha to <code>"00"</code> where the
values for R, G and B will be ignored:</p>
-<div class="sourceCode" id="cb65"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb65-1"><a href="#cb65-1" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>bgcolour<span class="op">,</span> <span class="st">"55555500"</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb66"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb66-1"><a href="#cb66-1" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>bgcolour<span class="op">,</span> <span class="st">"55555500"</span><span class="op">);</span></span></code></pre></div>
<p>This is what the CLI option <code>--nobackground</code> does - see <a
href="#using-colour">4.7 Using Colour</a>.</p>
-<h2 id="handling-errors">5.7 Handling Errors</h2>
+<h2 id="handling-errors">5.8 Handling Errors</h2>
<p>If errors occur during encoding a non-zero integer value is passed
back to the calling application. In addition the <code>errtxt</code>
member is set to a message detailing the nature of the error. The errors
@@ -3726,47 +3773,47 @@ occurs.</td>
</div>
<p>To catch errors use an integer variable as shown in the code
below:</p>
-<div class="sourceCode" id="cb66"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb66-1"><a href="#cb66-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
-<span id="cb66-2"><a href="#cb66-2" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><stdio.h></span></span>
-<span id="cb66-3"><a href="#cb66-3" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><string.h></span></span>
-<span id="cb66-4"><a href="#cb66-4" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
-<span id="cb66-5"><a href="#cb66-5" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
-<span id="cb66-6"><a href="#cb66-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
-<span id="cb66-7"><a href="#cb66-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> error<span class="op">;</span></span>
-<span id="cb66-8"><a href="#cb66-8" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
-<span id="cb66-9"><a href="#cb66-9" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Set invalid foreground colour */</span></span>
-<span id="cb66-10"><a href="#cb66-10" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>fgcolour<span class="op">,</span> <span class="st">"nonsense"</span><span class="op">);</span></span>
-<span id="cb66-11"><a href="#cb66-11" aria-hidden="true" tabindex="-1"></a> error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> argv<span class="op">[</span><span class="dv">1</span><span class="op">],</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb66-12"><a href="#cb66-12" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="op">(</span>error <span class="op">!=</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
-<span id="cb66-13"><a href="#cb66-13" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Some warning or error occurred */</span></span>
-<span id="cb66-14"><a href="#cb66-14" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"</span><span class="sc">%s\n</span><span class="st">"</span><span class="op">,</span> my_symbol<span class="op">-></span>errtxt<span class="op">);</span></span>
-<span id="cb66-15"><a href="#cb66-15" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="op">(</span>error <span class="op">>=</span> ZINT_ERROR<span class="op">)</span> <span class="op">{</span></span>
-<span id="cb66-16"><a href="#cb66-16" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Stop now */</span></span>
-<span id="cb66-17"><a href="#cb66-17" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
-<span id="cb66-18"><a href="#cb66-18" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">1</span><span class="op">;</span></span>
-<span id="cb66-19"><a href="#cb66-19" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span>
-<span id="cb66-20"><a href="#cb66-20" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span>
-<span id="cb66-21"><a href="#cb66-21" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Otherwise carry on with the rest of the application */</span></span>
-<span id="cb66-22"><a href="#cb66-22" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
-<span id="cb66-23"><a href="#cb66-23" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
-<span id="cb66-24"><a href="#cb66-24" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<div class="sourceCode" id="cb67"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb67-1"><a href="#cb67-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
+<span id="cb67-2"><a href="#cb67-2" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><stdio.h></span></span>
+<span id="cb67-3"><a href="#cb67-3" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><string.h></span></span>
+<span id="cb67-4"><a href="#cb67-4" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
+<span id="cb67-5"><a href="#cb67-5" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
+<span id="cb67-6"><a href="#cb67-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
+<span id="cb67-7"><a href="#cb67-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> error<span class="op">;</span></span>
+<span id="cb67-8"><a href="#cb67-8" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
+<span id="cb67-9"><a href="#cb67-9" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Set invalid foreground colour */</span></span>
+<span id="cb67-10"><a href="#cb67-10" aria-hidden="true" tabindex="-1"></a> strcpy<span class="op">(</span>my_symbol<span class="op">-></span>fgcolour<span class="op">,</span> <span class="st">"nonsense"</span><span class="op">);</span></span>
+<span id="cb67-11"><a href="#cb67-11" aria-hidden="true" tabindex="-1"></a> error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> argv<span class="op">[</span><span class="dv">1</span><span class="op">],</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb67-12"><a href="#cb67-12" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="op">(</span>error <span class="op">!=</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
+<span id="cb67-13"><a href="#cb67-13" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Some warning or error occurred */</span></span>
+<span id="cb67-14"><a href="#cb67-14" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"</span><span class="sc">%s\n</span><span class="st">"</span><span class="op">,</span> my_symbol<span class="op">-></span>errtxt<span class="op">);</span></span>
+<span id="cb67-15"><a href="#cb67-15" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="op">(</span>error <span class="op">>=</span> ZINT_ERROR<span class="op">)</span> <span class="op">{</span></span>
+<span id="cb67-16"><a href="#cb67-16" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Stop now */</span></span>
+<span id="cb67-17"><a href="#cb67-17" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
+<span id="cb67-18"><a href="#cb67-18" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">1</span><span class="op">;</span></span>
+<span id="cb67-19"><a href="#cb67-19" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span>
+<span id="cb67-20"><a href="#cb67-20" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span>
+<span id="cb67-21"><a href="#cb67-21" aria-hidden="true" tabindex="-1"></a> <span class="co">/* Otherwise carry on with the rest of the application */</span></span>
+<span id="cb67-22"><a href="#cb67-22" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
+<span id="cb67-23"><a href="#cb67-23" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
+<span id="cb67-24"><a href="#cb67-24" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>This code will exit with the appropriate message:</p>
<pre><code>Error 881: Malformed foreground RGB colour 'nonsense' (hexadecimal only)</code></pre>
<p>To treat all warnings as errors, set
<code>symbol->warn_level</code> to <code>WARN_FAIL_ALL</code>.</p>
-<h2 id="specifying-a-symbology">5.8 Specifying a Symbology</h2>
+<h2 id="specifying-a-symbology">5.9 Specifying a Symbology</h2>
<p>Symbologies can be specified by number or by name as shown in the
Table <a href="#tbl:barcode_types">: Barcode Types (Symbologies)</a>.
For example</p>
-<div class="sourceCode" id="cb68"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb68-1"><a href="#cb68-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_LOGMARS<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb69"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb69-1"><a href="#cb69-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_LOGMARS<span class="op">;</span></span></code></pre></div>
<p>means the same as</p>
-<div class="sourceCode" id="cb69"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb69-1"><a href="#cb69-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>symbology <span class="op">=</span> <span class="dv">50</span><span class="op">;</span></span></code></pre></div>
-<h2 id="adjusting-output-options">5.9 Adjusting Output Options</h2>
+<div class="sourceCode" id="cb70"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb70-1"><a href="#cb70-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>symbology <span class="op">=</span> <span class="dv">50</span><span class="op">;</span></span></code></pre></div>
+<h2 id="adjusting-output-options">5.10 Adjusting Output Options</h2>
<p>The <code>output_options</code> member can be used to adjust various
aspects of the output file. To select more than one option from the
table below simply <code>OR</code> them together when adjusting this
value:</p>
-<div class="sourceCode" id="cb70"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb70-1"><a href="#cb70-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>output_options <span class="op">|=</span> BARCODE_BIND <span class="op">|</span> READER_INIT<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb71"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb71-1"><a href="#cb71-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>output_options <span class="op">|=</span> BARCODE_BIND <span class="op">|</span> READER_INIT<span class="op">;</span></span></code></pre></div>
<div id="tbl:api_output_options" class="tablenos">
<table id="tbl:api_output_options" data-tag="$ $">
<caption><span>Table <span class="math inline"> </span>:</span> API
@@ -3789,15 +3836,15 @@ value:</p>
<tr class="even">
<td style="text-align: left;"><code>BARCODE_BIND_TOP</code></td>
<td style="text-align: left;">Boundary bar above the symbol only.<a
-href="#fn9" class="footnote-ref" id="fnref9"
-role="doc-noteref"><sup>9</sup></a></td>
+href="#fn10" class="footnote-ref" id="fnref10"
+role="doc-noteref"><sup>10</sup></a></td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>BARCODE_BIND</code></td>
<td style="text-align: left;">Boundary bars above and below the symbol
-and between rows if stacking multiple symbols.<a href="#fn10"
-class="footnote-ref" id="fnref10"
-role="doc-noteref"><sup>10</sup></a></td>
+and between rows if stacking multiple symbols.<a href="#fn11"
+class="footnote-ref" id="fnref11"
+role="doc-noteref"><sup>11</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>BARCODE_BOX</code></td>
@@ -3847,8 +3894,8 @@ Memory (raster)</a>.</td>
<tr class="odd">
<td style="text-align: left;"><code>BARCODE_QUIET_ZONES</code></td>
<td style="text-align: left;">Add compliant quiet zones (additional to
-any specified whitespace).<a href="#fn11" class="footnote-ref"
-id="fnref11" role="doc-noteref"><sup>11</sup></a></td>
+any specified whitespace).<a href="#fn12" class="footnote-ref"
+id="fnref12" role="doc-noteref"><sup>12</sup></a></td>
</tr>
<tr class="even">
<td style="text-align: left;"><code>BARCODE_NO_QUIET_ZONES</code></td>
@@ -3870,10 +3917,16 @@ use standard height (if any) as default.</td>
<td style="text-align: left;">Embed font in vector output - currently
available for SVG output only.</td>
</tr>
+<tr class="even">
+<td style="text-align: left;"><code>BARCODE_MEMORY_FILE</code></td>
+<td style="text-align: left;">Write output to in-memory buffer
+<code>symbol->memfile</code> instead of to <code>outfile</code>
+file.</td>
+</tr>
</tbody>
</table>
</div>
-<h2 id="setting-the-input-mode">5.10 Setting the Input Mode</h2>
+<h2 id="setting-the-input-mode">5.11 Setting the Input Mode</h2>
<p>The way in which the input data is encoded can be set using the
<code>input_mode</code> member. Valid values are shown in the table
below.</p>
@@ -3958,11 +4011,11 @@ from the default for the CLI and GUI, which is
<code>GS1NOCHECK_MODE</code>, <code>HEIGHTPERROW_MODE</code>,
<code>FAST_MODE</code> and <code>EXTRA_ESCAPE_MODE</code> are optional.
So, for example, you can set</p>
-<div class="sourceCode" id="cb71"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb71-1"><a href="#cb71-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> UNICODE_MODE <span class="op">|</span> ESCAPE_MODE<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb72"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb72-1"><a href="#cb72-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> UNICODE_MODE <span class="op">|</span> ESCAPE_MODE<span class="op">;</span></span></code></pre></div>
<p>or</p>
-<div class="sourceCode" id="cb72"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb72-1"><a href="#cb72-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> GS1_MODE <span class="op">|</span> GS1PARENS_MODE <span class="op">|</span> GS1NOCHECK_MODE<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb73"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb73-1"><a href="#cb73-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> GS1_MODE <span class="op">|</span> GS1PARENS_MODE <span class="op">|</span> GS1NOCHECK_MODE<span class="op">;</span></span></code></pre></div>
<p>whereas</p>
-<div class="sourceCode" id="cb73"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb73-1"><a href="#cb73-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> DATA_MODE <span class="op">|</span> GS1_MODE<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb74"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb74-1"><a href="#cb74-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>input_mode <span class="op">=</span> DATA_MODE <span class="op">|</span> GS1_MODE<span class="op">;</span></span></code></pre></div>
<p>is not valid.</p>
<p>Permissible escape sequences (<code>ESCAPE_MODE</code>) are listed in
Table <a href="#tbl:escape_sequences">: Escape Sequences</a>, and the
@@ -3983,20 +4036,20 @@ input (it will be set to the overall height on output).</p>
used for Data Matrix, MicroPDF417 and PDF417. For QR Code and UPNQR, it
affects Zint’s automatic mask selection - see <a
href="#qr-code-iso-18004">6.6.3 QR Code (ISO 18004)</a> for details.</p>
-<h2 id="multiple-segments-1">5.11 Multiple Segments</h2>
+<h2 id="multiple-segments-1">5.12 Multiple Segments</h2>
<p>For input data requiring multiple ECIs, the following functions may
be used:</p>
-<div class="sourceCode" id="cb74"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb74-1"><a href="#cb74-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
-<span id="cb74-2"><a href="#cb74-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">);</span></span>
-<span id="cb74-3"><a href="#cb74-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb74-4"><a href="#cb74-4" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Print<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
-<span id="cb74-5"><a href="#cb74-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span>
-<span id="cb74-6"><a href="#cb74-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb74-7"><a href="#cb74-7" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Buffer<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
-<span id="cb74-8"><a href="#cb74-8" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span>
-<span id="cb74-9"><a href="#cb74-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb74-10"><a href="#cb74-10" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Buffer_Vector<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
-<span id="cb74-11"><a href="#cb74-11" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb75"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb75-1"><a href="#cb75-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
+<span id="cb75-2"><a href="#cb75-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">);</span></span>
+<span id="cb75-3"><a href="#cb75-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb75-4"><a href="#cb75-4" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Print<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
+<span id="cb75-5"><a href="#cb75-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span>
+<span id="cb75-6"><a href="#cb75-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb75-7"><a href="#cb75-7" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Buffer<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
+<span id="cb75-8"><a href="#cb75-8" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span>
+<span id="cb75-9"><a href="#cb75-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb75-10"><a href="#cb75-10" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Encode_Segs_and_Buffer_Vector<span class="op">(</span><span class="kw">struct</span> zint_symbol <span class="op">*</span>symbol<span class="op">,</span></span>
+<span id="cb75-11"><a href="#cb75-11" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="kw">struct</span> zint_seg segs<span class="op">[],</span> <span class="dt">const</span> <span class="dt">int</span> seg_count<span class="op">,</span> <span class="dt">int</span> rotate_angle<span class="op">);</span></span></code></pre></div>
<p>These are direct analogues of the previously mentioned
<code>ZBarcode_Encode()</code>,
<code>ZBarcode_Encode_and_Print()</code>,
@@ -4007,44 +4060,44 @@ consisting of <code>"segs, seg_count"</code> is given, with
<code>segs</code> being an array of <code>struct zint_seg</code>
segments and <code>seg_count</code> being the number of elements it
contains. The zint_seg structure is of the form:</p>
-<div class="sourceCode" id="cb75"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb75-1"><a href="#cb75-1" aria-hidden="true" tabindex="-1"></a><span class="kw">struct</span> zint_seg <span class="op">{</span></span>
-<span id="cb75-2"><a href="#cb75-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">unsigned</span> <span class="dt">char</span> <span class="op">*</span>source<span class="op">;</span> <span class="co">/* Data to encode */</span></span>
-<span id="cb75-3"><a href="#cb75-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> length<span class="op">;</span> <span class="co">/* Length of `source`. If 0, `source` must be</span></span>
-<span id="cb75-4"><a href="#cb75-4" aria-hidden="true" tabindex="-1"></a><span class="co"> NUL-terminated */</span></span>
-<span id="cb75-5"><a href="#cb75-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> eci<span class="op">;</span> <span class="co">/* Extended Channel Interpretation */</span></span>
-<span id="cb75-6"><a href="#cb75-6" aria-hidden="true" tabindex="-1"></a><span class="op">};</span></span></code></pre></div>
+<div class="sourceCode" id="cb76"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb76-1"><a href="#cb76-1" aria-hidden="true" tabindex="-1"></a><span class="kw">struct</span> zint_seg <span class="op">{</span></span>
+<span id="cb76-2"><a href="#cb76-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">unsigned</span> <span class="dt">char</span> <span class="op">*</span>source<span class="op">;</span> <span class="co">/* Data to encode */</span></span>
+<span id="cb76-3"><a href="#cb76-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> length<span class="op">;</span> <span class="co">/* Length of `source`. If 0, `source` must be</span></span>
+<span id="cb76-4"><a href="#cb76-4" aria-hidden="true" tabindex="-1"></a><span class="co"> NUL-terminated */</span></span>
+<span id="cb76-5"><a href="#cb76-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">int</span> eci<span class="op">;</span> <span class="co">/* Extended Channel Interpretation */</span></span>
+<span id="cb76-6"><a href="#cb76-6" aria-hidden="true" tabindex="-1"></a><span class="op">};</span></span></code></pre></div>
<p>The symbology must support ECIs (see Table <a
href="#tbl:eci_aware_symbologies">: ECI-Aware Symbologies</a>). For
example:</p>
-<div class="sourceCode" id="cb76"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb76-1"><a href="#cb76-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
-<span id="cb76-2"><a href="#cb76-2" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
-<span id="cb76-3"><a href="#cb76-3" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
-<span id="cb76-4"><a href="#cb76-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_seg segs<span class="op">[]</span> <span class="op">=</span> <span class="op">{</span></span>
-<span id="cb76-5"><a href="#cb76-5" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"Κείμενο"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">9</span> <span class="op">},</span></span>
-<span id="cb76-6"><a href="#cb76-6" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"Текст"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">7</span> <span class="op">},</span></span>
-<span id="cb76-7"><a href="#cb76-7" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"文章"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">20</span> <span class="op">}</span></span>
-<span id="cb76-8"><a href="#cb76-8" aria-hidden="true" tabindex="-1"></a> <span class="op">};</span></span>
-<span id="cb76-9"><a href="#cb76-9" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
-<span id="cb76-10"><a href="#cb76-10" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
-<span id="cb76-11"><a href="#cb76-11" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_AZTEC<span class="op">;</span></span>
-<span id="cb76-12"><a href="#cb76-12" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>input_mode <span class="op">=</span> UNICODE_MODE<span class="op">;</span></span>
-<span id="cb76-13"><a href="#cb76-13" aria-hidden="true" tabindex="-1"></a> ZBarcode_Encode_Segs<span class="op">(</span>my_symbol<span class="op">,</span> segs<span class="op">,</span> <span class="dv">3</span><span class="op">);</span></span>
-<span id="cb76-14"><a href="#cb76-14" aria-hidden="true" tabindex="-1"></a> ZBarcode_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb76-15"><a href="#cb76-15" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
-<span id="cb76-16"><a href="#cb76-16" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
-<span id="cb76-17"><a href="#cb76-17" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<div class="sourceCode" id="cb77"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb77-1"><a href="#cb77-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#include </span><span class="im"><zint.h></span></span>
+<span id="cb77-2"><a href="#cb77-2" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> main<span class="op">(</span><span class="dt">int</span> argc<span class="op">,</span> <span class="dt">char</span> <span class="op">**</span>argv<span class="op">)</span></span>
+<span id="cb77-3"><a href="#cb77-3" aria-hidden="true" tabindex="-1"></a><span class="op">{</span></span>
+<span id="cb77-4"><a href="#cb77-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_seg segs<span class="op">[]</span> <span class="op">=</span> <span class="op">{</span></span>
+<span id="cb77-5"><a href="#cb77-5" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"Κείμενο"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">9</span> <span class="op">},</span></span>
+<span id="cb77-6"><a href="#cb77-6" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"Текст"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">7</span> <span class="op">},</span></span>
+<span id="cb77-7"><a href="#cb77-7" aria-hidden="true" tabindex="-1"></a> <span class="op">{</span> <span class="st">"文章"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">20</span> <span class="op">}</span></span>
+<span id="cb77-8"><a href="#cb77-8" aria-hidden="true" tabindex="-1"></a> <span class="op">};</span></span>
+<span id="cb77-9"><a href="#cb77-9" aria-hidden="true" tabindex="-1"></a> <span class="kw">struct</span> zint_symbol <span class="op">*</span>my_symbol<span class="op">;</span></span>
+<span id="cb77-10"><a href="#cb77-10" aria-hidden="true" tabindex="-1"></a> my_symbol <span class="op">=</span> ZBarcode_Create<span class="op">();</span></span>
+<span id="cb77-11"><a href="#cb77-11" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_AZTEC<span class="op">;</span></span>
+<span id="cb77-12"><a href="#cb77-12" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>input_mode <span class="op">=</span> UNICODE_MODE<span class="op">;</span></span>
+<span id="cb77-13"><a href="#cb77-13" aria-hidden="true" tabindex="-1"></a> ZBarcode_Encode_Segs<span class="op">(</span>my_symbol<span class="op">,</span> segs<span class="op">,</span> <span class="dv">3</span><span class="op">);</span></span>
+<span id="cb77-14"><a href="#cb77-14" aria-hidden="true" tabindex="-1"></a> ZBarcode_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb77-15"><a href="#cb77-15" aria-hidden="true" tabindex="-1"></a> ZBarcode_Delete<span class="op">(</span>my_symbol<span class="op">);</span></span>
+<span id="cb77-16"><a href="#cb77-16" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">0</span><span class="op">;</span></span>
+<span id="cb77-17"><a href="#cb77-17" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>A maximum of 256 segments may be specified. Use of multiple segments
with GS1 data is not currently supported.</p>
-<h2 id="scaling-helpers">5.12 Scaling Helpers</h2>
+<h2 id="scaling-helpers">5.13 Scaling Helpers</h2>
<p>To help with scaling the output, the following three function are
available:</p>
-<div class="sourceCode" id="cb77"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb77-1"><a href="#cb77-1" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_Default_Xdim<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">);</span></span>
-<span id="cb77-2"><a href="#cb77-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb77-3"><a href="#cb77-3" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_Scale_From_XdimDp<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">float</span> x_dim_mm<span class="op">,</span> <span class="dt">float</span> dpmm<span class="op">,</span></span>
-<span id="cb77-4"><a href="#cb77-4" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="dt">char</span> <span class="op">*</span>filetype<span class="op">)</span> <span class="op">{</span></span>
-<span id="cb77-5"><a href="#cb77-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb77-6"><a href="#cb77-6" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_XdimDP_From_Scale<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">float</span> scale<span class="op">,</span></span>
-<span id="cb77-7"><a href="#cb77-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">float</span> x_dim_mm_or_dpmm<span class="op">,</span> <span class="dt">const</span> <span class="dt">char</span> <span class="op">*</span>filetype<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb78"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb78-1"><a href="#cb78-1" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_Default_Xdim<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">);</span></span>
+<span id="cb78-2"><a href="#cb78-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb78-3"><a href="#cb78-3" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_Scale_From_XdimDp<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">float</span> x_dim_mm<span class="op">,</span> <span class="dt">float</span> dpmm<span class="op">,</span></span>
+<span id="cb78-4"><a href="#cb78-4" aria-hidden="true" tabindex="-1"></a> <span class="dt">const</span> <span class="dt">char</span> <span class="op">*</span>filetype<span class="op">)</span> <span class="op">{</span></span>
+<span id="cb78-5"><a href="#cb78-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb78-6"><a href="#cb78-6" aria-hidden="true" tabindex="-1"></a><span class="dt">float</span> ZBarcode_XdimDP_From_Scale<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">float</span> scale<span class="op">,</span></span>
+<span id="cb78-7"><a href="#cb78-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">float</span> x_dim_mm_or_dpmm<span class="op">,</span> <span class="dt">const</span> <span class="dt">char</span> <span class="op">*</span>filetype<span class="op">);</span></span></code></pre></div>
<p>The first <code>ZBarcode_Default_Xdim()</code> returns the default
X-dimension suggested by Zint for symbology <code>symbol_id</code>.</p>
<p>The second <code>ZBarcode_Scale_From_XdimDp()</code> returns the
@@ -4056,13 +4109,13 @@ however <code>dpmm</code> may be zero and defaults to 12 dpmm, and
is assumed. For raster output (BMP/GIF/PCX/PNG/TIF) the scale is rounded
to half-integer increments.</p>
<p>For example:</p>
-<div class="sourceCode" id="cb78"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb78-1"><a href="#cb78-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Royal Mail 4-State Customer Code */</span></span>
-<span id="cb78-2"><a href="#cb78-2" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_RM4SCC<span class="op">;</span></span>
-<span id="cb78-3"><a href="#cb78-3" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>dpmm <span class="op">=</span> <span class="fl">600.0</span><span class="bu">f</span> <span class="op">/</span> <span class="fl">25.4</span><span class="bu">f</span><span class="op">;</span> <span class="co">/* 600 dpi */</span></span>
-<span id="cb78-4"><a href="#cb78-4" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>scale <span class="op">=</span> ZBarcode_Scale_From_XdimDp<span class="op">(</span></span>
-<span id="cb78-5"><a href="#cb78-5" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>symbology<span class="op">,</span></span>
-<span id="cb78-6"><a href="#cb78-6" aria-hidden="true" tabindex="-1"></a> ZBarcode_Default_Xdim<span class="op">(</span>my_symbol<span class="op">-></span>symbology<span class="op">),</span></span>
-<span id="cb78-7"><a href="#cb78-7" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>dpmm<span class="op">,</span> <span class="st">"PNG"</span><span class="op">);</span> <span class="co">/* Returns 7.5 */</span></span></code></pre></div>
+<div class="sourceCode" id="cb79"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb79-1"><a href="#cb79-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Royal Mail 4-State Customer Code */</span></span>
+<span id="cb79-2"><a href="#cb79-2" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_RM4SCC<span class="op">;</span></span>
+<span id="cb79-3"><a href="#cb79-3" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>dpmm <span class="op">=</span> <span class="fl">600.0</span><span class="bu">f</span> <span class="op">/</span> <span class="fl">25.4</span><span class="bu">f</span><span class="op">;</span> <span class="co">/* 600 dpi */</span></span>
+<span id="cb79-4"><a href="#cb79-4" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>scale <span class="op">=</span> ZBarcode_Scale_From_XdimDp<span class="op">(</span></span>
+<span id="cb79-5"><a href="#cb79-5" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>symbology<span class="op">,</span></span>
+<span id="cb79-6"><a href="#cb79-6" aria-hidden="true" tabindex="-1"></a> ZBarcode_Default_Xdim<span class="op">(</span>my_symbol<span class="op">-></span>symbology<span class="op">),</span></span>
+<span id="cb79-7"><a href="#cb79-7" aria-hidden="true" tabindex="-1"></a> my_symbol<span class="op">-></span>dpmm<span class="op">,</span> <span class="st">"PNG"</span><span class="op">);</span> <span class="co">/* Returns 7.5 */</span></span></code></pre></div>
<p>The third function <code>ZBarcode_XdimDP_From_Scale()</code> is the
“reverse” of <code>ZBarcode_Scale_From_XdimDp()</code>, returning the
X-dimension (in mm) or the dot density (in dpmm) given a scale
@@ -4074,33 +4127,33 @@ bound to the maximum value of dpmm (1000), so must be further bound to
not only due to the symbology, resolution and filetype but also due to
the type of scanner used, the intended scanning distance, and what media
(“substrates”) the barcode appears on.</p>
-<h2 id="verifying-symbology-availability">5.13 Verifying Symbology
+<h2 id="verifying-symbology-availability">5.14 Verifying Symbology
Availability</h2>
<p>An additional function available in the API is:</p>
-<div class="sourceCode" id="cb79"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb79-1"><a href="#cb79-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_ValidID<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb80"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb80-1"><a href="#cb80-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_ValidID<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">);</span></span></code></pre></div>
<p>which allows you to check whether a given symbology is available,
returning a non-zero value if so. For example:</p>
-<div class="sourceCode" id="cb80"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb80-1"><a href="#cb80-1" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>ZBarcode_ValidID<span class="op">(</span>BARCODE_PDF417<span class="op">)</span> <span class="op">!=</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
-<span id="cb80-2"><a href="#cb80-2" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 available</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb80-3"><a href="#cb80-3" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
-<span id="cb80-4"><a href="#cb80-4" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 not available</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb80-5"><a href="#cb80-5" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<div class="sourceCode" id="cb81"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb81-1"><a href="#cb81-1" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>ZBarcode_ValidID<span class="op">(</span>BARCODE_PDF417<span class="op">)</span> <span class="op">!=</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
+<span id="cb81-2"><a href="#cb81-2" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 available</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb81-3"><a href="#cb81-3" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
+<span id="cb81-4"><a href="#cb81-4" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 not available</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb81-5"><a href="#cb81-5" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>Another function that may be useful is:</p>
-<div class="sourceCode" id="cb81"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb81-1"><a href="#cb81-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_BarcodeName<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">char</span> name<span class="op">[</span><span class="dv">32</span><span class="op">]);</span></span></code></pre></div>
+<div class="sourceCode" id="cb82"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb82-1"><a href="#cb82-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_BarcodeName<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">char</span> name<span class="op">[</span><span class="dv">32</span><span class="op">]);</span></span></code></pre></div>
<p>which copies the name of a symbology into the supplied
<code>name</code> buffer, which should be 32 characters in length. The
name is <code>NUL</code>-terminated, and zero is returned on success.
For instance:</p>
-<div class="sourceCode" id="cb82"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb82-1"><a href="#cb82-1" aria-hidden="true" tabindex="-1"></a><span class="dt">char</span> name<span class="op">[</span><span class="dv">32</span><span class="op">];</span></span>
-<span id="cb82-2"><a href="#cb82-2" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>ZBarcode_BarcodeName<span class="op">(</span>BARCODE_PDF417<span class="op">,</span> name<span class="op">)</span> <span class="op">==</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
-<span id="cb82-3"><a href="#cb82-3" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"</span><span class="sc">%s\n</span><span class="st">"</span><span class="op">,</span> name<span class="op">);</span></span>
-<span id="cb82-4"><a href="#cb82-4" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<div class="sourceCode" id="cb83"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb83-1"><a href="#cb83-1" aria-hidden="true" tabindex="-1"></a><span class="dt">char</span> name<span class="op">[</span><span class="dv">32</span><span class="op">];</span></span>
+<span id="cb83-2"><a href="#cb83-2" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>ZBarcode_BarcodeName<span class="op">(</span>BARCODE_PDF417<span class="op">,</span> name<span class="op">)</span> <span class="op">==</span> <span class="dv">0</span><span class="op">)</span> <span class="op">{</span></span>
+<span id="cb83-3"><a href="#cb83-3" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"</span><span class="sc">%s\n</span><span class="st">"</span><span class="op">,</span> name<span class="op">);</span></span>
+<span id="cb83-4"><a href="#cb83-4" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>will print <code>BARCODE_PDF417</code>.</p>
-<h2 id="checking-symbology-capabilities">5.14 Checking Symbology
+<h2 id="checking-symbology-capabilities">5.15 Checking Symbology
Capabilities</h2>
<p>It can be useful for frontend programs to know the capabilities of a
symbology. This can be determined using another additional function:</p>
-<div class="sourceCode" id="cb83"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb83-1"><a href="#cb83-1" aria-hidden="true" tabindex="-1"></a><span class="dt">unsigned</span> <span class="dt">int</span> ZBarcode_Cap<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">unsigned</span> <span class="dt">int</span> cap_flag<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb84"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb84-1"><a href="#cb84-1" aria-hidden="true" tabindex="-1"></a><span class="dt">unsigned</span> <span class="dt">int</span> ZBarcode_Cap<span class="op">(</span><span class="dt">int</span> symbol_id<span class="op">,</span> <span class="dt">unsigned</span> <span class="dt">int</span> cap_flag<span class="op">);</span></span></code></pre></div>
<p>by <code>OR</code>-ing the flags below in the <code>cap_flag</code>
argument and checking the return to see which are set.</p>
<div id="tbl:api_cap" class="tablenos">
@@ -4128,8 +4181,8 @@ Text?</td>
</tr>
<tr class="odd">
<td style="text-align: left;"><code>ZINT_CAP_EANUPC</code><a
-href="#fn12" class="footnote-ref" id="fnref12"
-role="doc-noteref"><sup>12</sup></a></td>
+href="#fn13" class="footnote-ref" id="fnref13"
+role="doc-noteref"><sup>13</sup></a></td>
<td style="text-align: left;">Is the symbology EAN/UPC?</td>
</tr>
<tr class="even">
@@ -4191,25 +4244,25 @@ defined?</td>
</table>
</div>
<p>For example:</p>
-<div class="sourceCode" id="cb84"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb84-1"><a href="#cb84-1" aria-hidden="true" tabindex="-1"></a><span class="dt">unsigned</span> <span class="dt">int</span> cap<span class="op">;</span></span>
-<span id="cb84-2"><a href="#cb84-2" aria-hidden="true" tabindex="-1"></a>cap <span class="op">=</span> ZBarcode_Cap<span class="op">(</span>BARCODE_PDF417<span class="op">,</span> ZINT_CAP_HRT <span class="op">|</span> ZINT_CAP_ECI<span class="op">);</span></span>
-<span id="cb84-3"><a href="#cb84-3" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>cap <span class="op">&</span> ZINT_CAP_HRT<span class="op">)</span> <span class="op">{</span></span>
-<span id="cb84-4"><a href="#cb84-4" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 supports HRT</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb84-5"><a href="#cb84-5" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
-<span id="cb84-6"><a href="#cb84-6" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 does not support HRT</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb84-7"><a href="#cb84-7" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span>
-<span id="cb84-8"><a href="#cb84-8" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>cap <span class="op">&</span> ZINT_CAP_ECI<span class="op">)</span> <span class="op">{</span></span>
-<span id="cb84-9"><a href="#cb84-9" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 supports ECI</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb84-10"><a href="#cb84-10" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
-<span id="cb84-11"><a href="#cb84-11" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 does not support ECI</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
-<span id="cb84-12"><a href="#cb84-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
-<h2 id="zint-version">5.15 Zint Version</h2>
+<div class="sourceCode" id="cb85"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb85-1"><a href="#cb85-1" aria-hidden="true" tabindex="-1"></a><span class="dt">unsigned</span> <span class="dt">int</span> cap<span class="op">;</span></span>
+<span id="cb85-2"><a href="#cb85-2" aria-hidden="true" tabindex="-1"></a>cap <span class="op">=</span> ZBarcode_Cap<span class="op">(</span>BARCODE_PDF417<span class="op">,</span> ZINT_CAP_HRT <span class="op">|</span> ZINT_CAP_ECI<span class="op">);</span></span>
+<span id="cb85-3"><a href="#cb85-3" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>cap <span class="op">&</span> ZINT_CAP_HRT<span class="op">)</span> <span class="op">{</span></span>
+<span id="cb85-4"><a href="#cb85-4" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 supports HRT</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb85-5"><a href="#cb85-5" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
+<span id="cb85-6"><a href="#cb85-6" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 does not support HRT</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb85-7"><a href="#cb85-7" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span>
+<span id="cb85-8"><a href="#cb85-8" aria-hidden="true" tabindex="-1"></a><span class="cf">if</span> <span class="op">(</span>cap <span class="op">&</span> ZINT_CAP_ECI<span class="op">)</span> <span class="op">{</span></span>
+<span id="cb85-9"><a href="#cb85-9" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 supports ECI</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb85-10"><a href="#cb85-10" aria-hidden="true" tabindex="-1"></a><span class="op">}</span> <span class="cf">else</span> <span class="op">{</span></span>
+<span id="cb85-11"><a href="#cb85-11" aria-hidden="true" tabindex="-1"></a> printf<span class="op">(</span><span class="st">"PDF417 does not support ECI</span><span class="sc">\n</span><span class="st">"</span><span class="op">);</span></span>
+<span id="cb85-12"><a href="#cb85-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
+<h2 id="zint-version">5.16 Zint Version</h2>
<p>Whether the Zint library linked to was built with PNG support may be
determined with:</p>
-<div class="sourceCode" id="cb85"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb85-1"><a href="#cb85-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_NoPng<span class="op">();</span></span></code></pre></div>
+<div class="sourceCode" id="cb86"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb86-1"><a href="#cb86-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_NoPng<span class="op">();</span></span></code></pre></div>
<p>which returns 1 if no PNG support is available, else zero.</p>
<p>Lastly, the version of the Zint library linked to is returned by:</p>
-<div class="sourceCode" id="cb86"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb86-1"><a href="#cb86-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Version<span class="op">();</span></span></code></pre></div>
+<div class="sourceCode" id="cb87"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb87-1"><a href="#cb87-1" aria-hidden="true" tabindex="-1"></a><span class="dt">int</span> ZBarcode_Version<span class="op">();</span></span></code></pre></div>
<p>The version parts are separated by hundreds. For instance, version
<code>"2.9.1"</code> is returned as <code>"20901"</code>.</p>
<h1 id="types-of-symbology">6. Types of Symbology</h1>
@@ -4357,12 +4410,12 @@ calculated by Zint. In addition EAN-2 and EAN-5 add-on symbols can be
added using the + character. For example, to draw a UPC-A symbol with
the data 72527270270 with an EAN-5 add-on showing the data 12345 use the
command:</p>
-<div class="sourceCode" id="cb87"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb87-1"><a href="#cb87-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCA <span class="at">-d</span> <span class="st">"72527270270+12345"</span></span></code></pre></div>
+<div class="sourceCode" id="cb88"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb88-1"><a href="#cb88-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCA <span class="at">-d</span> <span class="st">"72527270270+12345"</span></span></code></pre></div>
<p>or using the API encode a data string with the + character
included:</p>
-<div class="sourceCode" id="cb88"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb88-1"><a href="#cb88-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCA<span class="op">;</span></span>
-<span id="cb88-2"><a href="#cb88-2" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"72527270270+12345"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb89"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb89-1"><a href="#cb89-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCA<span class="op">;</span></span>
+<span id="cb89-2"><a href="#cb89-2" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"72527270270+12345"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
<figure>
<img src="images/upca_5.svg" title="fig:" class="upcean"
alt="zint -b UPCA --compliantheight -d "72527270270+12345"" />
@@ -4376,12 +4429,12 @@ input and validates the check digit before encoding.</p>
<code>--guardwhitespace</code> (API
<code>output_options |= EANUPC_GUARD_WHITESPACE</code>). For UPC, this
is only relevant when there is add-on:</p>
-<div class="sourceCode" id="cb89"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb89-1"><a href="#cb89-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCA <span class="at">-d</span> <span class="st">"72527270270+12345"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
+<div class="sourceCode" id="cb90"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb90-1"><a href="#cb90-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCA <span class="at">-d</span> <span class="st">"72527270270+12345"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
<p>or using the API:</p>
-<div class="sourceCode" id="cb90"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb90-1"><a href="#cb90-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCA<span class="op">;</span></span>
-<span id="cb90-2"><a href="#cb90-2" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>output_options <span class="op">|=</span> EANUPC_GUARD_WHITESPACE<span class="op">;</span></span>
-<span id="cb90-3"><a href="#cb90-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"72527270270+12345"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb91"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb91-1"><a href="#cb91-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCA<span class="op">;</span></span>
+<span id="cb91-2"><a href="#cb91-2" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>output_options <span class="op">|=</span> EANUPC_GUARD_WHITESPACE<span class="op">;</span></span>
+<span id="cb91-3"><a href="#cb91-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"72527270270+12345"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
<figure>
<img src="images/upca_5_gws.svg" title="fig:" class="upcean"
alt="zint -b UPCA --compliantheight -d "72527270270+12345" --guardwhitespace" />
@@ -4407,19 +4460,19 @@ check digit is calculated by Zint. EAN-2 and EAN-5 add-on symbols can be
added using the + character as with UPC-A. In addition Zint also
supports Number System 1 encoding by entering a 7-digit article number
starting with the digit 1. For example:</p>
-<div class="sourceCode" id="cb91"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb91-1"><a href="#cb91-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCE <span class="at">-d</span> <span class="st">"1123456"</span></span></code></pre></div>
+<div class="sourceCode" id="cb92"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb92-1"><a href="#cb92-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCE <span class="at">-d</span> <span class="st">"1123456"</span></span></code></pre></div>
<p>or</p>
-<div class="sourceCode" id="cb92"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb92-1"><a href="#cb92-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCE<span class="op">;</span></span>
-<span id="cb92-2"><a href="#cb92-2" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"1123456"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb93"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb93-1"><a href="#cb93-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_UPCE<span class="op">;</span></span>
+<span id="cb93-2"><a href="#cb93-2" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"1123456"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
<p>If your input data already includes the check digit symbology
<code>BARCODE_UPCE_CHK</code> (38) can be used which takes a 7 or
8-digit input and validates the check digit before encoding.</p>
<p>As with UPC-A, a quiet zone indicator can be added when there is an
add-on by setting <code>--guardwhitespace</code> (API
<code>output_options |= EANUPC_GUARD_WHITESPACE</code>):</p>
-<div class="sourceCode" id="cb93"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb93-1"><a href="#cb93-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCE <span class="at">-d</span> <span class="st">"1123456+12"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
+<div class="sourceCode" id="cb94"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb94-1"><a href="#cb94-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> UPCE <span class="at">-d</span> <span class="st">"1123456+12"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
<figure>
<img src="images/upce_2_gws.svg" title="fig:" class="upcean"
alt="zint -b UPCE --compliantheight -d "1123456+12" --guardwhitespace" />
@@ -4448,8 +4501,8 @@ numbers respectively. Zint will decide which symbology to use depending
on the length of the input data. In addition EAN-2 and EAN-5 add-on
symbols can be added to EAN-8 and EAN-13 symbols using the + character
as with UPC symbols. For example:</p>
-<div class="sourceCode" id="cb94"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb94-1"><a href="#cb94-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">-d</span> <span class="st">"54321"</span></span></code></pre></div>
+<div class="sourceCode" id="cb95"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb95-1"><a href="#cb95-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">-d</span> <span class="st">"54321"</span></span></code></pre></div>
<figure>
<img src="images/eanx5.svg" title="fig:" class="upcean"
alt="zint -b EANX --compliantheight -d "54321"" />
@@ -4457,15 +4510,15 @@ alt="zint -b EANX --compliantheight -d "54321"" />
aria-hidden="true"><code>zint -b EANX --compliantheight -d "54321"</code></figcaption>
</figure>
<p>will encode a stand-alone EAN-5, whereas</p>
-<div class="sourceCode" id="cb95"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb95-1"><a href="#cb95-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">-d</span> <span class="st">"7432365+54321"</span></span></code></pre></div>
+<div class="sourceCode" id="cb96"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb96-1"><a href="#cb96-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">-d</span> <span class="st">"7432365+54321"</span></span></code></pre></div>
<p>will encode an EAN-8 symbol with an EAN-5 add-on. As before these
results can be achieved using the API:</p>
-<div class="sourceCode" id="cb96"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb96-1"><a href="#cb96-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_EANX<span class="op">;</span></span>
-<span id="cb96-2"><a href="#cb96-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb96-3"><a href="#cb96-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"54321"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb96-4"><a href="#cb96-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb96-5"><a href="#cb96-5" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"7432365+54321"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb97"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb97-1"><a href="#cb97-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_EANX<span class="op">;</span></span>
+<span id="cb97-2"><a href="#cb97-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb97-3"><a href="#cb97-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"54321"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb97-4"><a href="#cb97-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb97-5"><a href="#cb97-5" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"7432365+54321"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
<figure>
<img src="images/eanx8_5.svg" title="fig:" class="upcean"
alt="zint -b EANX --compliantheight -d "7432365+54321"" />
@@ -4481,8 +4534,8 @@ and validates the check digit before encoding.</p>
<p>Options to add quiet zone indicators and to adjust the add-on gap and
the guard bar descent height are the same as for <a
href="#upc-version-e">6.1.3.2 UPC Version E</a>. For instance:</p>
-<div class="sourceCode" id="cb97"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb97-1"><a href="#cb97-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX_CHK <span class="at">-d</span> <span class="st">"74323654"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
+<div class="sourceCode" id="cb98"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb98-1"><a href="#cb98-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX_CHK <span class="at">-d</span> <span class="st">"74323654"</span> <span class="at">--guardwhitespace</span></span></code></pre></div>
<figure>
<img src="images/eanx8_gws.svg" title="fig:" class="upcean"
alt="zint -b EANX_CHK --compliantheight -d "74323654" –guardwhitespace" />
@@ -4765,15 +4818,15 @@ digit.</p>
escapes <code>\^A</code>, <code>\^B</code>, <code>\^C</code>. For
instance the following will force switching to Code Set B for the data
<code>"5678"</code> (normally Code Set C would be used throughout):</p>
-<div class="sourceCode" id="cb98"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb98-1"><a href="#cb98-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> CODE128 <span class="at">-d</span> <span class="st">"1234\^B5678"</span> <span class="at">--extraesc</span></span></code></pre></div>
+<div class="sourceCode" id="cb99"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb99-1"><a href="#cb99-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> CODE128 <span class="at">-d</span> <span class="st">"1234\^B5678"</span> <span class="at">--extraesc</span></span></code></pre></div>
<p>The manually selected Code Set will apply until the next Code Set
escape sequence, with the exception that data that cannot be represented
in that Code Set will be switched as appropriate. If the data contains a
special code sequence, it can be escaped by doubling the caret
(<code>^</code>). For instance</p>
-<div class="sourceCode" id="cb99"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb99-1"><a href="#cb99-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> CODE128 <span class="at">-d</span> <span class="st">"\^AABC\^^BDEF"</span> <span class="at">--extraesc</span></span></code></pre></div>
+<div class="sourceCode" id="cb100"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb100-1"><a href="#cb100-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> CODE128 <span class="at">-d</span> <span class="st">"\^AABC\^^BDEF"</span> <span class="at">--extraesc</span></span></code></pre></div>
<p>will encode the data <code>"ABC\^BDEF"</code> in Code Set A.</p>
<p>Code 128 is the default barcode symbology used by Zint. In addition
Zint supports the encoding of ISO/IEC 8859-1 (non-English) characters in
@@ -4792,8 +4845,8 @@ aria-hidden="true"><code>zint -b CODE128AB -d "130170X178"</code></figcaption>
</figure>
<p>It is sometimes advantageous to stop Code 128 from using Code Set C
which compresses numerical data. The <code>BARCODE_CODE128AB</code><a
-href="#fn13" class="footnote-ref" id="fnref13"
-role="doc-noteref"><sup>13</sup></a> variant (symbology 60) suppresses
+href="#fn14" class="footnote-ref" id="fnref14"
+role="doc-noteref"><sup>14</sup></a> variant (symbology 60) suppresses
Code Set C in favour of Code Sets A and B.</p>
<p>Note that the special escapes to manually switch Code Sets mentioned
above are not available for this variant (nor for any other).</p>
@@ -4819,11 +4872,11 @@ correct encoding. GS1-128 does not support extended ASCII (ISO/IEC
8859-1) characters. Check digits for GTIN data AI (01) are not generated
and need to be included in the input data. The following is an example
of a valid GS1-128 input:</p>
-<div class="sourceCode" id="cb100"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb100-1"><a href="#cb100-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 16 <span class="at">-d</span> <span class="st">"[01]98898765432106[3202]012345[15]991231"</span></span></code></pre></div>
-<p>or using the <code>--gs1parens</code> option:</p>
<div class="sourceCode" id="cb101"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb101-1"><a href="#cb101-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 16 <span class="at">--gs1parens</span> <span class="at">-d</span> <span class="st">"(01)98898765432106(3202)012345(15)991231"</span></span></code></pre></div>
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb101-1"><a href="#cb101-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 16 <span class="at">-d</span> <span class="st">"[01]98898765432106[3202]012345[15]991231"</span></span></code></pre></div>
+<p>or using the <code>--gs1parens</code> option:</p>
+<div class="sourceCode" id="cb102"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb102-1"><a href="#cb102-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 16 <span class="at">--gs1parens</span> <span class="at">-d</span> <span class="st">"(01)98898765432106(3202)012345(15)991231"</span></span></code></pre></div>
<h4 id="ean-14">6.1.10.4 EAN-14</h4>
<figure>
<img src="images/ean14.svg" title="fig:" class="lin"
@@ -4994,8 +5047,8 @@ href="#gs1-128">6.1.10.3 GS1-128</a>.</p>
not calculated by Zint when this symbology is encoded. Fixed length data
should be entered at the appropriate length for correct encoding. The
following is an example of a valid GS1 DataBar Expanded input:</p>
-<div class="sourceCode" id="cb102"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb102-1"><a href="#cb102-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 31 <span class="at">-d</span> <span class="st">"[01]98898765432106[3202]012345[15]991231"</span></span></code></pre></div>
+<div class="sourceCode" id="cb103"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb103-1"><a href="#cb103-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 31 <span class="at">-d</span> <span class="st">"[01]98898765432106[3202]012345[15]991231"</span></span></code></pre></div>
<h3 id="korea-post-barcode">6.1.12 Korea Post Barcode</h3>
<figure>
<img src="images/koreapost.svg" title="fig:" class="lin"
@@ -5084,20 +5137,20 @@ position. Lowercase input is automatically made uppercase.</p>
primarily in the vehicle industry, is to simply stack one-dimensional
codes on top of each other. This can be achieved at the command prompt
by giving more than one set of input data. For example</p>
-<div class="sourceCode" id="cb103"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb103-1"><a href="#cb103-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-d</span> <span class="st">"This"</span> <span class="at">-d</span> <span class="st">"That"</span></span></code></pre></div>
+<div class="sourceCode" id="cb104"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb104-1"><a href="#cb104-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-d</span> <span class="st">"This"</span> <span class="at">-d</span> <span class="st">"That"</span></span></code></pre></div>
<p>will draw two Code 128 symbols, one on top of the other. The same
result can be achieved using the API by executing the
<code>ZBarcode_Encode()</code> function more than once on a symbol. For
example:</p>
-<div class="sourceCode" id="cb104"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb104-1"><a href="#cb104-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_CODE128<span class="op">;</span></span>
-<span id="cb104-2"><a href="#cb104-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb104-3"><a href="#cb104-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"This"</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb104-4"><a href="#cb104-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb104-5"><a href="#cb104-5" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"That"</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
-<span id="cb104-6"><a href="#cb104-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb104-7"><a href="#cb104-7" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Print<span class="op">(</span>my_symbol<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb105"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb105-1"><a href="#cb105-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_CODE128<span class="op">;</span></span>
+<span id="cb105-2"><a href="#cb105-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb105-3"><a href="#cb105-3" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"This"</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb105-4"><a href="#cb105-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb105-5"><a href="#cb105-5" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Encode<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"That"</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span>
+<span id="cb105-6"><a href="#cb105-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb105-7"><a href="#cb105-7" aria-hidden="true" tabindex="-1"></a>error <span class="op">=</span> ZBarcode_Print<span class="op">(</span>my_symbol<span class="op">);</span></span></code></pre></div>
<figure>
<img src="images/code128_stacked.svg" title="fig:" class="lin"
alt="zint -d "This" -d "That"" />
@@ -5113,8 +5166,8 @@ specifying <code>--bind</code> (API
separator bars in integral multiples of the X-dimension (minimum and
default 1, maximum 4) can be set by <code>--separator</code> (API
<code>option_3</code>):</p>
-<div class="sourceCode" id="cb105"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb105-1"><a href="#cb105-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">--bind</span> <span class="at">--notext</span> <span class="at">--separator</span><span class="op">=</span>2 <span class="at">-d</span> <span class="st">"This"</span> <span class="at">-d</span> <span class="st">"That"</span></span></code></pre></div>
+<div class="sourceCode" id="cb106"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb106-1"><a href="#cb106-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">--bind</span> <span class="at">--notext</span> <span class="at">--separator</span><span class="op">=</span>2 <span class="at">-d</span> <span class="st">"This"</span> <span class="at">-d</span> <span class="st">"That"</span></span></code></pre></div>
<figure>
<img src="images/code128_stacked_sep2.svg" title="fig:" class="lin"
alt="zint --notext --bind --separator=2 -d "This" -d "That"" />
@@ -5389,21 +5442,21 @@ should be entered into a primary string with the data for the 2D
component being entered in the normal way. To do this at the command
prompt use the <code>--primary</code> switch (API <code>primary</code>).
For example:</p>
-<div class="sourceCode" id="cb106"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb106-1"><a href="#cb106-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX_CC <span class="at">--mode</span><span class="op">=</span>1 <span class="at">--primary</span><span class="op">=</span>331234567890 <span class="at">-d</span> <span class="st">"[99]1234-abcd"</span></span></code></pre></div>
+<div class="sourceCode" id="cb107"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb107-1"><a href="#cb107-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX_CC <span class="at">--mode</span><span class="op">=</span>1 <span class="at">--primary</span><span class="op">=</span>331234567890 <span class="at">-d</span> <span class="st">"[99]1234-abcd"</span></span></code></pre></div>
<p>This creates an EAN-13 linear component with the data
<code>"331234567890"</code> and a 2D CC-A (see <a
href="#cc-a">below</a>) component with the data
<code>"(99)1234-abcd"</code>. The same results can be achieved using the
API as shown below:</p>
-<div class="sourceCode" id="cb107"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb107-1"><a href="#cb107-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_EANX_CC<span class="op">;</span></span>
-<span id="cb107-2"><a href="#cb107-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb107-3"><a href="#cb107-3" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>option_1 <span class="op">=</span> <span class="dv">1</span><span class="op">;</span></span>
-<span id="cb107-4"><a href="#cb107-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb107-5"><a href="#cb107-5" aria-hidden="true" tabindex="-1"></a>strcpy<span class="op">(</span>my_symbol<span class="op">-></span>primary<span class="op">,</span> <span class="st">"331234567890"</span><span class="op">);</span></span>
-<span id="cb107-6"><a href="#cb107-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb107-7"><a href="#cb107-7" aria-hidden="true" tabindex="-1"></a>ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"[99]1234-abcd"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb108"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb108-1"><a href="#cb108-1" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>symbology <span class="op">=</span> BARCODE_EANX_CC<span class="op">;</span></span>
+<span id="cb108-2"><a href="#cb108-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb108-3"><a href="#cb108-3" aria-hidden="true" tabindex="-1"></a>my_symbol<span class="op">-></span>option_1 <span class="op">=</span> <span class="dv">1</span><span class="op">;</span></span>
+<span id="cb108-4"><a href="#cb108-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb108-5"><a href="#cb108-5" aria-hidden="true" tabindex="-1"></a>strcpy<span class="op">(</span>my_symbol<span class="op">-></span>primary<span class="op">,</span> <span class="st">"331234567890"</span><span class="op">);</span></span>
+<span id="cb108-6"><a href="#cb108-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb108-7"><a href="#cb108-7" aria-hidden="true" tabindex="-1"></a>ZBarcode_Encode_and_Print<span class="op">(</span>my_symbol<span class="op">,</span> <span class="st">"[99]1234-abcd"</span><span class="op">,</span> <span class="dv">0</span><span class="op">,</span> <span class="dv">0</span><span class="op">);</span></span></code></pre></div>
<p>EAN-2 and EAN-5 add-on data can be used with EAN and UPC symbols
using the + symbol as described in sections <a
href="#upc-universal-product-code-iso-15420">6.1.3 UPC (Universal
@@ -5763,13 +5816,13 @@ size to full height can be given in thousandths (permille) using the
<code>--vers</code> option (API <code>option_2</code>). The default
value is 250 (25%).</p>
<p>For example the following</p>
-<div class="sourceCode" id="cb108"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb108-1"><a href="#cb108-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> DAFT <span class="at">-d</span> AAFDTTDAFADTFTTFFFDATFTADTTFFTDAFAFDTF <span class="at">--height</span><span class="op">=</span>8.494 <span class="at">--vers</span><span class="op">=</span>256</span></code></pre></div>
+<div class="sourceCode" id="cb109"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb109-1"><a href="#cb109-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> DAFT <span class="at">-d</span> AAFDTTDAFADTFTTFFFDATFTADTTFFTDAFAFDTF <span class="at">--height</span><span class="op">=</span>8.494 <span class="at">--vers</span><span class="op">=</span>256</span></code></pre></div>
<p>produces the same barcode (see <a
href="#royal-mail-4-state-customer-code-rm4scc">6.5.3 Royal Mail 4-State
Customer Code (RM4SCC)</a>) as</p>
-<div class="sourceCode" id="cb109"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb109-1"><a href="#cb109-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> RM4SCC <span class="at">--compliantheight</span> <span class="at">-d</span> <span class="st">"W1J0TR01"</span></span></code></pre></div>
+<div class="sourceCode" id="cb110"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb110-1"><a href="#cb110-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> RM4SCC <span class="at">--compliantheight</span> <span class="at">-d</span> <span class="st">"W1J0TR01"</span></span></code></pre></div>
<h2 id="matrix-symbols">6.6 Matrix Symbols</h2>
<h3 id="data-matrix-iso-16022">6.6.1 Data Matrix (ISO 16022)</h3>
<figure>
@@ -6409,8 +6462,8 @@ be manually specified by using the <code>--mask</code> switch with
values 0-7, or in the API by setting
<code>option_3 = (N + 1) << 8</code> where N is 0-7. To use with
<code>ZINT_FULL_MULTIBYTE</code> set</p>
-<div class="sourceCode" id="cb110"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb110-1"><a href="#cb110-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
+<div class="sourceCode" id="cb111"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb111-1"><a href="#cb111-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
<p>The <code>--fast</code> option (API
<code>input_mode |= FAST_MODE</code>) may be used when leaving Zint to
automatically select a mask to reduce the number of masks to try to four
@@ -6546,8 +6599,8 @@ be manually specified by using the <code>--mask</code> switch with
values 0-3, or in the API by setting
<code>option_3 = (N + 1) << 8</code> where N is 0-3. To use with
<code>ZINT_FULL_MULTIBYTE</code> set</p>
-<div class="sourceCode" id="cb111"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb111-1"><a href="#cb111-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
+<div class="sourceCode" id="cb112"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb112-1"><a href="#cb112-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
<h3 id="rectangular-micro-qr-code-rmqr-iso-23941">6.6.5 Rectangular
Micro QR Code (rMQR) (ISO 23941)</h3>
<figure>
@@ -6814,8 +6867,8 @@ Latin-2 formatted use the <code>--binary</code> switch (API
<code>input_mode = DATA MODE</code>).</p>
<p>The following example creates a symbol from data saved as a Latin-2
file:</p>
-<div class="sourceCode" id="cb112"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb112-1"><a href="#cb112-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> upnqr.png <span class="at">-b</span> 143 <span class="at">--scale</span><span class="op">=</span>3 <span class="at">--binary</span> <span class="at">-i</span> upn.txt</span></code></pre></div>
+<div class="sourceCode" id="cb113"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb113-1"><a href="#cb113-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> upnqr.png <span class="at">-b</span> 143 <span class="at">--scale</span><span class="op">=</span>3 <span class="at">--binary</span> <span class="at">-i</span> upn.txt</span></code></pre></div>
<p>A mask may be manually specified or the <code>--fast</code> option
used as with QRCODE.</p>
<h3 id="maxicode-iso-16023">6.6.7 MaxiCode (ISO 16023)</h3>
@@ -6890,9 +6943,9 @@ your parcel courier.</td>
<p>The primary message can be set at the command prompt using the
<code>--primary</code> switch (API <code>primary</code>). The secondary
message uses the normal data entry method. For example:</p>
-<div class="sourceCode" id="cb113"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb113-1"><a href="#cb113-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> test.eps <span class="at">-b</span> 57 <span class="at">--primary</span><span class="op">=</span><span class="st">"999999999840012"</span> <span class="dt">\</span></span>
-<span id="cb113-2"><a href="#cb113-2" aria-hidden="true" tabindex="-1"></a> <span class="at">-d</span> <span class="st">"Secondary Message Here"</span></span></code></pre></div>
+<div class="sourceCode" id="cb114"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb114-1"><a href="#cb114-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> test.eps <span class="at">-b</span> 57 <span class="at">--primary</span><span class="op">=</span><span class="st">"999999999840012"</span> <span class="dt">\</span></span>
+<span id="cb114-2"><a href="#cb114-2" aria-hidden="true" tabindex="-1"></a> <span class="at">-d</span> <span class="st">"Secondary Message Here"</span></span></code></pre></div>
<p>When using the API the primary message must be placed in the
<code>primary</code> string. The secondary is entered in the same way as
described in <a href="#encoding-and-saving-to-file">5.2 Encoding and
@@ -6905,9 +6958,9 @@ to be prefixed by the ISO/IEC 15434 Format <code>"01"</code>
<code>vv</code> is a 2-digit version, by using the <code>--scmvv</code>
switch (API <code>option_2 = vv + 1</code>). For example to use the
common version <code>"96"</code> (ASC MH10/SC 8):</p>
-<div class="sourceCode" id="cb114"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb114-1"><a href="#cb114-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 57 <span class="at">--primary</span><span class="op">=</span><span class="st">"152382802840001"</span> <span class="at">--scmvv</span><span class="op">=</span>96 <span class="at">--esc</span> <span class="at">-d</span> <span class="dt">\</span></span>
-<span id="cb114-2"><a href="#cb114-2" aria-hidden="true" tabindex="-1"></a> <span class="st">"1Z00004951\GUPSN\G06X610\G159\G1234567\G1/1\G\GY\G1 MAIN ST\GNY\GNY\R\E"</span></span></code></pre></div>
+<div class="sourceCode" id="cb115"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb115-1"><a href="#cb115-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 57 <span class="at">--primary</span><span class="op">=</span><span class="st">"152382802840001"</span> <span class="at">--scmvv</span><span class="op">=</span>96 <span class="at">--esc</span> <span class="at">-d</span> <span class="dt">\</span></span>
+<span id="cb115-2"><a href="#cb115-2" aria-hidden="true" tabindex="-1"></a> <span class="st">"1Z00004951\GUPSN\G06X610\G159\G1234567\G1/1\G\GY\G1 MAIN ST\GNY\GNY\R\E"</span></span></code></pre></div>
<p>will prefix <code>"[)>\R01\G96"</code> to the secondary message.
(<code>\R</code>, <code>\G</code> and <code>\E</code> are the escape
sequences for Record Separator, Group Separator and End of Transmission
@@ -6916,8 +6969,8 @@ Sequences</a>.)</p>
<p>Modes 4 to 6 can be accessed using the <code>--mode</code> switch
(API <code>option_1</code>). Modes 4 to 6 do not have a primary message.
For example:</p>
-<div class="sourceCode" id="cb115"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb115-1"><a href="#cb115-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> test.eps <span class="at">-b</span> 57 <span class="at">--mode</span><span class="op">=</span>4 <span class="at">-d</span> <span class="st">"A MaxiCode Message in Mode 4"</span></span></code></pre></div>
+<div class="sourceCode" id="cb116"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb116-1"><a href="#cb116-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-o</span> test.eps <span class="at">-b</span> 57 <span class="at">--mode</span><span class="op">=</span>4 <span class="at">-d</span> <span class="st">"A MaxiCode Message in Mode 4"</span></span></code></pre></div>
<p>Mode 6 is reserved for the maintenance of scanner hardware and should
not be used to encode user data.</p>
<p>This symbology uses Latin-1 character encoding by default but also
@@ -7842,8 +7895,8 @@ be manually specified by using the <code>--mask</code> switch with
values 0-3, or in the API by setting
<code>option_3 = (N + 1) << 8</code> where N is 0-3. To use with
<code>ZINT_FULL_MULTIBYTE</code> set</p>
-<div class="sourceCode" id="cb116"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb116-1"><a href="#cb116-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
+<div class="sourceCode" id="cb117"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb117-1"><a href="#cb117-1" aria-hidden="true" tabindex="-1"></a>option_3 <span class="op">=</span> ZINT_FULL_MULTIBYTE <span class="op">|</span> <span class="op">(</span>N <span class="op">+</span> <span class="dv">1</span><span class="op">)</span> <span class="op"><<</span> <span class="dv">8</span></span></code></pre></div>
<h3 id="ultracode">6.6.14 Ultracode</h3>
<figure>
<img src="images/ultra.svg" title="fig:" class="ultra"
@@ -7903,8 +7956,8 @@ data-tag=": Ultracode Error Correction Values">
</div>
<p>Zint does not currently implement data compression by default, but
this can be initiated through the API by setting</p>
-<div class="sourceCode" id="cb117"><pre
-class="sourceCode c"><code class="sourceCode c"><span id="cb117-1"><a href="#cb117-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>option_3 <span class="op">=</span> ULTRA_COMPRESSION<span class="op">;</span></span></code></pre></div>
+<div class="sourceCode" id="cb118"><pre
+class="sourceCode c"><code class="sourceCode c"><span id="cb118-1"><a href="#cb118-1" aria-hidden="true" tabindex="-1"></a>symbol<span class="op">-></span>option_3 <span class="op">=</span> ULTRA_COMPRESSION<span class="op">;</span></span></code></pre></div>
<p>With compression, up to 504 digits, 375 alphanumerics or 252 bytes
can be encoded.</p>
<p>Revision 2 of Ultracode (2023) may be specified using
@@ -8553,32 +8606,32 @@ Buffering Symbols in Memory (vector)</a>) provided by the Zint library
<code>libzint</code>.</p>
<p>The main class is <code>Zint::QZint</code>, which has getter/setter
properties that correspond to the <code>zint_symbol</code> structure
-(see <a href="#setting-options">5.6 Setting Options</a>), and a main
+(see <a href="#setting-options">5.7 Setting Options</a>), and a main
method <code>render()</code> which takes a Qt <code>QPainter</code> to
paint with, and a <code>QRectF</code> rectangular area specifying where
to paint into:</p>
-<div class="sourceCode" id="cb118"><pre
-class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb118-1"><a href="#cb118-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Encode and display barcode in `paintRect` using `painter`.</span></span>
-<span id="cb118-2"><a href="#cb118-2" aria-hidden="true" tabindex="-1"></a><span class="co"> Note: legacy argument `mode` is not used */</span></span>
-<span id="cb118-3"><a href="#cb118-3" aria-hidden="true" tabindex="-1"></a><span class="dt">void</span> render<span class="op">(</span><span class="ex">QPainter</span><span class="op">&</span> painter<span class="op">,</span> <span class="at">const</span> <span class="ex">QRectF</span><span class="op">&</span> paintRect<span class="op">,</span></span>
-<span id="cb118-4"><a href="#cb118-4" aria-hidden="true" tabindex="-1"></a> AspectRatioMode mode <span class="op">=</span> IgnoreAspectRatio<span class="op">);</span></span></code></pre></div>
+<div class="sourceCode" id="cb119"><pre
+class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb119-1"><a href="#cb119-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Encode and display barcode in `paintRect` using `painter`.</span></span>
+<span id="cb119-2"><a href="#cb119-2" aria-hidden="true" tabindex="-1"></a><span class="co"> Note: legacy argument `mode` is not used */</span></span>
+<span id="cb119-3"><a href="#cb119-3" aria-hidden="true" tabindex="-1"></a><span class="dt">void</span> render<span class="op">(</span><span class="ex">QPainter</span><span class="op">&</span> painter<span class="op">,</span> <span class="at">const</span> <span class="ex">QRectF</span><span class="op">&</span> paintRect<span class="op">,</span></span>
+<span id="cb119-4"><a href="#cb119-4" aria-hidden="true" tabindex="-1"></a> AspectRatioMode mode <span class="op">=</span> IgnoreAspectRatio<span class="op">);</span></span></code></pre></div>
<p><code>render()</code> will emit one of two Qt signals -
<code>encoded</code> on successful encoding and drawing, or
<code>errored</code> on failure. The client can connect and act
appropriately, for instance:</p>
-<div class="sourceCode" id="cb119"><pre
-class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb119-1"><a href="#cb119-1" aria-hidden="true" tabindex="-1"></a><span class="fu">connect</span><span class="op">(</span>qzint<span class="op">,</span> <span class="ex">SIGNAL</span><span class="op">(</span>encoded<span class="op">()),</span> <span class="ex">SLOT</span><span class="op">(</span>on_encoded<span class="op">()));</span></span>
-<span id="cb119-2"><a href="#cb119-2" aria-hidden="true" tabindex="-1"></a><span class="fu">connect</span><span class="op">(</span>qzint<span class="op">,</span> <span class="ex">SIGNAL</span><span class="op">(</span>errored<span class="op">()),</span> <span class="ex">SLOT</span><span class="op">(</span>on_errored<span class="op">()));</span></span></code></pre></div>
+<div class="sourceCode" id="cb120"><pre
+class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb120-1"><a href="#cb120-1" aria-hidden="true" tabindex="-1"></a><span class="fu">connect</span><span class="op">(</span>qzint<span class="op">,</span> <span class="ex">SIGNAL</span><span class="op">(</span>encoded<span class="op">()),</span> <span class="ex">SLOT</span><span class="op">(</span>on_encoded<span class="op">()));</span></span>
+<span id="cb120-2"><a href="#cb120-2" aria-hidden="true" tabindex="-1"></a><span class="fu">connect</span><span class="op">(</span>qzint<span class="op">,</span> <span class="ex">SIGNAL</span><span class="op">(</span>errored<span class="op">()),</span> <span class="ex">SLOT</span><span class="op">(</span>on_errored<span class="op">()));</span></span></code></pre></div>
<p>where <code>qzint</code> is an instance of <code>Zint::QZint</code>
and <code>on_encoded()</code> and <code>on_error()</code> are Qt slot
methods provided by the caller. On error, the error value and message
can be retrieved by the methods <code>getError()</code> and
<code>lastError()</code> respectively.</p>
<p>The other main method is <code>save_to_file()</code>:</p>
-<div class="sourceCode" id="cb120"><pre
-class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb120-1"><a href="#cb120-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Encode and print barcode to file `filename`.</span></span>
-<span id="cb120-2"><a href="#cb120-2" aria-hidden="true" tabindex="-1"></a><span class="co"> Only sets `getError()` on error, not on warning */</span></span>
-<span id="cb120-3"><a href="#cb120-3" aria-hidden="true" tabindex="-1"></a><span class="dt">bool</span> save_to_file<span class="op">(</span><span class="at">const</span> <span class="ex">QString</span><span class="op">&</span> filename<span class="op">);</span> <span class="co">// `ZBarcode_Print()`</span></span></code></pre></div>
+<div class="sourceCode" id="cb121"><pre
+class="sourceCode cpp"><code class="sourceCode cpp"><span id="cb121-1"><a href="#cb121-1" aria-hidden="true" tabindex="-1"></a><span class="co">/* Encode and print barcode to file `filename`.</span></span>
+<span id="cb121-2"><a href="#cb121-2" aria-hidden="true" tabindex="-1"></a><span class="co"> Only sets `getError()` on error, not on warning */</span></span>
+<span id="cb121-3"><a href="#cb121-3" aria-hidden="true" tabindex="-1"></a><span class="dt">bool</span> save_to_file<span class="op">(</span><span class="at">const</span> <span class="ex">QString</span><span class="op">&</span> filename<span class="op">);</span> <span class="co">// `ZBarcode_Print()`</span></span></code></pre></div>
<p>which takes a <code>filename</code> to output to. It too will emit an
<code>errored</code> signal on failure, returning <code>false</code>
(but nothing on success, which just returns <code>true</code>). Note
@@ -8593,33 +8646,33 @@ symbology capabilities, and utility methods such as
<h1 id="annex-c.-tcl-backend-binding">Annex C. Tcl Backend Binding</h1>
<p>A Tcl binding is available in the <code>"backend_tcl</code>”
sub-directory. To make on Unix:</p>
-<div class="sourceCode" id="cb121"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb121-1"><a href="#cb121-1" aria-hidden="true" tabindex="-1"></a><span class="bu">cd</span> backend_tcl</span>
-<span id="cb121-2"><a href="#cb121-2" aria-hidden="true" tabindex="-1"></a><span class="fu">autoconf</span></span>
-<span id="cb121-3"><a href="#cb121-3" aria-hidden="true" tabindex="-1"></a><span class="ex">./configure</span></span>
-<span id="cb121-4"><a href="#cb121-4" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span></span>
-<span id="cb121-5"><a href="#cb121-5" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> make install</span></code></pre></div>
+<div class="sourceCode" id="cb122"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb122-1"><a href="#cb122-1" aria-hidden="true" tabindex="-1"></a><span class="bu">cd</span> backend_tcl</span>
+<span id="cb122-2"><a href="#cb122-2" aria-hidden="true" tabindex="-1"></a><span class="fu">autoconf</span></span>
+<span id="cb122-3"><a href="#cb122-3" aria-hidden="true" tabindex="-1"></a><span class="ex">./configure</span></span>
+<span id="cb122-4"><a href="#cb122-4" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span></span>
+<span id="cb122-5"><a href="#cb122-5" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> make install</span></code></pre></div>
<p>For Windows, a Visual Studio 6.0 project file is available at
<code>"backend_tcl\zint_tcl.dsp"</code>. This can also be opened (and
converted) by more modern Visual Studio versions, though some fixing up
of the project configuration will likely be required.</p>
<p>Once built and installed, invoke the Tcl/Tk CLI
<code>"wish"</code>:</p>
-<div class="sourceCode" id="cb122"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb122-1"><a href="#cb122-1" aria-hidden="true" tabindex="-1"></a><span class="ex">wish</span></span></code></pre></div>
+<div class="sourceCode" id="cb123"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb123-1"><a href="#cb123-1" aria-hidden="true" tabindex="-1"></a><span class="ex">wish</span></span></code></pre></div>
<p>and ignoring the Tk window click back to the command prompt
<code>"%"</code> and type:</p>
-<div class="sourceCode" id="cb123"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb123-1"><a href="#cb123-1" aria-hidden="true" tabindex="-1"></a><span class="ex">require</span> package zint</span>
-<span id="cb123-2"><a href="#cb123-2" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> help</span></code></pre></div>
+<div class="sourceCode" id="cb124"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb124-1"><a href="#cb124-1" aria-hidden="true" tabindex="-1"></a><span class="ex">require</span> package zint</span>
+<span id="cb124-2"><a href="#cb124-2" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> help</span></code></pre></div>
<p>which will show the usage message, with options very similiar to the
Zint CLI. (One notable difference is that boolean options such as
<code>-bold</code> take a <code>1</code> or <code>0</code> as an
argument.)</p>
<p>A demonstration Tcl/Tk program which is also useful in itself is
available at <code>"backend_tcl/demo/demo.tcl"</code>. To run type:</p>
-<div class="sourceCode" id="cb124"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb124-1"><a href="#cb124-1" aria-hidden="true" tabindex="-1"></a><span class="ex">wish</span> demo/demo.tcl</span></code></pre></div>
+<div class="sourceCode" id="cb125"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb125-1"><a href="#cb125-1" aria-hidden="true" tabindex="-1"></a><span class="ex">wish</span> demo/demo.tcl</span></code></pre></div>
<p>which will display the following window.</p>
<figure>
<img src="images/tcl_demo.png" title="fig:" class="pop"
@@ -9323,17 +9376,17 @@ Error counterpart of warning if <code>--werror</code> given
<h2 id="examples">EXAMPLES</h2>
<p>Create “out.png” (or “out.gif” if zint built without PNG support) in
the current directory, as a Code 128 symbol.</p>
-<div class="sourceCode" id="cb133"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb133-1"><a href="#cb133-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-d</span> <span class="st">'This Text'</span></span></code></pre></div>
-<p>Create “qr.svg” in the current directory, as a QR Code symbol.</p>
<div class="sourceCode" id="cb134"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb134-1"><a href="#cb134-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> QRCode <span class="at">-d</span> <span class="st">'This Text'</span> <span class="at">-o</span> <span class="st">'qr.svg'</span></span></code></pre></div>
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb134-1"><a href="#cb134-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-d</span> <span class="st">'This Text'</span></span></code></pre></div>
+<p>Create “qr.svg” in the current directory, as a QR Code symbol.</p>
+<div class="sourceCode" id="cb135"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb135-1"><a href="#cb135-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> QRCode <span class="at">-d</span> <span class="st">'This Text'</span> <span class="at">-o</span> <span class="st">'qr.svg'</span></span></code></pre></div>
<p>Use batch mode to read from an input file “ean13nos.txt” containing
13-digit GTINs, to create a series of EAN-13 barcodes, formatting the
output filenames to “ean001.gif”, “ean002.gif” etc. using the special
character “~”.</p>
-<div class="sourceCode" id="cb135"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb135-1"><a href="#cb135-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">--batch</span> <span class="at">-i</span> <span class="st">'ean13nos.txt'</span> <span class="at">-o</span> <span class="st">'ean~~~.gif'</span></span></code></pre></div>
+<div class="sourceCode" id="cb136"><pre
+class="sourceCode bash"><code class="sourceCode bash"><span id="cb136-1"><a href="#cb136-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> EANX <span class="at">--batch</span> <span class="at">-i</span> <span class="st">'ean13nos.txt'</span> <span class="at">-o</span> <span class="st">'ean~~~.gif'</span></span></code></pre></div>
<h2 id="bugs">BUGS</h2>
<p>Please send bug reports to
https://sourceforge.net/p/zint/tickets/.</p>
@@ -9395,31 +9448,35 @@ characters undefined: <code>#</code>, <code>$</code>, <code>@</code>,
<code>`</code>, <code>{</code>, <code>|</code>, <code>}</code>,
<code>~</code>.<a href="#fnref6" class="footnote-back"
role="doc-backlink">↩︎</a></p></li>
-<li id="fn7"><p>The <code>height</code> value is ignored for Aztec
+<li id="fn7"><p>BARCODE_MEMORY_FILE textual formats EPS and SVG will
+have Unix newlines (LF) on both Windows and Unix, i.e. not CR+LF on
+Windows.<a href="#fnref7" class="footnote-back"
+role="doc-backlink">↩︎</a></p></li>
+<li id="fn8"><p>The <code>height</code> value is ignored for Aztec
(including HIBC and Aztec Rune), Code One, Data Matrix (including HIBC),
DotCode, Grid Matrix, Han Xin, MaxiCode, QR Code (including HIBC, Micro
QR, rMQR and UPNQR), and Ultracode - all of which have a fixed
width-to-height ratio (or, in the case of Code One, a fixed height).<a
-href="#fnref7" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
-<li id="fn8"><p>For Windows, <code>outfile</code> is assumed to be UTF-8
-encoded.<a href="#fnref8" class="footnote-back"
+href="#fnref8" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
+<li id="fn9"><p>For Windows, <code>outfile</code> is assumed to be UTF-8
+encoded.<a href="#fnref9" class="footnote-back"
role="doc-backlink">↩︎</a></p></li>
-<li id="fn9"><p>The <code>BARCODE_BIND_TOP</code> flag is set by default
-for DPD - see <a href="#dpd-code">6.1.10.7 DPD Code</a>.<a
-href="#fnref9" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
-<li id="fn10"><p>The <code>BARCODE_BIND</code> flag is always set for
+<li id="fn10"><p>The <code>BARCODE_BIND_TOP</code> flag is set by
+default for DPD - see <a href="#dpd-code">6.1.10.7 DPD Code</a>.<a
+href="#fnref10" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
+<li id="fn11"><p>The <code>BARCODE_BIND</code> flag is always set for
Codablock-F, Code 16K and Code 49. Special considerations apply to
-ITF-14 - see <a href="#itf-14">6.1.2.6 ITF-14</a>.<a href="#fnref10"
+ITF-14 - see <a href="#itf-14">6.1.2.6 ITF-14</a>.<a href="#fnref11"
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
-<li id="fn11"><p>Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN,
+<li id="fn12"><p>Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN,
ITF-14, UPC-A and UPC-E have compliant quiet zones added by default.<a
-href="#fnref11" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
-<li id="fn12"><p><code>ZINT_CAP_EANUPC</code> was previously named
-<code>ZINT_CAP_EXTENDABLE</code>, which is still recognised.<a
href="#fnref12" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
-<li id="fn13"><p><code>BARCODE_CODE128AB</code> previously used the name
-<code>BARCODE_CODE128B</code>, which is still recognised.<a
+<li id="fn13"><p><code>ZINT_CAP_EANUPC</code> was previously named
+<code>ZINT_CAP_EXTENDABLE</code>, which is still recognised.<a
href="#fnref13" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
+<li id="fn14"><p><code>BARCODE_CODE128AB</code> previously used the name
+<code>BARCODE_CODE128B</code>, which is still recognised.<a
+href="#fnref14" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
</ol>
</section>
</body>
diff --git a/docs/manual.pmd b/docs/manual.pmd
index bd46083a..f0c80e21 100644
--- a/docs/manual.pmd
+++ b/docs/manual.pmd
@@ -1028,7 +1028,7 @@ zint --fg=00ff0055 -d "This Text"
{.lin}
-will produce a semi-transparent green foreground with standard (white)
+will produce a semi-transparent green foreground with a standard (white)
background. Note that transparency is treated differently by raster and vector
(SVG) output formats, as for vector output the background will "shine through" a
transparent foreground. For instance
@@ -1707,7 +1707,7 @@ int main(int argc, char **argv)
```
Note that when using the API, the input data is assumed to be 8-bit binary
-unless the `input_mode` member of the `zint_symbol` structure is set - see [5.10
+unless the `input_mode` member of the `zint_symbol` structure is set - see [5.11
Setting the Input Mode] for details.
## 5.3 Encoding and Printing Functions in Depth
@@ -1876,24 +1876,59 @@ for (circle = my_symbol->vector->circles; circle; circle = circle->next) {
}
```
-## 5.6 Setting Options
+## 5.6 Buffering Symbols in Memory (memfile)
+
+Symbols can also be stored as "in-memory" file buffers by giving the
+`BARCODE_MEMORY_FILE` option to the `output_options` member, which saves the
+print output to member `memfile` instead of to the output file `outfile`. The
+length of the buffer is given in `memfile_size`. For instance:
+
+```c
+#include <zint.h>
+#include <stdio.h>
+#include <string.h>
+int main(int argc, char **argv)
+{
+ struct zint_symbol *my_symbol;
+ my_symbol = ZBarcode_Create();
+ my_symbol->output_options |= BARCODE_MEMORY_FILE;
+ /* Only the extension is used, to determine output format */
+ strcpy(my_symbol->outfile, "mem.svg");
+ ZBarcode_Encode_and_Print(my_symbol, argv[1], 0, 0);
+ /* `my_symbol->memfile` now contains the SVG output */
+ fwrite(my_symbol->memfile, 1, my_symbol->memfile_size, stdout);
+ ZBarcode_Delete(my_symbol);
+ return 0;
+}
+
+```
+
+will print the SVG output to `stdout` (the file "mem.svg" is not created). This
+is particularly useful for the textual formats EPS and SVG,[^7] allowing the
+output to be manipulated and processed by the client.
+
+[^7]: BARCODE_MEMORY_FILE textual formats EPS and SVG will have Unix newlines
+(LF) on both Windows and Unix, i.e. not CR+LF on Windows.
+
+## 5.7 Setting Options
So far our application is not very useful unless we plan to only make Code 128
-symbols and we don't mind that they only save to `"out.png"`. As with the CLI
-program, of course, these options can be altered. The way this is done is by
-altering the contents of the `zint_symbol` structure between the creation and
-encoding stages. The `zint_symbol` structure consists of the following members:
+symbols and we don't mind that they only save to `"out.png"` (or to memory, as
+above). As with the CLI program, of course, these options can be altered. The
+way this is done is by altering the contents of the `zint_symbol` structure
+between the creation and encoding stages. The `zint_symbol` structure consists
+of the following members:
-----------------------------------------------------------------------------
Member Name Type Meaning Default Value
------------------- ---------- ------------------------- -----------------
-`symbology` integer Symbol to use - see [5.8 `BARCODE_CODE128`
+`symbology` integer Symbol to use - see [5.9 `BARCODE_CODE128`
Specifying a Symbology].
`height` float Symbol height in Symbol dependent
X-dimensions, excluding
fixed width-to-height
- symbols.[^7]
+ symbols.[^8]
`scale` float Scale factor for 1.0
adjusting size of image
@@ -1909,7 +1944,7 @@ Member Name Type Meaning Default Value
X-dimensions.
`output_options` integer Set various output 0 (none)
- parameters - see [5.9
+ parameters - see [5.10
Adjusting Output
Options].
@@ -1943,7 +1978,7 @@ Member Name Type Meaning Default Value
`.eps`, `.pcx`, `.svg`,
`.tif` or `.txt` followed
by a terminating
- `NUL`.[^8]
+ `NUL`.[^9]
`primary` character Primary message data for `""` (empty)
string more complex symbols,
@@ -1959,7 +1994,7 @@ Member Name Type Meaning Default Value
Readable Text (HRT).
`input_mode` integer Set encoding of input `DATA_MODE`
- data - see [5.10 Setting
+ data - see [5.11 Setting
the Input Mode].
`eci` integer Extended Channel 0 (none)
@@ -1989,7 +2024,7 @@ Member Name Type Meaning Default Value
`warn_level` integer Affects error/warning `WARN_DEFAULT`
value returned by Zint
- API - see [5.7 Handling
+ API - see [5.8 Handling
Errors].
`text` unsigned Human Readable Text, `""` (empty)
@@ -2017,7 +2052,7 @@ Member Name Type Meaning Default Value
string event that an error
occurred, with a
terminating `NUL` - see
- [5.7 Handling Errors].
+ [5.8 Handling Errors].
`bitmap` pointer to Pointer to stored bitmap (output only)
unsigned image - see [5.4
@@ -2044,17 +2079,28 @@ Member Name Type Meaning Default Value
structure vector elements - see
[5.5 Buffering Symbols
in Memory (vector)].
+
+`memfile` pointer to Pointer to in-memory (output only)
+ unsigned file buffer if
+ character `BARCODE_MEMORY_FILE`
+ array set in `output_options`
+ - see [5.6 Buffering
+ Symbols in Memory
+ (memfile)].
+
+`memfile_size` integer Length of in-memory file (output only)
+ buffer.
-----------------------------------------------------------------------------
Table: API Structure `zint_symbol` {#tbl:api_structure_zint_symbol tag="$ $"}
-[^7]: The `height` value is ignored for Aztec (including HIBC and Aztec Rune),
+[^8]: The `height` value is ignored for Aztec (including HIBC and Aztec Rune),
Code One, Data Matrix (including HIBC), DotCode, Grid Matrix, Han Xin, MaxiCode,
QR Code (including HIBC, Micro QR, rMQR and UPNQR), and Ultracode - all of which
have a fixed width-to-height ratio (or, in the case of Code One, a fixed
height).
-[^8]: For Windows, `outfile` is assumed to be UTF-8 encoded.
+[^9]: For Windows, `outfile` is assumed to be UTF-8 encoded.
To alter these values use the syntax shown in the example below. This code has
the same result as the previous example except the output is now taller and
@@ -2085,7 +2131,7 @@ ignored:
This is what the CLI option `--nobackground` does - see [4.7 Using Colour].
-## 5.7 Handling Errors
+## 5.8 Handling Errors
If errors occur during encoding a non-zero integer value is passed back to the
calling application. In addition the `errtxt` member is set to a message
@@ -2196,7 +2242,7 @@ Error 881: Malformed foreground RGB colour 'nonsense' (hexadecimal only)
To treat all warnings as errors, set `symbol->warn_level` to `WARN_FAIL_ALL`.
-## 5.8 Specifying a Symbology
+## 5.9 Specifying a Symbology
Symbologies can be specified by number or by name as shown in the Table
{@tbl:barcode_types}. For example
@@ -2211,7 +2257,7 @@ means the same as
symbol->symbology = 50;
```
-## 5.9 Adjusting Output Options
+## 5.10 Adjusting Output Options
The `output_options` member can be used to adjust various aspects of the output
file. To select more than one option from the table below simply `OR` them
@@ -2226,10 +2272,10 @@ Value Effect
------------------------- ---------------------------------------------------
0 No options selected.
-`BARCODE_BIND_TOP` Boundary bar above the symbol only.[^9]
+`BARCODE_BIND_TOP` Boundary bar above the symbol only.[^10]
`BARCODE_BIND` Boundary bars above and below the symbol and
- between rows if stacking multiple symbols.[^10]
+ between rows if stacking multiple symbols.[^11]
`BARCODE_BOX` Add a box surrounding the symbol and whitespace.
@@ -2256,7 +2302,7 @@ Value Effect
Symbols in Memory (raster)].
`BARCODE_QUIET_ZONES` Add compliant quiet zones (additional to any
- specified whitespace).[^11]
+ specified whitespace).[^12]
`BARCODE_NO_QUIET_ZONES` Disable quiet zones, notably those with defaults.
@@ -2268,20 +2314,23 @@ Value Effect
`EMBED_VECTOR_FONT` Embed font in vector output - currently available
for SVG output only.
+
+`BARCODE_MEMORY_FILE` Write output to in-memory buffer `symbol->memfile`
+ instead of to `outfile` file.
------------------------------------------------------------------------------
Table: API `output_options` Values {#tbl:api_output_options tag="$ $"}
-[^9]: The `BARCODE_BIND_TOP` flag is set by default for DPD - see [6.1.10.7 DPD
+[^10]: The `BARCODE_BIND_TOP` flag is set by default for DPD - see [6.1.10.7 DPD
Code].
-[^10]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
+[^11]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
49. Special considerations apply to ITF-14 - see [6.1.2.6 ITF-14].
-[^11]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
+[^12]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
UPC-E have compliant quiet zones added by default.
-## 5.10 Setting the Input Mode
+## 5.11 Setting the Input Mode
The way in which the input data is encoded can be set using the `input_mode`
member. Valid values are shown in the table below.
@@ -2366,7 +2415,7 @@ be set to the overall height on output).
MicroPDF417 and PDF417. For QR Code and UPNQR, it affects Zint's automatic mask
selection - see [6.6.3 QR Code (ISO 18004)] for details.
-## 5.11 Multiple Segments
+## 5.12 Multiple Segments
For input data requiring multiple ECIs, the following functions may be used:
@@ -2426,7 +2475,7 @@ int main(int argc, char **argv)
A maximum of 256 segments may be specified. Use of multiple segments with GS1
data is not currently supported.
-## 5.12 Scaling Helpers
+## 5.13 Scaling Helpers
To help with scaling the output, the following three function are available:
@@ -2473,7 +2522,7 @@ due to the symbology, resolution and filetype but also due to the type of
scanner used, the intended scanning distance, and what media ("substrates") the
barcode appears on.
-## 5.13 Verifying Symbology Availability
+## 5.14 Verifying Symbology Availability
An additional function available in the API is:
@@ -2511,7 +2560,7 @@ if (ZBarcode_BarcodeName(BARCODE_PDF417, name) == 0) {
will print `BARCODE_PDF417`.
-## 5.14 Checking Symbology Capabilities
+## 5.15 Checking Symbology Capabilities
It can be useful for frontend programs to know the capabilities of a symbology.
This can be determined using another additional function:
@@ -2530,7 +2579,7 @@ Value Meaning
`ZINT_CAP_STACKABLE` Is the symbology stackable?
-`ZINT_CAP_EANUPC`[^12] Is the symbology EAN/UPC?
+`ZINT_CAP_EANUPC`[^13] Is the symbology EAN/UPC?
`ZINT_CAP_COMPOSITE` Does the symbology support composite data? (see
[6.3 GS1 Composite Symbols (ISO 24723)] below)
@@ -2561,7 +2610,7 @@ Value Meaning
Table: {#tbl:api_cap tag=": API Capability Flags"}
-[^12]: `ZINT_CAP_EANUPC` was previously named `ZINT_CAP_EXTENDABLE`, which is
+[^13]: `ZINT_CAP_EANUPC` was previously named `ZINT_CAP_EXTENDABLE`, which is
still recognised.
For example:
@@ -2581,7 +2630,7 @@ if (cap & ZINT_CAP_ECI) {
}
```
-## 5.15 Zint Version
+## 5.16 Zint Version
Whether the Zint library linked to was built with PNG support may be determined
with:
@@ -3091,13 +3140,13 @@ all-numeric characters.
{.lin}
It is sometimes advantageous to stop Code 128 from using Code Set C which
-compresses numerical data. The `BARCODE_CODE128AB`[^13] variant (symbology 60)
+compresses numerical data. The `BARCODE_CODE128AB`[^14] variant (symbology 60)
suppresses Code Set C in favour of Code Sets A and B.
Note that the special escapes to manually switch Code Sets mentioned above are
not available for this variant (nor for any other).
-[^13]: `BARCODE_CODE128AB` previously used the name `BARCODE_CODE128B`, which is
+[^14]: `BARCODE_CODE128AB` previously used the name `BARCODE_CODE128B`, which is
still recognised.
#### 6.1.10.3 GS1-128
@@ -4866,7 +4915,7 @@ Used internally by Zint Barcode Studio to display the preview, the Qt Backend
Buffering Symbols in Memory (vector)]) provided by the Zint library `libzint`.
The main class is `Zint::QZint`, which has getter/setter properties that
-correspond to the `zint_symbol` structure (see [5.6 Setting Options]), and a
+correspond to the `zint_symbol` structure (see [5.7 Setting Options]), and a
main method `render()` which takes a Qt `QPainter` to paint with, and a `QRectF`
rectangular area specifying where to paint into:
diff --git a/docs/manual.txt b/docs/manual.txt
index ce271b59..2b66257a 100644
--- a/docs/manual.txt
+++ b/docs/manual.txt
@@ -62,16 +62,17 @@ December 2023
- 5.3 Encoding and Printing Functions in Depth
- 5.4 Buffering Symbols in Memory (raster)
- 5.5 Buffering Symbols in Memory (vector)
- - 5.6 Setting Options
- - 5.7 Handling Errors
- - 5.8 Specifying a Symbology
- - 5.9 Adjusting Output Options
- - 5.10 Setting the Input Mode
- - 5.11 Multiple Segments
- - 5.12 Scaling Helpers
- - 5.13 Verifying Symbology Availability
- - 5.14 Checking Symbology Capabilities
- - 5.15 Zint Version
+ - 5.6 Buffering Symbols in Memory (memfile)
+ - 5.7 Setting Options
+ - 5.8 Handling Errors
+ - 5.9 Specifying a Symbology
+ - 5.10 Adjusting Output Options
+ - 5.11 Setting the Input Mode
+ - 5.12 Multiple Segments
+ - 5.13 Scaling Helpers
+ - 5.14 Verifying Symbology Availability
+ - 5.15 Checking Symbology Capabilities
+ - 5.16 Zint Version
- 6. Types of Symbology
- 6.1 One-Dimensional Symbols
- 6.1.1 Code 11
@@ -1130,7 +1131,7 @@ format. For example:
[zint -d "This Text" --fg=00FF0055]
-will produce a semi-transparent green foreground with standard (white)
+will produce a semi-transparent green foreground with a standard (white)
background. Note that transparency is treated differently by raster and vector
(SVG) output formats, as for vector output the background will “shine through” a
transparent foreground. For instance
@@ -1742,7 +1743,7 @@ function as shown in the next example:
}
Note that when using the API, the input data is assumed to be 8-bit binary
-unless the input_mode member of the zint_symbol structure is set - see 5.10
+unless the input_mode member of the zint_symbol structure is set - see 5.11
Setting the Input Mode for details.
5.3 Encoding and Printing Functions in Depth
@@ -1899,24 +1900,53 @@ draw_string(), and draw_circle() routines available:
draw_circle(circle->x, circle->y, circle->diameter, circle->width);
}
-5.6 Setting Options
+5.6 Buffering Symbols in Memory (memfile)
+
+Symbols can also be stored as “in-memory” file buffers by giving the
+BARCODE_MEMORY_FILE option to the output_options member, which saves the print
+output to member memfile instead of to the output file outfile. The length of
+the buffer is given in memfile_size. For instance:
+
+ #include <zint.h>
+ #include <stdio.h>
+ #include <string.h>
+ int main(int argc, char **argv)
+ {
+ struct zint_symbol *my_symbol;
+ my_symbol = ZBarcode_Create();
+ my_symbol->output_options |= BARCODE_MEMORY_FILE;
+ /* Only the extension is used, to determine output format */
+ strcpy(my_symbol->outfile, "mem.svg");
+ ZBarcode_Encode_and_Print(my_symbol, argv[1], 0, 0);
+ /* `my_symbol->memfile` now contains the SVG output */
+ fwrite(my_symbol->memfile, 1, my_symbol->memfile_size, stdout);
+ ZBarcode_Delete(my_symbol);
+ return 0;
+ }
+
+will print the SVG output to stdout (the file “mem.svg” is not created). This is
+particularly useful for the textual formats EPS and SVG,[7] allowing the output
+to be manipulated and processed by the client.
+
+5.7 Setting Options
So far our application is not very useful unless we plan to only make Code 128
-symbols and we don’t mind that they only save to "out.png". As with the CLI
-program, of course, these options can be altered. The way this is done is by
-altering the contents of the zint_symbol structure between the creation and
-encoding stages. The zint_symbol structure consists of the following members:
+symbols and we don’t mind that they only save to "out.png" (or to memory, as
+above). As with the CLI program, of course, these options can be altered. The
+way this is done is by altering the contents of the zint_symbol structure
+between the creation and encoding stages. The zint_symbol structure consists of
+the following members:
------------------------------------------------------------------------------
Member Name Type Meaning Default Value
-------------------- ------------ -------------------------- -----------------
- symbology integer Symbol to use - see 5.8 BARCODE_CODE128
+ symbology integer Symbol to use - see 5.9 BARCODE_CODE128
Specifying a Symbology.
height float Symbol height in Symbol dependent
X-dimensions, excluding
fixed width-to-height
- symbols.[7]
+ symbols.[8]
scale float Scale factor for adjusting 1.0
size of image (sets
@@ -1932,7 +1962,7 @@ encoding stages. The zint_symbol structure consists of the following members:
X-dimensions.
output_options integer Set various output 0 (none)
- parameters - see 5.9
+ parameters - see 5.10
Adjusting Output Options.
fgcolour character Foreground (ink) colour as "000000"
@@ -1963,7 +1993,7 @@ encoding stages. The zint_symbol structure consists of the following members:
end in .png, .gif, .bmp,
.emf, .eps, .pcx, .svg,
.tif or .txt followed by a
- terminating NUL.[8]
+ terminating NUL.[9]
primary character Primary message data for "" (empty)
string more complex symbols, with
@@ -1979,7 +2009,7 @@ encoding stages. The zint_symbol structure consists of the following members:
Readable Text (HRT).
input_mode integer Set encoding of input DATA_MODE
- data - see 5.10 Setting
+ data - see 5.11 Setting
the Input Mode.
eci integer Extended Channel 0 (none)
@@ -2009,7 +2039,7 @@ encoding stages. The zint_symbol structure consists of the following members:
warn_level integer Affects error/warning WARN_DEFAULT
value returned by Zint
- API - see 5.7 Handling
+ API - see 5.8 Handling
Errors.
text unsigned Human Readable Text, which "" (empty)
@@ -2036,7 +2066,7 @@ encoding stages. The zint_symbol structure consists of the following members:
errtxt character Error message in the event (output only)
string that an error occurred,
with a terminating NUL -
- see 5.7 Handling Errors.
+ see 5.8 Handling Errors.
bitmap pointer to Pointer to stored bitmap (output only)
unsigned image - see 5.4 Buffering
@@ -2062,6 +2092,16 @@ encoding stages. The zint_symbol structure consists of the following members:
structure vector elements - see 5.5
Buffering Symbols in
Memory (vector).
+
+ memfile pointer to Pointer to in-memory file (output only)
+ unsigned buffer if
+ character BARCODE_MEMORY_FILE set in
+ array output_options - see 5.6
+ Buffering Symbols in
+ Memory (memfile).
+
+ memfile_size integer Length of in-memory file (output only)
+ buffer.
------------------------------------------------------------------------------
: Table : API Structure zint_symbol
@@ -2091,7 +2131,7 @@ ignored:
This is what the CLI option --nobackground does - see 4.7 Using Colour.
-5.7 Handling Errors
+5.8 Handling Errors
If errors occur during encoding a non-zero integer value is passed back to the
calling application. In addition the errtxt member is set to a message detailing
@@ -2198,7 +2238,7 @@ This code will exit with the appropriate message:
To treat all warnings as errors, set symbol->warn_level to WARN_FAIL_ALL.
-5.8 Specifying a Symbology
+5.9 Specifying a Symbology
Symbologies can be specified by number or by name as shown in the Table
: Barcode Types (Symbologies). For example
@@ -2209,7 +2249,7 @@ means the same as
symbol->symbology = 50;
-5.9 Adjusting Output Options
+5.10 Adjusting Output Options
The output_options member can be used to adjust various aspects of the output
file. To select more than one option from the table below simply OR them
@@ -2222,10 +2262,10 @@ together when adjusting this value:
-------------------------- ---------------------------------------------------
0 No options selected.
- BARCODE_BIND_TOP Boundary bar above the symbol only.[9]
+ BARCODE_BIND_TOP Boundary bar above the symbol only.[10]
BARCODE_BIND Boundary bars above and below the symbol and
- between rows if stacking multiple symbols.[10]
+ between rows if stacking multiple symbols.[11]
BARCODE_BOX Add a box surrounding the symbol and whitespace.
@@ -2252,7 +2292,7 @@ together when adjusting this value:
Symbols in Memory (raster).
BARCODE_QUIET_ZONES Add compliant quiet zones (additional to any
- specified whitespace).[11]
+ specified whitespace).[12]
BARCODE_NO_QUIET_ZONES Disable quiet zones, notably those with defaults.
@@ -2264,11 +2304,14 @@ together when adjusting this value:
EMBED_VECTOR_FONT Embed font in vector output - currently available
for SVG output only.
+
+ BARCODE_MEMORY_FILE Write output to in-memory buffer symbol->memfile
+ instead of to outfile file.
------------------------------------------------------------------------------
: Table : API output_options Values
-5.10 Setting the Input Mode
+5.11 Setting the Input Mode
The way in which the input data is encoded can be set using the input_mode
member. Valid values are shown in the table below.
@@ -2345,7 +2388,7 @@ FAST_MODE causes a less optimal encodation scheme to be used for Data Matrix,
MicroPDF417 and PDF417. For QR Code and UPNQR, it affects Zint’s automatic mask
selection - see 6.6.3 QR Code (ISO 18004) for details.
-5.11 Multiple Segments
+5.12 Multiple Segments
For input data requiring multiple ECIs, the following functions may be used:
@@ -2399,7 +2442,7 @@ example:
A maximum of 256 segments may be specified. Use of multiple segments with GS1
data is not currently supported.
-5.12 Scaling Helpers
+5.13 Scaling Helpers
To help with scaling the output, the following three function are available:
@@ -2442,7 +2485,7 @@ due to the symbology, resolution and filetype but also due to the type of
scanner used, the intended scanning distance, and what media (“substrates”) the
barcode appears on.
-5.13 Verifying Symbology Availability
+5.14 Verifying Symbology Availability
An additional function available in the API is:
@@ -2472,7 +2515,7 @@ success. For instance:
will print BARCODE_PDF417.
-5.14 Checking Symbology Capabilities
+5.15 Checking Symbology Capabilities
It can be useful for frontend programs to know the capabilities of a symbology.
This can be determined using another additional function:
@@ -2489,7 +2532,7 @@ see which are set.
ZINT_CAP_STACKABLE Is the symbology stackable?
- ZINT_CAP_EANUPC[12] Is the symbology EAN/UPC?
+ ZINT_CAP_EANUPC[13] Is the symbology EAN/UPC?
ZINT_CAP_COMPOSITE Does the symbology support composite data? (see
6.3 GS1 Composite Symbols (ISO 24723) below)
@@ -2535,7 +2578,7 @@ For example:
printf("PDF417 does not support ECI\n");
}
-5.15 Zint Version
+5.16 Zint Version
Whether the Zint library linked to was built with PNG support may be determined
with:
@@ -2995,7 +3038,7 @@ all-numeric characters.
[zint -b CODE128AB -d "130170X178"]
It is sometimes advantageous to stop Code 128 from using Code Set C which
-compresses numerical data. The BARCODE_CODE128AB[13] variant (symbology 60)
+compresses numerical data. The BARCODE_CODE128AB[14] variant (symbology 60)
suppresses Code Set C in favour of Code Sets A and B.
Note that the special escapes to manually switch Code Sets mentioned above are
@@ -4689,7 +4732,7 @@ QZint renders a barcode by drawing the vector representation (see 5.5 Buffering
Symbols in Memory (vector)) provided by the Zint library libzint.
The main class is Zint::QZint, which has getter/setter properties that
-correspond to the zint_symbol structure (see 5.6 Setting Options), and a main
+correspond to the zint_symbol structure (see 5.7 Setting Options), and a main
method render() which takes a Qt QPainter to paint with, and a QRectF
rectangular area specifying where to paint into:
@@ -5492,24 +5535,28 @@ the yen sign (¥), and tilde (~) to overline (U+203E).
[6] ISO/IEC 646 Invariant is a subset of ASCII with 12 characters undefined: #,
$, @, [, \, ], ^, `, {, |, }, ~.
-[7] The height value is ignored for Aztec (including HIBC and Aztec Rune), Code
+[7] BARCODE_MEMORY_FILE textual formats EPS and SVG will have Unix newlines (LF)
+on both Windows and Unix, i.e. not CR+LF on Windows.
+
+[8] The height value is ignored for Aztec (including HIBC and Aztec Rune), Code
One, Data Matrix (including HIBC), DotCode, Grid Matrix, Han Xin, MaxiCode, QR
Code (including HIBC, Micro QR, rMQR and UPNQR), and Ultracode - all of which
have a fixed width-to-height ratio (or, in the case of Code One, a fixed
height).
-[8] For Windows, outfile is assumed to be UTF-8 encoded.
+[9] For Windows, outfile is assumed to be UTF-8 encoded.
-[9] The BARCODE_BIND_TOP flag is set by default for DPD - see 6.1.10.7 DPD Code.
+[10] The BARCODE_BIND_TOP flag is set by default for DPD - see 6.1.10.7 DPD
+Code.
-[10] The BARCODE_BIND flag is always set for Codablock-F, Code 16K and Code 49.
+[11] The BARCODE_BIND flag is always set for Codablock-F, Code 16K and Code 49.
Special considerations apply to ITF-14 - see 6.1.2.6 ITF-14.
-[11] Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
+[12] Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
UPC-E have compliant quiet zones added by default.
-[12] ZINT_CAP_EANUPC was previously named ZINT_CAP_EXTENDABLE, which is still
+[13] ZINT_CAP_EANUPC was previously named ZINT_CAP_EXTENDABLE, which is still
recognised.
-[13] BARCODE_CODE128AB previously used the name BARCODE_CODE128B, which is still
+[14] BARCODE_CODE128AB previously used the name BARCODE_CODE128B, which is still
recognised.
diff --git a/frontend/main.c b/frontend/main.c
index f4eef960..92d93eaf 100644
--- a/frontend/main.c
+++ b/frontend/main.c
@@ -44,16 +44,20 @@ typedef char static_assert_int_at_least_32bits[sizeof(int) * CHAR_BIT < 32 ? -1
#define ARRAY_SIZE(x) ((int) (sizeof(x) / sizeof((x)[0])))
#endif
-/* Determine if C89 (excluding MSVC, which doesn't define __STDC_VERSION__) */
-#if !defined(_MSC_VER) && (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 199000L)
-#define ZINT_IS_C89
+/* Determine if C89 or C99 (excluding MSVC, which doesn't define __STDC_VERSION__) */
+#ifndef _MSC_VER
+# if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 199000L
+# define ZINT_IS_C89
+# elif __STDC_VERSION__ <= 199901L /* Actually includes pseudo-standards "C94/C95" as well */
+# define ZINT_IS_C99
+# endif
#endif
#ifdef _MSC_VER
# include <malloc.h>
# define z_alloca(nmemb) _alloca(nmemb)
#else
-# if defined(ZINT_IS_C89) || defined(__NuttX__) /* C89 or NuttX RTOS */
+# if defined(ZINT_IS_C89) || defined(ZINT_IS_C99) || defined(__NuttX__) /* C89 or C99 or NuttX RTOS */
# include <alloca.h>
# endif
# define z_alloca(nmemb) alloca(nmemb)
diff --git a/tools/update_version.php b/tools/update_version.php
index e9a9e027..6236e1ff 100644
--- a/tools/update_version.php
+++ b/tools/update_version.php
@@ -326,11 +326,11 @@ version_replace(2, $data_dirname . 'win32/zint_cmdline_vc6/zint_cmdline_vc6.dsp'
// win32/vs2008/libzint.vcproj
-version_replace(3, $data_dirname . 'win32/vs2008/libzint.vcproj', '/ZINT_VERSION="/', '/"[0-9.]+/', '"' . $v_str);
+version_replace(2, $data_dirname . 'win32/vs2008/libzint.vcproj', '/ZINT_VERSION="/', '/"[0-9.]+/', '"' . $v_str);
// win32/vs2008/zint.vcproj
-version_replace(3, $data_dirname . 'win32/vs2008/zint.vcproj', '/ZINT_VERSION="/', '/"[0-9.]+/', '"' . $v_str);
+version_replace(2, $data_dirname . 'win32/vs2008/zint.vcproj', '/ZINT_VERSION="/', '/"[0-9.]+/', '"' . $v_str);
// win32/vs2015/libzint.vcxproj
diff --git a/win32/libzint.vcxproj b/win32/libzint.vcxproj
index 366201ec..93e4e1d0 100644
--- a/win32/libzint.vcxproj
+++ b/win32/libzint.vcxproj
@@ -139,6 +139,7 @@
<ClCompile Include="..\backend\dotcode.c" />
<ClCompile Include="..\backend\eci.c" />
<ClCompile Include="..\backend\emf.c" />
+ <ClCompile Include="..\backend\filemem.c" />
<ClCompile Include="..\backend\general_field.c" />
<ClCompile Include="..\backend\gif.c" />
<ClCompile Include="..\backend\gridmtx.c" />
@@ -187,6 +188,7 @@
<ClInclude Include="..\backend\gb18030.h" />
<ClInclude Include="..\backend\gb2312.h" />
<ClInclude Include="..\backend\gbk.h" />
+ <ClInclude Include="..\backend\filemem.h" />
<ClInclude Include="..\backend\general_field.h" />
<ClInclude Include="..\backend\gridmtx.h" />
<ClInclude Include="..\backend\gs1.h" />
diff --git a/win32/vs2008/libzint.vcproj b/win32/vs2008/libzint.vcproj
index accc690e..e7e7c908 100644
--- a/win32/vs2008/libzint.vcproj
+++ b/win32/vs2008/libzint.vcproj
@@ -184,76 +184,6 @@
Name="VCPostBuildEventTool"
/>
</Configuration>
- <Configuration
- Name="Release_LIB|Win32"
- OutputDirectory="$(SolutionDir)$(ConfigurationName)"
- IntermediateDirectory="$(ConfigurationName)"
- ConfigurationType="4"
- CharacterSet="2"
- WholeProgramOptimization="0"
- >
- <Tool
- Name="VCPreBuildEventTool"
- />
- <Tool
- Name="VCCustomBuildTool"
- />
- <Tool
- Name="VCXMLDataGeneratorTool"
- />
- <Tool
- Name="VCWebServiceProxyGeneratorTool"
- />
- <Tool
- Name="VCMIDLTool"
- />
- <Tool
- Name="VCCLCompilerTool"
- Optimization="2"
- EnableIntrinsicFunctions="false"
- AdditionalIncludeDirectories="d:\opt\include"
- PreprocessorDefinitions="WIN32;NDEBUG;_LIB;_CRT_SECURE_NO_WARNINGS;_CRT_NONSTDC_NO_WARNINGS;ZINT_VERSION="\"2.13.0.9\"""
- StringPooling="true"
- ExceptionHandling="0"
- RuntimeLibrary="2"
- EnableFunctionLevelLinking="false"
- RuntimeTypeInfo="false"
- UsePrecompiledHeader="0"
- WarningLevel="3"
- DebugInformationFormat="0"
- CompileAs="0"
- DisableSpecificWarnings="4018;4244;4305"
- />
- <Tool
- Name="VCManagedResourceCompilerTool"
- />
- <Tool
- Name="VCResourceCompilerTool"
- PreprocessorDefinitions="NDEBUG"
- />
- <Tool
- Name="VCPreLinkEventTool"
- />
- <Tool
- Name="VCLibrarianTool"
- OutputFile="$(OutDir)\libzintMD.lib"
- />
- <Tool
- Name="VCALinkTool"
- />
- <Tool
- Name="VCXDCMakeTool"
- />
- <Tool
- Name="VCBscMakeTool"
- />
- <Tool
- Name="VCFxCopTool"
- />
- <Tool
- Name="VCPostBuildEventTool"
- />
- </Configuration>
</Configurations>
<References>
</References>
@@ -318,14 +248,6 @@
<File
RelativePath="..\..\backend\dllversion.c"
>
- <FileConfiguration
- Name="Release_LIB|Win32"
- ExcludedFromBuild="true"
- >
- <Tool
- Name="VCCLCompilerTool"
- />
- </FileConfiguration>
</File>
<File
RelativePath="..\..\backend\dmatrix.c"
@@ -343,6 +265,10 @@
RelativePath="..\..\backend\emf.c"
>
</File>
+ <File
+ RelativePath="..\..\backend\filemem.c"
+ >
+ </File>
<File
RelativePath="..\..\backend\general_field.c"
>
@@ -533,6 +459,10 @@
RelativePath="..\..\backend\gbk.h"
>
</File>
+ <File
+ RelativePath="..\..\backend\filemem.h"
+ >
+ </File>
<File
RelativePath="..\..\backend\general_field.h"
>
@@ -642,14 +572,6 @@
<File
RelativePath="..\..\backend\libzint.rc"
>
- <FileConfiguration
- Name="Release_LIB|Win32"
- ExcludedFromBuild="true"
- >
- <Tool
- Name="VCResourceCompilerTool"
- />
- </FileConfiguration>
</File>
</Filter>
</Files>
diff --git a/win32/vs2008/zint.sln b/win32/vs2008/zint.sln
new file mode 100644
index 00000000..3288aa7d
--- /dev/null
+++ b/win32/vs2008/zint.sln
@@ -0,0 +1,29 @@
+
+Microsoft Visual Studio Solution File, Format Version 10.00
+# Visual Studio 2008
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "zint", "zint.vcproj", "{3169C7FA-E52C-4BFC-B7BB-E55EBA133770}"
+ ProjectSection(ProjectDependencies) = postProject
+ {5C08DC40-8F7D-475E-AA3C-814DED735A4B} = {5C08DC40-8F7D-475E-AA3C-814DED735A4B}
+ EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libzint", "libzint.vcproj", "{5C08DC40-8F7D-475E-AA3C-814DED735A4B}"
+EndProject
+Global
+ GlobalSection(SolutionConfigurationPlatforms) = preSolution
+ Debug|Win32 = Debug|Win32
+ Release|Win32 = Release|Win32
+ EndGlobalSection
+ GlobalSection(ProjectConfigurationPlatforms) = postSolution
+ {3169C7FA-E52C-4BFC-B7BB-E55EBA133770}.Debug|Win32.ActiveCfg = Debug|Win32
+ {3169C7FA-E52C-4BFC-B7BB-E55EBA133770}.Debug|Win32.Build.0 = Debug|Win32
+ {3169C7FA-E52C-4BFC-B7BB-E55EBA133770}.Release|Win32.ActiveCfg = Release|Win32
+ {3169C7FA-E52C-4BFC-B7BB-E55EBA133770}.Release|Win32.Build.0 = Release|Win32
+ {5C08DC40-8F7D-475E-AA3C-814DED735A4B}.Debug|Win32.ActiveCfg = Debug|Win32
+ {5C08DC40-8F7D-475E-AA3C-814DED735A4B}.Debug|Win32.Build.0 = Debug|Win32
+ {5C08DC40-8F7D-475E-AA3C-814DED735A4B}.Release|Win32.ActiveCfg = Release|Win32
+ {5C08DC40-8F7D-475E-AA3C-814DED735A4B}.Release|Win32.Build.0 = Release|Win32
+ EndGlobalSection
+ GlobalSection(SolutionProperties) = preSolution
+ HideSolutionNode = FALSE
+ EndGlobalSection
+EndGlobal
diff --git a/win32/vs2008/zint.vcproj b/win32/vs2008/zint.vcproj
index c0b60b77..879a9717 100644
--- a/win32/vs2008/zint.vcproj
+++ b/win32/vs2008/zint.vcproj
@@ -41,7 +41,7 @@
<Tool
Name="VCCLCompilerTool"
Optimization="0"
- AdditionalIncludeDirectories="..\backend"
+ AdditionalIncludeDirectories="..\..\backend"
PreprocessorDefinitions="WIN32;_WIN32;_DEBUG;_CRT_SECURE_NO_WARNINGS;_CRT_NONSTDC_NO_WARNINGS;ZINT_VERSION="\"2.13.0.9\"";ZINT_DLL"
MinimalRebuild="true"
ExceptionHandling="0"
@@ -114,7 +114,7 @@
<Tool
Name="VCCLCompilerTool"
Optimization="2"
- AdditionalIncludeDirectories="..\backend"
+ AdditionalIncludeDirectories="..\..\backend"
PreprocessorDefinitions="WIN32;_WIN32;NDEBUG;_CRT_SECURE_NO_WARNINGS;_CRT_NONSTDC_NO_WARNINGS;ZINT_VERSION="\"2.13.0.9\"";ZINT_DLL"
StringPooling="true"
ExceptionHandling="0"
@@ -136,80 +136,7 @@
/>
<Tool
Name="VCLinkerTool"
- AdditionalLibraryDirectories="d:\opt\lib"
- />
- <Tool
- Name="VCALinkTool"
- />
- <Tool
- Name="VCManifestTool"
- />
- <Tool
- Name="VCXDCMakeTool"
- />
- <Tool
- Name="VCBscMakeTool"
- />
- <Tool
- Name="VCFxCopTool"
- />
- <Tool
- Name="VCAppVerifierTool"
- />
- <Tool
- Name="VCPostBuildEventTool"
- />
- </Configuration>
- <Configuration
- Name="Release_LIB|Win32"
- OutputDirectory="$(SolutionDir)$(ConfigurationName)"
- IntermediateDirectory="$(ConfigurationName)"
- ConfigurationType="1"
- CharacterSet="2"
- WholeProgramOptimization="0"
- >
- <Tool
- Name="VCPreBuildEventTool"
- />
- <Tool
- Name="VCCustomBuildTool"
- />
- <Tool
- Name="VCXMLDataGeneratorTool"
- />
- <Tool
- Name="VCWebServiceProxyGeneratorTool"
- />
- <Tool
- Name="VCMIDLTool"
- />
- <Tool
- Name="VCCLCompilerTool"
- Optimization="2"
- AdditionalIncludeDirectories="..\backend"
- PreprocessorDefinitions="WIN32;_WIN32;NDEBUG;_CRT_SECURE_NO_WARNINGS;_CRT_NONSTDC_NO_WARNINGS;ZINT_VERSION="\"2.13.0.9\"""
- StringPooling="true"
- ExceptionHandling="0"
- RuntimeLibrary="2"
- EnableFunctionLevelLinking="false"
- RuntimeTypeInfo="false"
- UsePrecompiledHeader="0"
- WarningLevel="3"
- DebugInformationFormat="0"
- />
- <Tool
- Name="VCManagedResourceCompilerTool"
- />
- <Tool
- Name="VCResourceCompilerTool"
- />
- <Tool
- Name="VCPreLinkEventTool"
- />
- <Tool
- Name="VCLinkerTool"
- AdditionalDependencies="libpngMD.lib zlibMD.lib"
- AdditionalLibraryDirectories="d:\opt\lib"
+ AdditionalLibraryDirectories=""
/>
<Tool
Name="VCALinkTool"
@@ -243,15 +170,15 @@
UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}"
>
<File
- RelativePath="..\getopt\getopt.c"
+ RelativePath="..\..\getopt\getopt.c"
>
</File>
<File
- RelativePath="..\getopt\getopt1.c"
+ RelativePath="..\..\getopt\getopt1.c"
>
</File>
<File
- RelativePath="..\frontend\main.c"
+ RelativePath="..\..\frontend\main.c"
>
</File>
</Filter>
@@ -261,11 +188,11 @@
UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}"
>
<File
- RelativePath=".\getopt\getopt.h"
+ RelativePath="..\..\getopt\getopt.h"
>
</File>
<File
- RelativePath="..\frontend\resource.h"
+ RelativePath="..\..\frontend\resource.h"
>
</File>
</Filter>
@@ -275,7 +202,7 @@
UniqueIdentifier="{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}"
>
<File
- RelativePath="..\frontend\zint.rc"
+ RelativePath="..\..\frontend\zint.rc"
>
</File>
</Filter>
diff --git a/win32/vs2015/libzint.vcxproj b/win32/vs2015/libzint.vcxproj
index 4049f835..99bbb6fd 100644
--- a/win32/vs2015/libzint.vcxproj
+++ b/win32/vs2015/libzint.vcxproj
@@ -316,6 +316,7 @@
<ClCompile Include="..\..\backend\dotcode.c" />
<ClCompile Include="..\..\backend\eci.c" />
<ClCompile Include="..\..\backend\emf.c" />
+ <ClCompile Include="..\..\backend\filemem.c" />
<ClCompile Include="..\..\backend\general_field.c" />
<ClCompile Include="..\..\backend\gif.c" />
<ClCompile Include="..\..\backend\gridmtx.c" />
@@ -364,6 +365,7 @@
<ClInclude Include="..\..\backend\gb18030.h" />
<ClInclude Include="..\..\backend\gb2312.h" />
<ClInclude Include="..\..\backend\gbk.h" />
+ <ClInclude Include="..\..\backend\filemem.h" />
<ClInclude Include="..\..\backend\general_field.h" />
<ClInclude Include="..\..\backend\gridmtx.h" />
<ClInclude Include="..\..\backend\gs1.h" />
diff --git a/win32/vs2017/libzint.vcxproj b/win32/vs2017/libzint.vcxproj
index 929578a9..04100810 100644
--- a/win32/vs2017/libzint.vcxproj
+++ b/win32/vs2017/libzint.vcxproj
@@ -139,6 +139,7 @@
<ClCompile Include="..\..\backend\dotcode.c" />
<ClCompile Include="..\..\backend\eci.c" />
<ClCompile Include="..\..\backend\emf.c" />
+ <ClCompile Include="..\..\backend\filemem.c" />
<ClCompile Include="..\..\backend\general_field.c" />
<ClCompile Include="..\..\backend\gif.c" />
<ClCompile Include="..\..\backend\gridmtx.c" />
@@ -187,6 +188,7 @@
<ClInclude Include="..\..\backend\gb18030.h" />
<ClInclude Include="..\..\backend\gb2312.h" />
<ClInclude Include="..\..\backend\gbk.h" />
+ <ClInclude Include="..\..\backend\filemem.h" />
<ClInclude Include="..\..\backend\general_field.h" />
<ClInclude Include="..\..\backend\gridmtx.h" />
<ClInclude Include="..\..\backend\gs1.h" />
diff --git a/win32/vs2019/libzint.vcxproj b/win32/vs2019/libzint.vcxproj
index 22d840cf..84717cdb 100644
--- a/win32/vs2019/libzint.vcxproj
+++ b/win32/vs2019/libzint.vcxproj
@@ -139,6 +139,7 @@
<ClCompile Include="..\..\backend\dotcode.c" />
<ClCompile Include="..\..\backend\eci.c" />
<ClCompile Include="..\..\backend\emf.c" />
+ <ClCompile Include="..\..\backend\filemem.c" />
<ClCompile Include="..\..\backend\general_field.c" />
<ClCompile Include="..\..\backend\gif.c" />
<ClCompile Include="..\..\backend\gridmtx.c" />
@@ -187,6 +188,7 @@
<ClInclude Include="..\..\backend\gb18030.h" />
<ClInclude Include="..\..\backend\gb2312.h" />
<ClInclude Include="..\..\backend\gbk.h" />
+ <ClInclude Include="..\..\backend\filemem.h" />
<ClInclude Include="..\..\backend\general_field.h" />
<ClInclude Include="..\..\backend\gridmtx.h" />
<ClInclude Include="..\..\backend\gs1.h" />
diff --git a/win32/zint_cmdline_vc6/zint_cmdline_vc6.dsp b/win32/zint_cmdline_vc6/zint_cmdline_vc6.dsp
index c6f19728..d4b13c9b 100644
--- a/win32/zint_cmdline_vc6/zint_cmdline_vc6.dsp
+++ b/win32/zint_cmdline_vc6/zint_cmdline_vc6.dsp
@@ -156,6 +156,10 @@ SOURCE=..\..\backend\emf.c
# End Source File
# Begin Source File
+SOURCE=..\..\backend\filemem.c
+# End Source File
+# Begin Source File
+
SOURCE=..\..\backend\general_field.c
# End Source File
# Begin Source File