SmartScan Xpress™ Barcode v3 FAQ |
 |
| This page contains frequently asked questions regarding using the SmartScan Barcode control. |
| Q1: What is the difference between the 4 editions of the SmartScan Barcode product (Basic, Standard, Professional, Pro Plus DataMatrix)? |
| Q2: What barcode formats does the control read and write? |
| Q3: What are runtimes? How do I pay for them? |
| Q4: Does the ImagXpress control come with the Smartscan Xpress Barcode control? |
| Q5: What format does the image need to be in for the Smartscan Xpress Barcode control to process? |
| Q6: How can an image be loaded into the Smartscan Xpress Barcode control? |
| Q7: I am trying to analyze a non 1 bit per pixel image and am getting an error that says, "Invalid Picture Type, Only 1 bit images are supported." Why? |
| Q8: How do I distribute my application (in .NET, Delphi, VB etc.)? |
| Q9: What DLL's do I need to distribute with my application? |
| Q10: The data is not being correctly recognized by the SmartScan control. How can I resolve this? |
| Q11: How can I determine if I have the latest version of a Pegasus control? |
Q1: What is the difference between the 4 editions of the SmartScan Barcode product (Basic, Standard, Professional, Pro Plus DataMatrix)? |
| Please refer to the descriptions below: Smartscan Xpress Basic is designed for developers deploying a low speed scanning solution, such as a flat bed TWAIN scanner, or a lighter volume sheet fed scan solution. Smartscan Xpress Basic reads approximately 6 barcodes per second, anywhere on the page and at any angle. This version should only be used for low volume barcode applications. Please note: Only the Professional edition will read 2D PDF417. Smartscan Xpress Standard is designed for developers deploying a moderate speed scanning solution with up to a few barcodes per page. Smartscan Xpress Standard reads approximately 20 barcodes per second, anywhere on the page and at any angle. This version is intended for most document imaging barcode applications. Please note: Only the Professional edition will read 2D PDF417. Smartscan Xpress Professional is the unlimited speed barcode engine. It will read as fast as the processor can handle. It is engineered for high-end, high-volume imaging applications where speed is critical for the success of the application. Smartscan Xpress Professional reads and writes common 1D barcodes and reads 2D barcode PDF-417. It creates all three reading speeds, allowing integrators to sell various speed and price options. Smartscan Xpress Pro Plus DataMatrix includes all of the features of the Professional edition, plus 2D DataMatrix barcode reading capability. |
Q2: What barcode formats does the control read and write? |
| Please refer to the information on the following page: http://www.pegasusimaging.com/ssbarcodefeatures.htm |
Q3: What are runtimes? How do I pay for them? |
| Licensing requirements for SmartScan Xpress Barcode are documented on the licensing page. |
Q4: Does the ImagXpress control come with the Smartscan Xpress Barcode control? |
| No, it does not. ImagXpress can be purchased separately. Please refer to the link below for more information. http://www.pegasusimaging.com/imagxpress.htm A discount is offered if the ImagXpress control is purchased at the same time as the SmartScan Xpress Barcode control. It may also be purchased on the Upgrade page, and is offered at a special price. |
Q5: What format does the image need to be in for the Smartscan Xpress Barcode control to process? |
| The image needs to be in 1 bit per pixel format (a black and white image). Color depth conversion of images is trivial when using the ImagXpress control in your application. Please refer to the link listed below for more information on ImagXpress: http://www.pegasusimaging.com/imagxpress.htm |
Q6: How can an image be loaded into the Smartscan Xpress Barcode control? |
| The Smartscan Xpress Barcode control can accept images via a Picture, ClipBoard or hDIB. The ImageSource property is set based on how the image is being passed to the barcode control. |
Q7: I am trying to analyze a non 1 bit per pixel image and am getting an error that says, "Invalid Picture Type, Only 1 bit images are supported." Why? |
| The reason is that the image needs to be in 1 bit per pixel format (a black and white image). Color depth conversion of images is trivial when using the ImagXpress control in your application. Please refer to the link listed below for more information on ImagXpress: http://www.pegasusimaging.com/imagxpress.htm |
Q8: How do I distribute my application (in .NET, Delphi, VB etc.)? |
| PLEASE NOTE: You must have received unlock codes in order to distribute applications. These are received when the runtimes are purchased as mentioned in #3 above. 1) Add a declaration to the IntegratorKey method where your program starts up and pass the 4 unlock codes as the parameters to the method. 2) If you are using .NET as your development tool you must do # 1 AND call the UnlockPICSSXBarcode.PS_Unlock function and pass as the parameters the same 4 unlock codes that are passed as the parameters to the IntegratorKey method as mentioned in #1. Please refer to the code samples below for the specific .NET development environments: For C# Developers: Call the static PS_Unlock function in the class constructor BEFORE the generated call to InitializeComponent () as follows: Public FormMain() { UnlockPICSSXBarcode.PS_Unlock(1234, 1234, 1234, 1234); InitializeComponent(); } For Visual Basic. NET Developers: Call the static PS_Unlock function in the class constructor (i.e. New function) BEFORE the generated call to InitializeComponent () as follows: Public Sub New () MyBase.New () UnlockPICSSXBarcode.PS_Unlock(1234, 1234, 1234, 1234) IntializeComponent () End Sub 3) If you are using the Delphi VCL as your development tool you must do #1 and declare the PS_Unlock function as outlined below: procedure PS_Unlock(pw1, pw2, pw3, pw4: LongInt); stdcall external 'ssxbc30.dll'; begin Application.Initialize; PS_Unlock(123456789,123456789,987654321,12345); Application.CreateForm(TForm1, Form1); Application.Run; end. 4) If you are using the SmartScan Xpress Barcode control as a COM object in VB you must do#1 AND declare the PS_Unlock function as outlined below: a) Add a reference to the SmartScan Xpress Barcode control via Project|References. b) Declare the PS_Unlock function as follows: Private Declare Sub ControlUnlock Lib "ssxbc30" Alias "PS_Unlock" (ByVal pw1 As Long, ByVal pw2 As Long, ByVal pw3 As Long, ByVal pw4 As Long) c) Dim the SmartScan Xpress Barcode control object: Dim ss As SSXBC30Lib.SSbc d) Call the unlock method: ControlUnlock 1234, 1234, 1234, 1234 Set ss = New SSXBC30Lib.SSbc 5) If you are using the control within HTML you must obtain a web license string. This web license string is received from our sales department when the web license is purchased. The web license string is passed as the parameter to the IntegratorWeb method. Please refer to http://www.pegasusimaging.com/weblicfaq.htm for more information on using the control within a web environment. 6) If you are using the SmartScan Xpress Barcode ActiveX control open your project with your development tool (Visual Basic or Delphi) and rebuild the EXE. The new registration information will be automatically incorporated in the new executable. |
Q9: What DLL's do I need to distribute with my application? |
| For .NET Windows Forms Applications: PegasusImaging.WinForms.SSXBarcode3.dll For All Other Applications: Ssxbc30.dll SsbcLib30.dll Gd21b.dll Gs21d.dll Gsbar21b.dll Gpapi.dll If you are using the Smartscan Xpress Barcode COM component, it needs to be registered after it is installed. Make sure that your installation program registers the Smartscan Xpress Barcode COM component before you run your application. |
Q10: The data is not being correctly recognized by the SmartScan control. How can I resolve this? |
| If an image is being scanned with the SmartScan Xpress Barcode control and the results aren't satisfactory, please scan the image with the demo application that is shipped with the product. If the product was installed to the default location, the SmartScan Xpress demo can be found at: C:\Program Files\Pegasus Imaging\SmartScan Xpress Barcode\V3.0\Samples\ActiveX-COM\VB6\ReadBarcodeDemo If the results improve, please review the code for the demo and note any differences between the original project and the demo application. If the results of the scan are still unsatisfactory, please submit a support request to support@jpg.com and attach the image in a Zip file. |
Q11: How can I determine if I have the latest version of a Pegasus control? |
| Please download the PegConnect utility program from the following link: PegConnect |
