NET Control Reference Manual - assets.omron.com · .NET Control Reference Manual 10 Different versions of Omron.FQ-Control.dll are required for 32 bit and 64 bit operating systems

Smart CameraFQ2-S/CH Series

.NET Control Reference Manual

1st Edition, 2015/04/01

©Copyright　OMRON Corporation 2015　All Rights Reserved.

Cat. No. Q225I-E-01

2

IntroductionThis manual provides information that is required to use .NET Controls with the FQ2-S/CH.When using the FQ2-S/CH, be sure to observe the following:• Read and understand this manual to ensure correct use of the product.• Keep this manual in a safe place for reference whenever necessary.

• All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, ortransmitted, in any form, or by any means, mechanical, electronic, photocopying, recording, orotherwise, without the prior written permission of OMRON.• No patent liability is assumed with respect to the use of the information contained herein.Moreover, because OMRON is constantly striving to improve its high-quality products, theinformation contained in this manual is subject to change without notice.• Every precaution has been taken in the preparation of this manual. Nevertheless, OMRONassumes no responsibility for errors or omissions. Neither is any liability assumed for damagesresulting from the use of the information contained in this publication.

Trademarks・Intel and Core are trademarks of Intel Corporation in the USA and other countries.・Microsoft, Visual Studio, Visual Basic, Visual C#, and Windows are either registered trademarks ortrademarks of Microsoft Corporation in the USA and other countries.　Other company names and product names in this document are the trademarks or registeredtrademarks of their respective companies.

Microsoft product screen shots are reprinted with permission from Microsoft Corporation.

Related ManualsThe information required to use the FQ2-S/CH Series is divided into two manuals: "FQ2-S/CH SeriesUser's Manual" (Cat. No. Z337) and "FQ2-S/CH Series User's Manual for Communications Settings"(Cat. No. Z338). Read each manual as appropriate for your needs.

Manual Description Contents

FQ2-S/CH Series User'sManual (Cat. No. Z337)

Describes the product specifications,basic settings, and other informationrequired to use the FQ2-S/CH Series.

Product specificationsConnections, wiringCamera, image adjustmentInspection item settingsTest measurement, operationTroubleshooting

FQ2-S/CH Series User'sManual for Communications Settings (Cat. No. Z338)

Provides information required to operate the sensor by remote control.

System configurationSensor control methodData input/output specificationsConnectable network typesCommunication settingsOutput data settings

Contents

1 Overview of .NET Controls .............................................42 Recommended System....................................................43 Required Environment ......................................................44 Supported Development Languages..........................45 Overview of Functions .....................................................46 Specifications Restrictions............................................57 Procedures...........................................................................57-1 Adding Controls to an Application ..........................57-2 Executing the Application ..........................................98 Appendix.............................................................................128-1 How to Use .NET Controls ......................................128-2 How to Specify Items................................................278-3 System Data List........................................................288-4 Figure Data List...........................................................298-4-1 Figure Data Structure List..................................298-4-2 List of Figure Data Array Elements.................308-5 API List ...........................................................................368-6 External Reference Parameters ........................163 Revision History ..............................................................166

4


1 Overview of .NET Controls.NET Controls are custom controls that enable easy display of measurement images and results ofthe FQ2-S/CH series in an application created using Microsoft Visual Studio.By simply adding custom controls to the application, you can show measurement images andmeasurement results of the FQ2-S/CH series.

2 Recommended SystemCPU: CPU with Intel Streaming SIMD Extensions, SSE2 or higher and adapted to the system requirements of OS to be used, Visual Studio and .NET FrameworkOS: Windows 7 Professional (32 bit) Windows 8.1 Pro (32 bit) .NET Framework: .NET Framework 3.5Monitor screen: XGA (1024 × 768), True Color (32 bit) or higherMemory: 2 GB or more of RAMFree hard disk space: 2 GB or more

*When Windows8.1 pro is used for OS, the installation of NET Framework3.5 is required.

3 Required EnvironmentMicrosoft Visual Studio 2008, 2010, 2012 or 2013FQ2 Sensor with firmware version 1.91 or later

4 Supported Development LanguagesVisual Basic .NETVisual C#

5 Overview of Functions.NET Controls consists of the following custom controls.

Control (function name) Description

CoreRA(sensor control)

Executes communication between the created application and theconnected FQ2 sensor.You can use CoreRA to detect FQ2 sensor events and control theFQ2 sensor through the API.Controls other than CoreRA and SensorListWindow connect tothe FQ2 sensor through CoreRA.To use .NET controls other than CoreRA and SensorListWindow,the controls must be added.

ImageWindow(image display)

Displays the measurement image of the specified item.


　*The processes required for image inspection are combined into a package on the FQ2 sensor. The sequenceof the processes in the package, in order of execution, is called a flow.

6 Specifications RestrictionsNote the restriction below when using .NET Control.

A maximum of two CoreRA controls or Touch Finders can be connected to one FQ2 sensor. An errorwill occur if you attempt to connect a third CoreRA control or Touch Finder.

7 ProceduresThis section describes the procedures for adding controls to an application and executing theapplication.

7-1 Adding Controls to an Application

Follow the procedure below to add a .NET Control to an application form.Procedure(1) Open the form application project in Visual Studio.(2) To add a .NET Control to the toolbox, drag "Omron.FQ-Control.dll" to "General" (outlined in redbelow) of the toolbox of Visual Studio.

TextWindow(detailed result display)

Displays the measurement results of the specified item.

SensorListWindow(sensor detection)

Finds FQ2 sensors on the network and shows a list of information.

JudgeWindow(overall judgement)

Displays the overall OK/NG judgement, measurement time,execution mode, scene name, and scene number.

FlowWindow(flow display) Displays the flow* of the current scene. The flow cannot be edited.

TrendGraphWindow (trend monitor) Displays the trend monitor.

HistogramWindow (histogram) Displays histograms.

MeasureWindow (measurement)　 Provides a user interface for measurement and remeasurement.

Control (function name) Description

.NET Control Reference Manual5

6

(3) Position and mount the .NET Controls that you added to the application form.Select each control in the toolbox and drag to the application form.

The controls are added to Form Designer as indicated in the red frame below.■CoreRA Control

■ImageWindow Control　　


■TextWindow Control

■SensorListWindow Control

■JudgeWindow Control


8

■FlowWindow Control

■TrendGraphWindow Control

■HistgramWindow Control


■MeasureWindow Control　

*For the procedures for using each control, refer to "8-1. How to Use .NET Controls". (Reference:How to Use .NET Controls (p. 12))

■Changing the Language　You can use the codes below (Visual Basic .NET) to set the language for all custom controls inthe application. If a code is not set, the language will be Japanese.

- Japanese 　Public Class Form1 　Public Sub New() 　System.Threading.Thread.CurrentThread.CurrentUICulture _ 　 = System.Globalization.CultureInfo.GetCultureInfo("ja-JP") 　InitializeComponent() 　End Sub　End Class

- English　Public Class Form1 　Public Sub New() 　System.Threading.Thread.CurrentThread.CurrentUICulture _ 　 = System.Globalization.CultureInfo.GetCultureInfo("en-US") 　InitializeComponent() 　End Sub　End Class

7-2 Executing the Application

This section explains the procedure for executing the application.The files and folders below must be in the same folder as the executable file for the application.The language folder can be in any location.


10

Different versions of Omron.FQ-Control.dll are required for 32 bit and 64 bit operating systems. Usethe appropriate Omron.FQ-Control.dll for your system. Acceptable combinations of operatingsystem, application, and Omron.FQ-Control.dll are indicated below.

■FQ2 Sensor Connection and Disconnection (Specifying an IP Address)(1) Start the FQ2 sensor to be connected to the application.(2) Start the application.(3) Set the properties (IP address) of the CoreRA control in the application.(4) Call up the ConnectStart method of the CoreRA control and connect the application to the FQ2sensor.Example: When the button is pressed, set the CoreRA control properties and connect to the FQ2sensor.　(Visual Basic.NET)Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)

Handles Button1.Click

File DescriptionOmron.FQ-Control.dll

Dll required for use of .NET Controls.

Omron.FQ-Control.PlatformCLR.dllOmron.FQ-Control.Resources.dllOmron.FQ-Control.ViewModels.dllOmron.FQ-Control.VisionComm.dllja-JP folder Folder required for display of Japanese with .NET Controls.

zh-CN folder Folder required for display of Chinese (simplified) with .NETControls.

zh-TW folder Folder required for display of Chinese (traditional) with .NETControls.

de-DE folder Folder required for display of German with .NET Controls.es-ES folder Folder required for display of Spanish with .NET Controls.fr-FR folder Folder required for display of French with .NET Controls.it-IT folder Folder required for display of Italian with .NET Controls.ko-KR folder Folder required for display of Korean with .NET Controls.System.Windows.Forms.DataVisualization.dll Dll required for display of graphs with .NET Controls.

OS Applicationproject platform

Operation mode of process FQ-Control.dll used

32 bit Any CPU 32-bit process 32 bit

32 bit x86 32-bit process 32 bit

64 bit Any CPU 64-bit process 64 bit

64 bit x86 32-bit process(WOW64) 32 bit

64 bit x64 64-bit process 64 bit


　'Setting property.　Me.CoreRA1.IpAddress = "10.5.5.100"

　'Connect to FQ2-S.　Me.CoreRA1.ConnectStart()

End Sub

■FQ2 Sensor Connection (Connecting After Finding Sensor)(1) Start the FQ2 sensor to be connected to the application.(2) Start the application.(3) Call up the SearchSensor method of the SensorListWindow control, and search for FQ2 sensorson the network.(4) Acquire the properties (IP address) using the SensorListUpdated event of the SensorListWindowcontrol in the application, and set in the properties (IP address) of the CoreRA control.(5) Call up the ConnectSensor method of the CoreRA control, and connect the application to theFQ2 sensor.

Example: When the button is pressed, search for FQ2 sensors on the network using theSensorListWindow control. Set the properties (IP address) of the CoreRA control using theSensorListUpdated event of the SensorListWindow control, and connect to the FQ2 sensor.(Visual Basic.NET)Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)

Handles Button1.Click 'Search for sensors on the network. Me.SensorListWindow1.SearchSensor() End Sub

Private Function SensorListWindow1_SensorListUpdated(ByVal sender As System.Object) AsSystem.Int32 Handles SensorListWindow1.SensorListUpdated

If Me.SensorListWindow1.SensorIpList.Count > 0 Then 'A sensor was detected.

'Setting property. Me.CoreRA1.IpAddress = Me.SensorListWindow1.SensorIpList(0)

'Connect to FQ2-S. Me.CoreRA1.ConnectStart()

Else 'A sensor was not detected. End If End Function


12

■ Disconnecting from the FQ2 Sensor

(1) Call up the ConnectSensor method of the CoreRA control, and disconnect the application fromthe FQ2 sensor.

Example: When the button is pressed, disconnect from the FQ2 sensor.(Visual Basic.NET)Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)

Handles Button2.Click

'Disconnect to FQ2-S. Me.CoreRA1.Disconnect()

End Sub

8 AppendixThis section explains how to use .NET controls in an application and specify items, and describessystem data, graphic data, APIs, and external reference parameters.

8-1 How to Use .NET Controls

This section explains how to use .NET Controls Values enclosed in brackets [ ] are default values.

● CoreRA Control

・FunctionExecutes communication between the created application and the connected FQ2 sensor.

・PropertiesProperty Type Set/Get Description

IpAddress String Set/Get Specifies the IP address of the FQ2 sensor towhich the application will connect.

IsConnected Boolean Get onlyReturns the connection status. (Read-only.) 　True: Connected　False: Not connected

DispImageTransferSize Integer Set/GetSpecify the resolution of transmitted measurementimages (X direction). (Units: px)Setting range0 to 999999 [320]

LoggingEnabled Boolean Set/Get

Specify whether logging is enabled or disabled. 　Set to True when using the trend monitor orhistograms.　False: No logging　[True: Logging]

When two Touch Finder or FQ control units areconnected to one sensor, logging is only possibleon one of the units. When two controls with thelogging function turned ON are connected to thesensor, the logging function turns OFF on thecontrol that was connected last.


ImageLoggingFileSave Boolean Set/GetSpecify whether image logging is enabled ordisabled.　[False: No image logging]　True: Image logging

ImageLoggingPrefix String Set/Get

Specify the prefix of the image logging file. [img]The sum of this string and the ImageLoggingDirectorystring cannot exceed 200 characters. The following characters cannot be used:　/ \ : , * ? " < > ¦

DataLoggingFileSave Boolean Set/Get Enable or disable data logging.　[False: No logging]　True: Logging

DataLoggingPrefix String Set/Get

Specify the prefix of the data logging file. [None]The sum of this string and the DataLoggingDirectory string cannot exceed 200characters. The following characters cannot be used:　/ \ : , * ? " < > ¦

ImageLoggingDirectory String Set/Get

Specify the path to the save location of thelogging image file. [None]The sum of this string and the ImageLoggingPrefix string cannot exceed 200characters. The following characters cannot be used:　/ \ : , * ? " < > ¦

DataLoggingDirectory String Set/Get

Specify the path to the save location of thelogging data file. [None]The sum of this string and the DataLoggingPrefix string cannot exceed 200characters. The following characters cannot be used:　/ \ : , * ? " < > ¦

FieldSeparator Delimiter Set/Get

Specify the field separator used in the loggingdata.　None　[Comma]　Tab　Space　Colon　SemiColon　CR　CRLF

RecordSeparator Delimiter Set/Get

Specify the record separator used in the loggingdata.　None　Comma　Tab　Space　Colon　SemiColon　CR　[CRLF]

DecimalSymbol DecimalPoint Set/Get

Specify the decimal point symbol used in thelogging data.　None　Comma　[Period]

Property Type Set/Get Description


14

・Methods

For other methods of controlling the FQ2 sensor, refer to "8-5 API List".(Reference: 8-5 API List (p.32))

・Events

Method Description

ConnectStart

Format:Function　ConnectStart(ByVal myIp As String) As Omron.FQ_Control.ConnectionState

Parameters:　myIP　IP address of FQ2 sensor

Return values:　Connection: Success = 0　Specified path does not exist: DirectoryNotFoundError = 1　Failed to connect: InvalidArgumentError = 3　Description:Connect to the FQ2 sensor according to the property settings.When connection is successful, the ImageWindow, TextWindow,JudgeWindow, FlowWindow, TrendGraphWindow, HistogramWindow,and MeasureWindow controls show FQ2 sensor measurementinformation and settings.

If the application for the connected FQ2 sensor is not running, anapplication without a main form is started.

Disconnect

Format: Function Disconnect() As Integer

Parameters:None

Return values: Disconnected from sensor: 0 No connected sensor: -1

Description:Disconnects from the FQ2 sensor.

Event Description

ProcessStarted Occurs when connection to the FQ2 sensor by the ConnectStart method issuccessful.

ProcessClosed Occurs when the connection with the FQ2 sensor is broken.

ErrorProc

Occurs when one of the FQ2 errors below occurs.・Connection number over : 0x02110102・Connection failure : 0x02110104・File output error : 0x02140600

MeasureDisp Occurs when measurement result display processing is executed on the FQ2sensor.

SceneChange Occurs when scene change processing is executed on the FQ2 sensor.RunModeChange Occurs when the run mode of the FQ2 sensor is changed.


● ImageWindow Control

・FunctionDisplays the measurement result image of the specified item.To open the setting window, click the square in the upper left corner of the control.

・Display image

・Setting window


ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.

ImageOrigin System.Drawing.Point

Set/Get

Specify the coordinates of the upper left corner ofthe displayed image, with the coordinates relativeto the upper left corner of the window.Setting range　(-9999, -9999) to (9999, 9999) [(0,0)]

ImageVisible Integer Set/GetSpecify whether the image window is shown orhidden.　0: Hide window　[1: Show window]

Magnification Double Set/Get

Specify the image magnification.Specify the magnification using a real number. Forexample, to reduce the size of the image by one-half, specify "0.5". To double the size of the image,specify "2.0".To automatically adjust the image to the size ofthe window, specify "-1".Setting range　-1 to 12.0 [-1]


16

・Methods

ItemKind ITEM KIND Set/Get

Specify the type of processing item that isdisplayed.　[ITEM_CAMERA (0) image input item]　ITEM_COMPENSATION (1) image adjustmentitem　ITEM_MEASURE (2) inspection item　ITEM_OUTPUT (3) output item (calculation)

SubNo Integer Set/Get

Specify the sub-number of the processing itemthat is displayed.To activate position list mode and show themeasurement regions of all inspection items,specify "-1".Setting range　-1 to 100 [0]

ItemNo Integer Set/Get

Specify the number of the processing item that isdisplayed.Setting range　0 to 31 [0]The setting range varies by processing item type.　0 only (image input item)　0 to 7 (image adjustment item)　0 to 31 (inspection item)　0 only (output item (calculation))

FollowFlow Integer Set/GetLink to flow display　0: Display the item specified by ItemKind andItemNo.　[1: Display the item selected in FlowWindow.]

UpdateImageRunUPDATE IMAGE SETUP

Set/GetSpecify the image update timing during operation.　[LATEST]: (0) Display the most recent measurement image　LAST NG: (1) Display the most recent NG image

UpdateImageSetupUPDATE IMAGE SETUP

Set/Get

Specify the image update timing duringadjustment.　[FREEZE]: (0) Update at each measurement　THROUGH: (1) Update continuously (live display)

WindowNo Integer Set/Get Window number (0 only)Setting range 0 only [0]

Method Description

pictureBox_MouseDown

Format:Protected Overridable Sub pictureBox_MouseDown(ByVal sender AsObject, ByVal e As System.Windows.Forms.MouseEventArgs)

Parameters:　Sender Source object of event　　e Mouse movement information

Return value:None

Description:By overriding with a derived class, you can redefine the MouseDownevent handler of the image display part of the image window.



・Events

● TextWindow Control

・FunctionDisplays the detailed results of the item specified in the item type or display item properties.To open the setting window, click the square in the upper right corner of the control.

・Display image

pictureBox_MouseUp

Format:Protected Overridable Sub pictureBox_MouseUp(ByVal sender AsObject, ByVal e As System.Windows.Forms.MouseEventArgs)

Parameters:　Sender Source object of event　e Mouse movement information

Return value:None

Description:By overriding with a derived class, you can redefine the MouseUp eventhandler of the image display part of the image window.

pictureBox_MouseDown

Format:Protected Overridable Sub pictureBox_MouseMove(ByVal sender AsObject, ByVal e As System.Windows.Forms.MouseEventArgs)

