Impact Reference Guide Publication # 843-0093 (Rev 11.1.
Disclaimer Datalogic Automation Inc. makes no representations or warranties for merchantability or fitness for any particular purpose, regarding Datalogic’s software or hardware. Datalogic Automation Inc. shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this publication or its contents. Datalogic Automation Inc.
T A B L E O F C O N T E N T S Introduction Manual Contents ..................................................................... Intro-1 Chapter 1: Installation and Setup Help .............................................................................................. 1-1 System Requirements for the A, T, and C-Series ........................ 1-1 System Requirements for the M-Series........................................ 1-2 Installation ................................................................
Table of Contents Impact Reference Guide Gaussian Filter .................................................................... 3-44 Image Math.......................................................................... 3-45 Light Leveling ...................................................................... 3-47 Linear Morphology Open ..................................................... 3-49 Linear Morphology Close..................................................... 3-50 Median Filter ....................
Impact Reference Guide Table of Contents Adaptive Template ............................................................ 3-145 Average Intensity............................................................... 3-146 Blob ................................................................................... 3-147 Bump Find ......................................................................... 3-147 Color Blob.......................................................................... 3-149 Contrast ............
Table of Contents Impact Reference Guide Chapter 4: Control Panel Manager Introduction ................................................................................... 4-1 Help .............................................................................................. 4-1 Starting CPM ................................................................................ 4-1 CPM - An Overview ...................................................................... 4-1 CPM User Interface .....................
Impact Reference Guide Table of Contents Scrolling Table..................................................................... 4-91 Tab ...................................................................................... 4-94 Tab Group ........................................................................... 4-95 Text Display......................................................................... 4-96 XBar-R Chart ....................................................................... 4-98 XML Table .
Table of Contents Impact Reference Guide Display a string in the title bar and in the About dialog........ 6-25 Set the amount of memory to be allocated .......................... 6-26 Modbus TCP/IP Client Tester ..................................................... 6-27 TCP/IP Settings .......................................................................... 6-28 HTTP Commands ....................................................................... 6-29 PC to Device - Direct Connection ..................
Introduction Thank you for purchasing a Datalogic Impact machine vision system. Please read the instructions in this document before starting your system setup. The machine vision system is flexible, compact, and configurable. This manual documents the Impact programs which you use to configure the Datalogic Impact device and view the data collected from your inspections. There are two main programs: Vision Program Manager and Control Panel Manager.
Introduction Impact Reference Guide mand line parameters, and TCP/IP settings for the device. The Emulator allows you to create and test vision programs without device hardware. Datalogic Automation Inc.
C H A P T E R 1 Installation and Setup This chapter discusses installing and starting Impact software. It also provides an overview of Impact software programs. NOTE: This manual covers the entire line of Datalogic Impact devices and cameras. Sections that apply to a specific models will be indicated. Impact software is a set of graphical tools used to configure the hardware and inspection tasks.
System Requirements for the M-Series Impact Reference Guide System Requirements for the M-Series Requirements for the M-Series Processor • Monitor display resolution of 1024 x 768 or greater (for local M-Series programming) • Keyboard and Mouse (for local M-Series programming) • If you are connecting to a device or camera, the processor must have the same version of Impact software installed.
Impact Reference Guide Client to device cable connection Client to device cable connection This section applies only to the A, T, and C-Series. You need to connect an Ethernet cable between the client PC and the Impact device or camera’s Ethernet port to communicate with the device or camera in VPM. Refer to the device or camera’s hardware manual for connector locations. IP Address Configuration This section applies only to the A, T, and C-Series.
Configuring the Impact Device or Camera Impact Reference Guide 1. Start VPM. When the “Select a Device to Connect to” dialog is displayed, click on the desired device or camera in the list of Devices found. If the device or camera is not in the list, be sure the device or camera power is on and that it is connected to the client computer, then click the Refresh button. 2. Click the Edit IP Address button at the bottom of the dialog. 3.
Impact Reference Guide Configuring the Client 5. When the warning dialog is displayed, click OK. After the change is complete, the device or camera reboots. 6. Click OK when the Device is Rebooting dialog is displayed. Configuring the Client This section applies only to the A, T, and C-Series. You may need to change the client computer’s mask and address to match the desired device or camera IP Address. Be sure the client computer and device or camera are directly connected with an Ethernet cable.
Connect to an Impact device, camera, or Emulator Impact Reference Guide When VPM is already connected to one or more devices, cameras, or Emulators To disconnect from a device, camera, or Emulator so you can connect to a different device, click the Connect button in the VPM toolbar. After the disconnection is complete, click the Connect button again to connect to make another connection. See “To choose a device, camera, or Emulator connection:” on page 1-6.
Impact Reference Guide Camera Setup • Edit IP Address... To change the IP address of the selected device, click this button. See “Changing the IP Address through the Device Setup tab.” on page 2-3. 3. When the connection has been made, you may see a message that VPM is reading from the newly connected device or camera. NOTE for Datalogic M-Series: We recommend that you do NOT edit vision programs or control panels on one camera while any other cameras on the same M-Series processor are online.
Camera Calibration Impact Reference Guide 5. Click the Live button. If you do not see the image or object in the image window, adjust the camera focus, image gain, shutter open time, and strobe length until a clear, well defined image is displayed. See “Camera” on page 2-16 for more details about how each of the settings affects the image. 6. You may need to move the camera toward or away from the object until it fills most of the camera’s field of view. You can now calibrate the camera if desired.
C H A P T E R 2 Settings Tab Introduction The Settings Tab is used to configure the Datalogic Impact device or camera, including its Internet Protocol (IP) Address, inputs, and outputs. This chapter explains the VPM Settings Tab and reviews the cameras you can use with Impact software, including details of proper setup and calibration on the client computer, and lighting adjustments. Help If you need help while using the Impact software, you can refer to this manual or the online help.
General Impact Reference Guide Input Name What it is Device Comment A comment about the device or camera. For example, Inspects Bearing Diameter. This comment appears in the Device Connection dialog. Task Timeout See “Enable Timeout” on page 2-6. Output Name What it is System Time The current time (the number of seconds elapsed since January 1, 1970). You can use the Basic tool to manipulate and format this value. For example, see “FORMATDATE” on page 5-14.
Impact Reference Guide General camera on a particular network. The IP Address must be unique to each device if there is more than one on a network. (For a detailed discussion of network configurations see page 6-28.) Note: Do not attempt to change the IP Address or Mask without the authorization of your network administrator; doing so could disrupt your network connection. To be able to communicate with the device, a client computer’s IP Mask and Address must be configured correctly.
General Impact Reference Guide 6. Click OK to close all the open dialog windows. Changing the M-Series Processor’s IP Address (Windows 7) IMPORTANT NOTE: Change only the Local Area Connection named LAN1 or LAN2. These correspond to Ethernet Ports 1 and 2 on the front of the processor. DO NOT change any of the other connections. Changing any other connection can cause the M-Series cameras to stop functioning. 1. In the Start menu, click on Control Panel. 2.
Impact Reference Guide General 5. In the list of items, select Internet Protocol Version 4 (TCP/IPv4), then click Properties. 6. Select Use the following IP address. 7. Enter the desired IP address. 8. Click OK to close all the open dialog windows. Changing the device or camera’s Mask and Address (A, T, and C-Series) To change the device or camera’s IP Mask and Address, you must know the current IP Address and Mask so you can configure the client correctly.
General Impact Reference Guide 3. When the connection has been made, click the General System Object, click the Setup tab, then click the General radio button. Enter the new IP Mask and/or IP Address in the appropriate field(s). Record the new value (along with the serial number) and store it where you can find it again. 4. Click the Diagnostics radio button, then click the Reboot device button. You must reboot to make the changes take effect in the device or camera.
Impact Reference Guide General If the task’s Trigger Event type is set to "Image In Event," the time starts when the camera trigger is complete, not at the beginning of task execution. For all other Trigger Event settings, the time starts when task execution begins. The timing accuracy depends on the tools in the task, but it is generally accurate to within a few milliseconds.
General Impact Reference Guide To copy settings files from one device to another 1. Connect to the source device (where you are copying from). 2. Click the Settings Tab - General - Setup - General panel 3. In the Settings Files group, select the Device Settings Only radio button. 4. Click Backup. 5. Disconnect from the source device. 6. Connect to the destination device (where you are copying to). 7. Click the Settings Tab - General - Setup - General panel 8.
Impact Reference Guide General NOTE: The M-Series Cameras support Delay Debounce on the Trigger input (Frame Trigger on Line Scan camera). The M-Series Cameras do not support Holdoff Debounce on the Trigger or Frame Trigger, only Delay Debounce. The M-Series Line Scan Camera does not support any Debounce setting on the Line Trigger. The M-Series Processor does not support any Debounce setting on Event Inputs. Third-party cameras have varying Delay and Holdoff Input Debounce settings.
General Impact Reference Guide one-way, the input port number cannot be the same on both devices. See page 3-201 for more details about the TCP/IP Out tool and how to set up TCP/IP communications. See page 3-37 for details about the TCP/IP Input Event. Click the Edit button to change or delete the hex-value delimiter characters that indicate the end of a data string. In the Create Delimiter Sequence dialog, select a character from the list, then click Append, or click Clear to delete the delimiter.
Impact Reference Guide General Click a button to turn the indicated output on and off. The indicator is green when the output is on. Strobes Use this function to test your strobe outputs. When you click a strobe button, the corresponding output will pulse for 30 microseconds. Options I/O Polling Rate Enter a number from 50 to 10,000 milliseconds. VPM polls the Datalogic Impact device at this rate and updates all the indicators on the Diagnostics tab.
General Impact Reference Guide • Calibration Editor - When you save images in VPM, the lens calibration information is stored with them. You can edit the calibration values, or copy that information to other image files. • Memory Meter - This utility displays the current memory usage for a device. The amount of available memory shown is not updated while the device is online. • TCP Tester - This utility emulates a device to test Ethernet between the client and Datalogic Impact devices.
Impact Reference Guide General Administration Panel NOTE: Access to this tab is limited to users with an Administrator access level. Some options are unavailable while the device is online. I m pa c t D e v i c e S e c u r i t y O v e r v i e w Impact device security resides in each device. (Control panel applications and vision programs can be password protected separately. See “Vision Program Security” on page 3-32 and “CPM Security” on page 4-2.
General Impact Reference Guide 5. Enter the same password again in the Confirm Password field. Asterisks are displayed for the password. 6. If you want the user’s password to expire after a fixed time period, check the Number of days before password expires check box and enter the number of days. Administrator level passwords never expire. 7. If you want anyone (including Administrators) to be able to change this password, check the Can Change Password check box. 8. Click the OK button.
Impact Reference Guide General 1. Click the Connect button, select a device from the Device Selection list, then click OK. 2. When the User Logon dialog is displayed, click Change Password. 3. Enter the User ID and the Old Password for that User ID. 4. Enter the New Password and type the same password in the Confirm Password field. 5. Click Log On. Client Directory The Client directory contains all of the files used by the Impact software.
Camera Impact Reference Guide Camera The Camera system object accesses and sets some of the Impact camera’s parameters. NOTES: The range of acceptable values for each input is determined by the camera type. Changing any of these properties while the camera is being triggered and acquiring images can cause the images to be corrupted. The camera should be offline or triggers should be stopped while these properties are being changed.
Impact Reference Guide Camera Input Name What it is Units Per Pixel Units per Pixel is the scale factor for converting measurements in the image to "real-world" units. See “Calibrate Manually” on page 2-29 for details.
Camera Impact Reference Guide Setup Panel Snap Click the Snap button to acquire and display an image in the image window. You can use this to see how camera settings affect the image, or to position objects within the camera’s field of view. The acquired image is also displayed in the image display area of the Design and Display tabs. Live Click the Live button to continuously acquire images and display images in the image window until you click the Snap or Live buttons.
Impact Reference Guide Camera NOTE: Some third-party cameras do not have a Strobe Pulse Length setting. The strobe trigger pulse width coincides with the camera shutter speed open time setting so that it turns on when the exposure starts (shutter opens) and turns off when the exposure ends (shutter closes). Line scan cameras do not have a strobe output. Advanced Button Strobe Trigger Select the type of trigger that the strobe you are using requires.
Camera Impact Reference Guide a) If the Auto-trigger When Online check box is checked, automatic triggers will start when the device goes Online and stop when it goes Offline. The Start/Stop Auto-trigger button is disabled. No other Start/Stop control is available. b) If the Auto-trigger When Online check box is NOT checked, the device must be Online to enable the Start/Stop Auto-trigger button.
Impact Reference Guide Camera tion speed. The range of acceptable values is determined by the camera type. If you want to use partial scanning on an image, you should calibrate the entire image first and then set the partial scan parameters. For partial scan images, the image coordinates of 0,0 correspond to the sensor pixel coordinates 0,0. This means that, when the image is partially scanned from the left or top, the upper left image pixel coordinate becomes the top left partial scan setting.
Camera Impact Reference Guide Datalogic’s color cameras have two stages of gain, the overall gain (set with the Gain slider on the General tab), and a gain for the red and blue pixels. When you click the Auto button, the average value is calculated for the red, green, and blue pixels. The red gain is computed as the average green pixel value divided by the average red pixel value. The blue gain is computed as the average green pixel value divided by the average blue pixel value.
Impact Reference Guide Camera This mode’s operation is the same as Continuous while Frame Trigger High mode, except that the frame trigger polarity is reversed. Continuous while Online In this mode, the frame trigger signal is not used. Scan Lines are acquired as long as the camera is online. Hardware line triggers must be provided on the camera’s Line Trigger input. When the current image fills with scan lines, image acquisition is complete and the next image starts with the next line trigger.
Camera Impact Reference Guide It is important to understand the scan direction of the Dalsa line scan camera. The camera has a two-line sensor capable of TDI (Time Delay Integration). An image row is exposed with one line of the sensor, then shifted and exposed again with the other line of the sensor, while the next row of the image is being exposed in the first sensor line. This doubles the net exposure time without slowing the line rate.
Impact Reference Guide Camera Because the maximum trigger input rate of the Line Scan camera is 20 MHz, which is faster than the camera’s number of lines per second acquisition rate, an internal frequency converter can be configured that will scale the line trigger input rate up or down to create fractional scale factors. This way you can match the x and y resolutions without modifying the encoder frequency. The Frequency Convertor setting can be used with any of the three Line Trigger types.
Camera Impact Reference Guide When Test Image mode is enabled, and you click the snap button, the test image selected in the Test Images drop down is displayed in the image window. Test images are stored in the camera. Internal Correction If Enable Correction box is checked, the camera’s internal correction for gain and offset is used. You select the desired correction set from the drop-down. This field is disabled for some camera types.
Impact Reference Guide Camera x' = a*x*x + b*y*y + c*x*y + d*x + e*y + f y' = g*x*x + h*y*y + i*x*y + j*x + k*y + l Because there are six coefficients to be computed in each equation, a minimum of six dots must be present in each quadrant of the image to successfully compute the mapping. If more than six dots are present, they are all used to compute a best fit mapping. Larger dots provide a more accurate calibration because the dot centers can be more accurately located.
Camera Impact Reference Guide The type of camera currently acquiring images. Frames per Second This field indicates the number of frames the device can capture and process per second. It is calculated based on the current Shutter Open Time, Partial Scan line and Half Resolution Mode settings. Calibrate Click this button to calibrate the camera when the desired image is displayed in the image window. You can use the Snap button or Load Image button to display the image.
Impact Reference Guide Camera 4. Move the target that the center of the image you use corresponds to the center of the lens (optical axis) as much as possible. (The yellow crosshairs indicate the center of the FOV.) When the target is placed correctly, focus the camera so that the target dots are clear and sharp. Sample Calibration Image 5. Click the Snap button. 6. Type the dot pitch measurement into the Target Pitch (units) field.
Camera Impact Reference Guide 2. Enter the Units per Pixel value in the Manual Settings group. Units per Pixel is the scale factor for converting measurements in the image to "real-world" units. For example, if an object measures 100 millimeters and the image resolution of that object is 640 pixels, the Units per Pixel value is 100 divided by 640 = 0.156 (or 0.156 mm per pixel). 3. Choose either Disable Lens Distortion Calibration or Keep Current Lens Distortion Calibration.
Impact Reference Guide Camera To calibrate from polygon points 1. Select From Polygon Points from the Calibrate drop-down. 2. A polygon ROI is placed on the image in the image window. Select the polygon and move it so Point 1 is centered over one of the calibration points. 3. Select and move each of the other polygon vertices to align them with the desired calibration points. The Polygon Points values are automatically updated in the Point Settings table.
Camera Impact Reference Guide • Real World Points: The "real-world" location (in X and Y coordinates) corresponding to each Polygon Point should be entered. Double-click on a field to edit it. Click the appropriate button to Append, Insert, or Delete a Real World point. Calibrate From Entered Points Use this option when it is difficult to calibrate with a target or when the inspected image contains perspective distortion and you need to manually enter the pixel grid points for the calibration.
Impact Reference Guide Camera 4. Click the Calibrate button. Entered Point 2 Entered Point 3 X value increases Entered Point 1 Entered Point 4 Y value increases Entered Point 6 Image Window Entered Point 5 Calibrate From Entered Points Image (Points marked for illustration only) Point Settings • Entered Points: The X and Y coordinates of each Entered Point. The points are NOT marked on the image. • Real World Points: The "real-world" location (in X and Y coordinates) of each Entered Point.
File Camera Impact Reference Guide • Line Points: The X and Y beginning and ending coordinates of the measurement line are indicated. • Real World Length: The length of the calibration line in real units.
Impact Reference Guide System Log When File Camera mode is enabled, the device will not acquire images with a camera, but it will use the images in the RAM Images Active list as though they were acquired live. To enable File Camera mode, click the File Camera/Camera button. See “File Camera or Camera” on page 3-11. Available File Images The images listed in the Available list are stored in the device’s compact flash and are available to be copied to the Active Images list.
File Manager Impact Reference Guide S y s t e m L o g P r o p e r t i e s Ta b Input Name What it is Log Entry The most recent log event S y s t e m L o g S e t u p Ta b NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is online. Archive Log On A-Series, C-Series, and T-Series Impact cameras, the System Log is stored on the camera.
Impact Reference Guide File Manager F i l e M a n a g e r P r o p e r t i e s Ta b Input Name What it is Display Tab Program Filter Programs that contain this name appear on the Display tab’s File Load drop down list. (See “Vision Program Load” on page 3-27.
File Manager Impact Reference Guide • VisionPrograms: Datalogic and user-created vision programs • Web folder: U-defined files that can be accessed with a web browser. To access the files in the Web folder with a browser 1. Open a web browser. 2. In the Address field, type http://123.123.123.123/file/ where 123.123.123.123 is the IP address of the Impact device. 3. Press Enter. If there is a file in the folder named index.htm or default.htm, the browser will automatically display it.
Impact Reference Guide Modbus TCP/IP Server To restore vision program files from the client to the Impact device: 1. Connect to the desired device. 2. Click Settings Tab - File Manager - Setup. 3. Open the folder on the client drive that contains the file to be restored. 4. Click the file to be restored to select it. 5. Click the Copy button. 6. Click the plus sign to the left of the Impact Root folder to open it. 7. Click the VisionPrograms folder. 8. Click the Paste button. 9.
AB PCCC Server Impact Reference Guide Input Name What it is Trigger Ack [33] If the Trigger register value is set to non-zero, the camera is triggered and that value is also written to this register as a trigger acknowledgement. Reserved [34] - [63] These registers are reserved for future use Register [64] - [127] The Modbus client can write to these registers.The value in the register can be linked to VPM tool property values.
Impact Reference Guide AB PCCC Server No values for the PCCC Server properties are saved in the Vision Program (*.vp) files. If you require initial values, they must be set using explicit Data Set operations in the program when it loads. The VPM PCCC server properties (the number in brackets) are described here. NOTE: This System Object is not available while the device is online.
OPC Data Access Impact Reference Guide To access Impact device data from a PLC, use Read/Write Message commands with PLC5 as the target device. There are variations in PCCC command implementations across PLC5 product generations. The files must be accessed using the right combination of File Type, File Name, and File Name index as shown in the two tables above. Refer to your PLC documentation for command details. IMPORTANT: File names are case sensitive.
Impact Reference Guide OPC Data Access Input Name What it is Shutter Speed (x 10 microseconds) The camera shutter speed Strobe 1 Duration (ms) The duration for strobe 1 Strobe 2 Duration (ms) The duration for strobe 2 Strobe 3 Duration (ms) The duration for strobe 3 Create Custom OPC Inputs You can create custom OPC inputs then read and write those input values from other VPM tool properties. How to create a custom input 1. Click the Add Input button above the properties pane. 2.
OPC Data Access Datalogic Automation Inc.
C H A P T E R 3 Vision Program Manager Introduction This chapter describes how to set up an inspection task, including an overview of Vision Program Manager tools and how to configure them. This chapter introduces VPM and describes how to configure the tools in the Toolbox. If you are using a camera, the camera should be calibrated before you set up an inspection task so that inspection measurements are accurate. See “Camera Setup Tab” on page 2-17 for camera calibration details.
VPM - An Overview Impact Reference Guide Multiple users can connect to one device, but only one user at a time can edit programs or change data on the device. User Logon dialog Enter a valid User ID and password, then click Log On, to access the selected Impact device. Click Change Password to change a user password from this dialog. (See “To modify a password during logon” on page 2-14 for more details.) • Edit IP Address... To change the IP address of the selected device, click this button.
Impact Reference Guide VPM User Interface VPM User Interface These are the primary areas in the VPM interface. Each of these areas is explained in the following sections.
Icons Impact Reference Guide Delete Selected Items - See “Delete Selected Items” on page 3-8. Delete All Character Models - (OCR and Character Contour Match tools) See “Character Contour Match” on page 3-159 or “OCR” on page 3-180. Delete Character Model - (OCR and Character Contour Match tools) See “Character Contour Match” on page 3-159 or “OCR” on page 3-180. Float Image Display - See “To float the Image Display Area” on page 3-16. Help - See “Help” on page 3-10.
Impact Reference Guide Select Camera Show ROIs (Summary tab) - See “Summary and Add Device” on page 3-5 Show Summary Table buttons - See “Show Summary Table Buttons” on page 3-12. Start/Stop Auto-trigger - See “Trigger Tab” on page 2-19. Start/Stop Continuous Trigger - See “Start/Stop Continuous Trigger” on page 3-11. Task - See “Create a Task” on page 3-33. Tip - This icon indicates helpful text or a guide for what to do next.
Main Toolbar Impact Reference Guide The Summary tab provides a summary of the inspection results from all the devices or cameras currently connected to VPM. Show ROIs - The Show ROIs button turns the ROI display on and off for all images on the Summary tab. Total Counts, Pass/Fail bar graph, and Reset - This area displays the pass, fail, percentage, and total counts from the first Pass/Fail tool in the ImageIn task. (You must include a Pass/Fail tool in the task to display this area.
Impact Reference Guide Main Toolbar next time VPM starts. If you click No, the Device Connect dialog will be displayed the next time VPM starts. Editing a vision program from multiple VPM programs The first VPM program to connect to a device acquires exclusive editing privileges on that device. Other VPM programs can connect to the device and display data (Read Only mode), but they cannot modify its vision programs. (See “Special Case Editing” on page 4-3.
Main Toolbar Impact Reference Guide Unload This closes the currently selected vision program and unloads it from the Impact device’s operating system, but it remains stored in the device’s memory. Select Program Click the button to show the list of vision programs that are currently loaded in the Impact device. Select a program to view, modify, or run it. Save This saves the currently open vision program into the Impact device’s memory and it remains loaded on the device.
Impact Reference Guide Main Toolbar • Print preview This displays a preview of a formatted, expanded list of all properties and values in the currently selected vision program, task, or tool. This button is disabled if the file is password protected. • Print to text file This prints an expanded list of all properties and values in the currently selected vision program, task, or tool to a text file. This button is disabled if the file is password protected.
Main Toolbar Impact Reference Guide Camera Preferences • Display Refresh Rate: The rate at which the Summary Table and Display tab values are refreshed while VPM is in Start/Stop Continuous Trigger mode or online. If the system is online, this setting affects only the refresh rate, not the trigger rate. • Display Refresh Timeout: Occasionally communication timeouts can cause VPM to stop refreshing the Summary Table and Display tab values.
Impact Reference Guide View Tabs View Tabs Click the Design tab to access the Design view. The following section describes the Design view. Click the Display tab to access the Display view. See “Display Tab” on page 3-25 for a complete description. Design Tab NOTE: The Design tab is hidden when the Summary tab is selected. To o l b o x Show/ Hide toolbox The toolbox contains all the vision programming tools in VPM. To show or hide the toolbox, click the toolbox Show/Hide button.
Design Tab Impact Reference Guide When this button is clicked, the task that has its Image In Event set as its Trigger Event type runs once on the image currently in the image buffer. A new image is not acquired. This button is disabled when the system is online, when you are promoting inputs and outputs, or when you are linking properties. Live Image Live Images When this button is clicked, images are displayed as rapidly as possible.
Impact Reference Guide Design Tab Add a Task When you click this tab, a task is added to the currently selected vision program. (See “Create a Task” on page 3-33) This tab is disabled if the file is password protected. When you add a task, a new task tab is created. S u m m a r y Ta b l e The Summary Table shows the results of all the tools that ran in the task.
Design Tab Impact Reference Guide • Total Time The time since the hardware trigger at the device started the image acquisition process (in microseconds). This is the "trigger to done" time, which includes exposure, acquire, image transfer to the PC, etc. This is a “live” value during the task run as it is read during the task run and updated to the current time. Once the task finishes running, this time is locked to the time at which the task finished.
Impact Reference Guide Design Tab The Task Tree shows the tools in the order they run when the task runs. If you link data between tools, be sure the data you are using originates in a tool that runs before the destination tool runs. Task Icon Resize Task Tree area Expand Branch Collapse Branch Expand or collapse branches: Some tools, like the Branch tool, have branches that can be expanded and collapsed. Click the Expand or Collapse icon to view the branches.
Design Tab Impact Reference Guide This image display area is where you configure Regions of Interest (ROI) and other tool parameters. To enable automatic image linking when new tools are added to the task, see “Program Preferences” on page 39. To auto-save images, see “Program Preferences” on page 3-9. If you are using an image processing tool with an ROI, the tool will not work correctly if all or part of the ROI extends past the edge of the image.
Impact Reference Guide Design Tab D i s p l a y A r e a To o l b a r Save Image Zoom Histogram Line Profile Image Save Image • When you click the Save Image button, two buttons are displayed. To save the image only, click the Save Image button. If you click Save Image with Graphics, the image will be saved with all ROIs that are on the image and Pseuodocoloring (if enabled). Note that images saved with graphics are saved in 24-bit format color and cannot be used as inspection images.
Design Tab Impact Reference Guide Histogram and Line Profile NOTE: The Histogram and Line Profile views are not available for color images. To display the Threshold Viewer, you can also right click on the ROI or the image. The floating Threshold Viewer displays a histogram or line profile, depending on the area of the image or ROI selected. The viewer graphically represents each pixel’s grey level to show how a VPM tool "sees" the image (example below).
Impact Reference Guide Design Tab When you select the Shape List input in the list of tool inputs, this toolbar is displayed. These tools are used to create ROIs, cut, copy, paste, and delete selected ROIs, save images, zoom in and out on the image, and view a histogram or line profile. For more details, also see “Display Area Toolbar” on page 3-17. To place a Rectangle, Circle, or Polygon Shape List ROI 1. In the tool input properties, select Shape List. 2. On the toolbar, click the Create ROI button.
Design Tab Impact Reference Guide Line and Wide Line ROIs To create a Line or Wide Line ROI 1. Select the desired tool, then click the desired Line ROI Property (depending on the tool). 2. On the toolbar, click the Create ROI button. 3. From the drop down, select the Line ROI. 4. Click on the image where you want to place the ROI. 5. To resize, move, or rotate the ROI, move the cursor along the ROI (the cursor changes to one of these types), then click and drag the cursor to the desired place or size.
Impact Reference Guide Design Tab You can use the buttons in this area to run a tool or task, update tool links, and train a tool, depending on the tool type. These buttons are displayed on the Properties tab only. Run button: When you click this button, the task or tool runs just as it does when the vision program is run, but it runs only one time. (An image must be displayed in the image window.
Design Tab Impact Reference Guide NOTE: Some tools have only a General and Display panel. For those tools, you need to click the Properties tab to configure the tool. This example shows the Pass/Fail panel in the Setup for the Blob tool. These radio buttons select the various setup screens. The cursor’s X-Y position and pixel greyscale intensity is displayed here. ROIs are created and modified in the image display area. Some tools have no image.
Impact Reference Guide Design Tab Only tasks have this panel. Here you can define how the task operates. • Task Type Called By Another Task or Control Panel: If this task is called by another task or triggered from a Control Panel, choose this option. Triggered By This Event: If this task is triggered by an event or hardware trigger in the Impact device, choose this option, then select the Trigger Event type from the drop down list.
Design Tab Impact Reference Guide • Restore Defaults - Each tool and task has some properties that are selected by default. This restores all of the default selections. • Apply to Entire File - If this check box is checked, the Clear, Select, or Restore Defaults operation will be applied to the property selections in all the tools and tasks in the currently selected vision program file.
Impact Reference Guide Display Tab The Link Summary tab window displays information about links to and from the currently selected tool, task, or program. Click the Advanced Browser button to display the data type and value. To open the Link Browser window, click the Link tab. Print to Text File Print Advanced/Basic Browser Tool, Task, or Program Name Print Preview To expand the browser window to include additional fields, click the Advanced Browser button.
Display Tab Impact Reference Guide Display Areas NOTES: When you switch to the Display tab from another tab, the task does not run automatically. You can click the Run Once on Current Image button to insure that the tab displays the most current values. If a tool has a Train property (e.g. the Origin tool), and you move an ROI, you must use the Train method to update the display. (Click the Setup tab, click the Summary radio button, then select the Train method on the Show On Display tab.
Impact Reference Guide Display Tab The Image display area (the image float option is not available here) Current Image Tabs for tools with image and library outputs Four most recent images The Chart display area (to enable, see “Display panel” on page 3-23) Click Reset to reset the tool’s counts Output Tabs Some tools, the Binary Image Filter for example, have an Output Image. The OCR and Character Contour Match tools have a character library output.
VPM Linking Impact Reference Guide When you select a new Vision Program file from the list, the current Program (and the Vision Program file) is unloaded and the selected one is loaded. Program files with names other than the Filter names can be loaded and unloaded through the Settings Tab File Manager - Setup. If no loaded Program names match those in the Filter, then the drop-down current selection is blank. See “To create a vision program” on page 3-30 for more details.
Impact Reference Guide Links Between VPM Tools NOTE: Any time an input image link is modified on a tool in a task, that new link source becomes the default for tools added to that task. For example, if you delete the image link in any tool in a task, the next time you add a tool to that task, the task’s image will NOT be automatically linked. The automatic linking applies whether the tool was added from the toolbox or the clipboard.
Creating a Vision Program Task One Tool A 1. Link Remains Tool B Task One Tool A 2. Link Removed Tool B Impact Reference Guide Task One Task One Tool B Tool A Tool A Tool B Task Two 3. Link Remains Task One Tool C Tool A Tool A Task Two Tool A Tool B Task Two Tool C 4. Link Remains Tool B Task Two Tool C Task Three Tool A Tool B To create a link 1. Click the destination tool in the tool tree. 2. Click the Properties tab. 3.
Impact Reference Guide Creating a Vision Program 2. Click the New button in the toolbar. The following dialog is displayed. Enter a name for the Vision Program file in the File Name field. This must be a unique name and names are case sensitive. The Program name "Inspection" is assigned by default. To assign a different Program name, click the Advanced button. The program name can be filtered by the Program name entered in the Display Tab Program Filter field in the File Manager.
Creating a Vision Program Impact Reference Guide 8. Click the Save button in the toolbar. Vision Program Security You can password protect a vision program when you save it. A password protected file is automatically saved in compressed binary format and the program cannot be edited, printed, viewed, or saved. NOTE: Vision Program security protects the vision program from unauthorized access. Device security protects the Impact device from unauthorized access. (See page 2-13.
Impact Reference Guide Create a Task General Properties Name What it is Abort On Error If True, the program will stop running when the Task Timeout value is reached or one of the tools in the task aborts due to an error. If an Abort Task is defined in the task properties, that Abort task will be queued to run. If False, then the task keeps running and any remaining tools abort and fail. (See “Enable Timeout” on page 2-6 and “VPM Task Configuration” on page 3-34.
VPM Task Configuration Impact Reference Guide VPM Task Configuration Task Icon A task is a collection of tools. It runs based on a user-selected external (hardware) or internal (software) event detected in the Impact device. Multiple tasks can be combined into a Program. Every task has general properties and common outputs. Each trigger event type also presents unique inputs which are listed after each event type in the table. General Property Name What it is Name The name of the task.
Impact Reference Guide VPM Task Configuration Output Name What it is Average UsecsSinceRun The average of all UsecsSinceRun values since the last count reset Max UsecsSinceRun The maximum UsecsSinceRun value since the last count reset UsecsSinceTrigger (Microseconds Since Trigger) The time since the hardware trigger at the device started the image acquisition process (in microseconds). This is the "trigger to done" time, which includes exposure, acquire, image transfer to the PC, etc.
VPM Task Configuration Impact Reference Guide • Bad Image Event: The task is queued when an error is generated during image acquisition. This can include DSL communication errors, CRC errors, and out-of-buffer-space errors, among others. This event provides an additional input: Input Name What it is statusBits The bit map of the image acquisition error message • Image In Event: The task is queued when an image has been acquired and is ready for processing by the Impact device.
Impact Reference Guide VPM Task Configuration • Scheduled Event: The task is queued when an Event Scheduler tool causes a scheduled event to occur. Use a Branch or Basic tool to determine what action to take based on the Event ID. Input Name What it is Event ID The Event ID of the Event Scheduler tool that triggered the event. • Shift Event FE and RE: The task is queued by both the rising and falling edges of a hardware trigger on the Impact device’s Shift input.
VPM Tools Impact Reference Guide • Modbus TCP/IP Event: The task is queued when the Modbus Server receives any Modbus Request from a client. Input Name What it is Function Code The function code of the Modbus client's request. These are standard Modus function codes. For example, Function Code 16 is a Write Multiple Registers request and Function code 3 is a Read Multiple Registers request. Start Address The starting register in the Modbus Request sent by the Modbus Client.
Impact Reference Guide VPM Tools an up-to-date tool or its replacement. If you do replace the tool, you may need to redefine the tool’s inspection properties. When you save the vision program file, the deprecated tool is saved the same as other tools. Current Origin tool Deprecated Origin tool Every tool has the general properties of Name, Description, and Type. Some tools also have inputs and outputs that can be linked between tools. Each tool input and output has a data type.
Toolbox and Drawers Impact Reference Guide Toolbox and Drawers VPM tools are contained in the toolbox and grouped within drawers based on their general purpose. Some tools appear in more than one drawer because they have multiple purposes. In VPM, a brief tool tip is displayed when you hover the cursor over the tool icon in the toolbox. For tool details, refer to the page number in the tables below (displayed in toolbox, then tool, alphabetical order).
Impact Reference Guide Recently Used Drawer Locating Logic Measurement Readers Specialized Blob 3-66 Basic 3-204 Angle page 3-111 Character Contour Match 3-159 Change image Calibration 3-218 Circle Gauge 3-117 Branch 3-205 Circle Edge Refinement 3-115 Code Reader 3-167 Clip ROI 3-219 Circular Pattern Find 3-70 Break 3-206 Circle Gauge 3-117 OCR 3-180 Data Transfer 3-219 Line Find 3-75 Call Task 3-206 Line Find 3-122 Grid Statistics 3-220 Origin 3-79 Counted Loop 3-207 Line Gauge
Binary Image Filter Impact Reference Guide The Average Filter tool can smooth the average grey level value of the pixels in an image and provide that processed image as an output. The smoothing is done within a defined filter area of pixels which is moved progressively throughout the ROI. Of the three filtering tools (Average, Gaussian and Median), this is the fastest because it weights all pixels within the filter area equally. It is not as precise as the other two, however.
Impact Reference Guide Color Pixel Fill Output Name What it is Threshold Range Used The Threshold Range used to modify the image. The parameters are start and end. Color Pixel Fill In the Image Filtering Drawer The Color Pixel Fill tool fills portions of a color image with a specified color value. The Find Shape List defines the area to be filled. The area is filled with the RGB color value specified in the Fill Value property. The filled area appears on the output image.
Gaussian Filter Impact Reference Guide Note: Show Gradient Sign works only when just one of the Enhance Edge settings is True. Input Image All four Enhance Edge settings true Enhance 90 Degree Edges Enhance 90 Degree Edges with Show Gradient Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space Shape List The desired region of the image to process. If no shape is defined, the entire image is processed.
Impact Reference Guide Image Math Input Name What it is Tool Origin The tool’s origin relative to the entire image space Shape List The desired region of the image to search. If no shape is defined, the entire image is processed. Filter Size The area size (in pixels square) to include in the smoothing. Smaller numbers provide less smoothing. Output Name What it is Output Image Smoothed Image within ROI (may be viewed on the Output Image tab).
Image Math Impact Reference Guide Pixels on the Output image are set to one hundred if they are logically True, and zero if they are logically False. • XOR This operation performs a logical XOR (exclusive OR) of the corresponding Input image and Secondary image pixel grey levels. Pixels on the images are considered logically True if their grey level is greater than zero. Pixels on the Output image are set to one hundred if they are logically True, and zero if they are logically False.
Impact Reference Guide Light Leveling Input Name What it is Secondary Image The operation is performed on this image and the Input image (except for NOT and Invert) Operation The operation to perform Input Image Weight Used only for the Weighted Average operation. See “Weighted Average Calculation” on page 3-47 for details. Secondary Image Weight Used only for the Weighted Average operation. See “Weighted Average Calculation” on page 3-47 for details.
Light Leveling Impact Reference Guide scale factor is calculated for all the other columns or rows which brightens them so they have the same average grey level as the brightest column or row. Each column or row’s scale factor is then applied to all the pixels in that column or row within the entire Region To Copy. The light sensor area can be trained or recalculated on each image.
Impact Reference Guide Linear Morphology Open Input Name What it is Target Intensity Selection Brightest Row/Column Average Is Target Intensity: After projecting the rows/columns of the sensor ROI, the tool finds the brightest row/column and scales all the other row/columns to have that same average intensity. It is automatic self-scaling behavior that preserves greyscale resolution.
Linear Morphology Close Impact Reference Guide Output Name What it is Output Image The morphed image (viewed on the Output Image tab). Linear Morphology Close In the Image Filtering Drawer The Linear Morphology Close tool removes small noise in an image, like the Morphology Close tool, but this tool retains thin lines in the image during the process. (See “Morphology” on page 3-52 for more details.
Impact Reference Guide Morphology Open Input Name What it is FilterWidth This is the width of the area (in pixels) within which the filtering takes place FilterHeight This is the height of the area (in pixels) within which the filtering takes place Output Name What it is Output Image Filtered Image (may be viewed on the Output Image tab). Morphology Open In the Image Filtering Drawer The Morphology Open tool performs a morphological open on the white parts of an image.
Morphology Close Impact Reference Guide Input Name What it is Shape List The desired region of the image to search. If no shape is defined, the entire image is processed. Number of Iterations The number of times to perform the operation. If zero is entered, the tool just copies the input image to the output. Morphology Shape Defines the shape of the neighborhood around each pixel that is searched to find the output pixel value. See “Morphology Shape” on page 3-53.
Impact Reference Guide Morphology Close Dilate The dilate operation gradually enlarges the boundaries of regions of foreground pixels. Thus areas of foreground pixels grow in size while holes (background pixels) within those regions become smaller. Results of a dilate operation Erode The erode operation erodes away the boundaries of regions of foreground pixels. Thus areas of foreground pixels shrink in size, and holes within those areas become larger.
Morphology Dilate Impact Reference Guide iterations is limited to 35 along the x and y axes so that the square shape’s corners fit inside the circle. Defects at the top, bottom, left, and right may not be found. Defects here not found Number of iterations Using a circle shape would solve this problem, but a perfect circle is slow to process, so an octagonal shape is used. (The figure on the right.
Impact Reference Guide New Image The Morphology Erode tool performs a standard erosion on the white parts of an image. (See “Morphology” on page 3-52 for more details.) Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space Shape List The desired region of the image to search. If no shape is defined, the entire image is processed. Number of Iterations The number of times to perform the operation.
Image Geometry Drawer Impact Reference Guide Input Name What it is Tool Origin The tool’s origin relative to the entire image space Find Shape List The desired region of the image to fill. If no shape is defined, the entire image is filled. Shape List ROI Type Each Shape is separate ROI: Each shape is processed as a separate ROI and the results are combined. This mode is faster than the other mode if the shapes are far apart, but results are duplicated if the shapes overlap.
Impact Reference Guide Deslant Image Output Name What it is Output Image Reduced resolution image (viewed on the Output Image tab). Deslant Image In the Image Geometry Drawer The Deslant Image tool corrects the slant frequently seen in printed dot matrix characters. Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space Shape List The desired region of the image to search. If no shape is defined, the entire image is processed.
Image Sampling Impact Reference Guide Image Sampling In the Image Geometry Drawer The Image Sampling tool provides a reduced resolution image by sampling a user-defined number of pixels. For example, you can produce an image at one-half resolution by sampling every other pixel. Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space. Region of Interest The area of the image to sample.
Impact Reference Guide Image Stitching with Points Output Name What it is Output Image The resulting stitched image (viewed on the Output Image tab). The output image must be less than 32k pixels high or wide with a practical limit of 16 Mpixels total. See “Special Note for Stitched Images with Distortion” on page 3-60.
Line Profile Impact Reference Guide two and includes the overlap area, but not any pixels from image one, then the ROI uses all image two pixels to provide the most accurate results with no seam and with distortion correction. The image display may look odd because the displayed pixels are from image one, but the results are based on image two pixels.
Impact Reference Guide Multiple Image Stitch be within five pixels on each dimension to help the tool find the correct stitching transformation. For a more detailed explanation of how the images are stitched based on the inputs, see “Stitching Directions” on page 3-62.
Multiple Image Stitch Impact Reference Guide Output Name What it is Stitching Scores A list of the stitching scores for each stitch in the output image. Output Image The image resulting from the stitching operation. Stitching Directions These examples show a part to be inspected that is too large to snap in one image. The camera moves above the part while a series of images are snapped. These images are then combined into an image list and the Multiple Image Stitch tool puts them together.
Impact Reference Guide Multiple Image Stitch order in the final stitched image is determined by the tool’s input settings (see “Stitched Image Order Table” on page 3-63). Image Size = 600 Camera Motion The input settings for this tool are: Row Major Order = True Major Forward = True Minor Forward = True Serpentine = True Image Size = 600 Image 1 Image 2 Image 4 Image 3 The camera moves this far, then snaps another image.
Unwrap Impact Reference Guide Row Major Major Order Forward Minor Forward Serpentine Stitched Image Order False True True False 1 3 2 4 False True False True 2 3 1 4 False True False False 2 4 1 3 False False True True 4 1 3 2 False False False True 3 2 41 False False True False 3 1 4 2 False False False False 4 2 3 1 Unwrap In the Image Geometry Drawer The Unwrap tool can be used to straighten text in the shape of an arc so it can be analyzed with the OCR tool.
Impact Reference Guide Undistort Image Undistort Image In the Image Geometry Drawer The Undistort Image tool applies the input image's calibrated distortion mapping to the image to produce an output image that is not distorted. The tool’s primary purpose is to "flatten" an image with perspective distortion, so that images look similar at all rotations and translations. It also removes radial lens distortion.
Locating Drawer Impact Reference Guide Input Name What it is In Range Value The pixel grey level value to use for the Fixed Threshold Range. Use Out Of Range Value If True, pixels with a grey level within the Fixed Threshold Range are changed to the Out Of Range Value before the average intensity is calculated. Out Of Range Value The pixel grey level value to use for the Fixed Threshold Range.
Impact Reference Guide Blob Input Name What it is Shape List ROI Type Each Shape is separate ROI: Each shape is processed as a separate ROI and the results are combined. This mode is faster than the other mode if the shapes are far apart, but results are duplicated if the shapes overlap. ShapeList is One ROI: The ShapeList is one large rectangular ROI and the shapes are the enabled pixels within the rectangle. The tool may be slow if the shapes are far apart.
Blob Impact Reference Guide Input Name What it is Output Origin Type Also see “Output Origin” on page 3-70 Centroid X, Y Only: The X and Y coordinates of the blob centroid (the angle is ignored) Centroid X, Y and Major Axis Angle: The X and Y coordinates of the blob centroid and Major Axis angle in a +/- 90 degree range (useful if blob has an oblong shape).
Impact Reference Guide Blob thus considered in-range. This setting is best used when looking for a bright part of an image with non-uniform grey levels. In this example, the lower threshold is approximately 50% and the upper threshold 100%. Lower Threshold 0 Threshold Range Upper Threshold 100 Autothreshold Contrasting Dark Pixels This sets the upper and lower thresholds automatically based on all the grey levels in the ROI.
Circular Pattern Find Impact Reference Guide The average of all grey levels within the Region of Interest is calculated. The Fixed Threshold Range (i.e. the difference between the Min and Max values) is centered on the average grey level. Pixels with grey levels within that range are considered in-range of the inspection. For example, if the Fixed Threshold Range is 20 to 40, the range is 20. If the average grey level is 70, the center of the grey level is 35.
Impact Reference Guide Circular Pattern Find • Widen Arc • Rotate Do not change the arc ROI’s width between training and running, only the arc length. Generally, a thinner arc executes faster. The tool can find multiple matches within the search ROI and the best match and a list of all matches are available as outputs. Note: You cannot see the trained model. That is, after you train and then resize the arc for searching, you can not see the trained arc angle.
Circular Pattern Find Impact Reference Guide The Contour Pattern Find tool creates a model based on detected edges in a user-selected part of an image, then provides a best-match score and the x-y coordinates of the model’s origin as an output. Input Name What it is Input Image The image being inspected Tool Origin The tool’s origin relative to the entire image space Train Shape List The region of the image used to train the model.
Impact Reference Guide Circular Pattern Find Input Name What it is Edge Detection Sensitivity When Finding Indicates sensitivity to noise in image while looking for the model. Higher settings allow rougher edges and causes more thorough and longer searching. Fixed Edge Threshold When Training The grey level threshold value when Fixed Threshold Edge Detection When Training is selected.
Circular Pattern Find Impact Reference Guide NOTE: This tool has been deprecated and replaced by the Pinpoint Pattern Find tool (see page 3-84). It is documented here only for existing vision programs and is no longer supported. The Correlation Pattern Find tool is a general-purpose correlation based pattern find tool. It finds one or more instances of a trained model image in a user-defined search region. It can find the model at any angle of rotation.
Impact Reference Guide Line Find Input Name What it is Correlation Model The model to find, linked from another tool Output Name What it is Found match If True, at least one match with a sufficient Match Score was found Output Best Origin The best origin relative to the input tool origin Output Best Origin Relative to RWC The match’s origin in Real World Coordinates.
Line Find Impact Reference Guide Input Name What it is Edge Detection Method Gradient Edges or Grey Level Edges Gradient detection generally provides more consistent results. In some cases Gradient detection can pick up extra edges in a noisy image and Grey Level detection may offer better control. See “Edge Detection Method” on page 3-78. Edge Detection Sensitivity The sensitivity level determines the transition level necessary for detection. A higher value detects less well-defined edges.
Impact Reference Guide Line Find Input Name What it is Max Straightness Error The maximum deviation allowed from a straight line (0 indicates a straight line) Output Name What it is Passed If True, the found line’s parameters lie within all the limits Line Segment The found line Output Origin Relative to Tool The X and Y coordinates of the center point and the angle of the found line relative to the Tool Origin.
Line Find Impact Reference Guide Above is an example of an image after the tool has run (some features have been removed in each example for clarity). The magenta dots are the edge points, the yellow dots are the outlier edge points, and the green line is an output that lies on the fitted line and extends from the first fitted point to the last fitted point, as they are projected to the fitted line. The output origin is centered on the fitted line and at the same angle.
Impact Reference Guide Origin what better than Gradient Edges when the edge is a gradual slope, the flat parts of the image are noisy, or you are trying to find more subtle edges. Image edges Rising Edge found Grey Levels Threshold Falling Edge found Origin In the Locating Drawer The Origin tool uses from one to three line ROIs to locate image edges. These edges provide an origin point and angle for other tools to use as a reference point to locate the parts of the image you want to inspect.
Origin Impact Reference Guide Input Name What it is Primary Object Color to Find The object color for the Primary ROI to find Primary Threshold Method Adaptive or Fixed - See “Threshold Method” on page 3-83 for more details. Primary Fixed Threshold Percentage The percentage grey level threshold value used when fixed threshold method is selected Primary Adaptive Threshold Offset If Adaptive Threshold Method is selected, this offset is added to the adaptive threshold.
Impact Reference Guide 3-81 Origin Input Name What it is Secondary Noise Level See “Primary Noise Level” on page 3-80. Secondary Centering Method See “Centering Method and Point Numbers” on page 3-83 Secondary Point Number The Secondary ROI point used for the origin point, numbered from the start of the Secondary ROI.
Origin Impact Reference Guide Input Name What it is Subpixel Method The type of subpixel averaging The grey levels of one or more adjacent pixels (3, 5, 7, or 9) around an edge point are used to interpolate the edge to a fraction of a pixel Subpixel Position The subpixel position for edges that are not well defined. See “Subpixel Position” on page 3-144.
Impact Reference Guide Origin Central Rising Edge: Detects the central point of the dark to light transition Central Falling Edge: Detects the central point of the light to dark transition First Rising Edge: Detects the first dark to light transition First Falling Edge: Detects the first light to dark transition Automatic: Detects transitions based on the "...Object Color to Find" property setting Centering Method and Point Numbers Points found on the ROI are counted from the beginning of the ROI.
Pinpoint Pattern Find™ Impact Reference Guide Pinpoint Pattern Find™ In the Locating Drawer The Pinpoint Pattern Find tool uses a train region to create a pattern (or model) from part of an image. When the tool runs, it uses correlation and contour matching routines to find one or more matches to the trained pattern. It then calculates best-match scores and provides those scores and the x-y coordinates of the found patterns as one or more origin outputs.
Impact Reference Guide 3-85 Pinpoint Pattern Find™ Input Name What it is Angle Range Pattern The maximum possible range of rotation of the image in relation to the trained pattern. No Rotation: This is the fastest setting + - A Few Degrees: uses the Angle Range property value 0 And 180 + - A Few Degrees: uses the Angle Range property value plus 180 degrees. For example, if the Angle Range is -5 and 5, the tool searches for patterns rotated from -5 to +5 and 175 to 185 degrees.
Pinpoint Pattern Find™ Impact Reference Guide Input Name What it is Scale Range Step The value to use for the Scale Range Step Type property when Fixed Steps is selected. A typical value is 0.1. So, for example, a Scale Range of 0.5,1.5 is covered by 0.1 steps from 0.5 to 1.5 (0.5, 0.6 … 1.4, 1.5). Minimum Match Score The tool passes if a pattern is found in the Search region that has a match score greater than or equal to this value (0 to 100).
Impact Reference Guide 3-87 Pinpoint Pattern Find™ Output Name What it is Passed When at least one pattern with a score greater than or equal to the Minimum Match Score is found, this property is True. Output Best Origin The Output origin, relative to the tool origin input property, calculated from the found pattern with the highest Match Score. Output Best Origin Relative to RWC The Output origin, relative to Real World Coordinates, calculated from the found pattern with the highest Match Score.
Pinpoint Pattern Find™ Impact Reference Guide Output Name What it is Actual Angle Range Step The value used for the Angle Range Step Type property Actual Scale Range Step The value used for the Scale Range Step property How to use the Pinpoint Pattern Find tool Click the Setup tab to use the setup for this tool. General 1. Image: To use a different image source, click the Link button. The tool works only with greyscale images. 2.
Impact Reference Guide Pinpoint Pattern Find™ minus the text, is the trained pattern. The pattern’s edge points may have gaps in them. These are a normal feature of the tool caused by a statistical data reduction process that increases execution speed. Trained Pattern Rectangular Exclusion Region 3. Pattern Model: The model from another Pinpoint Pattern Find tool can be linked to this tool, rather than training the model in this tool.
Pinpoint Pattern Find™ Impact Reference Guide 6. Model Detail Max Memory: The tool can potentially use a large amount of Impact device memory. If the vision program is running out of memory, set the maximum amount of memory the tool uses for the pattern. The Actual value is the current amount of memory used for the pattern. If you enter a value that is less than the current Actual value, and then retrain the tool, the pattern is retrained to use less memory.
Impact Reference Guide Pinpoint Pattern Find™ You can use any shape for the Search ROI including polygons, circles, and exclusion regions. If no Search ROI is defined, the entire image is searched. 2. Pass/Fail Result: The tool runs automatically and updates the panel whenever you change the Search ROI, any settings on this panel, or a new image is acquired. The result is indicated by the Pass/Fail field just below the image.
Feature Finding Drawer Impact Reference Guide If the Algorithm Type property is set to Correlation, correlation matching is used only for the first stage of the search. The final placement and scoring is always correlation based. This setting may be useful for patterns that have weak and variable edges or for very small objects. Correlation is inherently slower than edge matching, especially for searching over large areas or with rotating patterns.
Impact Reference Guide 3-93 Average Intensity Input Name What it is Shape List ROI Type Each Shape is separate ROI: Each shape is processed as a separate ROI. ShapeList is One ROI: The tool calculates average intensity as if there is only one ROI, no matter how many ROIs are used. The tool averages all the pixels from all the ROIs together and produces one Average Intensity and one Passed result. The Average Intensity and Passed Lists are one value long.
Average Intensity Impact Reference Guide Output Name What it is Average Intensity Result Average grey level intensity of all pixels in all ROIs Intensity Difference The positive or negative difference between the Average Intensity Result and the Uniform Tolerance nominal value, regardless of the Tolerance type Intensity Offset Output The negative value of Intensity Difference.
Impact Reference Guide Blob Blob In the Feature Finding, Flaw Detection, and Locating Drawers See “Blob” on page 3-66. Blob Filter In the Feature Finding Drawer The Blob Filter tool filters the blob’s output list for user-selected features such as size, shape, or whether any part of the blob is filled. The included blobs are put in a filtered list that is available as an output.
Blob Filter Impact Reference Guide Input Name What it is Enable Filled Convexity Filter When checked, filters blobs within Filled Convexity Range Filled Convexity Range Blob minimum and maximum Filled Convexity Enable Filled Major Length Filter When checked, filters blobs within Filled Major Length Range (see “Major Length” on page 3-97) Filled Major Length Range Blob minimum and maximum Filled Major Length Enable Filled Minor Length Filter When checked, filters blobs within Filled Minor Length
Impact Reference Guide Color Blob Major Length The Major Length is the length of the major axis of an ellipse having the same moments of inertia about the major and minor axes as the blob. Major Axis Length Minor Length The Minor Length is the length of the minor axis of an ellipse having the same moments of inertia about the major and minor axes as the blob. Minor Axis Length Color Blob In the Feature Finding Drawer The Color Blob tool finds areas within an ROI based on the Trained Color.
Color Blob Impact Reference Guide To set up the tool using a Train Shape List: 1. Select the desired Blob Detect Type. 2. Draw the Train Shape List ROI over the desired solid color area. 3. Click the Train button. The tool finds R, G and B values of the average color in the Train Shape List ROI and put it in the Trained Color value. If you are looking for out of range blobs in a solid color area, you can set up the tool without a Train Shape List. To set up the tool without a Train Shape List: 1.
Impact Reference Guide 3-99 Color Blob Input Name What it is Train Mode Train a New Color: trains a new color using the current settings Add To The Trained Color: trains a new color using the current settings and adds it to the Trained Color List. Pixels are in range if they are in range for any color in the list. Color Difference Method Color Difference Includes Intensity: the Maximum Allowed Color Difference value uses all 3 dimensions of color and therefore includes intensity differences.
Color Checker Impact Reference Guide Input Name What it is Enable Output Blob List When true, the filtered blobs are presented in the Blob List output Enable Output Area List When true, the filtered blobs areas are presented in the Area list output Enable Output Centroid List When true, the filtered blobs centroids are presented in the Centroid list output Output Origin Type Also see “Output Origin” on page 3-70 Centroid X, Y Only: The X and Y coordinates of the blob centroid (the angle is ignore
Impact Reference Guide Contrast To set up the tool: 1. Draw the Shape List ROI over the color area you want to find. 2. Click the Train button. The tool finds the R, G and B values of the color in the Shape List ROI and put it in the Trained Color value. Wherever the Trained Color is located in the RGB color space, the Maximum Allowed Color Difference is the radius of a sphere around that color.
Contrast Impact Reference Guide The Contrast tool evaluates all of its ROIs as a total group against a common tolerance and provides combined outputs. The Contrast - Multiple ROI tool evaluates each ROI individually, against a common tolerance, and provides a detailed list of outputs. Input Name What it is Input Image The image being inspected Tool Origin The tool’s origin relative to the entire image space Shape List The desired region of the image to search.
Impact Reference Guide Contrast - Multiple ROI Output Name What it is Threshold Range Used The Fixed Threshold Range input. The parameters are start and end. Contrast - Multiple ROI In the Feature Finding and Flaw Detection Drawers The Contrast - Multiple ROI tool checks the pixels within multiple ROIs and provides the percentage or area of pixels that are outside and inside a range that is based on user-defined parameters.
Edge Point Find Impact Reference Guide Input Name What it is Maximum Percent Out of Range Maximum percentage of pixels to allow in the ROIs outside the designated grey level range (0 to 100 percent) Maximum Area Out of Range Maximum area of pixels to allow in the ROIs outside the designated grey level range (0 to 100 percent) Number of ROIs Allowed To Fail An ROI fails when the Maximum Area or Maximum Percent Out of Range value is exceeded.
Impact Reference Guide 3-105 Edge Point Find Input Name What it is Line Segment The x and y coordinates of the beginning and end of the edge-finding line Line Segment List A list of all the line segments between edges found Noise Level The amount of background noise present in the image. Higher noise means the edges must be farther apart. Lower noise allows edges that are closer together.
Line Find Impact Reference Guide Input Name What it is Subpixel Search Distance in Pixels The maximum distance, in pixels, from the threshold edge that the subpixel algorithm searches for the subpixel edge. See “Subpixel Search Distance” on page 3-125. Enable Rise/Fall Output If True, the Edge Rise/Fall Indicator List output is populated. Enable Number of Edges Per Segment Output If True, the Number of Edges Per Segment List output is populated.
Impact Reference Guide Spot Find 7. Run the tool. The output point list is generated. Spot Size ROI Shape List ROI Found points highlighted Sample Tool Setup Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space. Use this only if you are trying to find an origin relative to another tool. Find Shape List This is the tool’s search area.
Wide Edge Point Find Impact Reference Guide Wide Edge Point Find In the Feature Finding Drawer The Wide Edge Point Find tool uses an adaptive or fixed threshold method to find edge points along a wide line ROI. Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space Wide Line ROI Points on this ROI are used for finding the edge. Wide Line ROI List A list of wide line ROIs used for finding the edge.
Impact Reference Guide Wide Edge Point Find Input Name What it is Enable Number of Edges Per ROI Output If True, the Number of Edges Per ROI List output is populated.
Wide Edge Point Find Datalogic Automation Inc.
Impact Reference Guide Measurement Drawer Measurement Drawer Angle In the Measurement Drawer The Angle tool measures the angle between two user-specified lines. The lines can be found using the tool’s built-in Line Find ROIs or they can be linked from a Pinpoint Pattern Find or Line Find tool as Origins or Line Segments. The angle is always reported as a positive number from 0 to 360. The intersection point is also reported. See “How to set up the Angle tool” on page 3-112.
Angle Impact Reference Guide Input Name What it is Angle Endpoint Choose whether or not to consider the direction of the angle’s end line when measuring the angle. See “How to set up the Angle tool” on page 3-112. Enable Angle Range Check If True, the tool will pass if the measured Angle value is within the Angle Range limits. Angle Range If Enable Angle Range Check is True, the tool will fail if the measured Angle value falls outside these limits.
Impact Reference Guide Angle the cursor changes as shown below, then click and drag. Rotate the ROI Move the ROI ROI positioned on image Adjust the ROI width These Wide Line ROIs are the same as those in the Line Find tool with the following settings: Grey level edges, Automatic thresholding, Medium noise level, Sampling of 50%, and Outlier distance of three pixels. If you want to use different settings, add a Line Find tool to the task and link that tool’s Line Segment into the Angle tool. 2b.
Angle Impact Reference Guide 5. The Lines or linked Origin, Found Arc, and Intersection are displayed on the image. Arc Linked Origin Line 1 Intersection 6. If you check the Enable Angle Check check box, the tool will fail if the Actual Angle value is not within the Angle Range limits. Enter the desired values in the Minus, Nominal, and Plus fields. 7. Select the angle Direction from the drop down (Clockwise or Counterclockwise).
Impact Reference Guide Circle Edge Refinement Circle Edge Refinement In the Measurement Drawer The Circle Edge Refinement tool refines the center location and diameter of a circle based on an estimated center and the number of segments to search. It indicates if the center and diameter are within an expected range. This tool is primarily used to find the centers of the balls in a ball grid array (BGA).
Circle Edge Refinement Impact Reference Guide Input Name What it is Adaptive Grey Level Threshold Offset If one of the adaptive settings is picked from Edge Detection Sensitivity, and Grey Level Edges is selected, then this offset is added to the adaptive threshold. This allows you to weight the adaptive threshold up or down. Noise Level The amount of background noise present in the image. Higher noise means the edges must be farther apart. Lower noise allows edges that are closer together.
Impact Reference Guide Circle Gauge Output Name What it is Bounding Circle Diameter List If Bounding Circle Enable is True, this is the list of Bounding Circle diameters. Circle Edge Detect Type The first three settings are designed to find one edge point per ROI. The tool will then find fit the circle with least squared error. The last three settings will find multiple edge points per ROI.
Circle Gauge Impact Reference Guide Input Name What it is Fixed Gradient Threshold Percentage The gradient threshold value for Gradient Edges Detection Method when Edge Detection Sensitivity is set to Fixed Threshold Fixed Grey Level Threshold Percentage The grey level threshold value for Grey Level Edges Detection Method when Edge Detection Sensitivity is set to Fixed Threshold Noise Level The amount of background noise present in the image. Higher noise means the edges must be farther apart.
Impact Reference Guide 3-119 Circle Gauge Input Name What it is Enable Smoothing Filter If true, the tool removes isolated outlier points (by excluding noise points) for the Roundness and Bounding Circle calculations, since these calculations are sensitive to individual defect points. An isolated outlier is one where both neighbors are not outliers. If two points in a row are beyond outlier distance, they are still considered a defect in Roundness and Bounding Circle calculations.
Circle Gauge Impact Reference Guide Output Name What it is Output Origin Relative to Tool The found origin point, relative to the Tool Origin, if any.The origin is positioned at the circle center if the Circle type is Circle. If Circle type is ring, then it is centered at the average center of the ID and OD. Output Origin Relative To RWC The found origin, relative to the entire image space. The origin is positioned at the circle center if the Circle type is Circle.
Impact Reference Guide Circle Gauge 2. Click the ROI radio button. Position the Circle ROI over the circle or ring you want to find. Be sure that the ROI completely encloses the circle or ring. To adjust the ROI, hold the cursor over an adjustment point until the cursor changes to one shown below, then click and drag. Adjust Inner and Outer ROI Diameter Adjust Arc Length Move the ROI ROI positioned on image Adjust ROI size 3.
Line Find Impact Reference Guide 6. Click the Pass/Fail radio button. Adjust the settings in the Filter Area to define which image features you want to check. % Out of Tolerance - The percent of the edge points that can be out of tolerance. A point is out of tolerance if it is not found, is an outlier, is out of radius tolerance, or is out of ring thickness tolerance. Roundness Error - The difference between the greatest radius and least radius of all the points on the circle, including outliers.
Impact Reference Guide Line Gauge To train the tool’s scale factor: 1. Place the Wide Line ROI across the distance to be measured. If the ROI goes partly off the image during runtime, it will be clipped at the image’s edge. 2. Press the Train button. Check the endpoints found to make sure the desired distance is being measured. 3. Type the known measurement distance into the Scale Factor Train Distance field. 4. Click the Train button.
Line Gauge Impact Reference Guide Input Name What it is Noise Level The amount of background noise present in the image. Higher noise means the edges must be farther apart. Lower noise allows edges that are closer together.
Impact Reference Guide Line Gauge Output Name What it is Step Segment List A list of the step line segments (when Number of Steps is greater than 1) Number of Edges Per ROI List The number of edges found on each ROI. Step Angle NOTE: For purposes of conversion, one radian is equal to 180 divided by pi (approximately 57.296 degrees). One degree is equal to pi divided by 180 (approximately 0.01745 radians).
Line Gauge Datum Line Impact Reference Guide 2. Snap a new image and click the Train button. The tool will average the measured distances and update the scale factor. 3. Repeat step 2 as needed to average more measurements. The tool will calculate the scale factor so that the measured distance in pixels (the Output distance) equals the Scale Factor Train Distance. This factor is applied after any camera calibration factor.
Impact Reference Guide 3-127 Line Gauge Datum Line Input Name What it is Datum Line Type The tool measures from the Wide Line ROI point: Absolute Distance to Datum Line: the absolute distance to the Datum Line Signed Distance to Datum Origin X Axis: the signed distance to the Datum Origin’s X axis Signed Distance to Datum Origin Y Axis: the signed distance to the Datum Origin’s Y axis Absolute Distance to Datum Origin X Axis: the absolute distance to the Datum Origin’s X axis Absolute Distance to Datu
Line Gauge Datum Line Impact Reference Guide Input Name What it is Subpixel Method The type of subpixel averaging. The grey levels of adjacent pixels (3, 5, or 7) around an edge point are averaged and used to interpolate the edge to a fraction of a pixel. See “Subpixel Method” on page 3-125. Subpixel Position The subpixel position for edges that are not well defined. See “Subpixel Position” on page 3-144.
Impact Reference Guide Line Gauge Dual ROI Line Gauge Dual ROI In the Measurement Drawer The Line Gauge Dual ROI tool finds the distance between two points using two line ROIs. The Line Gauge Dual ROI tool can be calibrated so that the distance measured in pixels on the image relates correctly to the measurement’s real-world units. You can calibrate the tool alone, or in addition to, the camera. For example, you can calibrate the tool on a sample part as well as calibrate the camera for all parts.
Line Gauge Dual ROI Impact Reference Guide Input Name What it is Primary Use Center If True, the measurement starting point is half way between the Primary and Secondary Endpoint Positions Primary Blob Color To Find Bright, Dark, or both color objects on the Primary Wide Line ROI Primary Blob Threshold Method See “Grey Level Threshold Types” on page 3-68 for more details.
Impact Reference Guide 3-131 Line Gauge Dual ROI Input Name What it is Secondary Adaptive Blob Threshold Offset If Adaptive Threshold Method is selected, this offset is added to the adaptive threshold. This allows you to weight the adaptive threshold up or down. Secondary Noise Level The amount of background noise present in the image along the Secondary Wide Line ROI. Higher noise means the edges must be farther apart. Lower noise allows edges that are closer together.
Linear Regression Impact Reference Guide Output Name What it is Edge Point List A list of the found edge point locations Distance Segment List A list of the measured line segments Step Segment List A list of the Wide Line ROIs (when Number of Steps is greater than 1) Number of Edges Per ROI List The number of edges found on each ROI. Linear Regression In the Measurement Drawer The Linear Regression tool creates a line from a list of points.
Impact Reference Guide Midpoint Midpoint In the Measurement Drawer The Midpoint tool calculates the midpoint between two input points and provides its x-y coordinates as an output.
Multiple Point to Point Measurements Impact Reference Guide Input Name What it is Distance Type Euclidean: direct distance between the points AbsoluteX: the distance between Point One and a line through Point Two's X coordinate and perpendicular to the X axis AbsoluteY: the distance between Point One and a line through Point Two's Y coordinate and perpendicular to the Y axis Distance Type List Allows you to specify a different distance type for each point pair.
Impact Reference Guide Peak Valley Find 1. If the Points List link source tool does NOT have a Tool Origin property (e.g. the Data Instance tool), the link is made without a warning. 2. If the Points List link source property contains "RWC" in the name (it uses Real World Coordinates), and this tool’s Tool Origin is 0,0,0, the link is made without a warning. 3.
Point Match Impact Reference Guide Output Name What it is Valley List A list of valley edge points. Edge Point List A list of edge points. Peak Count A count of peak points found along the edge. Valley Count A count of valley points found along the edge. Peak Valley Find Tool Details Edges are chosen as the first edge (either rising or falling), in the direction of the line segment, that is within the given edge strength range.
Impact Reference Guide 3-137 Point Match Input Name What it is Ideal Points A point list generated from an ideal part that is used as a template for comparison. The points can be in any order. See “How Point Matching Works” on page 3-138. Actual Points A point list taken from a test part that is used to determine whether the part is defective. The point list is in no particular order relative to the ideal point list.
Point to Point Measurement Impact Reference Guide Output Name What it is Missing Points The points in this list were found in the ideal point list, but had no matching point within tolerance in the actual point list. Radial Offsets A list of radial distances from each ideal point to the corresponding actual point. missing points have a distance of zero. X-Offsets A list of distances from each ideal point to the corresponding actual point along the x-axis. Missing points have a distance of zero.
Impact Reference Guide Point to Point Measurement Input Name What it is Point Two Origin The origin the tool will use when Point Two Origin Source is set to the value Use Point Two Origin Point Two The x and y coordinates of the ending measurement point Distance Type Euclidean: Measure direct distance between the points AbsoluteX: Measure the distance between Point One and a line through Point Two's X coordinate and perpendicular to the X axis AbsoluteY: Measure the distance between Point One and a
Point to Point Measurement Impact Reference Guide 3. Point One Tab - Measurement Type: Select how you want the tool to measure the distance between the points.
Impact Reference Guide Point to Line Measurement 2. Enter the Measurement Tolerances: In the Nominal field, enter the correct measurement length, then enter the tolerances in the Minus and Plus fields. Point to Line Measurement In the Measurement Drawer The Point to Line Measurement tool measures the distance between a point and a line.A Setup is available for this tool, which simplifies basic configuration. See “How to use the Point to Line Measurement tool” on page 3-141.
Point to Line Measurement Impact Reference Guide Origin: Select this to use the X-axis line of the origin shown in the Tool Origin area. The X, Y, and Angle fields are set to zero. X1, Y1, X2, Y2: If the Line Segment is not linked, enter the coordinates in these fields X, Y, Angle: If the Origin is not linked, enter the coordinates in these fields. The measurement Origin is offset from the Tool Origin by this amount. 2.
Impact Reference Guide Subpixel Edge Extractor surement Length displayed is 100, but the distance in the real world is 200. Enter 200 in the Train Measurement Length field and click Train. The tool calculates the Scale Factor so that the measured distance in pixels (the Measurement Length) equals the Train Measurement Length. The Scale Factor is applied after any camera calibration factor. The Reset button resets the Measurement Length and Scale Factor to their original values. 2.
Subpixel Edge Extractor Impact Reference Guide Input Name What it is Fixed Grey Level Threshold Percentage The threshold value used when Grey Level Edge Detection and Fixed Threshold Edge Detection Sensitivity are selected Subpixel Position The subpixel position for edges that are not well defined. See “Subpixel Position” on page 3-144.
Impact Reference Guide Flaw Detection Drawer edge, which is quite poorly defined in this case. The bottom, middle, and top of the edge are determined by the direction of the Wide Line ROI and the Edge Polarity setting.
Average Intensity Impact Reference Guide Input Name What it is Find Shape List The desired region of the image to search. If no shape is defined, the entire image is processed. Trained Image The Input Image is copied to this input when you train the tool. You should not link an image to here, since it is replaced when you train the tool. Filter Width The maximum distance to search in the Input Image for the best gradient match (in pixels).
Impact Reference Guide Blob Blob See “Blob” on page 3-66 Bump Find In the Flaw Detection Drawer The Bump Find Tool analyzes a polygon list for bulges in the boundaries. Use the Polygon Smoothing tool (page 3-153) to smooth the polygon list before you use the Bump Find tool. The tool distinguishes between a bump or bulge defect and polygon corners or noise based on the input parameters.
Bump Find Impact Reference Guide spond to the first defect, defect points 4, 5, 6, and 7 (the next four) correspond to the second defect, and the final five points are the third defect.
Impact Reference Guide Color Blob Input Name What it is Minimum Point Count This is the minimum number of points a defect must contain to be included in the Defect List Use Area Filter If True, only defects with areas that lie within the Area Range is included in the Defect List Area Range A defect’s area must lie within this range to be included in the Defect List. This is the area included between the first and last defect point in a defect.
Extreme Difference Impact Reference Guide value. Also, since location is unimportant, non-maximal suppression is not used. Defect points tend to cluster and larger clusters indicate larger defects. The Extreme Difference tool uses concentric square regions to compare regional extremum (minimums and maximums). For example, if the tool is searching for dark regions, the minimum grey levels for the interior square and the exterior ring are calculated.
Impact Reference Guide Greyscale Template Input Name What it is Defect Type Find Bright Defects - finds bright areas Find Dark Defects - finds dark areas Find Both Defects - finds both dark and bright areas Output Name What it is Defect List The list of points found Greyscale Template In the Flaw Detection Drawer The Greyscale Template tool creates a template of an image when the tool is trained and that template is compared to the input image.
Greyscale Template Impact Reference Guide Input Name What it is Train Grey Level Threshold Type The threshold type when thresholding Train Mode is selected Train Fixed Threshold Range The threshold range when Fixed Threshold Range is selected for Train Grey Level Threshold type. The parameters are start and end. Standoff Distance The distance to erode the template from the edges. Increase this value if the Train Noise Level setting is not sufficient to accommodate the image noise level.
Impact Reference Guide Polygon Smoothing greyscale image is updated by averaging the current image with the existing model. The model tracks the number of images that have been added and weights the current image accordingly. For example, if the current image is the fourth one to be added to the model, the new model pixels are calculated by giving the current image one-fourth weight and the current model three-fourths weight.
Readers Drawer Impact Reference Guide Input Name What it is Input Polygon List A list of polygons to be smoothed Output Name What it is Smooth Polygon List The list of smoothed polygons NOTE: Polygon lists are not currently visible in VPM. To see the smoothed polygon list, use a Data Instance tool with a polygon list data type and link its input to the Polygon Smoothing tool’s smooth polygon list output. You can then promote the Data Instance tool’s shape list output to a task Output.
Impact Reference Guide 3-155 Readers Drawer Input Name What it is Fixed Grey Level Threshold Percentage The grey level threshold value for Fixed Threshold Edge Detection Sensitivity when Grey Level Edge detection is selected (0 to 100 percent) Adaptive Grey Level Threshold Offset If one of the adaptive settings is picked from Edge Detection Sensitivity, and Grey Level Edges is selected, then this offset is added to the adaptive threshold. This allows you to weight the adaptive threshold up or down.
Readers Drawer Impact Reference Guide Output Name What it is Edge Point List A list of all the points found on the Line Segment ROI. Use this list to show points on a display panel and as feedback when configuring the Edge Detection properties. How the Barcode Tool Works By default, this tool has one line segment ROI that must be drawn across all the bars of the code. (The minimum bar width is two pixels.
Impact Reference Guide Readers Drawer 2. Click the ROI radio button. Move and size the ROI so it crosses all the bars in the barcode. Note that the ROI can extend over background clutter. It can begin in the quiet zones on the left and right of the barcode, it can be angled across the barcode, and it does not have to be perpendicular to the bars. 3. The detected edges are displayed on the image.
Readers Drawer Impact Reference Guide to that type. Doing this makes the tool read faster and reduce the unlikely possibility that the tool accidently reads the barcode type incorrectly. To change the "Find" type, select a new type or select "Any Type" to automatically determine the type. 6. Verify String - If you want to verify that the barcode contains a specific string, type or link that string into the "Verify String" property.
Impact Reference Guide Character Contour Match In the tool’s "Barcode Type" list, the four UPC/EAN/JAN types are grouped into one called “UPC/EAN/ JAN”. The GS1-128 barcode is a subset of Code 128 and will decode as Code 128 in the tool’s "Barcode Type Found" property. The RSS barcode type was renamed to GS1 Databar in 2007. It is called GS1 Databar (RSS) in the list above. There are two barcodes generally named “2 of 5.
Character Contour Match Impact Reference Guide can enter 1”comma”000 as the verification string. Note that quotes are not used in the symbol library, but only in strings used for training or verification. A Setup is available for this tool, which will simplify basic configuration. Click the Setup tab to use it. (Also see “Set up the Character Contour Match tool” on page 3-161.
Impact Reference Guide Character Contour Match Input Name What it is Train Mode Determines what happens to trained characters in the Verification Library Add New: Appends trained characters to the Verification Library if they are not already recognized to be there Add New and Replace: Performs the Add New and removes characters from the existing Library which model the same letter but are not recognized as such in the trained image Delete Library and Add: Removes all characters from the current Verific
Character Contour Match Impact Reference Guide 4. Type the characters you are trying to find into the Train String value. 5. Click the Train button. 6. Enter the characters you want to verify into the Verification String value. 7. Click the Run button. Character Contour Match Train Modes These train modes update the Verification Library with characters found in the input string, based on the mode selected.
Impact Reference Guide Character Contour Match If symbols are printed on transparent parts, or imaged on the opposite side of the printing, there can be a reflection. The contrast difference of symbols printed dark on light or light on dark will not affect the decoding. The tool provides the string decoded from the symbol and a list of points indicating the found modules, as outputs. For more details, see “How the Data Matrix tool works” on page 3-165. A Setup is available for this tool.
Character Contour Match Impact Reference Guide Output Name What it is Symbol String The decoded data matrix symbol. Successful Read If True, the data matrix has been read and decoded successfully. If the Verify String is present, this also indicates that the matrix and verify string match.
Impact Reference Guide Character Contour Match cally. If necessary, you can click the check box and adjust the threshold option until all the module points are marked as Found in the image. 4. When the Automatic Module Size check box is checked, the tool automatically looks for symbols with modules of various sizes, 4, 8, 12, etc. If you enter a different module size, then the tool only looks for codes with modules of that size. The minimum recommended module size is 3 pixels. 5.
Character Contour Match Impact Reference Guide Another issue may include matrix inking. For this problem you can use morphology filters. For a dark on light matrix, use open morphology for light inking and close morphology for heavy inking. After using these tools, most matrices should be more readable. Structured Append The Structured Append outputs apply to symbols that are part of a structured append.
Impact Reference Guide Code Reader The number of byte errors indicates symbol or location quality. Each byte corresponds to eight modules or cell locations, so up to eight module errors can fit into a single byte error. The number of correctable errors is based on the size of the matrix. For example, in a 14 x 14 matrix, five byte errors are correctable. The data portion is 144 modules (12h x 12w = 144). These 144 data modules are divided into 18 bytes (144 modules / 8 bytes per module = 18 bytes).
Code Reader Impact Reference Guide Input Name What it is Processing Mode When you Train the tool, the Processing Mode for the best results is automatically selected. Some input properties are only effective when Advanced mode is selected. These properties are labeled "Processing Mode Advanced" (PMA) in this table. See “Code Configuration Processing Modes” on page 6-35. Standard: Normally used for most applications.
Impact Reference Guide Input Name What it is MSI If True, the tool looks for this code type when it runs. Matrix 2 of 5 If True, the tool looks for this code type when it runs. EAN/UPC If True, the tool looks for this code type when it runs. EAN/UPC Add On 2/5 If True, the tool looks for the 2 and 5 supplemental digits added to the right of the EAN/UPC code when it runs. Pharmacode (onetrack) If True, the tool looks for this code type when it runs.
Code Reader Impact Reference Guide Input Name What it is Code Quality Verification (PMA) To enable verification grading, this input must be set to True before Training. ISO/EIC and AIM DPM code quality grades are generated for each found code, where applicable. The grades appear on their respective outputs and on the Setup Grades panel. See “Code Quality Grades” on page 6-39. 1D Advanced Box Improvement If True, the tool increases the precision of the decoding ROI around a 1D code when it runs.
Impact Reference Guide 3-171 Code Reader Input Name What it is 1D Check Digit Status (PMA) If True, the check digit control is enabled to improve decoding safety. The check digit is generally the last digit aligned to the right of the code which verifies the validity of the preceding digits. The calculation technique and number of check digits depends on the code type. The check digit should be used whenever the code contains one.
Code Reader Impact Reference Guide Input Name What it is 1D Pharmacode Code Orientation (PMA) The code’s expected orientation. Horizontal: the code is aligned to the x axis (+/- 45°) Vertical: the code is aligned to the y axis (+/- 45°) 1D Pharmacode Reverse Decoding (PMA) Indicates whether to read the code in the reverse direction. The default setting of False is not changed during Training. To use the Reverse property it must be manually selected on the Properties tab.
Impact Reference Guide 3-173 Code Reader Input Name What it is Pass Fail Enable List See “Using the Pass Fail Filters” on page 3-179. Pass Fail Code Type List See “Using the Pass Fail Filters” on page 3-179. Pass Fail Match Code List See “Using the Pass Fail Filters” on page 3-179. Pass Fail Min String Length List See “Using the Pass Fail Filters” on page 3-179. Pass Fail Max String Length List See “Using the Pass Fail Filters” on page 3-179.
Code Reader Impact Reference Guide Output Name What it is First Code Decoding Time (micro sec) The time required to decode the first found code that passed its filters. Ideal for single code applications. Code ROI List A list of the ROIs of each of the found codes that passed their filters. The ROIs’ locations are relative to the Tool Origin property. Code ROI Origin List A list of the Origins of each of the found codes that passed their filters.
Impact Reference Guide 3-175 Code Reader Output Name What it is ISO/IEC 15416 Defects Grade Defects are irregularities found within elements and quiet zones, and are measured in terms of element reflectance non-uniformity. Element reflectance non-uniformity within an individual element or quiet zone is the difference between the reflectance of the highest peak and the reflectance of the lowest valley.
Code Reader Impact Reference Guide Output Name What it is Pass Fail Number of Found Codes List A list of the Actual number of codes found and passed based on the Pass Fail group of Input Property settings. See “Using the Pass Fail Filters” on page 3-179. Unicode Output String If the found code contains any text with ISO-8859-1 encoding, this string provides it in UTF-8 format. Unicode Output String List A list of found ISO-8859-1 encoded text in UTF-8 format. How to Set Up the Code Reader tool 1.
Impact Reference Guide Code Reader NOTE: The tool will train on a maximum of thirty code symbols in one image. Additional symbols are ignored and a warning message is displayed below the image. A check indicates the Code Type is enabled. 8. Click the Pass/Fail Radio button. The tool’s Pass/Fail status and statistics about found codes are displayed. If there are multiple codes in the image, select an ROI to display that code’s statistics. 9.
Code Reader Impact Reference Guide The following example shows two filters. The first one will pass only if the image contains two Datamatrix ECC200 codes (Min # = 2) that start with the string "728" (Match String = 728*). The second filter will pass if the image contains any UPC-A code (Match String = *). The first filter fails because the image contains only one Datamatrix ECC200 code (Act # = 1) that has a string that starts with "728." Because the first filter fails, the tool fails.
Impact Reference Guide Code Reader 5. If you want to generate quality grades for any of the codes you are reading, you must leave the Enable Verification Grading check box selected. 6. Enter the Minimum Number of Codes to Train. 7. Click the Train button. 8. For any additional code types you want to train, repeat steps 1 through 7. Using the Pass Fail Filters You can define one or more filters to test the characteristics of the defined codes found in the image.
OCR Impact Reference Guide • one or more characters follow the "R" character (using the "*" Wildcard character). If you include only the Wildcard in the Pass Fail Match Code, all decoded strings are matched. Composite Codes If the Composite Code input property is True, the tool decodes two different code types: • The first code is one of these 1D codes: GS1 128, Code 128, GS1 Databar, GS1 Databar Stacked, GS1 Databar Limited, GS1 Databar Expanded, or GS1 Databar Expanded Stacked.
Impact Reference Guide OCR A Setup is available for this tool. See “How to set up the OCR tool” on page 3-183. 3-181 Input Name What it is Input Image Linked Image Tool Origin The tool’s origin relative to the entire image space Region of Interest The area of the image that contains the characters. May contain only one row of characters Threshold Type See “Threshold Types” on page 3-186.
OCR Impact Reference Guide Input Name What it is Verify String If this string is present, the tool compares this string to the input string. Successful Read is True if all characters, in order, in the input string match this string.
Impact Reference Guide OCR Output Name What it is Character Success List A list of each character’s match success or failure. If there are missing or extra characters in the Output String, the tool will identify and skip over them, allowing the rest of the string to match.
OCR Impact Reference Guide character widths may change from image to image. See “Dealing with undesired results:” on page 3185. 5. If you want to link in a font library you have already created, click the Link button. 6. Click the Train radio button. In the Train - String field, enter the characters that you want to verify in the image. Select Add New from the Mode drop down. This will add the found character models to the Font Library.
Impact Reference Guide OCR Maximum Percent Size Change determines how much the read character’s size can change from the trained character’s size. OCR Train Modes These train modes update the Font Library with characters found in the input string, based on the mode selected. • Add New This mode adds any characters that are not recognized (new or different) in the input string to the Font Library.
OCR Impact Reference Guide • Characters must have at least a one pixel column of vertical separation between them. If they overlap vertically, then they can not be read. However, if the characters are on a fixed pitch, then the "Maximum Character Width" parameter can be used to force them to break apart. In some cases, filter preprocessing can also be used to separate characters. Characters should be a minimum of twenty-eight pixels high for best results.
Impact Reference Guide Communication Drawer This sets the upper and lower thresholds automatically based on all the grey levels in the ROI. The lower threshold is set to 0%, and the upper threshold is set to a value somewhere in the valley between the bright pixel and the dark pixel peaks. The exact value depends on the statistics of the two peaks. Dark pixels are thus considered in-range. This setting is best used when looking for a bright part of an image with non-uniform grey levels.
Discrete Output Impact Reference Guide Output Name What it is BCD Output Valid If True, Interpret as BCD is True and the Input values produced a valid BCD value Input 1 to maximum The state of the respective input (The number of inputs is determined by the device type. Emulators have 16 inputs.) How to set up the Discrete Input tool 1. Click the Setup tab, then click the Setup & Test radio button. 2.
Impact Reference Guide Discrete Output Input Name Data Pulse Reset Method Indicates how each of the outputs should be reset after the tool runs. (Pulsed Output Timing only) Pulse Reset State Each bit of this integer value indicates the desired state of the corresponding output after the tool runs. This value has the same effect as the State input. Used when Pulse Reset Method is set to Use Pulse Reset State.
Discrete Output Impact Reference Guide Note: You should only enable those outputs you want to turn on or off. If an output is enabled, and its corresponding State value bit is not set correctly, the output may be in an undesired state after the tool runs. State If an output is enabled by its corresponding bit in the Mask value, the State’s value determines whether the tool turns an output on or off.
Impact Reference Guide Discrete Output Dwell (in milliseconds or events) determines the length of time the output is on or off. These diagrams show the output pattern based on the Output Timing Pattern setting. Immediate Set and Hold Delayed Set and Hold Immediate Pulse Delayed Pulse How to set up the Discrete Output tool 1. Click the Setup tab, then click the Setup & Test radio button. 2.
EtherNet/IP Introduction Impact Reference Guide 3. Set & Test Outputs: This section is where you define what you want an output to do. Note: The number of outputs shown will vary with the Impact device type. Emulators have sixteen outputs. On, Off, Unchanged: Click the radio button under the desired output for the desired output state when the tool runs. If the output is already in that state, the tool does not change it, unless a pulse was defined.
Impact Reference Guide EtherNet/IP Read Implicit Assembly Additional inputs and outputs can be added. Data values in the added inputs are sent with the message, while values in the added outputs are filled in when the message from another device is received. You can use an EtherNet/IP device’s data sheet to provide the appropriate values for each input and output. To create a new input our output, click the appropriate Add button, then select the data type from the type properties drop down.
Impact Send Message Impact Reference Guide The EtherNet/IP Write Implicit Assembly tool provides a method for writing to a reserved data area (called a static assembly) on the Impact device. Other EtherNet/IP devices can read data from this area. Additional inputs, which are appended to the static assembly, can be added. To create a new input, click the Add Input button, then select the data type from the type properties drop down. The tool has an additional General property - Offset.
Impact Reference Guide Impact Send Message How to set up the Impact Send Message tool The Impact Send Message tool sends data to a corresponding Impact Wait For Message tool. You define the data you want to send by adding Inputs on the Message panel. The tool will still work properly if no Inputs are defined. The Message Destination is defined on the Destination panel.
Impact Send Message Impact Reference Guide To link a value into an Input 1. Click the desired Input in the Input list. 2. Click the Link button. 3. Select the desired tool and property from the Task tree. To delete an Input link 1. Click the desired Input in the Input list. 2. Click the "x" on the left side of the Value field (under the Value column). To delete an Input 1. Click the desired Input in the Input list. 2. Click the "x" on the far left side of the Input entry (under the Name column).
Impact Reference Guide Impact Wait For Message 2. Click the Browse button. When the Select Message Destination dialog is displayed, select the desired Destination Camera from the list. 3. Click OK. The camera’s IP Address and name is displayed. 4. Enter the desired Message Number in the Message Number field (from 0 to 255). There should be an Impact Wait For Message tool in a task in the Destination Camera that uses the same Message Number. 5. To test the tool, click the Send button.
Impact Wait For Message Impact Reference Guide Input Name What it is Enable Maximum Timestamp Difference NOTE: To use this tool with an A, T, or C Series smart camera, this property must be disabled. When the tasks containing an Impact Send or Wait For Message tool are triggered, the input events are time stamped. If the difference between the Send task and the Wait task time stamps is greater than this value (in milliseconds), this tool fails.
Impact Reference Guide Impact Wait For Message 2. Click the Add button. 3. When the Add Output dialog is displayed, enter the name for the Output 4. Click the Type drop down and select the type of the data you want to receive. 5. Click OK. Defining the Message Receiver To receive a message, you need to define the Receiver parameters which include the message number. The corresponding Impact Send Message tool must have the same Message Number. To define the Receiver 1.
Serial Port Out Impact Reference Guide exceeded, the tool fails and the message data and Actual Timestamp Difference values are not written to their respective properties. • Message Number - Enter the desired Message Number in the Message Number field (from 0 to 255). There should be an Impact Send Message tool in a task in the Camera listed in the Camera field that uses the same Message Number.
Impact Reference Guide TCP/IP Out 2. Select the type of data the tool will send - a string or an Integer List. String - You can type a string directly into the Data to Send field, or create a link. Integer List - can contain any valid integer value but, since each value is translated into a 1-byte character, any value outside the range -128 to +127 is truncated before it is sent. You can use a Basic tool to unpack, translate, and repack larger integer values, if necessary.
TCP/IP Out Impact Reference Guide 7. If you want the tool to disconnect from the remote device after the data send is complete, check the check box labeled "Disconnect After Each Send." See “Disconnect After Each Write” on page 3-204. 8. In the field labeled "Check for Successful Send after Delay," enter the number of milliseconds the tool should wait between the data send and a check for success. 9. The receiving device may require that a special character (delimiter) be appended to the data it receives.
Impact Reference Guide TCP/IP Out 13. In the TCP/IP section, be sure the TCP/IP Input Event Port number is 10,000. This is the port number where the local Impact device listens for messages. (Step 8 in the local Impact device configuration.) 14. Click the Test Data Send button. The data you entered in step 4 should have been sent to the local Impact device. The following inputs are available in the tool.
Logic Drawer Impact Reference Guide Output Name What it is Write Succeeded If Connection Type is Server, this value is always True and doesn't relay the number of successful remote client message transmissions. It is the responsibility of the remote client to actively manage the health of the connection. If Connection Type is Client, this value is True when the data was received by the remote device within the time defined in the Error Check Delay property.
Impact Reference Guide Branch to test the validity of your Basic code. The code is also compiled when you select a different tool. When you click the Run button, the Basic program results appear in the properties pane. Click in this window, then type Variable names (e.g. count) the desired Basic language are automatically created as statements. inputs. Set the variable type here. In the example above, the variable "count" is incremented each time the tool runs, then reset to zero when it reaches five.
Break Impact Reference Guide The tools in the False branch are executed if ImageID is greater than or equal to zero. If ImageID is greater than or equal to zero, the statement is False and the tools in the False branch run. The Branch tool evaluates the basic language expression: ImageID < 0. If it is True, the tools in the True branch run. Input Name What it is Basic Expression A Basic language expression.
Impact Reference Guide Counted Loop NOTE: The called task should have the Trigger Event Type set to None. Counted Loop In the Logic Drawer The Counted Loop tool loops a user-specified number of times. The starting and step-increment values may also be defined. Any tool may be used within the loop.
Data Instance Impact Reference Guide 7 7 False Count + Increment Count = Limit so Success set to False 8 8 False Count + Increment 9 9 False Count + Increment 10 0 True Count + Increment Count = Rollover so Count set to Reset Value Count < Limit so Success set to True Input Name What it is Count The current Count Reset Value When the Count value equals the Rollover value, the Count value is set to the Reset value and the Success output is set to True.
Impact Reference Guide Delay The Data Set tool is used to "push" data to another tool. Each data type has a specific set of data elements that can be accessed. The Data Set tool can be used to access these data elements individually then link them into other tools using its general property, Destination. When this tool runs, its data values are "pushed" into the linked tool’s values.
Group Impact Reference Guide Group In the Logic Drawer The Group tool provides a way to group and organize tools within the task tree. To add a tool to a group 1. If necessary, click the Expand Properties icon to the left of the tool. 2. Drag a tool from the tool box and drop it in the desired place under the Group tool. To add a tool to the top of the group, drop it on the branch icon. To add a tool to the end of the group, drop it on the bottom tool in the group.
Impact Reference Guide Multiple Branch Input Name What it is Sort Feature The feature in the list that determines the sort order. Sort Order The order in which to sort the list. Output Name What it is Sorted List The sorted list. Multiple Branch In the Logic Drawer The Multiple Branch tool provides multiple branches based on multiple conditions. When it runs, the tool evaluates user-defined Basic-language expressions.
Pass Fail Impact Reference Guide When you add the Pass Fail tool, it automatically creates a list of the tools above it in the task tree that have a pass/fail status (the input tools). Click the Setup tab to configure the Pass Fail tool. Pass Fail tool Setup window • Pass/Fail: This is the pass or fail status of the Pass Fail tool. After all the input tools’ pass/fail statuses have been evaluated, this LED is green if the Pass Fail tool passed and red if it failed.
Impact Reference Guide Reset Input Name What it is Input ... Any inputs that have been added are listed in this section. Click the Add Input button on the Setup tab to add inputs. Invert Input ... If true, the input tool’s value is inverted or reversed before it is used to determine the Pass Fail tool’s status. Output Name What it is Pass Indicates the pass or fail status of the Pass Fail tool after all the input tools’ pass/fail statuses have been evaluated.
Device Settings Impact Reference Guide The tools in the False branch are executed if TriggerId is greater than zero. The Branch tool evaluates the expression: TriggerID < 0. If it is True, this is the first image so the Camera Trigger tool snaps a second image and assigns it a positive ID number. The Sample Top tool then processes the first image. If the Trigger ID is positive, it is the second image from the Camera Trigger tool so the image is processed by the Locate Label tool.
Impact Reference Guide 3-215 Device Settings Input Name What it is Enable Camera Shutter Speed If True, this tool’s Camera Shutter Speed value is sent to the camera when the tool runs. Camera Shutter Speed Shutter Speed (Open Time) indicates the amount of time the shutter is open. The higher the number, the longer the shutter is open and the brighter the image. Enable Camera Internal Correction If True, the camera’s internal correction is enabled when the tool runs.
Offline Impact Reference Guide Input Name What it is Enable Strobe 1 Duration If True, this tool’s Strobe 1 Duration value is sent to the camera when the tool runs. Strobe 1 Duration Strobe 1 pulse length in microseconds Enable Strobe 2 Duration If True, this tool’s Strobe 2 Duration value is sent to the camera when the tool runs.
Impact Reference Guide Vision Program Save Vision Program Save In the Device Control Drawer The Vision Program Save tool saves the current vision program file to the Impact device when it runs. There are no output values. Input Name What it is Filename The name of the vision program file to be saved, without the file extension (.vp is added by default). If you enter the name of an existing file, that file is overwritten. Program Name The name of the program in the vision program file.
Specialized Drawer Impact Reference Guide Specialized Drawer Change Image Calibration In the Specialized Drawer The Change Image Calibration tool is intended for use in situations where the camera or part moves to a new position that requires a different calibration between camera snaps. The input image’s calibration data are replaced with the calibration data stored in the tool. The camera’s calibration is not changed. This tool has one input, the image, and no outputs.
Impact Reference Guide Clip ROI Since the camera is calibrated for position A, all camera images are calibrated for position A by default, and there is no need for a Change Image Calibration tool trained at position A. When the Change Image Calibration tool runs, it will put the stored calibration data for position B into the image. All the tools that follow it will use the image with calibration B, even though they are using the current input image.
Grid Statistics Impact Reference Guide Grid Statistics In the Specialized Drawer The Grid Statistics tool provides extensive statistics about a series of points in a grid pattern. This tool can be used analyze components such as contacts on electrical connectors, Ball Grid Array (BGA) ball spacing, or other components where a grid of found points must be compared to an ideal list. This Grid Statistics tool matches an Ideal Points list and an Actual Points list within a given set of tolerances.
Impact Reference Guide 3-221 Grid Statistics Input Name What it is Create Pitch Segments If True, the X pitches and Y pitches between the Ideal points and corresponding Actual points are created as output Line Segment lists. A separate output Line Segment list is provided for the X Pitches and the Y Pitches.
Grid Statistics Impact Reference Guide Output Name What it is Y Pitches The Actual Y Pitch distances between consecutive points or Columns using the Actual Point list data. The last point in a column or row in the grid will have a pitch value calculated to the previous row or point in the column. Pitch Results A list of the pass/fail status of the X and Y Pitch measurements between sequential Actual Points.
Impact Reference Guide Lead Statistics Output Name What it is Ideal Points Relative to Tool Origin A copy of the Ideal point list that have been moved by a distance equal to the Grid Offset coordinate. This is the X Offset, Y Offset, and Angle that the entire grid would be moved to perform the Best Fit alignment of the Ideal point grid to the Actual point grid.
Train Datalogic Automation Inc.
C H A P T E R 4 Control Panel Manager Introduction This section discusses the Control Panel Manager, the graphical tool for creating Control Panels. The Impact device can be accessed from any client computer on the network that has the software installed on it. Help If you need help while using the Impact software, you can refer to this manual or the online help.
CPM User Interface Impact Reference Guide CPM Security When you open a Control Panel in CPM, the Connector Control may attempt to connect to an Impact device or Emulator. If security is enabled on the device, the User LogOn dialog is displayed. You must enter a valid user ID and password to connect the Control Panel to the device. If you do not log on, you can still modify the Control Panel, but you will not be able to update any data or images on the Control Panel.
Impact Reference Guide Main Toolbar This connection is not the same as the one provided by the Connector control. When you connect with this button, CPM is connected to the device so that the VPM Task(s) in the device can be displayed. You can then make links between the task tool’s properties and the Control Panel. Links to VPM cannot be created if this button is disconnected.
Main Toolbar Impact Reference Guide This opens a browser so you can load a Control Panel template to create a new Control Panel Application. Only one Control Panel Application may be open at a time. An application may contain multiple Control Panels. Several templates are provided with CPM, or you can click the Create Empty Application button to create one. You can also create controls or groups of controls, then save them as Control Panel templates.
Impact Reference Guide Main Toolbar Print Control Panel tree Use this button to print a formatted, expanded list of all properties and values in the currently selected application, Control Panel, or control to a chosen printer. (Connector Control Events, Methods, and Links are not listed.) Print preview of Control Panel tree Use this button to preview a formatted, expanded list of all properties and values in the currently selected application, Control Panel, or control.
Task and Panel Toolbar Impact Reference Guide • Use internal on-screen keyboard: If this is selected, and Enable automatic on-screen keyboard is checked, an internal built-in, on-screen keyboard application is used for entering text and numbers. See zzzz for details. • Use External on-screen keyboard: If this is selected, and Enable automatic on-screen keyboard is checked, an external, third-party, on-screen keyboard is used for entering text and numbers. See “OnScreen Keyboard” on page 6-11 for details.
Impact Reference Guide Control Palette Control Palette Open/Close Control Groups (Control Palette must be enabled. See “Select Design View Options” above.) Controls are grouped in the palette according to common functions. Click the control group header to open or close the group list. Individual controls are explained in more detail under “CPM Controls” on page 4-23.
Control Panel Tree Impact Reference Guide This is an example of a tool with the properties expanded, showing the Input, Output, and Method properties. Control Panel Tree (Control Panel Tree must be enabled. See “Select Design View Options” on page 4-6.) This is a graphic representation of the controls on the Control Panel Canvas. Controls do not need to be in any particular order. You can add controls here or on the Canvas.
Impact Reference Guide Image Display To change the order of controls 1. Select the control you want to move in the Control Tree. 2. Click and drag the control up or down to the desired location. Control Panel App Click this icon to access Control Panel Application properties. See “Control Panel Application” on page 4-9 for details about creating a Control Panel Application and its properties. Control Panel Click this icon to access Control Panel properties.
Control Panel Application Impact Reference Guide must have a unique name, although Control Panels with the same name may be stored in different Control Panel Application files. To create an empty Control Panel Application 1. Click the New Control Panel Application button. 2. Click the Create Empty Application button in the Select Template browser. New 3. Add Control Panels as desired. (See “Control Panel” on page 4-11.) To create a Control Panel Application from a template 1.
Impact Reference Guide Control Panel Property Name What it is Control Color This property controls how some input controls are displayed in a control panel. For more details, see each control’s properties. System: The controls have rounded corners and a "3D" look. The Button Color and Border Painted properties for the Button and Toggle Button are disabled. New control panel applications default to this setting. CPM Classic: The controls have square corners and a "flatter" look.
Control Panel Impact Reference Guide To add a Control Panel to a Control Panel Application 1. Click the Add a Control Panel button. 2. Click the Select Design View button and select the Control Palette option so the Control Palette is displayed. 3. Add controls to the panel as desired. See “Add Controls to a Control Panel” on page 4-13 for more details. The following Control Panel properties, methods, and events are available.
Impact Reference Guide Control Panel 3. On the Properties tab, enter the desired panel width and height (in pixels). The Recommended values show the calculated width and height based on the current screen resolution. The Recommended Height without toolbar is used when the panel is run in CPM Runtime with no toolbar. Add Controls to a Control Panel There are three ways to add Controls to a Control Panel.
CPM and VPM Linking Impact Reference Guide CPM and VPM Linking Impact Device VPM Vision Program Control Panel Impact Connector Control Tool A Control 1 Tool B VPM to CPM Links Control 2 CPM to CPM Links VPM to VPM Links Impact Connector Control In CPM, links can be made between vision programs and tasks on the Impact device and Control panels on the host. The links create an information path to the device through the Impact Connector control.
Impact Reference Guide Links between CPM and VPM Links between CPM and VPM The following kinds of links can be made between a VPM task or tool and a CPM control: • Get Data Link: a CPM control property receives data from a VPM tool or task property • Set Data Link: a CPM control property sends data to a VPM tool or task property • Method Link: a CPM property sends data to a VPM tool or task method property such as Run or Train • Data Transfer Link: a CPM control property receives data directly from a VPM
Links between CPM and VPM Impact Reference Guide To create a Set Data link, hold down the Shift key while you select the property in VPM with the left mouse button, then drag and drop it onto an empty spot on the Control Panel Canvas or the Control Panel Tree. This table lists the control choices for a drag and drop Set Data link.
Impact Reference Guide Links between CPM and VPM Property Data Type Existing Control Default Control Added - Default Property Wide Line Segment List Image Display Line List ROI - Wide Line List Wide Circular Arc Image Display Arc ROI - Wide Circular Arc Circle Correlation Model Image Display Circle Correlation Model Set Data To create a Set Data link, hold down the Shift key while you select the desired property in VPM with the left mouse button, then drag and drop it onto an existing control
Links between CPM and VPM Impact Reference Guide 3. Expand the properties for the tool you want to link. Both Inputs and Outputs can be used to create Get Data links. 4. Left-click on the desired property, drag it to the Control Panel Canvas or the Control Tree, and release it. If you drop it on the Control Tree, the new control is added in the Control Tree and in the upper left corner of the Canvas. 5. Repeat step 4 until all links have been made. To create a Set Data link using drag and drop 1.
Impact Reference Guide Panel Icon Links between CPM controls 5. To add the link to an existing control, hold the mouse cursor over the control and right-click.The choices displayed will depend on the VPM property data type and the compatible data types in the control. If the control does not have a compatible data type, no choices are displayed. To add the link to a new control, hold the mouse over a blank area on the Canvas, or the Panel icon in the Control Tree and right-click.
Links between CPM controls Impact Reference Guide • Destination control: The control’s property that receives the value when the link selection is "Set link to here." For example, if you select "Set link to here" on an Indicator Light’s property, then link to a Toggle Button’s property, the Indicator Light is the Destination. • Ending control: The control that is selected to end the link process. When you create right-click links, the beginning control normally keeps the focus when the link is complete.
Impact Reference Guide Links between CPM controls There are two ways to create a link between controls. You can use left-click drag and drop, or right-click. This section describes how to create drag and drop links. See “Create Right-Click Links in CPM” on page 421 for right-click links. When you create a drag and drop link, CPM will always give you choice of what destination property, method, or event should get the link. The choice shown depends on the type of source data you are linking.
Links between CPM controls Impact Reference Guide Ending control when the link is complete, hold down the Ctrl key while you left-click on the desired Ending control property. To create a link from one control (source) to another (destination) using right-click 1. Display the Control Panel Tree if you want to use it to add links. 2. Select the beginning control from the Canvas or the Control Panel Tree and click the Properties, Methods, or Events tab. 3.
Impact Reference Guide CPM Controls To open the Link Browser window, click the Links tab. Print Advanced/Basic Browser Control Name Print Preview Print to Text File Hover over link for tooltip To expand the browser window to include additional fields, click the Advanced Browser button. The link direction arrow points from the source to the destination. The following fields are displayed in the browser window, from left to right.
CPM Control Palette and Groups Impact Reference Guide Data, Method, and tabs. See “Control Panel” on page 4-11 for details about adding controls to a Control Panel. NOTE: All distances are in pixels, unless otherwise noted. All X coordinates are referenced to the left edge of the panel. All Y coordinates are referenced to the top edge of the panel. CPM Control Palette and Groups CPM controls are contained in the palette and grouped within groups based on their general purpose.
Impact Reference Guide Images Group Images Group D y n a m i c R O I To o l t i ps All controls have a Tooltip Text property. The text in this property is displayed when the cursor is held over the control. Tool tips for Image controls with ROIs can contain special keywords that will be replaced by information about the ROI. Each type of Image control uses different keywords. Text may be interspersed with keywords, and more than one keyword can be used in a tooltip text property.
Histogram Impact Reference Guide ROI Type Keyword Rectangle Circle Polygon Properties Displayed See Rectangle ROI type above %extents% X and Y, radius %location% X and Y %hints% description of editing that can be performed %extents% X and Y of each polygon vertex %location% X and Y of the vertex "grab region" closest to the mouse %vertex% The number of the vertex with a "grab region" closest to the mouse %hints% description of editing that can be performed Histogram The Histogram contro
Impact Reference Guide 4-27 Histogram Property Name What it is Background Color Click in the field to select a color for the control’s background Transparent Background If True, the control’s background is transparent. The Background Color property is ignored. Primary Threshold Midpoint Cursor Color Click in the field to select a color for Primary Threshold Midpoint Cursor.
Image Display Impact Reference Guide Event Name When it happens Threshold Range Changed When either Threshold Range value changes Image Display The Image Display control displays an image from a vision program. If Auto Image Save Enabled is true, the displayed image is saved to a file with .png extension. The image is linked to the Impact Connector control from a vision program task then linked to this control.
Impact Reference Guide 4-29 Image Display Property Name What it is Auto Image Save Type If All is selected, displayed images are saved to the Save Image Path with the name in the Auto Image Save All Name property. If Failed is selected, displayed images with the Image Passed property of false are saved to the Save Image Path with the name in the Auto Image Save Failed Name property.
Image Display Impact Reference Guide Property Name What it is Display Orientation Normal: The image is displayed without rotation 90: The image is rotated 90 degrees clockwise. 180: The image is rotated 180 degrees clockwise. 270: The image is rotated 270 degrees clockwise. Note: This changes only the image and ROI display orientation, the display coordinates remain the same.
Impact Reference Guide 4-31 Image Display Property Name What it is Zoom The zoom factor for the displayed image, with 1.0 as the default. For example, if Zoom is 2.0, the image is displayed twice its size. If you enter a value of -1, the value is automatically adjusted so the image fits the Image control. If you enter a value of -2, the value is automatically adjusted so the image and the ROIs fit the Image control.
Arc ROI Impact Reference Guide Arc ROI The Arc ROI control displays an Arc ROI on the displayed image. The origin is linked from a vision program tool output. See “ROI Color Properties” on page 4-34 for more ROI color properties information. Note: You must have an Image Display control in the Control Panel to add this control. Property Name What it is Arc Angle The ROI’s angle (in radians). One radian is equal, in degrees, to 180 divided by pi. One degree is equal, in radians, to pi divided by 180.
Impact Reference Guide Blob List Method Name What it does Disable Editing Disables the ability to edit the control Enable Editing Enables the ability to edit the control Hide Makes the control invisible Show Makes the control visible Event Name When it happens Extents Edited When the ROI is modified either with the mouse or by changing one of the extent’s properties.
Blob List Impact Reference Guide Property Name What it is Tooltip Text Text displayed when the cursor is held over the control in Run mode. Fill Color Transparency The ROI’s transparency, from 0 to 100 percent. True Color Click in the field to choose the ROI’s True color. True State Visible If True, the ROI is visible when it’s State is True. Use True Color If True, the ROI is colored in the True Color. Visible If True, the control is visible.
Impact Reference Guide Blob List Property Name What it is Contour Model Link the Contour Model for the ROI from a vision program tool. Origin Link the origin from the vision program tool. Origin Angle The angle of the linked tool’s origin. Origin Color Click in the field to choose the origin’s display color. Origin Visible If True, the linked tool’s origin is visible. Origin X The X coordinate of the linked tool’s origin. Origin Y The Y coordinate of the linked tool’s origin.
Greyscale Template Model Impact Reference Guide Property Name What it is False Color Click in the field to choose the ROI’s False display color. Selectable If True, the ROI can be selected. ToolTip Text Text displayed when the cursor is held over the control in Run mode. Use True Color If True, the ROI is colored in the True Color. Visible If True, the ROI is visible.
Impact Reference Guide Line List Method Name What it does Hide Makes the control invisible Show Makes the control visible Line List The Line List ROI control displays line ROIs on the displayed image. The line list and origin are linked from a vision program tool output (with the data type Line Segment List). See “ROI Color Properties” on page 434 for more ROI color properties information. Note: You must have an Image Display control in the Control Panel to add this control.
Line ROI Impact Reference Guide Property Name What it is Wide Line List Link the Wide Line List from a vision program tool’s Wide Line Segment List. Width The ROI’s display width. Width Visible If True, ROIs is drawn the width indicated by the Width property. If False, ROIs is drawn one pixel wide.
Impact Reference Guide 4-39 Line ROI Property Name What it is Mid Point Y The Y coordinate of the ROI’s midpoint. Movable If True, the ROI can be moved. (The Selectable property must be True.) Origin Link the origin from the vision program tool. Origin Angle The angle of the linked tool’s origin. Origin Color Click in the field to choose the origin’s display color. Origin Visible If True, the linked tool’s origin is visible. Origin X The X coordinate of the linked tool’s origin.
Origin Impact Reference Guide Event Name When it happens Selected Enables the ability to edit the control Unselected Makes the control invisible Origin The Origin control displays an Origin linked from a vision program tool output. A tool’s origin can be linked directly to controls that display an ROI. This control is used primarily to display only the Origin ROI. See “ROI Color Properties” on page 4-34 for more ROI color properties information.
Impact Reference Guide Origin List Property Name What it is Y The Origin ROI’s Y coordinate. Method Name What it does Disable Editing Disables the ability to edit the control Enable Editing Enables the ability to edit the control Hide Makes the control invisible Show Makes the control visible Event Name When it happens Extents Edited When the ROI is modified either with the mouse or by changing one of the extent’s properties.
Point List Impact Reference Guide Property Name What it is Origin X The X coordinate of the linked tool’s origin. Origin Y The Y coordinate of the linked tool’s origin. Radius The radius of a circle drawn around the control’s ROI, in pixels. State List Link the boolean list from the vision program tool. This indicates the ROI’s True or False State. Selectable If True, the ROI can be selected. Sizable If True, the ROI can be resized. (The Selectable property must be True.
Impact Reference Guide Rectangle List Property Name What it is Color by States If True, the ROI is colored with the True or False Color based on its state from the State List. False Color Click in the field to choose the ROI’s False color. False State Visible If True, the ROI is visible when it’s State is False. Origin Link the origin from the vision program tool. Origin Angle The angle of the linked tool’s origin. Origin Color Click in the field to choose the tool’s origin color.
Rectangle List Impact Reference Guide Note: You must have an Image Display control in the Control Panel to add this control. Property Name What it is Color by States If True, the ROI is colored with the True or False Color based on its state from the State List. False Color Click in the field to choose the ROI’s failing display color. False State Visible If True, failing ROIs are displayed in the False Color. Draw Filled If True, the ROI is filled with the appropriate True or False Color.
Impact Reference Guide Rectangle ROI Event Name When it happens Extents Edited When the ROI is modified either with the mouse or by changing one of the extent’s properties. Selected Enables the ability to edit the control Unselected Makes the control invisible Rectangle ROI The Rectangle ROI control displays a Rectangle ROI on the displayed image. The rectangle extents and origin are linked from a vision program tool output.
Shape List Impact Reference Guide Property Name What it is Width The control’s width. X The X coordinate of the control’s left edge. Y The Y coordinate of the control’s top edge.
Impact Reference Guide 4-47 Shape List Property Name What it is Origin Y The Y coordinate of the linked tool’s origin. Selectable If True, the ROI can be selected. Shape List Link the Shape List from the vision program tool. Sizable If True, the ROI can be resized. (The Selectable property must be True.) State List Link the boolean list from the vision program tool. This indicates the ROI’s True or False State. Tooltip Text Text displayed when the cursor is held over the control in Run mode.
Input Group Impact Reference Guide Input Group Button When the Button control is pressed, it produces an action which can be linked to other controls. This action can be used, for example, to start and stop updates, connect to the Impact device, and put the device online and offline. Property Name What it is Button Color Click in the field to choose the button’s color. (The Visible property must be True to see the button.
Impact Reference Guide Check Box Property Name What it is ToolTip Text Text displayed when the cursor is held over the control in Run mode. Icon Click in the field to place an icon on the button. Icon files may have these extensions: gif, jpg, png, and bmp. The icon file must be on the same disk drive as the Control Panel file. Vertical Text Position The button label’s vertical alignment relative to the icon. Visible If True, the button is visible.
Drop List Selector Impact Reference Guide Property Name What it is Unselected True if the check box is currently cleared. CheckBox Label The text displayed on the check box. Some special characters will not display in this property. See “Special Characters” on page 4-97. Selected If True, the check box is checked. ToolTip Text Text displayed when the cursor is held over the control in Run mode. Transparent If True, the control’s background is transparent.
Impact Reference Guide 4-51 Drop List Selector Property Name What it is Background Color Click in the field to choose the list’s background color. (The Transparent property must be False to see the background.) Text Color Click in the field to choose the list item’s text color. Selection Background Color Click in the field to choose the selected list item’s background color. Selection Text Color Click in the field to choose the selected list item’s text color.
Font Library Impact Reference Guide Font Library The Font Library control displays the Font Library linked from a tool in a VPM task. Click the delete icons to delete one or more selected characters from the library. Property Name What it is Height The control’s display height. Width The control’s display width. X The X coordinate of the control’s left edge. Y The Y coordinate of the control’s top edge. Editable If True, the font library can be edited through the Control Panel.
Impact Reference Guide Keyboard Property Name What it is Editable If True, the font library can be edited through the Control Panel. ToolTip Text Text displayed when the cursor is held over the control in Run mode. Zoom Percent The font library characters are magnified by this percentage in the display.
Keyboard Impact Reference Guide Property Name What it is Horizontal Text Position The control label’s horizontal position relative to the icon. Icon Height The icon’s height. Icon Text Gap The distance between the icon and the control label. Icon Width The icon’s width. Keep Icon Aspect Ratio If True, the icon’s height to width ratio is maintained when it is resized. Keyboard Application The path to the desired On-Screen Keyboard application.
Impact Reference Guide Numeric Entry Numeric Entry You can use the Numeric Entry control to enter numbers on the Control Panel. The numbers can then be linked to a vision program or other controls. If the On-Screen Keyboard (OSK) is enabled, it is displayed when this control gains focus. 4-55 Property Name What it is X The X coordinate of the control’s left edge. Y The Y coordinate of the control’s top edge. Minimum Value The minimum value that may be entered.
Password Impact Reference Guide Property Name What it is Height The control’s height. Horizontal Alignment Sets the number’s horizontal justification: Left, Center, or Right Enabled If True, the control is enabled. Visible If True, the control is visible. On-Screen Keyboard Displayed If True, the On-Screen Keyboard is currently displayed.
Impact Reference Guide Password To define, modify, or delete User IDs and passwords, click the Users property value. See “How the Password control works” on page 4-61. If there are no Users defined, and you select the Password control, its events and properties will be behave as if a Level 1user has logged on. 4-57 Property Name What it is Border Painted If True, a bevel border is drawn around the button. Height The control’s height. Width The control’s width.
Password Impact Reference Guide Property Name What it is Level 5 Name The name associated with the Level 5 user. This user has the least access (includes access of 5 only). Logged On If True, a user is currently logged on. Logged On Inactivity Duration If a user is logged on, and the keyboard/mouse is inactive for this amount of time (in minutes), the user will be automatically logged off. Logged On Inactivity Enabled If True, the Logged On Inactivity Duration property is effective.
Impact Reference Guide 4-59 Password Property Name What it is Password Required If True, a password that meets all system requirements must be defined for each user. Right Margin The distance between the button’s right edge and the label. Selected The value is set to True when a login has been completed. It is set to False when the control is selected while a user is logged on. (The Selected Event occurs even if the login is cancelled.
Password Impact Reference Guide Property Name What it is Logged On User The name of the user currently logged on to the control. Blank if no one is logged on. User Logon Disabled Duration The length of time, in minutes, that a user must wait to log in after the "Max Failed Logon Attempts" has been exceeded. User ID Maximum Length The maximum number of characters that the User ID can contain (maximum 12).
Impact Reference Guide Password Event Name When it happens Logged Off If any users are defined, when one of them logs off If no users are defined, when the Password control is unselected Action By User The control’s status changes by a user Failed Logon Attempt A user’s attempt to log on fails Selected By User If any users are defined, when one of them logs on or cancels a log on If no users are defined, when the Password control is selected by the user Unselected If any users are defined, when
Password Impact Reference Guide 6. Password always expires: If this box is checked, the user’s password will expire based on the Password Expiration property. If the box is not checked, the password will never expire and, therefore, cannot be changed by the user. 7. Force password change at first logon: If this box is checked, the user will be forced to change their Password after the next time they log on. A prompt is displayed.
Impact Reference Guide Radio Button The start time for each user, which is used to calculate elapsed time after each logon, is reset to the current time when any of the following occurs: The Password Expiration property is set to True A password is modified or created using the User Edit dialog A user changes their password during logon After the time has elapsed, and a user logs on, a prompt is displayed for the user to change their password.
Radio Button Group Impact Reference Guide Property Name What it is Label Position The label’s position relative to the radio button Unselected If True, the button is not selected. Button Label The button’s label. Some special characters will not display in this property. See “Special Characters” on page 4-97. Selected If True, the button is Selected. Only one button in a group can be set to True, all other buttons in that group are set to False.
Impact Reference Guide Radio Button Group Note: You must have a Radio Button Group control in the Control Panel to add a Radio Button control. 4-65 Property Name What it is Border Text Align Sets the border text’s position at the top of the border Border Text Color Click in the field to choose the border text’s color. Border Text Font Click in the field to choose the border text’s font properties.
Range Impact Reference Guide Range The Range control is used to display and enter the start and end values of Range1D input type in a VPM tool. You can also link to and enter a Tolerance data type where the minus, nominal, and plus values are calculated from the Range control’s start and end values. See “Using the Range Control” on page 4-68. Property Name What it is Background Color Click in the field to choose the control’s background color. (The Visible property must be True to see the background.
Impact Reference Guide 4-67 Range Property Name What it is Decimal Precision The number of decimal places to display in the Start and End values. Range The control’s Start and End Values as a Range 1D data type. You can only link this property. It can be linked from the Range1D property of a VPM tool. Selected Background The Start and End Value background color when the value is selected. Selected Color The Start and End Value text color when the value is selected.
Range Scroll Impact Reference Guide Method Name What it does Hide Makes the control invisible Start Gain Focus Forces the cursor to the Start Value field. Show Makes the control visible Event Name When it happens End Value Action by User When the End Value field is changed by a user’s action End Value Action When the End Value field changes Start Value Action When the Start Value field changes Range Action by User When the Range property is changed by a user’s action, i.e.
Impact Reference Guide Range Scroll The middle of the bar adjusts the Range Start and End values within the limits of the Range Minimum and Range Maximum values. Tools that have a data type of Range1D can be linked directly to this control. 4-69 Property Name What it is Background Color Click in the field to choose the control’s background color. (The Visible property must be True to see the background.) Height The control’s height. Width The control’s width.
Slider Impact Reference Guide Event Name When it happens Changed by User Only when the control’s value changes by a user’s action. Change Completed When the control’s range, start, or end, value change is complete (the adjustment stops moving) Slider The Slider control varies a value when a slider is moved on the Control Panel. You can define the size, orientation, and major and minor tick spacing for the best presentation.
Impact Reference Guide Table Property Name What it is Width The control’s width. Snap To Ticks If True, the slider will snap to the nearest tick mark when it is moved. Thumb Knob Height The slider knob’s height Thumb Knob Width The slider knob’s width Tooltip Text Text displayed when the cursor is held over the control in Run mode. Transparent If True, the control’s background is transparent. Visible If True, the control is visible.
Table Impact Reference Guide Table Setup What it is Cells Use Row Properties: All cells use the display properties (e.g. precision, boolean type) defined in the Per Row group; also enables Data Highlighting in the Rows Group Column Properties: All cells use the display properties (e.g.
Impact Reference Guide Table Table Setup What it is Cell Font The font properties for cells Data Highlighting Subgroup (configure row highlighting) Enabled If checked, the selected Cell Text Color and Cell Background Color are applied to the cells. Column To Monitor Enter a column number. The state of the cell at the intersection of Column To Monitor and the Current Row is monitored.
Table Impact Reference Guide Table Setup What it is Cell Background Color The background color for cells Cell Font The font properties for cells Alignment Sets the data alignment within the column. Width Sets the selected column’s width (in pixels). Data Highlighting Subgroup (configure column highlighting) Enabled If checked, the selected Cell Text Color and Cell Background Color are applied to the cells. Row To Monitor Enter a row number.
Impact Reference Guide Text Entry Method Name What it does Hide Makes the control invisible Enable Enables the control so it can be used Disable Disables the control; it cannot be used Event Name When it happens Updated When the table’s values are updated Update by User Only when the table’s values are updated by a user’s action Text Entry The Text Entry control provides text entry on the Control Panel. The entered text can then be linked to a vision program or another Control Panel.
Toggle Button Impact Reference Guide Property Name What it is Tooltip Text Text displayed when the cursor is held over the control in Run mode. Transparent If True, the control’s background is transparent. Visible If True, the control is visible. Method Name What it does Disable Disables the control; it cannot be used Enable Enables the control so it can be used Gain Focus The control gains focus (the cursor is placed in the text entry field). Hide Makes the control invisible.
Impact Reference Guide 4-77 Toggle Button Property Name What it is Horizontal Alignment Sets the label’s justification: Left, Center, or Right Horizontal Text Position Sets the label’s horizontal justification relative to the icon. Icon Height The icon’s height. Icon Text Gap The distance, in pixels, between the label text and the icon. Icon Width The icon’s width. Unselected If True, the button is currently Unselected.
Tolerance Impact Reference Guide Property Name What it is Unselected Label The displayed label when the button is in the Unselected state. Some special characters will not display in this property. See “Special Characters” on page 4-97. Unselected Label Color Click in the field to choose the label’s color when the control is in the Unselected state. Vertical Text Position Sets the label’s vertical justification relative to the icon. Visible If True, the control is visible.
Impact Reference Guide Tolerance 2. Click the up or down step button OR Enter a value in the field and press the Enter key 4-79 Property Name What it is Caret Color Click in the field to choose the cursor color displayed in number entry fields. Height The control’s height (in pixels) Width The control’s width (in pixels) X The control’s X coordinate. Y The control’s Y coordinate. Disabled Value Color Click in the field to choose the value’s display color when the control is disabled.
Tolerance Impact Reference Guide Property Name What it is Nominal Label Color Click in the field to choose the color for the Nominal label. Nominal Label Text The text displayed for the Nominal label. Nominal Decimal Precision The number of displayed decimal places for the Nominal value. Nominal Step Button Value The amount of increase or decrease for each click on the indicated Step Button for the Nominal value. Nominal Value The current Nominal value.
Impact Reference Guide 4-81 Tolerance Property Name What it is Step Buttons Visible If True, the step buttons are visible. Tolerance The control’s Tolerance value. Link this property to the Tolerance property of a tool. (Linkable Only) Tooltip Text Text displayed when the cursor is held over the control in Run mode. Transparent If True, the control’s background is transparent. Value Font The font for all the text entry values. Visible If True, the control is visible.
Display Group Impact Reference Guide Display Group Chart The Chart control presents a graphic display of data from a vision program. Several different types of charts are available and up to five categories of data series can be plotted. Property Name What it is Chart Setup When you click in the value field, the chart property editor is displayed. (See page “Edit Chart Properties” on page 4-84 for details.) Height The control’s height. Width The control’s width.
Impact Reference Guide 4-83 Chart Property Name What it is Series 2 Name The name displayed in the legend. The name must be unique. Not used for Pie Chart Series 3 Category The third data series category name. Categories are grouped together on the chart. Not used for Pie Chart Series 3 Color Click in the value field to choose the series display color. For Pie Chart, this is the color of the third data value. Series 3 Data The data to be plotted for this series.
Chart Impact Reference Guide Property Name What it is Range Marker 3 The value for Range Marker 3. Range Marker 1 The value for Range Marker 1. Range Marker 2 The value for Range Marker 2. Run on Data Change If True, the chart is updated whenever any data value changes. Chart Title The name displayed at the top of the chart. It may also be edited in the chart property editor. ToolTip Text Text displayed when the cursor is held over the control in Run mode.
Impact Reference Guide Chart • Title: Enter the title to be displayed at top of the chart, then select the title’s color and font. • Background: Choose the color that is displayed around the chart plot area, or select Transparent for the panel’s background color to show. Plot Tab • Background: Choose the color displayed in the chart plot area, or select Transparent for the panel’s background color to show behind the plotted data.
Frame Impact Reference Guide Legend Tab Select the where to display (or Hide) the chart legend relative to the chart. Data Tab • Data Delimiter: This is the ascii delimiter that appears between data values — Carriage Return, Line Feed, CR and LF (carriage return and line feed), or User Defined. Enter the User Defined value in the field below this selection.
Impact Reference Guide Graphic Display Property Name What it is Border Text Font The border text’s font properties. Border Type The border type: Bevel Lowered, Bevel Raised, Etched Lowered, Etched Raised, Line, or None. Height The frame’s height. Width The frame’s width. X The X coordinate of the frame’s left edge. Y The Y coordinate of the frame’s top edge. Enabled If True, all controls within the frame are enabled. (Each control can be disabled individually.
Indicator Light Impact Reference Guide Property Name What it is Image Click in the field to display the file browser to choose the image file. Image files may have these extensions: gif, jpg, and png. The image file must be on the same disk drive as the Control Panel file. ToolTip Text Text displayed when the cursor is held over the control in Run mode.
Impact Reference Guide Numeric Display Method Name What it does Hide Makes the control invisible. Show Makes the control visible Toggle Makes the control switch state. Turn Off Makes the control’s Light On property False. Turn On Makes the control’s Light On property True. Event Name When it happens Light Change When the Indicator Light switches. Numeric Display The Numeric Display control displays numbers on the Control Panel.
Rich Text Impact Reference Guide Property Name What it is Enabled If True, the button is enabled. Visible If True, the control is visible. Border Type The border type: Bevel Lowered, Bevel Raised, Etched Lowered, Etched Raised, Line, or None. Line Border Color Click in the field to choose the line border’s color. (This has no effect on other border types.) Line Border Width The line border’s width. (This has no effect on other border types.
Impact Reference Guide Scrolling Table Scrolling Table The Scrolling Table control displays other CPM controls in a grid layout. Only one row or column is updated with new data and, when the table is full, old data rows and columns are scrolled off the table. A qualifying control can be added by dragging it from the palette and dropping into the desired table cell.
Scrolling Table Impact Reference Guide Property Name What it is Transparent If True, the Control Panel’s color shows behind the table If False, the Background Color is displayed Visible If True, the control is visible Scroll On Data Change If True, whenever the Scroll method is called, the table will update if one or more of the cell values has changed. This prevents the table from scrolling if no values have changed.
Impact Reference Guide Scrolling Table 4. Set the desired Scroll Direction and Scrolling Limit. These two settings determine whether the table scrolls up, down, right, or left, and how many rows or columns of values are displayed before they drop off the table. Default Scrolling Table No controls added To display values in the table, you can drop other controls into table cells and then link values into them, or drag properties directly from VPM tools into table cells.
Tab Impact Reference Guide 2. Open the desired tool, click and drag the desired property, then drop it onto the Scrolling Table control. When you release the property, if the data type is compatible with one of the qualifying controls, that control is automatically added to the table. The Scrolling Table resizes automatically based on the Auto Resize and Scrolling Limit properties and a default label is added to either the row or column, depending on the Scroll Direction property.
Impact Reference Guide Tab Group Property Name What it is On Top If True, the tab is currently in front of any other tab in the Control Panel. Keep Icon Aspect Ratio If True, the icon’s height to width ratio is maintained when it is resized. Tab Name The name displayed on the control’s tab. ToolTip Text Text displayed when the cursor is held over the control in Run mode.
Text Display Impact Reference Guide Property Name What it is Tab Width Sets the tab width for all Tab controls in the Tab Group control, in pixels. A value of zero automatically adjusts to accommodate the tab font and/or icon size. ToolTip Text Text displayed when the cursor is held over the control in Run mode. Visible If True, the control is visible.
Impact Reference Guide Text Display Property Name What it is Width The control’s width. ToolTip Text Text displayed when the cursor is held over the control in Run mode. Transparent If True, the control’s background is transparent. Vertical Alignment Sets the number’s vertical justification: Top, Center, or Bottom Visible If True, the control is visible.
XBar-R Chart Impact Reference Guide XBar-R Chart The XBar-R Chart control graphs statistical information on the Control Panel. It is used to show both the mean value (XBar) and the range (R) of a data set. The XBar portion of the chart shows any changes in the mean value of the process while the R portion shows any changes in the dispersion of the process.
Impact Reference Guide XBar-R Chart Property Name What it is Deviation of Minimums Calculated: Standard deviation of all data pair minimum values. Deviation of Maximums Calculated: Standard deviation of all data pair maximum values. Upper Control Limit Calculated: Three times the standard deviation of all the means added to the mean of all means. Lower Control Limit Calculated: Three times the standard deviation of all the means subtracted from the mean of all means.
XML Table Impact Reference Guide Plot Tab • Background: Choose the color displayed in the chart plot area, or select Transparent for the panel’s background color to show behind the plotted data. • Range Markers: Horizontal lines of the selected color are drawn in the plot area at the Minimum and Maximum Range Marker values. • Control Limit Markers: Horizontal lines of the selected color are drawn in the plot area at the Upper and Lower Control Limit values.
Impact Reference Guide 4-101 XML Table Property Name What it is Column Reordering Enabled If True, the columns can be moved within the table. The new order is lost when the table is updated. To move a column, click the header then drag the column to the new position. To resize a column, hold the cursor over the border between columns, then click and drag the border to resize it.
General Group Impact Reference Guide Method Name What it does Hide Makes the control invisible. Update Table Reads the XML file specified in the "File path" property or parses the string in the Data property, then displays the data in the table according to the record tags. Show Makes the control visible. Event Name When it happens Update Failed When populating the table with data from the XML file or Data property is incomplete.
Impact Reference Guide Change Log In the example above, the variable "count" is incremented each time the tool runs, then reset to zero when it reaches five. When you type the variable name "count," the Basic tool automatically creates an input with that name. You can set the variable’s type in the Type drop-down. For more details about entering text in the Editor window, see “Typing in the Editor Window” on page 5-1).
Change Log Impact Reference Guide Property Name What it is Logging Level Any log event of this level or higher will be logged. If the value is zero, all events will be logged. Maximum Number of Files When this number of files has been created, the event "Maximium Number of Files Written" event is activated. The next file created is numbered at 001 and any existing log files with the same name are overwritten.
Impact Reference Guide Change Log ties pane. List values are formatted as single values separated by the system’s regional format separator. Fields are separated by four spaces.The following changes are written to the log.
Execute Command Impact Reference Guide • When the "Update File" method is called • When the five minutes have elapsed since the entries were last written • When the control panel application closes • When CPM goes into Design mode • When the "Log File Path" property changes while in run mode • When the "Log File Name" property changes while in run mode When entries are successfully written or appended to an existing file a "File Update Completed" event occurs.
Impact Reference Guide Impact Connector Impact Connector The Impact Connector control connects the Control Panel to an Impact device. Vision programs, tasks, and tool data are linked to this control, then linked to properties, methods, and events in other controls. This control is not displayed on the Control Panel Canvas. To see it, click the Select Design View Options button and select Control Panel Tree (see “Select Design View Options” on page 4-6).
Impact Connector Impact Reference Guide Property Name What it is Link Error If True, one or more of the links between the Control Panel and the Impact device have been broken. This may be due to some change in the vision program (e.g. a tool deletion). The links are shown on the Get Data, Set Data, and Execute Method tabs.
Impact Reference Guide Impact Connector 2. Click in the IP address field and select the desired device’s IP address from the list displayed, then click OK. 3. Select the Connected property, then set the Value to True. 4. If device security is enabled, you will need to enter a valid User ID and Password. Properties Links Note: If the Control Panel is not connected to an Impact device, you cannot create links.
Impact Connector Impact Reference Guide Get Data links allow you to get data from a tool or task in a vision program and display or use it in a control. The link is created between the Impact Connector control and the vision program tool or task. For example, you can link to a Basic tool’s calculated value, then link that to a Numeric Display control so the Control Panel operator can see the value on the Control Panel. See “Links between CPM and VPM” on page 4-15 for more details on links.
Impact Reference Guide Load Image • If the User ID/Password property is empty, then the User Logon dialog is displayed. The entered User ID and Password are verified on the device to be connected. If either is invalid, an error message is displayed, otherwise the Impact Connector is connected to the device. • If a valid User ID and Password have been linked from the UserID\Password property of another Impact Connector, then the User ID and Password are verified on the device to be connected.
Load Vision Program Impact Reference Guide This control is not displayed on the Control Panel Canvas. To see it, click the Select Design View Options button and select Control Panel Tree (see “Select Design View Options” on page 4-6). Property Name What it is Image The image currently loaded into this control. Image Path Click in the field to enter the image’s file name or browse to choose the image file. Image files may have these extensions: jpg, png, and bmp.
Impact Reference Guide Save Vision Program Property Name What it is File To Load The name of the vision program file to load. If this field is blank, the file browser is displayed. If multiple files are specified, they must be separated by commas. If you try to load a file with the same program name as an already loaded file, the existing file is unloaded first. IMPORTANT: File names are case sensitive.
Save Vision Program Impact Reference Guide Property Name What it is Device Connection This property indicates the device that contains the files. When you add the control to the control panel, this link is created to an Impact Connector control automatically. If the control panel contains more than one Connector control, you are prompted to choose one. Display Saving Prompt If True, a message is displayed while the file is being saved.
Impact Reference Guide Scriptor Property Name What it is Warn On Overwrite If True, a confirmation dialog is displayed when you try to save a file that already exists. Warn on Save As If True, a confirmation dialog is displayed when a file is saved with a different name. File Format XML: The file is saved in uncompressed format as XML. Compressed: The file is saved in compressed binary format (resulting in a much smaller file size).
Scriptor Impact Reference Guide Scriptor Editor Tab Click in this window, then type the desired Scriptor commands. You enter scriptor commands on this tab. See “Script Examples” on page 4-118. Property Name What it is Exit Application Upon Completion If True, CPM exits when the script has completed executing. If False, the Control Panel Application continues to run. Run Automatically If True, the script is executed as soon as the Control Panel Application enters Run mode.
Impact Reference Guide Scriptor This command sets the specified property to the value. If this call is successful, the boolean variable (e.g. successful) is set to True. The parameter format for a non-linked control value is: ("Panel Tab Name.Frame Name (if applicable).Property Name","value") The parameter format for a linked control value is: (Panel Tab Name.IMPACT Connector Control Name:Program Name.Task Name.
Scriptor Impact Reference Guide if(Scriptor.loadAndExecuteScript("C:/IMPACT/scripts/connect.bsh")) { boolean successful = Scriptor.loadAndExecuteScript("C:/IMPACT/scripts/ load.bsh"); if(successful) { Scriptor.loadAndExecuteScript("C:/IMPACT/scripts/save.bsh"); } } getDefaultLocale() Method This command gets the current client’s locale based on the operating system’s regional options setting and the Application.properties file. Example: import java.util.ResourceBundle; Locale locale = Scriptor.
Impact Reference Guide Scriptor This section contains examples of scripts using the scriptor commands listed previously. IMPORTANT: These scripts are examples only. They will not necessarily operate as-is, since they must be modified to fit in your operating environment. Datalogic is not responsible for any malfunctions that may result from the use of this code. Main script This is a main script that calls other scripts that connect to an Impact device, then load and save vision programs on that device.
Scriptor Impact Reference Guide successful = Scriptor.setProperty("Panel 1.Load Vision Program.Warn On Overwrite", "false"); } if(successful) { // successful = Scriptor.setProperty("Panel 1.Load Vision Program.File Path", "IMPACT Root/VisionPrograms"); // successful = Scriptor.setProperty("Panel 1.Load Vision Program.File Path", ""); // defaults to device successful = Scriptor.setProperty("Panel 1.Load Vision Program.File Path", "C:/IMPACT"); } if(successful) { successful = Scriptor.setProperty("Panel 1.
Impact Reference Guide TCP-IP Logger successful = Scriptor.setProperty("Panel 1.Save Vision Program.File To Save", "BearingOCR.vp, Locate.vp"); } if(successful) { successful = Scriptor.executeMethod("Panel 1.Save Vision Program.Save Program"); } if(successful) { // wait for all the loads to complete String saveCompleted = "false"; while(saveCompleted.equals("false")) { saveCompleted = Scriptor.getProperty("Panel 1.Save Vision Program.Save Successful"); Scriptor.
TCP-IP Logger Impact Reference Guide button and select Control Panel Tree (see “Select Design View Options” on page 4-6). You can display the received data by linking the Last Data Received property to a text display control. The control will find all local IP addresses, select the first one by default, and display them in the Local IP Address property drop down list.
Impact Reference Guide Timer Method Name What it does Enable Enables the control so it can be used Delete Log File Deletes the log file. Show File Browser Displays the file browser so the operator can choose a log file. Disable Disables the control; it cannot be used Event Name When it happens File Write Failed When the control cannot write to the log file. New Data Received When the control receives new data. Timer The Timer control counts elapsed time during Run mode.
Timer Datalogic Automation Inc.
C H A P T E R 5 Impact Basic This chapter discusses the Basic language that is used in the Basic tool in VPM and the Basic Interpreter control in CPM. The Basic tool performs logical and mathematical calculations based on a set of user-written statements using the Basic programming language. The program results are available to link to other tools. Basic Editor Window Basic language commands are typed in the Basic editor window in the VPM Basic tool and the CPM Basic Interpreter.
General Language Format Impact Reference Guide To modify text 1. Select the desired text, then type the new text. To check the validity of your Basic code 1. Click the Compile button. 2. Any errors are displayed in the Editor window. Comments You can make your programs more readable by leaving blank lines between statements, and adding explanatory comment lines. You can indicate comment lines in one of three ways: 1. Start the line with the letters REM followed by one or more spaces.
Impact Reference Guide Constants TIP: If the variable’s name has a specific ending, the type will be assigned automatically. Variables ending in "real" are assigned type Real, "string" are assigned type String, and "int" are assigned type Integer. For example, count_real is a Real, name_string is a String, and count_int is an Integer.
Expressions Impact Reference Guide Expressions Expressions are used to assign and calculate values. They can contain variables, operators, function calls and parentheses. Operators, unless they are surrounded by parentheses, are evaluated from left to right in the order of precedence listed in the following table, starting with the highest precedence.
Impact Reference Guide Statement syntax Operator Operator Meaning NOT Logical negation: calculates the logical negation of the operand (e.g. NOT True; the result is False) *Note: For the compare operators (<, <=, >, >=), the result of the operation is undef if any of the operands is undef. Statement syntax Statements consist of assignments, functions, or commands written on a single line. You can leave blank lines between statements for readability. Spacing within a statement is optional.
Arrays Impact Reference Guide Repeat Until Repeat REM loop body Until expression This construct repeats the loop body until the expression is True. The expression is evaluated after the execution of the loop body so the loop body is always executed at least once. While While expression REM loop body End This construct repeats the loop body while the expression is True. The expression is evaluated before entering the loop so the loop is not executed if the expression is already False.
Impact Reference Guide Data Types Basic code, click the drop-down arrow next to the variable name in the Tool Properties pane to define its data type. Boolean and Boolean List Boolean variables have a value of True (non-zero) or False (zero). You can use any of the comparison operators to compare boolean variables to each other or the constants True and False. You can also assign values to Boolean variables. Individual Boolean List elements can be accessed using array notation.
Basic Commands and Functions Impact Reference Guide Basic Commands and Functions Important Note: Some Basic commands and functions are not implemented in Impact software. Some of them may be implemented in future versions. These commands are implemented only in the CPM Basic control. They will not work in the VPM Basic tool.
Impact Reference Guide Commands and Functions A-D ADDHOUR() This function takes two arguments and returns a real number representing a date and time. The first argument is a time value, the second argument is the number of hours to add to or subtract from it. (See“FORMATDATE” on page 5-14.) Example: newtime = ADDHOUR(now,1) yields newtime = 1.330338E9 ADDMINUTE() This function takes two arguments and returns a real number representing a date and time.
Commands and Functions A-D Impact Reference Guide AMAXI(array) This function returns the index of the maximum value in the argument array. Example: list[0] = 10 list[1] = 2 list[2] = 53 list[3] = 4 listmaxi =amaxi (list) yields listmaxi = 2 AMIN(array) This function returns the minimum value in the argument array. Example: list[0] list[1] list[2] list[3] listmin = 10 = 2 = 53 = 4 =amin (list) yields listmin = 2 AMINI(array) This function returns the index of the minimum value in the argument array.
Impact Reference Guide Commands and Functions A-D (CPM Only) This function changes the current directory. This example changes the current directory to the path in the quotes. Example: chdir "C:\Documents\design docs" CHOMP() This function removes a trailing "newline" character from the string argument. If the last character is not a "newline," then the original string is returned.
Commands and Functions E-H Impact Reference Guide Loop Until expression Do REM loop body Loop While expression Do Until This construct repeats the loop body until the expression is True. The expression is evaluated before entering the loop so the loop is not executed if the expression is already True. Do Until expression REM loop body Loop Do While This construct repeats the loop body while the expression is True.
Impact Reference Guide Commands and Functions E-H ERROR 3 ERROR$ () This function returns a string describing the most recent error. Example: error_string = ERROR$() ERROR$ (n) This function returns a string describing error number "n." Example: error_string = ERROR$ (10) EVEN() This function returns a True or False value based on whether the argument is an even or odd number. If the argument is undef, the result is undef.
Commands and Functions E-H Impact Reference Guide FFTMAG() This function computes the Fourier transform of the argument array. The argument is an array of two or more real values. (Ideally the length should be a power of 2, e.g. 4, 8, 16, 64, 256). After computing the transform, the function computes the magnitude of each complex output value (by multiplying the value by its complex conjugate and taking the square root of the result), and stores the magnitude back in the input array.
Impact Reference Guide Commands and Functions E-H Format String Resultant display 0D date with leading zero, if needed WD single digit day of the week starting with Sunday = 0 WEEKDAY-NAME weekday name WDN three letter abbreviation of the weekday name HH hour (24 hour notation) 0H hour with leading zero, if needed (24 hour notation) hh hours (12 hour notation) 0h hours with leading zero, if needed (12 hour notation) mm minutes 0m minutes with leading zero, if needed ss seconds 0s
Commands and Functions E-H Impact Reference Guide This function returns the local Impact device time converted to Greenwich Mean Time (GMT) as a real number. Example: thistime_string = FORMATDATE ("MM-DD-YY HH:mm:ss",GMTIME) yields thistime_string = 2-27-12 16:29:15 GOSUB This an alternative to calling a subroutine. Program execution jumps to the line with the label indicated. (A better way to call a subroutine is to use the Call command.
Impact Reference Guide Commands and Functions I-L Commands and Functions I-L IF THEN This command structure provides conditional execution. You can use single or multi-line syntax. If you use a single line, you cannot include an ELSE statement.
Commands and Functions I-L Impact Reference Guide The syntax of this function is INSTRREV(base_string,sub_string[,position]) The first argument (base_string) is the string to search. The search starts from the end of the string. The second argument (sub_string) is the string to find. The third argument is the character location to start the search. The location of the first character of sub_string is returned. If the position argument is missing, the search starts with the last character of base_string.
Impact Reference Guide Commands and Functions I-L ISINTEGER() This function returns True if the argument is an integer number. Example: x = 1 check_bool = isinteger(x) yields check_bool = True ISNUMERIC() This function returns True if the argument is a number (real or integer). Example: x = 1 check_bool = isnumeric(x) yields check_bool = True ISREAL() This function returns True if the argument is a real number. Example: x = 1.
Commands and Functions I-L Impact Reference Guide LCASE() This function converts the string argument to lower case. If the argument is undef, the result is undef. Example: var_string = LCASE("ALLLOWERCASE") yields var_string = alllowercase LEFT() This function creates a string from the leftmost characters of the first argument. The second argument is the number of characters to use.
Impact Reference Guide Commands and Functions M-Q x = LOG(2.72) yields x = 1.000632 LOG10() This function calculates the log of the argument. If the argument is less than or equal to zero, the result is undef. Example: x = LOG10(1000) yields x = 3 LT R I M ( ) This function removes any existing spaces from the leftmost part of a string.
Commands and Functions M-Q Impact Reference Guide NOW This function returns the local Impact device time and date expressed as seconds. (See“FORMATDATE” on page 5-14.) Example: thistime_string = FORMATDATE ("MM-DD-YY HH:mm:ss",NOW) yields thistime_string = 2-27-12 11:56:19 OCT() This function returns the octal value of the integer argument as a string. Example: oct_string = OCT(255) yields oct_string = 377 ODD() This function returns a True value if the argument is an odd number.
Impact Reference Guide Commands and Functions R-V You can also open an existing file and write (append) additional records to the end of it. This example opens the existing file named yourfile.txt in the current directory and adds the string "Another line" to it. IMPORTANT: File names are case sensitive. open "yourfile.txt" for append as 1 print#1,"Another line\n" close 1 Open - Input This example opens the myfile.txt file for reading, then assigns the input string to the string variable in_string.
Commands and Functions R-V Impact Reference Guide REM loop body Until expression REPLACE () The syntax of this function is REPLACE (base_string, search_string, replace_string [,number_of_replaces] [,position]). The first argument (base_string) is the string to search. The second argument (search_string) is the string to find. The third argument (replace_string) is the string to use as replacement. The fourth argument (number_of_replaces - optional) is the number of replaces to do.
Impact Reference Guide Commands and Functions R-V RND This function returns a random number. Example: x = RND yields x = 1016015 ROUND() This function will round the argument to zero decimal places if there is no second argument. The optional second argument indicates the number of places to round. If the first argument is undef, the result is undef. Example: x = ROUND (11.1225,2) yields x = 11.12 RTRIM() This function removes any existing spaces from the rightmost part of a string.
Commands and Functions R-V Impact Reference Guide SPLIT "10,11,12" by "," to sub1, sub2, sub3, sub4 yields sub1 = 10 sub2 = 11 sub3 = 12 (sub4 is undefined) If there are fewer variables than sub-strings, the last string variable will hold the remaining part of the original string and the delimiter. Example, SPLIT "10,11,12" by "," to sub1, sub2 yields sub1 = 10 sub2 = 11, 12 If two delimiters follow each other, the resulting variable is empty.
Impact Reference Guide Commands and Functions R-V This command stops program execution. No further commands are executed. Example: STOP STR() This function converts a number to a string. This conversion is done automatically, but you can use this function to insure that a variable is interpreted as a string.
Commands and Functions R-V Impact Reference Guide The syntax of this function is TIMEVALUE (year, month, day, hour, minute, second) This function returns a real number that based on the arguments. If an argument is missing or undefined, the following default values are used: year = 1970 month = January day = 1 hour = 0 minute = 0 second = 0 Example: time_var = yearday (TIMEVALUE (2005,12,23)) yields time_var = 356 TRIM() This function removes any leading and trailing spaces from a string.
Impact Reference Guide Commands and Functions W-Y UCASE() This function converts the string argument to all upper case. If the argument is undef, the result is undef. In this example, the string "ALL UPPERCASE" is assigned to the variable var_string. Example: var_string = UCASE("All Uppercase") yields var_string = ALL UPPERCASE UNDEF Impact Basic uses a special constant named "undef." This constant is undefined in the sense that it has no value (it is not zero or false and it is not any data type).
Basic Program Examples Impact Reference Guide thisyearday = YEARDAY yields thisyearday = 57 Basic Program Examples The following examples of Basic tool code illustrate some simple function calls and shows how to construct Basic statements. Each example is preceded by explanatory text which will help explain its purpose. This example uses the CHR function to create a string (ab_) with the last character incrementing from ‘a’ to ‘z’ each time the code is run.
Impact Reference Guide Basic Program Examples ’ example (65). It assigns the string value "A" to the variable ’ char_string. char_string = chr(asc_value) Example 4 ’ ’ ’ ’ This example uses the HEX function to find the hex value of the number assigned to the variable asc_value in the previous examples (65). It assigns the string value "41" to the variable hex_string. hex_string = hex(asc_value) Example 5 ’ ’ ’ ’ ’ This example demonstrates the string concantenation function (&).
Basic Program Examples Impact Reference Guide ’ variable reverse_string. reverse_string = strreverse(resulting_string) This example shows how to format a real value to a specified number of digits. ’This is the real value to format real_value = 123.1234567890 ’Set the number of digits of precision desired precision_int = 1 ’The Basic function "instr" finds the location of the decimal point in the real value (4).
C H A P T E R 6 Appendix This appendix explains several parts of Impact software in more detail. Threshold Viewer NOTE: The Histogram and Line Profile buttons in the Display Area toolbar are visible only when the Setup tab is selected. To display the Threshold viewer in other tabs, right click on the ROI or image. The floating Threshold viewer shows a Histogram or Line Profile, depending on the area of the image or type of ROI selected.
Threshold Viewer Impact Reference Guide If the Threshold Viewer window is displayed, it will close when any of the following events happen: • You click the "X" button in the upper right corner of the Threshold Viewer window. • You select the Display tab. • You select the Settings tab and the Camera or File Camera are NOT selected. • The Camera or File Camera in the Settings tab is selected and you select another system object that is NOT the Camera or File Camera.
Impact Reference Guide Threshold Viewer Histogram Plot The Histogram plot is displayed as a bar chart where each vertical bar represents the greyscale intensity of a pixel in the image. The Y-Axis is the scale for the number of pixels of each intensity. The X-Axis shows the range of grey levels for the pixels from zero percent (black) to 100 percent (white). Greyscale % The minimum and maximum grey levels, as shown graphically in the plot, are displayed here as numbers.
Threshold Viewer Impact Reference Guide Center Fixed Threshold Range - Adjustable Threshold Adjustable Threshold Center Fixed Threshold Range on Region Average If the tool's threshold type property is set to "Center Fixed Threshold on Region Average," the X-Axis is displayed as -100 to 100 and the centered red cursor is not shown. Moving either the Minimum or Maximum cursor will move the opposite cursor so that the range is always centered on zero.
Impact Reference Guide Threshold Viewer Bright and Dark Pixels - Adaptive Threshold Adaptive Threshold Bright Pixels If the tool's threshold type is set to some form of "Adaptive Threshold - Bright," the maximum Threshold (%) is set to 100 and the minimum value is set to the value of the tool's Fixed Threshold Value property.
Threshold Viewer Impact Reference Guide The Threshold Viewer Window will display a grey level or gradient Line Profile, depending on the mode chosen in the tool, for these ROI types: Arc, Line, and Wide Line. For details about the Histogram window, see “Histogram” on page 6-2. Title The window title displays the current Profile Mode (Grey Level or Gradient), the Tool or Task name, and the current threshold mode being used (when applicable).
Impact Reference Guide Threshold Viewer The vertical red cursor is movable and shows the Greyscale or Gradient value at its location. A red hash mark on the selected Line ROI follows the position of the red cursor on the plot. The red hashmark on the ROI corresponds to the red cursor’s position. Red cursor Greyscale % The percent greyscale, as shown graphically in the plot, at the red vertical line (cursor).
Threshold Viewer Impact Reference Guide Arc: When Arc Profile is selected, an arc with a line segment is displayed on the ROI. You can click and drag the arc handle to contract and expand it and move the line segment. The profile viewer shows the pixel values under the line segment. The red hashmark on the ROI corresponds to the red cursor’s position. Radial Profile Click and drag the line segment. Click and drag the arc handle.
Impact Reference Guide Threshold Viewer When Pseudocolor is on, a movable horizontal green cursor is displayed. Moving the cursor up or down adjusts either the Threshold % Minimum or Maximum numeric fields and threshold limits in the image display, depending on whether bright or dark line type is selected. In this mode, no values are update in the tool’s properties. Line Profile - Gradient Mode Gradient Introduction The term gradient refers to how quickly an image’s grey level intensity changes.
Threshold Viewer Impact Reference Guide Gradient Mode - Adjustable Threshold Gradient Mode Adjustable Threshold Line Profile Plot The gradient Line Profile is displayed as a line plotted on a graph where the X-Axis represents the length of the selected line ROI and the Y-Axis represents the gradient percent range. The maximum range value is based on the currently selected Gradient Range. The top horizontal green cursor represents the tool's Gradient Threshold Minimum percent.
Impact Reference Guide Threshold Viewer Gradient Mode - Autothreshold Gradient Mode Autothreshold When the tool is in Autothreshold mode, no horizontal green cursors are displayed and the Threshold % fields are set to zero since there are no Threshold Used properties in the tool to read. 6-11 Datalogic Automation Inc.
On-Screen Keyboard Impact Reference Guide On-Screen Keyboard Two on-screen keyboards (OSK) are available for entering text and numbers in VPM and CPM using a touchscreen rather than a keyboard. Only the external keyboard is available in VPM. The external and internal OSKs are available in CPM.
Impact Reference Guide CPM CPM There are three ways to enter information in CPM using a touchscreen: the Keyboard control, the external OSK, and the internal OSK. The Keyboard Control displays a graphical keyboard on the screen that can be used for keyboard input using a touchscreen. The Keyboard control is placed on a control panel and accessed by clicking it when you want to enter information in a field. For more details see “Keyboard” on page 4-53.
CPM Impact Reference Guide 3. In the Program Preferences dialog, check the box labeled "Enable automatic on-screen keyboard." Using the internal OSK The internal OSK is displayed when you select an input field on a control panel. When you press a key, that field will receive the letter or number. Datalogic Automation Inc.
Impact Reference Guide VPM VPM The external OSK is accessible in VPM only when you are using the Display tab. If the OSK is enabled, the text entry OSK pops up when an editable text cell gains focus. The numeric OSK application is executed when an editable integer or real cell gains focus.The OSK application stops when either the table loses focus or you press the "Enter" key. If a table has various data types within it, the OSK will change depending what cell gains focus. To enable the external OSK 1.
Emulator Impact Reference Guide Emulator On M-Series processors the Emulator is called Impact M Device You can use an emulator with CPM and VPM to create and test vision programs without an Impact device connected to your PC. The Emulator uses the PC to emulate an Impact device. You have the option of connecting to an Emulator or a device. If you connect to an Emulator in VPM, it is started automatically and VPM connects to it.
Impact Reference Guide Command Line Parameters the software version number. The Impact Device dialog additionally shows the emulated camera port. 2. To connect to the Emulator with VPM, CPM, or Settings, select the device with the desired the name from the Device Selection list. 3. Click the Connect to Device button. To close the Emulator: 1. Be sure that VPM, CPM, or Settings are not connected to the Emulator you are closing. 2. Click Exit on the Emulator dialog.
Summary Impact Reference Guide 4. Click the Shortcut tab The command line The option goes at the end of the command line 5. The command line appears in the Target field on the Properties dialog. The default command line varies with the program. For example, here is an example of the VPM program command line: "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\VPM\VPM.
Impact Reference Guide Override the program’s default system country settings Disable moving and sizing the window (-d): CPM, CPMRE, VPM, Settings (page 6-19) Display an image as the logo in the title bar (-logo): CPM, CPMRE, VPM, Settings (page 6-20) Display an image as a banner in line with the toolbar (-banner): CPM, CPMRE, VPM, Settings (page 6-20) Display an image at program start and in the About dialog (-splash): CPM, CPMRE, VPM, Settings (page 625) Display a string in the title bar and in the Abou
Disable moving and sizing the window Impact Reference Guide country CN Disable moving and sizing the window With this option, the program does not display the minimize, restore/down, or close buttons in the title bar. The "Exit" button is added so the program can be closed. Add the following option to the command line: -d Here are example command lines disabling the program window (the option is in bold): CPM "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.
Impact Reference Guide Display an image as the logo on the title bar VPM "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC -Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\VPM\VPM.jar" -language fr Settings "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC -Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\VPM\Settings.
Disable the ability to close the program Impact Reference Guide where the folder "images" contains the image to be displayed named "image name.ext." NOTE: The file path and name must be enclosed in quotes and include the file extension. There is a space between the option and the first quotation mark. Here are example command lines that display an image named "banner.png" located in a folder named "C:\Images" (the option is in bold): CPM "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.
Impact Reference Guide Access a text file containing a list of command line options When this option is used, the Impact Device driver programs (IMPACTDevice.exe) do not display the Exit button. The program cannot be closed from the program window. To close the program you must use the Windows Task Manager. The switch is case sensitive and must NOT be preceded by a hyphen or dash. noExit To edit the program command file 1. Find the command file in the program’s installation folder.
Load a control panel application when program starts Impact Reference Guide CPMRE "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC -Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\CPM\CPMRE.jar" -optionfile "C:\text folder\options.txt" VPM "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC -Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\VPM\VPM.jar" -optionfile "C:\text folder\options.
Impact Reference Guide Run a Scriptor file All distances are in pixels. Invalid or missing values may place the control panel off screen. There is a space between each of the option values. This example command line opens a window and locates it on the screen at 0, 0 with a size of 500 by 500 pixels (the option is in bold): CPMRE "C:\Datalogic\IMPACT\Applications\jre\bin\javaw.exe" -XX:+UseParallelGC -Xmx400m -Xms64m -Xrs -jar "C:\Datalogic\IMPACT\Applications\CPM\CPMRE.
Display an image at program start and in the About dialog Impact Reference Guide NOTE: This command line may be too long to include in the shortcut. See “Access a text file containing a list of command line options” on page 6-22. Display an image at program start and in the About dialog NOTE: The text for this option is different and it is placed within the command line, not at the end.
Impact Reference Guide Set the amount of memory to be allocated -title "The String" Set the amount of memory to be allocated IMPORTANT NOTE: This option is placed within the command line, not at the end. This option already exists in the program command line. Change the existing value only, do not add a new value to the end of the command line. This option sets the amount of memory space to be allocated for the program to run.
Modbus TCP/IP Client Tester Impact Reference Guide Modbus TCP/IP Client Tester The Modbus Client Tester is used to send function codes and data to the Modbus Server on the Impact device for testing. To launch the Modbus Client Tester 1. Start VPM 2. Select the Settings Tab - General - Diagnostics panel. 3. Click the Advanced button. 4. Select Modbus Client. 5.
Impact Reference Guide TCP/IP Settings TCP/IP Settings This section describes different types of Impact device and PC connections and the TCP/IP settings for those connections. If you need help configuring the network or the client computer, you should seek professional advice. Network configuration is beyond the scope of this manual. Impact software TCP Ports Impact software uses an ephemeral port number to connect to Impact devices.
HTTP Commands Impact Reference Guide HTTP Commands This section describes HTTP commands that can be used to send commands to a Datalogic vision device over a local area network. These commands can be sent to the vision device using a standard Internet browser. NOTE: All commands are case sensitive. To send commands to the camera 1. Start a web browser 2. In the browser's address field, type the camera’s IP Address followed by a forward slash. For example http://192.168.0.128/ 3.
Impact Reference Guide PC to Device - Direct Connection PC to Device - Direct Connection Direct Connection PC 1 settings IP Address: 192.168.0.mmm Subnet: 255.255.255.0 Gateway: None Impact Device default settings IP Address: 192.168.0.128 Subnet: 255.255.255.0 Gateway: None The PC and Impact Device settings must be compatible: IP Address: AAA.BBB.CCC.nnn Subnet: 255.255.XXX.0 Gateway: AAA.BBB.CCC.nnn The first 3 fields of the IP address (AAA.BBB.
PC to Device - Switch Connection Impact Reference Guide PC to Device - Switch Connection Connection with switch No domain or network host 10/100 Ethernet switch PC 1 settings IP Address: 192.168.0.mmm Subnet: 255.255.255.0 Gateway: None Impact Device default settings PC 2 settings IP Address: 192.168.0.mmm Subnet: 255.255.255.0 Gateway: None IP Address: 192.168.0.128 Subnet: 255.255.255.0 Gateway: None The PC and Impact device settings must be compatible: IP Address: AAA.BBB.CCC.nnn Subnet: 255.255.
Impact Reference Guide PC to Device - Router Connection PC to Device - Router Connection Connection with router Router with integral switch and DHCP PC 1 settings IP Address: 192.168.0.mmm Subnet: 255.255.255.0 Gateway: None Optional wireless connection Impact Device default settings IP Address: 192.168.0.128 Subnet: 255.255.255.0 Gateway: None 10/100 Ethernet connections PC 2 settings IP Address: 192.168.0.mmm Subnet: 255.255.255.
PC to Device - Internet connection Impact Reference Guide PC to Device - Internet connection Server based network Internet access via a firewall and multiple subnets VPN Firewall/Router Smart Switch Subnet A = 192.168.xxx Gateway: 192.168.xxx.n Smart Switch Subnet B = 192.168.yyy Gateway: 192.168.yyy.m 10/100 Ethernet connections PC on Subnet A PC on Subnet B Impact Device on Subnet B IP Address: 192.168.yyy.mm1 Subnet: 255.255.254.0 Gateway: 192.168.yyy.m IP Address: 192.168.yyy.mm2 Subnet: 255.
Impact Reference Guide How the Code Reader Tool Works How the Code Reader Tool Works This section explains some of the more specialized Code Reader tool functions and parameters, and provides some details about how the tool works. The tool reads the following types of 1D, 2D, and Postal symbols and provides 36 different outputs from the decoded symbols.
How the Code Reader Tool Works Impact Reference Guide Input Property Affected Code Types Postal Minimum Bar Count, Postal Maximum Bar Count, Postal Bar Edge Spacing, Postal Code Orientation Postal - Processing Mode Advanced (PMA) Code Quality Verification 1D: Code128, EAN128, Code39, Code93, Codabar, EAN/UPC, Interleaved 2 of 5 2D: Datamatrix ECC200 (PMA) 1D Advanced Box Improvement 1D: Interleaved 2 of 5, Code 39, Codabar, Code128, GS1-128, Code 93, EAN/UPC, Code 32,Matrix 2 of 5, Standard 2 of 5,
Impact Reference Guide How the Code Reader Tool Works The Processing Mode Input Property affects which Input Properties are used to configure each Code Type. For example, setting the Postal Minimum Bar Count will only have an effect when Processing Mode is set to Advanced.
How the Code Reader Tool Works Impact Reference Guide Code Type Processing Mode Standard Settings Processing Mode Advanced Settings Code 128 Code 128 Advanced Box Improvement 1D Code Orientation 1D Low Contrast 1D Small Codes Improvement 1D Minimum Code Height (pixels) 1D Narrow Margins 1D Start/Stop Characters Tx 1D Code128 Characters Tx GS1 128 GS1 128 Advanced Box Improvement 1D Code Orientation 1D Low Contrast 1D Small Codes Improvement 1D Minimum Code Height (pixels) 1D Narrow Margins 1D Star
Impact Reference Guide 6-39 How the Code Reader Tool Works Code Type Processing Mode Standard Settings Processing Mode Advanced Settings GS1 Databar Expanded Stacked Composite GS1 Databar Expanded Stacked Composite Codes Micro PDF 1D Code Orientation 1D Low Contrast 1D Small Codes Improvement 1D Minimum Code Height (pixels) Interleaved 2 of 5 (ITF) Interleaved 2 of 5 (ITF) Advanced Box Improvement 1D Code Orientation 1D Low Contrast 1D Small Codes Improvement 1D Minimum Code Height (pixels) 1D Na
How the Code Reader Tool Works Impact Reference Guide Code Type Processing Mode Standard Settings Processing Mode Advanced Settings Pharmacode (one-track) N/A Pharmacode (one-track) 1D Pharmacode Output Format 1D Pharmacode Min Bar Count 1D Pharmacode Max Bar Count 1D Pharmacode Colored Bars Check 1D Pharmacode Decoded Min Value 1D Pharmacode Decoded Max Value 1D Pharmacode Code Orientation 1D Pharmacode Reverse Decoding PDF417 PDF417 Advanced Box Improvement 1D Code orientation 1D Low Contrast 1D
Impact Reference Guide How the Code Reader Tool Works If the Code Quality Verification input property is True during Training, code quality grades are generated for each found code, where applicable. The grades appear on their respective outputs and on the Setup Grades panel. This table lists the different code types and the possible grades that they can generate.
How the Code Reader Tool Works Impact Reference Guide Bar code symbol quality assessment is based on an analysis of the Scan Reflectance profiles. The scan reflectance profile is a record of the Reflectance values measured on a single line across the entire width of the barcode. Symbol Quality grading is used to derive a relative measure of symbol quality under the measurement conditions used.
Impact Reference Guide How the Code Reader Tool Works Symbol Contrast (SC) Minimum Reflectance (Rmin) Minimum Edge Contrast (ECmin) Modulation (MOD) Defects Decodability (V) The Overall Symbol grade is calculated using the mean of the ten scan grades. AIM DPM QUALITY GUIDELINE The AIM DPM Quality Guideline is applicable to the symbol quality assessment of direct parts marking performed in using two-dimensional bar code symbols.
Troubleshooting Impact Reference Guide Troubleshooting Issue: Bad Image Event A Bad Image Event generates a System Log entry with details of the detected error. It also generates a Bad Image Event Trigger (see “Trigger Event Types” on page 3-35). Things to check • Buffer Overrun – This results from triggering the camera so fast that images are acquired more quickly than the task can process them. That is, the task processing time is consistently longer than the time between camera triggers.
Impact Reference Guide Troubleshooting Slow down the triggering rate Decrease task execution time by optimizing the inspection Issue: Need to Back Up All M-Series Settings, Configuration Files, and Programs All the settings and program files need to be saved or copied from one M-Series processor to another. Things to check • To back up and copy settings, configuration files, and programs: 1.
Troubleshooting Impact Reference Guide When communication with a device is lost or temporarily interrupted, the connected program regularly tries to re-establish communication. During this attempt, this dialog is displayed. If you click Cancel, the program will stop trying to re-establish communication. When communication with the device is restored, this dialog is displayed: Things to check • The network connection to the device is bad. Power to the device has been turned off.
Impact Reference Guide Troubleshooting If you try to connect to a device that has an Impact software version different from the PC, this dialog is displayed. You should click No to abandon the attempted connection. If you click Yes, the connection is completed, but you should not try to edit any vision programs on the device or change any device settings. If you do, you may corrupt the vision program files on the device or put the device into an undesirable state of operation.
Troubleshooting Impact Reference Guide Connect the device • The Impact device is powered off Turn on the device’s power • The IP Address is incorrect Enter the correct IP Address Issue: ImpactSendMessage Tool error in System Log The message "ImpactSendMessageTool::Run - Failure, cannot send Image data type on this platform" is in the System Log.
Impact Reference Guide Troubleshooting Reconnect the cable between the PC and/or switch and the device Check the device’s Ethernet status light, it should be on steady, not blinking • The IP addresses and/or IP masks for the PC and Impact device are incompatible Change the IP address or IP mask on the PC or device to be compatible (see “TCP/IP Settings” on page 6-28 and “IP Address Configuration” on page 1-3) • The device does not respond to a "ping" from the PC Check power to the device
Troubleshooting Impact Reference Guide When you use the On-screen keyboard (OSK) on a Windows 7 64-bit operating system, you may get the following error: If this error occurs, you are probably trying to use the default OSK program location as it is defined in the VPM and CPM OSK setup. You must copy the program file from its current location to another folder and change its default location. Things to check • The default OSK program location as it is defined in the VPM and CPM OSK setup.
I M P A C T R E F E R E N C E Index Symbols @ 4-97 & 5-8 <> 4-97 > 4-97 A AB PCCC read/write values 2-42 system object 2-40 VPM 2-41 Abort on error 2-6, 3-32, 3-34 About CPM 4-6 image 6-25 VPM 3-10 Abs 5-8 Access administrator level 2-13 control panel 2-13 controller level 2-13 level 2-13 monitor level 2-13 operator level 2-13 programmer level 2-13 Acos 5-8 ActiveX server 2-9 Adaptive template tool 3-145 Adaptive threshold 3-186, 6-5 Add input button 3-21 output button 3-21 Add device 3-5 Addday 5-8 Addh
Index atan 5-10 call 5-11 chdir 5-11 chomp 5-11 chr 5-11 close 5-11 comment 5-2, 5-5, 5-23 constants 5-3 cos 5-11 curdir 5-11 data type 5-7 day 5-11 division 5-4 edit window 5-1 end sub 5-12 EOF 5-12 equality 5-4 error 5-12, 5-13 error messages 5-2 error$ 5-13 even 5-13 exit function 5-13 exit sub 5-13 exp 5-13 expressions 5-4 false 5-14 fftmag 5-14 file example 5-32 fix 5-14 formatdate 5-14 frac 5-15 function 5-15 gmtime 5-16 gosub 5-16 goto 5-16 greater than 5-4 greater than or equal 5-4 hex 5-16 hour 5-
Impact Reference Guide variables 5-2 weekday 5-29 XOR 5-4 year 5-29 yearday 5-29 Basic control 4-102 Basic tool 3-204, 5-1 Batch file execute command 4-106 BCD 3-187 Binary Coded Decimal 3-187 Binary image tool 3-42 Blob filter tool 3-95 Blob list control 4-33 Blob tool 3-66 Boolean data type 5-7 Border blobs 3-96 Branch tool 3-205 Break tool 3-206 Buffer overrun 6-43 Buffers not created 6-44 Bump find tool 3-147 Button add input 3-21 add output 3-21 connect 3-6, 4-2 CPM 4-2 enter password 3-21, 3-32 live
Index defined code type 3-167 postal codes 6-34 processing mode 3-168 quality grades 6-39 setup 3-176 standards 6-40 train mode 3-167 Code reader tool 3-167 Code types 6-34 Collapse task tree 3-14 Color bilinear interpolation 2-21 image display 3-16 white balance 2-21 Color blob tool 3-97 Color checker tool 3-100 Color image sampling tool 3-56 Color pixel fill tool 3-43 Command line about image 6-25 access text file 6-22 banner 6-20 country settings 6-18 disable close 6-21 disable close window 6-21 disable
Impact Reference Guide text display 4-96 text entry 4-75 timer 4-123 toggle button 4-76 tolerance 4-78 XBar-R chart 4-98 XML table 4-100 Control palette group 4-24 Control panel add 4-6 add control 4-13 chooser 4-8 defined 4-1 design view options 4-6 design/run mode 4-5 events 4-9 full screen view 4-5 image display 4-9 methods 4-9 move up/down 4-8 new 4-11 print 4-5 properties 4-9 security 2-13, 4-2 template 4-4 toolbar 4-6 tree 4-8 tree select 4-6 Control panel application 4-9 create 4-9 display size 4-12
Index date/time 2-6 events 2-11 in use 3-7 IP address 2-2 IP mask 2-2 memory 2-15 not in list 6-47 not located 6-46 security 2-13 storage 2-15 Device settings tool 3-214 Digital shift 2-26 Disable close 6-21 close Impact device drivers 6-21 exit 6-21 security 2-13 window 6-19 Discrete input tool 3-187 setup 3-188 Discrete output tool 3-188 delay 3-190 dwell 3-190 mask 3-189 output timing method 3-190 setup 3-191 state 3-190 Display does not refresh 6-43 refresh rate 3-10 refresh timeout 3-10 setup chart 3-
Impact Reference Guide Events diagnostics 2-11 Events link 4-109 Examples basic 5-30 Execute command control 4-106 Exit function 5-13 sub 5-13 Exp 5-13 Expand task tree 3-14 Explicit messaging 3-192 Expressions 5-4 Extrapolation 2-26, 2-28 Extreme Difference tool 3-149 F False 5-14 Fftmag 5-14 Field of view 2-28 File basic example 5-32 delete 3-8 list 2-38 load vision program 2-38 restore to client 2-38 vision program load 3-216 vision program save 3-217 File camera no image 6-44 system object 2-34 system
Index I I/O polling rate 2-11 Icons list 3-3 small 3-9, 4-5 yellow 3-38 IF then 5-17 Image auto save 3-10 auto saving 4-28 automatic link 3-28 buffers 2-12, 6-43 color 3-16 color sub-properties 3-35 controls 4-25 display area 3-15, 4-9 display control 4-28 display refresh 6-43 distortion 2-26, 2-28 float display 3-16 format 2-35 history 3-10, 3-12 list - multiple image stitch 3-60 math tool 3-45 not displayed 6-44 sampling tool 3-58 save 2-26, 3-17 save buffers 2-12 stitching multiple images 3-60 stitching
Impact Reference Guide L Label special characters 4-97 Language settings 6-19 Lbound 5-6, 5-19 Lcase 5-20 Lead Statistics tool 3-223 Left 5-20 Legend, chart 4-86 Len 5-20 Less than 5-4 Less than or equal 5-4 Level, user 2-13 License key 2-15 Light leveling tool 3-47 Like 5-20 Line find tool 3-75 Line gauge datum line tool 3-126 Line gauge dual ROI tool 3-129 Line gauge tool 3-122 Line input 5-20 Line list control 4-37 Line profile gradient 6-8 grey level 6-5 Line profile tool 3-60 Line ROI control 4-38 Lin
Index Morphology close tool 3-51 dilate tool 3-54 erode tool 3-54 open tool 3-51 Multiple branch tool 3-211 Multiple image stitch tool 3-60 Multiple point to point measurement tool 3-133 Multiplication 5-4 N New image tool 3-55 No camera connected 6-48 NOT 5-5 Not equal 5-4 Now 5-22 Numeric display control 4-89 Numeric entry control 4-55 O OCR tool 3-180 font library 3-186 train modes 3-185 verification 3-186 Oct 5-22 Odd 5-22 Offline tool 3-216 Offset, camera 2-19 On error goto 5-22 resume 5-22 Online b
Impact Reference Guide see PMA Profile type 6-7 Program vision program unload 3-217 Program banner 6-20 Programmer access 2-13, 4-107 Properties control 4-9 link 3-28 tool 3-24 Properties link 4-109 Pseudocolor 6-3, 6-7 Pulse length 2-18 reset 3-188 Q Quality grades 6-39 Quick setup 1-2 R Radians to degrees 3-125 Radio button control 4-63 Radio button group control 4-64 Range control 4-65 Range scroll control 4-68 Read only 3-7 Real data type 5-7 Real List data type 5-7 Reboot 2-6, 2-11 Reconnect VPM 3-6
Index ActiveX 2-9 OPC 2-9 Set data link 4-109 Settings 2-1 administration 2-13 camera calibration 2-26 copy 6-44 Settings tab 2-1 Setup camera 1-7, 2-18 code reader 3-176 display panel 3-23 Impact device 1-8 tab 3-21 Shape list control 4-46 Shape list ROI 3-18 Shift on both edges 2-8 on camera trigger 2-8 on falling edge 2-8 on rising edge 2-8 rate 2-11 source 2-8 Show on display tab 3-23 Shutter open time 2-18 Simultaneous connections 2-6 Sin function 5-25 Slant angle types 3-57 Slider control 4-70 Small
Impact Reference Guide configure data highlight 4-73, 4-74 configure labels 4-72, 4-73 configure row 4-72 control 4-71 dynamic 4-71 set cell data type 4-74 setup 4-71 static 4-71 summary 3-13 Tabs view 3-11 Tan 5-27 Target calibration 2-28 Task call 3-33 configuration 3-34 create 3-33 delete 3-8 test buttons 3-20 timeout 1-8, 2-6 tree, collapse 3-14 tree, CPM 4-6 tree, expand 3-14 tree, VPM 4-6 trigger event types 3-35 TCP/IP direct connection 6-30 Impact ports 6-28 input event port 2-9 internet connection
Index contrast - multiple ROI 3-103 contrast tool 3-101 correlation pattern find 3-73 counted loop 3-207 counter 3-207 data instance 3-208 data matrix 3-162 data set 3-208 data transfer 3-219 delay 3-209 deslant 3-57 device settings 3-214 discrete input 3-187 discrete output 3-188 edge enhancement 3-43 edge point find 3-104 EtherNet/IP data 3-192 EtherNet/IP read assembly 3-193 EtherNet/IP write assembly 3-193 event scheduler 3-209 extreme difference 3-149 gaussian filter 3-44 greyscale template 3-151 grid
Impact Reference Guide types 3-35 Trim 5-28 Troubleshooting 6-43 True 5-28 Type 5-28 U Ubound 5-6, 5-28 Ucase 5-29 Undef 5-29 array 5-6 constant 5-3 Undistort image tool 3-65 Units per pixel 2-30 Unload vision program file 2-38 Unwrap tool 3-64 Update links button 3-21 User add 2-13 delete 2-14 ID 2-13 level 2-13 modify 2-14 multiple devices 2-14 password 2-14 User interface CPM 4-2 VPM 3-3 V Val 5-29 Variables 5-2 Version checking 6-45 software 3-10, 4-6, 6-45 Vertical binning 2-26 View tabs 3-11 Viewer
Index Datalogic Automation Inc.
