CONTENTS Title Page Copyright Page Preface 1 Overview of the GObE Widget 1.1 Objects and the GObE Display List 1.2 The GObE World Coordinate System 1.2.1 Virtual Display 1.2.2 Display Window 1.2.3 Display Viewport 1.2.4 Scroll Region 1.2.5 Navigation Window 1.3 Scrolling, Zooming, and Resizing 1.4 Pointer Tracking 1.5 Highlighting 1.6 Compound Strings and Font Lists 1.7 Extract, Paste, Print (DDIF) Support (VMS Systems Only) 2 GObE Events 2.1 Overview of Events and Callbacks 2.1.1 Callback Routine Structure and Organization 2.2 Selection Semantics 2.2.1 Predefined GObE Selection Bits 2.2.2 Button Syntax 2.3 Autoscrolling During Event Processing 2.4 Supported Events 2.4.1 Window Events 2.4.1.1 Enter-Leave Event 2.4.1.2 Grid Event 2.4.1.3 Resize Event 2.4.2 Object Events 2.4.2.1 Drag-Track Event 2.4.2.2 Hot Event 2.4.2.3 Restriction Event 2.4.3 Button Events 2.4.3.1 Help Event 2.4.3.2 Click Event 2.4.3.3 Double Click Event 2.4.3.4 Press-Release 2.4.4 Interactive Transformation Events 2.4.4.1 Begin Drag Event 2.4.4.2 Rotate Event 2.4.4.3 Rubberband Event 2.4.4.4 Scale Event 2.4.4.5 Translate Event (Move) 2.4.5 Navigation Events 2.4.5.1 Scroll Event 2.4.5.2 Zoom Event 3 Widget Resources 3.1 Motif Toolkit Resources 3.2 GObE-Specific Widget Resources 4 GObE Services - Overview 4.1 Widget Services 4.2 Window Services 4.3 Object Services 4.4 Object Drawing Services 4.5 DDIF Services - Extracting, Pasting, and Printing (VMS Systems Only) 4.6 General Information Services 4.7 Interactive Transformation Control Services 4.8 Event Services 4.9 Graphic Context Services 4.9.1 Object Attributes 5 GObE Services - Reference GobeCenter (Center Object) GobeChangeParent (Change Parent) GobeCopy (Copy Object) GobeCreateAttributes (Create Attributes) GobeCreateWidget (Create GObE Widget (low-level)) GobeDelete (Delete Object) GobeDeleteAttributes (Delete Attributes) GobeDisableEvent (Disable Event) GobeDraw (Draw Object Structure) GobeDrawArc (Draw Arc) GobeDrawCurve (Draw Curve) GobeDrawImage (Draw Image) GobeDrawLine (Draw Line) GobeDrawPixmap (Draw Pixmap) GobeDrawPoint (Draw Point) GobeDrawPolyline (Draw Polyline) GobeDrawRectangle (Draw Rectangle) GobeDrawText (Draw Text) GobeEnableEvent (Enable Event) GobeEndLocate (End Locate Sequence) GobeEndPrint (End Print) GobeEndTraverse (End Traversal Sequence) GobeExtract (Extract Object) GobeExtractDDIFDocument (Extract DDIF Document) GobeExtractPoint (Extract Object Point) GobeFreeExtract (Free Extracted Objects) GobeGetAttributes (Get Attributes) GobeGetCursorPosition (Get Cursor Position) GobeGetDCPosition (Get DC Position) GobeGetDeferred (Get Update Deferral Status (low-level)) GobeGetDisplayUpdate (Get Update Deferral Status (high-level)) GobeGetDrag (Get Drag Range) GobeGetEvent (Get Event Information) GobeGetObjectType (Get Object Type) GobeGetParent (Get Parent of Object) GobeGetPermHighlight (Get Permanent Highlighting) GobeGetRestriction (Get Transform Restriction) GobeGetRoot (Get Root Object) GobeGetRotate (Get Rotate Range and Center) GobeGetRubberbandPoint (Get Rubberband Index Point) GobeGetScale (Get Scale Range and Center) GobeGetScroll (Get Scroll Range) GobeGetSelect (Get Selection Bits) GobeGetText (Get Text Value) GobeGetTransformation (Get Object Transformation Matrix) GobeGetUserData (Get User Data) GobeGetVersion (Get Version) GobeGetVisibility (Get Visibility) GobeGetWidgetUserData (Get Widget User Data) GobeGetWorkWidget (Get GObE Work Widget) GobeGetZoom (Get Zoom Range) GobeImport (Import) GobeImportAttributes (Import Attributes) GobeInitializeForMrm (Initialize for MRM) GobeInitPrint (Initiate Print) GobeLocate (Locate Objects) GobeMeasure (Measure Object) GobeMeasureImage (Measure Image) GobeMeasurePixmap (Measure Pixmap) GobeMeasureText (Measure Text String) GobeModify (Modify Object Rendition) GobeModifyAttributes (Modify Attributes) GobePasteDDIFDocument (Paste to DDIF Document) GobePop (Pop Object in Front of Siblings) GobePopdownNavWind (Pop Down Navigation Window) GobePopupNavWind (Pop Up Navigation Window) GobePrint (Print Region of Display List) GobePush (Push Object Behind Siblings) GobeReadDDIFFile (Read from DDIF File) GobeRotate (Rotate Object) GobeRubberband (Rubberband Object Point) GobeScale (Scale Object) GobeScroll (Scroll Display Window) GobeSetCursorPosition (Set Cursor Position) GobeSetDeferred (Set Update Deferral Status (low-level)) GobeSetDisplayUpdate (Set Update Deferral Status (high-level)) GobeSetDrag (Set Drag Range) GobeSetPermHighlight (Set Permanent Highlighting) GobeSetRotate (Set Rotate Range and Center) GobeSetRubberbandPoint (Set Rubberband Index Point) GobeSetScale (Set Scale Range and Center) GobeSetScroll (Set Scroll Range) GobeSetScrollRegion (Set Scroll Region) GobeSetSelect (Set Selection Bits) GobeSetText (Set Text Object Value) GobeSetUserData (Set User Data) GobeSetVisibility (Set Visibility) GobeSetWidgetUserData (Set Widget User Data) GobeSetZoom (Set Zoom Range) GobeTransform (Transform Object) GobeTranslate (Translate (Move) Object) GobeTraverse (Traverse Display List) GobeUnzoom (Unzoom Display Window) GobeWidget (Create GObE widget (high-level)) GobeWriteDDIFFile (Write to DDIF File) GobeZoom (Zoom Display Window) A GObE Example Programs (gobetest and GobeFontDemo) A.1 Gobetest Description A.1.1 Menu Bar Functions A.1.1.1 File Menu A.1.1.2 Setup Menu A.1.1.3 Edit Menu A.1.1.4 Transform Menu A.1.1.5 Navigate Menu A.1.2 Pointer Functions A.1.3 Additional Notes A.2 GobeFontDemo Description B Compiling and Linking on VMS Systems B.1 Language Binding Files B.2 Shareable Image Files B.3 Sample Program Files B.4 Widget Meta Language (WML) Files B.5 UIL Files and Widget Definition B.6 Summary of Files C Miscellaneous GObE Constants C.1 Tracking Style C.2 Selection Modes C.3 Area Enter/Leave C.4 Button Press/Release C.5 Line Rendition C.6 Line Cap Rendition C.7 Line Join Rendition C.8 Arrowhead Style C.9 Partial Arc Rendition C.10 Fill Patterns C.11 Fill_outline Attributes C.12 Point Style C.13 Arc Style C.14 Partial Arc Style C.15 Transformation Types C.16 Drag Events C.17 Pre-defined Button States C.18 Reserved Selection Criteria C.19 GObE Shapes C.20 GObE Events D Miscellaneous GObE Structures D.1 The Button Data Structure D.2 The Reserved Select Data Structure D.3 The Point Data Structure D.4 The X Point Data Structure D.5 The Rectangle Data Structure D.6 The Range Center Data Structure D.7 The Object Data Structure D.7.1 f_bits Field D.7.2 The Shape Data Structure D.7.2.1 The Generic Shape Data Structure D.7.2.2 The Arc Shape Data Structure D.7.2.3 The Curve Shape Data Structure D.7.2.4 The Image Shape Data Structure D.7.2.5 The Line Shape Data Structure D.7.2.6 The Pixmap Shape Data Structure D.7.2.7 The Point Shape Data Structure D.7.2.8 The Polyline Shape Data Structure D.7.2.9 The Rectangle Shape Data Structure D.7.2.10 The Text Shape Data Structure E Messages E.1 Success Codes E.2 Informational Codes E.3 Warning Codes E.4 Error Codes Glossary FIGURES 1-1 A GObE Object, Display List, and Stacking Order 1-2 The GObE World Coordinate System 1-3 Multiple Line Text Object 2-1 The GobeEventGenericStruct Structure 2-2 GobeEventEnterLeaveStruct Structure 2-3 The GObE Grid 2-4 GobeEventGridStruct Structure 2-5 GobeEventResizeStruct Structure 2-6 GobeEventDragTrackStruct Structure 2-7 GobeEventHotStruct Structure 2-8 GobeEventRestrictionStruct Structure 2-9 GobeEventButtonStruct Structure 2-10 Rubberbanding a Rectangle 2-11 GobeEventGenericDragStruct Structure 2-12 GobeEventDragBeginStruct Structure 2-13 GobeEventRotateStruct Structure 2-14 GobeEventRubberbandStruct Structure 2-15 GobeEventScaleStruct Structure 2-16 GobeEventTranslateStruct Structure 2-17 GobeEventScrollStruct Structure 2-18 GobeEventZoomStruct Structure 4-1 GobeGgcValuesStruct Structure and C Bitmasks D-1 GobeButtonStruct Structure D-2 GobeReservedSelectStruct Structure D-3 GobePointStruct Structure D-4 GobeXPointStruct Structure D-5 GobeRectangleStruct Structure D-6 GobeRangeCenterStruct Structure D-7 GobeObjectStruct Structure D-8 GobeShapeStruct Structure D-9 GobeGenericShapeStruct Structure D-10 GobeArcShapeStruct Structure D-11 GobeCurveShapeStruct Structure D-12 GobeImageShapeStruct Structure D-13 GobeLineShapeStruct Structure D-14 GobePixmapShapeStruct Structure D-15 GobePointShapeStruct Structure D-16 GobePolylineShapeStruct Structure D-17 GobeRectangleShapeStruct Structure D-18 GobeTextShapeStruct Structure TABLES 1 Documentation Conventions 2-1 GObE Event Classes: Are Button Syntax and Selection Semantics Relevant? 2-2 GObE Events 2-3 The Enter-Leave Data Structure 2-4 The Grid Data Structure 2-5 The Resize Data Structure 2-6 The Drag-track Data Structure 2-7 The Hot Data Structure 2-8 The Restriction Data Structure 2-9 The Button Data Structure 2-10 Features for Controlling Interactive Transformations 2-11 The Generic Drag Data Structure 2-12 The Begin Drag Data Structure 2-13 The Rotate Data Structure 2-14 The Rubberband Data Structure 2-15 The Scale Data Structure 2-16 The Translate Data Structure 2-17 The Scroll Data Structure 2-18 The Zoom Data Structure 3-1 Supported Motif Toolkit Widget Resources 3-2 GObE Convenience Routines for Resources 3-3 GObE-Specific Widget Resources 4-1 GObE Widget Services 4-2 GObE Window Services 4-3 GObE Object Services 4-4 Location Point Semantics 4-5 GObE DDIF Services 4-6 GObE Services for General Information 4-7 GObE Interactive Transformation Services 4-8 GObE Event Services 4-9 GObE Graphic Context Services 4-10 The GGC Values Data Structure B-1 Language Binding Files B-2 Resources Not Supported by WML B-3 Files in DECW$SYSTEM_DEFAULTS B-4 Files in SYS$LIBRARY B-5 Files in DGIT$EXAMPLES D-1 f_bits Field