Parameters:　Sender Source object of event　e Mouse movement information

Return value:None

Description:By overriding with a derived class, you can redefine the MouseMoveevent handler of the image display part of the image window.

Event Description

ImageWindowPictureClick Occurs when the image display part of the image window isclicked.

ImageWindowPicturePaint Occurs when the image display part of the image window isredrawn.

Method Description


18

・Setting window

・Properties

● SensorListWindow Control

・FunctionFinds FQ2 sensors on the network and shows a list of information.You can also use this control to configure network settings of FQ2 sensors that are found.

・Searches for sensors and shows a list of the FQ2 sensors that are found on the network.・Sensors that have already been connected are not detected.・You can acquire the sensor information, MAC address, and IP address of detected sensors.・You can select a sensor from the list and set auto IP address assignment or configure networksettings.




Specify the type of processing item that isdisplayed.　[ITEM_CAMERA (0) image input item]　ITEM_COMPENSATION (1) image adjustmentitem　ITEM_MEASURE (2) inspection item　ITEM_OUTPUT (3) output item (calculation)



FollowFlow IntegerSet/Get Link to flow display

　0: Display the item specified by ItemKind andItemNo.　[1: Display the item selected in FlowWindow.]

FontSize Float Set/GetSpecify the font size of the display text. (Units:px)Setting range　8 to 72 [10]


・Display image

・Properties

・Methods


SensorInfoList

System.Collections.Generic.List(OfOmron.FQ_Control.SensorInformation)

Get only

Found sensor information SensorInformation　{string Mac: MAC address　string Name: Sensor name　string IPAddress: IP address　string SubnetMask: Subnet mask　string Defaultgateway: Default gateway string Version: Software version　string Model: Model bool IPSettingAuto: Sensor IP setting method(auto/manual) }

SensorMacList

System.Collections.Generic.List(Of String)

Get only List of MAC addresses of found sensors

SensorIpList


Get only List of IP addresses of found sensors

CheckedIndeces


Get only Index of checked sensors

SelectedIndex Integer Get only Index of selected sensors

FontSize SingleSet/Get Specify the font size of the display text. (Units:

px)Setting range 8 to 64 [9]

Method Description

SearchSensor

Format:Sub SearchSensor(ByVal myIp As String)

Parameters:　myIP IP address to be used (if omitted, the IP address is automaticallyselected from a valid local area connection)

Return value:None

Description:Searches for sensors on the network and updates the sensor list.


20

・Event

● JudgeWindow Control

・Function　Displays the overall judgement, measurement time, current scene number, scene name, andexecution mode.

・Display image

IpAutoSetting

Format:Sub IpAutoSetting(ByVal indeces As System.Collections.Generic.List(Of Integer), ByVal myIp As String)Parameters: indeces: Sensor list index (if omitted, CheckedIndeces is used) myIP: IP address to be used (if omitted, the IP address is automaticallyselected from a valid local area connection)

Return value:None

Description:Assigns IP addresses to sensors whose IP setting method is "Auto" inthe sensor list.

NetworkSetting

Format:Sub NetworkSetting(ByVal index As Integer, ByVal ip As String, ByValsubnet As String, ByVal gateway As String, ByVal option As Integer,ByVal myIp As String)

Parameters: indeces: Sensor list index (if omitted, CheckedIndeces is used) ip:　IP address to be changed subnet: Subnet mask to be changed gateway: Default gateway to be changed option: 0: None, 1: Save in sensor myIP: IP address to be used (if omitted, the IP address is automaticallyselected from a valid local area connection)

Return value:None

Description:Changes the network settings of the sensors in the sensor list.

Event DescriptionSensorListUpdated Occurs when the sensor list is updated

Method Description


・Properties

・Event



JudgeFontSize Single Set/GetSpecify the font size of the judgement string.(Units: px)Setting range　8 to 64 [64]

JudgeLocation System.Drawing.Point

Set/GetCoordinates of the upper left corner of thejudgement stringSetting range　(-32768, -32768) to (32767, 32767) [(0,0)]

JudgeVisible BooleanSet/Get Judgement string display

　[True: Show]　False: Hide

TimeFontSize Single Set/GetSpecify the font size of the measurement timestring. (Units: px)Setting range　8 to 64 [20]

TimeLocation System.Drawing.Point

Set/Get

Coordinates of the upper left corner of themeasurement time stringSetting range　(-32768, -32768) to (32767, 32767) [(164, 70)]

TimeVisible BooleanSet/Get Measurement time string display


ModeFontSize Single Set/GetSpecify the font size of the measurement modestring. (Units: px)Setting range　8 to 64 [25]

ModeLocationSystem.Drawing.Point Set/Get

Coordinates of the upper left corner of themeasurement mode stringSetting range　(-32768, -32768) to (32767, 32767) [(212, 11)]

ModeVisible BooleanSet/Get Measurement mode string display


SceneFontSize Single Set/GetSpecify the font size of the scene name string.(Units: px)Setting range　8 to 64 [20]

SceneLocation System.Drawing.Point

Set/Get

Coordinates of the upper left corner of the scenename stringSetting range　(-32768, -32768) to (32767, 32767) [(287, 70)]

SceneVisible Boolean Set/GetScene name string display　[True: Show]　False: Hide

Event DescriptionJudgeWindowClick Occurs when JudgeWindow is clicked.


22

● FlowWindow Control

・FunctionDisplays the flow of the current scene.This control also displays a list of the processing items in the current scene, along with icons, itemnames, and judgement results (OK/NG) for each item.For ImageWindow and TextWindow, if you specify "Link to flow display" in these properties and clicka flow, the display in each window will be updated in sync with the selected flow.

・Display image

・Properties

・Event

● TrendGraphWindow Control

・Function　Displays a trend monitor of the item data selected in the properties.The trend monitor plots up to 1,000 points of data per graph line. Measurement data is alwaysadded to the right of the graph. If the number of points specified in the horizontal axis range



ItemHeight Integer Set/GetSpecify the size (height) of items to be displayedin the flow list.Setting range 16 to 128 [48]

FontSize Single Set/Get Specify the font size of the item name. (Units: px)Setting range 8 to 64 [12]

FlowItemCount Integer Get only Get the total number of items currently on FlowWindow.

SelectedItemIdent Integer Get only Gets the identifiers of items currently on FlowWindow.

SelectedItemKind ITEM KIND Get only Get the type of items currently on FlowWindow.

SelectedItemNo Integer Get only Get the item numbers of items currently on FlowWindow.

Event DescriptionItemButtonClick Occurs when the item button is clicked.


parameter is already plotted, the latest data will be added to the right end. The existing data pointswill be shifted to the left.To open the setting window, click the square in the upper left corner of the control.The trend monitor shows up to three lines simultaneously.If you change the items or data that are displayed, the data of the previously shown items or dataare not discarded.To show the trend monitor, enable the logging settings of the CoreRA control that is used forconnection.

・Display image

・Setting window



LineSetting LINESETTING

Set/Get Graph line settings, 3 lines

GraphVisible Integer Set/Get Show/hide setting　　[0: Hide line]　　1: Show line

LineColorSystem.Drawing.Color Set/Get

Line colorSetting range　 (R, G, B) = (0, 0, 0) to (255, 255, 255)　[(255, 0, 0)]

LineWidth Integer Set/GetLine thicknessSetting range 1 to 10 [1]


24

t

s

● HistogramWindow Control

・Function　Displays a histogram of the item data selected in the properties.You can plot up to 1,000 points of data.To open the setting window, click the square in the upper left corner of the control.To show the trend monitor, enable the logging settings of the CoreRA control that is used forconnection.


Processing item type　[ITEM_CAMERA (0) image input item]　ITEM_COMPENSATION (1) image adjustmenitem　ITEM_MEASURE (2) inspection item　ITEM_OUTPUT (3) output item (calculation)


Specify the number of the processing item that idisplayed.Setting range　0 to 31 [0]The setting range varies by processing item type.　0 only (image input item)　0 to 7 (image adjustment item)　0 to 31 (inspection item)　0 only (output item (calculation))

DataNo Integer Set/Get Data number of data to be displayedSetting range　0 to 99999 [0]

MultiDataNo Integer Set/Get Data number of multi-measurement dataSetting range　0 to 99 [0]

MinValue Double Set/GetLower limit of vertical axisSetting range　-999999999.9999 to 999999999.9999 [-999999999.9999]

MaxValue Double Set/GetUpper limit of vertical axisSetting range　-999999999.9999 to 999999999.9999 [999999999.9999]

DisplayMaximum Dmaximum Set/Get

Horizontal axis rangeSetting range　[COUNT_100]　COUNT_200　COUNT_300　COUNT_400　COUNT_500　COUNT_600　COUNT_700　COUNT_800　COUNT_900　COUNT_1000

FontSize Single Set/GetSpecify the font size of the axis scale. (Units: px)Setting range　8 to 64 [10]



・Display image

・Setting window



BarColor System.Drawing.Color

Set/GetBar colorSetting range　 (R, G, B) = (0, 0, 0) to (255, 255, 255)　[(0, 0, 255)]


Processing item type　[ITEM_CAMERA (0) image input item]　ITEM_COMPENSATION (1) image adjustmentitem　ITEM_MEASURE (2) inspection item　ITEM_OUTPUT (3) output item (calculation)



DataNo Integer Set/GetData number of data to be displayedSetting range　0 to 99999 [0]

MultiDataNo Integer Set/GetData number of multi-measurement dataSetting range　0 to 99 [0]


26

●MeasureWindow Control

・Function　In the run window, the control remeasures the camera images. In the setup window, the controlmeasures or remeasures the camera images, the logging images, and the file images.File formats of image files you can remeasure are ifz and bmp.

・Display image

MinValue Double Set/Get

Lower limit of horizontal axisSetting range　-999999999.9999 to 999999999.9999 　[-999999999.9999]

MaxValue Double Set/GetUpper limit of horizontal axisSetting range -999999999.9999 to 999999999.9999 [999999999.9999]

YAxis DMaximum Set/Get

Vertical axis rangeSetting range　[COUNT_100]　COUNT_200　COUNT_300　COUNT_400　COUNT_500　COUNT_600　COUNT_700　COUNT_800　COUNT_900　COUNT_1000

StepSize Integer Set/Get Skipping widthSetting range　1 to 10000 [10]

FontSize Single Set/Get Specify the font size of the axis scale. (Units: px)Setting range　8 to 64 [10]



・Properties

8-2 How to Specify Items

　To specify a target item, use the item type number and the item number. The item number isassigned in order of item registration for items of that type.

　For details on the inspection items and image adjustment items, refer to the user's manual.

Example:　Specify a processing item in the following processing flow of the FQ2 sensor

Image input (0)　0: Camera image inputImage adjustment (1)　0: Edge position compensation　1: Weak smoothingInspection items (2)　0. Search　1. Shape search II　2. OCROutput item (calculation) (3)　0. Calculation

To specify shape search II as the target item, specify as follows:　Item type number: 2 (inspection)　Item number: 1 (shape search II)



Item type (item type number) Item

Image input (0) Camera image input

Image adjustment (1)

Color gray filter, weak smoothing, strong smoothing, dilate,erosion, median, extract edges, extract horizontal edges,extract vertical edges, enhance edges, backgroundsuppression, shape search position compensation, searchposition compensation, edge position compensation, two-edge position compensation, two-edge midpointcompensation, edge rotation position compensation, andposition compensation

Inspection (2)OCR, barcode, 2D-code, 2D-code (DPM), search, sensitivesearch, shape search II, edge position, edge width, edgepitch, area, color data, labeling

Calculation (3) Calculation


28

8-3 System Data List

The identification information and data identifiers that are required to set or get system data areshown below.

Identification information 0 Identification information 1 Data identifier

Configuration

--- Configuration

Startup scene control saveSceneStart

Startup scene number initialSceneNo

Camera control--- CameraControl

Trigger delay cameraDelay0

Measurement control--- MeasureControl

BUSY output condition BusyControl

Logging control

--- Logging

Image data imageLogging

Measurement data dataLogging

Statistical data totalLogging

Parallel control

--- ParallelIo

OR output polarity

Output delay riseTime

Judgement output mode orOutMode

One-shot output time orOutputTime

OUT0 polarity out0Polarity



OUT0 signal assignment out0Control



Input mode commandMode

LED BUSY busyLedControl

Retry function

--- Retry

Switch order (scene switching) retryChangeSceneMethod

Switch order (target scene) retryChangeSceneArray

Timeout time retryTimeout


8-4 Figure Data List

To set or get a model figure or region figure held in a processing unit, use an array to specify thefigure data.

8-4-1 Figure Data Structure List

The structure of figure data is indicated below.

Parallel Interface SensorData Unit

--- Sdu1

OR output orOutJudge


OR output delay orRiseTime

OR one-shot output time orOutputTime

Output control handshake

Output period cycleTime

GATE ON delay riseTime

Output time outputTime

Timeout timeout

Number of delay delayCount

ACK signal ON period ackOutputTime

RS-232C Interface SensorData Unit

--- Sdu2

OR output orOutJudge


OR output delay time orRiseTime

OR one-shot output time orOutputTime

ALL OUT signals polarity outPolarity

Parallel command mode commandMode

ACK signal ON period ackOutputTime

Array element Description Description

figure(0) Figure data header information

Contains figure data header information. Includes the numberof figures and figure data size information.Upper 16 bits: Number of figuresLower 16 bits: Number of bytes of figure data size (figurearray length x 4)Figure data header information = Number of bytes of figuredata size + Number of figure data x 65536

figure(1) Figure 0 type information

Type information of figure 0 data. Includes drawing mode andfigure type information.Upper 16 bits: Drawing modeLower 16 bits: Figure typeFigure type information = Figure type + Drawing mode x65536

figure(2) Figure 0 data Figure data of figure 0. The size and content depend on the figuretype.

Identification information 0 Identification information 1 Data identifier


30

The following shows an example of a data structure that is composed of multiple figures (rectanglesand polygons).aaa

8-4-2 List of Figure Data Array Elements

The array elements of each figure and corresponding settings are shown below. The informationshown in the table is for a figure count of 1.

figure(3) Figure 0 data Figure data of figure 0. The size and content depend on the figuretype.

... ... ...

... Figure 1 type information Type information of figure 1 data.

...

Figure 1 data Figure data of figure 1. The size and content depend on the figuretype.

... ... ...

... Figure N type information Type information of figure N data.

...

Figure N data Figure data of figure N. The size and content depend on the figuretype.

... ... ...

Array element Description


figure(1) Figure type information: Rectangle

figure(2) X-coordinate of upper left point

figure(3) Y-coordinate of upper left point

figure(4) X-coordinate of lower right point

figure(5) Y-coordinate of lower right point

figure(6) Figure type information: Polygon

figure(7) Number of vertices

figure(8) X-coordinate of first point

figure(9) Y-coordinate of first point

figure(10) X-coordinate of second point

figure(11) Y-coordinate of second point

.

.

.

.

.

.

figure(24) X-coordinate of ninth point

figure(25) Y-coordinate of ninth point

figure(26) X-coordinate of tenth point

figure(27) Y-coordinate of tenth point

Array element Description Description


Figure Figure type

Array element Description

Wide line 4


figure(1) Figure type information





figure(6) Width

Rectangle 8



figure(2) X-coordinate of upper left point

figure(3) Y-coordinate of upper left point

figure(4) X-coordinate of lower right point

figure(5) Y-coordinate of lower right point

Ellipse 16



figure(2) X-coordinate of center point

figure(3) Y-coordinate of center point

figure(4) Radius on X-axis

figure(5) Radius on Y-axis

Wide circle 64



figure(2) X-coordinate of center point

figure(3) Y-coordinate of center point

figure(4) Radius

figure(5) Width

Polygon 512



figure(2) Number of vertices





.

.

.

.

.

.

figure(19) X-coordinate of ninth point

figure(20) Y-coordinate of ninth point

figure(21) X-coordinate of tenth point

figure(22) Y-coordinate of tenth point


32

8-5 API List

The following table shows APIs that can be used.Alphabetical Order

API name Function Classification References

AssignMeasureItem Adds an inspection item. Flow Control Reference: Details (p.41)

AssignPositionItem Adds an image adjustment item. Flow Control Reference: Details (p.43)

CalculationData Gets numerical data of a calculation. ProcessingItem Control

Reference: Details (p.45)

CalculationData2 Gets character string data of a calculation.

ProcessingItem Control


CameraData Gets numerical data of camera parameters.



ChangeScene Changes the scene. Scene Control Reference: Details(p.48)

ClearError Clears an error. Other Reference: Details(p.49)

ClearMeasureData Clears measurement results of a processing item. Other Reference: Details

(p.50)

ClearScene Clears scene data. Scene Control Reference: Details(p.51)

ClearTotalData Clears statistical data. Other Reference: Details(p.52)

CopyMeasureItem Copies an inspection item. Flow Control Reference: Details(p.53)

CopyPositionItem Copies an image adjustment item. Flow Control Reference: Details(p.54)

CopyScene Copies scene data. Scene Control Reference: Details(p.55)

DeleteMeasureItem Deletes an inspection item. Flow Control Reference: Details(p.56)

DeletePositionItem Deletes an image adjustment item. Flow Control Reference: Details(p.57)

GetAll Gets the input statuses of all input terminals.

IO Module Control

Reference: Details(p.58)

GetApplicationVersion Gets the software version of the sensor. Other Reference: Details

(p.60)

GetCalculationData Gets calculation data. ProcessingItem Control


GetCameraData Gets data of camera parameters. ProcessingItem Control


GetErrorCode Gets the most recent sensor error code. Other Reference: Details

(p.65)

GetLinkOutputData Gets data output by link data / Fieldbus data communication.



GetMeasureItemData Gets data of an inspection item. ProcessingItem Control



GetMeasureItemFigure Gets figure data registered in an inspection item.



GetMeasureOut Gets the external output setting for measurement results.

MeasurementControl


GetNoprotocolOutputData Gets data output by no protocol datacommunication.



GetParallelData Gets data output by parallel data communication.



GetParallelJudgeData Gets data output by parallel judgement output.



GetPort Gets the input status of a specified input terminal.

IO Module Control


GetPositionItemData Gets data of an image adjustment item.



GetPositionItemFigure Gets figure data of an image adjustment item.



GetRetryData Gets retry data. ProcessingItem Control


GetRunMode Gets the execution status (execution mode) of the FQ2 sensor.

MeasurementControl


