5. Использование API

Zint написан на языке C и имеет API для использования программами на языке С. Благодаря theunknownones, есть возможно использовать zint в виде компонента Delphi.

API библиотеки libzint очень похоже на тот, что используется пакетом GNU Barcode. Это позволяет легко переходить от GNU Barcode к Zint. Однако имена функций и параметров, используемые в Zint и GNU штрих-коде, различаются. Это позволяет спользовать одном приложении оба пакета без каких-либо конфликтов.

5.1 Создание и удаление штрих-кодов

Штрих-коды, которые создает Zint, находятся в структуре zint_symbol , определенной в zint.h. Эти штрих-коды создаются функцией ZBarcode_Create() и удаляются с помощью функции ZBarcode_Delete(). К примеру, данный код создает и затем удаляет штрих-код:

#include <stdio.h>

#include <zint.h>

int main()

{

struct zint_symbol *my_symbol;

my_symbol = ZBarcode_Create();

if(my_symbol != NULL)

{

printf("Symbol successfully created!\n");

}

ZBarcode_Delete(my_symbol);

return 0;

}

При компиляции этот код должен быть связан с библиотекой libzint с параметром -lzint:

gcc -o simple simple.c –lzint

5.2 Кодирование и сохранение в файл

Чтобы закодировать данные в штрих-код, используется функция ZBarcode_Encode(). Чтобы записать штрих-код в файл, используется функция ZBarcode_Print(). К примеру, данный код берет параметр из командной строки и выводит штрихкод в формате Code 128 в файл out.png (формат, соответственно, PNG) в текущем рабочем каталоге:

#include <stdio.h>

#include <zint.h>

int main(int argc, char **argv)

{

struct zint_symbol *my_symbol;

my_symbol = ZBarcode_Create();

ZBarcode_Encode(my_symbol, argv[1], 0);

ZBarcode_Print(my_symbol, 0);

ZBarcode_Delete(my_symbol);

return 0;

}

Это также может быть сделано в один этап с использованием функции ZBarcode_Encode_and_Print(), как показано в следующем примере:

#include <stdio.h>

#include <zint.h>

int main(int argc, char **argv)

{

struct zint_symbol *my_symbol;

my_symbol = ZBarcode_Create();

ZBarcode_Encode_and_Print(my_symbol, argv[1], 0, 0);

ZBarcode_Delete(my_symbol);

return 0;

}

Строка на входе должна быть в кодировкеUnicode.

5.3 Функции кодирования и печати

Определены следующие функции для кодирования и печати штрих-кодов:

int ZBarcode_Encode(struct zint_symbol *symbol, unsigned char *input, int

length);

int ZBarcode_Encode_File(struct zint_symbol *symbol, char *filename);

int ZBarcode_Print(struct zint_symbol *symbol, int rotate_angle);

int ZBarcode_Encode_and_Print(struct zint_symbol *symbol, unsigned char *input,

int length, int rotate_angle);

int ZBarcode_Encode_File_and_Print(struct zint_symbol *symbol, char *filename,

int rotate_angle);

В этих фунциях параметр "length" может быт использован для установки длины вводной строки. Это позволяет кодировать NULL (ASCII 0) символы в тех штрихкодах, где это допустими. Значение 0 отключает эту возможность и Zint будет кодировать данные до первого символа NULL в строке ввода.

Параметр "rotate_angle" позволяет повернуть картинку во время ее вывода в формате PNG. Допустимые значения: 0, 90, 180 и 270.

Функции ZBarcode_Encode_File() and ZBarcode_Encode_File_and_Print() могут быть использованы, чтобы закодировать данные, получаемые из файла, имя файла указывается в строке "filename".

5.4 Буферизация штрих-кодов в память

В дополнение к сохранению штрих-кодов в файлы, Zint позволяет получить доступ к растровому изображению штрихкода в памяти.

Для этого используются следующие функции:

int ZBarcode_Buffer(struct zint_symbol *symbol, int rotate_angle);

int ZBarcide_Encode_and_Buffer(struct zint_symbol *symbol, unsigned char *input,

int length, int rotate_angle);

int ZBarcode_Encode_File_and_Buffer(struct zint_symbol *symbol, char *filename,

int rotate_angle);

Параметры такие же, как и описано выше. Разница в том, что вместо сохранения картинки в файл, она помещается в массив (char). Указатель "bitmap" устанавливается на первой ячейке массива; значения "barcode_width" и "barcode_height" указывают на размер полученного изображения в пикселях. Вращение и параметры цвета могут быть использованы во время буферизации так же, как и при сохранении в PNG файл.

Растровые данные могут быть извлечены из массива с помощью метода, показанного в следующем примере. render_pixel() следует понимать, как функцию для рисования точек на экране, осуществляемая приложением:

int row, col, i = 0;

int red, blue, green;

for(row = 0; row < my_symbol->bitmap_height; row++) {

for(column = 0; column < my_symbol->bitmap_width; column++) {

red = my_symbol->bitmap[i];

green = my_symbol->bitmap[i + 1];

blue = my_symbol->bitmap[i + 2];

render_pixel(row, column, red, green, blue);

i += 3;

}

}

5.5 Настройки

Пример выше, конечно очень прост, но позволяет ли формировать штриходы формата Code 128 и сохранять их в jut.png. Конечно, в реальном применении это все должно настраиваться. Это обеспечивается изменением значений элементов структуры zint_symbol в между этапами создания и кодирования. Структура zint_symbol состоит из следующих переменных:

Примечание. Это значение игнорируется в штрих-кодах Australia Post 4-State, PostNet, PLANET, USPS OneCode, RM4SCC, PDF417, Data Matrix, Maxicode, QR Code, GS1 DataBar-14 Stacked, PDF417 и MicroPDF417 – которые имеют фиксированную высоту.

Чтобы изменить эти значения, используют синтаксис, показанный на примере ниже Результат выполнения этого кода такой же, как и в предыдущем примере, но штрихкод будет выше и зеленого цвета.

#include <stdio.h>

#include <zint.h>

#include <string.h>

int main(int argc, char **argv)

{

struct zint_symbol *my_symbol;

my_symbol = ZBarcode_Create();

strcpy(my_symbol->fgcolour, "00ff00");

my_symbol->height = 400;

ZBarcode_Encode_and_Print(my_symbol, argv[1], 0, 0);

ZBarcode_Delete(my_symbol);

return 0;

}

5.6 Обработка ошибок

В случае возникновения ошибок при кодировании, вызывающему приложению возвращается код ошибки (тип integer). Кроме того, подробное сообщение об ошибке помещается в переменную errtxt. Коды ошибок, которые могут быть возвращены Zint, приведены в следующей таблице:

Пример обработки сообщений об ошибках

#include <stdio.h>

#include <zint.h>

#include <string.h>

int main(int argc, char **argv)

{

struct zint_symbol *my_symbol;

int error = 0;

my_symbol = ZBarcode_Create();

strcpy(my_symbol->fgcolour, "nonsense");

error = ZBarcode_Encode_and_Print(my_symbol, argv[1], 0, 0);

if(error != 0)

{

/* some error occurred */

printf("%s\n", my_symbol->errtxt);

}

if(error > WARN_INVALID_OPTION)

{

/* stop now */

ZBarcode_Delete(my_symbol);

return 1;

}

/* otherwise carry on with the rest of the application */

ZBarcode_Delete(my_symbol);

return 0;

}

Результатом будет сообщение об ошибке:

error: malformed foreground colour target

5.7 Указание формата

Формат штрихкода может быть задан число или именем, как показано в следующей таблице.

symbol->symbology= BARCODE_LOGMARS;

означает то же, что и

symbol->symbology = 50;