T A B L E O F C O N T E N T S 1 INTRODUCTION 9 1.1 PURPOSE 9 1.2 SCOPE 9 1.3 APPLICABLE DOCUMENTS 10 1.4 ABBREVIATIONS AND ACRONYMS 10 1.5 GLOSSARY 11 1.6 STYLISTIC CONVENTIONS 11 1 VLT Look & Feel 1 1.1 OVERVIEW 1 1.2 DESIGN GOALS FOR THE VLT PANELS 2 1.2.1 Interface Design 2 1.2.2 Panel Design 2 1.2.3 Use of Dialogue Windows 3 1.3 PANEL LAYOUT 4 1.3.1 VLT Session manager 5 1.3.2 Schematics 6 1.3.3 Selection Panel 7 1.3.4 Status Panel 8 1.3.5 Input Panel 9 1.3.6 Common Terms 10 1.3.7 Presenting Textual Information 11 1.3.8 Organization of a GUI 12 2 USER'S GUIDE 13 2.1 OVERVIEW 13 2.1.1 The Main Panel 14 2.1.2 Structure of the Working Window 16 2.1.3 Structure of the MenuBar 18 2.1.4 EXAMPLE: Enable/Disable Menu entries 19 2.1.5 Getting Started 20 2.1.6 How To Run a Panel 21 2.1.7 Run Time Parameters 22 2.1.8 Miscellaneous 23 2.2 NAMING CONVENTIONS 24 2.2.1 Widget Names 24 2.2.2 Widget Names within a uifClass 26 2.2.3 Variables Names 27 2.2.4 Mapping of run-time data. 28 2.3 DATABASE INTERFACE 29 2.3.1 Basics 29 2.3.2 Access to a remote database 29 2.3.3 EXAMPLE : Dynamic configuration of env. names 31 2.3.4 Store database values 32 2.3.5 Update Panel Data 33 2.3.6 Template of procedure for database events 35 2.3.7 EXAMPLE : Panel reading database values 36 2.3.8 EXAMPLE: Panel with user's defined event procedure 37 2.3.9 EXAMPLE : Panel writing values into the database 38 2.4 COMMAND INTERFACE 40 2.4.1 Syntax for tcl/tk commands 40 2.4.2 Calling Other Panels 40 2.4.3 Send a Message to a Process 41 2.4.4 Command Feedback Window 42 2.4.5 Interface to The Command Feedback Window 43 2.4.6 EXAMPLE : Panel sending command to another process 44 2.5 USER'S DEFINED PROCEDURES 45 2.5.1 Standard procedures 46 2.5.2 Set Defaults or Constants 48 2.5.3 Editing Local Procedures 49 2.5.4 Application Defaults 50 2.6 USAGE OF "Mega-Widgets" 51 2.6.1 Import a "Mega-Widget" 52 2.6.2 Panel Editor "uifClass-Widget" 53 2.6.3 Public Domain "Mega-Widget" 57 2.6.4 Panel Editor "Mega-Widgets" 59 2.6.5 Link to Widget's Libraries 59 2.7 DEBUGGING COMMANDS 60 2.7.1 Description of "DEBUG" menu 60 2.7.2 Activate Run-Time DEBUG Flags 62 2.8 BUILDING PANELS IN THE VLT ENVIRONMENT 63 2.8.1 Makefile 63 2.8.2 File naming 64 2.8.3 Example of Makefile 64 2.9 CAVEATS 65 2.9.1 LOAD Operation Fails 65 2.9.2 SAVE Operation Fails 65 2.9.3 Widget already exists 66 2.9.4 Set CWP Fails 66 2.10 HOW TO REPORT A PROBLEM 67 3 PROGRAMMATIC INTERFACE 69 3.1 libpanPublic.tcl 69 3.2 libuif.tcl 70 3.3 libuifClass.tcl 71 3.4 libuifCommon.tcl 73 3.5 Examples of itk Mega-Widgets 75 4 VLT GUI Guidelines 79 4.1 RECOMMANDATIONS 79 4.2 OPTIMIZATION OF PERFORMANCES 80 4.2.1 Optimization of Control Programs 80 4.2.2 Optimization of panels 80 4.3 EXAMPLES 82 4.3.1 Show the same DB value with several widgets 82 4.3.2 Change Widget Configuration 82 4.3.3 Use panel procedures in normal tcl/tk scripts. 83 4.3.4 Interaction between classContainer and classFrame 84 4.3.5 Interaction between Menus and classFrame 85 4.3.6 Programmatic setting of "show" flag for classContainer 86 4.3.7 Enabling/Disabling classContainer radioButtons. 87 4.3.8 Store data of a uifClass into the database. 87 4.3.9 Use the telescope identifier to derive an environment name. 87 4.3.10 Set the uifClass CWP according to a database attribute 88 4.3.11 Add Simple Graphic Element 90 4.3.12 Create specific widget layout. 91 5 REFERENCE 93 5.1 WIDGETS Window 93 5.2 PANEL EDITOR 94 5.2.1 MENU "File" 94 5.2.2 MENU "Std.Comp" 94 5.2.3 MENU "Options" 95 5.2.4 MENU "Screen" 95 5.2.5 MENU "Debug" 95 5.2.6 Editing Functions 96 5.2.7 Action Buttons Area 99 5.3 PANEL CONFIGURATION 101 5.4 WIDGET CONFIGURATION (Common Part) 102 5.4.1 Common Parameters 102 5.4.2 Configuration Actions 103 5.4.3 Standard Commands 104 5.4.4 Configure List Elements 105 5.5 WIDGETS CONFIGURATION (Specific Widgets) 107 5.5.1 Action Button 107 5.5.2 Arrows Button 108 5.5.3 Bar Chart 109 5.5.4 Bitmaps 110 5.5.5 Button 111 5.5.6 Check Button 113 5.5.7 Dummy Frame 114 5.5.8 Entry 115 5.5.9 Free Text 117 5.5.10 Output Led 118 5.5.11 List Box 119 5.5.12 Option Button 120 5.5.13 Output and Output Array 122 5.5.14 Output List 123 5.5.15 Output String 124 5.5.16 Radio Buttons 125 5.5.17 Scale 126 5.5.18 Text Widget 127 5.6 MENU BAR 128 5.6.1 Configuration Panel 128 5.6.2 Edit Mode : Show Configuration 130 5.6.3 Edit Mode : Add 131 5.6.4 Edit Mode : Modify 132 6 MAN PAGES 133
