ITT Rule IDL Version 7.0 User Manual Page 136
- Page / 430
- Table of contents
- BOOKMARKS
Rated. / 5. Based on customer reviews
136 Chapter 6: Creating a Visualization
Registering a Visualization Type iTool Developer’s Guide
Registering a Visualization Type
Before a visualization of a given type can be created by an iTool, the visualization
type’s class definition must be registered as being available to the iTool. Registering
a visualization type with the iTool links the class definition file containing the actual
IDL code that defines the visualization type with a simple string that names the type.
Code that creates a visualization in an iTool uses the name string to specify which
type of visualization should be created. In addition, some operations and
manipulators will operate only on specific visualization types; these limits are also
specified using the name string.
Using IDLitTool::RegisterVisualization
In most cases, you will register a visualization type with the iTool in the iTool’s class
Init method. Registration ensures that the visualization type is available when the
iTool attempts to create a visualization. (See “Creating a New iTool Class” on
page 91 for details on the iTool class Init method.)
To register a visualization, call the IDLitTool::RegisterVisualization method:
self->RegisterVisualization,
Visualization_Type
, $
VisType_Class_Name
where Visualization_Type is the string you will use when referring to the
visualization type, and VisType_Class_Name is a string that specifies the name of the
class file that contains the visualization type’s definition.
Note
The file
VisType_Class_Name
__define.pro must exist somewhere in IDL’s
path for the visualization type to be successfully registered.
See “IDLitTool::RegisterVisualization” (IDL Reference Guide) for details.
Specifying Useful Properties
You can set any property of the IDLitVisualization and IDLitComponent classes
when registering a visualization. The following properties may be of particular
interest:
ICON
A string value giving the name of an icon to be associated with this object. Typically,
this property is the name of a bitmap file to be used when displaying the object in a
- Programming 1
- Restricted Rights Notice 2
- Limitation of Warranty 2
- Export Control Information 2
- Acknowledgments 2
- Contents 3
- Overview of iTools 9
- What are iTools? 10
- About this Manual 12
- About the iTools Code Base 13
- Framework 15
- Part I: Understanding 17
- Architecture 19
- IDLitVisualization Classes 23
- IDLitTool Classes 23
- IDLitData Classes 24
- IDLitReader Classes 24
- IDLitWriter Classes 25
- IDLitOperation Classes 25
- IDLitManipulator Classes 26
- Atomic Graphic Objects 26
- • IDLgrPlot • IDLgrText 27
- • IDLgrPolygon • IDLgrVolume 27
- MY DATA object is visible to 28
- Using Identifiers 29
- Retrieving Identifiers 29
- Proxy Identifiers 30
- Object Descriptors 30
- OPERATIONS/OPERATIONS/ROTATE 31
- FILE READERS/ASCII TEXT 34
- FILE WRITERS/WINDOWS BITMAP 34
- MANIPULATORS/ROTATE 34
- OPERATIONS/FILE/OPEN 34
- TOOLBAR/FILE/OPEN 35
- WINDOW/VIEW_1 35
- Registering Components 38
- Specifying Object Identifiers 39
- Proxy Registration 39
- TOOLBAR/EDIT/UNDO: 40
- Sending Notifications 41
- Notification Messages 42
- Observers 43
- System Resources 44
- Help System 45
- Format of Help Entries 46
- Data Management 51
- 52 Chapter 3: Data Management 52
- Chapter 3: Data Management 53 53
- Composite Data Types 54
- Chapter 3: Data Management 55 55
- Data Objects 56
- Data Containers 56
- Parameter Sets 57
- Predefined iTool Data Classes 58
- IDLitDataIDLImage 59
- IDLitDataIDLImagePixels 59
- IDLitDataIDLPalette 59
- IDLitDataIDLPolyvertex 59
- IDLitDataIDLVector 60
- Parameters 61
- ParmameterName 62
- DataType1 62
- DataTypeN 62
- Data Type Matching 63
- 64 Chapter 3: Data Management 64
- Data Update Mechanism 65
- 66 Chapter 3: Data Management 66
- Property Management 67
- What is a Property? 68
- Properties vs. Preferences 68
- How are Properties Displayed? 69
- Property Data Types 69
- Property Registration 70
- Property Identifiers 70
- Property Attributes 70
- Property Aggregation 70
- User Defined Property Types 73
- Pre-Registered Properties 75
- USERDEF (Get, Set) 80
- VALID_RANGE (Get, Set) 80
- Intersection 82
- Property Update Mechanism 84
- Part II: Using the 87
- Creating an iTool 89
- Overview of iTool Creation 90
- Creating a New iTool Class 91
- PRO FirstExampleTool__Define 92
- Registering Visualizations 95
- Registering Operations 96
- Registering Manipulators 97
- ReaderType_Class_Name 98
- WriterType_Class_Name 98
- Unregistering Components 100
- Registering a New Tool Class 101
- Arguments 103
- Keywords 103
- Creating Data Objects 104
- Handling Errors 105
- Creating an iTool Instance 106
- Example: Simple iTool 108
- Launch Routine 110
- Launch Routine Discussion 111
- 'Palette' 112
- "Example 1 Tool" 112
- Creating a Visualization 113
- IDLitVisAxis 115
- IDLitVisColorbar 115
- IDLitVisContour 115
- IDLitVisHistogram 115
- IDLitVisImage 116
- IDLitVisImagePlane 116
- IDLitVisIntVol 116
- IDLitVisIsosurface 116
- IDLitVisLegend 117
- IDLitVisLegendItem 117
- IDLitVisLight 117
- IDLitVisLineProfile 117
- IDLitVisMapGrid 117
- IDLitVisPlot 118
- IDLitVisPlotProfile 118
- IDLitVisPlot3D 118
- IDLitVisPolygon 118
- IDLitVisPolyline 119
- IDLitVisRoi 119
- IDLitVisShapePoint 119
- IDLitVisShapePolygon 119
- IDLitVisShapePolyline 119
- IDLitVisSurface 120
- IDLitVisText 120
- IDLitVisVolume 120
- ObjectClass 121
- Creating an Init Method 123
- Superclass Initialization 124
- Return Value 125
- Registering Parameters 125
- Registering Properties 125
- PropertyIdentifier 126
- TypeCode] $ 126
- [, ATTRIBUTE = value] 126
- Object_Reference 126
- Setting Property Attributes 127
- Example Init Method 128
- Creating a Cleanup Method 130
- Creating a GetProperty Method 131
- Creating a SetProperty Method 132
- ExampleVis object’s 133
- _extra structure 133
- ExampleVis 135
- Specifying Useful Properties 136
- Finding the Identifier String 138
- Class Definition File 140
- Init Method 141
- OnDataChangeUpdate Method 142
- OnDataDisconnect Method 144
- Creating an Operation 145
- Predefined iTool Operations 148
- Data-Centric Operations 150
- Generalized Operations 151
- SomeOperationClass 156
- Creating an Execute Method 159
- ) ? 255b : MAX(data) 160
- ) ? 0b : MIN(data) 160
- Example SetProperty Method 163
- How an IDLitOperation Works 165
- Creating an IDLitOperation 165
- Creating a DoAction Method 172
- Example UndoOperation Method 178
- Example RedoOperation Method 179
- Operations and Macros 181
- Registering an Operation 182
- Unregistering an Operation 184
- Execute Method 188
- GetProperty Method 189
- SetProperty Method 190
- Creating a Manipulator 193
- Manipulator Visuals 195
- Predefined iTool Manipulators 198
- Image Manipulators 199
- Plot and Contour Manipulators 200
- Surface Manipulators 200
- Volume Manipulators 201
- The RecordUndoValues Method 203
- The CommitUndoValues Method 203
- Using the ButtonPress Field 204
- Creating a New Manipulator 206
- The Manipulator Init Function 208
- Creating Mouse Event Methods 213
- Creating an OnWheel Method 216
- Example OnWheel Method 217
- Creating an OnKeyboard Method 218
- ExampleManip operation: 221
- Registering a Manipulator 223
- Unregistering a Manipulator 225
- Creating a File Reader 229
- Predefined iTool File Readers 231
- IDLitReadISV 232
- IDLitReadJPEG 232
- IDLitReadJPEG2000 232
- IDLitReadPICT 232
- IDLitReadPNG 233
- IDLitReadShapefile 233
- IDLitReadTIFF 233
- IDLitReadWAV 233
- Creating a New File Reader 234
- SomeFileReaderClass 237
- Extensions 237
- Creating an IsA Method 242
- Creating a GetData Method 243
- Registering a File Reader 245
- Unregistering a File Reader 246
- Example: TIFF File Reader 248
- IsA Method 250
- GetData Method 250
- Creating a File Writer 253
- Predefined iTool File Writers 255
- IDLitWriteEMF 256
- IDLitWriteEPS 256
- IDLitWriteISV 256
- IDLitWriteJPEG 256
- IDLitWriteJPEG2000 257
- IDLitWritePICT 257
- IDLitWritePNG 257
- IDLitWriteTIFF 257
- Creating a New File Writer 258
- Creating a SetData Method 266
- Example SetData Method 267
- Registering a File Writer 269
- Unregistering a File Writer 270
- Example: TIFF File Writer 272
- SetData Method 273
- RETURN, 1 ; success 275
- Part III: Modifying the 277
- User Interface Objects 282
- Widget Registration Methods 283
- AddOnNotifyObserver Method 283
- DoAction Method 283
- Using iTool User 285
- Interface Elements 285
- The iTools Feedback Mechanism 286
- Status Messages 287
- PromptUserYesNo 289
- PromptUserText 290
- Informational Messages 291
- Creating a User 293
- Interface Service 293
- Predefined iTool UI Services 295
- Operation Preview Service 296
- Creating a New UI Service 297
- and yoffset values when 298
- YOFFSET = yoffset) 299
- ScaleFactor user 300
- Registering a UI Service 302
- ScaleFactor user interface 304
- Widget Creation Function 306
- Event-handling Routines 308
- Invoking the opName Operation 310
- Interface Panel 311
- Creating and Using a UI Panel 312
- Creating a UI Panel Interface 313
- Adding Observers 315
- Create the Widget Hierarchy 315
- Create Event Handlers 316
- Creating Callback Routines 318
- Simple UI Panel” on page 322 319
- Registering a UI Panel 320
- Example: A Simple UI Panel 322
- Panel Creation Routine 323
- Panel Event Handler Routine 325
- Panel Callback Routine 327
- Panel Type Specification 328
- Creating a Custom 331
- What About Using a UI Panel? 333
- What You Will Need to Create 334
- Create or Choose an iTool 335
- Create the Widget Interface 335
- Create Callback Routines 336
- Create a Cleanup Routine 336
- Routine Signature 340
- Error Checking 341
- Top Level Base 341
- User Interface Object 341
- Widget Creation and Layout 342
- User Interface Registration 342
- Handling Widget Destruction 342
- Adding Menus 344
- Resizing Menus 345
- Adding a Toolbar 346
- Modifying Toolbar Contents 347
- Resizing Toolbars 347
- Adding an iTool Window 348
- Resizing iTool Windows 349
- Adding a Status Bar 350
- Adding a User Interface Panel 351
- Handling Callbacks 352
- Handling Resize Events 354
- Handling Shutdown Events 356
- Writing a Cleanup Routine 357
- Calling the Cleanup Routine 357
- Register Your User Interface 358
- Use Your User Interface 358
- Discussion 366
- Controlling iTools from 379
- How to Control an iTool 380
- FindIdentifier Examples 382
- Property Value Information 386
- Changing Property Values 389
- Using the SetProperty Method 390
- Running Operations 391
- Selecting Items in the iTool 393
- Replacing Data in an iTool 394
- Using the SetData Method 395
- Appendix B 397
- CW_ITMENU 399
- Version History 402
- See Also 403
- CW_ITPANEL 404
- CW_ITSTATUSBAR 408
- CW_ITTOOLBAR 411
- CW_ITWINDOW 416
- Index iTool Developer’s Guide 420
© 2020, manymanuals.com. All rights reserved. | 0.649 s |
Manymanuals.com
Manymanuals.de
Manymanuals.fr
Manymanuals.it
Manymanuals.pl
Manymanuals.cz
Manymanuals.es
Manymanuals-pt.com
Comments to this Manuals