NDT Remote Control Library. User s Manual

Transcription

1 NDT Remote Control Library User s Manual Software Version 2.6 DMTA EN [U ] Revision A October 2012

2 Olympus NDT, 48 Woerd Avenue, Waltham, MA 02453, USA 2012 Olympus NDT, Inc. All rights reserved. No part of this publication may be reproduced, translated, or distributed without the express written permission of Olympus NDT, Inc. This document was prepared with particular attention to usage to ensure the accuracy of the information contained therein, and corresponds to the version of the product manufactured prior to the date appearing on the title page. There could, however, be some differences between the manual and the product if the product was modified thereafter. The information contained in this document is subject to change without notice. Software version 2.6 Part number: DMTA EN [U ] Revision A October 2012 Printed in Canada All brands are trademarks or registered trademarks of their respective owners and third party entities.

3 Table of Contents Important Information Please Read Before Use... 1 Intended Use... 1 Safety Symbols... 1 Safety Signal Words... 2 Note Signal Words... 2 Warranty Information... 4 Technical Support... 4 Introduction Installation System Requirements Finding the Version Number of the NDT Remote Control Library Installing the NDT Remote Control Library Component Installing the NDT Remote Control Library Component Under Windows XP Installing the NDT Remote Control Library Component Under Windows Modifying Elements to Control Computer and Software Configuration Configuring Computers Under Windows XP Configuring Computers for Remote Controlling TomoView Under Windows XP Configuring a Computer for Remote Controlling OmniScan ix Instruments Under Windows XP Configuring TomoView for Remote Control Under Windows XP Configuring Computers Under Windows Table of Contents iii

4 2.2.1 Configuring Computers for Remote Controlling TomoView Under Windows Configuring Computers for Remote Controlling an OmniScan ix Under Windows Configuring TomoView for Remote Control Under Windows Connecting to Hardware and/or Software Connecting the NDT Remote Control Library to TomoView Connecting the NDT Remote Control Library to a Local TomoView Connecting the NDT Remote Control Library to a Remote TomoView Connecting the NDT Remote Control Library to an OmniScan ix Application Examples The OmniScan ix Remote Control Application Using the OmniScan ix Remote Control Application OmniScan ix Remote Control Application Description The TomoView Remote Control Application Using the TomoView Remote Control Application TomoView Remote Control Application Description The Remote Online Data Application Using the Remote Online Data Application Remote Online Data Application Description The TomoView Embedding Application Using the TomoView Embedding Application TomoView Embedding Application Description Organization Program Commands Units Description Commands for TomoView and OmniScan ix Remote Control INDTInspectionSystems INDTInspectionSystem INDTRemoteControl IFileControl INDTDocuments INDTDocument IAnalysisControl ICursors2D ICursor2D iv Table of Contents

5 ICursorPosition IIndicationBoxes IIndicationBox IArea ICursorPosition IDataSource IPanes IPane IReadings IReading IOnlineData IChannels IChannel IBeams (RDTiffDefinition) IBeams (NDTRemoteControlsSettings) IBeam (RDTiffDefinition) IBeam (NDTRemoteControlsSettings) IGates (RDTiffDefinition) IGates (NDTRemoteControlsSettings) IGate (RDTiffDefinition) IGate (NDTRemoteControlsSettings) IDataGroups IDataManager IDataGroup IDataAccess IPartParameters IFilterSettings IDataGroup IInspectionControl IAutoNaming IUserInterfaceControl IUserMenu ICorePanel IGeneralSettings ISystemUnit IOnlineSettings ISequences ISequence IAxis IEncoder IUltrasoundSettingsCollection IUltrasoundSettings Table of Contents v

6 IUltrasoundChannels IUltrasoundChannel IPulserReceiver IUltrasoundChannelPA IPositionOrientation ITimeBase ISoundVelocity IDACPoints IDACPoint IElements IElement IUltrasoundChannelMono IDataSettings IAscan ICscan IFilter IPodElementConfig ICustomControls ICustomControl TomoViewActiveX Commands for OmniScan ix Remote Control IOmniscan IOmniscanOnlineData IOnlineDataAccess Commands for Events Monitoring IInspectionControlEvents INDTRemoteControlEvents IOnlineDataEvents IUserInterfaceControlEvents Commands for OmniScan EC Remote Control IOmniscan IOnlineDataEC IGroups IGroup IDataGroups IDataGroup IDataAccess IDataGroupParam IPatchParam IInspectionControl (IInspectionControlEC) Custom Controls Applying Settings vi Table of Contents

7 7. Notification IInspectionControlEvents INDTRemoteControlEvents IUserInterfaceControlEvents IOnlineDataEvents Reading Online Data Troubleshooting Troubleshooting First Steps Hardware Key Connection to TomoView Custom Control TomoView Ultrasound Settings Access Connection to OmniScan Contacting Technical Support Appendix A: Establishing Connection Appendix B: Reading Online Data Example List of Figures List of Tables Index Table of Contents vii

8 viii Table of Contents

9 Important Information Please Read Before Use Intended Use The NDT Remote Control Library is designed to perform nondestructive inspections on industrial and commercial materials. Safety Symbols The following safety symbols might appear on the instrument and in the instruction manual: General warning symbol: This symbol is used to alert the user to potential hazards. All safety messages that follow this symbol shall be obeyed to avoid possible harm. High voltage warning symbol: This symbol is used to alert the user to potential electric shock hazards greater than 1000 volts. All safety messages that follow this symbol shall be obeyed to avoid possible harm. Important Information Please Read Before Use 1

10 Safety Signal Words The following safety symbols might appear in the documentation of the instrument: The DANGER signal word indicates an imminently hazardous situation. It calls attention to a procedure, practice, or the like, which, if not correctly performed or adhered to, could result in death or serious personal injury. Do not proceed beyond a DANGER signal word until the indicated conditions are fully understood and met. The WARNING signal word indicates a potentially hazardous situation. It calls attention to a procedure, practice, or the like, which, if not correctly performed or adhered to, could result in death or serious personal injury. Do not proceed beyond a WARNING signal word until the indicated conditions are fully understood and met. The CAUTION signal word indicates a potentially hazardous situation. It calls attention to an operating procedure, practice, or the like, which, if not correctly performed or adhered to, could result in minor or moderate personal injury, material damage, particularly to the product, destruction of part or all of the product, or loss of data. Do not proceed beyond a CAUTION signal word until the indicated conditions are fully understood and met. Note Signal Words The following safety symbols could appear in the documentation of the instrument: The IMPORTANT signal word calls attention to a note that provides important information, or information essential to the completion of a task. 2 Important Information Please Read Before Use

11 The NOTE signal word calls attention to an operating procedure, practice, or the like, which requires special attention. A note also denotes related parenthetical information that is useful, but not imperative. The TIP signal word calls attention to a type of note that helps you apply the techniques and procedures described in the manual to your specific needs, or provides hints on how to effectively use the capabilities of the product. Important Information Please Read Before Use 3

12 Warranty Information Olympus guarantees your Olympus product to be free from defects in materials and workmanship for a specific period, and in accordance with conditions specified in the Olympus NDT Terms and Conditions available at The Olympus warranty only covers equipment that has been used in a proper manner, as described in this instruction manual, and that has not been subjected to excessive abuse, attempted unauthorized repair, or modification. Inspect materials thoroughly on receipt for evidence of external or internal damage that might have occurred during shipment. Immediately notify the carrier making the delivery of any damage, because the carrier is normally liable for damage during shipment. Retain packing materials, waybills, and other shipping documentation needed in order to file a damage claim. After notifying the carrier, contact Olympus for assistance with the damage claim and equipment replacement, if necessary. This instruction manual explains the proper operation of your Olympus product. The information contained herein is intended solely as a teaching aid, and shall not be used in any particular application without independent testing and/or verification by the operator or the supervisor. Such independent verification of procedures becomes increasingly important as the criticality of the application increases. For this reason, Olympus makes no warranty, expressed or implied, that the techniques, examples, or procedures described herein are consistent with industry standards, nor that they meet the requirements of any particular application. Olympus reserves the right to modify any product without incurring the responsibility for modifying previously manufactured products. Technical Support Olympus is firmly committed to providing the highest level of customer service and product support. If you experience any difficulties when using our product, or if it fails to operate as described in the documentation, first consult the user s manual, and then, if you are still in need of assistance, contact our After-Sales Service. To locate the nearest service center, visit the Service Centers page at: 4 Important Information Please Read Before Use

13 Introduction The NDT Remote Control Library is a COM component designed to help create custom applications that can be used to control one or more workstations equipped with TomoView or an OmniScan ix, to integrate TomoView and OmniScan ix technologies inside a custom built interface and control automated inspection using in-house mechanics. The OmniScan MX2 instrument with an EC module can be controlled using the NDT Remote Control Library, providing the MXE software version 2.2 or higher is installed. In order to make it easier to create applications, complete sample programs are provided along with the corresponding source code the sample programs provide a ready-to-use starting point from where to build dedicated applications. These samples purpose is to provide a solid basis for the most common types of applications, which can be narrowed down to the four following categories: TomoView integration applications Remotely controlling the TomoView software, which in turn is used to control the inspection sequence and data processing functionalities. OmniScan ix integration applications Remotely controlling the OmniScan ix along with the inspection sequence. Online data applications extracting data and monitoring TomoView/OmniScan ix in real time, in order to create a live data display application. TomoView window embedding applications Integrating TomoView components inside an external program to create a customized application with TomoView operating in the background. Considering that these libraries were designed to be used in C++, C#, Visual Basic, and LabVIEW programing environments, the samples provided were developed using these four languages, and are further detailed in section 4 on page 103. Introduction 5

14 In the last section of this manual, a complete listing of the functionalities that can be used is given along with a description of each available element. A certain level of knowledge and familiarity with non-destructive testing (NDT) using ultrasounds is required to be able to use the NDT Remote Control Library. The NDT Remote Control Library commands are documented in detail in the NDT Remote Control documentation, which is provided as an online help document, located at the following access path: [Installation Drive Name]:\OlympusNDT\NDTRemoteControlLibrary26\Manual For more information on non-destructive ultrasonic testing, please refer to the following manuals from the Advanced Practical NDT Series collection, available for free as downloadable PDF files at Introduction to Phased Array Ultrasonic Technology Applications Advances in Phased Array Ultrasonic Technology Applications 6 Introduction

15 1. Installation The first step for using the NDT Remote Control Library is to install the NDT Remote Control Library component. Make sure you follow the instructions below before installing the NDT Remote Control Library component. Failure to do so may cause malfunction of the component and reception of error messages. Before installing the component, you must determine whether the elements you want to control are installed locally or remotely. For example, if you want to control computers equipped with TomoView, you must have the IP addresses of the computers before you start the installation. You must make sure that your network is properly configured and that the remote units (computers or OmniScan ix units) are communicating with each other without problems. The computer on which the NDT Remote Control Library component is to be installed must be equipped with a hardware key configured for the NDT Remote Control Library. The computer on which TomoView is to be installed must be equipped with a hardware key configured for TomoView. The computer on which both the NDT Remote Control Library component and TomoView are to be installed must be equipped with a hardware key configured for both the NDT Remote Control Library and TomoView. Installation 7

16 1.1 System Requirements To install and run the NDT Remote Control Library, you need the following: Personal computer with a Pentium Pro III processor of 800 MHz or higher 512 MB of RAM or more Minimum free hard disk space: 1.03 GB, plus two times the size of the biggest data file to be handled Video adapter that supports a minimum of 256 colors, with a resolution of 1024x768pixels Ethernet card and connection Operating system: Microsoft Windows 7 Microsoft Windows Vista Microsoft Windows XP Professional (Service Pack 2 or higher) The recommended configuration includes: Personal computer with Pentium processor of 1.4 GHz 1 GB of RAM (less RAM may result in limitations when attempting to perform operations on data files of 500 MB and more) 40 GB of free hard disk for data storage 1.2 Finding the Version Number of the NDT Remote Control Library In the case that the NDT Remote Control Library component has already been installed on your computer, you must find its version number in order to decide whether it should be updated. To find the version number of the NDT Remote Control Library under Windows XP 1. On the Windows taskbar, click START, and then click Control Panel. 2. Double-click Add or Remove Programs. The Add or Remove Programs window is displayed. 3. Scroll down to Olympus NDT Remote Control Library [version number]. The number displayed at the end of the name of the software indicates the current software version (see Figure 1-1 on page 9). 8 Chapter 1

17 Figure 1-1 Finding the version number of the NDT Remote Control Library under Windows XP using the Add or Remove Programs window To find the version number of the NDT Remote Control Library under Windows 7 1. On the Windows taskbar, click START, and then click Control Panel. 2. Under Programs, click Uninstall a program. The Uninstall or change a program panel is displayed. 3. Scroll down to Olympus NDT Remote Control Library [version number]. The number displayed at the end of the name of the software indicates the current software version (see Figure 1-2 on page 9). Figure 1-2 Finding the version number of the NDT Remote Control Library under Windows 7 using the Add or Remove Programs window Installation 9

18 1.3 Installing the NDT Remote Control Library Component This section presents the NDT Remote Control Library component installation procedure for Windows XP and Windows Installing the NDT Remote Control Library Component Under Windows XP This section presents the NDT Remote Control Library component installation procedure for Windows XP. To install the NDT Remote Control Library component under Windows XP 1. On the Olympus NDT Web site at find the installer for the NDT Remote Control Library software. The installer should be available in the TomoView section. It can also be found on the installation DVD provided with Olympus instruments. On the Olympus NDT website, you can find the most recent version of the NDT Remote Control Library component installer. 2. Double-click the InstallNDTRemoteControlLibrary-[version].exe. The installation wizard appears. 3. On the Software Licence Agreement page of the installation wizard, click I agree (see Figure 1-3 on page 11). 10 Chapter 1

19 Figure 1-3 The Software Agreement page 4. On the Welcome page of the installation wizard, click Next (see Figure 1-4 on page 11). Figure 1-4 The Welcome page Installation 11

20 5. On the Select Destination Directory page, under Destination drive, select the folder where you wish to install the component, and then click Next (see Figure 1-5 on page 12). By default, your computer s system drive is selected. Figure 1-5 The Select Destination Directory page 6. On the Start Installation page, click Next (see Figure 1-6 on page 12). Figure 1-6 The Start Installation page 12 Chapter 1

21 The Installing page appears (see Figure 1-7 on page 13). Figure 1-7 The Installing page Once the files have been installed, the Configuration Manager page appears. 7. On the Configuration Manager page, in the lists under Device (the topmost being selected by default), select the elements (TomoView software or OmniScan ix instrument) that are to be controlled (see Figure 1-8 on page 13). Figure 1-8 The Configuration Manager page Installation 13

22 In the text boxes under IP Address, type the IP address of each of the elements you want to control: For an OmniScan, type the OmniScan instrument s IP address. For TomoView, type the IP address of the computer on which TomoView is installed. When TomoView is installed on the same computer as the NDT Remote Control Library, you do not need to specify the IP address. You can control up to three elements at a time in any combination (see Figure 1-9 on page 14). Figure 1-9 Selecting elements to control 8. Click Apply to save the elements to control and their IP addresses. Note that the elements to be controlled by the NDT Remote Control Library and their IP addresses can be modified later using the Configuration Manager. For more information, see Section 1.4 on page Chapter 1

23 9. On the Installation Complete page, under Computer configuration, select the appropriate option (see Figure 1-10 on page 15). Figure 1-10 The Installation Complete page Perform automatic configuration: this option is selected by default. When selected, configuration of the Windows security settings to enable remote control of OmniScan ix and TomoView software is completed automatically during the final phase of installation. Skip automatic configuration: select this option to cancel configuration of the Windows security settings. The configuration of the Windows security settings to enable remote control of OmniScan ix and TomoView software can be modified later or completed separately. For more information, see chapter 2 on page On the Installation Complete page, click Finish. The NDT Remote Control Library component is now installed. You can find the files on the drive you have selected, in the OlympusNDT folder (see Figure 1-11 on page 16) and in the Common Files folder (see Figure 1-12 on page 16). Installation 15

24 Figure 1-11 The path to the NDTRemoteControlLibrary26 folder Figure 1-12 The path to the remote control library files Installing the NDT Remote Control Library Component Under Windows 7 This section presents the NDT Remote Control Library component installation procedure under Windows Chapter 1