GetSystemData Gets system data. System Data Reference: Details(p.83)

GetTotalData Gets statistical data. Other Reference: Details(p.84)

ImageUpdate Updates the image input from the camera.

MeasurementControl


IOMonitorStart Starts the IO monitor. IO ModuleControl


IOMonitorStop Terminates the IO monitor. IO ModuleControl


LinkOutputData Gets numerical data output by linkdata / Fieldbus data communication.



LinkOutputData2Gets character string data output bylink data / Fieldbus data communication.



LoadBackupDataLoads all setting data (all scene data, system data, and calibration group data).

Data Save/Load


LoadScene Loads scene data. Data Save/Load


LoadSceneGroup Loads scene group data. Data Save/Load


LoadSystemData Loads system data. Data Save/Load


Measure Executes measurement processing. Measurement Control


MeasureItemCount Gets the number of inspection items. Flow Control Reference: Details(p.95)

MeasureItemData Gets numerical data of an inspection item.

Processing Item Control




34

MeasureItemData2 Gets character string data of an inspection item.



MeasureItemIdent Gets the identifier of a registered inspection item.



MeasureItemJudge Gets the judgement result of an inspection item.

Measurement Control


MeasureItemTitle Gets the title of an inspection item Processing Item Control


NoprotocolOutputData Gets numerical data output by no protocol data communication.



NoprotocolOutputData2 Gets character string data by no protocol data communication.



ParallelData Gets numerical data output by parallel data communication.



ParallelData2 Gets character string data output by parallel data communication.



ParallelJudgeData Gets numerical data output by parallel judgement output.



ParallelJudgeData2 Gets string data output by parallel judgement output.



PositionItemCount Gets the number of image adjustment items. Flow Control Reference: Details

(p.107)

PositionItemData Gets numerical data of an image adjustment item.



PositionItemIdent Gets the identifier of a registeredimage adjustment item.



PositionItemJudge Gets the judgement result of an image adjustment item.

Measurement Control


PositionItemTitle Gets the title of an image adjustmentitem.



PutAll Sets the output statuses of all output terminals.

IO Module Control


PutPort Sets the output status of a specified output terminal.

IO Module Control


RefreshImageWindow Updates the image display window and text display window.

DisplayControl


ReMeasure Executes remeasurement. Measurement Control


RetryData Gets numerical data related to retry. Processing Item Control


RunOut Sets the output status of the RUN signal

IO Module Control


SaveBackupDataSaves all setting data (all scene data, system data, and calibration group data) of the sensor to a file.

Data Save/Load


SaveData Saves all setting data in the sensor. Data Save/Load


SaveImage Saves image data. Measurement Control




SaveLoggingDataSaves measurement data saved in the sensor memory by the logging function to a file.

Other Reference: Details(p.124)

SaveScene Saves scene data. Data Save/Load


SaveSceneGroup Saves the scene group data. Data Save/Load


SaveSystemData Saves system data. Data Save/Load


SceneCount Gets the number of scenes that can be used. Scene Control Reference: Details

(p.128)

SceneNo Gets the scene number of the current scene. Scene Control Reference: Details

(p.129)

SceneTitle Gets the scene title. Scene Control Reference: Details(p.130)

SensorName Gets the sensor name. System Data Reference: Details(p.131)

SetCalculationData Sets calculation data. Processing Item Control


SetCameraData Sets camera parameter data. Processing Item Control


SetLinkOutputData Sets the data output by link data / Fieldbus data communication.



SetMeasureItemData Sets the data of an inspection item. Processing Item Control


SetMeasureItemFigure Sets the figure data of an inspectionitem.



SetMeasureItemTitle Sets the title of an inspection item Processing Item Control


SetMeasureOutSets whether or not measurementresults are output to an externaldevice.

Measurement Control


SetNoprotocolOutputData Sets the data that are output by noprotocol communication.



SetSensorName Sets the sensor name. System Data Reference: Details(p.158)

SetParallelData Sets the data that are output by parallel data communication.



SetParallelJudgeData Sets the data that are output by parallel judgement output.



SetPositionItemData Sets the data of an image adjustmentitem.



SetPositionItemFigure Sets the figure data of an image adjustment item.



SetPositionItemTitle Sets the title of an image adjustment item



SetRetryData Sets the retry data. Processing Item Control


SetRunMode Sets the execution status (executionmode) of the sensor.

Measurement Control




36

SetSceneTitle Sets the title of a scene. Scene Control Reference: Details(p.157)

SetSystemData Sets the system data. System Data Reference: Details(p.159)

SystemReset Reboots the sensor. Other Reference: Details(p.160)

TeachMeasureItem Performs teaching for a specified inspection item.



TeachPositionItem Performs teaching for a specified image adjustment item.





Function-based Index

●Scene Controls

●Processing Flow Controls

●Processing item control

API name Function References

ChangeScene Changes the scene. Reference: Details (p.48)

ClearScene Clears scene data. Reference: Details (p.51)

CopyScene Copies scene data. Reference: Details (p.55)

SceneCount Gets the number of scenes that can be used. Reference: Details (p.128)

SceneNo Gets the scene number of the current scene. Reference: Details (p.129)

SceneTitle Gets the scene title. Reference: Details (p.130)

SetSceneTitle Sets the title of a scene. Reference: Details (p.157)


AssignMeasureItem Adds an inspection item. Reference: Details (p.41)

AssignPositionItem Adds an image adjustment item. Reference: Details (p.43)

CopyMeasureItem Copies an inspection item. Reference: Details (p.53)

CopyPositionItem Copies an image adjustment item. Reference: Details (p.54)

DeleteMeasureItem Deletes an inspection item. Reference: Details (p.56)

DeletePositionItem Deletes an image adjustment item. Reference: Details (p.57)

MeasureItemCount Gets the number of inspection items. Reference: Details (p.95)

PositionItemCount Gets the number of image adjustment items. Reference: Details (p.107)


CalculationData Gets numerical data of a calculation. Reference: Details (p.45)

CalculationData2 Gets character string data of a calculation. Reference: Details (p.46)

CameraData Gets numerical data of camera parameters. Reference: Details (p.47)

GetCalculationData Gets calculation data. Reference: Details (p.61)

GetCameraData Gets data of camera parameters. Reference: Details (p.63)

GetLinkOutputData Gets data output by link data / Fieldbus data communication. Reference: Details (p.66)

GetMeasureItemData Gets data of an inspection item. Reference: Details (p.68)

GetMeasureItemFigure Gets figure data registered in an inspection item. Reference: Details (p.70)

GetNoprotocolOutputData Gets data output by no protocol data communication. Reference: Details (p.72)

GetParallelData Gets data output by parallel data communication. Reference: Details (p.73)

GetParallelJudgeData Gets data output by parallel judgement output. Reference: Details (p.74)

GetPositionItemData Gets data of an image adjustment item. Reference: Details (p.78)

GetPositionItemFigure Gets figure data of an image adjustment item. Reference: Details (p.79)

GetRetryData Gets retry data. Reference: Details (p.80)

LinkOutputData Gets numerical data output by link data / Fieldbus data communication. Reference: Details (p.88)


38

LinkOutputData2 Gets character string data output by link data / Fieldbus data communication. Reference: Details (p.89)

MeasureItemData Gets numerical data of an inspection item. Reference: Details (p.96)

MeasureItemData2 Gets character string data of an inspection item. Reference: Details (p.97)

MeasureItemIdent Gets the identifiers of the registered inspection items. Reference: Details (p.98)

MeasureItemTitle Gets the title of an inspection item Reference: Details (p.100)

NoprotocolOutputData Gets numerical data output by no protocol data communication. Reference: Details (p.101)

NoprotocolOutputData2 Gets character string data by no protocol data communication. Reference: Details (p.102)

ParallelData Gets numerical data output by parallel data communication. Reference: Details (p.103)

ParallelData2 Gets character string data output by parallel data communication. Reference: Details (p.104)

ParallelJudgeData Gets numerical data output by parallel judgement output. Reference: Details (p.105)

ParallelJudgeData2 Gets string data output by parallel judgement output. Reference: Details (p.106)

PositionItemData Gets numerical data of an image adjustment item. Reference: Details (p.108)

PositionItemIdent Gets the identifier of a registered image adjustment item. Reference: Details (p.109)

PositionItemTitle Gets the title of an image adjustment item Reference: Details (p.111)

RetryData Gets the numerical data of a retry. Reference: Details (p.119)

SetCalculationData Sets calculation data. Reference: Details (p.132)

SetCameraData Sets camera parameter data. Reference: Details (p.134)

SetLinkOutputData Sets the data output by link data / Fieldbus data communication. Reference: Details (p.136)

SetMeasureItemData Sets the data of an inspection item. Reference: Details (p.138)

SetMeasureItemFigure Sets the figure data of an inspection item. Reference: Details (p.140)

SetMeasureItemTitle Sets the title of an inspection item Reference: Details (p.142)

SetNoprotocolOutputData Sets the data that are output by no protocol communication. Reference: Details (p.144)

SetParallelData Sets the data that are output by parallel data communication. Reference: Details (p.146)

SetParallelJudgeData Sets the data that are output by parallel judgement output. Reference: Details (p.148)

SetPositionItemData Sets the data of an image adjustment item. Reference: Details (p.150)

SetPositionItemFigure Sets the figure data of an image adjustment item. Reference: Details (p.152)

SetPositionItemTitle Sets the title of an image adjustment item Reference: Details (p.154)

SetRetryData Sets the retry data. Reference: Details (p.155)

TeachMeasureItem Performs teaching for a specified inspection item. Reference: Details (p.161)

TeachPositionItem Performs teaching for a specified image adjustment item. Reference: Details (p.162)



●Measurement Controls

●IO Module Controls

●Display Controls

●System Data


ClearMeasureData Clears measurement results of a processing item. Reference: Details (p.50)

GetMeasureOut Gets the external output setting for measurement results. Reference: Details (p.71)

ImageUpdate Updates the image input from the camera. Reference: Details (p.85)

GetRunMode Gets the execution status (execution mode) of the FQ2 sensor. Reference: Details (p.82)

Measure Executes measurement processing. Reference: Details (p.94)

MeasureItemJudge Gets the judgement result of an inspection item. Reference: Details (p.99)

PositionItemJudge Gets the judgement result of an image adjustment item. Reference: Details (p.110)

ReMeasure Executes remeasurement. Reference: Details (p.117)

SaveImage Saves image data. Reference: Details (p.123)

SetMeasureOut Sets whether or not measurement results are output to an external device. Reference: Details (p.143)

SetRunMode Sets the execution status (execution mode) of the FQ2 sensor. Reference: Details (p.156)


GetAll Gets the input statuses of all input terminals. Reference: Details (p.58)

GetPort Gets the input status of a specified input terminal. Reference: Details (p.76)

IOMonitorStart Starts the IO monitor. Reference: Details (p.86)

IOMonitorStop Terminates the IO monitor. Reference: Details (p.87)

PutAll Sets the output statuses of all output terminals. Reference: Details (p.112)

PutPort Sets the output status of a specified output terminal. Reference: Details (p.114)

RunOut Sets the output status of the RUN signal. Reference: Details (p.120)


RefreshImageWindow Updates the image display window and text display window. Reference: Details (p.116)


GetSystemData Gets system data. Reference: Details (p.83)

SensorName Gets the sensor name. Reference: Details (p.131)

SetSensorName Sets the sensor name. Reference: Details (p.158)

SetSystemData Sets the system data. Reference: Details (p.159)


40

●Data Save/Load

●Others


LoadBackupData Loads all setting data (all scene data, system data, and calibration group data). Reference: Details (p.90)

LoadScene Loads scene data. Reference: Details (p.91)

LoadSceneGroup Loads scene group data. Reference: Details (p.92)

LoadSystemData Loads system data. Reference: Details (p.93)

SaveBackupData Saves all setting data (all scene data, system data, and calibration group data) of the sensor to a file. Reference: Details (p.121)

SaveData Saves all setting data of the FQ2 sensor. Reference: Details (p.122)

SaveScene Saves scene data. Reference: Details (p.125)

SaveSceneGroup Saves the scene group data. Reference: Details (p.126)

SaveSystemData Saves system data. Reference: Details (p.127)


ClearError Clears an error. Reference: Details (p.49)

ClearTotalData Clears statistical data. Reference: Details (p.52)

GetApplicationVersion Gets the software version of the sensor. Reference: Details (p.60)

GetErrorCode Gets the most recent sensor error code. Reference: Details (p.65)

GetTotalData Gets statistical data. Reference: Details (p.84)

SaveLoggingData Saves measurement data saved in the sensor memory by the logging function to a file. Reference: Details (p.124)

SystemReset Reboots the sensor. Reference: Details (p.160)


8-5-1AssignMeasureItem

Adds an inspection item.

FormatFunction AssignMeasureItem(ByVal itemIdent As String) As Integer

Parameter

Return valueError code (0: Normal, -1: Error)

DescriptionAdds an inspection item with identifier specified in the <itemIdent> parameter to the end of themeasurement flow. You can add up to 32 inspection items.The inspection item identifiers are shown below.

Usage Cautions･ This command is only valid in setup mode.

ExampleAdd a search processing item to the end of the measurement flow.

Supported VersionsVersion 1.91 or later

Parameter name Data type Description

itemIdent String Identifier of the processing item to be registered as an inspection item

Inspection item Inspection item identifierOCR OCRBarcode Barcode2D-code 2DCode2D-code (DPM) 2dcrV400Search SearchSensitive search SensitiveSearchShape search II ShapeSearch2Edge position EdgePositionEdge width EdgeWidthEdge pitch EdgePitchArea ColorAreaColor data ColorDataLabeling ColorLabeling

Me.CoreRA1.SetRunMode(2)'Add the search processing item.Dim ret As Integer = Me.CoreRA1.AssignMeasureItem("Search")Me.CoreRA1.SetRunMode(1)


42

Related Items

CopyMeasureItem (Reference: Details (p.53)) DeleteMeasureItem (Reference: Details (p.56))

GetRunMode (Reference: Details (p.82)) MeasureItemCount (Reference: Details (p.95))

SetRunMode (Reference: Details (p.156))


8-5-2 AssignPositionItem

Adds an image adjustment item.

FormatFunction AssignPositionItem(ByVal itemident As String) As Integer

Parameter


DescriptionAdd an image adjustment item with identifier specified in the <itemIdent> parameter to the end ofthe measurement flow for image adjustment items. You can add up to 8 image adjustment items.

The image adjustment item identifiers are shown below.


ExampleAdd a position compensation processing item to the end of the measurement flow for image


<itemIdent> String Identifier of the image adjustment item to be added as an inspection item

Image adjustment item Image adjustment item identifierColor gray filter FilterColorGrayWeak smoothing WeakSmoothingStrong smoothing StrongSmoothingDilate DilateErosion ErosionMedian MedianExtract edges ExtractEdgesExtract horizontal edges ExtractHorizontalEdgesExtract vertical edges ExtractVerticalEdgesEnhance edges EnhanceEdgesBackground suppression FilterHighContrastShape search position compensation ShapeMdlScrollSearch position compensation ModelScrollEdge position compensation EdgePosScrlTwo-edge position compensation 2EdgePosScrlTwo-edge midpoint compensation 2EdgeMidPosScrlEdge rotation position compensation EdgeRotPosScrlPosition compensation Scroll


44

adjustment items.


Related Items

Me.CoreRA1.SetRunMode(2)'Add the position compensation processing item.Dim ret As Integer = Me.CoreRA1.AssignPositionItem("Scroll")Me.CoreRA1.SetRunMode(1)

CopyPositionItem (Reference: Details (p.54)) DeletePositionItem (Reference: Details (p.57))

GetRunMode (Reference: Details (p.82)) PositionItemCount (Reference: Details (p.107))



8-5-3 CalculationData

Gets numerical data of a calculation.

FormatFunction CalculationData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns the calculation data as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets numerical data of a calculation.

Usage Cautions･ None.

ExampleGets numerical data of a calculation.


Related Items


<dataNo> IntegerExternal reference data number of the calculation (Reference: 8-6External Reference Parameters (p.163))

'Get external reference data No. 0 (judgement) of the calculation.Dim data As Double = Me.CoreRA1.CalculationData(0)

CalculationData2 (Reference: Details (p.46)) GetCalculationData (Reference: Details (p.61))

SetCalculationData (Reference: Details (p.82))


46

8-5-4 CalculationData2

Gets character string data of a calculation.

FormatFunction CalculationData2(ByVal dataNo As Integer, ByVal type As Integer) AsString

Parameter

Return valueReturns character string calculation data.Returns null if an error occurs.

DescriptionGets character string data of a calculation.


ExampleGets character string data of a calculation.


Related Items



<type> Integer Type of character string (0: char, 1: TCHAR)

'Get external reference data No. 150 (expression 0) of the calculation.Dim data As String = Me.CoreRA1.CalculationData2(150, 0)

CalculationData (Reference: Details (p.45)) GetCalculationData (Reference: Details (p.61))

SetCalculationData (Reference: Details (p.82))


8-5-5 CameraData

Gets numerical data of a camera parameter.

FormatFunction CameraData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns a camera parameter as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets numerical data of a camera parameter.For the camera parameter numbers, refer to "Camera parameter numbers" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).


ExampleGets the data of camera parameter No. 1 (shutter speed).


Related Items


<dataNo> Integer Camera parameter number

Dim data As Double = Me.CoreRA1.CameraData(1)

GetCameraData (Reference: Details (p.63)) SetCameraData (Reference: Details (p.134))


48

8-5-6 ChangeScene

Changes a scene.

FormatFunction ChangeScene(ByVal sceneNo As Integer) As Integer

Parameter


DescriptionChanges the current scene to the scene with the scene number specified in the <sceneNo>parameter.


ExampleChange the current scene to scene No. 2.


Related Items


<sceneNo> Integer Scene number of destination scene (0 to 31)

Dim ret As Integer = Me.CoreRA1.ChangeScene(2)

GetRunMode (Reference: Details (p.82)) SceneCount (Reference: Details (p.128))SceneNo (Reference: Details (p.129)) SetRunMode (Reference: Details (p.156))


8-5-7 ClearError

Clears an error.

FormatFunction ClearError() As Integer

Parameter

　None


DescriptionClears an error.


ExampleClears an error.


Related Items

Dim ret As Integer = Me.CoreRA1.ClearError()

GetErrorCode (Reference: Details (p.65))


50

8-5-8 ClearMeasureData

Clears the measurement results of a processing item.

FormatFunction ClearMeasureData() As Integer

