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.
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">
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