25 To install the NDT Remote Control Library component under Windows 7 1. On the Olympus NDT Web site at find the installer for the NDT Remote Control Library software. The installer should be available in the TomoView section. It can also be found on the installation DVD provided with Olympus instruments. On the Olympus NDT website, you can find the most recent version of the NDT Remote Control Library component installer. 2. Double-click the InstallNDTRemoteControlLibrary-[version].exe. The installation wizard appears. 3. On the Software Licence Agreement page of the installation wizard, click I agree (see Figure 1-13 on page 17). Figure 1-13 The Software Agreement page 4. On the Welcome page of the installation wizard, click Next (see Figure 1-14 on page 18). Installation 17

26 Figure 1-14 The Welcome page 5. On the Select Destination Directory page, under Destination drive, select the folder where you wish to install the component, and then click Next (see Figure 1-15 on page 18). By default, your computer s system drive is selected. Figure 1-15 The Select Destination Directory page 18 Chapter 1

27 6. On the Start Installation page, click Next (see Figure 1-16 on page 19). Figure 1-16 The Start Installation page The Installing page appears (see Figure 1-17 on page 19). Once the files have been installed, the Configuration Manager page appears. Figure 1-17 The Installing page Installation 19

28 7. On the Configuration Manager page, in the lists under Device (which is selected by default), select the elements (TomoView software or OmniScan ix instrument) that are to be controlled (see Figure 1-18 on page 20). Figure 1-18 The Configuration Manager page In the text boxes under IP Address, type the IP address of each of the elements you want to control. For an OmniScan ix, type the OmniScan IP address. For TomoView, type the IP address of the computer on which TomoView is installed. If TomoView is installed on the same computer as the NDT Remote Control Library, you do not need to specify the IP address. You can control up to three elements at a time in any combination (see Figure 1-19 on page 21). 20 Chapter 1

29 Figure 1-19 Selecting elements to control 8. Click Apply to save the elements to control and their IP addresses. Note that the elements to be controlled by the NDT Remote Control Library and their IP addresses can be modified later using the Configuration Manager. For more information, see section 1.4 on page On the Installation Complete page, under Computer configuration, select the appropriate option (see Figure 1-20 on page 22). Installation 21

30 Figure 1-20 The Installation Complete page Perform automatic configuration: this option is selected by default. When selected, configuration of the Windows security settings to enable remote control of OmniScan ix and TomoView software is completed automatically during the final phase of installation. Skip automatic configuration: select this option to cancel configuration of the Windows security settings. Configuration of the Windows security settings to enable remote control of OmniScan ix and TomoView software can be modified later or completed separately. For more information, see Chapter 2 on page Click Finish. The NDT Remote Control Library component is now installed. You can find the files on the drive you have selected, in the OlympusNDT folder (see Figure 1-21 on page 23) and in the Common Files folder (see Figure 1-22 on page 23). 22 Chapter 1

31 Figure 1-21 The path to the NDTRemoteControlLibrary26 folder Figure 1-22 The path to the remote control library files 1.4 Modifying Elements to Control Once the NDT Remote Control Library component has been installed, you can modify which elements are to be controlled by using the Configuration Manager, which can be found at the following access path: [Installation Drive Name]:\OlympusNDT\ NDTRemoteControlLibrary26\Configuration Manager (Figure 1-23 on page 24). Installation 23

32 Figure 1-23 The path to the Configuration Manager From the Configuration Manager, you can change the elements to be controlled (TomoView software and OmniScan ix instrument), and add or modify IP addresses. To modify elements to control 1. Double-click the NDTRC [version number] Manager.exe. The Configuration Manager page appears (see Figure 1-24 on page 24). Figure 1-24 The Select Hardware page 24 Chapter 1

33 2. On the Configuration Manager page, in the lists under Device (which is selected by default), select the elements that are to be controlled (see Figure 1-24 on page 24). In the text boxes under IP Address, type the IP address of each of the elements you want to control. For an OmniScan, type the OmniScan IP address. For TomoView, type the IP address of the computer on which TomoView is installed. If TomoView is installed on the same computer as the NDT Remote Control Library, you do not need to specify an IP address. You can control up to three elements at a time in any combination (see Figure 1-25 on page 25). Figure 1-25 Selecting elements to control 3. Click Apply to save the elements to control and their IP addresses. Installation 25

34 26 Chapter 1

35 2. Computer and Software Configuration This chapter presents the configuration that must be done on all computers used for the remote control application and in TomoView software to prevent any messages from appearing at startup. Configuration of the computers and of the TomoView software can also be performed automatically during the installation procedure of the remote control application. The appropriate procedures are provided for configuring, under Windows XP and Windows 7, all computers that use Microsoft Distributed Component Object Model (DCOM) technology to allow communication between them. These procedures are not compulsory. You may use your own configurations if you have any already defined. Make sure that the file sharing function is activated and that file sharing validation has been performed for all the computers (see Figure 2-1 on page 28). Computer and Software Configuration 27

36 Figure 2-1 The network connection Properties dialog box Make sure that the IP address of the network connection using the OmniScan ix is properly configured (see Figure 2-2 on page 29). 28 Chapter 2

37 Figure 2-2 The Internet Protocol (TCP/IP) Properties dialog box For the configuration procedure for TomoView software, refer to Section on page 29. For an OmniScan ix instrument, refer to Section on page Configuring Computers Under Windows XP Under Windows XP, computers can be configured for remote controlling the TomoView software application or OmniScan ix instruments using the NDT Remote Control Library Configuring Computers for Remote Controlling TomoView Under Windows XP This section presents the configuration procedure for computers with TomoView that will be controlled with the NDT Remote Control Library. Computer and Software Configuration 29

38 To configure computers for TomoView Under Windows XP 1. Before installing TomoView, on all computers used for the application, create a common user (with the same password) with administrator rights. 2. Install TomoView on all the computers that will be controlled with the NDT Remote Control Library (refer to the TomoView Installation Procedure document). From this point on, the procedure only has to be performed for computers on which TomoView has been installed and that are remotely controlled by NDT Remote Control Library. 3. On the Windows taskbar, click Start and then, in the Start menu, click Run. 4. On the Run dialog box, type dcomcnfg, and then click OK (see Figure 2-3 on page 30). Figure 2-3 The Run dialog box 5. On the Component Services window (see Figure 2-4 on page 31): a) Click the plus button next to Component Services. b) Click the plus button next to Computers, and then right-click My Computer. c) On the contextual menu, click Properties. 30 Chapter 2

39 Figure 2-4 The Component Services window Computer and Software Configuration 31

40 6. On the My Computer Properties dialog box (see Figure 2-5 on page 32): a) Click the Default Properties tab. b) Select the Enable Distributed COM on this computer check box. c) In the Default Authentication Level list, select Connect. d) In the Default Impersonation Level list, select Identify, and then click Apply. Figure 2-5 The Default Properties tab of the My Computer Properties dialog box 7. On the My Computer Properties dialog box (see Figure 2-6 on page 33): a) Click the COM Security tab. b) In the Access Permissions group box, click Edit Limits. 32 Chapter 2

41 Figure 2-6 The COM Security tab of the My Computer Properties dialog box 8. On the Access Permission dialog box (see Figure 2-7 on page 34): a) In the Group or user names list, click Everyone. b) Make sure that the Local Access and Remote Access Allow check boxes are selected. c) In the Group or user names list, click ANONYMOUS LOGON. d) Select the Local Access and Remote Access Allow check boxes. e) Click OK. Computer and Software Configuration 33

42 Figure 2-7 The Access Permission dialog box 9. On the My Computer Properties dialog box, select the COM Security tab, and then, in the Launch and Activation Permissions group box, click Edit Limits (see Figure 2-8 on page 35). 34 Chapter 2

43 Figure 2-8 Back to the My Computer Properties dialog box 10. On the Launch Permissions dialog box (see Figure 2-9 on page 36): a) In the Group or user names list, click Everyone. b) Under Allow, make sure that Local Launch, Remote Launch, Local Activation, and Remote Activation, check boxes are selected. c) Click OK. Computer and Software Configuration 35

44 Figure 2-9 The Launch Permission dialog box 11. On the COM Security tab of the My Computer Properties dialog box, in the Access Permissions group box, click Edit Default (see Figure 2-10 on page 37). 36 Chapter 2

45 Figure 2-10 The Edit Default button in the Access Permission group box 12. On the Access Permission dialog box, click Add (see Figure 2-11 on page 38). Computer and Software Configuration 37

46 Figure 2-11 The Group or user names group box of the Access Permission dialog box 13. In the Select Users or Groups dialog box, in the Enter the object names to select box, type Everyone, and then click OK (see Figure 2-12 on page 38). Figure 2-12 The Select Users or Groups dialog box 14. Back in the Access Permission dialog box, the name appears in the Group or user names list (see Figure 2-13 on page 39). In the Permissions for Everyone list, select the Allow check boxes for Local Access and Remote Access. 38 Chapter 2

47 Figure 2-13 The new name in the Group or user names list 15. Click OK. 16. On the COM Security tab of the My Computer Properties dialog box, in the Launch Permissions group box, click Edit Default (see Figure 2-14 on page 40). Computer and Software Configuration 39

48 Figure 2-14 The Edit Default button in the Launch and Activation Permission group box 17. In the Launch Permission dialog box, click Add (see Figure 2-15 on page 41). 40 Chapter 2

49 Figure 2-15 The Launch Permission dialog box 18. On the Select Users or Groups dialog box, in the Enter the object names to select box, type Everyone, and then click OK (see Figure 2-16 on page 41). Figure 2-16 The Select Users or Groups dialog box Computer and Software Configuration 41

50 19. In the Launch Permissions dialog box, the name appears in the Group or user names list (see Figure 2-17 on page 42). In the Permissions for Everyone list, under Allow, select the check boxes for Local Launch, Remote Launch, Local Activation, and Remote Activation. Figure 2-17 The new name in the Group or user names list 20. Click OK. 21. In the My Computer Properties dialog box, click Apply, and then click OK (see Figure 2-18 on page 43). 42 Chapter 2

51 Figure 2-18 The My Computer Properties dialog box 22. In the Component Services window (see Figure 2-19 on page 44): a) Expand the My Computer folder, and then click the DCOM Config folder. b) On the DCOM Config pane, right-click the Olympus NDT TomoView component, and then, on the shortcut menu, click Properties. Computer and Software Configuration 43

52 Figure 2-19 The Component Services window 23. In the Olympus NDT TomoView Properties dialog box (see Figure 2-20 on page 45): a) Click the Security tab. b) In the Launch and Activation Permissions and Access Permissions group boxes, select the Use Default option. c) Click Apply. 44 Chapter 2

53 Figure 2-20 The Security tab of the Olympus NDT TomoView Properties dialog box 24. In the Olympus NDT TomoView Properties dialog box (see Figure 2-21 on page 46): a) Click the Identity tab. b) Select the The interactive user option. c) Click Apply, and then click OK. Computer and Software Configuration 45

54 Figure 2-21 The Identity tab of the Olympus NDT TomoView Properties dialog box 25. Close the Component Services dialog box Configuring a Computer for Remote Controlling OmniScan ix Instruments Under Windows XP This section presents the configuration procedure for computers that will remote control OmniScan ix instruments with the NDT Remote Control Library. To configure a computer for OmniScan ix instruments under Windows XP 1. On the Windows taskbar, click Start, and then, in the Start menu, click Run. 2. In the Run dialog box, type dcomcnfg, and then click OK (see Figure 2-22 on page 47). 46 Chapter 2

55 Figure 2-22 The Run dialog box 3. In the Component Services window (see Figure 2-23 on page 47): a) Expand Component Services. b) Expand Computers, and then right-click My Computer. c) On the contextual menu, click Properties. Figure 2-23 The Component Services window Computer and Software Configuration 47

56 4. In the My Computer Properties dialog box (see Figure 2-24 on page 48): a) Click the Default Properties tab. b) Select the Enable Distributed COM on this computer check box. c) In the Default Authentication Level list, select Connect. d) In the Default Impersonation Level list, select Identify, and then click Apply. Figure 2-24 The Default Properties tab of the My Computer Properties dialog box 5. In the My Computer Properties dialog box (see Figure 2-25 on page 49): a) Click the COM Security tab. b) In the Access Permissions group box, click Edit Limits. 48 Chapter 2

57 Figure 2-25 The COM Security tab of the My Computer Properties dialog box 6. In the Access Permission dialog box (see Figure 2-26 on page 50): a) In the Group or user names list, click Everyone. b) Under Allow, make sure that Local Access and Remote Access Allow check boxes are selected. c) In the Group or user names list, click ANONYMOUS LOGON. d) Under Allow, select the Local Access and Remote Access Allow check boxes. e) Click OK. Computer and Software Configuration 49

58 Figure 2-26 The Access Permission dialog box Configuring TomoView for Remote Control Under Windows XP This section presents the TomoView software configuration procedure for remote control. Before executing this procedure, make sure that you have started and closed TomoView at least once. Perform this procedure for all instances where TomoView is installed to prevent any dialog boxes from appearing at the TomoView startup. To configure TomoView under Windows XP 1. On the Windows taskbar, click Start. 2. On the Start menu, click Run. 3. On the Run dialog box, type regedit, and then click OK (see Figure 2-27 on page 51). 50 Chapter 2

59 Figure 2-27 The Run dialog box 4. In the Registry Editor window (see Figure 2-28 on page 51): a) Expand the HKEY_CURRENT_USER folder. b) Expand the Software folder. Figure 2-28 The Registry Editor window c) Under the Software folder, Expand the OlympusNDT folders Figure 2-29 on page 52). d) Expand the TomoView [version] folder. e) Click the DEFAULT folder to open it. Computer and Software Configuration 51

60 Figure 2-29 The files to modify in the DEFAULT folder 5. Change the binary values as follows: a) Double-click the AUTO_SELECT_POD file. The Edit DWORD Value dialog box for that file appears (see Figure 2-30 on page 52). Figure 2-30 The Edit DWORD Value dialog box for the AUTO_SELECT_POD file b) In the Value data box, type 1, and then click OK. This will allow the software to detect the acquisition unit automatically; therefore, the Select POD Configuration to Use dialog box will not open. c) Double-click the INIT_MODE file. The Edit DWORD Value dialog box for that file appears. d) In the Value data box, type 2, and then click OK. 52 Chapter 2

61 This selects the Open an existing configuration option in the Configuration Selection dialog box. e) Double-click the NO_WELCOME file. f) In the Value data box, type 1, and then click OK. The Configuration Selection dialog box will not open. The SHOW_USER_CONNECT_DLG value exists only if you have created more than one user in TomoView. If the installation user exists only in TomoView, the value is not created. 2.2 Configuring Computers Under Windows 7 Computers can be configured for remote controlling the TomoView software application or OmniScan ix instruments using the NDT Remote Control Library Configuring Computers for Remote Controlling TomoView Under Windows 7 This section presents the configuration procedure, under Windows 7, for computers with TomoView that will be controlled with the NDT Remote Control Library. To configure computers for TomoView Under Windows 7 1. Before installing TomoView, on all computers used for the application, create a common user (with the same password) with administrator rights. 2. Install TomoView on all the computers that will be controlled with the NDT Remote Control Library (please refer to the TomoView Software User s Manual). From this point on, the procedure only has to be performed for computers on which TomoView has been installed and that are remotely controlled by NDT Remote Control Library. 3. On the Windows taskbar, click Start, and then click Run. 4. In the Run dialog box, type dcomcnfg, and then click OK (see Figure 2-31 on page 54). Computer and Software Configuration 53

62 Figure 2-31 The Run dialog box 5. In the Component Services window (see Figure 2-32 on page 55): a) Expand the Component Services folder. b) Expand the Computers folder, right-click My Computer, and then click Properties on the shortcut menu. 54 Chapter 2

63 Figure 2-32 The Component Services window 6. In the My Computer Properties dialog box (see Figure 2-33 on page 56): a) Click the Default Properties tab. b) Select the Enable Distributed COM on this computer check box. c) In the Default Authentication Level list, select Connect. d) In the Default Impersonation Level list, select Identify, and then click Apply. Computer and Software Configuration 55

64 Figure 2-33 The Default Properties tab of the My Computer Properties dialog box e) Click the COM Security tab (see Figure 2-34 on page 57). f) Under Access Permissions, click Edit Limits. 56 Chapter 2

