TEC-IT Online Barcode Generator Service

(c) TEC-IT Datenverarbeitung GmbH. This service is subject to a fee (except demo operation until further notice).

Barcode Demo Form

The following form sends the entered data with the GET method to the online generator URL:

For demo purposes leave the default values in the form.

Login

Access Key Parameter "accesskey=..."

Barcode Properties

Barcode type Parameter "&code=..."
Module width Parameter "&modulewidth=..."
Parameter "&unit=..."
Rotation Parameter "&rotation=..."
Parameter "&format=..."
Monochrome PNG Parameters "&format=png&bw=true"

Data to be Encoded

Data Parameter "&data=..."

When you click on [Generate Barcode], the data entered above will be sent to the Online Barcode Generator. The barcode will be generated and sent back to the to the browser. A new browser window will be opened for this purpose. In case of an error, an image with an error text is generated.

Integration Into Your Application

The barcode is generated as an image data stream in the selected format (default: GIF) and sent to the browser or your application. The integration into Html documents can be done with the Html Image Tag - like this:

<img src="barcode.ashx?accesskey=demo&code=EAN13&data=978020137962&dpi=96&modulewidth=2&unit=px">

Barcode Image  

The bar code type and the other bar code properties are supplied via GET parameters (separated by &).

Use format=png&bw=true to request a 1-bit black-and-white PNG. This also converts text to black and white; omit bw to retain colors and text smoothing. Try 1-bit PNG.

GIF, PNG and JPEG output is limited to 32 megapixels (32,000,000 pixels), calculated as the final image width multiplied by its height. Larger raster images return an error using the selected onerror mode. SVG vector output is not subject to this pixel limit.

Object Pooling (Server Configuration)

SDK object reuse is controlled centrally in Web.config, under appSettings: <add key="BarcodePoolingEnabled" value="true" />. The supplied configuration enables pooling. Set the value to false to disable it; missing or invalid values also disable it. Changing Web.config restarts the application.

Clients do not need a pooling parameter; a supplied pooling request parameter is ignored. Only authenticated customer keys use the pool; demo requests never do. Pools are separated by access key, barcode variant and rendering parameters, excluding data and its alias text. Each object is used by one request at a time. Always send all required properties on every request; do not rely on a previous request to initialize an object. Failed requests discard their object.

Pool capacity adapts to logical processors and recently active access keys. Each profile starts with a retention limit of twice the logical processor count; observed concurrent leases can raise it. The total idle limit is min(ceiling, max(128, active keys * 3 * 2 * logical processors, peak concurrent leases)). Inactive keys are removed during quiet cleanup; the concurrency high-water mark resets when that cleanup empties the pool. BarcodePoolMaxIdle configures the ceiling (default: 1024; missing, invalid or non-positive values use 1024). Objects are allocated on demand. Each application process has its own pool.

Two minutes is a soft retention period: older matching objects remain reusable. Age cleanup runs in the background only when no barcode rendering is active and at least 250 ms have passed without activity. It removes one object at a time and disposes it outside the pool lock, checking activity before removing the next. A miss immediately creates another object.

At capacity, a return can replace one oldest idle object. Failed and surplus objects enter a separate disposal buffer of at most 128 objects, which also drains during load. If that buffer is full, the returning request disposes its one surplus object synchronously instead. One additional object may be undergoing background disposal. The idle ceiling does not limit active renderings. Application restarts clear the pool.

Supported Get Parameters

The following GET parameters are evaluated in the online generator:

