Scanner User Manual
Contents
1. makes the KeyMessage workable when the Message Mode cannot be used By setting the appropriate KeyEvent setting which occurs when capturing 2D Barcode F15 you can see the Barcode content through the GetLastBarcode function private void OnKeyDown object sender System Windows Forms KeyEventArgs e if e KeyCode Keys F15 char temp new char 64 GetLastBarCode temp BarCode Text temp 4 3 Trigger Key Emulation In some circumstances it may be necessary to use a different key than the Trigger Keys located on both sides of the PDA In these cases activation of the Trigger Key emulation function is highly recommended e void TrigkeyDownEmu e void TrigkeyUpEmu The above indicated functions are created to switch program into a user s required operating mode After accomplishing this task you can press the Trigger Key on your PDA If there is a need to use the cursor key located at the center of your PDA as a trigger key you should add this function to the program as it is illustrated below private void OnKeyDown object sender System Windows Forms KeyEventArgs e Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 4 4 Barcode Setup To change or set up different setting for a particular Barcode Type modifications should be made through the control panel or choose a direct execution by activating the Scanner exe file Scanner Manual version 1 0 Metrologic Optimu2. K Oh Cheil Comtech Co Ltd Image File Prefix imc TEA Recycle Bin My K Oh Cheil Comtech Co Ltd Let Top Right Bottom fo fo 752 asa rig ReCapture Cur Save E nd B oar BRED 70 0m lt 2 TRE D 6 42 am 2 armam 7 03 an Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 3 Program Tutorial The principal task for the Scanner program is to detect when the Trigger Key has been activated and then send a trigger signal to scan the Barcode and decode When the decoder executes a task of decoding a barcode it works in accordance with the operation mode Most importantly it sends every decoded result to the application as a type of KeyStroke or Window Message designated for further processing 3 1 Library Preparation If there is no library it is reasonable to use the KeyStroke Mode function or employ WM_BARCODE_DATA In such cases the DLL is not required As soon as functions are used that support capturing a barcode the DLL is needed An illustration on how to use library is presented below an Select Project Add To Project gt Files Bie Got Mew foet Daed Duid Ted es CScankibTesvigp BHA cisse memb t Project Did Tools Window Help WIT i EE pL L sib testhee AN SeantibTesis IMCI000_85 Win f l as DiSconlibTest classes a 2 CBcanLibTesttpp MS CScanLibTestilg Select SharpEx lib is een okie Dan ay gt Create an Application named ScanLi
3. Metrologic OptimusPDA SDK 28 March 2007 Private Sub edtBarcode_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles edtBarcode KeyDown If e KeyCode Keys Up Or e KeyCode Keys Down Or e KeyCode Keys Left Or e KeyCode Keys Right Then TrigkeyDownEmu End If End Sub Private Sub edtBarcode_KeyUp ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles edtBarcode KeyUp If e KeyCode Keys Up Or e KeyCode Keys Down Or e KeyCode Keys Left Or e KeyCode Keys Right Then TrigkKeyUpEmu End If End Sub 5 4 Barcode Setup To change or set up different setting for a particular Barcode Type modifications should be made through the control panel or choose a direct execution by activating the Scanner exe file Private Sub Code39Enable_Click ByVal sender As System Object ByVal e As System EventArgs Handles Code39Enable Click SetBarcode 1 True End Sub Private Sub Code39Disable_Click ByVal sender As System Object ByVal e As System EventArgs Handles Code39Disable Click SetBarcode 1 False End Sub Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 6 Reference BOOL GeiLasiBarcode LPSTR Barcode Loading decoded result to the LPSTR pointer Parameter Barcode out sending a pointer that will receive a barcode Return If the scanner software is involved in processing data return is TRUE If the scanner software is not i
4. OnInitDialog omission SetOpMode RET_MESSAGE Change to MessageMode SetMessageWindow this gt m_hWnd Set Windows Target to Current Window omission e 3 If the scanner works in a proper way during decoding phase it sends a message WM_BAR_DECODED_DATA to the OnDecodeData Function in order to process received Barcode Data Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Adding a function to the header file Adding a message handler to the source code Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 3 4 Trigger Key Emulation In some circumstances it may be necessary to use a different key than the Trigger Keys located on both sides of the PDA In these cases activation of the Trigger Key emulation function is highly recommended e void TrigkeyDownEmu e void TrigkeyUpEmu The above indicated two functions are created to switch program into a user s required operating mode After accomplishing this task you can press the Trigger Key on your PDA If there is a need to use the cursor key located at the center of your PDA as a trigger key you should add this function to the program as it is illustrated below BOOL CScanLibTestDlg PreTranslateMessage MSG pMsg if pMsg gt message WM_KEYDOWN if O9Msg gt wParam VK_UP pMsg gt wParam VK_DOWN pMsg gt wParam VK_LEFT When Pressed Cursor Key pMsg
5. gt wParam VK_RIGHT TrigkeyDownEmu else if pMsg gt message WM_KEYUP if OMsg gt wParam VK_UP pMsg gt wParam VK_DOWN pMsg gt wParam VK_LEFT When Released Cursor Key pMsg gt wParam VK_RIGHT TrigkeyUpEmu return CDialog PreTranslateMessage pMsg Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 3 5 Barcode Setup The Barcode Type selection can be done from the Control Panel However it is also possible to send a direct request to the Scanner exe file to set the Barcode Type void CScanLibTestDlg OnButtonCode39Enable SetBarcode BAR_CODE39 TRUE void CScanLibTestDlg OnButtonCode39Disable SetBarcode BAR_CODE39 FALSE Bar Code Type BAR_PDF417 BAR_CODE39 BAR_CODABAR BAR_CODE128 BAR_DISCRETE2OF5 BAR_INTERLEAVED2OF5 BAR_CODE93 BAR_UPC_A BAR_UPC_EO BAR_EAN8 BAR_EAN13 BAR_MSIPLESSY BAR_EAN128 BAR_UPC_E1 BARCODE_NUMBER BAR_NONE BAR_REGONLY ON oOoaRWND O Ww WO i ss 4 oma KRWNY CO Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 4 C Program Tutorial Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 4 1 Library Preparation Show All files Now Project has SharpEx lib After activating library the source code will be shown Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 private static extern bool SetOpMode int OpMo
6. it can also be used with other barcode scan engines as well Moreover in case when an application program is based on the Scanner Program it can be used in other working environments Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 1 2 Operation Introductory 1 2 1 KeyStroke Mode The KeyStroke Mode allows scanning without the need to use an additional application Scanning information is displayed in the Editbox when the Scanner exe decodes a barcode using the activated edit control tool The Editbox allows decoded barcode data to be observed When use KeyStroke Mode Barcode Reader Scanner exe KeyStroke Mode Focused Editbox ScanedBarcodeData Target Window NULL Your Application Barcode Results Keyln to Edit Control Scanner Manual version 1 0 Metrologic OptimusPDA SDK 1 2 2 Message Mode 28 March 2007 Message Mode decodes barcodes using Scanner exe and sends a message such as WM_BAR_DECODED_DATA to the application that is being used Therefore decoded data is directly processed by the application It is recommended to set up a Window Handle which will receive the data When use Message Mode Barcode Reader Scanner exe KeyStroke Mode Target Window NULL InnoLDC_SetMessageMode Require to Set MessageMode Your Application Scanner Manual version 1 0 Barcode Reader Scanner exe Message Mode Target Window NULL Register Applica
7. Metrologic OptimusPDA SDK 28 March 2007 Scanner User Manual Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Contents 1 Introduction O O O O 1 1 Scanner Program 1 2 Operation Introductory 1 2 1 Keystroke Mode 1 2 2 Message Mode 2 Options O O O O O O O 2 1 Display Tray Icon 2 2 Setting Gun Mode 2 3 Running and Stopping Scanner 2 4 Barcode Setup 2 5 Character String Options 2 6 Image Capture 2 7 Image Setup 3 Program Tutorial O O O O O 3 1 Library Preparation 3 2 Barcode Reading in the Keystroke Mode 3 3 Barcode Reading in the Message Mode 3 4 Trigger Key Emulation 3 5 Barcode Setup 4 C Program Tutorial O O O O 4 1 Library Preparation 4 2 Barcode Reading in Keystroke Mode 4 3 Trigger Key Emulation 4 4 Barcode Setup 5 Visual Basic Net Program Tutorial O O O O 5 1 Library Preparation 5 2 Barcode Reading in Keystroke Mode 5 3 Trigger Key Emulation 5 4 Barcode Setup 6 Reference Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 1 Introduction 1 1 Scanner Program The OptimusPDA is available with 3 different scan engines 1D laser 1D CMOS and 2D Imager The scanner program works with different types of decoder modules and is compatible with all three barcode scan engines available If a developed application is supported by the Scanner Program then
8. appropriate KeyEvent setting which occurs when capturing 2D Barcode F15 you can see the Barcode content through the GetLastBarcode function Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 5 3 Trigger Key Emulation In some circumstances it may be necessary to use a different key than the Trigger Keys located on both sides of the PDA In these cases activation of the Trigger Key emulation function is highly recommended Below specified functions are created to switch the program into an operating mode required by a user After choosing relevant function you can press the Trigger Key located on your PDA e void TrigkeyDownEmu e void TrigkeyUpEmu If there is a need to employ the cursor key located at the center of OptimusPDA as a trigger key you should use the following function of the program Private Sub Form1_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles MyBase KeyDown If e KeyCode Keys Up Or e KeyCode Keys Down Or e KeyCode Keys Left Or e KeyCode Keys Right Then TrigkeyDownEmu End If End Sub Private Sub Form1_KeyUp ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles MyBase KeyUp If e KeyCode Keys Up Or e KeyCode Keys Down Or e KeyCode Keys Left Or e KeyCode Keys Right Then TrigkKeyUpEmu End If End Sub Scanner Manual version 1 0
9. bTest TE S L ST S ingens Scant test J pconubiesizjMcsuuu us xjwiasz Workspace ScanLibTest 1 pr E ScanlibTest files C Source Files CJ Header Files C Resource Files Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 include BarcodeTypeHHP h include BarcodeTypelntermac h include BarcodeTypeSymbol h include SharpEx h Use SharpEx Lib After opening the library a header file should be added as in the above source code 3 2 Barcode Reading in Keystroke Mode A program assigned to the Focus in the Editbox decodes a barcode and forwards the Barcode Data to the Editbox Highlights on the source code in the KeyStroke Mode 1 To switch KeyStroke Mode on SetOpMode RET _KEYSTROKE 2 As soon as the PDA s Scan Trigger key is being pressed F20 key value is inputted to the O S Now a SetFocus can be specified for the Editbox where a PreTranslateMessage MSG pMsg is stored BOOL CScanLibTestDlg PreTranslateMessage MSG pMsg if pMsg gt message WM_KEYDOWN if pMsg gt wParam VK_F20 When Trigger Key Pressed CEdit edtBarcode CEdit GetDlgltem IDC_EDIT_BARCODE edtBarcode gt SetFocus return CDialog PreTranslateMessage pMsg Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Transfer of readings with regard to 2D barcode working under the KeyStroke Mode IT50x0 only The 2D barcode conte
10. de Dlllmport SharpEx dll private static extern bool GetLastBarcode char Buffer Dlllmport SharpEx dll private static extern void TrigkKeyUpEmu Dlllmport SharpEx dll private static extern void TrigkKeyDownEmu Dlllmport SharpEx dll private static extern bool setBarCode int Type bool bEnable 4 2 Barcode Reading in Keystroke Mode In cases when the application runs under the Focus status in the Editbox and without selection of any specific coding program it will decode a barcode by default to display Barcode Data in the Editbox Highlights on the source code in the KeyStroke Mode 1 To switch KeyStroke Mode on SetOpMode 0 2 When Scan Trigger key of the PDA is pressed F20 Key value will be inputted to the O S Now SetFocus can be specified in the Editbox where OnKeyDown object sender System Windows Forms KeyEventArgse should be located private void OnKeyDown object sender System Windows Forms KeyEventArgs e if e KeyCode Keys F20 edtBarcode Focus edtBarcode SelectAll Transfer of readings with regard to 2D barcode working in KeyStroke mode IT40x0 only Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Usually 2D barcode content contains character string along with BinaryData The 2D barcode content includes a character string and it is important that the BinaryData is assigned to the character strings There is an alternative option that
11. es can be made in the following location Setting gt Barcode gt Barcode Tab Choose a barcode type you want to use 2 5 Character String Options While decoding the Barcode in KeyStroke Mode the output can have a character string added Below are the options None After barcode output no input Carriage Return Enter Carriage Return input after barcode input Tab After displayed barcode character string output input a tab Prefix String Character string is displayed before the Barcode Data Suffix String Character string follows the Barcode Data EX Prefix String gt Setting Suffix String gt Setting Barcode Data When character string is 88073670649 output data will display 88073670649 Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 2 6 Image Capture K Oh Cheil Comtech Co Ltd evice Modem Decode Only Image amp Decode Image Only Recapture Trig ReCapture Cur Save E nd GunMode Trigger Off a ED 4 Decode Only Image amp Decode Image Only Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 2 7 Image Setup Save to Path lmagefilePrefix jpg Ex Storage system scanner lmageprefix IMG Version General Barcode String Img Captured image is saved to Storage system scanner IMGjpg Image Reverse Path Storage system scanner E o t _ Show Image at Bottom
12. he Focus status in the Editbox and without selection of any specific decoding program it will decode a barcode by default to display Barcode Data in the Editbox Highlights on the source code in the KeyStroke Mode 1 To switch KeyStroke Mode on SetOpMode RET_KEYSTROKE 2 When Scan Trigger key of the PDA is pressed F20 Key value will be inputted to the O S Then you can specify a SetFocus in the Editbox where Form1_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles MyBase KeyDown and edtBarcode_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles edtBarcode KeyDown should be located Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Private Sub Form1_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles MyBase KeyDown If e KeyCode Keys F20 Then edtBarcode Focus edtBarcode SelectAll End If End Sub Private Sub edtBarcode_KeyDown ByVal sender As Object ByVal e As System Windows Forms KeyEventArgs Handles edtBarcode KeyDown If e KeyCode Keys F20 Then edtBarcode Focus edtBarcode SelectAll End If End Sub Transfer of readings with regard to 2D barcode working in KeyStroke mode IT40x0 Only Any 2D barcode s contents contain a string of characters associated with BinaryData There is an alternative option that makes the KeyMessage workable when the Message Mode cannot be used By setting the
13. ld be selected depending on its compatibility to the certain barcode type Return If the scanner software is involved in processing data returns is TRUE If the scanner software is not involved in processing data return is FALSE Scanner Manual version 1 0
14. nt includes a character string and it is important that the BinaryData is assigned to the character strings There is an alternative option that makes the KeyMessage workable when the Message Mode cannot be used By setting the appropriate KeyEvent setting which occurs when capturing 2D Barcode F15 you can see the Barcode content through the GetLastBarcode function BOOL CScanLibTestDlg PreTranslateMessage MSG pMsg if pMsg gt message WM_KEYDOWN if pMsg gt wParam VK_F15 When Decoded 2D Barcode TCHAR Temp 64 GetLastBarcode Temp Get 2D Barcode AfxMessageBox Temp return CDialog PreTranslateMessage pMsg Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 3 3 Barcode Reading in Message Mode The executable file scanner exe that decodes Barcode allows sending information WM_BAR_DECODED_DATA to the application as well as receiving a direct response The Window Handle which is responsible for receiving messages must be identified in a proper way so the beam will work effectively in order to decode a Barcode Explanatory tips for the source code in the Message Mode e 1 The function for changing the Message Mode is SetOpMode RET_MESSAGE e 2 When you are working in the Message Mode you should assign the Window Handle to the application Notice Beam does not work unless Window Handle is being assigned SetMessageWindow this gt m_hWnd BOOL CScanLibTestDlg
15. nvolved in processing data return is FALSE BOOL SetOpMode int OpMode Decode mode change Parameter OpMode RET_KEYSTROKE Switch to the KeyStroke Mode RET_ MESSAGE Switch to the Message Mode Return If the scanner software is involved in processing data return is TRUE If the scanner software is not involved in processing data return is FALSE Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 void TrigKeyDownEmu Emulation when the side Trigger Key is being pressed void TrigkKeyUpEmu Emulation when the side Trigger Key is being released BOOL SetMessageWindow HWND wnd Parameter wnd Transfer result from the handle to the window that processes the barcode data Return If the scanner software is involved in processing data return is TRUE If the scanner software is not involved in processing data return is FALSE BOOL SetBarcode int Type BOOL bEnable Parameter Type Select a barcode you wish to setup A barcode has several types that enable decoding Depending on decoder s program you should refer to the relevant file header that corresponds to it File headers are classified by decoder according to the following types e BarcodeTypeHHP h HHP IT50x0 e BarcodeTypeSymbol h Symbol SE955 SE923 SE923HS e BarcodeTypelntermac EV15 Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 Decide which option Barcode Enable or Barcode Disable shou
16. sPDA SDK 28 March 2007 5 Visual Basic Net Program Tutorial 5 1 Library Preparation a ze sae on On st 0n RS aH aa pnts KEAN j OU RSAS OVEN 6 59280 Spt oh tenen pias Create an Application named ScanLibTest a i PEE E EEEE ENE UE EESE E EE DB LEE eee eee Gee eo is pane PL eet it ey x eos 5y aa tat Sy cad BS A BETE Eog j ai onno cs 2 Anvembivinne cs Fonpise i Forstics Shame ii Show All files LOSS CORTI ERE Jia gals et senate ear ere S SP Scant Eo pirg be j Sane a BTA SSRENE fo ooa GP Scaotiot jd BAD lS B Cki gt SB ELRO po ox i Aasemalytvy Include Project as trp a Now Project has SharpEx lib For included library the following source code should be applied Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 lt DIillmport SharpEx dll gt _ Public Shared Function SetOpMode ByVal OpMode As Int32 As Boolean End Function lt Dillmport SharpEx dll gt _ Public Shared Function GetLastBarcode ByVal buffer As Char As Boolean End Function lt DIllmport SharpEx dll gt _ Public Shared Sub TrigkKeyUpEmu End Sub lt DIillmport SharpEx dll gt _ Public Shared Sub TrigkKeyDownEmu End Sub lt Dillmport SharpEx dll gt _ Public Shared Function SetBarcode ByVal Type As Int32 ByVal bEnable As Boolean As Boolean End Function 5 2 Barcode Reading in Keystroke Mode When the application is under t
17. tion s Windows Handle Your Application InnoLDC_SetMessageWindow HWND wnd You may get barcode when barcode readed Barcode Reader Message Mode Target Window YourApps Your Application WM_BAR_DECODED_DATA Metrologic OptimusPDA SDK 28 March 2007 2 Options 2 1 Display Tray Icon Quick access to the file Scanner exe performance can be achieved by placing the Tray Icon in the taskbar To display this Tray Icon Select the Start Tab gt Settings gt Control Panel gt Barcode General Barcode String Ima g a Z Control Mode Key Stroke wera Modem Message i _ Show Gun Mode Menu g P Set GunMode when startup 2 Recycle Bin Display Tray Icon Decode Only d Image amp Decode Fast KeyStrokeiMode Image Only Running Mode qeg Multiscan Mode Use Scanner Controller aki R Show Barcode Info C Not Use gt Ws Set To KeyStroke Mode C Simple Menu Mode aa Transfer AIM dhde peer Show Image Trigger Off After marking the checkbox and clicking the OK button the program will put the Tray Icon in the taskbar at the bottom of the screen Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 2 2 Setting Gun Mode When the Gun Mode is set up only the PDA s Gun trigger can to be used for scanning Please note that with Gun Mode activated the ActiveSync application becomes inactive G
18. un Mode would need to be disable again to use the OptimusPDA with ActiveSync Setting the Gun Mode In the Barcode setting in Control Panel tick the Use Gun Mode option and then press the OK button When you click the barcode Tray Icon select Gun Mode the Tray Icon then toggles ia gt iy Version General Barcode String Img Control Mode Key Stroke C Message Show Gun Mode Menu 2 Decode Only _ Set GunMode whe meas Image amp Decode ecycle Bin Display Tray Icon a Image Only MultiScan Mode _ Fast KeyStroke M de Show Barcode Info Running Mode Internet Set To KeyStroke Mode Use Scanner Contfoller Explorer O Not Use gt Show Image C Simple Menu Mode af Microsoft GunMode Transfer AIM Code WordPad Trigger Off 23 ea 12 gt 9 ix fa D 6 31 aM 2 Sim 6 32 am Scanner Manual version 1 0 Metrologic OptimusPDA SDK 28 March 2007 2 3 Running and stopping the scanner To run or stop the scanner program use the Barcode Setting window according to the following methods Scan Run Settings gt Barcode gt General Tab Click Exit Scanner Button Scan Stop Settings gt Barcode gt General Tab Click Run Scanner Button Scanner program should be used only with regard to specific purposes there is no need to keep stopping and running the scanner program 2 4 Barcode Setup Setting can be changed for individual barcodes These chang
Download Pdf Manuals
Related Search