65 Figure 2-34 The COM Security tab of the My Computer Properties dialog box 7. In the Access Permission dialog box (see Figure 2-35 on page 58): a) Under Group or user names, click Everyone. b) In the Everyone list, under Allow, make sure that Local Access and Remote Access Allow check boxes are selected. c) Under Group or user names, click ANONYMOUS LOGON. d) In the ANONYMOUS LOGON list, under Allow, select the Local Access and Remote Access Allow check boxes. e) Click OK. Computer and Software Configuration 57

66 Figure 2-35 The Access Permission dialog box 8. In the My Computer Properties dialog box, select the COM Security tab, and then, under Launch and Activation Permissions, click Edit Limits (see Figure 2-36 on page 59). 58 Chapter 2

67 Figure 2-36 Back to the My Computer Properties dialog box 9. In the Launch Permissions dialog box (see Figure 2-37 on page 60): a) Under Group or user names, click Everyone. b) In the Permissions for Everyone list, under Allow, make sure that the Local Launch, Remote Launch, Local Activation, and Remote Activation, check boxes are selected. c) Click OK. Computer and Software Configuration 59

68 Figure 2-37 The Launch Permission dialog box 10. In the My Computer Properties dialog box, under Access Permissions on the COM Security tab, click Edit Default (see Figure 2-38 on page 61). 60 Chapter 2

69 Figure 2-38 The Edit Default button in the Access Permission group box 11. In the Access Permission dialog box, click Add (see Figure 2-39 on page 62). Computer and Software Configuration 61

70 Figure 2-39 The Group or user names group box of the Access Permission dialog box 12. In the Select Users or Groups dialog box, in the Enter the object names to select box, type Everyone, and then click OK (see Figure 2-40 on page 62). Figure 2-40 The Select Users or Groups dialog box In the Access Permission dialog box, the name appears under Group or user names (see Figure 2-41 on page 63). 62 Chapter 2

71 Figure 2-41 The new name in the Group or user names list 13. In the Permissions for Everyone list, under Allow, select the Local Access and Remote Access check boxes, and then click OK. 14. On the COM Security tab of the My Computer Properties dialog box, under Launch and Access Permissions, click Edit Default (see Figure 2-42 on page 64). Computer and Software Configuration 63

72 Figure 2-42 The Edit Default button in the Launch and Activation Permission group box 15. In the Launch Permission dialog box, click Add (see Figure 2-43 on page 65). 64 Chapter 2

73 Figure 2-43 The Launch Permission dialog box 16. In the Select Users, Computers, Service Accounts, or Groups dialog box, in the Enter the object names to select box, type Everyone, and then click OK (see Figure 2-44 on page 65). Figure 2-44 The Select Users, Computers, Service Accounts, or Groups dialog box In the Launch Permissions dialog box, the name appears in the Group or user names list (see Figure 2-45 on page 66). Computer and Software Configuration 65

74 Figure 2-45 The new name in the Group or user names list 17. In the Permissions for Everyone list, under Allow, select the check boxes for Local Launch, Remote Launch, Local Activation, and Remote Activation, and then click OK. 18. In the My Computer Properties dialog box, click Apply (see Figure 2-46 on page 67). 66 Chapter 2

75 Figure 2-46 The My Computer Properties dialog box 19. In the DCOM Machine wide settings dialog box, click Yes (see Figure 2-47 on page 67). Figure 2-47 The DCOM Machine wide settings dialog box 20. In the My Computer Properties dialog box, click OK (see Figure 2-48 on page 68). Computer and Software Configuration 67

76 Figure 2-48 The My Computer Properties dialog box 21. In the Component Services window (see Figure 2-49 on page 69): a) Expand the My Computer folder, and then click the DCOM Config folder. b) On the DCOM Config pane, right-click the Olympus NDT TomoView [version number] component, and then, on the shortcut menu, click Properties. 68 Chapter 2

77 Figure 2-49 The Component Services window 22. In the Olympus NDT TomoView Properties dialog box (see Figure 2-50 on page 70): a) Click the Security tab. b) Under Launch and Activation Permissions and Access Permissions, select the Use Default option, and then click Apply. Computer and Software Configuration 69

78 Figure 2-50 The Security tab of the Olympus NDT TomoView Properties dialog box c) Click the Identity tab (see Figure 2-51 on page 71). d) Select the The interactive user option, and then click OK. 70 Chapter 2

79 Figure 2-51 The Identity tab of the Olympus NDT TomoView Properties dialog box 23. Close the Component Services window Configuring Computers for Remote Controlling an OmniScan ix Under Windows 7 This section presents the configuration procedure for computers that will remote control OmniScan ix instruments with the NDT Remote Control Library. To configure computers for OmniScan ix under Windows 7 1. On the Windows taskbar, click Start, and then click Run. 2. In the Run dialog box, type dcomcnfg, and then click OK (see Figure 2-52 on page 72). Computer and Software Configuration 71

80 Figure 2-52 The Run dialog box 3. In the Component Services window (see Figure 2-53 on page 72): a) Expand the Component Services folder. b) Expand the Computers folder. c) Right-click the My Computer folder, and then, on the shortcut menu, click Properties. Figure 2-53 The Component Services window 72 Chapter 2

81 4. In the My Computer Properties dialog box (see Figure 2-54 on page 73): a) Click the Default Properties tab. b) Select the Enable Distributed COM on this computer check box. c) In the Default Authentication Level list, select Connect. d) In the Default Impersonation Level list, select Identify, and then click Apply. Figure 2-54 The Default Properties tab of the My Computer Properties dialog box e) Click the COM Security tab (see Figure 2-55 on page 74). f) In the Access Permissions group box, click Edit Limits. Computer and Software Configuration 73

82 Figure 2-55 The COM Security tab of the My Computer Properties dialog box 5. In the Access Permission dialog box (see Figure 2-56 on page 75): a) In the Group or user names list, click Everyone. b) In the Permissions for Everyone list, under Allow, make sure that Local Access and Remote Access Allow check boxes are selected. c) In the Group or user names list, click ANONYMOUS LOGON. d) In the Permissions for ANONYMOUS LOGON list, under Allow, select the Local Access and Remote Access Allow check boxes. e) Click OK. 74 Chapter 2

83 Figure 2-56 The Access Permission dialog box 6. On the My Computer Properties dialog box, click Apply (see Figure 2-57 on page 76). Computer and Software Configuration 75

84 Figure 2-57 The My Computer Properties dialog box 7. In the DCOM Machine wide settings dialog box, click Yes (see Figure 2-58 on page 76). Figure 2-58 The DCOM Machine wide settings dialog box 8. In the My Computer Properties dialog box, click OK (see Figure 2-58 on page 76). 76 Chapter 2

85 Figure 2-59 The My Computer Properties dialog box Configuring TomoView for Remote Control Under Windows 7 This section presents the TomoView software configuration procedure for remote control. Before performing this procedure, make sure that you have started and closed TomoView at least once. Perform this procedure for all instances where TomoView is installed to prevent any dialog boxes from appearing at the TomoView startup. To configure TomoView under Windows 7 1. On the Windows taskbar, click Start 2. In the Search programs and files box, type regedit, and then press the Enter key. OR a) Click All Programs, click Accessories, and then click Run. b) On the Run dialog box, type regedit, and then click OK (see Figure 2-60 on page 78). Computer and Software Configuration 77

86 Figure 2-60 The Run dialog box 3. In the Registry Editor window (see Figure 2-61 on page 78): a) Expand the HKEY_CURRENT_USER folder. b) Expand the Software folder. Figure 2-61 The Registry Editor window c) Under the Software folder, Expand the OlympusNDT folder (see Figure 2-62 on page 79). d) Expand the TomoView [version] folder. e) Click the DEFAULT folder to display its contents in the pane to the righthand side of the Registry Editor window. 78 Chapter 2

87 Figure 2-62 The files to modify in the DEFAULT folder 4. Change the binary values as follows: a) Double-click the AUTO_SELECT_POD file to open the Edit DWORD Value dialog box for that file (see Figure 2-63 on page 79). Figure 2-63 The Edit DWORD Value dialog box for the AUTO_SELECT_POD file b) In the Value data box, type 1 and click OK. This will allow the software to detect the acquisition unit automatically; therefore, the Select POD Configuration to Use dialog box will not open. c) Double-click the INIT_MODE file, type 2 in the Value data text box, and then click OK (see Figure 2-64 on page 80). Computer and Software Configuration 79

88 Figure 2-64 The Edit DWORD Value dialog box with the value 2 entered in the Value data box This selects the Open an existing configuration option in the Configuration Selection dialog box. d) Double-click the NO_WELCOME file, type 1 in the text box, and then click OK (see Figure 2-65 on page 80). Figure 2-65 The Edit DWORD Value dialog box with the value 2 entered in the Value data box The Configuration Selection dialog box will not open. The SHOW_USER_CONNECT_DLG value exists only if you created more than one user in TomoView. If the installation user exists only in TomoView, the value is not created. 80 Chapter 2

89 3. Connecting to Hardware and/or Software This chapter explains how to establish communication with the elements that you want to control in order to allow proper connection with the remote hardware and/or software. If you have selected more than one element to control, the order in which you have selected them determines the number assigned to each element. For example, if you have selected OmniScan, TomoView, TomoView, the item number will be: Item[1] for the OmniScan, Item[2] for the first computer equipped with TomoView, and Item[3] for the second computer equipped with TomoView. 3.1 Connecting the NDT Remote Control Library to TomoView This section describes how to connect the NDT Remote Control Library to a local or remote TomoView. Note that if you want to use TomoView to perform acquisitions, you will need to have a compatible acquisition unit connected to the computer and recognized by the BootP server on the computer on which TomoView is running. For more information on connecting an acquisition unit to TomoView, please refer to the TomoView user manual. Connecting to Hardware and/or Software 81

90 3.1.1 Connecting the NDT Remote Control Library to a Local TomoView This section describes how to connect the NDT Remote Control Library to TomoView installed on the same computer. To connect the NDT Remote Control Library to a Local TomoView 1. Open the Configuration Manager, which can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\ Configuration manager (see Figure 3-1 on page 82). Figure 3-1 The access path to the NDT Remote Control Library Configuration Manager 2. In the Configuration Manager dialog box, in the first list under Device (which is selected by default), select TomoView [version] and leave the IP Address box empty (see Figure 3-2 on page 83). 82 Chapter 3

91 Figure 3-2 The Configuration Manager dialog box 3. In the MFC_TomoView_2.exe sample program, click Connect. TomoView opens and can now be controlled remotely using the sample program through the NDT Remote Control Library (see Figure 3-3 on page 84). Connecting to Hardware and/or Software 83

92 Figure 3-3 The TomoView sample application window Connecting the NDT Remote Control Library to a Remote TomoView This section describes how to connect the NDT Remote Control Library to TomoView installed on a remote computer. To connect the NDT Remote Control Library to a Remote TomoView 1. Connect a crosslink Ethernet (RJ-45) cable category 5e or better to a network port on each one of the two computers. 2. On each computer, create a similar user with administrator privileges: Under Windows XP On the taskbar, click Start, click Control Panel, click User Accounts, and then click User Accounts. In the User Accounts dialog box, click Add. In the Add 84 Chapter 3

93 New User dialog box, enter a user name in the User name box and a domain name in the Domain box (see Figure 3-4 on page 85). Figure 3-4 Adding a user in the Add New User dialog box under Windows XP Select Other, set the access level to Administrator, and then click OK (see Figure 3-5 on page 85). Figure 3-5 Setting the access level of a user in the Add New User dialog box under Windows XP Connecting to Hardware and/or Software 85

94 Under Windows 7 On the taskbar, click Start, click Control Panel, click User Accounts, click User Accounts, and then click Manage User Accounts. In the User Accounts dialog box, click Add. In the Add New User dialog box, enter a user name in the User name box and a domain name in the Domain box (see Figure 3-6 on page 86). Figure 3-6 Adding a user in the Add New User dialog box under Windows 7 Select Other, select the Administrator access level, and then click OK (see Figure 3-7 on page 87). 86 Chapter 3

95 Figure 3-7 Setting the access level of a user in the Add New User dialog box under Windows 7 3. On the local computer, configure the network connection: Under Windows XP (1) On the taskbar, click Start, click Control Panel, click Network Connection, and then double-click on the connection used to communicate with the OmniScan ix. (2) In the [Connection Name] Properties dialog box that appears, select Internet Protocol (TCP/IP), and then click Properties (see Figure 3-8 on page 88). Connecting to Hardware and/or Software 87

96 Figure 3-8 The [Connection Name] Properties dialog box on the local computer under Windows XP (3) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address, type compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-9 on page 89). 88 Chapter 3

97 Figure 3-9 Configuring the internet protocol on the local computer using the Internet Protocol (TCP/IP) Properties dialog box under Windows XP Under Windows 7 (1) On the taskbar, click Start, click Control Panel, click Network and Internet, click Network and Sharing Center, and then click the connection used to establish the link with the OmniScan ix. (2) The [Connection Name] Status dialog box appears. Click Properties. In the [Connection Name] Properties dialog box that appears, select Internet Protocol Version 4 (TCP/IPv4), and then click Properties (see Figure 3-10 on page 90). Connecting to Hardware and/or Software 89

98 Figure 3-10 The [Connection Name] Properties dialog box on the local computer under Windows 7 (3) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address, type compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-11 on page 91). 90 Chapter 3

99 Figure 3-11 Configuring the internet protocol on the local computer using the Internet Protocol (TCP/IP) Properties dialog box under Windows 7 4. On the remote computer, configure the network connection: Under Windows XP (1) On the taskbar, click Start, click Control Panel, click Network Connection, and then double-click on the connection used to establish the link with the local computer. (2) In the [Connection Name] Properties dialog box that appears, select Internet Protocol (TCP/IP) and then click Properties (see Figure 3-12 on page 92). Connecting to Hardware and/or Software 91

100 Figure 3-12 The [Connection Name] Properties dialog box on the remote computer under Windows XP (3) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address. (4) Type compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-13 on page 93). On the remote computer, set the IP address to a value which is in the same range as the local computer (the same first three blocks) but not identical to the IP address of the computer (for example, and ). 92 Chapter 3

101 Figure 3-13 Configuring the internet protocol on the remote computer using the Internet Protocol (TCP/IP) Properties dialog box under Windows XP Under Windows 7 (1) On the taskbar, click Start, click Control Panel, click Network and Internet, click Network and Sharing Center, and then click the connection used to establish the link with the OmniScan ix. The [Connection Name] Status dialog box appears. (2) Click Properties. (3) In the [Connection Name] Properties dialog box that appears, select Internet Protocol Version 4 (TCP/IPv4), and then click Properties (see Figure 3-14 on page 94). Connecting to Hardware and/or Software 93

102 Figure 3-14 The [Connection Name] Properties dialog box on the remote computer under Windows 7 (4) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address, type compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-15 on page 95). On the remote computer, set the IP address to a value which is in the same range as the local computer (the same first three blocks) but not identical to the IP address of the computer. For example, and Chapter 3

103 Figure 3-15 Configuring the internet protocol on the remote computer using the Internet Protocol (TCP/IP) Properties dialog box under Windows 7 5. Open the Configuration Manager, which can be found at the following access path: [Installation folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\ Configuration manager. 6. Under Device, select TomoView 2.10 from the list. 7. Under IP Address, type the IP address of the remote computer in the box, as defined in step 4, and then click Apply (see Figure 3-16 on page 96). Connecting to Hardware and/or Software 95

104 Figure 3-16 Configuring the Configuration Manager to TomoView Connecting the NDT Remote Control Library to an OmniScan ix This section describes how to connect the NDT Remote Control Library to an OmniScan ix. To connect the NDT Remote Control Library to an OmniScan ix 1. Connect a crosslink Ethernet (RJ-45) cable category 5e or better to the network port of the computer. 2. Connect the other end of the Ethernet cable to the OmniScan ix s Ethernet port. 3. On the computer, configure the network connection for the OmniScan ix: Under Windows XP (1) On the taskbar, click Start, click Control Panel, click Network Connection, and then double-click on the connection used to establish the link with the OmniScan ix. (2) In the [Connection Name] Properties dialog box that appears, select Internet Protocol (TCP/IP) and then click Properties (see Figure 3-17 on page 97). 96 Chapter 3

105 Figure 3-17 The [Connection Name] Properties dialog box on the computer under Windows XP (3) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address, type OmniScan-compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-9 on page 89). Connecting to Hardware and/or Software 97