ParameterNone.


DescriptionClears all measurement results of a processing item.


ExampleClears all measurement results of a processing item.


Related Items　None

'Clear the measurement results.Dim ret As Integer = Me.CoreRA1.ClearMeasureData()


8-5-9 ClearScene

Clears scene data.

FormatFunction ClearScene(ByVal sceneNo As Integer) As Integer

Parameter


DescriptionClears the setting information in the scene with the scene number specified in the <sceneNo>parameter, and restores the scene to the factory default state.


ExampleClear the scene data of scene No. 2.


Related Items


<sceneNo> Integer Scene number of scene to be cleared (0 to 31)

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.ClearScene(2)Me.CoreRA1.SetRunMode(1)



52

8-5-10 ClearTotalData

Clears statistical data.

FormatFunction ClearTotalData() As Integer

ParameterNone


DescriptionClears statistical data.


ExampleClears statistical data.


Related Items

Dim ret As Integer = Me.CoreRA1.ClearTotalData()

ClearScene (Reference: Details (p.51)) GetRunMode (Reference: Details (p.82))GetTotalData (Reference: Details (p.84)) SetRunMode (Reference: Details (p.156))


8-5-11 CopyMeasureItem

Copies an inspection item.

FormatFunction CopyMeasureItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionCopies the inspection item specified in the <itemNo> parameter to the end of the inspectionprocessing item block.


Example

Copies the specified inspection item to the end of the inspection processing item block.


Related Items


<itemNo> Integer Item number (0 to 30) of the inspection item to be copied.

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.CopyMeasureItem(2)Me.CoreRA1.SetRunMode(1)

AssignMeasureItem (Reference: Details (p.41))

DeleteMeasureItem (Reference: Details (p.56))

GetRunMode (Reference: Details (p.82))

MeasureItemCount (Reference: Details (p.95))



54

8-5-12 CopyPositionItem

Copies an image adjustment item.

FormatFunction CopyPositionItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionCopies the image adjustment item specified in the <itemNo> parameter to the end of theinspection processing item block.


Example

Copies the image adjustment item to the end of the image adjustment item block.


Related Items


<itemNo> Integer Item number (0 to 6) of the image adjustment item to be copied.

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.CopyPositionItem(2)Me.CoreRA1.SetRunMode(1)

AssignPositionItem (Reference: Details (p.43))

DeletePositionItem (Reference: Details (p.57))




8-5-13 CopyScene

Copies scene data.

FormatFunction CopyScene(ByVal srcSceneNo As Integer, ByVal destSceneNo AsInteger) As Integer

Parameter


DescriptionCopies the scene data with the scene number specified in the <srcSceneNo> parameter to thescene data with the scene number specified in the <destSceneNo> parameter.


ExampleCopy the data of scene 2 to scene 3.


Related Items


<srcSceneNo> Integer Scene number (0 to 31) of the scene to be copied.<destSceneNo> Integer Scene number (0 to 31) of destination scene.

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.CopyScene(2, 3)Me.CoreRA1.SetRunMode(1)



56

8-5-14 DeleteMeasureItem

Deletes an inspection item.

FormatFunction DeleteMeasureItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionDeletes the inspection item specified in the <itemNo> parameter.


ExampleDeletes the processing item of inspection item No. 2.


Related Items


<itemNo> Integer Item number (0 to 31) of the inspection item

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.DeleteMeasureItem(2)Me.CoreRA1.SetRunMode(1)

AssignMeasureItem (Reference: Details (p.41))

CopyMeasureItem (Reference: Details (p.53))

GetRunMode (Reference: Details (p.82)) MeasureItemCount (Reference: Details (p.95))



8-5-15 DeletePositionItem

Deletes an image adjustment item.

FormatFunction DeletePositionItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionDeletes the image adjustment item specified in the <itemNo> parameter.


ExampleDelete image adjustment item No. 2.


Related Items


<itemNo> Integer Item number (0 to 7) of the image adjustment item.

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.DeletePositionItem(2)Me.CoreRA1.SetRunMode(1)

AssignPositionItem (Reference: Details (p.43))

CopyPositionItem (Reference: Details (p.54))




58

8-5-16 GetAll

Gets the input statuses of all input terminals.

FormatFunction GetAll(ByVal ioIdent As String) As Integer

Parameter

Return valueThe input status of each input terminal is expressed as an integer value (OFF (0) or ON (1)) ineach digit of a character string in binary notation.

Example: DI0 and DI2 are ON Binary notation: 0000 0101 Value of input statuses that can be acquired: 5

　　IN0, 0x0001 　　IN1, 0x0002 　　IN2, 0x0004 　　IN3, 0x0008 　　IN4, 0x0010 　　TRIG, 0x0020 　　IN5, 0x0040 　　IN6, 0x0080 　　IN7, 0x0100 　　RESET, 0x0800　　DSA, 0x2000 　　Returns -1 if an error occurs.

DescriptionGets the input statuses of all input terminals of the communication module specified in the<ioIdent> parameter.Specify "ParallelIo" in the <ioIdent> parameter.

　　For the FQ2 sensor standard parallel interface, the statuses of the TRIG and IN0 to IN5terminals can be acquired. For the Parallel Interface Sensor Data Unit, the statuses of the TRIG,DSA, IN0 to IN7, and RESET terminals can be acquired. For the RS-232C Interface Sensor Data Unit,the statuses of the TRIG, IN0 to IN5, and RESET terminals can be acquired.

Usage Cautions･ This command is valid only in setup mode (IO monitor mode only).

ExampleGets the input statuses of the DI signals in parallel I/O.


<ioIdent> String Identifier of the communication module to be used (always "ParallelIo")



Related Items

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"'Get the input statuses.Dim state As Integer = Me.CoreRA1.GetAll(ioModule)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

GetPort (Reference: Details (p.76)) PutAll (Reference: Details (p.112))PutPort (Reference: Details (p.114)) SetMeasureOut (Reference: Details (p.143))SetParallelJudgeData (Reference: Details (p.148))


60

8-5-17 GetApplicationVersion

Gets the software version of the sensor.

FormatFunction GetApplicationVersion(ByVal kind As Integer) As String

Parameter

Return valueGets the software version as a character string value.Returns null if an error occurs.

DescriptionGets the software version of the sensor.


Example　 Gets the sensor model.


Related ItemsNone


<kind> Integer

Type of version to be acquired0: Sensor model1. Software version (without date)2. Software version (with date)　

Dim Version As String = Me.CoreRA1.GetApplicationVersion(0)


8-5-18 GetCalculationData

Gets calculation data.

FormatFunction GetCalculationData(ByVal dataNo As Integer, ByRef data As Integer) AsIntegerFunction GetCalculationData(ByVal dataNo As Integer, ByRef data As Double) AsIntegerFunction GetCalculationData(ByVal dataNo As Integer, ByRef data As String, ByValstring_type As Integer) As Integer

Parameter

Return value　Error code (0: Normal, -1: Error)

DescriptionGets calculation data.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 55 (judgement 0) of the calculation.

Get external reference data No. 5 (data 0) of the calculation.

Get external reference data No. 150 (expression 0) of the calculation.



<data>IntegerDoubleString

Data acquired

<string_type> Integer Specifies the character string type when the data to be acquired is a characterstring. (0: char, 1: TCHAR)

Dim data As Integer'Change the variable data type to signed integer because the judgement data value is an integer.Dim ret As Integer = Me.CoreRA1.GetCalculationData(55, data)

Dim data As Double'Change the variable data type to double precision floating point decimal because the judgement value is areal number.Dim ret As Integer = Me.CoreRA1.GetCalculationData(5, data)

Dim data As String'Change the variable data type to string because the expression 0 value is a character string.Dim ret As Integer = Me.CoreRA1.GetCalculationData(150, data,0)


62


Related Items

CalculationData (Reference: Details (p.45)) CalculationData2 (Reference: Details (p.46))SetCalculationData (Reference: Details (p.82))


8-5-19 GetCameraData

Gets the data of a camera parameter.

FormatFunction GetCameraData(ByVal dataNo As Integer, ByRef data As Integer) AsIntegerFunction GetCameraData(ByVal dataNo As Integer, ByRef data As Double) AsInteger

Parameter


DescriptionGets the data of a camera parameter.For the camera parameter numbers, refer to "Camera parameter numbers" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).Set the same data type for the <data> parameter as the data to be acquired.


ExampleGets the data of camera parameter No. 1 (shutter speed).

Get the data of camera parameter No. 10 (white balance R scaling).


Related Items



<data> IntegerDouble Data acquired

Me.CoreRA1.SetRunMode(2)Dim data As Integer'Change the variable data type to signed integer because the shutter speed value is an integer.Dim ret As Integer = Me.CoreRA1.GetCameraData(1, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double'Change the variable data type to double precision floating point decimal because the white balance Rscaling data value is a real number.Dim ret As Integer = Me.CoreRA1.GetCameraData(10, data)Me.CoreRA1.SetRunMode(1)


64

SetCameraData (Reference: Details (p.134))


8-5-20 GetErrorCode

Gets the most recent error code of the sensor.

FormatFunction GetErrorCode() As Integer

Parameter　None.

Return value　Most recent error code　Returns -1 if an error occurs.

DescriptionGets the most recent error code of the sensor.For recent error code, refer to "8-1 Error Histories" in FQ2-S/CH Series User's Manual (Cat. No.Z337).


ExampleGets the most recent error code of the sensor.


Related Items

Dim ret As Integer = Me.CoreRA1.GetErrorCode()

ClearError (Reference: Details (p.49))


66

8-5-21 GetLinkOutputData

Gets data output by link data / Fieldbus data communication.

FormatFunction GetLinkOutputData(ByVal dataNo As Integer, ByRef data As Integer) AsIntegerFunction GetLinkOutputData(ByVal dataNo As Integer, ByRef data As String, ByValstring_type As Integer) As Integer

Parameter


DescriptionGets data output by link data / Fieldbus data communication.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 307 (output form) of link data output / Fieldbus data output.

Get external reference data No. 120 (output data 0) of link data output / Fieldbus data output.　


Related Items


<dataNo> IntegerData number of external reference data of link data output / Fieldbusdata output (Reference: 8-6 External Reference Parameters (p.163))

<data> IntegerString Data acquired


Me.CoreRA1.SetRunMode(2)Dim data As Integer'Change the variable data type to signed integer because the output data type is integer.Dim ret As Integer = Me.CoreRA1.GetLinkOutputData(307, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As String'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.GetLinkOutputData(120, data,0)Me.CoreRA1.SetRunMode(1)


LinkOutputData (Reference: Details (p.88)) LinkOutputData2 (Reference: Details (p.89))


68

8-5-22 GetMeasureItemData

Gets the data of an inspection item.

FormatFunction GetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByRef data As Integer) As IntegerFunction GetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByRef data As Double) As IntegerFunction GetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByRef data As String, ByVal string_type As Integer) As Integer

Parameter


DescriptionGets the data of an inspection item.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 5 (correlation) of inspection item No. 1 (search).

Get external reference data No. 6 (position X) of inspection item No. 1 (search).

Get external reference data No. 7 (decode character string) of inspection item No. 2 (2D code).　


<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item


Data acquired


Me.CoreRA1.SetRunMode(2)Dim data As Integer'Change the variable data type to integer because the correlation data value is an integer.Dim ret As Integer = Me.CoreRA1.GetMeasureItemData(1, 5, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double'Change the variable data type to double precision floating point decimal because the position X data valueis a real number.Dim ret As Integer = Me.CoreRA1.GetMeasureItemData(1, 6, data)Me.CoreRA1.SetRunMode(1)



Related Items

Me.CoreRA1.SetRunMode(2)Dim data As String'Change the variable data type to string because the decode character string value is a character string.Dim ret As Integer = Me.CoreRA1.GetMeasureItemData(2, 7, data, 0)Me.CoreRA1.SetRunMode(1)

GetMeasureItemFigure (Reference: Details (p.70))

SetMeasureItemData (Reference: Details (p.138))

SetMeasureItemFigure (Reference: Details (p.140))

MeasureItemData (Reference: Details (p.96))

MeasureItemData2 (Reference: Details (p.97))


70

8-5-23 GetMeasureItemFigure

Gets the figure data of an inspection item.

FormatFunction GetMeasureItemFigure(ByVal itemNo As Integer, ByVal figureNo AsInteger, ByRef figure As Integer()) As Integer

Parameter


DescriptionGets the figure data of an inspection item.For region numbers and figure data, refer to "SETITEMFIGPARAM or SIFP" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).


ExampleGet figure data No. 1 (region figure) of inspection item No. 1 (search).


Related Items


<itemNo> Integer Item number (0 to 31) of the inspection item<figureNo> Integer Region number (0 to 7)<figure> Integer() Figure data to be acquired

Me.CoreRA1.SetRunMode(2)Dim figure(5) As IntegerDim ret As Integer = Me.CoreRA1.GetMeasureItemFigure(1, 1, figure)

GetMeasureItemData (Reference: Details (p.68))


SetMeasureItemFigure (Reference: Details (p.140))




8-5-24 GetMeasureOut

Gets the setting for output of measurement results to an external device.

FormatFunction GetMeasureOut() As Integer

ParameterNone.

Return value　Output yes/no (0: No, 1: Yes)　Returns -1 if an error occurs.

DescriptionGets the setting for output of measurement results to an external device.


ExampleGets the setting for output of measurement results to an external device.


Related Items

Dim meaureOut As Integer = Me.CoreRA1.GetMeasureOut()

SetMeasureOut (Reference: Details (p.143))


72

8-5-25 GetNoprotocolOutputData

Gets data that is output by no protocol data communication.

FormatFunction GetNoprotocolOutputData(ByVal dataNo As Integer, ByRef data AsInteger) As IntegerFunction GetNoprotocolOutputData(ByVal dataNo As Integer, ByRef data AsString, ByVal string_type As Integer) As Integer

Parameter


DescriptionGets data that is output by no protocol data communication.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 300 (data format) of no protocol data output.

Get external reference data No. 120 (output data 0) of no protocol data output.　


Related Items


<dataNo> IntegerExternal reference data number of no protocol data output (Reference:8-6 External Reference Parameters (p.163))



Dim data As Integer'Change the variable data type to signed integer because the data type is integer.Dim ret As Integer = Me.CoreRA1.GetNoprotocolOutputData(300, data)

Dim data As String'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.GetNoprotocolOutputData(120, data,0)

SetNoprotocolOutputData (Reference: Details (p.144))


8-5-26 GetParallelData

Gets data output by parallel data communication.

FormatFunction GetParallelData(ByVal dataNo As Integer, ByRef data As Integer) AsIntegerFunction GetParallelData(ByVal dataNo As Integer, ByRef data As String, ByValstring_type As Integer) As Integer

Parameter


DescriptionGets data output by parallel data communication.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 300 (data format) of parallel data output.

Get external reference data No. 150 (output data 0) of the parallel data output.　


Related Items


<dataNo> IntegerExternal reference data number of parallel data output (Reference: 8-6 External Reference Parameters (p.163))



Dim data As Integer'Change the variable data type to signed integer because the output data type is integer.Dim ret As Integer = Me.CoreRA1.GetParallelData(300, data)

Dim data As String'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.GetParallelData(150, data,0)

ParallelData (Reference: Details (p.103)) ParallelData2 (Reference: Details (p.104))SetParallelData (Reference: Details (p.146))


74

8-5-27 GetParallelJudgeData

Gets data output by parallel judgement output.

FormatFunction GetParallelJudgeData(ByVal dataNo As Integer, ByRef data As Integer)As IntegerFunction GetParallelJudgeData(ByVal dataNo As Integer, ByRef data As Double)As IntegerFunction GetParallelJudgeData(ByVal dataNo As Integer, ByRef data As String,ByVal string_type As Integer) As Integer

Parameter


DescriptionGets data output by parallel judgement output.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 103 (reflect) of parallel judgement output.

Get external reference data No. 300 (judgement upper limit) of the parallel judgement output.

Get external reference data No. 150 (output data 0) of parallel judgement output.　


<dataNo> IntegerExternal reference data number of parallel judgement output(Reference: 8-6 External Reference Parameters (p.163))


Data acquired


Dim data As Integer'Change the variable data type to signed integer because the reflect value is an integer.Dim ret As Integer = Me.CoreRA1.GetParallelJudgeData(103, data)

Dim data As Double'Change the variable data type to double precision floating point decimal because the judgement upper limitvalue is a real number.Dim ret As Integer = Me.CoreRA1.GetParallelJudgeData(300, data)

Dim data As String'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.GetParallelData(150, data,0)



Related Items

ParallelJudgeData (Reference: Details (p.105))

ParallelJudgeData2 (Reference: Details (p.106))

SetParallelJudgeData (Reference: Details (p.148))


76

8-5-28 GetPort

Gets the input status of a specified input terminal.

FormatFunction GetPort(ByVal ioIdent As String, ByVal portKind As Integer, ByVal portNoAs Integer) As Integer

Parameter

Return valueReturns the input status of the input terminal as an integer value.0: Input OFF state1: Input ON state

　-1: Error

DescriptionGets the status of the input terminal, specified in the <portKind> parameter and <portNo>parameter, of the communication module specified in the <ioIdent> parameter.Normally "ParallelIo" should be specified in the <ioIdent> parameter.


ExampleGet the input status of DI5 of parallel I/O.



<portkind> Integer

Terminal type of input terminal whose input status is to be acquired.0: TRIG1: DSA (only when the sensor is connected to the Sensor Data Unit)2: DI 13: RESET

<portNo> Integer

Terminal number of input terminal whose input status is to be acquired.Terminal type is DI and only when the sensor is connected to the FQ-SDU1Sensor Data Unit

0 to 7 : (IN0 to 7)Terminal type is DI and when the sensor is connected to the FQ-SDU2 SensorData Unit 0 to 5 : (IN0 to 5)Terminal type is other than DI

0 only



Related Items

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"'Get the input status.Dim state As Integer = Me.CoreRA1.GetPort(ioModule, 2, 5)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

GetAll (Reference: Details (p.58)) PutAll (Reference: Details (p.112))PutPort (Reference: Details (p.114)) RunOut (Reference: Details (p.120))SetMeasureOut (Reference: Details (p.143))

SetParalleJudgeData (Reference: Details (p.148))


78

8-5-29 GetPositionItemData

Gets the data of an image adjustment item.

FormatFunction GetPositionItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByRef data As Integer) As IntegerFunction GetPositionItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByRef data As Double) As Integer

