AXI for MAXAda Reference Manual 0890518-000 November 1997 Copyright 1997 by Concurrent Computer Corporation. All rights reserved. This publication or any part thereof is intended for use with Concurrent products by Concurrent personnel, customers, and end–users. It may not be repro- duced in any form without the written permission of the publisher. The information contained in this document is believed to be correct at the time of publication. It is subject to change without notice. Concurrent makes no warranties, expressed or implied, concerning the information contained in this document. To report an error or comment on a specific portion of the manual, photocopy the page in question and mark the cor- rection or comment on the copy. Mail the copy (and any additional comments) to Concurrent Computer Corporation, 2101 W. Cypress Creek Road, Ft. Lauderdale, FL 33309–1892. Mark the envelope “Attention: Publications Department.” This publication may not be reproduced for any other reason in any form without written permission of the publisher. AXI is a trademark of Sente Corporation. Power Hawk is a registered trademark of Concurrent Computer Corporation MAXAda is a registered trademark of Concurrent Computer Corporation. NightView is a registered trademark of Concurrent Computer Corporation OSF and Motif are trademarks of the Open Software Foundation, Inc. UNIX is a registered trademark, licensed exclusively by X/Open Company Ltd. X Window System and X are trademarks of X Consortium, Inc. Printed in U. S. A. Revision History: Level: Effective With: Original Release -- November 1997 000 PowerMAX OS 4.1 Preface Scope of Manual This manual is intended for use by Ada programmers interfacing to the X Window Sys- temTM and MotifTM Window Manager using Series 6000 or Power HawkTM Systems and MAXAdaTM. The Ada X Interface for MAXAda (AXI for MAXAdaTM) provides complete functionality from the X Window System and the Motif Window Manager. Structure of Manual This manual consists of thirteen chapters and two appendixes. A brief description of the chapters and appendixes follows: • Chapters 1-12 describe the Xlib, X Toolkit, and Motif interfaces. • Chapter 13 describes the STARS binding to the Xlib and Xt routines. • Appendix A lists some of the complex data type definitions included in the packages Xlib, Xt, and Xm. • Appendix B provides Concurrent-specific information. Syntax Notation The following notation is used throughout this guide: italic Books, reference cards, and items that the user must specify appear in italic type. Special terms may also appear in italic. list bold User input appears in list bold type and must be entered exactly as shown. Names of directories, files, commands, options and man page references also appear in list bold type. list Operating system and program output such as prompts and mes- sages and listings of files and programs appears in list type. [ ] Brackets enclose command options and arguments that are optional. You do not type the brackets if you choose to specify such options or arguments. iii AXI for MAXAda Reference Manual Related Publications The following publications are related to this document: 0890516 MAXAda Reference Manual 0890299 X Toolkit Programming Manual 0890300 X Window System User’s Guide 0890380 OSF/Motif Documentation Set 0890395 NightViewTM User’s Guide 0890429 PowerMAX OS 4.1 System Administration Manual, Volume 1 0890430 PowerMAX OS 4.1 System Administration Manual, Volume 2 The Definitive Guides to the X Window System for Version 11, Volumes 1 - 7, O’Reilly and Associates, Sebastopol, CA, 1990. Xlib - C Language X Interface, by Jim Gettys, Ron Newman and Robert Scheifler. Massa- chusetts Institute of Technology, Cambridge, MA, 1990. This document is a part of the X Version 11 distribution from MIT. OSF/Motif Programmer’s Reference Manual. Open Software Foundation, Cambridge, MA, 1990. iv Contents 1 Introduction Overview. 1-1 Introduction. 1-1 A Quick Tour of X11 and Motif 1.1. 1-1 The Client-Server Model . 1-2 X Protocol . 1-2 X Library. 1-2 Intrinsics and Toolkits. 1-3 Widgets . 1-3 Widget Classes . 1-3 Resources . 1-3 Linking Widgets to an Application. 1-3 AXI Ada Bindings . 1-3 X11R5. 1-6 STARS Bindings. 1-6 Product Enhancements . 1-6 Ada Tasking . 1-7 Packaging . 1-7 2 Programming Considerations General Naming Conventions. 2-1 Name Restrictions. 2-2 Procedure and Function Parameters . 2-2 Specification File Naming Conventions . 2-3 Boolean Values . 2-6 Bitwise Operations . 2-7 Macros. 2-7 Strings . 2-7 Dynamic Memory Allocation . 2-8 Callbacks. 2-8 Tasking and AXI. 2-9 v AXI for MAXAda Reference Manual Using the Xlib Interface . 2-10 Analysis of a Sample Program . 2-10 A Comparison with a C Client . 2-15 Compilation and Linking . 2-17 3 Convenience Functions Calling Sequence . 3-2 Description . 3-2 Return . 3-2 See Also . 3-2 4 Xlib Call Reference Xlib routines . 4-1 Screen and Display Macros . 4-43 Image Format Macros. 4-46 Keysym Classification Macros . 4-47 Ada Convenience Functions . 4-47 X11 Release 5 Functions . 4-47 5 X Resource Manager X Resource Manager Routines . 5-1 6 X Color Management System XCMS Routines. 6-1 7 X Wide Character Strings Xwc Routines . 7-1 8 X Server Extensions MIT Miscellaneous Extension . 8-1 Shape Extension . 8-1 Shared Memory Extensions . 8-3 Multi Buffering Extension . ..