106 Figure 3-18 Configuring the internet protocol on the computer using the Internet Protocol (TCP/IP) Properties dialog box under Windows XP Under Windows 7 (1) On The taskbar, click Start, click Control Panel, click Network and Internet, click Network and Sharing Center, and then click the connection used to establish the link with the OmniScan ix. The [Connection Name] Status dialog box appears. (2) Click Properties. (3) In the [Connection Name] Properties dialog box that appears, select Internet Protocol Version 4 (TCP/IPv4), and then click Properties (see Figure 3-10 on page 90). 98 Chapter 3

107 Figure 3-19 The [Connection Name] Properties dialog box on the local computer under Windows 7 (4) In the Internet Protocol (TCP/IP) Properties dialog box, click Use the following IP address. (5) Type OmniScan-compatible IP address values in the IP address and Subnet Mask boxes, and then click OK (see Figure 3-11 on page 91). 4. On the OmniScan ix, select the Preferences > Instrument > Category = Network menu. 5. In the Network Settings submenu, type an OmniScan-compatible IP address value in the IP Address box. On the OmniScan ix, set the IP address to a value which is in the same range as the computer to which it is connected (the same first three blocks), but not identical to the IP address of the computer. For example, and Connecting to Hardware and/or Software 99

108 Figure 3-20 The IP Address parameter found in the Preferences menu in the OmniScan software user interface 6. Open the Configuration Manager, which can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\ Configuration manager. 7. Under Device, select OmniScan Ultrasound 2.0R2 from the list, under IP Address, type the IP address of the remote computer in the box, as defined in step 4, and then click Apply (see Figure 3-21 on page 101). 100 Chapter 3

109 Figure 3-21 Configuring the Configuration Manager to an OmniScan ix 8. Close the Configuration Manager. Connecting to Hardware and/or Software 101

110 102 Chapter 3