https://services.tec-it.com/aspx/tbarcode/barcode.ashx?
accesskey=YourAccessKey Your access key (identifies your account)
&code=Code39 | Code128 | ... Barcode type (see list below for the possible values)
&data=Hello%201234 Barcode data (URL encoded, UTF-8)
&dpi=96 Bitmap resolution in DPI (Default: 96 dpi) - optional
&modulewidth=auto | fit | min | [value] Module width: auto or fit: value is selected appropriately
min: value is selcted as small as possible
[value]: value is specified numerically
&unit=mm | px | mils Unit (for width, height and modulewidth) - optional
mm: Millimeter; px: Pixel; mils: 1/1000 inch; fit: identical to modulewidth=fit
&height=heigth (numerical) Height (&unit=..) incl. quiet zone - optional
&width=width (numerical) Width (&unit=..) incl. quiet zone - optional
&qz=quiet zone (numerical) Quiet zone (&qzunit=..) - optional
5 (all sides) | 5,10 (top/bottom, left/right) | 5,10,5,20 (top, right, bottom, left)
&qzunit=mod | mm | px | mils | in | none Unit for the quiet zone - optional
mod: Module (standard); mm: Millimeter; px: Pixel; mils: 1/1000 inch; in: inch
&bb=bearer bar (numerical) Widt of the bearer bar in [mm] for ITF-14 - optional
&bbtype=tb | rect | none Type of the bearer bar for ITF-14 - optional
tb: only horizontal (default); rect: all sides; none: no bearer bar
&translate-esc=on | off Translate escape sequences (on = translate)
\F -> FNC1, \xFA -> binary value in hex format, \t -> Tab, \n -> Line Feed, \r -> Carriage Return
&codepage=Default | Utf_8 | Windows1252 | [...] Code page for encoding the barcode data.
Usually used with 2D codes (e.g. QRCode vCard uses Utf_8).
&eclevel=Low | Medium | Quartil | High Error correction level for QR Code - optional
&cdmethod=Standard | Modulo10 | [enum] Check digit method (see API description) - optional
&hrt=ABCDEFG Display text - optional (only if the display text should differ from the barcode data).
&showhrt=yes | no Show human readable text line - optional (Default: yes), applied only to linear code types.
&composite=auto | cca | ccb | ccc 2D Composite Component - optional (applies only to Composite Codes)
&rotation=0 | 90 | 180 | 270 Orientation (rotation) of the bar code in degree - optional
&scalex=1,2,3... Horizontal scaling - optional
&scaley=1,2,3... Vertical scaling - optional
&format=gif | jpg | png | svg Generated bitmap or vector format (default: GIF) - optional
&bw=false | true 1-bit black-and-white output with format=png&bw=true (default: false). Applies to PNG only. Text is also converted; error images retain their colors.
&download=false | true File will be delivered as attachment (Default: false) - optional
&onerror=show | ignore | 500 | 204 Error handling (default: show), including invalid numeric request parameters such as width or height - optional
&hash=E3A243F7... Hash code - optional (only if set for your account)

Supported Barcodes

The following bar codes are supported in the parameter code=BarcodeType (extension on request).

Aztec                     Code11                   ISBN
CodablockF                Code128                  ITF14
DataMatrix                Code25IL                 MSI
MaxiCode                  Code39                   OneTrackPharmacode
MicroPDF417               Code39FullASCII          TwoTrackPharmacode
PDF417                    Code93                   TelepenAlpha
QRCode / QRCodeISO        EAN8                     UPCA
MicroQR                   EAN13                    UPCE
SwissQRCode23             EANUCC128                Flattermarken
GS1DataMatrix             GS1-128
AustralianPost            PlanetCode12
DAFT                      RoyalMail
DPD                       PostNet5
JapanesePostal            PostNet9
KIX                       PostNet11
KoreanPostal              USPSIntelligentMail      USPSIMpb
GS1DataBar                GS1DataBarStacked
GS1DataBarStackedOmni     GS1DataBarLimited
GS1DataBarExpanded        GS1DataBarExpandedStacked
EAN8CCA                   EAN13CCA
UPCACCA                   UPCECCA
GS1-128CCA
GS1DataBarCCA             GS1DataBarStackedCCA
GS1DataBarStackedOmniCCA  GS1DataBarLimitedCCA
GS1DataBarExpandedCCA     GS1DataBarExpandedStackedCCA
MobileQRPhone             MobileSemaPhone
MobileQRSMS               MobileSemaSMS
MobileQRUrl               MobileSemaUrl