Summary of the content on the page No. 1
iTool
Programming
IDL Version 7.0
November 2007 Edition
Copyright © ITT Visual Information Solutions
All Rights Reserved
1107IDL70ITD
Summary of the content on the page No. 2
Restricted Rights Notice ® The IDL®, IDL Analyst™, ENVI , and ENVI Zoom™ software programs and the accompanying procedures, functions, and documentation described herein are sold under license agreement. Their use, duplication, and disclosure are subject to the restrictions stated in the license agreement. ITT Visual Information Solutions reserves the right to make changes to this document at any time and without notice. Limitation of Warranty ITT Visual Information Solutions makes no warrant
Summary of the content on the page No. 3
Contents Chapter 1 Overview of iTools ................................................................................... 9 What are iTools? ............................................................................................................. 10 What is the iTools Component Framework? ................................................................... 11 About this Manual ........................................................................................................... 12 About
Summary of the content on the page No. 4
4 Registering Components .................................................................................................. 38 iTool Messaging System .................................................................................................. 41 System Resources ............................................................................................................ 44 Chapter 3 Data Management ................................................................................. 51 Overview
Summary of the content on the page No. 5
5 Chapter 6 Creating a Visualization ...................................................................... 113 Overview of iTool Visualization Types ........................................................................ 114 Predefined iTool Visualization Classes ......................................................................... 115 Creating a New Visualization Type .............................................................................. 121 Registering a Visualization Type ......
Summary of the content on the page No. 6
6 Creating a New File Reader ........................................................................................... 234 Registering a File Reader ............................................................................................... 245 Unregistering a File Reader ........................................................................................... 246 Example: TIFF File Reader ........................................................................................... 248 Cha
Summary of the content on the page No. 7
7 Chapter 14 Creating a User Interface Panel ......................................................... 311 Overview of the iTool UI Panel .................................................................................... 312 Creating a UI Panel Interface ........................................................................................ 313 Creating Callback Routines ........................................................................................... 318 Registering a UI Panel ....
Summary of the content on the page No. 8
8 Appendix B iTool Compound Widgets .................................................................. 397 Overview of iTools Compound Widgets ....................................................................... 398 CW_ITMENU ................................................................................................................ 399 CW_ITPANEL .............................................................................................................. 404 CW_ITSTATUSBAR .............
Summary of the content on the page No. 9
Chapter 1 Overview of iTools This chapter provides an overview of the IDL iTool Component Framework. What are iTools? . . . . . . . . . . . . . . . . . . . . . 10 About the iTools Code Base . . . . . . . . . . . . 13 What is the iTools Component Framework? 11 Skills Required to Use the iTools Component Framework . . . . . . . . . . . . . . . . . . . . . . . . . 15 About this Manual . . . . . . . . . . . . . . . . . . . . 12 iTool Developer’s Guide 9
Summary of the content on the page No. 10
10 Chapter 1: Overview of iTools What are iTools? IDL Intelligent Tools, or iTools, are applications written in IDL to perform a variety of data analysis and visualization tasks. iTools share a common underlying application framework, presenting a full-featured, customizable, application-like user interface with menus, toolbars, and other graphical features. Several predefined iTools are provided along with IDL; you can use these tools to explore and visualize your data without writing any
Summary of the content on the page No. 11
Chapter 1: Overview of iTools 11 What is the iTools Component Framework? The iTools component framework is a set of object class definitions written in the IDL language. It is designed to facilitate the development of sophisticated visualization tools by providing a set of pre-built components that provide standard features including: creation of visualization graphics mouse manipulations of visualization graphics annotations management of visualization and application properties un
Summary of the content on the page No. 12
12 Chapter 1: Overview of iTools About this Manual The iTool Developer’s Guide describes the IDL iTools component framework and provides examples of its use. After reading this manual, you will understand how to use the component framework to create your own intelligent tools. This manual is divided into three parts: Part I: Understanding the iTools Component Framework This section describes the iTools component framework in conceptual terms, and outlines some of the processes you will use in
Summary of the content on the page No. 13
Chapter 1: Overview of iTools 13 About the iTools Code Base The iTools component framework is written almost entirely in the IDL language. The IDL code that implements both the component framework and all of the standard iTools included with IDL is available for you to inspect, copy, and learn from. To inspect the iTools code, look in the lib/itools subdirectory of your IDL installation directory. The iTools code base is organized as follows: In thelib/itools directory you will find code th
Summary of the content on the page No. 14
14 Chapter 1: Overview of iTools The core iTool component framework classes used to build individual iTools, visualization types, operations, etc. are formally documented in the IDL Reference Guide and discussed in detail in this manual. If an object class, method, or property is necessary for the construction of a new iTool or component of an iTool, it is formally documented in the IDL Reference Guide or in this manual. Core iTool framework classes are located in the lib/itools/framewor
Summary of the content on the page No. 15
Chapter 1: Overview of iTools 15 Skills Required to Use the iTools Component Framework The iTools component framework consists of a set of IDL object classes, supplemented by utility routines. If you are already familiar with the concepts of object-oriented programming, or have written programs that use IDL object graphics, you will find the iTools framework easy to understand and use. The framework approach means that most of the details of creating a full-featured and usable application
Summary of the content on the page No. 16
16 Chapter 1: Overview of iTools Skills Required to Use the iTools Component Framework iTool Developer’s Guide
Summary of the content on the page No. 17
Part I: Understanding the iTools Component Framework
Summary of the content on the page No. 18
Summary of the content on the page No. 19
Chapter 2 iTool System Architecture This chapter describes the iTool component framework architecture. Overview of the iTool System Architecture 20 Registering Components . . . . . . . . . . . . . . 38 iTools Object Model Diagram . . . . . . . . . . . 21 iTool Messaging System . . . . . . . . . . . . . . 41 iTool Object Identifiers . . . . . . . . . . . . . . . . 28 System Resources . . . . . . . . . . . . . . . . . . . . 44 iTool Object Hierarchy . . . . . . . . . . . . . . . . 31 iToo
Summary of the content on the page No. 20
20 Chapter 2: iTool System Architecture Overview of the iTool System Architecture The iTool system architecture is designed to maintain a separation between the functionality provided by an iTool and the graphical presentation layer that reveals that functionality to an iTool user (the iTool user interface). Such a separation allows for the creation of different user interfaces for the same underlying functionality; while the initial iTool user interface has been created using IDL widgets, i