111 4. Application Examples In the [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\ Samples folder, you can find a list of compiled and ready-to-use sample applications which are installed on the computer with the NDT Remote Control Library. These sample applications are an ideal starting point. They are provided as part of the installation package to be a foundation on which to build your own custom applications. The sample applications have been developed using the C++, C#, Visual Basic, and LabVIEW programming languages. The complete source code of the sample applications is available at the access path [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Samples, inside a subfolder with the name of the sample application, to which is added the name of the language used to program the sample application s code. 4.1 The OmniScan ix Remote Control Application The OmniScan Application_VB.exe program reproduces typical OmniScan ix applications common in software environment integrations. The objective is to control the acquisition procedure by loading the appropriate setup file, initializing the inspection sequence and, once it is completed, saving the data file automatically either on the instrument, on a USB key connected to the instrument, or on a remote computer Using the OmniScan ix Remote Control Application The OmniScan Application_VB.exe program is a ready-to-use sample application programmed in Visual Basic. It contains commands that are frequently used when remote-controlling an OmniScan ix. Application Examples 103

112 To use the OmniScan ix Remote Control Application 1. Make sure that the NDT Remote Control Library is properly configured for remote-controlling the OmniScan ix (see section 3.2 on page 96). 2. In the [Installation Folder Name]:\OlympusNDT \NDTRemoteControlLibrary26\Samples folder, double-click OmniScan Application_VB.exe. 3. In the OmniScan UT Application window, click Connect (see Figure 4-1 on page 104). Figure 4-1 The sample OmniScan UT Application dialog box Use the available commands to send remote commands to the OmniScan ix (see Figure 4-2 on page 105). 104 Chapter 4

113 Figure 4-2 The sample OmniScan UT Application dialog box connected to an OmniScan ix For more information about the commands that are available for remote-controlling an OmniScan ix instrument, see section on page OmniScan ix Remote Control Application Description An overview of the functions available in the sample OmniScan UT Application, which can remote-control an OmniScan ix, is provided in Figure 4-3 on page 106. Application Examples 105

114 Connect to/ disconnect from an OmniScan ix. Set the data file name. Select where to save the data files on an OmniScan ix or on a computer. Load an OmniScan ix setup file. Control the acquisition of data. Get current encoder position. Figure 4-3 The sample OmniScan UT Application dialog box controls The commands enable the connection or disconnection of the computer and an OmniScan ix instrument, loading an OmniScan setup file, pre-configuring a data file name scheme, controlling data acquisition, selecting where data files are saved on an OmniScan ix instrument or on a connected computer, and obtaining the encoder s current position. The complete source code for the sample OmniScan UT application can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Samples The code of the sample Visual Basic application can be found inside a subfolder with the name of the sample application, to which is added the name of the language used to program the sample application s code. 106 Chapter 4

115 4.2 The TomoView Remote Control Application The TomoView Application_MFC.exe program reproduces typical TomoView applications which are built in software environment integrations. When a setup file is loaded, the program allows broad control of the inspection sequence parameters and initializing. When a data file is loaded, the program gives access to data handling commands to perform post-processing on either single or multiple data file configurations Using the TomoView Remote Control Application The TomoView Application_MFC.exe program is a ready-to-use sample application programmed in C++. It contains commands that are frequently used in both the acquisition and the analysis mode of TomoView. To use the TomoView Remote Control Application 1. Make sure that the NDT Remote Control Library is properly configured for connection to TomoView (see section 3.1 on page 81). 2. In the [Installation Folder Name]:\OlympusNDT\ NDTRemoteControlLibrary26\Samples folder, double-click TomoView Application_MFC.exe. 3. In the TomoView Application window, click Connect (see Figure 4-4 on page 108). Application Examples 107

116 Figure 4-4 The sample TomoView Application main window Use the available commands to send commands to TomoView remotely (see Figure 4-5 on page 109). 108 Chapter 4

117 Figure 4-5 The sample TomoView Application main window connected to TomoView For more information about the commands that are available for remote-controlling TomoView, see section on page TomoView Remote Control Application Description An overview of the functions available in the sample TomoView application, which can send commands to TomoView, is provided in Figure 4-6 on page 110 and Figure 4-7 on page 111. Application Examples 109

118 Connect to/dis connect from TomoView. Load a TomoView setup or data file. Control the acquisition of data. Set the data files saving parameters. Display live A-scan or C-scan data. Set the patch size and other mechanical settings. Figure 4-6 The sample TomoView Application main window displaying the Acquisition tab controls The available commands are found in the sample application s main window, and in two of the three tabs. They enable the connection or disconnection of the computer and TomoView or an OmniScan ix instrument and loading a setup file. In the Acquisition tab are found commands for controlling data acquisition, selecting and displaying data, pre-configuring a data file name scheme, selecting where data files are saved on an OmniScan ix or on a connected computer, and obtaining the encoder s current position (see Figure 4-6 on page 110). 110 Chapter 4

119 Connect to/disconnect from TomoView. Load a TomoView setup or data file. Control the TomoView data merging functionalities. Display live A-scan or C-scan data. Merge separate data files into a single file. Figure 4-7 The sample TomoView Application main window and the Analysis tab controls In the Analysis tab are found commands for selecting and displaying data, merging data, and merging data files (see Figure 4-7 on page 111). The complete source code for the sample TomoView application can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Samples The code of the sample C++ application can be found inside a subfolder with the name of the sample application, to which is added the name of the language used to program the sample application s code. Application Examples 111

120 4.3 The Remote Online Data Application The Online Data_CSharp.exe program reproduces typical TomoView or OmniScan ix live data extraction applications which can be used to perform online external data monitoring and display. When working with an OmniScan ix instrument, only live C-Scan data can be retrieved. A-Scan data is not available Using the Remote Online Data Application The Online Data_CSharp.exe program is a ready-to-use sample application programmed in C#. It contains commands that are frequently used for live TomoView or OmniScan data extraction. To use the Remote Online Data Application 1. Make sure that the NDT Remote Control Library is properly configured for connection to TomoView (see section 3.1 on page 81). 2. In the [Installation Folder Name]:\OlympusNDT\ NDTRemoteControlLibrary26\Samples folder, double-click Online Data_CSharp.exe. 3. In the Online Data UI window, click Connect (see Figure 4-8 on page 113). 112 Chapter 4

121 Figure 4-8 The sample Online Data UI application main window Use the available commands for live TomoView or OmniScan data extraction (see Figure 4-9 on page 114). Application Examples 113

122 Figure 4-9 The sample Online Data UI application main window connected to an OmniScan ix For more information about the commands for live TomoView or OmniScan data extraction, see section on page Chapter 4

123 4.3.2 Remote Online Data Application Description An overview of the functions available in the sample Online Data UI application, which can send commands for live TomoView or OmniScan data extraction, is provided in Figure 4-10 on page 116. Application Examples 115

124 Live A-scan or C-scan data. Connect to/disconnect from TomoView or an OmniScan ix. Select which live A-scan or C-scan data to display. General setup information. Figure 4-10 The sample Online Data UI application main window controls 116 Chapter 4

125 The commands enable the connection or disconnection of the computer and TomoView or an OmniScan ix instrument and loading a setup file, and selecting and displaying data. The complete source code for the sample Online Data UI application can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Samples The code of the sample C# application can be found inside a subfolder with the name of the sample application, to which is added the name of the language used to program the sample application s code. 4.4 The TomoView Embedding Application The Embedded TomoView.vi program shows a basic TomoView embedding application programmed in LabVIEW. It can be used to build a more complete interface that can display for instance only A-scan and/or C-scan data with TomoView operating behind the scene Using the TomoView Embedding Application The Embedded TomoView.vi program is a ready-to-use sample application that contains commands to embed a TomoView display inside another application, such as LabVIEW. To use the TomoView Embedding Application 1. Make sure that the NDT Remote Control Library is properly configured for connection to TomoView (see section 3.1 on page 81). 2. In the [Installation Folder Name]:\OlympusNDT\ NDTRemoteControlLibrary26\Samples folder, double-click Embedded TomoView.vi. 3. In the Embedded TomoView.vi application, click Play ( ). 4. Click Hook TomoView 2.X to embed TomoView (see Figure 4-11 on page 118). Application Examples 117

126 Figure 4-11 The LabVIEW main window with an embedded TomoView window For more information about the commands for live TomoView or OmniScan data extraction, please refer to the NDT Data Access Library User s Manual TomoView Embedding Application Description An overview of the functions available in the sample TomoView embedding application, which can embed a TomoView window in a LabVIEW application, is provided in Figure 4-12 on page Chapter 4

127 Buttons to hook or unhook TomoView. Embedded TomoView window. Figure 4-12 The LabVIEW main window with an embedded TomoView window and controls to hook or unhook TomoView from the LabVIEW application The complete source code for the sample embedded TomoView window application can be found at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Samples Application Examples 119

128 The code of the sample LabVIEW application can be found inside a subfolder with the name of the sample application, to which is added the name of the language used to program the sample application s code. 120 Chapter 4

129 5. Organization This chapter presents the organization of the commands and their availability according to the elements to be controlled. The NDT Remote Control Library is based on an arborescent structure. For the command structure, see the tree views in Figure 5-1 on page 122 to Figure 5-15 on page 132. In these figures, terms in bold identify public methods, and terms in italic identify public properties. The interfaces described in the following sections can be easily identified as their names generally begin by the letter i. Collections names generally end with the letter s. To access an inspection station, you must use a remote control object from the INDTInspectionSystems collection. Legend for Figure 5-1 to Figure 5-14 Terms in bold identify public methods. Terms in italics identify public properties. Organization 121

130 INDTInspectionSystems INDTInspectionSystem NDTRemoteControl(INDTRemoteControl) FileControl(IFileControl) INDTDocuments INDTDocument (see Figure 5-2 on page 123) InspectionControl(IInspectionControl) CustomControls FileControls GeneralSettings Identification InspectionControl OnlineSettings PodStatus UserInterfaceControl Add FindNDTDocument GetActiveDocument ImportTCG ExportTCG Remove RemoveAll NewEnum Count Item GeneralSettings(IGeneralSettings) SystemUnit SystemUnit Update UnitSystem OnlineSettings(IOnlineSettings) MechanicalSequences (see Figure 5-8 on page 127) UltrasoundSettings (see Figure 5-9 on page 128) CustomControls (see Figure 5-14 on page 132) Figure 5-1 INDTRemoteControl tree structure Initialize MoreInfo NDTName NDTRemoteControl RemoteServerName CloseAllDataFiles CloseDataFile LoadLayout LoadSetup LoadUltrasoundPALawFile OpenDataFile SaveSetup NDTDocuments SetupFileName AbortAcquisition GetEncoderPosition GoToInspectionSetupUpdate PauseAcquisition PresetEncoderPosition StartAcquisition StopAcquisition AcquisitionSequence AutoNaming InspectionState IAutoNaming UserInterfaceControl(IUserInterfaceControl) (see Figure 5-7 on page 126) NewEnum Count Item Update Counter Directory FileName SaveMode MechanicalSequences UltrasoundSettingCollection 122 Chapter 5

131 INDTDocument IAnalysisControl ICursors2D ICursor2D ReadPosition WritePosition Type ReadPosition(CursorPosition) DefectBoxes(IIndicationBoxes) IIndicationBox Area DataSource Panes (IPanes) IPane FirstPosition(CursorPosition) SecondPosition(CursorPosition) DataSource CopyTo ChannelIndex DataGroupIndex GateIndex VisibleReadings(IReadings) CopyTo ChannelIndex DataGroupIndex GateIndex IReading GetValue Description Id Label OnlineData(IOnlineData) (see Figure 5-3 on page 124) GetCursors NewEnum Count Item Index Scan USound OnlineDataEC[IOnlineDataEC) [see Figure 5-6 on page 126] Index Scan Usound Cursors2D DefectBoxes Panes Area DataSource ID Index Scan Usound Figure 5-2 INDTDocument tree structure FirstPosition SecondPosition CreateBitmap Active DataSource VisibleReadings Activate Active ActiveChannel Activelayout AnalysisControl FileName OnlineData OnlineDataEC FindID FindLabel Refresh NewEnum Count Item Add Refresh Remove RemoveAll Update NewEnum Count Item GetActive Refresh Update NewEnum Count Item Organization 123

132 OnlineData(IOnlineData) IChannels Channel Beams Beam ActiveDataGroup Channels Angle Delay Gain Gates Name ReferenceIndexOffset ReferenceScanOffset Skew Gates Gate DataGroups Level Name Rectification Start Synchro Type Width DataGroups DataGroup DataAccess PartParameters (see Figure 5-4 on page 125) Filter AnalogicSmoothing DigitalSmoothing HighPass LowPass ActiveDataGroup (IDataGroup) [see Figure 5-5 on page 125] Add Remove RemoveAll NewEnum Count Item Add GetGate Remove RemoveAll NewEnum Count Item Figure 5-3 IOnlineData tree structure Averaging Beams Compression DigitizingFrequency filter Name PartParameters PulseWidth Type DataAccess DataRectification IndexQantity IndexResolution Name SampleQuantity SampleResolution ScanQuantityScanResolution Type Add Remove RemoveAll NewEnum Count Item PulserVoltage Add GetDataGroup GetDataSource Remove RemoveAll SetDataSourc NewEnum Count DataManager Item GetDataError GetDataErrorBuffer GetDataErrorSlice ReadAscan ReadData ReadDataSlice WriteData 124 Chapter 5

133 PartParameters InspectionType InterfaceSoundVelocity MaterialSoundVelocity ProbeDelay ProbeParallelToScan ProbeSeparation Radius Surface Thickness Figure 5-4 PartParameters tree structure ActiveDataGroup(IDataGroup) PatchParam DataGroupParam IndexQuantity IndexResolution ScanQuantity ScanResolution Type DataAccess DataGroupParam Name PatchParam DataAccess GetDataError GetDataErrorBuffer ReadData Figure 5-5 ActiveDataGroup(IDataGroup) tree structure Organization 125

134 OnlineDataEC(IOnlineDataEC) Groups(IGroups) Group DataGroups NewEnum Count Item DataRGoups IsEnabled Name DataGroup Groups DataAccess DataGroupParam Name PatchParam NewEnum Count Item PatchParam DataGroupParam DataAccess Type GetDataError GetDataErrorBuffer ReadData IndexQuantity IndexResolution ScanQuantity ScanResolution Figure 5-6 OnlineDataEC(IOnlineDataEC) tree structure UserInterfaceControl(IUserInterfaceControl) IUserMenu ICorePanel LockCloseFile LockOpenFile LocSaveFile ShowApplicationMenu ShowDisplayProperties ShowMechanicalSettings ShowUTSettings Close HideWindow Maximize Minimize Move Restore ShowWindow Size CorePanel LockClose LockMaximize LockMinimize LockMove LockRestore LockSize UserMenu Figure 5-7 UserInterfaceControl(IUserInterfaceControl) tree structure 126 Chapter 5

135 MechanicalSequences(Sequences) Sequence ScanAxis(Axis) Encoder IndexAxis(Axis) Encoder AlternateAxis(Axis) Encoder Update AcuisitionSpeed DisplayResolution Encoder Length PresetMode PresetValue Start Type Unit Update AcquisitionSpeed DisplayResolution Encoder Length PresetMode PresetValue Start Type Unit Update AcquisitionSpeed DisplayResolution Encoder Length PresetMode PresetValue Start Type Unit Update AlternateAxis FiringMode Index IndexAxis MechanicalAngle Name PresetIndexMode ResetScanEncoderMode ScanAxis Type Update Input Inverse Name Resolution Type Update Input Inverse Name Resolution Type Update Input Inverse Name Resolution Type Add Remove RemoveAll Update NewEnum Count Item Figure 5-8 MechanicalSequences tree structure Organization 127

136 UltrasoundSettings UltrasoundSettings UltrasoundChannels Add Remove RemoveAll Update NewEnum Count CurrentChannel Item SetAcquisitionRate Update AcquisitionRate BoardType Device PodElementConfig UltrasoundChannels Update NewEnum Count CurrentDevice Item PodElementConfig UltrasoundChannel (see Figure 5-10 on page 128) MaximumAperture MaximumElement SumPulsReceiverForPC Figure 5-9 UltrasoundSettings tree structure UltrasoundChannel UltrasoundChannelPA Update AllBeamsConfig GeneralGain PhasedArrayMerged AllBeamsConfig(Beam) [see Figure 5-11 on page 129] UltrasoundChannelMono Update BoosterGain DataSettings (see Figure 5-12 on page 130) PulserReceiver Update Update Beams DataSettings Index InspectionType Name PulserReceiver PulserVlotge PulseWidth Recurrence type UltrasoundChannelMono UltrasoundChannelPA Beams (see Figure 5-13 on page 131) Figure 5-10 UltrasoundChannel tree structure 128 Chapter 5

137 AllBeamsConfig(Beam) Gates Gate Update NewEnum Count Item Update Index Length Name Start Threshold Type Update DACPoints Gain Gates Index Name PositionOrientation Receivers SoundVelocity SumGain TargetSumGain TimeBase Transmitters WaveType WedgeDelay PositionOrientation TimeBase SoundVelocity DACPoints DACPoint Update Gain Index Position Add Remove RemoveAll Update NewEnum Count Enable Item Update InWedge Longitudinal Transversal Update Range Start Update Angle ReferenceIndexOffset ReferenceScanOffset Skew Transmitters(Elements) Element Receivers(Elements) Element Delay Index Add Remove RemoveAll Update NewEnum Count Item Delay Index Add Remove RemoveAll Update NewEnum Count Item Figure 5-11 AllBeamsConfig(Beam) tree structure Organization 129

138 DataSettings Ascan Cscan Filter Update ProbeFrequency Smoothing Update Compression ProduceData ProduceVideoData Update Gate0ProducePositionData Gate1ProduceAmplitudeData Gate1ProducePositionData Gate2ProduceAmplitudeData Gate2ProducePositionData Gate3ProduceAmplitudeData Gate3ProducePositionData Gate4ProduceAmplitudeData Gate4ProducePositionData Update Ascan Averaging Cscan DigitizingFrequency Filter Rectification Figure 5-12 DataSettings tree structure 130 Chapter 5

139 Beams Beam Gates Gate Update Index Length Name Start Threshold Type Update NewEnum Count Item Update DACPoints Gain Gates Index Name PositionOrientation Receivers SoundVelocity SumGain TargetSumGain TimeBase Transmitters WaveType WedgeDelay Update NewEnum Count CurrentBeam Item PositionOrientation TimeBase SoundVelocity DACPoints DACPoint Update Gain Index Position Add Remove RemoveAll Update NewEnum Count Enable Item Update InWedge Longitudinal Transversal Update Range Start Update Angle ReferenceIndexOffset ReferenceScanOffset Skew Transmitters(Elements) Element Receivers(Elements) Element Delay Index Add Remove RemoveAll Update NewEnum Count Item Delay Index Add Remove RemoveAll Update NewEnum Count Item Figure 5-13 Beams tree structure Organization 131

140 CustomControls ICustonControl IsVisible ShowDialog Identification Update NewEnum Count Item Figure 5-14 CustomControls tree structure TomoViewActiveX HookTomoView UnHookTomoView Figure 5-15 TomoViewActiveX tree structure The NDT Remote Control Library commands are documented in detail in the NDT Remote Control documentation, which is provided as an online help document, located at the following access path: [Installation Folder Name]:\OlympusNDT\NDTRemoteControlLibrary26\Manual The TomoView software supports all NDT Remote Control Library commands, except those specifically for the OmniScan EC (see section on page 180), and for the OmniScan ix (see section on page 177). The OmniScan ix supports only some of the NDT Remote Control Library commands. The entry point to access all commands is INDTRemoteControl. You can also access the data from the files generated through remote control using the NDT Data Access Library. For more information, please refer to the NDT Data Access Library User s Manual. 132 Chapter 5

141 6. Program Commands This chapter presents the description of the program commands available in this library. The interfaces described in the following sections can be easily identified as their names begin by the letter i. Collections names end with the letter s. 6.1 Units This section presents the units that you must use for your settings. All values are expressed in the international system of units. Time is in seconds Distance is in meters Amplitude is in percentage. Rotation/angles are in degrees. 6.2 Description This section presents the description of all the commands available for remote controlling workstations equipped with TomoView, an OmniScan ix, or an OmniScan EC. The TomoView software supports all NDT Remote Control Library commands, except those specifically for the OmniScan EC (see section on page 180), and for the OmniScan ix (see section on page 177). The OmniScan ix supports only some of the NDT Remote Control Library commands. These commands are regrouped in the four following categories: Program Commands 133

142 Commands for TomoView and OmniScan ix Remote Control Commands for OmniScan ix Remote Control Commands for Events Monitoring Commands for OmniScan EC Remote Control Commands for TomoView and OmniScan ix Remote Control The methods described in this section can be used to send remote commands to a workstation equipped with TomoView or an OmniScan ix. Note that only a subset of these commands is available for a workstation featuring an OmniScan ix INDTInspectionSystems The INDTInspectionSystems collection contain the NewEnum, Count, and Item properties INDTInspectionSystem The INDTInspectionSystem interface contains the following elements: Method Initialize The Initialize function was designed for internal use only. Properties MoreInfo Get more information on the current inspection station, which can be either Connected to TomoView, OmniScan Ultrasound, or OmniScan Eddy Current. NDTName Get the name of the current inspection station, which can be either TomoView 2.X, OmniScan Ultrasound 2.0R2 or higher for the OmniScan ix, or OmniScan Eddy Current 2.1 or higher for the OmniScan EC. NDTRemoteControl Get INDTRemoteControl interface. For a list of the commands available in the IRemoteControl interface, see section on page Chapter 6

143 RemoteServerName Get the IP Address corresponding to the current inspection station INDTRemoteControl The INDTRemoteControl interface contains the following properties: CustomControls Get ICustomControls collection. For a list of the commands available in the ICustomControls interface, see section on page 176. FileControl Get IFileControl interface. For a list of the commands available in the IFileControl interface, see section on page 136. GeneralSettings Get GeneralSettings interface. For a list of the commands available in the GeneralSettings interface, see section on page 160. Identification Get the name of the current inspection station, which will correspond to the name indicated in the title bar of the main window for TomoView, or to OmniScan for an OmniScan ix or OmniScan EC. InspectionControl Get IInspectionControl interface. For a list of the commands available in the IInspectionControl interface, see section on page 156. OnlineSettings Get IOnlineSettings interface. For a list of the commands available in the IOnlineSettings interface, see section on page 161. PodStatus Get whether a POD is currently connected or not to the inspection station (TRUE = A POD is connected and FALSE = No POD is connected). UserInterfaceControl Get IUserInterfaceControl interface. For a list of the commands available in the IUserInterfaceControl interface, see section on page 158. Program Commands 135

144 IFileControl The IFileControl interface contains the following elements: Methods CloseAllDataFiles Close all the currently opened TomoView data files (.rdt). CloseDataFile Close the TomoView data file (.rdt) with the specified name. LoadLayout Load the TomoView layout file (.rst) with the specified name. LoadSetup Load the TomoView setup file (.acq) or OmniScan ix setup file (.ous) with the specified name. LoadUltrasoundPALawFile Load the TomoView focal law file (.law or.pac) with the specified name (TRUE = Replace law file of the current channel and FALSE = Add a new channel based on the specified law file). OpenDataFile Open the TomoView data file (.rdt) with the specified name. SaveSetup Save the TomoView setup file (.acq) with the specified name. ImportTCG Import the time-corrected gain (TCG) curve to be applied to the current group from a TCG curve points file (.csv). ExportTCG Export the TCG curve applied to the current group to a TCG curve points file (.csv). Properties NDTDocuments Get INDTDocuments collection. For a list of the commands available in the INDTDocuments collection, see section on page Chapter 6

145 SetupFileName Get the name of the current TomoView setup file (.acq), OmniScan ix setup file (.ous), or OmniScan EC setup file (.oes or.oas) INDTDocuments The INDTDocuments collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following methods: FindNDTDocument Get INDTDocument interface for the specified document. For a list of the commands available in the INDTDocument interface, see section on page 137. GetActiveDocument Get INDTDocument interface for the active document. For a list of the commands available in the INDTDocument interface, see section on page INDTDocument The INDTDocument interface contains the following elements: Method Activate Activate the specified TomoView setup file (.acq) or data file (.rdt). Properties Active Get whether or not the specified document is active in TomoView (TRUE = The current document is active in TomoView and FALSE = The current document is not active in TomoView. ActiveChannel Get or set the number corresponding to the active channel in the current setup file. ActiveLayout Get or set the number corresponding to the active layout in the current TomoView layout file (.rst). Program Commands 137

146 AnalysisControl Get IAnalysisControl interface. For a list of the commands available in the IAnalysisControl interface, see section on page 138. FileName Get the name of the current TomoView setup file (.acq) or data file (.rdt). OnlineData Get IOnlineData interface. For a list of the commands available in the IOnlineData interface, see section on page 143. OnlineDataEC Get IOnlineDataEC interface. For a list of the commands available in the IOnlineDataEC interface, see section on page IAnalysisControl The IAnalysisControl interface contains the following properties: Cursors2D Get ICursors2D collection. For a list of the commands available in the ICursors2D interface, see section on page 138. DefectBoxes Panes Get IIndicationBoxes collection. For a list of the commands available in the IIndicationBoxes interface, see section on page 139. Get IPanes collection. For a list of the commands available in the IPanes interface, see section on page ICursors2D The ICursors2D collection contains, along with the NewEnum, Count, and Item properties, the following method: GetCursor Select the active cursor, which can be either Reference, Measurement, or Data. 138 Chapter 6

147 ICursor2D The ICursor2D interface contains the following elements: Methods ReadPosition Get the Scan, Index, or Ultrasound position for the selected cursor (the Scan and Index positions are specified in meters or degrees and the Ultrasound position is specified in seconds). WritePosition Set the Scan, Index, or Ultrasound position for the selected cursor (the Scan and Index positions are specified in meters or degrees and the Ultrasound position is specified in seconds). Property Type Get or set the current cursor type, which can be either Reference, Measurement, or Data cursor ICursorPosition The ICursorPosition interface contains the following properties: Index Get or set current cursor position on the Index axis (specified in meters or degrees). Scan Get or set current cursor position on the Scan axis (specified in meters or degrees). USound Get or set current cursor position on the Ultrasound axis (specified in seconds) IIndicationBoxes The IIndicationBoxes collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following methods: Program Commands 139

148 Refresh Update Get current information from all indication boxes. Set the IndicationBoxes changes to the current inspection system IIndicationBox The IIndicationBox interface contains the following properties: Area Get IArea interface. For a list of the commands available in the IArea interface, see section on page 140. DataSource Id Get IDataSource interface. For a list of the commands available in the IDataSource interface, see section on page 141. Get or set the number corresponding to the active indication box IArea The IArea interface contains the following properties: FirstPosition Get ICursorPosition interface for the first cursor position. For a list of the commands available in the ICursorPosition interface, see section on page 139. SecondPosition Get ICursorPosition interface for the second cursor position. For a list of the commands available in the ICursorPosition interface, see section on page ICursorPosition The ICursorPosition interface contains the following properties: Index Scan Get the current cursor position on the Index axis (specified in meters or degrees). Get the current cursor position on the Scan axis (specified in meters or degrees). 140 Chapter 6

149 USound Get current cursor position on the Ultrasound axis (specified in seconds) IDataSource The IDataSource interface contains the following elements: Method CopyTo Copy the IDataSource values from the specified indication box to the current indication box. Properties BeamIndex Get or set the number corresponding to the beam for the current indication box. ChannelIndex Get or set the number corresponding to the channel for the current indication box. DataGroupIndex Get or set the number corresponding to the data group for the current indication box. GateIndex Get or set the number corresponding to the gate for the current indication box IPanes The IPanes collection contains, along with the NewEnum, Count, and Item properties, the following methods: GetActive Get IPanes interface for the active pane. For a list of the commands available in the IPanes interface, see section on page 141. Refresh Get the current information from TomoView for the panes. Update Set the Panes changes to the current inspection system. Program Commands 141

150 IPane The IPane interface contains the following elements: Method CreateBitmap Create a bitmap file (.bmp) from the current pane with the specified name, length, height (both specified in pixels), and rotation (which can be either Normal or Rotate90). Properties Active Get whether or not the selected pane is the active pane (TRUE = The current pane is the active pane and FALSE = The current pane is not the active pane). DataSource Get IDataSource interface for the selected pane. For a list of the commands available in the IDataSource interface, see section on page 141. VisibleReadings Get IReadings interface for visible readings on the active pane. For a list of the commands available in the IReadings interface, see section on page IReadings The IReadings collection contains, along with the NewEnum, Count, and Item properties, the following methods: FindID Get IReading interface for the reading with the specified ID. For a list of the commands available in the IReading interface, see section on page 143. FindLabel Get IReading interface for the reading with the specified ID. For a list of the commands available in the IReadings interface, see section on page 143. Refresh Get current information from all indication readings. 142 Chapter 6

151 IReading The IReading interface contains the following elements: Method GetValue Get the value and unit of the specified reading (you need to pass a reference object, which will contain the return value of the get operation). Properties Description Id Label Get the description of the specified reading. Get the ID number corresponding to the selected reading (this function was designed for internal use only). Get the name of the specified reading IOnlineData The IOnlineData interface contains the following properties: ActiveDataGroup Get IDataGroup interface. For a list of the commands available in the IDataGroup interface, see section on page 151. Channels Get IChannels interface. For a list of the commands available in the IChannels interface, see section on page IChannels The IChannels collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following method: PulserVoltage Get or set the pulse voltage of the pulser, when this value is the same for all groups (specified in volts). Program Commands 143

152 IChannel The IChannel interface contains the following properties: Averaging Get or set the number of A-scans acquired for each A-scan that is returned. The returned A-scan is obtained by calculating, for each sample, the average value over all the acquired A-scans. Beams Get the array of beam objects in the current channel object. Compression Get or set the digitizer compression ratio, which is used to reduce the sample quantity (and thus data file size) by keeping the position of the first sample with the maximum amplitude detected over the number of considered samples. DigitizingFrequency Get or set the digitizer frequency which is used for the acquisition (specified in hertz). Filter Get IFilterSettings interface. For a list of the commands available in the IFilterSettings interface, see section on page 154. Name Get or set the name of the current channel. PartParameters Get IPartParameters interface. For a list of the commands available in the IPartParameters interface, see section on page 154. PulseWidth Get or set the pulse width of the pulser (specified in seconds). Type Get or set information on the channel type, which can be either MonoElement (Conventional UT), PhasedArrayMerged (Linear merged in TomoView and Linear at 0 on the OmniScan PA) or PhasedArray. ConditionalAScan Get or set if the Conditional A-Scan function is activated, which allows the A-Scans to be recorded only when an alarm was triggered (TRUE = Conditional A-Scan is activated and FALSE = Conditional A-Scan is not activated). PulserVoltage Get or set the pulse voltage of the pulser for the active channel (specified in volts). 144 Chapter 6

153 IBeams (RDTiffDefinition) The IBeams collection contains the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties IBeams (NDTRemoteControlsSettings) The IBeams collection contains, along with the NewEnum, Count, and Item properties, the following elements: Method Update Set Beams changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Property CurrentBeam Get the number corresponding to the active Beam in TomoView IBeam (RDTiffDefinition) The IBeam interface contains the following properties: Angle Delay Gain Get or set the refracted angle of the ultrasound beam (specified in degrees), which is defined as the angle between the central ray of the ultrasound beam in the material and the normal on the incidence plane inside the material. Get or set the current beam delay (specified in seconds), to which the wedge delay has been subtracted. Get or set the total gain value of the current beam, which is calculated by adding the channel gain to the beam gain (specified in db). Gates Get IGates interface. For a list of the commands available in the IGates interface, see section on page 147. Program Commands 145

154 Name Get the name of the current beam. ReferenceIndexOffset Get or set the distance between the beam exit point (where the beam exits the wedge) and the zero position on the index axis (specified in meters). ReferenceScanOffset Get or set the distance between the beam exit point (where the beam exits the wedge), and the zero position on the scan axis (specified in meters). Skew Get or set the skew angle of the ultrasound beam (specified in degrees), which is defined as the angle between the ultrasound beam projection on the scanning surface and the primary axis of the array IBeam (NDTRemoteControlsSettings) The IBeam interface contains the following elements: Method Update Set Beam changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties DACPoints Get IDACPoints interface. For a list of the commands available in the IDACPoints interface, see section on page 170. Gain Get or set the current beam gain (specified in decibels). Gates Get IGates interface. For a list of the commands available in the IGates interface, see section on page 148. Index Get the position of the current Beam in the IUltrasoundChannelPA interface. Name Get the current beam name. 146 Chapter 6

155 PositionOrientation Get IPositionOrientation interface. For a list of the commands available in the IPositionOrientation interface, see section on page 168. Receivers Get IElements interface for the receivers. For a list of the commands available in the IElements interface, see section on page 171. SoundVelocity Get ISoundVelocity interface. For a list of the commands available in the ISoundVelocity interface, see section on page 169. SumGain Get the sum gain value of the current beam (specified in decibels). TargetSumGain Set the sum gain value of the current beam (specified in decibels). TimeBase Get ITimeBase interface. For a list of the commands available in the ITimeBase interface, see section on page 169. Transmitters Get IElements interface for the transmitters. For a list of the commands available in the IElements interface, see section on page 171. WaveType Get or set the wave type, which can be either Longitudinal, Transverse, or InWedge. WedgeDelay Get or set the total wedge delay, which is calculated using the following formula: Wedge delay = Ultrasound path in wedge / Ultrasound velocity in wedge (specified in seconds) IGates (RDTiffDefinition) The IGates collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following method: GetGate Select of the current gate, which can take the following values: Synchro (Gate I), GateA, GateB, Main (A-scan), MainVideo (A-Scan video), MainPeak (A-Scan peak), Gate2Gate1 (Gate 2 - Gate 1), SoftGate (software A-scan), GateC, GateD, ThicknessGate, SoftI (software Gate I), SoftA (software Gate A), SoftB (software Gate B), SoftC (software Gate C), SoftD (software Gate D). Program Commands 147

156 IGates (NDTRemoteControlsSettings) The IGates collection contains, along with the NewEnum, Count, and Item properties, the following method: Update Set Gates changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time IGate (RDTiffDefinition) The IGate interface contains the following properties: DataGroups Get IDataGroups interface. For a list of the commands available in the IDataGroups interface, see section on page 150. Level Get or set the threshold level of the selected gate (specified in percentage (%) of full screen height). Name Get the name of the current gate. Rectification Get or set the signal rectification type between NotRectified (the A-scan signal is displayed without any rectification), UnipolarPositif (only the positive part of the signal is kept), UnipolarNegatif (only the negative part of the signal is kept), and Bipolar (the negative part of the signal is brought back to the positive part). Start Get or set the start position of the selected gate (specified in seconds). Synchro Get or set the synchronization mode of the selected gate. For a synchronized gate, the Start position is determined by either the crossing or maximum position of the gate on which it is synchronized. Type Get the gate type, which can take the following values: Synchro (Gate I), GateA, GateB, Main (A-scan), MainVideo (A-Scan video), MainPeak (A-Scan peak), Gate2Gate1 (Gate 2 - Gate 1), SoftGate (software A-scan), GateC, GateD, ThicknessGate, SoftI (software Gate I), SoftA (software Gate A), SoftB (software Gate B), SoftC (software Gate C), SoftD (software Gate D). 148 Chapter 6

157 Width Get or set the length of the selected gate (specified in seconds). AmplitudeUnderLevelSaved Get or set if the amplitude data is shown even when the signal has not crossed the gate, therefore ignoring the no detection codes (TRUE = Amplitude under level is saved and FALSE = Amplitude under level is not saved). PeakSelection Get or set the peak selection type for the selected gate, which can be either FirstPeak or HighestPeak IGate (NDTRemoteControlsSettings) The IGate interface contains the following elements: Method Update Set Gate changes to the current inspection system. Set the optional parameter to FALSE if you do not want to update the child objects at the same time. Properties Index Get or set the number corresponding to the active Gate in TomoView. Length Get or set the length of the selected gate (specified in seconds). Name Get or set the name of the current gate. Start Get or set the start position of the selected gate (specified in seconds). Threshold Get or set the threshold level of the selected gate (specified in percentage [%] of full screen height). Type Get the gate type, which can take the following values: Synchro (Gate I), GateA, GateB, Main (A-scan), MainVideo (A-Scan video), MainPeak (A-Scan peak), Program Commands 149

158 Gate2Gate1 (Gate 2 - Gate 1), SoftGate (software A-scan), GateC, GateD, ThicknessGate, SoftI (software Gate I), SoftA (software Gate A), SoftB (software Gate B), SoftC (software Gate C), SoftD (software Gate D) IDataGroups The IDataGroups collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following elements: Methods GetDataGroup Get the first data group with the requested name, which can be either Ascan, AscanVideo, AscanPeak, CscanPeak, CscanTimeOfFlight, CscanCrossing, or Analog. GetDataSource Get the data groups source, which can be either TVFile, OmniFile, TVOnline, OmniFileUT128Pourcent, TVFileFromOmniscanUT128Pourcent, OmniOnline, or TVFileFromStandardOmniscan. SetDataSource For added data groups, set the data groups source, which can be either TVFile, OmniFile, TVOnline, OmniFileUT128Pourcent, TVFileFromOmniscanUT128Pourcent, OmniOnline, or TVFileFromStandardOmniscan. Property DataManager Get pointer on IDataManager interface. For a list of the commands available in the IDataManager interface, see section on page IDataManager The IDataManager collection contains the following methods: AddDatagroupFrom The AddDatagroupFrom function is not implemented in the NDT Remote Control Library. It is only available through the NDT Data Access Library. 150 Chapter 6

159 AddDatagroupFromID The AddDatagroupFromID function is not implemented in the NDT Remote Control Library. It is only available through the NDT Data Access Library IDataGroup The IDataGroup interface contains the following properties: DataAccess Get access to IDataAccess interface, which allows you to retrieve the acquisition data in the form of A-scans and C-scans. For a list of the commands available in the IDataAccess interface, see section on page 152. DataRectification Get or set the signal rectification type between NotRectified (the A-scan signal is displayed without any rectification), UnipolarPositif (only the positive part of the signal is kept), UnipolarNegatif (only the negative part of the signal is kept), and Bipolar (the negative part of the signal is brought back to the positive part). IndexQuantity Get or set the number of cells on the index axis (rows). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1)*(Index Resolution). IndexResolution Get or set the resolution of the index axis (specified in meters or degrees). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1)*(Index Resolution). Name Get the name of the selected data group. SampleQuantity Get or set the number of samples per data acquisition, that is, the number of points that compose the A-scan. For example, if you have a 10 µs A-scan digitized at 100 MHz, this value will be equal to (10 µs)*(100 MHz) = SampleResolution Get or set the resolution of each sample (specified in seconds). For example, if you have an A-scan digitized at 100 MHz, this value will be equal to (1)/(100 MHz) = s = 10 ns. Program Commands 151

