.NET Control Reference Manual - assets.omron.com · .NET Control Reference Manual 10 Different...
Transcript of .NET Control Reference Manual - assets.omron.com · .NET Control Reference Manual 10 Different...
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
.NET Control Reference Manual
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.
.NET Control Reference Manual
*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
.NET Control Reference Manual
■TextWindow Control
■SensorListWindow Control
■JudgeWindow Control
.NET Control Reference Manual7
8
■FlowWindow Control
■TrendGraphWindow Control
■HistgramWindow Control
.NET Control Reference Manual
■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.
.NET Control Reference Manual9
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
.NET Control Reference Manual
'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
.NET Control Reference Manual11
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.
.NET Control Reference Manual
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
.NET Control Reference Manual13
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.
.NET Control Reference Manual
● 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
・PropertiesProperty Type Set/Get Description
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]
.NET Control Reference Manual15
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.
Property Type Set/Get Description
.NET Control Reference Manual
・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
.NET Control Reference Manual17
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.
Property Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
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)
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 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]
.NET Control Reference Manual
・Display image
・Properties
・Methods
Property Type Set/Get Description
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
System.Collections.Generic.List(Of String)
Get only List of IP addresses of found sensors
CheckedIndeces
System.Collections.Generic.List(Of String)
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.
.NET Control Reference Manual19
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
.NET Control Reference Manual
・Properties
・Event
Property Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
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
[True: Show] False: Hide
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
[True: Show] False: Hide
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.
.NET Control Reference Manual21
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
Property Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
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.
.NET Control Reference Manual
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
・PropertiesProperty Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
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]
.NET Control Reference Manual23
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.
ItemKind ITEM KIND Set/Get
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)
ItemNo Integer Set/Get
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]
Property Type Set/Get Description
.NET Control Reference Manual
・Display image
・Setting window
・PropertiesProperty Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
BarColor System.Drawing.Color
Set/GetBar colorSetting range (R, G, B) = (0, 0, 0) to (255, 255, 255) [(0, 0, 255)]
ItemKind ITEM KIND Set/Get
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)
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))
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]
.NET Control Reference Manual25
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]
Property Type Set/Get Description
.NET Control Reference Manual
・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)
Property Type Set/Get Description
ConnectCoreRAComponent CoreRA Set/Get Specify the CoreRA control used for connection.
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
.NET Control Reference Manual27
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
OUT1 polarity out1Polarity
OUT2 polarity out2Polarity
OUT0 signal assignment out0Control
OUT1 signal assignment out1Control
OUT2 signal assignment out2Control
Input mode commandMode
LED BUSY busyLedControl
Retry function
--- Retry
Switch order (scene switching) retryChangeSceneMethod
Switch order (target scene) retryChangeSceneArray
Timeout time retryTimeout
.NET Control Reference Manual
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
Judgement output mode orOutMode
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
Judgement output mode orOutMode
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
.NET Control Reference Manual29
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(0) Figure data header information
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
.NET Control Reference Manual
Figure Figure type
Array element Description
Wide line 4
figure(0) Figure data header information
figure(1) Figure type information
figure(2) X-coordinate of first point
figure(3) Y-coordinate of first point
figure(4) X-coordinate of second point
figure(5) Y-coordinate of second point
figure(6) Width
Rectangle 8
figure(0) Figure data header information
figure(1) Figure type information
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(0) Figure data header information
figure(1) Figure type information
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(0) Figure data header information
figure(1) Figure type information
figure(2) X-coordinate of center point
figure(3) Y-coordinate of center point
figure(4) Radius
figure(5) Width
Polygon 512
figure(0) Figure data header information
figure(1) Figure type information
figure(2) Number of vertices
figure(3) X-coordinate of first point
figure(4) Y-coordinate of first point
figure(5) X-coordinate of second point
figure(6) Y-coordinate of second point
.
.
.
.
.
.
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
.NET Control Reference Manual31
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
Reference: Details (p.46)
CameraData Gets numerical data of camera parameters.
ProcessingItem Control
Reference: Details (p.47)
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
Reference: Details(p.61)
GetCameraData Gets data of camera parameters. ProcessingItem Control
Reference: Details(p.63)
GetErrorCode Gets the most recent sensor error code. Other Reference: Details
(p.65)
GetLinkOutputData Gets data output by link data / Fieldbus data communication.
ProcessingItem Control
Reference: Details(p.66)
GetMeasureItemData Gets data of an inspection item. ProcessingItem Control
Reference: Details(p.68)
.NET Control Reference Manual
GetMeasureItemFigure Gets figure data registered in an inspection item.
ProcessingItem Control
Reference: Details(p.70)
GetMeasureOut Gets the external output setting for measurement results.
MeasurementControl
Reference: Details(p.71)
GetNoprotocolOutputData Gets data output by no protocol datacommunication.
ProcessingItem Control
Reference: Details(p.72)
GetParallelData Gets data output by parallel data communication.
ProcessingItem Control
Reference: Details(p.73)
GetParallelJudgeData Gets data output by parallel judgement output.
ProcessingItem Control
Reference: Details(p.74)
GetPort Gets the input status of a specified input terminal.
IO Module Control
Reference: Details(p.76)
GetPositionItemData Gets data of an image adjustment item.
ProcessingItem Control
Reference: Details(p.78)
GetPositionItemFigure Gets figure data of an image adjustment item.
ProcessingItem Control
Reference: Details(p.79)
GetRetryData Gets retry data. ProcessingItem Control
Reference: Details(p.80)
GetRunMode Gets the execution status (execution mode) of the FQ2 sensor.
MeasurementControl
Reference: Details(p.82)
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
Reference: Details(p.85)
IOMonitorStart Starts the IO monitor. IO ModuleControl
Reference: Details(p.86)
IOMonitorStop Terminates the IO monitor. IO ModuleControl
Reference: Details(p.87)
LinkOutputData Gets numerical data output by linkdata / Fieldbus data communication.
ProcessingItem Control
Reference: Details(p.88)
LinkOutputData2Gets character string data output bylink data / Fieldbus data communication.
ProcessingItem Control
Reference: Details(p.89)
LoadBackupDataLoads all setting data (all scene data, system data, and calibration group data).
Data Save/Load
Reference: Details(p.90)
LoadScene Loads scene data. Data Save/Load
Reference: Details(p.91)
LoadSceneGroup Loads scene group data. Data Save/Load
Reference: Details(p.92)
LoadSystemData Loads system data. Data Save/Load
Reference: Details(p.93)
Measure Executes measurement processing. Measurement Control
Reference: Details(p.94)
MeasureItemCount Gets the number of inspection items. Flow Control Reference: Details(p.95)
MeasureItemData Gets numerical data of an inspection item.
Processing Item Control
Reference: Details(p.96)
API name Function Classification References
.NET Control Reference Manual33
34
MeasureItemData2 Gets character string data of an inspection item.
Processing Item Control
Reference: Details(p.97)
MeasureItemIdent Gets the identifier of a registered inspection item.
Processing Item Control
Reference: Details(p.98)
MeasureItemJudge Gets the judgement result of an inspection item.
Measurement Control
Reference: Details(p.99)
MeasureItemTitle Gets the title of an inspection item Processing Item Control
Reference: Details(p.100)
NoprotocolOutputData Gets numerical data output by no protocol data communication.
Processing Item Control
Reference: Details(p.101)
NoprotocolOutputData2 Gets character string data by no protocol data communication.
Processing Item Control
Reference: Details(p.102)
ParallelData Gets numerical data output by parallel data communication.
Processing Item Control
Reference: Details(p.103)
ParallelData2 Gets character string data output by parallel data communication.
Processing Item Control
Reference: Details(p.104)
ParallelJudgeData Gets numerical data output by parallel judgement output.
Processing Item Control
Reference: Details(p.105)
ParallelJudgeData2 Gets string data output by parallel judgement output.
Processing Item Control
Reference: Details(p.106)
PositionItemCount Gets the number of image adjustment items. Flow Control Reference: Details
(p.107)
PositionItemData Gets numerical data of an image adjustment item.
Processing Item Control
Reference: Details(p.108)
PositionItemIdent Gets the identifier of a registeredimage adjustment item.
Processing Item Control
Reference: Details(p.109)
PositionItemJudge Gets the judgement result of an image adjustment item.
Measurement Control
Reference: Details(p.110)
PositionItemTitle Gets the title of an image adjustmentitem.
Processing Item Control
Reference: Details(p.111)
PutAll Sets the output statuses of all output terminals.
IO Module Control
Reference: Details(p.112)
PutPort Sets the output status of a specified output terminal.
IO Module Control
Reference: Details(p.114)
RefreshImageWindow Updates the image display window and text display window.
DisplayControl
Reference: Details(p.116)
ReMeasure Executes remeasurement. Measurement Control
Reference: Details(p.117)
RetryData Gets numerical data related to retry. Processing Item Control
Reference: Details(p.119)
RunOut Sets the output status of the RUN signal
IO Module Control
Reference: Details(p.120)
SaveBackupDataSaves all setting data (all scene data, system data, and calibration group data) of the sensor to a file.
Data Save/Load
Reference: Details(p.121)
SaveData Saves all setting data in the sensor. Data Save/Load
Reference: Details(p.122)
SaveImage Saves image data. Measurement Control
Reference: Details(p.123)
API name Function Classification References
.NET Control Reference Manual
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
Reference: Details(p.125)
SaveSceneGroup Saves the scene group data. Data Save/Load
Reference: Details(p.126)
SaveSystemData Saves system data. Data Save/Load
Reference: Details(p.127)
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
Reference: Details(p.132)
SetCameraData Sets camera parameter data. Processing Item Control
Reference: Details(p.134)
SetLinkOutputData Sets the data output by link data / Fieldbus data communication.
Processing Item Control
Reference: Details(p.136)
SetMeasureItemData Sets the data of an inspection item. Processing Item Control
Reference: Details(p.138)
SetMeasureItemFigure Sets the figure data of an inspectionitem.
Processing Item Control
Reference: Details(p.140)
SetMeasureItemTitle Sets the title of an inspection item Processing Item Control
Reference: Details(p.142)
SetMeasureOutSets whether or not measurementresults are output to an externaldevice.
Measurement Control
Reference: Details(p.143)
SetNoprotocolOutputData Sets the data that are output by noprotocol communication.
Processing Item Control
Reference: Details(p.144)
SetSensorName Sets the sensor name. System Data Reference: Details(p.158)
SetParallelData Sets the data that are output by parallel data communication.
Processing Item Control
Reference: Details(p.146)
SetParallelJudgeData Sets the data that are output by parallel judgement output.
Processing Item Control
Reference: Details(p.148)
SetPositionItemData Sets the data of an image adjustmentitem.
Processing Item Control
Reference: Details(p.150)
SetPositionItemFigure Sets the figure data of an image adjustment item.
Processing Item Control
Reference: Details(p.152)
SetPositionItemTitle Sets the title of an image adjustment item
Processing Item Control
Reference: Details(p.154)
SetRetryData Sets the retry data. Processing Item Control
Reference: Details(p.155)
SetRunMode Sets the execution status (executionmode) of the sensor.
Measurement Control
Reference: Details(p.156)
API name Function Classification References
.NET Control Reference Manual35
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.
Processing Item Control
Reference: Details(p.161)
TeachPositionItem Performs teaching for a specified image adjustment item.
Processing Item Control
Reference: Details(p.162)
API name Function Classification References
.NET Control Reference Manual
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)
API name Function References
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)
API name Function References
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)
.NET Control Reference Manual37
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)
API name Function References
.NET Control Reference Manual
●Measurement Controls
●IO Module Controls
●Display Controls
●System Data
API name Function References
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)
API name Function References
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)
API name Function References
RefreshImageWindow Updates the image display window and text display window. Reference: Details (p.116)
API name Function References
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)
.NET Control Reference Manual39
40
●Data Save/Load
●Others
API name Function References
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)
API name Function References
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)
.NET Control Reference Manual
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)
.NET Control Reference Manual41
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))
.NET Control Reference Manual
8-5-2 AssignPositionItem
Adds an image adjustment item.
FormatFunction AssignPositionItem(ByVal itemident As String) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleAdd a position compensation processing item to the end of the measurement flow for image
Parameter name Data type Description
<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
.NET Control Reference Manual43
44
adjustment items.
Supported VersionsVersion 1.91 or later
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))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual45
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.
Usage Cautions・ None.
ExampleGets character string data of a calculation.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of the calculation (Reference: 8-6External Reference Parameters (p.163))
<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))
.NET Control Reference Manual
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).
Usage Cautions・ None.
ExampleGets the data of camera parameter No. 1 (shutter speed).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> Integer Camera parameter number
Dim data As Double = Me.CoreRA1.CameraData(1)
GetCameraData (Reference: Details (p.63)) SetCameraData (Reference: Details (p.134))
.NET Control Reference Manual47
48
8-5-6 ChangeScene
Changes a scene.
FormatFunction ChangeScene(ByVal sceneNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
DescriptionChanges the current scene to the scene with the scene number specified in the <sceneNo>parameter.
Usage Cautions・ None.
ExampleChange the current scene to scene No. 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-7 ClearError
Clears an error.
FormatFunction ClearError() As Integer
Parameter
None
Return valueError code (0: Normal, -1: Error)
DescriptionClears an error.
Usage Cautions・ None.
ExampleClears an error.
Supported VersionsVersion 1.91 or later
Related Items
Dim ret As Integer = Me.CoreRA1.ClearError()
GetErrorCode (Reference: Details (p.65))
.NET Control Reference Manual49
50
8-5-8 ClearMeasureData
Clears the measurement results of a processing item.
FormatFunction ClearMeasureData() As Integer
ParameterNone.
Return valueError code (0: Normal, -1: Error)
DescriptionClears all measurement results of a processing item.
Usage Cautions・ None.
ExampleClears all measurement results of a processing item.
Supported VersionsVersion 1.91 or later
Related Items None
'Clear the measurement results.Dim ret As Integer = Me.CoreRA1.ClearMeasureData()
.NET Control Reference Manual
8-5-9 ClearScene
Clears scene data.
FormatFunction ClearScene(ByVal sceneNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleClear the scene data of scene No. 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetRunMode (Reference: Details (p.82)) SceneCount (Reference: Details (p.128))SceneNo (Reference: Details (p.129)) SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual51
52
8-5-10 ClearTotalData
Clears statistical data.
FormatFunction ClearTotalData() As Integer
ParameterNone
Return valueError code (0: Normal, -1: Error)
DescriptionClears statistical data.
Usage Cautions・ None.
ExampleClears statistical data.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual
8-5-11 CopyMeasureItem
Copies an inspection item.
FormatFunction CopyMeasureItem(ByVal itemNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
DescriptionCopies the inspection item specified in the <itemNo> parameter to the end of the inspectionprocessing item block.
Usage Cautions・ This command is only valid in setup mode.
Example
Copies the specified inspection item to the end of the inspection processing item block.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual53
54
8-5-12 CopyPositionItem
Copies an image adjustment item.
FormatFunction CopyPositionItem(ByVal itemNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
DescriptionCopies the image adjustment item specified in the <itemNo> parameter to the end of theinspection processing item block.
Usage Cautions・ This command is only valid in setup mode.
Example
Copies the image adjustment item to the end of the image adjustment item block.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
GetRunMode (Reference: Details (p.82)) PositionItemCount (Reference: Details (p.107))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
8-5-13 CopyScene
Copies scene data.
FormatFunction CopyScene(ByVal srcSceneNo As Integer, ByVal destSceneNo AsInteger) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleCopy the data of scene 2 to scene 3.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetRunMode (Reference: Details (p.82)) SceneCount (Reference: Details (p.128))SceneNo (Reference: Details (p.129)) SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual55
56
8-5-14 DeleteMeasureItem
Deletes an inspection item.
FormatFunction DeleteMeasureItem(ByVal itemNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
DescriptionDeletes the inspection item specified in the <itemNo> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleDeletes the processing item of inspection item No. 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
8-5-15 DeletePositionItem
Deletes an image adjustment item.
FormatFunction DeletePositionItem(ByVal itemNo As Integer) As Integer
Parameter
Return valueError code (0: Normal, -1: Error)
DescriptionDeletes the image adjustment item specified in the <itemNo> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleDelete image adjustment item No. 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
GetRunMode (Reference: Details (p.82)) PositionItemCount (Reference: Details (p.107))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual57
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.
Parameter name Data type Description
<ioIdent> String Identifier of the communication module to be used (always "ParallelIo")
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual59
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.
Usage Cautions・ None.
Example Gets the sensor model.
Supported VersionsVersion 1.91 or later
Related ItemsNone
Parameter name Data type Description
<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)
.NET Control Reference Manual
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.
Usage Cautions・ None.
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.
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of the calculation (Reference: 8-6External Reference Parameters (p.163))
<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)
.NET Control Reference Manual61
62
Supported VersionsVersion 1.91 or later
Related Items
CalculationData (Reference: Details (p.45)) CalculationData2 (Reference: Details (p.46))SetCalculationData (Reference: Details (p.82))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGets the data of camera parameter No. 1 (shutter speed).
Get the data of camera parameter No. 10 (white balance R scaling).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> Integer Camera parameter number
<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)
.NET Control Reference Manual63
64
SetCameraData (Reference: Details (p.134))
.NET Control Reference Manual
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).
Usage Cautions・ None.
ExampleGets the most recent error code of the sensor.
Supported VersionsVersion 1.91 or later
Related Items
Dim ret As Integer = Me.CoreRA1.GetErrorCode()
ClearError (Reference: Details (p.49))
.NET Control Reference Manual65
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets data output by link data / Fieldbus data communication.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ This command is only valid in setup mode.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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
<string_type> Integer Specifies the character string type when the data to be acquired is a characterstring. (0: char, 1: TCHAR)
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)
.NET Control Reference Manual
LinkOutputData (Reference: Details (p.88)) LinkOutputData2 (Reference: Details (p.89))
.NET Control Reference Manual67
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets the data of an inspection item.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ This command is only valid in setup mode.
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).
Parameter name Data type Description
<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item
<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)
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)
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual69
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
Return value Error code (0: Normal, -1: Error)
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).
Usage Cautions・ This command is only valid in setup mode.
ExampleGet figure data No. 1 (region figure) of inspection item No. 1 (search).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SetMeasureItemData (Reference: Details (p.138))
SetMeasureItemFigure (Reference: Details (p.140))
MeasureItemData (Reference: Details (p.96))
MeasureItemData2 (Reference: Details (p.97))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGets the setting for output of measurement results to an external device.
Supported VersionsVersion 1.91 or later
Related Items
Dim meaureOut As Integer = Me.CoreRA1.GetMeasureOut()
SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual71
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of no protocol data output (Reference:8-6 External Reference Parameters (p.163))
<data> IntegerString 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 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))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets data output by parallel data communication.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ None.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel data output (Reference: 8-6 External Reference Parameters (p.163))
<data> IntegerString 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 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))
.NET Control Reference Manual73
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets data output by parallel judgement output.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ None.
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.
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel judgement output(Reference: 8-6 External Reference Parameters (p.163))
<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 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)
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
Related Items
ParallelJudgeData (Reference: Details (p.105))
ParallelJudgeData2 (Reference: Details (p.106))
SetParallelJudgeData (Reference: Details (p.148))
.NET Control Reference Manual75
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.
Usage Cautions・ This command is valid only in setup mode (IO monitor mode only).
ExampleGet the input status of DI5 of parallel I/O.
Parameter name Data type Description
<ioIdent> String Identifier of the communication module to be used (always "ParallelIo")
<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
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual77
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets the data of an image adjustment item.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ None.
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).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 7) of the image adjustment item.<dataNo> Integer External reference data number of the image adjustment item
<data> IntegerDouble Data acquired
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))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
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).
Usage Cautions・ None.
ExampleGet figure data No. 0 (region figure) of image adjustment item No. 1 (extract edges).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual79
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
Return value Error code (0: Normal, -1: Error)
DescriptionGets retry data.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ This command is only valid in setup mode.
ExampleGet external reference data No. 121 (max count) of the retry.
Get external reference data No. 123 (shutter speed step) of the retry.
Supported VersionsVersion 1.91 or later
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of the retry (Reference: 8-6 ExternalReference Parameters (p.163))
<data> IntegerDouble Data acquired
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)
.NET Control Reference Manual
Related Items
RetryData (Reference: Details (p.119)) SetRetryData (Reference: Details (p.155))
.NET Control Reference Manual81
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.
Usage Cautions・ None.
Example Gets the execution mode.
Supported VersionsVersion 1.91 or later
Related Items
Dim runMode As Integer = Me.CoreRA1.GetRunMode()
GetMeasureItemData (Reference: Details (p.68))
Measure (Reference: Details (p.94))
SetMeasureItemData (Reference: Details (p.138))
SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
8-5-33 GetSystemData
Gets system data.
FormatFunction GetSystemData(ByVal dataIdent0 As String, ByVal dataIdent1 As String,ByRef data As Integer) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
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))
Usage Cautions・ None.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual83
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.
Usage Cautions・ None.
ExampleGet statistical data (number of measurements).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-35 ImageUpdate
Updates the image input from the camera.
FormatFunction ImageUpdate() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
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.
Supported VersionsVersion 1.91 or later
Related Items
'Update the frozen image to the most recent image.Dim ret As Integer = Me.CoreRA1.ImageUpdate()
RefreshImageWindow (Reference: Details (p.116))
.NET Control Reference Manual85
86
8-5-36 IOMonitorStart
Starts the IO monitor.
FormatFunction IOMonitorStart() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGets the input statuses of the DI signals in parallel I/O.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual
8-5-37 IOMonitorStop
Stops the IO monitor.
FormatFunction IOMonitorStop() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGets the input statuses of the DI signals in parallel I/O.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual87
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.
Usage Cautions・ None.
ExampleGet external reference data No. 307 (output format) of the link data output / Fieldbus dataoutput.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 120 (output data) of the link data output / Fieldbus data output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerData numbers of the link data output/Fieldbus data 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. (0: char, 1: TCHAR)
Dim data As String = Me.CoreRA1.LinkOutputData2(120, 0)
GetLinkOutputData (Reference: Details(p.66))
LinkOutputData (Reference: Details (p.88))
.NET Control Reference Manual89
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-41 LoadScene
Loads scene data.
FormatFunction LoadScene(ByVal sceneNo As Integer, ByVal fileName As String) AsInteger
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleLoad scene data into scene 2 and then change the scene to scene 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual91
92
8-5-42 LoadSceneGroup
Loads scene group data.
FormatFunction LoadSceneGroup(ByVal fileName As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionLoads the scene group data file specified in the <fileName> parameter.Specify the file name by absolute path in the <fileName> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleLoad the scene group data and then change the scene used to scene 0.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-43 LoadSystemData
Loads system data.
FormatFunction LoadSystemData(ByVal fileName As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionLoads the system data file specified in the <fileName> parameter.Specify the file name by absolute path in the <fileName> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleLoad system data and then execute "Save data". Restart the sensor to apply the loaded settings.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual93
94
8-5-44 Measure
Executes measurement processing.
FormatFunction Measure() As Integer
Parameter None.
Return value Error code (0: Normal, -1: Error)
DescriptionExecutes measurement processing.
Usage Cautions・ None.
ExampleExecutes measurement processing.
Supported VersionsVersion 1.91 or later
Related Items
Dim ret As Integer = Me.CoreRA1.Measure()
GetRunMode (Reference: Details (p.82)) ReMeasure (Reference: Details (p.117))SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGets the number of inspection items.
Supported VersionsVersion 1.91 or later
Related Items
Dim ret As Integer = Me.CoreRA1.MeasureItemCount()
MeasureItemIdent (Reference: Details (p.98)) PositionItemCount (Reference: Details (p.107))
PositionItemIdent (Reference: Details (p.109))
.NET Control Reference Manual95
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.
Usage Cautions・ None.
ExampleGet external reference data No. 0 (judgement) of inspection item No. 0 (search).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetMeasureItemData (Reference: Details (p.68))
MeasureItemData2 (Reference: Details (p.97))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 127 (error string) of inspection item No. 2 (bar code).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item to be 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 String = Me.CoreRA1.MeasureItemData2(2, 127, 0)
GetMeasureItemData (Reference: Details (p.68))
MeasureItemData (Reference: Details (p.96))
.NET Control Reference Manual97
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.
Usage Cautions・ None.
ExampleGet the identifier of the inspection item registered in item 1.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 31) of the inspection item
Dim ItemIdent As String = Me.CoreRA1.MeasureItemIdent(1)
MeasureItemCount (Reference: Details (p.95))
MeasureItemTitle (Reference: Details (p.100))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet the judgement result of inspection item No. 1.
Supported VersionsVersion 1.91 or later
Related Items
None
Parameter name Data type Description
<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)
.NET Control Reference Manual99
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGet the title of inspection item No. 1 (search).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
MeasureItemCount (Reference: Details (p.95))
MeasureItemTitle (Reference: Details (p.100))
SetMeasureItemData (Reference: Details (p.138))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 300 (data format) of no protocol data output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of no protocol data output (Reference:8-6 External Reference Parameters (p.163))
Dim data As Double = Me.CoreRA1.NoprotocolOutputData(300)
GetNoprotocolOutputData (Reference: Details (p.72))
NoprotocolOutputData2 (Reference: Details (p.102))
SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual101
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.
Usage Cautions・ None.
ExampleGet external reference data No. 120 (output data 0) of no protocol data output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of no protocol data 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. (0: char, 1: TCHAR)
Dim data As String = Me.CoreRA1.NoprotocolOutputData2(120, 0)
GetNoprotocolOutputData (Reference: Details (p.72))
NoprotocolOutputData (Reference: Details (p.101))
SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 300 (data format) of parallel data output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel data output (Reference: 8-6 External Reference Parameters (p.163))
Dim data As Double = Me.CoreRA1.ParallelData(300)
GetParallelData (Reference: Details (p.73)) ParallelData2 (Reference: Details (p.104))SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual103
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.
Usage Cautions・ None.
ExampleGet external reference data No. 150 (output data 0) of the parallel data output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel data 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. (0: char, 1: TCHAR)
Dim data As String = Me.CoreRA1.ParallelData2(150, 0)
GetParallelData (Reference: Details (p.73)) ParallelData (Reference: Details (p.103))SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 300 (judgement upper limit 0) of parallel judgement output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual105
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.
Usage Cautions・ None.
ExampleGet external reference data No. 150 (output data name 0) of parallel judgement output.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetParallelJudgeData (Reference: Details (p.74))
ParallelJudgeData (Reference: Details (p.105))
SetMeasureOut (Reference: Details (p.143))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGets the number of inspection items.
Supported VersionsVersion 1.91 or later
Related Items
Dim ret As Integer = Me.CoreRA1.PositionItemCount()
MeasureItemCount (Reference: Details (p.95))
PositionItemIdent (Reference: Details (p.109))
.NET Control Reference Manual107
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.
Usage Cautions・ None.
ExampleGet external reference data No. 0 (judgement) of image adjustment item No. 0 (color gray filter).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetPositionItemData (Reference: Details (p.78))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet the identifier of the image adjustment item registered in item 1.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 7) of the image adjustment item.
Dim ItemIdent As String = Me.CoreRA1.PositionItemIdent(1)
PositionItemCount (Reference: Details (p.107))
PositionItemTitle (Reference: Details (p.111))
.NET Control Reference Manual109
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.
Usage Cautions・ None.
ExampleGet the judgement result of image adjustment item No. 1.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
GetPositionItemData (Reference: Details (p.78))
.NET Control Reference Manual
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGet the title of image adjustment item No. 1.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
PositionItemCount (Reference: Details (p.107))
SetPositionItemData (Reference: Details (p.150))
.NET Control Reference Manual111
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
Return value Error code (0: Normal, -1: Error)
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
Usage Cautions・ This command is valid only in setup mode (IO monitor mode only).
ExampleSet all DO output statuses of parallel I/O to ON.
Parameter name Data type Description
<ioIdent> String Identifier of the communication module to be used (always "ParallelIo")
<state> Integer
Output status of terminalBIT0: DO0BIT1: DO1BIT2: DO2BIT3: DO3BIT4: DO4BIT5: DO5BIT6: DO6BIT7: DO7BIT8: DO8BIT9: DO9BIT10: DO10BIT11: DO11BIT12: DO12BIT13: DO13BIT14: DO14BIT15: DO15
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual113
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is valid only in setup mode (IO monitor mode only).
ExampleSet the DO3 output status of parallel I/O to ON.
Parameter name Data type Description
<ioIdent> String Identifier of the communication module to be used (always "ParallelIo")
<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)
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
Related Items
GetAll (Reference: Details (p.58)) GetPort (Reference: Details (p.76))PutAll (Reference: Details (p.112))
.NET Control Reference Manual115
116
8-5-64 RefreshImageWindow
Updates the image display window and text display window.
FormatFunction RefreshImageWindow() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
DescriptionUpdates the image display window and the text display window.
Usage Cautions・ None.
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.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual
8-5-65 ReMeasure
Executes remeasurement.
FormatFunction ReMeasure(ByVal preImageNo As Integer) As IntegerFunction ReMeasure(ByVal imagefileName As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleExecute remeasurement using the image of image logging number 0.
Execute remeasurement using the image with the specified file name.
Supported VersionsVersion 1.91 or later
Parameter name Data type Description
<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)
.NET Control Reference Manual117
118
Related Items
GetRunMode (Reference: Details (p.82)) Measure (Reference: Details (p.94))SetRunMode (Reference: Details (p.156))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet external reference data No. 121 (max count) of the retry data.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual119
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
Return value Error code (0: Normal, -1: Error)
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
ExampleSave all setting data in a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual121
122
8-5-69 SaveData
Saves all sensor setting data in the sensor.
FormatFunction SaveData() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
DescriptionSaves all sensor setting data in the sensor.
Usage Cautions・ This command is only valid in setup mode.
ExampleSave all setting data in the sensor.
Supported VersionsVersion 1.91 or later
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))
SaveSystemData (Reference: Details (p.127))
.NET Control Reference Manual
8-5-70 SaveImage
Saves image data.
FormatFunction SaveImage(ByVal preImageNo As Integer, ByVal fileName As String) AsInteger
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleSave the image with image logging number 0 to a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual123
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
ExampleSaves the measurement data that is saved by data logging in the sensor memory to a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-72 SaveScene
Saves scene data.
FormatFunction SaveScene(ByVal sceneNo As Integer, ByVal fileName As String) AsInteger
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
ExampleSave the scene data of scene 2 in a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SaveBackupData (Reference: Details (p.121))
SaveData (Reference: Details (p.122))
SaveSceneGroup (Reference: Details (p.126))
SaveSystemData (Reference: Details (p.127))
.NET Control Reference Manual125
126
8-5-73 SaveSceneGroup
Saves the scene group data.
FormatFunction SaveSceneGroup(ByVal fileName As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
ExampleSave the scene group data in a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SaveBackupData (Reference: Details (p.121))
SaveData (Reference: Details (p.122)) SaveScene (Reference: Details (p.125))SaveSystemData (Reference: Details (p.127))
.NET Control Reference Manual
8-5-74 SaveSystemData
Saves system data.
FormatFunction SaveSystemData(ByVal fileName As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ None.
ExampleSave the system data in a file.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
SaveData (Reference: Details (p.122))
SaveScene (Reference: Details (p.125)) SaveSceneGroup (Reference: Details (p.126))
.NET Control Reference Manual127
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.
Usage Cautions・ None.
ExampleGets the number of scenes that can be used.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual
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.
Usage Cautions・ None.
ExampleGet the scene number of the current scene. If the scene number is not 2, change to scene 2.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual129
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.
Usage Cautions・ None.
ExampleGet the title of scene 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<sceneNo> Integer Scene number (0 to 31)
Dim title As String = Me.CoreRA1.SceneTitle(2)
SetSceneTitle (Reference: Details (p.157))
.NET Control Reference Manual
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".
Usage Cautions・ None.
ExampleGets the sensor name.
Supported VersionsVersion 1.91 or later
Related Items
Dim title As String = Me.CoreRA1.SensorName()
SetSensorName (Reference: Details (p.158))
.NET Control Reference Manual131
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of the calculation (Reference: 8-6External Reference Parameters (p.163))
<data>IntegerDoubleString
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)
.NET Control Reference Manual
Set external reference data No. 150 (expression name 0) in the calculation data.
Supported VersionsVersion 1.91 or later
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))
.NET Control Reference Manual133
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleSet data in camera parameter No. 1 (shutter speed).
Set data in camera parameter No. 10 (white balance R scaling).
Supported VersionsVersion 1.91 or later
Parameter name Data type Description
<dataNo> Integer Camera parameter number
<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)
.NET Control Reference Manual
Related ItemsCameraData (Reference: Details (p.47)) GetCameraData (Reference: Details (p.63))
.NET Control Reference Manual135
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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
<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'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)
.NET Control Reference Manual
GetLinkOutputData (Reference: Details (p.66))
.NET Control Reference Manual137
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
Return value Error code (0: Normal, -1: Error)
DescriptionSets the data of an inspection item.Set the same data type for the <data> parameter as the data to be acquired.
Usage Cautions・ This command is only valid in setup mode.
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).
Parameter name Data type Description
<itemNo> Integer Item number (0 to 31) of the inspection item<dataNo> Integer External reference data number of the inspection item
<data>IntegerDoubleString
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 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)
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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)
GetMeasureItemData (Reference: Details (p.68))
.NET Control Reference Manual139
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
Return value Error code (0: Normal, -1: Error)
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).
Usage Cautions・ This command is only valid in setup mode.
ExampleSet the coordinates of the upper left corner of figure data No. 1 (region figure) of inspection itemNo. 1 (search) to (100, 50).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
.NET Control Reference Manual
GetMeasureItemData (Reference: Details (p.68))
GetMeasureItemFigure (Reference: Details (p.70))
.NET Control Reference Manual141
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleSet the title of inspection item No. 1 (search).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
MeasureItemCount (Reference: Details (p.95))
MeasureItemIdent (Reference: Details (p.98))
MeasureItemTitle (Reference: Details (p.100))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
DescriptionSets whether or not measurement results are output to an external device.
Usage Cautions・ None.
ExampleSets measurement result output to "enable".
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<mode> Integer Output yes/no (0: Yes, 1: No)
Dim ret As Integer = Me.CoreRA1.SetMeasureOut(1)
GetMeasureOut (Reference: Details (p.71))
.NET Control Reference Manual143
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of no protocol data output (Reference:8-6 External Reference Parameters (p.163))
<data> IntegerString 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 = 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)
.NET Control Reference Manual
GetNoprotocolOutputData (Reference: Details (p.72))
.NET Control Reference Manual145
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel data output (Reference: 8-6 External Reference Parameters (p.163))
<data> IntegerString 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 = 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)
.NET Control Reference Manual
GetParallelData (Reference: Details (p.73)) ParallelData (Reference: Details (p.103))
.NET Control Reference Manual147
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
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.
Parameter name Data type Description
<dataNo> IntegerExternal reference data number of parallel judgement output(Reference: 8-6 External Reference Parameters (p.163))
<data>IntegerDoubleString
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 = 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)
.NET Control Reference Manual
Supported VersionsVersion 1.91 or later
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)
GetParallelJudgeData (Reference: Details (p.74))
ParallelJudgeData (Reference: Details (p.105))
.NET Control Reference Manual149
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
Return value Error code (0: Normal, -1: Error)
DescriptionSets the data of an image adjustment item.Change the data type of the <data> parameter to the type of data to be set.
Usage Cautions・ This command is only valid in setup mode.
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).
Supported VersionsVersion 1.91 or later
Parameter name Data type Description
<itemNo> Integer Item number (0 to 7) of the image adjustment item.<dataNo> Integer External reference data number of the image adjustment item
<data> IntegerDouble Setting data
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)
.NET Control Reference Manual
Related Items
GetPositionItemData (Reference: Details (p.78))
PositionItemData (Reference: Details (p.108))
.NET Control Reference Manual151
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
Return value Error code (0: Normal, -1: Error)
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).
Usage Cautions・ This command is only valid in setup mode.
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).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
.NET Control Reference Manual
GetPositionItemFigure (Reference: Details (p.79))
.NET Control Reference Manual153
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
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleGet the title of image adjustment item No. 1 (position compensation).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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)
PositionItemCount (Reference: Details (p.107))
PositionItemIdent (Reference: Details (p.109))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
DescriptionSets retry data.Change the data type of the <data> parameter to the type of data to be set.
Usage Cautions・ This command is only valid in setup mode.
ExampleSet external reference data No. 121 (max count) of the retry.
Set external reference data No. 123 (shutter speed step) of the retry.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<dataNo> Integer External reference data number of retry
<data> IntegerDouble Setting data
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))
.NET Control Reference Manual155
156
8-5-93 SetRunMode
Sets the execution status (execution mode) of the FQ2 sensor.
FormatFunction SetRunMode(ByVal mode As Integer) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionSets the execution status (execution mode) of the FQ2 sensor.
Usage Cautions・ None.
Example Change the execution mode to setup mode.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
8-5-94 SetSceneTitle
Sets the title of a scene.
FormatFunction SetSceneTitle(ByVal sceneNo As Integer, ByVal sceneTitle As String) AsInteger
Parameter
Return value Error code (0: Normal, -1: Error)
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.
Usage Cautions・ This command is only valid in setup mode.
ExampleSet the title of scene 2.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual157
158
8-5-95 SetSensorName
Sets the sensor name.
FormatFunction SetSensorName(ByVal name As String) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionSets the FQ2 sensor name.
Usage Cautions・ This command is only valid in setup mode.
ExampleSets the sensor name.
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual
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
Return value Error code (0: Normal, -1: Error)
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))
Usage Cautions・ This command is only valid in setup mode.
ExampleSpecify 7 for the startup scene number that belongs to identification information 0 of"Configuration" and whose identification information 1 is "initialSceneNo".
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<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))
.NET Control Reference Manual159
160
8-5-97 SystemReset
Reboots the sensor.
FormatFunction SystemReset() As Integer
ParameterNone.
Return value Error code (0: Normal, -1: Error)
DescriptionReboots the sensor.
Usage Cautions・ None.
ExampleReboots the sensor.
Supported VersionsVersion 1.91 or later
Related Items
None
Dim ret As Integer = Me.CoreRA1.SystemReset()
.NET Control Reference Manual
8-5-98 TeachMeasureItem
Executes teaching for a specified inspection item.
FormatFunction TeachMeasureItem(ByVal itemNo As Integer) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionExecutes teaching for the inspection item specified in the <itemNo> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleExecute teaching for inspection item No. 1 (search).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 31) of the inspection item
Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.TeachMeasureItem(1)Me.CoreRA1.SetRunMode(1)
TeachPositionItem (Reference: Details (p.162))
.NET Control Reference Manual161
162
8-5-99 TeachPositionItem
Executes teaching for a specified image adjustment item.
FormatFunction TeachPositionItem(ByVal itemNo As Integer) As Integer
Parameter
Return value Error code (0: Normal, -1: Error)
DescriptionExecutes teaching for the image adjustment item specified in the <itemNo> parameter.
Usage Cautions・ This command is only valid in setup mode.
ExampleExecute teaching for image adjustment item No. 1 (shape search position compensation).
Supported VersionsVersion 1.91 or later
Related Items
Parameter name Data type Description
<itemNo> Integer Item number (0 to 7) of the image adjustment item.
Me.CoreRA1.SetRunMode(2)Dim ret As Integer = Me.CoreRA1.TeachPositionItem(1)Me.CoreRA1.SetRunMode(1)
TeachMeasureItem (Reference: Details (p.161))
.NET Control Reference Manual
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
Set/Get Integer 0 to 10 2
External referencenumber
Data name Set/Get Data type Data range Default
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
.NET Control Reference Manual163
164
No protocol data output
(N = 0 to 31)
Link data output / Fieldbus data output
(N = 0 to 15)
Parallel judgement output
External referencenumber
Data name Set/Get Data type Data range Default
120 + N Output dataN Set/Get String
(char) 255 characters Empty character string(“”)
200 + N Output dataname N Set/Get String
(TCHAR) 15 characters Empty character 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)
Set/Get Integer 0 to 10 4
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
External referencenumber
Data name Set/Get Data type Data range Default
103 Apply overalljudgement Set/Get Integer 0: Yes, 1: No 0
120 + N Output data N Set/Get String
(char) 255 characters Empty character string(“”)
200 + N Output data name N Set/Get String
(TCHAR) 15 characters Empty character string(“”)
307 Output format Set/Get Integer 0: Floating point
1: Fixed point 1
External referencenumber
Data name Set/Get Data type Data range Default
103 Apply overall judgement Set/Get Integer 0: Yes, 1: No 0
150 + N Output data N Set/Get String
(char) 255 characters Empty character string(“”)
.NET Control Reference Manual
(N = 0 to 15)
Parallel data output
(N = 0 to 31)
250 + N Output dataname N Set/Get String
(TCHAR) 15 characters Empty character 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
External referencenumber
Data name Set/Get Data type Data range Default
150 + N Output data N Set/Get String
(char) 255 characters Empty character string(“”)
250 + N Output data name N Set/Get String
(TCHAR) 15 characters Empty character string(“”)
300 Output format Set/Get Integer 0: Binary
1: BCD 0
400 Data output Set/Get Integer 0: No, 1: Yes 1
External referencenumber
Data name Set/Get Data type Data range Default
.NET Control Reference Manual165
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