Parameter


DescriptionGets the data of an image adjustment item.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 120 (source image) of image adjustment inspection item No. 1(color gray filter).

Get external reference data No. 125 (RGB gain R) of inspection item No. 1 (color gray filter).


Related Items


<itemNo> Integer Item number (0 to 7) of the image adjustment item.<dataNo> Integer External reference data number of the image adjustment item


Dim data As Integer'Change the variable data type to signed integer because the source image data value is an integer.Dim ret As Integer = Me.CoreRA1.GetPositionItemData(1, 120, data)

Dim data As Double'Change the variable data type to double precision floating point decimal because the RGB gain R value isa real number.Dim ret As Integer = Me.CoreRA1.GetMeasureItemData(1, 125, data)

GetPositionItemFigure (Reference: Details (p.79))

PositionItemData (Reference: Details (p.108))

SetPositionItemData (Reference: Details (p.150))


8-5-30 GetPositionItemFigure

Gets the figure data of an image adjustment item.

FormatFunction GetPositionItemFigure(ByVal itemNo As Integer, ByVal figureNo AsInteger, ByRef figure As Integer()) As Integer

Parameter


DescriptionGets the figure data of an image adjustment item.For region numbers and figure data, refer to "SETITEMFIGPARAM or SIFP" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).


ExampleGet figure data No. 0 (region figure) of image adjustment item No. 1 (extract edges).


Related Items


<itemNo> Integer Item number (0 to 7) of the image adjustment item.<figureNo> Integer Region number (0 to 7)<figure> Integer() Figure data to be acquired

Dim figure(5) As IntegerDim ret As Integer = Me.CoreRA1.GetPositionItemFigure(1, 0, figure)

GetPositionItemData (Reference: Details (p.78))

SetPositionItemFigure (Reference: Details (p.152))


80

8-5-31 GetRetryData

Gets retry data.

FormatFunction GetRetryData(ByVal dataNo As Integer, ByRef data As Integer) AsIntegerFunction GetRetryData(ByVal dataNo As Integer, ByRef data As Double) AsInteger

Parameter


DescriptionGets retry data.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 121 (max count) of the retry.

Get external reference data No. 123 (shutter speed step) of the retry.



<dataNo> IntegerExternal reference data number of the retry (Reference: 8-6 ExternalReference Parameters (p.163))


Me.CoreRA1.SetRunMode(2)Dim data As Integer'Change the variable data type to signed integer because the max count value is an integer.Dim ret As Integer = Me.CoreRA1.GetRetryData(121, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double'Change the variable data type to double precision floating point decimal because the shutter speed stepvalue is a real number.Dim ret As Integer = Me.CoreRA1.GetRetryData(123, data)Me.CoreRA1.SetRunMode(1)


Related Items

RetryData (Reference: Details (p.119)) SetRetryData (Reference: Details (p.155))


82

8-5-32 GetRunMode

Gets the execution status (execution mode) of the FQ2 sensor.

FormatFunction GetRunMode() As Integer

ParameterNone.

Return valueReturns the execution mode.

Execution mode 1: Run mode 2: Setup mode

　Returns -1 if an error occurs.

DescriptionGets the execution status (execution mode) of the FQ2 sensor.


Example　 Gets the execution mode.


Related Items

Dim runMode As Integer = Me.CoreRA1.GetRunMode()


Measure (Reference: Details (p.94))




8-5-33 GetSystemData

Gets system data.

FormatFunction GetSystemData(ByVal dataIdent0 As String, ByVal dataIdent1 As String,ByRef data As Integer) As Integer

Parameter


DescriptionGet the system data of identification information 1 specified in the <dataIdent1> parameter,which belongs to identification information 0 specified in the <dataIdent0> parameter.For system data identification information, refer to the system data list. (Reference: SystemData List (p. 28))


ExampleGet the value set for the startup scene number whose identification information 1 is"initialSceneNo" and which belongs to identification information 0 of "Configuration", and switchthe scene used to the startup scene.


Related Items


<dataIdent0> String Data identifier of identification information 0 of system data to be acquired<dataIdent1> String Data identifier of identification information 1 of system data to be acquired<data> Integer Value of acquired system data

'Get the set value for the startup scene number that belongs to Configuration.Dim sceneNo As IntegerDim ret As Integer = Me.CoreRA1.GetSystemData("Configuration", "initialSceneNo", sceneNo)'Change the scene.ret = Me.CoreRA1.ChangeScene(sceneNo)

SetSystemData (Reference: Details (p.159))


84

8-5-34 GetTotalData

Gets statistical data.

FormatFunction GetTotalData(ByVal kind As Integer) As Double

Parameter

Return valueReturns the specified type of statistical data as a double precision floating point decimal value.Returns -1 if an error occurs.

Description　Gets statistical data.


ExampleGet statistical data (number of measurements).


Related Items


<kind> Integer

Specifies the type of statistical data to be acquired.1: Number of measurements2: Number of NGs3: NG rate4: Number of OKs5: OK rate

Dim MeaCount As Double = Me.CoreRA1.GetTotalData(1)

ClearTotalData (Reference: Details (p.52))


8-5-35 ImageUpdate

Updates the image input from the camera.

FormatFunction ImageUpdate() As Integer

ParameterNone.


DescriptionUpdates the image input from the camera to the most recent image.

Usage Cautions･ This command is valid only when the image mode is "Camera Image Freeze". When the imagemode is "Camera Image Live", the image input from the camera is continuously updated.

ExampleUpdate an image displayed in "Camera Image Freeze" image mode to the most recent image.


Related Items

'Update the frozen image to the most recent image.Dim ret As Integer = Me.CoreRA1.ImageUpdate()

RefreshImageWindow (Reference: Details (p.116))


86

8-5-36 IOMonitorStart

Starts the IO monitor.

FormatFunction IOMonitorStart() As Integer

ParameterNone.


DescriptionStarts the IO monitor.To use an IO module command, you must first execute the IOMonitorStart command.When the action of the IO module command is finished, execute the IOMonitorStop command.

　




Related Items

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"Dim state As Integer = Me.CoreRA1.GetAll(ioModule)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

IOMonitorStop (Reference: Details (p.87))


8-5-37 IOMonitorStop

Stops the IO monitor.

FormatFunction IOMonitorStop() As Integer

ParameterNone.


DescriptionStops the IO monitor.To use an IO module command, you must first execute the IOMonitorStart command.When the action of the IO module command is finished, execute the IOMonitorStop command.




Related Items

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"Dim state As Integer = Me.CoreRA1.GetAll(ioModule)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

IOMonitorStart (Reference: Details (p.86))


88

8-5-38 LinkOutputData

Gets numerical data output by link data / Fieldbus data communication.

FormatFunction LinkOutputData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns the data as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data specified in the <dataNo> parameter.


ExampleGet external reference data No. 307 (output format) of the link data output / Fieldbus dataoutput.


Related Items


<dataNo> IntegerData numbers of the link data output/Fieldbus data output (Reference:8-6 External Reference Parameters (p.163))

Dim data As Double = Me.CoreRA1.LinkOutputData(307)

GetLinkOutputData (Reference: Details (p.66))

LinkOutputData2 (Reference: Details (p.89))


8-5-39 LinkOutputData2

Gets character string data output by link data / Fieldbus data communication.

FormatFunction LinkOutputData2(ByVal dataNo As Integer, ByVal string_type As Integer)As String

Parameter

Return valueReturns character string data.Returns null if an error occurs.

DescriptionGets the character string data specified in the <dataNo> parameter.


ExampleGet external reference data No. 120 (output data) of the link data output / Fieldbus data output.


Related Items


<dataNo> IntegerData numbers of the link data output/Fieldbus data output (Reference:8-6 External Reference Parameters (p.163))


Dim data As String = Me.CoreRA1.LinkOutputData2(120, 0)

GetLinkOutputData (Reference: Details(p.66))

LinkOutputData (Reference: Details (p.88))


90

8-5-40 LoadBackupData

Loads all setting data (all scene data, system data, and calibration group data).

FormatFunction LoadBackupData(ByVal fileName As String) As Integer

Parameter


DescriptionLoads the file containing all setting data (all scene data, system data, and calibration groupdata) that is specified in the <fileName> parameter.Specify the file name by absolute path in the <fileName> parameter.


ExampleLoad all setting data (all scene data, system data, and calibration group data) and then save thedata to the sensor. To enable the loaded settings, restart the sensor.


Related Items


<fileName> String File name of all sensor setting data (system + all scene data) to be loaded(*.bkd)

Me.CoreRA1.SetRunMode(2)'Loads the file of all setting data (all scene data, system data, and calibration group data).Dim ret As Integer = Me.CoreRA1.LoadBackupData("C:\BACKDIR\BackupData.bkd")'Save the data to the sensor.ret = Me.CoreRA1.SaveData()Reboot the sensor.ret = Me.CoreRA1.SystemReset()Me.CoreRA1.SetRunMode(1)

GetSystemData (Reference: Details (p.83)) LoadScene (Reference: Details (p.91))LoadSceneGroup (Reference: Details (p.92)) LoadSystemData (Reference: Details (p.93))SaveBackupData (Reference: Details (p.121))

SaveData (Reference: Details (p.122))

SystemReset (Reference: Details (p.160))


8-5-41 LoadScene

Loads scene data.

FormatFunction LoadScene(ByVal sceneNo As Integer, ByVal fileName As String) AsInteger

Parameter


DescriptionLoads the scene data file specified in the <fileName> parameter into the scene number specifiedin the <sceneNo> parameter.Specify the file name by absolute path in the <fileName> parameter.


ExampleLoad scene data into scene 2 and then change the scene to scene 2.


Related Items


<sceneNo> Integer Scene number to be loaded (0 to 31)<fileName> String File name of the scene data to be loaded (*.scn)

Me.CoreRA1.SetRunMode(2)'Load the scene data file.Dim ret As Integer = Me.CoreRA1.LoadScene(2, "C:\BACKDIR\scene02.scn")'Change the scene.ret = Me.CoreRA1.ChangeScene(2)Me.CoreRA1.SetRunMode(1)

ChangeScene (Reference: Details (p.48)) LoadBackupData (Reference: Details (p.90))LoadSceneGroup (Reference: Details (p.92)) LoadSystemData (Reference: Details (p.93))SaveScene (Reference: Details (p.125)) SceneNo (Reference: Details (p.129))


92

8-5-42 LoadSceneGroup

Loads scene group data.

FormatFunction LoadSceneGroup(ByVal fileName As String) As Integer

Parameter


DescriptionLoads the scene group data file specified in the <fileName> parameter.Specify the file name by absolute path in the <fileName> parameter.


ExampleLoad the scene group data and then change the scene used to scene 0.


Related Items


<fileName> String File name of the scene group data to be loaded (*.sgp)

Me.CoreRA1.SetRunMode(2)'Load the file of the scene group data.Dim ret As Integer = Me.CoreRA1.LoadSceneGroup("C:\BACKDIR\scenegroup.sgp")'Change the scene.ret = Me.CoreRA1.ChangeScene(0)Me.CoreRA1.SetRunMode(1)

ChangeScene (Reference: Details (p.48)) LoadBackupData (Reference: Details (p.90))LoadScene (Reference: Details (p.91)) LoadSystemData (Reference: Details (p.93))SaveSceneGroup (Reference: Details (p.126))


8-5-43 LoadSystemData

Loads system data.

FormatFunction LoadSystemData(ByVal fileName As String) As Integer

Parameter


DescriptionLoads the system data file specified in the <fileName> parameter.Specify the file name by absolute path in the <fileName> parameter.


ExampleLoad system data and then execute "Save data". Restart the sensor to apply the loaded settings.


Related Items


<fileName> String File name of the system data to be loaded (*.syd)

Me.CoreRA1.SetRunMode(2)'Load the system data fileDim ret As Integer = Me.CoreRA1.LoadSystemData("C:\BACKDIR\backupsysset.syd")'Save the data to the sensor.ret = Me.CoreRA1.SaveData()'Reboot the sensor.ret = Me.CoreRA1.SystemReset()Me.CoreRA1.SetRunMode(1)

LoadBackupData (Reference: Details (p.90)) LoadScene (Reference: Details (p.91))LoadSceneGroup (Reference: Details (p.92)) SaveData (Reference: Details (p.122))SaveSystemData (Reference: Details (p.127)) SystemReset (Reference: Details (p.160))


94

8-5-44 Measure

Executes measurement processing.

FormatFunction Measure() As Integer

Parameter　 None.


DescriptionExecutes measurement processing.


ExampleExecutes measurement processing.


Related Items

Dim ret As Integer = Me.CoreRA1.Measure()

GetRunMode (Reference: Details (p.82)) ReMeasure (Reference: Details (p.117))SetRunMode (Reference: Details (p.156))


8-5-45 MeasureItemCount

Gets the number of inspection items.

FormatFunction MeasureItemCount() As Integer

Parameter　 None.

Return valueReturns the number of inspection items as an integer value.Returns -1 if an error occurs.

DescriptionGets the number of inspection items.


ExampleGets the number of inspection items.


Related Items

Dim ret As Integer = Me.CoreRA1.MeasureItemCount()

MeasureItemIdent (Reference: Details (p.98)) PositionItemCount (Reference: Details (p.107))

PositionItemIdent (Reference: Details (p.109))


96

8-5-46 MeasureItemData

Gets the numerical data of an inspection item.

FormatFunction MeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer) AsDouble

Parameter

Return valueReturns the data of the inspection item as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data of the external reference data number specified in the <dataNo>parameter, which belongs the inspection item specified in the <itemNo> parameter.


ExampleGet external reference data No. 0 (judgement) of inspection item No. 0 (search).


Related Items


<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item to be acquired.

Dim data As Double = Me.CoreRA1.MeasureItemData(0, 0)




8-5-47 MeasureItemData2

Gets the character string data of an inspection item.

FormatFunction MeasureItemData2(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal string_type As Integer) As String

Parameter

Return valueReturns the character string data of the inspection item as a character string.Returns null if an error occurs.

DescriptionGets the character string data of the external reference data number specified in the <dataNo>parameter, which belongs to the inspection item specified in the <itemNo> parameter.


ExampleGet external reference data No. 127 (error string) of inspection item No. 2 (bar code).


Related Items


<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item to be acquired.


Dim data As String = Me.CoreRA1.MeasureItemData2(2, 127, 0)




98

8-5-48 MeasureItemIdent

Gets the identifier of a registered inspection item.

FormatFunction MeasureItemIdent(ByVal itemNo As Integer) As String

Parameter

Return valueReturns the identifier of the inspection item as a character string.Returns null if an error occurs.

DescriptionGets the identifier of the inspection item specified in the <itemNo> parameter.


ExampleGet the identifier of the inspection item registered in item 1.


Related Items



Dim ItemIdent As String = Me.CoreRA1.MeasureItemIdent(1)


MeasureItemTitle (Reference: Details (p.100))


8-5-49 MeasureItemJudge

Gets the judgement result of an inspection item.

FormatFunction MeasureItemJudge(ByVal itemNo As Integer) As Integer

Parameter

Return valueReturns the judgement result as an integer value.

-2: No judgement (unmeasured) 0: Judgement result OK-1: Judgement result NG-10: Judgement result error (image format mismatch)-11: Judgement result error (unregistered model)-12: Judgement result error (insufficient memory)-13: Teaching not performed error-14: Figure not registered error-15: Out of range error-16: Measurement timeout error-17: Format character string error-20: Judgement result error (other errors)

DescriptionGets the judgement result of the inspection item specified in the <itemNo> parameter.


ExampleGet the judgement result of inspection item No. 1.


Related Items

　None


<itemNo> Integer Item number (0 to 31) of the inspection item whose judgement result is to beacquired.

Dim judge As Integer = Me.CoreRA1.MeasureItemJudge(1)


100

8-5-50 MeasureItemTitle

Gets the title of an inspection item

FormatFunction MeasureItemTitle(ByVal itemNo As Integer) As String

Parameter

Return valueReturns the title of the inspection item as a character string.Returns null if an error occurs.

DescriptionGets the title of the inspection item specified in the <itemNo> parameter.The title can be acquired in the language specified in the language setting.


ExampleGet the title of inspection item No. 1 (search).


Related Items


<itemNo> Integer Inspection item number (0 to 31) of the inspection item whose title is to beacquired.

Me.CoreRA1.SetRunMode(2)Dim ItemIdent As String = Me.CoreRA1.MeasureItemTitle(1)Me.CoreRA1.SetRunMode(1)





8-5-51 NoprotocolOutputData

Gets numerical data output by no protocol data communication.

FormatFunction NoprotocolOutputData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns the data output by no protocol communication as a double precision floating pointdecimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data of the external reference number specified in the <dataNo> parameter,which is output by no protocol communication.


ExampleGet external reference data No. 300 (data format) of no protocol data output.


Related Items



Dim data As Double = Me.CoreRA1.NoprotocolOutputData(300)

GetNoprotocolOutputData (Reference: Details (p.72))

NoprotocolOutputData2 (Reference: Details (p.102))



102

8-5-52 NoprotocolOutputData2

Gets character string data output by no protocol communication.

FormatFunction NoprotocolOutputData2(ByVal dataNo As Integer, ByVal string_type AsInteger) As String

Parameter

Return valueReturns the character string data that is output by no protocol communication.Returns null if an error occurs.

DescriptionGets the character string data of the external reference data number specified in the <dataNo>parameter, which is output by no-protocol communication.


ExampleGet external reference data No. 120 (output data 0) of no protocol data output.


Related Items




Dim data As String = Me.CoreRA1.NoprotocolOutputData2(120, 0)


NoprotocolOutputData (Reference: Details (p.101))



8-5-53 ParallelData

Gets numerical data output by parallel data communication.

FormatFunction ParallelData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns the data output by parallel data communication as a double precision floating pointdecimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data, output by parallel output, of the external reference data numberspecified in the <dataNo> parameter.


ExampleGet external reference data No. 300 (data format) of parallel data output.


Related Items



Dim data As Double = Me.CoreRA1.ParallelData(300)

GetParallelData (Reference: Details (p.73)) ParallelData2 (Reference: Details (p.104))SetMeasureOut (Reference: Details (p.143))


104

8-5-54 ParallelData2

Gets character string data output by parallel data communication.

FormatFunction ParallelData2(ByVal dataNo As Integer, ByVal string_type As Integer) AsString

Parameter

Return valueReturns the character string data that is output by parallel data communication.Returns null if an error occurs.

DescriptionGets the character string data, output by parallel output, of the external reference data numberspecified in the <dataNo> parameter.