160 ScanQuantity Get or set the number of cells on the scan axis (columns). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1)*(Scan Resolution). ScanResolution Get or set the resolution of the scan axis (specified in meters or degrees). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1)*(Scan Resolution). Type Get the current data group type, which can be either Ascan, AscanVideo, AscanPeak, CscanPeak, CscanTimeOfFlight, or CscanCrossing IDataAccess The IDataAccess interface contains the following methods: GetDataError Get an error code for a specified C-scan position based on the relative cell position inside the data grid. The possible error codes are: no error (0), no data (1), no signal has crossed the detection gate (2), and no detection on the synchronization gate (3). GetDataErrorBuffer Get the error codes for the full C-scan patch. The possible error codes are: no error (0), no data (1), no signal has crossed the detection gate (2), and no detection on the synchronization gate (3). GetDataErrorSlice Get the error codes for a specified slice of the full C-scan patch. The possible error codes are: no error (0), no data (1), no signal has crossed the detection gate (2), and no detection on the synchronization gate (3). ReadAscan Get the A-scan data for a specified position based on the relative cell position inside the data grid. ReadData Get either the A-scan or C-scan data for a specified position based on the relative cell position inside the data grid. 152 Chapter 6

161 ReadDataSlice Get a complete line of data in the scan axis or index axis dimension at the specified position (set EDataSliceType = 1 for the scan dimension or EDataSliceType = 2 for the index dimension). WriteData The WriteData function is not implemented in the NDT Remote Control Library. It is only available through the NDT Data Access Library IPartParameters The IPartParameters collection contains the following properties: InspectionType Get or set the current channel configuration, which can be either PulseEcho, Tofd, PitchCatch, or ThroughTransmission. InterfaceSoundVelocity Get or set the sound velocity inside water, which is always equal to 1483 (specified in meters per second). MaterialSoundVelocity Get or set the sound velocity inside the part (specified in meters per second). ProbeDelay Get or set the time taken by the transmitted ultrasound wave to travel across the wedge and be reflected back to the ultrasound element (specified in seconds). ProbeParallelToScan Indicates if the probe was positioned parallel or perpendicular to the inspected part (TRUE = parallel and FALSE = perpendicular). ProbeSeparation For TOFD applications, get or set the distance between the beam exit points (where the beam exits the wedge) of the two probes. Radius Get or set the radius of the inspected cylindrical part (specified in meters). For a flat surface this parameter will always be equal to 0. Surface Get or set the positioning of the probe which was used during the inspection. This parameter can take four values for cylindrical parts (CylOuterScanAlong, CylOuterScanAround, CylInnerScanAlong, or CylInnerScanAround) depending on whether the part was inspected on the outer or inner diameter and if the scan Program Commands 153

162 was performed on the longitudinal or radial axis. There is only one possibility for flat surfaces (FlatSurface). Thickness Get or set the thickness of the inspected flat or tube part (specified in meters). For a bar (filled cylinder), this value will always be equal to 0. WallThicknessType Get or set the wall thickness type for the inspected part, which can be either Constant or Variable. VWThicknessMin This function was designed for internal use by Olympus NDT only. VWThicknessMed This function was designed for internal use by Olympus NDT only. VWThicknessMax This function was designed for internal use by Olympus NDT only. VWThicknessMedStart This function was designed for internal use by Olympus NDT only. VWThicknessMedStop This function was designed for internal use by Olympus NDT only IFilterSettings The IFilterSettings interface contains the following properties: AnalogicSmoothing Get or set the frequency of the video filter which is used to filter the channel signal (specified in hertz). If no video filter was applied, this parameter is equal to 0. DigitalSmoothing Get or set if the digital smoothing is activated (TRUE = Digital Smoothing is active and FALSE = Digital Smoothing is not active). HighPass Get or set the frequency of the high-pass filter which is used to filter the channel signal (specified in hertz). LowPass Get or set the frequency of the low-pass filter which is used to filter the channel signal (specified in hertz). 154 Chapter 6

163 IDataGroup The IDataGroup interface contains the following properties: DataAccess Get access to IDataAccess interface, which allows you to retrieve the acquisition data in the form of A-scans and C-scans. For a list of the commands available in the IDataAccess interface, see section on page 152. DataRectification Get or set the signal rectification type between NotRectified (the A-scan signal is displayed without any rectification), UnipolarPositif (only the positive part of the signal is kept), UnipolarNegatif (only the negative part of the signal is kept), and Bipolar (the negative part of the signal is brought back to the positive part). IndexQuantity Get or set the number of cells on the index axis (rows). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1)*(Index Resolution). IndexResolution Get or set the resolution of the index axis (specified in meters). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1)*(Index Resolution). IndexUnit Get or set the index axis unit, which can be either meters or degrees. Name Get the name of the selected data group. SampleQuantity Get or set the number of samples per data acquisition, that is, the number of points that compose the A-scan. For example, if you have a 10 µs A-scan digitized at 100 MHz, this value will be equal to (10 µs)*(100 MHz) = SampleResolution Get or set the resolution of each sample (specified in seconds). For example, if you have an A-scan digitized at 100 MHz, this value will be equal to (1)/(100 MHz) = s = 10 ns. SampleUnit Get or set the ultrasound axis unit, which can be either seconds or samples. Program Commands 155

164 ScanQuantity Get or set the number of cells on the scan axis (columns). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1)*(Scan Resolution). ScanResolution Get or set the resolution of the scan axis (specified in meters). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1)*(Scan Resolution). ScanUnit Get or set the scan axis unit, which can be either meters or degrees. Type Get or set the current data group type, which can be either Ascan, AscanVideo, AscanPeak, CscanPeak, CscanTimeOfFlight, or CscanCrossing IInspectionControl The IInspectionControl interface contains the following elements: Methods AbortAcquisition Stop the current acquisition without saving the acquisition data and automatically return to setup mode. GetEncoderPosition Return the Scan and Index encoder positions (specified in meters). For a nonencoded configuration, these positions are always equal to 0. GoToInspectionSetupState Set the device to Setup Mode. PauseAcquisition Pause the acquisition, which can then be restarted with the StartAcquisition command to continue the inspection at the point it was paused. PresetEncoderPosition Reset the Scan and Index encoder positions to their preset values. StartAcquisition Start a new acquisition (which also clears the currently acquired data). StopAcquisition Stop the acquisition and save the acquisition data. 156 Chapter 6

165 Properties AcquisitionSequence Get the number corresponding to the current scan sequence. AutoNaming Get IAutoNaming interface. For a list of the commands available in the IAutoNaming interface, see section on page 157. InspectionState Get the current device state, which can be either Setup, Inspection, Analysis, or CommError (communication error with the inspection station) IAutoNaming The IAutoNaming interface contains the following elements: Method Update Set the AutoNaming changes to the current inspection system. Properties Counter Get or set the counter start value of the counter that is inserted in the file name with character. Directory Get or set the directory where data files are to be saved for the Automatic and Confirm saving modes. FileName Get or set the data file name for the Automatic and Confirm saving modes. character inserts a counter, and the # character adds the desired number of digits for repeats. SaveMode Get or set the current saving mode, which can either be Automatic (data files are automatically saved at the end of the inspection sequence in the specified directory), Manual (the automatic file naming is deactivated and you will be asked to enter the data file name at the end of every acquisition), or Confirm (the data file name must be confirmed before saving the data file). Program Commands 157

