npZint plugin

About this plugin

This plugin for NeoBook allows you to generate and save into Bitmap images up to 82 barcode symbols. The plugin support dozens of 1D and 2D barcodes and you can generate it easily specifiying lot of general and specific symbols options.

The plugin provide you with actions to list the names of all available barcode symbols, generate barcodes and, optionally, set the appropiate options for that symbols. This plugin do not require any thirdparty library or DLL in order to work.

Thirparty

This plugin are imposible without the aid of this people:

Thanks a lot!

Plugin actions index

npZintCreate

This action creates a new instance of an Zint object. The result variable store the ID of the new Zint object. You can use this ID with other plugin actions.

↑↑

npZintDestroy

This action destruct a previously created Zint object instance. The result variable store "True" if every is OK, or "False" if not, for example, because no instance is found with the provided ID. The [LastError] variable contain information about the error.

↑↑

npZintDestroyAll

This action destruct all previously created Zint object instances.

↑↑

npZintBarcode

Generate a barcode with the specified options and save it to the specified Bitmap file. Specify the Bitmap file path in which the barcode must be saved. Specify the barcode symbol by their name (you can get it using the npZintBarcodes action). Specify the barcode data and, optionally, the barcode primary data (used optionally by some barcode symbols) and finally your desired width and height. Note this width and height can vary depending of the generated barcode.

Barcode Application identifiers must be indicated using brackets. Barcode symbols requires some specific data length, may allow digits or only alpha characters, etc. You need to know the appropiate barcode symbol specification in order to provide the appropiate barcode data and barcode primary data. It's something out of the scope of this plugin to refer in this help every barcode specification since this can be easily found in internet and probably anyone need to generate all the available barcodes, but generate the appropiate barcode in order to suit their own requeriments.

The result variable store "True" if everything is OK, or "False" if an error ocurr. On this last case the variable [LastError] store information about the error.

The supported barcode symbols list is:

↑↑

npZintBarcodes

Retrieve a list of names of all the supported barcode symbologies. The barcode variable store an NeoBook array with all barcode symbol names. The barcode count variable store the total count of symbols. Then is easy (for example) to fill a list with the available symbols using a code like this: 

npZintBarcodes "[Barcodes]" "[BarcodesCount]"
Loop "1" "[BarcodesCount]" "[I]"
  ListBoxAddItem "BarcodesListBox" "0" "[Barcodes[I]]"
EndLoop
SetVar "[BarcodesListBox]" "[Barcodes1]"

↑↑

npZintOptions

Set some general options to be used by all barcodes symbologies. You must execute this action before npZintBarcode in order to take effect. This option take effect on all barcode symbols: for specific options see the npZintOptionsEx action. Here is a list with the available options and the possible values:

The result variable store "True" if everything is OK, or "False" if an error ocurr. On this last case the variable [LastError] store information about the error.

↑↑

npZintOptionsEx

Set some specific options to be used only by some barcodes symbologies. You must execute this action before npZintBarcode in order to take effect. This option only take effect on the appropiate barcode symbols: for general options see the npZintOptions action. Here is a list with the available options and the possible values:

The result variable store "True" if everything is OK, or "False" if an error ocurr. On this last case the variable [LastError] store information about the error.

↑↑

Action errors subroutine

All the NeoPlugins deal with errors in the same way that NeoBook does: when the plugin found an action error the [LastError] variable store information about the error, so you can take care about this variable when execute an action.

But all the NeoPlugins also incorporate an advanced way to deal with possible action errors. You can define a subroutine named OnNeoPluginActionError in order to be executed when some action error are found and you can use this variables inside:

Note that this error handling subroutine are shared for all the NeoPlugins, so you no need to specify a subroutine for every plugin you use in your publication because the same subroutine are recognized and automagically used by every NeoPlugin. Below you can view a sample of this subroutine code: 

:OnNeoPluginActionError
  AlertBox "NeoPlugin Error" "Error [LastError] in plugin: [PluginName]"
Return

Also note that the use of this NeoPlugins error handling subroutine is completelly optional. You can continue using the [LastError] variable as usual and even use the both methods at the same time.

↑↑