ExampleGet external reference data No. 150 (output data 0) of the parallel data output.


Related Items




Dim data As String = Me.CoreRA1.ParallelData2(150, 0)

GetParallelData (Reference: Details (p.73)) ParallelData (Reference: Details (p.103))SetMeasureOut (Reference: Details (p.143))


8-5-55 ParallelJudgeData

Gets numerical data output by parallel judgement output.

FormatFunction ParallelJudgeData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns the data output that is by parallel judgement output as a double precision floating pointdecimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data, output by parallel judgement output, of the external reference datanumber specified in the <dataNo> parameter.


ExampleGet external reference data No. 300 (judgement upper limit 0) of parallel judgement output.


Related Items


<dataNo> IntegerExternal reference data number of parallel judgement output (Reference: 8-6 External Reference Parameters (p.163))

Dim data As Double = Me.CoreRA1.ParallelJudgeData(300)

GetParallelJudgeData (Reference: Details (p.74))

ParallelJudgeData2 (Reference: Details (p.106))

SetMeasureOut (Reference: Details (p.143)) SetParallelJudgeData (Reference: Details (p.148))


106

8-5-56 ParallelJudgeData2

Gets character string data output by parallel judgement output.

FormatFunction ParallelJudgeData2(ByVal dataNo As Integer, ByVal string_type AsInteger) As String

Parameter

Return valueReturns the character string data that is output by parallel judgement output.Returns null if an error occurs.

DescriptionGets the character string data, output by parallel judgement output, of the external referencedata number specified in the <dataNo> parameter.


ExampleGet external reference data No. 150 (output data name 0) of parallel judgement output.


Related Items


<dataNo> IntegerExternal reference data number of parallel judgement output (Reference:8-6 External Reference Parameters (p.163))

<string_type> Integer Specifies the character string type when the data to be acquired is a characterstring. char, 1: TCHAR)

Dim data As String = Me.CoreRA1.ParallelJudgeData2(150, 0)





8-5-57 PositionItemCount

Gets the number of image adjustment items.

FormatFunction PositionItemCount() As Integer

Parameter　 None.

Return valueReturns the number of image adjustment items as a signed integer value.Returns -1 if an error occurs.

DescriptionGets the number of image adjustment items.


ExampleGets the number of inspection items.


Related Items

Dim ret As Integer = Me.CoreRA1.PositionItemCount()




108

8-5-58 PositionItemData

Gets the numerical data of an image adjustment item.

FormatFunction PositionItemData(ByVal itemNo As Integer, ByVal dataNo As Integer) AsDouble

Parameter

Return valueReturns the data of the image adjustment item as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets the numerical data of the external reference data number specified in the <dataNo>parameter, which belongs to the image adjustment item specified in the <itemNo> parameter.


ExampleGet external reference data No. 0 (judgement) of image adjustment item No. 0 (color gray filter).


Related Items


<itemNo> Integer Item number (0 to 7) of the image adjustment item<dataNo> Integer External reference data number of the image adjustment item to be acquired

Dim data As Double = Me.CoreRA1.PositionItemData(0, 0)



8-5-59 PositionItemIdent

Gets the identifier of a registered image adjustment item.

FormatFunction PositionItemIdent(ByVal itemNo As Integer) As String

Parameter

Return valueReturns the identifier of the image adjustment item as a character string.Returns null if an error occurs.

DescriptionGets the identifier of the image adjustment item specified in the <itemNo> parameter.


ExampleGet the identifier of the image adjustment item registered in item 1.


Related Items



Dim ItemIdent As String = Me.CoreRA1.PositionItemIdent(1)

PositionItemCount (Reference: Details (p.107))

PositionItemTitle (Reference: Details (p.111))


110

8-5-60 PositionItemJudge

Gets the judgement result of an image adjustment item.

FormatFunction PositionItemJudge(ByVal itemNo As Integer) As Integer

Parameter

Return valueReturns the judgement result as an integer value.

-2: No judgement (unmeasured) 0: Judgement result OK-1: Judgement result NG-10: Judgement result error (image format mismatch)-11: Judgement result error (unregistered model)-12: Judgement result error (insufficient memory)-13: Teaching not performed error-14: Figure not registered error-15: Out of range error-16: Measurement timeout error-17: Format character string error-20: Judgement result error (other errors)

DescriptionGets the judgement result of the image adjustment item specified in the <itemNo> parameter.


ExampleGet the judgement result of image adjustment item No. 1.


Related Items


<itemNo> Integer Item number (0 to 7) of an image adjustment item whose judgement result is tobe gotten

Dim judge As Integer = Me.CoreRA1.PositionItemJudge(1)



8-5-61 PositionItemTitle

Gets the title of an image adjustment item.

FormatFunction PositionItemTitle(ByVal itemNo As Integer) As String

Parameter

Return valueReturns the title of the image adjustment item as a character string.Returns null if an error occurs.

DescriptionGets the title of the inspection item specified in the <itemNo> parameter.The title can be acquired in the language specified in the language setting.


ExampleGet the title of image adjustment item No. 1.


Related Items


<itemNo> Integer Inspection item number (0 to 7) of image adjustment item whose title is to beacquired

Me.CoreRA1.SetRunMode(2)Dim ItemIdent As String = Me.CoreRA1.PositionItemTitle(1)Me.CoreRA1.SetRunMode(1)


SetPositionItemData (Reference: Details (p.150))


112

8-5-62 PutAll

Sets the output statuses of all output terminals.

FormatFunction PutAll(ByVal ioIdent As String, ByVal state As Integer) As Integer

Parameter


DescriptionSets the output status of all output terminals of the communication module specified in the<ioIdent> parameter to the state specified in the <state> parameter.Normally "ParallelIo" should be specified in the <ioIdent> parameter.The output statuses are set using an integer value expressed in binary with OFF (0) or ON (1) ineach binary digit for each output terminal.In parallel I/O, an integer value is returned wherein the statuses of DO0 to DO15 are expressedby the 1st digit to the 16th digit.Example: Set DO0 and DO4 to ON

Binary notation: 0000 0000 0001 0001Value of output statuses that are set: 17


ExampleSet all DO output statuses of parallel I/O to ON.



<state> Integer

Output status of terminalBIT0: DO0BIT1: DO1BIT2: DO2BIT3: DO3BIT4: DO4BIT5: DO5BIT6: DO6BIT7: DO7BIT8: DO8BIT9: DO9BIT10: DO10BIT11: DO11BIT12: DO12BIT13: DO13BIT14: DO14BIT15: DO15



Related Items

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"'Set the output statuses.Dim ret As Integer = Me.CoreRA1.PutAll(ioModule, 65535)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

GetAll (Reference: Details (p.58)) GetPort (Reference: Details (p.76))PutPort (Reference: Details (p.114)) SetParallelJudgeData

(Reference: Details (p.148))


114

8-5-63 PutPort

Sets the output status of a specified output terminal.

FormatFunction PutPort(ByVal ioIdent As String, ByVal portKind As Integer, ByVal portNoAs Integer, ByVal state As Integer) As Integer

Parameter


DescriptionSets the state of the output terminal of the terminal number specified in the <portKind>parameter and the <portNo> parameter of the communication module specified in the <ioIdent>parameter to the output status specified in the <state> parameter.


ExampleSet the DO3 output status of parallel I/O to ON.



<portKind> Integer

Terminal type of output terminal whose output status is to be set.3: RUN4: ERROR5: BUSY6: OR7: GATE9: DO0 to DO1510: STGOUT11: SHTOUT12: ACK

<portNo> Integer

Terminal number of output terminal whose output status is to be set.When the terminal type is DO0 to 15: DO0 to DO15･When the terminal type is other than DO 0 only

<state> IntegerOutput status of output terminal0: Output OFF1: Output ON

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"Set the output statuses.Dim ret As Integer = Me.CoreRA1.PutPort(ioModule, 9, 3, 1)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)



Related Items

GetAll (Reference: Details (p.58)) GetPort (Reference: Details (p.76))PutAll (Reference: Details (p.112))


116

8-5-64 RefreshImageWindow

Updates the image display window and text display window.

FormatFunction RefreshImageWindow() As Integer

ParameterNone.


DescriptionUpdates the image display window and the text display window.


ExampleUpdate an image displayed in "Camera Image Freeze" image mode to the most recent image. Applythe updated image to the image window and the text display window.


Related Items

'Update the frozen image to the most recent image.Dim ret As Integer = Me.CoreRA1.ImageUpdate()'Apply the updated image to the display in the image window.ret = Me.CoreRA1.RefreshImageWindow()

ImageUpdate (Reference: Details (p.85))


8-5-65 ReMeasure

Executes remeasurement.

FormatFunction ReMeasure(ByVal preImageNo As Integer) As IntegerFunction ReMeasure(ByVal imagefileName As String) As Integer

Parameter


DescriptionExecutes remeasurement for the image of the image logging number specified in the<preImageNo> parameter or the image of the image logging file name specified in the<imagefileName> parameter.In the <preImageNo> parameter, specify the image number of the logging image already loggedas a logging image in the sensor.If -1 is specified for the <preImageNo> parameter, remeasurement is executed using the mostrecent input image.If 0 is specified for the <preImageNo> parameter, remeasurement is executed using the mostrecent logged image of the sensor.Specify the <imagefileName> parameter by an absolute path.


ExampleExecute remeasurement using the image of image logging number 0.

Execute remeasurement using the image with the specified file name.



<preImageNo> Integer Image logging number (-1 to (number of images in the sensor already loggedminus one)) of image to be remeasured

<imagefileName> String Image file name of image to be remeasured

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.ReMeasure(0)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.ReMeasure("C:\BACKDIR\a.ifz")Me.CoreRA1.SetRunMode(1)


118

Related Items

GetRunMode (Reference: Details (p.82)) Measure (Reference: Details (p.94))SetRunMode (Reference: Details (p.156))


8-5-66 RetryData

Gets the numerical data of a retry.

FormatFunction RetryData(ByVal dataNo As Integer) As Double

Parameter

Return valueReturns retry data as a double precision floating point decimal value.Returns -1 if an error occurs.

DescriptionGets the retry numerical data specified in the <dataNo> parameter.


ExampleGet external reference data No. 121 (max count) of the retry data.


Related Items


<dataNo> IntegerExternal reference data number of the retry (Reference: 8-6 ExternalReference Parameters (p.163))

Dim data As Double = Me.CoreRA1.RetryData(121)

GetRetryData (Reference: Details (p.80)) SetRetryData (Reference: Details (p.155))


120

8-5-67 RunOut

Sets the output status of the RUN signal.

FormatFunction RunOut(ByVal ioIdent As String, ByVal state As Integer) As Integer

Parameter


DescriptionSets the RUN signal state of the communication module specified in the <ioIdent> parameter to the statespecified in the <state> parameter.

Usage Cautions･ This command is valid only in setup mode (IO monitor mode only).･ This command requires the Parallel Interface Sensor Data Unit.

ExampleSet the RUN signal of parallel I/O to ON.


Related Items


<ioIdent> String Identifier of the communication module to be used ("ParallelIo")

<state> IntegerOutput status of terminal0: Output OFF1: Output ON

Me.CoreRA1.SetRunMode(2)Me.CoreRA1.IOMonitorStart()Dim ioModule As String = "ParallelIo"Set the output statuses.Dim ret As Integer = Me.CoreRA1.RunOut(ioModule, 1)Me.CoreRA1.IOMonitorStop()Me.CoreRA1.SetRunMode(1)

GetAll (Reference: Details (p.58)) GetPort (Reference: Details (p.76))PutAll (Reference: Details (p.112)) PutPort (Reference: Details (p.114))


8-5-68 SaveBackupData

Saves all setting data (all scene data, system data, and calibration group data) of the sensor to afile.

FormatFunction SaveBackupData(ByVal fileName As String) As Integer

Parameter


DescriptionSaves all setting data in the file specified in the <fileName> parameter.In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.Specify the file extension ".bkd" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSave all setting data in a file.


Related Items


<fileName> String Name (*.bkd) of backup file for all setting data

Dim ret As Integer = Me.CoreRA1.SaveBackupData("C:\BACKDIR\BackupData.bkd")

GetSystemData (Reference: Details (p.83)) LoadBackupData (Reference: Details (p.90))SaveData (Reference: Details (p.122)) SaveScene (Reference: Details (p.125))SaveSceneGroup (Reference: Details (p.126))

SaveSystemData (Reference: Details (p.127))


122

8-5-69 SaveData

Saves all sensor setting data in the sensor.

FormatFunction SaveData() As Integer

ParameterNone.


DescriptionSaves all sensor setting data in the sensor.


ExampleSave all setting data in the sensor.


Related Items

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.SaveData()Me.CoreRA1.SetRunMode(1)

SaveBackupData (Reference: Details (p.121))

SaveScene (Reference: Details (p.125))

SaveSceneGroup (Reference: Details (p.126))



8-5-70 SaveImage

Saves image data.

FormatFunction SaveImage(ByVal preImageNo As Integer, ByVal fileName As String) AsInteger

Parameter


DescriptionSaves the image that has the image logging number specified in the <preImageNo> parameter,using the file name in ifz format specified in the <fileName> parameter.In the <preImageNo> parameter, specify the image number of the logging image already loggedas a logging image in the sensor.In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.Specify the file extension ".ifz" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSave the image with image logging number 0 to a file.


Related Items


<preImageNo> Integer Image number (0 to 19) of the logging image to be saved(-1) saves the most recent image.

<fileName> String File name of image to be saved

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.SaveImage(0, "C:\BACKDIR\a.ifz")Me.CoreRA1.SetRunMode(1)

SaveLoggingData (Reference: Details (p.124))


124

8-5-71 SaveLoggingData

Saves the measurement data that is saved by data logging in the sensor memory to a file.

FormatFunction SaveLoggingData(ByVal fileName As String) As Integer

Parameter


DescriptionSaves logging data in the file specified in the <fileName> parameter.Specify the file extension ".csv" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSaves the measurement data that is saved by data logging in the sensor memory to a file.


Related Items


<fileName> String File name of the logging data to be saved

Dim ret As Integer = Me.CoreRA1.SaveLoggingData("C:\BACKDIR\loggingData.csv")

SaveImage (Reference: Details (p.123))


8-5-72 SaveScene

Saves scene data.

FormatFunction SaveScene(ByVal sceneNo As Integer, ByVal fileName As String) AsInteger

Parameter


DescriptionSaves the scene data with the scene number specified in the <sceneNo> parameter in the filewith the file name specified in the <fileName> parameter.In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.Specify the file extension ".scn" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSave the scene data of scene 2 in a file.


Related Items


<sceneNo> Integer Scene number to save the scene (0 to 31)<fileName> String Name of the scene data file to be saved (*.scn)

Dim ret As Integer = Me.CoreRA1.SaveScene(2, "C:\BACKDIR\scene02.scn")

LoadScene (Reference: Details (p.91))



SaveSceneGroup (Reference: Details (p.126))



126

8-5-73 SaveSceneGroup

Saves the scene group data.

FormatFunction SaveSceneGroup(ByVal fileName As String) As Integer

Parameter


DescriptionSaves the scene group data in the file with the file name specified in the <fileName> parameter.In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.Specify the file extension ".sgp" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSave the scene group data in a file.


Related Items


<fileName> String Name of the scene group data file to be saved (*.sgp)

Dim ret As Integer = Me.CoreRA1.SaveSceneGroup("C:\BACKDIR\scenegroup.sgp")

LoadSceneGroup (Reference: Details (p.92))


SaveData (Reference: Details (p.122)) SaveScene (Reference: Details (p.125))SaveSystemData (Reference: Details (p.127))


8-5-74 SaveSystemData

Saves system data.

FormatFunction SaveSystemData(ByVal fileName As String) As Integer

Parameter


DescriptionSaves the system data in the file with the file name specified in the <fileName> parameter.In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.Specify the file extension ".syd" in the file name specified in the <fileName> parameter.If the file specified in the <fileName> parameter already exists, it is overwritten.


ExampleSave the system data in a file.


Related Items


<fileName> String Name of the system data file to be saved (*.syd)

Dim ret As Integer = Me.CoreRA1.SaveSystemData("C:\BACKDIR\backupsysset.syd")

GetSystemData (Reference: Details (p.83)) LoadSystemData (Reference: Details (p.93))SaveBackupData (Reference: Details (p.121))


SaveScene (Reference: Details (p.125)) SaveSceneGroup (Reference: Details (p.126))


128

8-5-75 SceneCount

Gets the number of scenes that can be used.

FormatFunction SceneCount() As Integer

ParameterNone.

Return valueReturns the number of scenes that can be used as an integer.Returns -1 if an error occurs.

DescriptionGets the number of scenes that can be used.


ExampleGets the number of scenes that can be used.


Related Items

Dim num As Integer = Me.CoreRA1.SceneCount()

ChangeScene (Reference: Details (p.48)) ClearScene (Reference: Details (p.51))CopyScene (Reference: Details (p.55)) SceneNo (Reference: Details (p.129))


8-5-76 SceneNo

Gets the scene number of the current scene.

FormatFunction SceneNo() As Integer

ParameterNone.

Return valueReturns the scene number of the current scene as an integer.Returns -1 if an error occurs.

DescriptionGets the scene number of the current scene.


ExampleGet the scene number of the current scene. If the scene number is not 2, change to scene 2.


Related Items

'Get the scene number of the current scene.Dim no As Integer = Me.CoreRA1.SceneNo()'If the scene number is not 2, change to scene 2Dim ret As IntegerIf no <> 2 Then ret = Me.CoreRA1.ChangeScene(2)End If

ChangeScene (Reference: Details (p.48)) ClearScene (Reference: Details (p.51))CopyScene (Reference: Details (p.55)) SceneCount (Reference: Details (p.128))


130

8-5-77 SceneTitle

Gets the scene title.

FormatFunction SceneTitle(ByVal sceneNo As Integer) As String

Parameter

Return valueReturns the scene title as a character string.Returns null if an error occurs.

DescriptionGets the title set in the scene that has the scene number specified in the <sceneNo> parameter.If a title name is not set, returns null.


ExampleGet the title of scene 2.


Related Items


<sceneNo> Integer Scene number (0 to 31)

Dim title As String = Me.CoreRA1.SceneTitle(2)

SetSceneTitle (Reference: Details (p.157))


8-5-78 SensorName

Gets the sensor name.

FormatFunction SensorName() As String

Parameter

　None

Return valueReturns the sensor name as a character string.Returns null if an error occurs.