166 IUserInterfaceControl The IUserInterfaceControl interface contains the following elements: Methods Close Close the TomoView main window. HideWindow Hide the TomoView main window (only available for TomoView 2.9R4 or higher). Maximize Maximize the TomoView main window. Minimize Move Minimize the TomoView main window. Move the TomoView main window on the computer screen by the specified width (x) and height (y) coordinates. Restore Restore the TomoView main window to its previous state. ShowWindow Show the TomoView main window (only available for TomoView 2.9R4 or higher). Size Resize the TomoView main window on the computer screen to the specified width (x) and height (y). Properties CorePanel Get ICorePanel interface. For a list of the commands available in the ICorePanel interface, see section on page 160. LockClose Lock the Close TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). LockMaximize Lock the Maximize TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). 158 Chapter 6

167 LockMinimize Lock the Minimize TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). LockMove Lock the Move TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). LockRestore Lock the Restore TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). LockSize Lock the Size TomoView main window command (TRUE = Lock the command and FALSE = Unlock the command). UserMenu Get IUserMenu interface. For a list of the commands available in the IUserMenu interface, see section on page IUserMenu The IUserMenu interface contains the following properties: LockCloseFile Lock the Close File command in TomoView (TRUE = Lock the command and FALSE = Unlock the command). LockOpenFile Lock the Open File command in TomoView (TRUE = Lock the command and FALSE = Unlock the command). LockSaveFile Lock the Save File command in TomoView (TRUE = Lock the command and FALSE = Unlock the command). ShowApplicationMenu Show the TomoView menu bar (TRUE = Show the menu bar and FALSE = Hide the menu bar). Program Commands 159

168 ICorePanel The ICorePanel interface contains the following methods: ShowDisplayProperties Show the View Properties dialog box, used to consult and modify the various properties of the active pane. ShowMechanicalSettings Show the Scan and Mechanical Settings panel, used to define the scan and perform the settings for the mechanical scanning system. ShowUTSettings Show the UT Settings panel, used to configure the ultrasonic setup parameters IGeneralSettings The IGeneralSettings collection contains the following element: SystemUnit Get ISystemUnit interface. For a list of the commands available in the ISystemUnit interface, see section on page ISystemUnit The ISystemUnit interface contains the following elements: Method Update Set the new system unit information in TomoView. Property UnitSystem Get or set the current System Unit, which can be either Metric or Imperial. 160 Chapter 6

169 IOnlineSettings The IOnlineSettings interface contains the following properties: MechanicalSequences Get ISequences interface. For a list of the commands available in the ISequences interface, see section on page 161. UltrasoundSettingsCollection Get IUltrasoundSettingsCollection collection. For a list of the commands available in the IUltrasoundSettingsCollection interface, see section on page 164. UltrasoundSettings Get IUltrasoundSettings interface. For a list of the commands available in the IUltrasoundSettings interface, see section on page ISequences The ISequences collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following property: Update Set Sequences changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time ISequence The ISequence interface contains the following elements: Method Update Set Sequence changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties AlternateAxis Get IAxis interface. This interface is not available when using the free running or one-line scan sequence types. For a list of the commands available in the IAxis interface, see section on page 163. Program Commands 161

170 FiringMode Index Get or set the firing mode (trigger signal used to fire the ultrasonic pulses) between SynchroFreeRunning (fire on the internal counter), SynchroEncoder (fire on scan axis encoder), SynchroExtern (fire on an external synchronization I/O), or SynchroAbsolutePosition. Get the number corresponding to the active sequence in TomoView. IndexAxis Get IAxis interface for the Index axis. This interface is not available when using the free running or one-line scan sequence types. For a list of the commands available in the IAxis interface, see section on page 163. MechanicalAngle For an angular sequence (two-dimensional surface-scan sequence where the scan and index axes do not correspond to the orientation of the mechanical axes), get or set the angle that the scan line forms with the orientation of the mechanical axis. Name Get or set the name of the current sequence. PresetIndexMode Get or set the Index axis preset options between PresetIndexNone (no preset at acquisition end) and PresetIndexEndAcq (when the acquisition is stopped, the start value for the index axis is set to the current index axis encoder position). ResetScanEncoderMode Get or set the Scan axis reset option between ResetNone (the Scan axis is never reset), ResetByTopTour (the Scan axis is reset when an external signal is received on the corresponding instrument I/O connector), and ResetByModulo360 (the scan axis is reset when the Scan encoder reaches the Stop position). ScanAxis Get IAxis interface for the Scan axis. This interface is not available when using the free running sequence type. For a list of the commands available in the IAxis interface, see section on page 163. Type Get or set the Sequence type between Bidirectional, Unidirectional, OneLineScan, Helicoidal, FreeRunning, Angular (you must specify a mechanical angle), and Custom. 162 Chapter 6

171 IAxis The IAxis interface contains the following elements: Method Update Set Axis changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties AcquisitionSpeed Get or set the speed that the motor should follow during the inspection (only available when working in master mode with TomoView). DisplayResolution Get or set the acquisition resolution, which determines the spacing between the acquisitions. Encoder Get IEncoder interface. For a list of the commands available in the IEncoder interface, see section on page 164. Length Get or set the length of the inspection (specified in meters or degrees). PresetMode Get or set the Preset mode between Never (the encoder is never reset), OnStart (the encoder is reset when the acquisition is started), and External (the encoder is reset when an external signal is received on the corresponding instrument s I/O connector). PresetValue Get or set the encoder preset position. Start Get or set the position where the inspection sequence is to start. Type Get the current axis type between Scan, Index, and Alternate. Unit Specify the unit of the corresponding axis. The following units are available: distance in meters and rotation in degrees. Program Commands 163

172 IEncoder The IEncoder interface contains the following elements: Method Update Set Encoder changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties Input Get or set the number corresponding to the encoder between 0 for internal, and 1 to x for external encoders 1 to x. Inverse Get or set whether or not the encoder is inverted (TRUE = The encoder is inverted and FALSE = The encoder is not inverted). Name Get or set the name of the sequence for which the settings will be applied. Resolution Get or set the number of encoder steps needed to move 1 meter. Type Get or set the encoder type between Quadrature, PulsePlus (positive pulse), PulseLess (negative pulse), and ClockDir (clock direction) IUltrasoundSettingsCollection The IUltrasoundSettingsCollection collection contains, along with the NewEnum, Count, and Item properties, the following property: Method Update Set UltrasoundSettingsCollection changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. 164 Chapter 6

173 Property CurrentDevice Get the number corresponding to the acquisition unit for active channel IUltrasoundSettings The IUltrasoundSettings collection contains the following elements: Methods SetAcquisitionRate Set the current system pulse repetition frequency (PRF) value, which gives a measure of the number of ultrasonic pulse sequences (all beams from all channels being fired) generated per second (specified in hertz). You can either set this value to MaximumRate (which will set the AcquisitionRate to the maximum possible value) or CustomRate (which will set the AcquisitionRate to the specified value). Update Set UltrasoundSettings changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties AcquisitionRate Get the current system pulse repetition frequency (PRF) value, which gives a measure of the number of ultrasonic pulse sequences (all beams from all channels being fired) generated per second (specified in hertz). BoardType Indicates the currently connected acquisition unit, which be either FocusLT, OmniScanPA, OmniScanUT, FocusLT2, OmniScanMX2PA, OmniScanMX2UT, Focus, Utomo, Mcdu, TomoIII, TomoIIIPA, MS5800_UT, or UnknownBoard. DeviceID Get the number corresponding to the acquisition unit for the current UltrasoundSettings interface. PodElementConfig Get IPodElementConfig interface. For a list of the commands available in the IPodElementConfig interface, see section on page 175. Program Commands 165

174 UltrasoundChannels Get IUltrasoundChannels collection. For a list of the commands available in the IUltrasoundChannels interface, see section on page IUltrasoundChannels The IUltrasoundChannels collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following elements: Method Update Set UltrasoundChannels changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Property CurrentChannel Get or set the number corresponding to the active layout in the current layout file IUltrasoundChannel The IUltrasoundChannel interface contains the following elements: Method Update Set UltrasoundChannel changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties Beams Get IBeams interface. For a list of the commands available in the IBeams interface, see section on page Chapter 6

175 DataSettings Index Name Get IDataSettings interface. For a list of the commands available in the IDataSettings interface, see section on page 172. Get the position of the current UltrasoundChannel in the UltrasoundChannels collection. Get or set the current channel name. PulserReceiver Get pointer to PulserReceiver interface. PulserVoltage Get the pulse voltage of the pulser for the active channel (specified in volts). PulseWidth Get or set the pulse width of the pulser (specified in seconds). Recurrence Get or set the firing recurrence frequency, which is defined as the number of ultrasonic pulses generated per second for each beam in the current channel (specified in hertz). Type Get information on the channel type, which can be either MonoElement (Conventional UT) or PhasedArray. UltrasoundChannelMono Get IUltrasoundChannelMono interface. For a list of the commands available in the IUltrasoundChannelMono interface, see section on page 171. UltrasoundChannelPA Get IUltrasoundChannelPA interface. For a list of the commands available in the IUltrasoundChannelPA interface, see section on page 168. InspectionType Get or set the current channel configuration, which can be either TofdUT, UTPulseEcho, UTPitchCatch, PAPulseEcho, PAPitchCatch, or TofdPA IPulserReceiver The IPulserReceiver interface contains the following method: Update Set PulserReceiver changes to the current inspection system. Program Commands 167

176 IUltrasoundChannelPA The IUltrasoundChannelPA interface contains the following elements: Method Update Set UltrasoundChannelPA changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties AllBeamsConfig Get the IBeam interface, but the beam (focal law) settings will be applied to all beams (focal laws). GeneralGain Get or set the current channel gain. PhasedArrayMerged Get or set whether or not the Linear Merged is activated in TomoView (TRUE = Linear Merged mode is activated and FALSE = Linear Merged mode is not activated) IPositionOrientation The IPositionOrientation interface contains the following elements: Method Update Set PositionOrientation changes to the current inspection system. Properties Angle Get or set the refracted angle of the ultrasound beam (specified in degrees), which is defined as the angle between the central ray of the ultrasound beam in the material and the normal on the incidence plane inside the material. 168 Chapter 6

177 ReferenceIndexOffset Get or set the distance between the beam exit point (where the beam exits the wedge) and the zero position on the index axis (specified in meters). ReferenceScanOffset Get or set the distance between the beam exit point (where the beam exits the wedge) and the zero position on the scan axis (specified in meters). Skew Get or set the skew angle of the ultrasound beam (specified in degrees), which is defined as the angle between the ultrasound beam projection on the scanning surface and the primary axis of the array ITimeBase The ITimeBase interface contains the following elements: Method Update Set TimeBase changes to the current inspection system. Properties Range Get or set the range value of the selected beam (specified in seconds). Start Get or set the start value of the selected beam (specified in seconds) ISoundVelocity The ISoundVelocity interface contains the following elements: Method Update Set SoundVelocity changes to the current inspection system. Program Commands 169

178 Properties InWedge Get or set the sound velocity inside the wedge (specified in meters per second). Longitudinal Get or set the longitudinal wave propagation speed inside the material (specified in meters per second). Transversal Get or set the transversal wave propagation speed inside the material (specified in meters per second) IDACPoints The IDACPoints collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following elements: Method Update Set DACPoints changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Property Enable Enables the DAC (distance-amplitude correction) curve IDACPoint The IDACPoint interface contains the following elements: Method Update Set DACPoint changes to the current inspection system. 170 Chapter 6

179 Properties Gain Index Get or set the gain of the current DAC point gain value (specified in decibels). Get the number corresponding to the current DAC point in the DAC points collection. Position Get or set the position of the current DAC point (specified in seconds) IElements The IElements collection contains, along with the Add, Remove, and RemoveAll methods, and the NewEnum, Count, and Item properties, the following method: Update Set Elements changes to the current inspection system IElement The IElement interface contains the following properties: Delay Get or set the delay corresponding to the current element (specified in seconds). Index Get the number corresponding to the current element in the elements collection IUltrasoundChannelMono The IUltrasoundChannelMono interface contains the following elements: Method Update Set UltrasoundChannelMono changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Program Commands 171

180 Property BoosterGain Get or set if the booster function that adds a gain of 25 db to the receiver of the selected channel is activated (TRUE = Booster is activated and FALSE = Booster is not activated). Note that this function is only available for the utomoscan and TomoScan III acquisition units IDataSettings The IDataSettings collection contains the following elements: Method Update Set DataSettings changes to the current inspection system. Set the optional parameter to FALSE if you don t want to update the child objects at the same time. Properties Ascan Get IAscan interface. For a list of the commands available in the IAscan interface, see section on page 173. Averaging Get or set the number of A-scans acquired for each A-scan that is returned. The returned A-scan is obtained by calculating, for each sample, the average value over all the acquired A-scans. Cscan Get ICscan interface. For a list of the commands available in the ICscan interface, see section on page 173. DigitizingFrequency Get or set the digitizer frequency which is used for the acquisition (specified in hertz). Filter Get IFilter interface. For a list of the commands available in the IFilter interface, see section on page 175. Rectification Get or set the signal rectification type between NotRectified (the A-scan signal is displayed without any rectification), UnipolarPositif (only the positive part of the 172 Chapter 6

181 signal is kept), UnipolarNegatif (only the negative part of the signal is kept), and Bipolar (the negative part of the signal is brought back to the positive part) IAscan The IAscan interface contains the following elements: Method Update Set Ascan changes to the current inspection system. Properties Compression Get or set the digitizer compression ratio, which is used to reduce the sample quantity (and thus data file size) by keeping the position of the first sample with the maximum amplitude detected over the number of considered samples. ProduceData Get or set if A-Scan data is produced (TRUE = A-Scan data is produced and FALSE = A-Scan data is not produced). ProduceVideoData Get or set if A-Scan Video data is produced (TRUE = A-Scan Video data is produced and FALSE = A-Scan Video data is not produced). ProduceConditionalData Get or set if the Conditional A-Scan function was activated, which allows the A-Scans to be recorded only when an alarm was triggered (TRUE = Conditional A-Scan is activated and FALSE = Conditional A-Scan is not activated) ICscan The ICscan interface contains the following elements: Method Update Set Cscan changes to the current inspection system. Set the optional parameter to FALSE if you do not want to update the child objects at the same time. Program Commands 173

182 Properties Gate0ProducePositionData Get or set if Gate 0 (also referred to as Gate I) will produce position C-Scan data (TRUE = Gate 0 will produce position C-Scan data and FALSE = Gate 0 will not produce position C-Scan data). Gate1ProduceAmplitudeData Get or set if Gate 1 (also referred to as Gate A) will produce amplitude C-Scan data (TRUE = Gate 1 will produce amplitude C-Scan data and FALSE = Gate 0 will not produce amplitude C-Scan data). Gate1ProducePositionData Get or set if Gate 1 (also referred to as Gate A) will produce position C-Scan data (TRUE = Gate 1 will produce position C-Scan data and FALSE = Gate 1 will not produce position C-Scan data). Gate2Gate1ProducePositionData Get or set if Gate 2 - Gate 1 (also referred to as POS B - POS A ) will produce position C-Scan data (TRUE = Gate 2 - Gate 1 will produce position C-Scan data and FALSE = Gate 2 - Gate 1 will not produce position C-Scan data). Note that this position C-Scan data will correspond to the subtraction of the Gate 1 position data from the Gate 2 position data. Gate2ProduceAmplitudeData Get or set if Gate 2 (also referred to as Gate B) will produce amplitude C-Scan data (TRUE = Gate 2 will produce amplitude C-Scan data and FALSE = Gate 2 will not produce amplitude C-Scan data). Gate2ProducePositionData Get or set if Gate 2 (also referred to as Gate B) will produce position C-Scan data (TRUE = Gate 2 will produce position C-Scan data and FALSE = Gate 2 will not produce position C-Scan data). Gate3ProduceAmplitudeData Get or set if Gate 3 (also referred to as Gate C) will produce amplitude C-Scan data (TRUE = Gate 3 will produce amplitude C-Scan data and FALSE = Gate 3 will not produce amplitude C-Scan data). Gate3ProducePositionData Get or set if Gate 3 (also referred to as Gate C) will produce position C-Scan data (TRUE = Gate 3 will produce position C-Scan data and FALSE = Gate 3 will not produce position C-Scan data). 174 Chapter 6

