Intro to Ada Bar Codes
======================

The project Ada Bar Codes provides a package for generating
various types of bar codes on different output formats,
such as PDF, SVG or bitmaps.

The creation of a bar code is as simple as this small procedure:

  with Ada.Text_IO,
       Bar_Codes.Impl;

  procedure Small_Demo is
    use Ada.Text_IO;
    use Bar_Codes, Bar_Codes.Impl;
    svg : File_Type;
  begin
    Create (svg, Out_File, "bar_code.svg");
    Put_Line (svg, "<?xml version=""1.0"" encoding=""UTF-8""?>");
    Put_Line (svg, SVG_Bar_Code (Code_QR_Low, 25.0, 25.0, "mm", "Hello"));
    Close (svg);
  end;


Contents
========

  Ada Bar Codes
  =============

  - ada_bar_codes.gpr       : project file for the AdaCore GNAT compiler
  - ada_bar_codes_oa.prj    : project file for the PTC ObjectAda compiler
  - ada_bar_codes.txt       : this file
  - bar_codes.ads           : package specification
  - bar_codes.adb           : package body
  - bar_codes-*             : private children packages (needed but not relevant for users)
  - demo/bar_codes_demo.adb : demo procedure
  - test/bar_codes_test.adb : test procedure (produces lots of files!)

Warning & legal
===============
There is NO WARRANTY in this software. Read copyright notice in bar_codes.ads.

Portability
===========
This software can be compiled for any target machine, and with any compiler
for Ada 2005 or later language versions.

How to build Ada Bar Codes and its demo
=======================================
Here is how to build with GNAT/GCC:

    - type "gprbuild -P ada_bar_codes" in the command line
or
    - type "gnatmake -P ada_bar_codes" in the command line
or
    - open the ada_bar_codes.gpr file (will launch GNAT Studio),
      press F4 (Build)

Here is how to build with ObjectAda (tested with v.9.2):
    - open the ada_bar_codes_oa.prj file, press F7 (Build)

The project builds bar_codes_demo[.exe] and bar_codes_test[.exe].

Thanks to...
============

Giuseppe Cannone, for the inspiration and advice.

Jeffrey R. Carter, for the first implementation on raster graphics
  and as a Web service: https://github.com/jrcarter/Gnoga_Bar_Codes


Nicolas Boulenguez <nicolas@debian.org>,
  for numerous suggestions and improvements.

On the Web
==========
Home page:     http://ada-bar-codes.sf.net/
Project page:  http://sf.net/projects/ada-bar-codes/
Mirror:        https://github.com/zertovitch/ada-bar-codes
Alire crate:   https://alire.ada.dev/crates/bar_codes

--
Enjoy!

Gautier de Montmollin
gautier.de.montmollin, at: gmail dot com.