DescriptionGets the FQ2 sensor name.If a sensor name is not set, returns the default value "FQ".


ExampleGets the sensor name.


Related Items

Dim title As String = Me.CoreRA1.SensorName()

SetSensorName (Reference: Details (p.158))


132

8-5-79 SetCalculationData

Sets calculation data.

FormatFunction SetCalculationData(ByVal dataNo As Integer, ByVal data As Integer) AsIntegerFunction SetCalculationData(ByVal dataNo As Integer, ByVal data As Double) AsIntegerFunction SetCalculationData(ByVal dataNo As Integer, ByVal data As String, ByValstring_type As Integer) As Integer

Parameter


DescriptionSets the data specified in the <data> parameter in the calculation data specified in the<dataNo> parameter.Change the data type of the <data> parameter to the type of data to be set.


ExampleSet external reference data No. 410 (data logging switch) in the calculation data.

Set external reference data No. 300 (judgement upper limit 0) in the calculation data.




Setting data

<string_type> Integer If the setting data is a character string, specify the character string type (0:char, 1: TCHAR)

Me.CoreRA1.SetRunMode(2)Dim data As Integer = 1'Change the variable data type to signed integer because the data logging switch value is an integer.Dim ret As Integer = Me.CoreRA1.SetCalculationData(410, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 100.0'Change the variable data type to double precision floating point decimal because the judgement upper limitvalue is a real number.Dim ret As Integer = Me.CoreRA1.SetCalculationData(300, data)Me.CoreRA1.SetRunMode(1)


Set external reference data No. 150 (expression name 0) in the calculation data.


Related Items

Me.CoreRA1.SetRunMode(2)Dim data As String = "1+2"'Change the variable data type to string because expression name 0 is a character string.Dim ret As Integer = Me.CoreRA1.SetCalculationData(150, data,0)Me.CoreRA1.SetRunMode(1)

CalculationData (Reference: Details (p.45)) GetCalculationData (Reference: Details (p.61))


134

8-5-80 SetCameraData

Sets data in a camera parameter.

FormatFunction SetCameraData(ByVal dataNo As Integer, ByVal data As Integer) AsIntegerFunction SetCameraData(ByVal dataNo As Integer, ByVal data As Double) AsInteger

Parameter


DescriptionSets the data specified in the <data> parameter in the camera image input data specified in the<dataNo> parameter.For the camera parameter numbers, refer to "Camera parameter numbers" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).Change the data type of the <data> parameter to the type of data to be set.


ExampleSet data in camera parameter No. 1 (shutter speed).

Set data in camera parameter No. 10 (white balance R scaling).




<data> IntegerDouble Setting data

Me.CoreRA1.SetRunMode(2)Dim data As Integer = 20'Change the variable data type to signed integer because the shutter speed value is an integer.Dim ret As Integer = Me.CoreRA1.SetCameraData(1, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 1.2'Change the variable data type to double precision floating point decimal because the white balance Rscaling data value is a real number.Dim ret As Integer = Me.CoreRA1.SetCameraData(10, data)Me.CoreRA1.SetRunMode(1)


Related ItemsCameraData (Reference: Details (p.47)) GetCameraData (Reference: Details (p.63))


136

8-5-81 SetLinkOutputData

Sets the data output by link data / Fieldbus data communication.

FormatFunction SetLinkOutputData(ByVal dataNo As Integer, ByVal data As Integer) AsIntegerFunction SetLinkOutputData(ByVal dataNo As Integer, ByVal data As String, ByValstring_type As Integer) As Integer

Parameter


DescriptionSets the data output by link data / Fieldbus data communication.Change the data type of the <data> parameter to the type of data to be set.


ExampleSet external reference data No. 307 (output format) of link data output / Fieldbus data output.

Set external reference data No. 120 (output data 0) of link data output / Fieldbus data output.　


Related Items


<dataNo> IntegerData number of external reference data of link data output / Fieldbusdata output (Reference: 8-6 External Reference Parameters (p.163))

<data> IntegerString Setting data


Me.CoreRA1.SetRunMode(2)Dim data As Integer'Change the variable data type to signed integer because the output format is an integer value.Dim ret As Integer = Me.CoreRA1.SetLinkOutputData(307, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As String = "1+2"'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.SetLinkOutputData(120, data,0)Me.CoreRA1.SetRunMode(1)


GetLinkOutputData (Reference: Details (p.66))


138

8-5-82 SetMeasureItemData

Sets the data of an inspection item.

FormatFunction SetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal data As Integer) As IntegerFunction SetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal data As Double) As IntegerFunction SetMeasureItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal data As String, ByVal string_type As Integer) As Integer

Parameter


DescriptionSets the data of an inspection item.Set the same data type for the <data> parameter as the data to be acquired.


ExampleSet external reference data No. 103 (reflect) of inspection item No. 1 (search).

Sets external reference data No. 132 (detection point X) of inspection item No. 1 (search).

Set external reference data No. 127 (error string) of inspection item No. 2 (2D code).


<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item


Setting data


Me.CoreRA1.SetRunMode(2)Dim data As Integer = 1'Change the variable data type to signed integer because the reflect value is an integer.Dim ret As Integer = Me.CoreRA1.SetMeasureItemData(1, 103, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 100.0'Change the variable data type to double precision floating point decimal because the detection point Xdata value is a real number.Dim ret As Integer = Me.CoreRA1.SetMeasureItemData(1, 132, data)Me.CoreRA1.SetRunMode(1)



Related Items

Me.CoreRA1.SetRunMode(2)Dim data As String = "CodeNG"'Change the variable data type to string because the decode character string is a character string.Dim ret As Integer = Me.CoreRA1.SetMeasureItemData(2, 127, data, 0)Me.CoreRA1.SetRunMode(1)



140

8-5-83 SetMeasureItemFigure

Sets inspection item figure data.

FormatFunction SetMeasureItemFigure(ByVal itemNo As Integer, ByVal figureNo AsInteger, ByVal figure As Integer()) As Integer

Parameter


DescriptionSets inspection item figure data.For region numbers and figure data, refer to "SETITEMFIGPARAM or SIFP" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).


ExampleSet the coordinates of the upper left corner of figure data No. 1 (region figure) of inspection itemNo. 1 (search) to (100, 50).


Related Items


<itemNo> Integer Item number (0 to 31) of the inspection item<figureNo> Integer Region number (0 to 7)<figure> Integer() Figure data to be set

Me.CoreRA1.SetRunMode(2)Dim figure(5) As IntegerDim ret As Integer = Me.CoreRA1.GetMeasureItemFigure(1, 1, figure)

If ret = 0 Then

　figure(2) = 100　figure(3) = 50

　ret = Me.CoreRA1.SetMeasureItemFigure(1, 1, figure)

End IfMe.CoreRA1.SetRunMode(1)



GetMeasureItemFigure (Reference: Details (p.70))


142

8-5-84 SetMeasureItemTitle

Sets the title of an inspection item.

FormatFunction SetMeasureItemTitle(ByVal itemNo As Integer, ByVal unitTitle As String)As Integer

Parameter


DescriptionSets the title specified in the <unitTitle> parameter in the title of the inspection item specified inthe <itemNo> parameter.The title can be set in the language specified in the language setting.


ExampleSet the title of inspection item No. 1 (search).


Related Items


<itemNo> Integer Inspection item number (0 to 31) of inspection item whose title is to be set<unitTitle> Integer Title to be set

Me.CoreRA1.SetRunMode(2)Dim unitTitle As String = "MySearch"'Set the title of inspection item No. 1 (search).Dim ret As Integer = Me.CoreRA1.SetMeasureItemTitle(1, unitTitle)Me.CoreRA1.SetRunMode(1)


MeasureItemIdent (Reference: Details (p.98))



8-5-85 SetMeasureOut

Sets whether or not measurement results are output to an external device.

FormatFunction SetMeasureOut(ByVal mode As Integer) As Integer

Parameter


DescriptionSets whether or not measurement results are output to an external device.


ExampleSets measurement result output to "enable".


Related Items


<mode> Integer Output yes/no (0: Yes, 1: No)

Dim ret As Integer = Me.CoreRA1.SetMeasureOut(1)

GetMeasureOut (Reference: Details (p.71))


144

8-5-86 SetNoprotocolOutputData

Sets the data that is output by no protocol data communication.

FormatFunction SetNoprotocolOutputData(ByVal dataNo As Integer, ByVal data AsInteger) As IntegerFunction SetNoprotocolOutputData(ByVal dataNo As Integer, ByVal data AsString, ByVal string_type As Integer) As Integer

Parameter


DescriptionSets the data that is output by no protocol data communication.Change the data type of the <data> parameter to the type of data to be set.


ExampleSet external reference data No. 300 (data format) of no protocol data output to ASCII.

Set external reference data No. 120 (output data 0) of no protocol data output.　


Related Items





Me.CoreRA1.SetRunMode(2)Dim data As Integer = 0'Change the variable data type to signed integer because the data type is integer.Dim ret As Integer = Me.CoreRA1.SetNoprotocolOutputData(300, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As String = "1+2"'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.SetNoprotocolOutputData(120, data,0)Me.CoreRA1.SetRunMode(1)




146

8-5-87 SetParallelData

Sets the data that is output by parallel data communication.

FormatFunction SetParallelData(ByVal dataNo As Integer, ByVal data As Integer) AsIntegerFunction SetParallelData(ByVal dataNo As Integer, ByVal data As String, ByValstring_type As Integer) As Integer

Parameter


DescriptionSets the data that is output by parallel data communication.Set the same data type for the <data> parameter as the data to be acquired.


ExampleSet external reference data No. 300 (data format) of parallel data output.

Set external reference data No. 150 (output data 0) of parallel data output.　


Related Items





Me.CoreRA1.SetRunMode(2)Dim data As Integer = 0'Change the variable data type to signed integer because the output format is an integer value.Dim ret As Integer = Me.CoreRA1.SetParallelData(300, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As String = "1+2"'Change the variable data type to string because the output data 0 value is a character string.Dim ret As Integer = Me.CoreRA1.SetParallelData(150, data,0)Me.CoreRA1.SetRunMode(1)


GetParallelData (Reference: Details (p.73)) ParallelData (Reference: Details (p.103))


148

8-5-88 SetParallelJudgeData

Sets the data that is output by parallel judgement output.

FormatFunction SetParallelJudgeData(ByVal dataNo As Integer, ByVal data As Integer)As IntegerFunction SetParallelJudgeData(ByVal dataNo As Integer, ByVal data As Double)As IntegerFunction SetParallelJudgeData(ByVal dataNo As Integer, ByVal data As String,ByVal string_type As Integer) As Integer

Parameter


DescriptionSets the data that is output by parallel judgement output.Set the same data type for the <data> parameter as the data to be acquired.


ExampleGet external reference data No. 103 (reflect) of parallel judgement output.

Set external reference data No. 300 (judgement upper limit) of parallel judgement output.

Set external reference data No. 150 (output data 0) of parallel judgement output.　


<dataNo> IntegerExternal reference data number of parallel judgement output(Reference: 8-6 External Reference Parameters (p.163))


Setting data


Me.CoreRA1.SetRunMode(2)Dim data As Integer = 0'Change the variable data type to signed integer because the reflect value is an integer.Dim ret As Integer = Me.CoreRA1.SetParallelJudgeData(103, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 100.0'Change the variable data type to double precision floating point decimal because the judgement upper limitvalue is a real number.Dim ret As Integer = Me.CoreRA1.SetParallelJudgeData(300, data)Me.CoreRA1.SetRunMode(1)



Related Items

Me.CoreRA1.SetRunMode(2)Dim data As String = "1+2"'Change the variable data type to string because the output data is a character string.Dim ret As Integer = Me.CoreRA1.SetParallelJudgeData(150, data, 0)Me.CoreRA1.SetRunMode(1)




150

8-5-89 SetPositionItemData

Sets the data of an image adjustment item.

FormatFunction SetPositionItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal data As Integer) As IntegerFunction SetPositionItemData(ByVal itemNo As Integer, ByVal dataNo As Integer,ByVal data As Double) As Integer

Parameter


DescriptionSets the data of an image adjustment item.Change the data type of the <data> parameter to the type of data to be set.


ExampleSet external reference data No. 120 (source image) of image adjustment item No. 1 (color grayfilter).

Set external reference data No. 145 (detection point X) of image adjustment item No. 2 (searchposition compensation).



<itemNo> Integer Item number (0 to 7) of the image adjustment item.<dataNo> Integer External reference data number of the image adjustment item


Me.CoreRA1.SetRunMode(2)Dim data As Integer = 1'Change the variable data type to signed integer because the source image data value is an integer.Dim ret As Integer = Me.CoreRA1.SetPositionItemData(1, 120, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 100.0'Change the variable data type to double precision floating point decimal because the detection point X is areal number.Dim ret As Integer = Me.CoreRA1.SetPositionItemData(2, 145, data)Me.CoreRA1.SetRunMode(1)


Related Items


PositionItemData (Reference: Details (p.108))


152

8-5-90 SetPositionItemFigure

Sets the figure data of an image adjustment item.

FormatFunction SetPositionItemFigure(ByVal itemNo As Integer, ByVal figureNo AsInteger, ByVal figure As Integer()) As Integer

Parameter


DescriptionSets the figure data of an image adjustment item.For region numbers and figure data, refer to "SETITEMFIGPARAM or SIFP" in FQ2-S/CH SeriesUser's Manual for Communications Settings (Cat. No. Z338).


ExampleSet the coordinates of the upper left corner of figure data No. 1 (region figure) of imageadjustment item No. 0 (extract edges) to (100, 50).


Related Items


<itemNo> Integer Item number (0 to 7) of the image adjustment item.<figureNo> Integer Region number (0 to 7)

<figure> Integer()Figure data to be set (Reference: 8-4 Figure Data List (p.30))

Me.CoreRA1.SetRunMode(2)Dim figure(5) As IntegerDim ret As Integer = Me.CoreRA1.GetPositionItemFigure(1, 0, figure)

If ret = 0 Then

　figure(2) = 100　figure(3) = 50

ret = Me.CoreRA1.SetPositionItemFigure(1, 0, figure)

End IfMe.CoreRA1.SetRunMode(1)


GetPositionItemFigure (Reference: Details (p.79))


154

8-5-91 SetPositionItemTitle

Sets the title of an image adjustment item

FormatFunction SetPositionItemTitle(ByVal itemNo As Integer, ByVal unitTitle As String)As Integer

Parameter


DescriptionSets the title specified in the <unitTitle> parameter in the title of the image adjustment itemspecified in the <itemNo> parameter.The title can be set in the language specified in the language setting.


ExampleGet the title of image adjustment item No. 1 (position compensation).


Related Items


<itemNo> Integer Inspection item number (0 to 7) of image adjustment item whose title is to beset

<unitTitle> String Title to be set

Me.CoreRA1.SetRunMode(2)Dim unitTitle As String = "MyScroll"'Set the title of image adjustment item No. 1 (position compensation).Dim ret As Integer = Me.CoreRA1.SetPositionItemTitle(1, unitTitle)Me.CoreRA1.SetRunMode(1)




8-5-92 SetRetryData

Sets retry data.

FormatFunction SetRetryData(ByVal dataNo As Integer, ByVal data As Integer) AsIntegerFunction SetRetryData(ByVal dataNo As Integer, ByVal data As Double) As Integer

Parameter


DescriptionSets retry data.Change the data type of the <data> parameter to the type of data to be set.


ExampleSet external reference data No. 121 (max count) of the retry.

Set external reference data No. 123 (shutter speed step) of the retry.


Related Items


<dataNo> Integer External reference data number of retry


Me.CoreRA1.SetRunMode(2)Dim data As Integer = 2'Change the variable data type to signed integer because the max count value is an integer.Dim ret As Integer = Me.CoreRA1.SetRetryData(121, data)Me.CoreRA1.SetRunMode(1)

Me.CoreRA1.SetRunMode(2)Dim data As Double = 0.02'Change the variable data type to double precision floating point decimal because the shutter speed stepvalue is a real number.Dim ret As Integer = Me.CoreRA1.SetRetryData(123, data)Me.CoreRA1.SetRunMode(1)

GetRetryData (Reference: Details (p.80)) RetryData (Reference: Details (p.119))


156

8-5-93 SetRunMode

Sets the execution status (execution mode) of the FQ2 sensor.

FormatFunction SetRunMode(ByVal mode As Integer) As Integer

Parameter


DescriptionSets the execution status (execution mode) of the FQ2 sensor.


Example　 Change the execution mode to setup mode.


Related Items


<mode> IntegerExecution mode 1: Run mode 2: Setup mode

Dim ret As Integer = Me.CoreRA1.SetRunMode(2)

GetRunMode (Reference: Details (p.82)) Measure (Reference: Details (p.94))Remeasure (Reference: Details (p.117))


8-5-94 SetSceneTitle

Sets the title of a scene.

FormatFunction SetSceneTitle(ByVal sceneNo As Integer, ByVal sceneTitle As String) AsInteger

Parameter


DescriptionSets the title specified in the <sceneTitle> parameter in the title of the scene specified in the<sceneNo> parameter.If a title with 32 or more characters is specified in the <sceneTitle> parameter, the first 31characters are set in the title.


ExampleSet the title of scene 2.


Related Items


<sceneNo> Integer Scene number (0 to 31) of the scene for which a title is to be set.<sceneTitle> String Scene title

Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.SetSceneTitle(2, "Title")Me.CoreRA1.SetRunMode(1)

SceneTitle (Reference: Details (p.130))


158

8-5-95 SetSensorName

Sets the sensor name.

FormatFunction SetSensorName(ByVal name As String) As Integer

Parameter


DescriptionSets the FQ2 sensor name.


ExampleSets the sensor name.


Related Items


<name> String Sensor name

Me.CoreRA1.SetRunMode(2)Dim name As String = "MyFq"Dim ret As Integer = Me.CoreRA1.SetSensorName(name)Me.CoreRA1.SetRunMode(1)

SensorName (Reference: Details (p.131))


8-5-96 SetSystemData

Sets the system data.

FormatFunction SetSystemData(ByVal dataIdent0 As String, ByVal dataIdent1 As String,ByVal data As Integer) As Integer

Parameter


DescriptionSets the value specified in the <data> parameter in the system data of identification information1 specified in the <dataIdent1> parameter, which belongs to identification information 0specified in the <dataIdent0> parameter.For system data identification information, refer to the system data list. (Reference: SystemData List (p. 28))