183 Gate4ProduceAmplitudeData Get or set if Gate 4 (also referred to as Gate D) will produce amplitude C-Scan data (TRUE = Gate 4 will produce amplitude C-Scan data and FALSE = Gate 4 will not produce amplitude C-Scan data). Gate4ProducePositionData Get or set if Gate 4 (also referred to as Gate D) will produce position C-Scan data (TRUE = Gate 4 will produce position C-Scan data and FALSE = Gate 4 will not produce position C-Scan data) IFilter The IFilter interface contains the following elements: Method Update Set Filter changes to the current inspection system. Properties ProbeFrequency Get or set the high pass and low pass filters simultaneously (specified in hertz). The first match at a frequency higher will be selected when no filter is available at the requested frequency. Smoothing Get or set the smoothing filter frequency (specified in hertz) IPodElementConfig The IPodElementConfig interface contains the following properties: MaximumAperture Get the number of active channels available on the current acquisition unit (consecutive probe elements that can be pulsed in a single beam). MaximumElement Get the total number of available channels on the current acquisition unit. SumPulseReceiveForPC Indicates whether or not the current acquisition unit is a P model (TRUE = The current acquisition unit is a P model and FALSE = The current acquisition unit Program Commands 175

184 is a R model). See the user s manual of your acquisition unit for more details on these two models ICustomControls The ICustomControls collection contains, along with the NewEnum, Count, and Item properties, the following method: FindControl Get the Custom Control with the specified name (see section on page 183 for more details) ICustomControl The ICustomControl interface contains the following elements: Methods IsVisible This function was designed for internal use only. It indicates whether or not the current custom control is visible (TRUE = The Custom Control is visible and FALSE = The Custom Control is not visible). ShowDialog Get the dialog box associated with the selected custom control. Property Identification This function was designed for internal use only TomoViewActiveX The TomoViewActiveX contains the following methods: HookTomoView Hook the active TomoView application inside the defined frame. UnHookTomoView Unhook the active TomoView application from the defined frame. 176 Chapter 6

185 6.2.2 Commands for OmniScan ix Remote Control The methods described in this section can be used to send remote commands to an inspection station equipped with an OmniScan ix IOmniscan The IOmniscan interface contains the following methods: MapRemotePC Initialize the specified computer, which can then be used as a remote storage location. UnMapRemotePC Remove the specified computer from the remote storage location options. StorageLocation Get or set the location of all files for the load and save commands IOmniscanOnlineData The IOmniscanOnlineData interface contains the following methods: AutomaticallySyncronizeNewData Initialize the automatic online data transfer from the OmniScan. SynchronizeAllData Synchronize all the data from the OmniScan IOnlineDataAccess The IonlineDataAccess interface contains the following method: GetCurrentPosition Get the position of the last acquired data Commands for Events Monitoring The events described in this section can be used get information on the current state of the inspection station. Program Commands 177

186 IInspectionControlEvents This section presents the available notifications for the IInspectionControl interface for both TomoView and the OmniScan. It contains the following methods: AcquisitionAborted Get a notification when the acquisition has aborted. AcquisitionStarted Get a notification when the acquisition has started. AcquisitionStopped Get a notification when the acquisition has stopped. Error Get a notification when an error has occurred, which is accompanied by a short description of the error type. AcquisitionPaused Get a notification when the acquisition has paused. AlarmChanged Get a notification when an alarm output has changed, which is accompanied by the encoder position where the alarm output has changed and the alarm status. Each bit in the bit field represents an alarm output beginning with the least significant bit as the first alarm output. A bit value of one represents an active alarm output while a bit value of 0 indicates an inactive alarm output (not supported by TomoView). AcquisitionMemoryWarning Get a notification that a certain percentage of the available memory has been reached when working with the Conditional A-Scan mode INDTRemoteControlEvents This section presents the available notifications for the INDTRemoteControl interface for both TomoView and the OmniScan. It contains the following method: Error Get a notification when an error has occurred, which is accompanied by a short description of the error type. 178 Chapter 6

187 IOnlineDataEvents This section presents the available notifications for the IOnlineData interface for the OmniScan. It contains the following methods: BeforeDataTreeChange Get a notification before the NDT Data Access tree structure changes. After this event, data will not be available as the IChannels collection in the IOnlineData interface and all objects below will be destroyed. All pointers to such structures should be freed upon reception of this event as addresses of structures are likely to be changed or invalid. AfterDataTreeChange Get a notification that the NDT Data Access tree structure has completed its reconstruction and that the IChannel collection can now be safely accessed. PatchChange Get a notification when the mechanical patch has changed in size or resolution. Error Get a notification when an error has occurred, which is accompanied by a short description of the error type IUserInterfaceControlEvents This section presents the available notifications for the IUserInterfaceControl interface for TomoView. Note that there is a short time difference between the reception of the notification and the effectiveness of the command. It contains the following methods: Minimize Get a notification that the TomoView main window is about to be minimized. Maximize Get a notification that the TomoView main window is about to be maximized. Size Get a notification that the TomoView main window has been resized on the computer screen to the specified width (x) and height (y). Move Get a notification that the TomoView main window has been moved on the computer screen by the specified width (x) and height (y) coordinates. Program Commands 179

188 Restore Close Get a notification that the TomoView main window is about to be restored to its previous state. Get a notification that you are about to quit TomoView. TextMessage Get a notification when a message must be shown to the user, accompanied by a short description of the message Commands for OmniScan EC Remote Control The methods described in this section can be used to send remote commands to an inspection station equipped with an OmniScan EC IOmniscan The IOmniscan interface contains the following methods: MapRemotePC Initialize the specified computer, which can then be used as a remote storage location. UnMapRemotePC Remove the specified computer from the remote storage location options. StorageLocation Get or set the location of all files for the load and save commands. SetupList Get a list of the available setup files on the OmniScan EC IOnlineDataEC The IOnlineDataEC interface contains the following property: Groups Get IGroups interface. For a list of the commands available in the IGroups interface, see section on page IGroups The IGroups collection contains the NewEnum, Count, and Item properties. 180 Chapter 6

189 IGroup The IGroup interface contains the following properties: DataGroups Get IDataGroups interface. For a list of the commands available in the IDataGroups interface, see section on page 181. IsEnabled Get whether or not the selected group is enabled to get information (TRUE = Group is enabled to get information and FALSE = Group is not enabled to get information). Name Get the name of the selected group IDataGroups The IDataGroups collection contains the NewEnum, Count, and Item properties IDataGroup The IDataGroup interface contains the following properties: DataAccess Get access to IDataAccess interface, which allows you to retrieve the C-scan acquisition data. For a list of the commands available in the IDataAccess interface, see section on page 182. DataGroupParam Get IDataGroupParam interface. For a list of the commands available in the IDataGroupParam interface, see section on page 182. Name Get the name of the selected data group. PatchParam Get IPatchParam interface. For a list of the commands available in the IPatchParam interface, see section on page 182. Program Commands 181

190 IDataAccess The IDataAccess interface contains the following methods: GetDataError Get an error code for a specified C-scan position based on the relative cell position inside the data grid. The possible error codes are: no error (0) and no data (1). GetDataErrorBuffer Get the error codes for the full C-scan patch. The possible error codes are: no error (0) and no data (1). ReadData Get all C-scan data for a specified position based on the relative cell position inside the data grid IDataGroupParam The IDataGroupParam interface contains the following property: Type Get or set the current datagroup type, which can be either Horizontal or Vertical IPatchParam The IDataGroupParam interface contains the following properties: IndexQuantity Get or set the number of cells on the index axis (rows). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1) * Index Resolution. IndexResolution Get or set the resolution of the index axis (specified in meters). The total index length can then be obtained by performing the following calculation: Index Length = (Index Quantity - 1) * Index Resolution. ScanQuantity Get or set the number of cells on the scan axis (columns). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1) * Scan Resolution. 182 Chapter 6

191 ScanResolution Get or set the resolution of the scan axis (specified in meters). The total scan length can then be obtained by performing the following calculation: Scan Length = (Scan Quantity - 1) * Scan Resolution IInspectionControl (IInspectionControlEC) The IInspectionControl interface contains the following method: Balance Balance the probe (which also clears the currently acquired data) Custom Controls This section presents the description of the functions accessible in ICustomControls. There are three merge types you can control through the ICustomControls command: data file merge, C-scan merge, and volumetric merge. These merges are described briefly in this section. For more information, refer to the TomoView User s Manual. Data File Merge The data file merge is very useful for applications where the inspection of a component is done in sections. Each section produces its own data file. With the data file merge, you merge these files and create one file covering the complete inspected component. You can merge all data files or select the files for the component sections you want to merge. C-Scan Merge The C-scan merge, as the data file merge, is used for applications where the inspection of a component is done in sections. Each section produces its own C-scan file. You can merge these files and create one file covering the complete inspected component. You can select the type of data to merge: minimum amplitude, maximum amplitude, or minimum position. Program Commands 183

192 You can merge all C-scan files or select the files for the component sections you want to merge. Volumetric Merge The volumetric merge function allows you to perform the merge of the ultrasound data acquired with various acoustic beams, as generated by the corresponding channels and/or focal laws. This merging process compares the amplitude obtained in each point of the inspected volume by the considered channels and/or focal laws, and creates a new data group with the maximum amplitude observed at each position in the inspected volume. You can select the type of data to merge: A-scan, C-scan, or peak. You can merge all channels of the selected data type or choose the channels to merge. Getting a Merge Type To get the merge type you want, you must type the exact name as shown here. For file merge, you must type DataFileMerger For C-scan merge, you must type CScanMerger For volumetric merge, you must type VolumetricMerge The following is an example of find command for the file merge function: NDTRemoteControlDefinition::ICustomControlPtr pcustomcontrol = pndtremotecontrol->customcontrols->findcontrol( DataFileMerger ); DataFileMerger::IDataFileMergerPtr pdatafilemerger = pcustomcontrol; pdatafilemerger->mergedatafiles( ArrayFile, _bstr_t(m_csfilenamedestination) ); ArrayFile is a SAFEARRAY with the list of files to merge. For more information, refer to the application example in: C:\OlympusNDT\NDTRemoteControlLibraryXX\Samples\Test TomoView VC 6.0\Release. 184 Chapter 6

193 6.3 Applying Settings This section presents the way the settings are applied for TomoView. The ultrasound settings (IOnlineSettings) and mechanical settings (IMechanicalSequences) are not applied as you are setting them. To make the changes effective, you must update the settings once the setup is ready. Collections and objects can be updated individually or updated at once in a chain reaction from the primary collection to the end collection. Program Commands 185

194 186 Chapter 6

195 7. Notification This chapter presents the notifications that TomoView or the OmniScan can send. TomoView supports most commands described in this section. The label [Not supported by TomoView] is added at the end of the description for the few commands that are not supported by TomoView. 7.1 IInspectionControlEvents This section presents the notifications available for the acquisition sequences for both TomoView and the OmniScan. The IInspectionControlEvents interface contains the following methods: AcquisitionStarted You get notified when the acquisition has in fact started. AcquisitionAborted You get notified when the acquisition has in fact aborted. AcquisitionStopped You get notified when the acquisition has in fact stopped. Error You get notified when an error has occurred. It is accompanied with a short description of the type of error. AcquisitionPaused You get notified when acquisition is in a suspended state. AlarmChanged You get notified when an alarm output has changed. The event informs of the encoder position where alarm outputs changed and uses a bitfield to represent Notification 187

196 alarm status. Each bit in the bitfield represents an alarm output beginning with the least significant bit as alarm output one. A bit value of one represents an alarm active while a bit value of 0 indicates an inactive alarm output. [Not supported by TomoView] 7.2 INDTRemoteControlEvents This section presents the notification available for the NDT Remote Control Library COM component for both TomoView and for the OmniScan. The INDTRemoteControlEvents interface contains the following method: Error You get notified when an error has occurred. It is accompanied with a short description of the type of error. 7.3 IUserInterfaceControlEvents This section presents the notifications available for the user interface for TomoView. They are not supported by the OmniScan. There is a short time laps between the reception of the notification and the effectiveness of the command. You can pause the completion of the command if you need to. If not, the command will be carried out. The IUserInterfaceControlEvents interface contains the following methods: Minimize You get notified that the TomoView main window is about to be minimized. Maximize You get notified that the TomoView main window is about to be maximized. Size You get notified that the TomoView main window is about to be resized on the computer screen according to the size specified (width x, height y). Move You get notified that the TomoView main window is about to be moved on the computer screen according to the coordinate specified (width x, height y). 188 Chapter 7

197 Restore Close You get notified that the TomoView main window is about to be restored to the previous state. You get notified that you are about to quit TomoView. 7.4 IOnlineDataEvents This section presents notifications available for online data. They are available only for the OmniScan as they are not supported by TomoView. Online data events are used to inform of changes in data size or arrangement. The IOnlineDataEvents interface contains the following methods: BeforeDataTreeChange You get notified before the NDT Data Access tree structure changes. After this event, data will not be available as the OnlineData s Channel collection and all objects below will be destroyed. All pointers to such structures should be freed upon reception of this event as addresses of structures are likely to be changed or invalid. AfterDataTreeChange You get notified that the NDT Data Access tree structure has completed its reconstruction and that the Channel collection can now be safely accessed. PatchChange You get notified that the mechanical patch has changed in size or resolution. Error You get notified that an error has occurred. It is accompanied with a short description of the type of error. Notification 189

198 190 Chapter 7

199 8. Reading Online Data This section explains online data access. Online data uses the NDT Data Access Library architecture. The following information is available through NDT Remote Control Library s integration of the NDT Data Access Library: IChannel::name IChannel::beams (IBeams) IBeam::name IBeam::gates (IGates) IBeam::referenceIndexOffset IBeam::referenceScanOffset IGate::name IGate::dataGroups (IDataGroups) IGate::start IGate::width IGate::level IGate::rectification IGate::type IDataGroups:name IDataGroups::dataSource IDataGroup::dataAccess (IDataAccess) IDataGroup::dataRectification IDataGroup::indexQuantity IDataGroup::indexResolution IDataGroup::scanQuantity IDataGroup::scanResolution Reading Online Data 191

200 IDataGroup::type A code example for reading online data is provided in Appendix B on page 209. For a complete reference on the NDT Data Access structure and access to object members and methods, refer to the description of the stored inspection data in the NDT Data Access Library User s Manual document. 192 Chapter 8

201 9. Troubleshooting This chapter presents troubleshooting guides for errors that may arise while using NDT Remote Control Library. Each section covers one category of errors and includes a table presenting the error codes, their descriptions, and the associated solutions. 9.1 Troubleshooting First Steps Before contacting The Olympus NDT technical support, it is recommended to perform the following short steps. These steps will help solve simple and common issues, and gather essential information that will speed up solving remaining issues in case technical support needs to be contacted. To perform the troubleshooting first steps 1. Verify which version of the Windows operating system is installed on your computer. To retrieve the Windows operating system version under Windows XP a) On the taskbar, click Start. b) Right-click My Computer, and then click Properties. c) Click the General tab (see Figure 9-1 on page 194). Under System, the version of the operating system is displayed. Troubleshooting 193

202 Figure 9-1 Windows XP version number in the System Properties dialog box To retrieve the Windows operating system version under Windows 7 a) On the taskbar, click Start. b) Right-click Computer, and then click Properties (see Figure 9-2 on page 195). Under Windows edition, the version of the operating system is displayed. 194 Chapter 9

203 Figure 9-2 The Windows Control Panel displaying the Windows edition Verify that you are running on either Windows 7 or Windows XP Service Pack 3 or higher. 2. Verify that a HASP key containing a NDT Remote Control Library licence is properly connected on your computer. On the Windows taskbar, click Start, click All Programs, click Olympus NDT, and then click Keytool [Version Number] (see Figure 9-3 on page 196). Troubleshooting 195

204 Figure 9-3 The KeyTool window showing the NDT Remote Control Library license Verify that your HASP key is properly recognized by the Keytool software and contains the NDT Remote Control Library software licence. 3. If working remotely, verify that the Ethernet cables used to communicate with the OmniScan ix are crosslink Ethernet (RJ-45) cable category 5e or better. Try using different cables of the same category to see if this corrects the problem. 4. If applicable, verify that your antivirus software is not preventing the NDT Remote Control Library from working correctly. 5. If applicable, verify that your firewall software is not preventing the NDT Remote Control Library from working correctly. 6. Reinstall the latest NDT Remote Control Library version on your computer. For more information, see section 1.3 on page Chapter 9