ExampleSpecify 7 for the startup scene number that belongs to identification information 0 of"Configuration" and whose identification information 1 is "initialSceneNo".


Related Items


<dataIdent0> String Data identifier of identification information 0 of system data to be set.<dataIdent1> String Data identifier of identification information 1 of system data to be set.<data> Integer Value of the system data to be set

Me.CoreRA1.SetRunMode(2)'Set the startup scene number of Configuration.Dim ret As Integer = Me.CoreRA1.SetSystemData("Configuration", "initialSceneNo", 7)Me.CoreRA1.SetRunMode(1)

GetSystemData (Reference: Details (p.83))


160

8-5-97 SystemReset

Reboots the sensor.

FormatFunction SystemReset() As Integer

ParameterNone.


DescriptionReboots the sensor.


ExampleReboots the sensor.


Related Items

　None

Dim ret As Integer = Me.CoreRA1.SystemReset()


8-5-98 TeachMeasureItem

Executes teaching for a specified inspection item.

FormatFunction TeachMeasureItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionExecutes teaching for the inspection item specified in the <itemNo> parameter.


ExampleExecute teaching for inspection item No. 1 (search).


Related Items



Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.TeachMeasureItem(1)Me.CoreRA1.SetRunMode(1)

TeachPositionItem (Reference: Details (p.162))


162

8-5-99 TeachPositionItem

Executes teaching for a specified image adjustment item.

FormatFunction TeachPositionItem(ByVal itemNo As Integer) As Integer

Parameter


DescriptionExecutes teaching for the image adjustment item specified in the <itemNo> parameter.


ExampleExecute teaching for image adjustment item No. 1 (shape search position compensation).


Related Items



Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.TeachPositionItem(1)Me.CoreRA1.SetRunMode(1)

TeachMeasureItem (Reference: Details (p.161))


8-6 External Reference Parameters

　Retry　

　Calculation　

　(N = 0 to 31)

External referencenumber

Data name Set/Get Data type Data range Default

121 Max count Set/Get Integer 0 to 20 4122 Interval Set/Get Integer 32 to 999 100

123 Shutterspeed step Set/Get Double 0.01 to 1 0.3

124 Brightness step Set/Get Integer 1 to 20 5

125Exposure timeincrement count

Set/Get Integer 0 to 10 2

126Exposure timedecrement count




0 Judgement Get Integer-2: No judgement0: Judgement result OK-1: Judgement result NG

-2

5 + N Data N Get Double -999999999.9999to 999999999.9999 0

55 + N Judgement N Get Integer

-2: No judgement0: Judgement result OK-1: Judgement result NG -2

103 Apply overalljudgement Set/Get Integer 0: Yes, 1: No 0

150 + N Expression N Set/Get String(char) 255 characters Empty character string

(“”)

250 + N Name of expression N Set/Get String

(TCHAR) 15 characters Empty character string(“”)

300 + N Judgement upper limit N Set/Get Double -999999999.9999

to 999999999.9999 999999999.9999

350 + N Judgement lower limit N Set/Get Double -999999999.9999

to 999999999.9999 -999999999.9999

410Data logging switch(all items)

Set/Get Integer 0: Data logging OFF1: Data logging ON 1

411Data logging sw forjudgement

Set/Get Integer0: Data logging OFF1: Data logging ON 1


164

　No protocol data output　

　(N = 0 to 31)

　Link data output / Fieldbus data output　

(N = 0 to 15)

　Parallel judgement output　



120 + N Output dataN Set/Get String

(char) 255 characters Empty character string(“”)

200 + N Output dataname N Set/Get String


300 Data format Set/Get Integer 0: ASCII, 1: Binary 0

301 Integer digits(for ASCII) Set/Get Integer 0 to 10 6

302Decimal part digits(for ASCII)


303 Negative(for ASCII) Set/Get Integer 0: ”-”

1: ”8” 0

304Field separator(for ASCII)

Set/Get Integer0: OFF1: Comma2: Tab3: Space4: CR5: LF6: CR+LF

0

305Record separator(for ASCII)

Set/Get Integer 0

306Zero suppressed(for ASCII)

Set/Get Integer 0: No, 1: Yes 0

307Decimal output form(for binary)

Set/Get Integer 0: Floating point1: Fixed point 1



103 Apply overalljudgement Set/Get Integer 0: Yes, 1: No 0

120 + N Output data N Set/Get String


200 + N Output data name N Set/Get String


307 Output format Set/Get Integer 0: Floating point

1: Fixed point 1



103 Apply overall judgement Set/Get Integer 0: Yes, 1: No 0




　(N = 0 to 15)

　Parallel data output　

　(N = 0 to 31)

250 + N Output dataname N Set/Get String


300 + N Judgemen tupper limit N Set/Get Double -999999999.9999

to 999999999.9999 999999999.9999

350 + N Judgemen tlower limit N Set/Get Double -999999999.9999

to 999999999.9999 -999999999.9999

400 Data output Set/Get Integer 0: No, 1: Yes 1





250 + N Output data name N Set/Get String


300 Output format Set/Get Integer 0: Binary

1: BCD 0

400 Data output Set/Get Integer 0: No, 1: Yes 1




166

Revision Historyzz

Revision code Rev. date Revised contents SoftwareVersion

01 April 2015 1st edition Ver. 1.91 or later

Revision History

Terms and Conditions of Sale1. Offer; Acceptance. These terms and conditions (these "Terms") are deemed

part of all quotes, agreements, purchase orders, acknowledgments, price lists,catalogs, manuals, brochures and other documents, whether electronic or inwriting, relating to the sale of products or services (collectively, the "Products")by Omron Electronics LLC and its subsidiary companies (“Omron”). Omronobjects to any terms or conditions proposed in Buyer’s purchase order or otherdocuments which are inconsistent with, or in addition to, these Terms.

2. Prices; Payment Terms. All prices stated are current, subject to change with-out notice by Omron. Omron reserves the right to increase or decrease priceson any unshipped portions of outstanding orders. Payments for Products aredue net 30 days unless otherwise stated in the invoice.

3. Discounts. Cash discounts, if any, will apply only on the net amount of invoicessent to Buyer after deducting transportation charges, taxes and duties, and willbe allowed only if (i) the invoice is paid according to Omron’s payment termsand (ii) Buyer has no past due amounts.

4. Interest. Omron, at its option, may charge Buyer 1-1/2% interest per month orthe maximum legal rate, whichever is less, on any balance not paid within thestated terms.

5. Orders. Omron will accept no order less than $200 net billing. 6. Governmental Approvals. Buyer shall be responsible for, and shall bear all

costs involved in, obtaining any government approvals required for the impor-tation or sale of the Products.

7. Taxes. All taxes, duties and other governmental charges (other than generalreal property and income taxes), including any interest or penalties thereon,imposed directly or indirectly on Omron or required to be collected directly orindirectly by Omron for the manufacture, production, sale, delivery, importa-tion, consumption or use of the Products sold hereunder (including customsduties and sales, excise, use, turnover and license taxes) shall be charged toand remitted by Buyer to Omron.

8. Financial. If the financial position of Buyer at any time becomes unsatisfactoryto Omron, Omron reserves the right to stop shipments or require satisfactorysecurity or payment in advance. If Buyer fails to make payment or otherwisecomply with these Terms or any related agreement, Omron may (without liabil-ity and in addition to other remedies) cancel any unshipped portion of Prod-ucts sold hereunder and stop any Products in transit until Buyer pays allamounts, including amounts payable hereunder, whether or not then due,which are owing to it by Buyer. Buyer shall in any event remain liable for allunpaid accounts.

9. Cancellation; Etc. Orders are not subject to rescheduling or cancellationunless Buyer indemnifies Omron against all related costs or expenses.

10. Force Majeure. Omron shall not be liable for any delay or failure in deliveryresulting from causes beyond its control, including earthquakes, fires, floods,strikes or other labor disputes, shortage of labor or materials, accidents tomachinery, acts of sabotage, riots, delay in or lack of transportation or therequirements of any government authority.

11. Shipping; Delivery. Unless otherwise expressly agreed in writing by Omron:a. Shipments shall be by a carrier selected by Omron; Omron will not drop ship

except in “break down” situations.b. Such carrier shall act as the agent of Buyer and delivery to such carrier shall

constitute delivery to Buyer;c. All sales and shipments of Products shall be FOB shipping point (unless oth-

erwise stated in writing by Omron), at which point title and risk of loss shallpass from Omron to Buyer; provided that Omron shall retain a security inter-est in the Products until the full purchase price is paid;

d. Delivery and shipping dates are estimates only; ande. Omron will package Products as it deems proper for protection against nor-

mal handling and extra charges apply to special conditions.12. Claims. Any claim by Buyer against Omron for shortage or damage to the

Products occurring before delivery to the carrier must be presented in writingto Omron within 30 days of receipt of shipment and include the original trans-portation bill signed by the carrier noting that the carrier received the Productsfrom Omron in the condition claimed.

13. Warranties. (a) Exclusive Warranty. Omron’s exclusive warranty is that theProducts will be free from defects in materials and workmanship for a period oftwelve months from the date of sale by Omron (or such other period expressedin writing by Omron). Omron disclaims all other warranties, express or implied.(b) Limitations. OMRON MAKES NO WARRANTY OR REPRESENTATION,EXPRESS OR IMPLIED, ABOUT NON-INFRINGEMENT, MERCHANTABIL-

ITY OR FITNESS FOR A PARTICULAR PURPOSE OF THE PRODUCTS.BUYER ACKNOWLEDGES THAT IT ALONE HAS DETERMINED THAT THEPRODUCTS WILL SUITABLY MEET THE REQUIREMENTS OF THEIRINTENDED USE. Omron further disclaims all warranties and responsibility ofany type for claims or expenses based on infringement by the Products or oth-erwise of any intellectual property right. (c) Buyer Remedy. Omron’s sole obli-gation hereunder shall be, at Omron’s election, to (i) replace (in the formoriginally shipped with Buyer responsible for labor charges for removal orreplacement thereof) the non-complying Product, (ii) repair the non-complyingProduct, or (iii) repay or credit Buyer an amount equal to the purchase price ofthe non-complying Product; provided that in no event shall Omron be responsi-ble for warranty, repair, indemnity or any other claims or expenses regardingthe Products unless Omron’s analysis confirms that the Products were prop-erly handled, stored, installed and maintained and not subject to contamina-tion, abuse, misuse or inappropriate modification. Return of any Products byBuyer must be approved in writing by Omron before shipment. Omron Compa-nies shall not be liable for the suitability or unsuitability or the results from theuse of Products in combination with any electrical or electronic components,circuits, system assemblies or any other materials or substances or environ-ments. Any advice, recommendations or information given orally or in writing,are not to be construed as an amendment or addition to the above warranty.See http://www.omron247.com or contact your Omron representative for pub-lished information.

14. Limitation on Liability; Etc. OMRON COMPANIES SHALL NOT BE LIABLEFOR SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,LOSS OF PROFITS OR PRODUCTION OR COMMERCIAL LOSS IN ANYWAY CONNECTED WITH THE PRODUCTS, WHETHER SUCH CLAIM ISBASED IN CONTRACT, WARRANTY, NEGLIGENCE OR STRICT LIABILITY.Further, in no event shall liability of Omron Companies exceed the individualprice of the Product on which liability is asserted.

15. Indemnities. Buyer shall indemnify and hold harmless Omron Companies andtheir employees from and against all liabilities, losses, claims, costs andexpenses (including attorney's fees and expenses) related to any claim, inves-tigation, litigation or proceeding (whether or not Omron is a party) which arisesor is alleged to arise from Buyer's acts or omissions under these Terms or inany way with respect to the Products. Without limiting the foregoing, Buyer (atits own expense) shall indemnify and hold harmless Omron and defend or set-tle any action brought against such Companies to the extent based on a claimthat any Product made to Buyer specifications infringed intellectual propertyrights of another party.

16. Property; Confidentiality. Any intellectual property in the Products is the exclu-sive property of Omron Companies and Buyer shall not attempt to duplicate itin any way without the written permission of Omron. Notwithstanding anycharges to Buyer for engineering or tooling, all engineering and tooling shallremain the exclusive property of Omron. All information and materials suppliedby Omron to Buyer relating to the Products are confidential and proprietary,and Buyer shall limit distribution thereof to its trusted employees and strictlyprevent disclosure to any third party.

17. Export Controls. Buyer shall comply with all applicable laws, regulations andlicenses regarding (i) export of products or information; (iii) sale of products to“forbidden” or other proscribed persons; and (ii) disclosure to non-citizens ofregulated technology or information.

18. Miscellaneous. (a) Waiver. No failure or delay by Omron in exercising any rightand no course of dealing between Buyer and Omron shall operate as a waiverof rights by Omron. (b) Assignment. Buyer may not assign its rights hereunderwithout Omron's written consent. (c) Law. These Terms are governed by thelaw of the jurisdiction of the home office of the Omron company from whichBuyer is purchasing the Products (without regard to conflict of law princi-ples). (d) Amendment. These Terms constitute the entire agreement betweenBuyer and Omron relating to the Products, and no provision may be changedor waived unless in writing signed by the parties. (e) Severability. If any provi-sion hereof is rendered ineffective or invalid, such provision shall not invalidateany other provision. (f) Setoff. Buyer shall have no right to set off any amountsagainst the amount owing in respect of this invoice. (g) Definitions. As usedherein, “including” means “including without limitation”; and “Omron Compa-nies” (or similar words) mean Omron Corporation and any direct or indirectsubsidiary or affiliate thereof.

Certain Precautions on Specifications and Use1. Suitability of Use. Omron Companies shall not be responsible for conformity

with any standards, codes or regulations which apply to the combination of theProduct in the Buyer’s application or use of the Product. At Buyer’s request,Omron will provide applicable third party certification documents identifyingratings and limitations of use which apply to the Product. This information byitself is not sufficient for a complete determination of the suitability of the Prod-uct in combination with the end product, machine, system, or other applicationor use. Buyer shall be solely responsible for determining appropriateness ofthe particular Product with respect to Buyer’s application, product or system.Buyer shall take application responsibility in all cases but the following is anon-exhaustive list of applications for which particular attention must be given:(i) Outdoor use, uses involving potential chemical contamination or electricalinterference, or conditions or uses not described in this document.(ii) Use in consumer products or any use in significant quantities. (iii) Energy control systems, combustion systems, railroad systems, aviationsystems, medical equipment, amusement machines, vehicles, safety equip-ment, and installations subject to separate industry or government regulations. (iv) Systems, machines and equipment that could present a risk to life or prop-erty. Please know and observe all prohibitions of use applicable to this Prod-uct. NEVER USE THE PRODUCT FOR AN APPLICATION INVOLVING SERIOUSRISK TO LIFE OR PROPERTY OR IN LARGE QUANTITIES WITHOUTENSURING THAT THE SYSTEM AS A WHOLE HAS BEEN DESIGNED TO

ADDRESS THE RISKS, AND THAT THE OMRON’S PRODUCT IS PROP-ERLY RATED AND INSTALLED FOR THE INTENDED USE WITHIN THEOVERALL EQUIPMENT OR SYSTEM.

2. Programmable Products. Omron Companies shall not be responsible for theuser’s programming of a programmable Product, or any consequence thereof.

3. Performance Data. Data presented in Omron Company websites, catalogsand other materials is provided as a guide for the user in determining suitabil-ity and does not constitute a warranty. It may represent the result of Omron’stest conditions, and the user must correlate it to actual application require-ments. Actual performance is subject to the Omron’s Warranty and Limitationsof Liability.

4. Change in Specifications. Product specifications and accessories may bechanged at any time based on improvements and other reasons. It is our prac-tice to change part numbers when published ratings or features are changed,or when significant construction changes are made. However, some specifica-tions of the Product may be changed without any notice. When in doubt, spe-cial part numbers may be assigned to fix or establish key specifications foryour application. Please consult with your Omron’s representative at any timeto confirm actual specifications of purchased Product.

5. Errors and Omissions. Information presented by Omron Companies has beenchecked and is believed to be accurate; however, no responsibility is assumedfor clerical, typographical or proofreading errors or omissions.

OMRON CANADA, INC. • HEAD OFFICEToronto, ON, Canada • 416.286.6465 • 866.986.6766 • www.omron247.com

OMRON ELECTRONICS DE MEXICO • HEAD OFFICEMéxico DF • 52.55.59.01.43.00 • 01-800-226-6766 • [email protected]

OMRON ELECTRONICS DE MEXICO • SALES OFFICEApodaca, N.L. • 52.81.11.56.99.20 • 01-800-226-6766 • [email protected]

OMRON ELETRÔNICA DO BRASIL LTDA • HEAD OFFICESão Paulo, SP, Brasil • 55.11.2101.6300 • www.omron.com.br

OMRON ARGENTINA • SALES OFFICECono Sur • 54.11.4783.5300

OMRON CHILE • SALES OFFICESantiago • 56.9.9917.3920

OTHER OMRON LATIN AMERICA SALES54.11.4783.5300

Authorized Distributor:

Q225I-E-01 04/15 Note: Specifications are subject to change. © 2016 Omron Electronics LLC Printed in U.S.A.

Printed on recycled paper.

Automation Control Systems• Machine Automation Controllers (MAC) • Programmable Controllers (PLC) • Operator interfaces (HMI) • Distributed I/O • Software

Drives & Motion Controls • Servo & AC Drives • Motion Controllers & Encoders

Temperature & Process Controllers • Single and Multi-loop Controllers

Sensors & Vision• Proximity Sensors • Photoelectric Sensors • Fiber-Optic Sensors• Amplified Photomicrosensors • Measurement Sensors• Ultrasonic Sensors • Vision Sensors

Industrial Components • RFID/Code Readers • Relays • Pushbuttons & Indicators• Limit and Basic Switches • Timers • Counters • Metering Devices • Power Supplies

Safety • Laser Scanners • Safety Mats • Edges and Bumpers • Programmable Safety

Controllers • Light Curtains • Safety Relays • Safety Interlock Switches

OMRON AUTOMATION AND SAFETY • THE AMERICAS HEADQUARTERS • Chicago, IL USA • 847.843.7900 • 800.556.6766 • www.omron247.com

OMRON EUROPE B.V. • Wegalaan 67-69, NL-2132 JD, Hoofddorp, The Netherlands. • +31 (0) 23 568 13 00 • www.industrial.omron.eu

Documents

NET Control Reference Manual - assets.omron.com · .NET Control Reference Manual 10 Different versions of Omron.FQ-Control.dll are required for 32 bit and 64 bit operating systems