AXI for Maxada Reference Manual

Total Page:16

File Type:pdf, Size:1020Kb

AXI for Maxada Reference Manual 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 . ..
Recommended publications
  • Release Notes for Xfree86® 4.8.0 the Xfree86 Project, Inc December 2008
    Release Notes for XFree86® 4.8.0 The XFree86 Project, Inc December 2008 Abstract This document contains information about the various features and their current sta- tus in the XFree86 4.8.0 release. 1. Introduction to the 4.x Release Series XFree86 4.0 was the first official release of the XFree86 4 series. The current release (4.8.0) is the latest in that series. The XFree86 4.x series represents a significant redesign of the XFree86 X server,with a strong focus on modularity and configurability. 2. Configuration: aQuickSynopsis Automatic configuration was introduced with XFree86 4.4.0 which makes it possible to start XFree86 without first creating a configuration file. This has been further improved in subsequent releases. If you experienced any problems with automatic configuration in a previous release, it is worth trying it again with this release. While the initial automatic configuration support was originally targeted just for Linux and the FreeBSD variants, as of 4.5.0 it also includes Solaris, NetBSD and OpenBSD support. Full support for automatic configuration is planned for other platforms in futurereleases. If you arerunning Linux, FreeBSD, NetBSD, OpenBSD, or Solaris, try Auto Configuration by run- ning: XFree86 -autoconfig If you want to customise some things afterwards, you can cut and paste the automatically gener- ated configuration from the /var/log/XFree86.0.log file into an XF86Config file and make your customisations there. If you need to customise some parts of the configuration while leav- ing others to be automatically detected, you can combine a partial static configuration with the automatically detected one by running: XFree86 -appendauto If you areusing a platform that is not currently supported, then you must try one of the older methods for getting started like "xf86cfg", which is our graphical configuration tool.
    [Show full text]
  • A Study on the Use of Opengl in Window Systems
    Master Thesis Computer Science Thesis no: MCS-2004:03 March 2004 A study on the use of OpenGL in window systems Johan Persson Department of Software Engineering and Computer Science Blekinge Institute of Technology Box 520 SE - 372 25 Ronneby Sweden This thesis is submitted to the Department of Software Engineering and Computer Science at Blekinge Institute of Technology in partial fulfillment of the requirements for the degree of Master of Science in Software Engineering. The thesis is equivalent to 20 weeks of full time studies. Contact Information: Author: Johan Persson E-mail: [email protected] University advisor: Bj¨orn T¨ornqvist Department of Software Engineering and Computer Science Department of Software Engineering and Computer Science Internet : http://www.bth.se/ipd Blekinge Institute of Technology Phone : +46 457 38 50 00 Box 520 Fax : + 46 457 271 25 SE - 372 25 Ronneby Sweden Abstract OpenGL is getting used more in window system as a way of improving performance and enabling new functionality. Examples of two systems using different approaches of how OpenGL is being used are Quartz Extreme and Fresco. Quartz Extreme uses window composition which assures fast redisplay and Fresco on the other hand uses a structured graphics approach which utilises OpenGL on a much lower level compared to Quartz Extreme which operates at a window level. Fresco’s way brings great flexibility and an ability to mix 2D and 3D-objects on the desktop. But each of the approaches has its problems; Quartz extreme requires a large amount of memory for buffering of the window contents and Fresco has performance problems when redisplaying complex structures.
    [Show full text]
  • Distributed Multihead X Design Kevin E
    Distributed Multihead X design Kevin E. Martin, David H. Dawes, and RickardE.Faith 29 June 2004 (created 25 July 2001) Abstract This document covers the motivation, background, design, and implementation of the distributed multihead X (DMX) system. It is a living document and describes the current design and implementation details of the DMX system. As the project pro- gresses, this document will be continually updated to reflect the changes in the code and/or design. Copyright 2001 by VALinux Systems, Inc., Fremont, California. Copyright 2001-2004 by Red Hat, Inc., Raleigh, North Carolina 1. Introduction 1.1 The Distributed Multihead X Server Current Open Source multihead solutions arelimited to a single physical machine. Asingle X server controls multiple display devices, which can be arranged as independent heads or unified into a single desktop (with Xinerama). These solutions arelimited to the number of physical devices that can co-exist in a single machine (e.g., due to the number of AGP/PCI slots available for graphics cards). Thus, large tiled displays arenot currently possible. The work described in this paper will eliminate the requirement that the display devices reside in the same physical machine. This will be accomplished by developing a front-end proxy X server that will control multiple back-end X servers that make up the large display. The overall structureofthe distributed multihead X (DMX) project is as follows: A single front- end X server will act as a proxy to a set of back-end X servers, which handle all of the visible ren- dering. X clients will connect to the front-end server just as they normally would to a regular X server.
    [Show full text]
  • The Exene Library Manual (Version 0.4)
    The eXene Library Manual (Version 0.4) February 11, 1993 John H. Reppy Emden R. Gansner AT&T Bell Laboratories 600 Mountain Ave. Murray Hill, NJ 07974 COPYRIGHT c 1993 by AT&T Bell Laboratories ALL RIGHTS RESERVED Contents 1 Introduction 1 1.1 Roadmap 1 2 Geometry 3 2.1 Point operations 3 2.2 Size operations 4 2.3 Rectangle operations 4 3 Basic eXene objects 6 3.1 The display 7 3.2 Screens 7 3.3 Drawables 8 3.3.1 Geometry of drawables 8 3.3.2 Images 8 3.3.3 Pixmaps and tiles 9 3.4 Cursors 10 3.4.1 The standard cursors 10 3.5 Miscellaneous types and operations 11 3.5.1 Other display operations 11 3.5.2 Window hash tables 11 3.5.3 Gravity 11 4 Windows 13 4.1 Window creation 13 4.2 Window con®guration 15 4.3 Other window operations 15 5 Drawing 16 5.1 Pens 16
    [Show full text]
  • Programming on Silicon Graphics Systems: an Overview
    Programming on Silicon Graphics Systems: An Overview Document Number 007-2476-001 CONTRIBUTORS Written by Eleanor Bassler Edited by C. Kleinfeld Photography by Nancy Cam © Copyright 1994, Silicon Graphics, Inc.— All Rights Reserved This document contains proprietary and confidential information of Silicon Graphics, Inc. The contents of this document may not be disclosed to third parties, copied, or duplicated in any form, in whole or in part, without the prior written permission of Silicon Graphics, Inc. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure of the technical data contained in this document by the Government is subject to restrictions as set forth in subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 and/ or in similar or successor clauses in the FAR, or in the DOD or NASA FAR Supplement. Unpublished rights reserved under the Copyright Laws of the United States. Contractor/manufacturer is Silicon Graphics, Inc., 2011 N. Shoreline Blvd., Mountain View, CA 94043-1389. Silicon Graphics and IRIS are registered trademarks and IRIX, IRIS Graphics Library, IRIS IM, IRIS InSight, IconSmith, OpenGL, IRIS ViewKit, POWER Fortran Accelerator, IRIS Performer, Indigo Video, Indy Video, Galileo Video, Indigo2 Video, Sirius Video, ImageVision Library, CASEVision, Impressario, Indigo Magic, Open Inventor, POWER Series, and RealityEngine are trademarks of Silicon Graphics, Inc. OSF/Motif is a trademark of Open Software Foundation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/ Open Company, Ltd. X Window System is a trademark of the Massachusetts Institute of Technology. PostScript is a registered trademark and Display PostScript is a trademark of Adobe Systems, Inc.
    [Show full text]
  • Programming on Silicon Graphics® Systems: an Overview
    Programming on Silicon Graphics® Systems: An Overview Document Number 007-2476-003 CONTRIBUTORS Written by Eleanor Bassler Edited by C. Kleinfeld Photography by Nancy Cam Production by Heather Hermstad St. Peter’s Basilica image courtesy of ENEL SpA and InfoByte SpA. Disk Thrower image courtesy of Xavier Berenguer, Animatica. © 1998, Silicon Graphics, Inc.— All Rights Reserved The contents of this document may not be copied or duplicated in any form, in whole or in part, without the prior written permission of Silicon Graphics, Inc. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure of the technical data contained in this document by the Government is subject to restrictions as set forth in subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 and/or in similar or successor clauses in the FAR, or in the DOD or NASA FAR Supplement. Unpublished rights reserved under the Copyright Laws of the United States. Contractor/manufacturer is Silicon Graphics, Inc., 2011 N. Shoreline Blvd., Mountain View, CA 94043-1389. Silicon Graphics, the Silicon Graphics logo, and IRIX are registered trademarks, and IRIS Graphics Library, IRIS IM, IRIS InSight, IconSmith, OpenGL, IRIS ViewKit, POWER Fortran Accelerator, IRIS Performer, Indigo Video, Indy Video, Galileo Video, Indigo2 Video, Sirius Video, ImageVision Library, CASEVision, Impressario, Indigo Magic, Open Inventor, POWER Series, and RealityEngine are trademarks, of Silicon Graphics, Inc. OSF/Motif is a trademark of Open Software Foundation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. X Window System is a trademark of the Massachusetts Institute of Technology.
    [Show full text]
  • Guile-GNOME: Gdk Version 2.16.2, Updated 9 December 2011
    Guile-GNOME: Gdk version 2.16.2, updated 9 December 2011 Damon Chaplin many others This manual is for (gnome gdk) (version 2.16.2, updated 9 December 2011) GDK documentation Copyright 1997-2007 Damon Chaplin and others This work may be reproduced and distributed in whole or in part, in any medium, physical or electronic, so as long as this copyright notice remains intact and unchanged on all copies. Commercial redistribution is permitted and encouraged, but you may not redistribute, in whole or in part, under terms more restrictive than those under which you received it. If you redistribute a modified or translated version of this work, you must also make the source code to the modified or translated version available in electronic form without charge. However, mere aggregation as part of a larger work shall not count as a modification for this purpose. All code examples in this work are placed into the public domain, and may be used, modified and redistributed without restriction. BECAUSE THIS WORK IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE WORK, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRIT- ING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE WORK "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. SHOULD THE WORK PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY REPAIR OR CORREC- TION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE WORK AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAM- AGES ARISING OUT OF THE USE OR INABILITY TO USE THE WORK, EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
    [Show full text]
  • Status=Not/Inst/Cfg-Files/Unpacked
    Desired=Unknown/Install/Remove/Purge/Hold |Status=Not/Inst/Cfgfiles/Unpacked/Failedcfg/Halfinst/trigaWait/Trigpend |/Err?=(none)/Reinstrequired(Status,Err:uppercase=bad) ||/NameVersion Description +++=========================================================================== =============================================================================== ================================================================================ ===== ii0trace1.0bt4 0traceisatraceroutetoolthatcanberunwithinanexisting,open TCPconnectionthereforebypassingsometypesofstatefulpacketfilterswith ease. ii3proxy0.6.1bt2 3APA3A3proxytinyproxyserver iiace1.10bt2 ACE(AutomatedCorporateEnumerator)isasimpleyetpowerfulVoIPCo rporateDirectoryenumerationtoolthatmimicsthebehaviorofanIPPhoneinor dert iiadduser3.112ubuntu1 addandremoveusersandgroups iiadmsnmp0.1bt3 SNMPauditscanner. iiafflib3.6.10bt1 AnopensourceimplementationofAFFwritteninC. iiair2.0.0bt2 AIRisaGUIfrontendtodd/dc3dddesignedforeasilycreatingforen sicimages. iiaircrackng1.1bt9 Aircrackngwirelessexploitationandenumerationsuite iialacarte0.13.10ubuntu1 easyGNOMEmenueditingtool iialsabase1.0.22.1+dfsg0ubuntu3 ALSAdriverconfigurationfiles iialsatools1.0.220ubuntu1 ConsolebasedALSAutilitiesforspecifichardware iialsautils1.0.220ubuntu5 ALSAutilities iiamap5.2bt4 Amapisanextgenerationtoolforassistingnetworkpenetrationtesti ng.Itperformsfastandreliableapplicationprotocoldetection,independanton the iiapache22.2.145ubuntu8.4 ApacheHTTPServermetapackage iiapache2mpmprefork2.2.145ubuntu8.4 ApacheHTTPServertraditionalnonthreadedmodel
    [Show full text]
  • AIX® Version 6.1 Aixwindows Programming Guide About This Document
    AIX® Version 6.1 AIXwindows Programming Guide AIX® Version 6.1 AIXwindows Programming Guide Note Before using this information and the product it supports, read the information in Appendix F, “Notices,” on page 121. This edition applies to AIX Version 6.1 and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1997, 2013. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About This Document...............................v Content of This Document..............................v Highlighting ...................................v Case-Sensitivity in AIX ...............................v ISO 9000 ....................................v Related Documents ................................v Chapter 1. AIXwindows Overview for Programmers ...................1 Chapter 2. AIXwindows Window Manager Overview ...................3 Starting and Exiting X and the AIXwindows Window Manager.................3 Restoring Default Behavior .............................3 Chapter 3. Using the AIXwindows Customizing Tool ...................5 Using the Customizing Tool Introduction ........................5 Related Information ................................5 How to Start the Customizing Tool...........................5 Using the Customizing Tool Main Window ........................6 Using the Browsers................................10 Understanding the app-custom Files .........................14 Chapter 4. AIXwindows
    [Show full text]
  • Solaris X Window System Developer's Guide Provides Detailed Information on the Solaris X Server
    Solaris XWindow System Developer's Guide Part No: 816–0279–10 May 2002 Copyright ©2002Sun Microsystems 4150 Network Circle, Santa Clara, CA 95054 U.S.A. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, docs.sun.com, AnswerBook, AnswerBook2, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements.
    [Show full text]
  • All Installed Packages .PDF
    Emperor-OS All Installed Package Editor: Hussein Seilany [email protected] www.Emperor-OS.com Emperor-has 5 package management system for installing, upgrading, configuring, and removing software. Also providing access over 60,000 software packages of Ubuntu. We per-installed several tools are available for interacting with Emperor's package management system. You can use simple command-line utilities to a graphical tools. Emperor-OS's package management system is derived from the same system used by the Ubuntu GNU/Linux distribution. We will show you the list of installed packages on Emperor-OS. The packages lists is long. Having a list of installed packages helps system administrators maintain, replicate, and reinstall Emperor-OS systems. Emperor-OS Linux systems install dependencies all the time, hence it is essential to know what is on the system. In this page you can find a specific package and python modules is installed, count installed packages and find out the version of an installed package. Download lists as PDF file or see them as html page in the following: Are you looking for all in one operating system? 70 Packages: Installed Special Packages 120 Tools: Installed Utility 260 Modules: Installed Python2 and 3 Modules 600Fonts: Installed Fonts 5 Desktops: Desktop Manager Packages 22Tools: Extra Development Tools 270 Themes: Installed Themes 40 Icons: Installed Icons 40Games: Installed Games 2533scanners: supports Scanners 2500 Cameras: supports Camera 4338Packages: All Installed Packages 2 [email protected] www.Emperor-OS.com The list installed packages: Emperor-OS Linux is an open source operating system with many utilities.
    [Show full text]
  • Swm: an X Window Manager Shell 1. Introduction
    swm: An X Window Manager Shell Thomas E. LaStrange Solbourne Computer Inc. 1900 Pike Road Longmont, CO 80501 [email protected] ABSTRACT swm is a policy-free, user con®gurable window manager client for the X Window System. Besides providing basic window manager functionality, swm introduces new features not found in existing window managers. First and foremost, swm has no default look-and-feel. Like the X Window system itself, swm does not dictate policy (look-and-feel); rather, it provides the mechanism for implementing window management policy. Users are not required to learn a new programming language to modify its behavior; instead, simple objects with associated actions determine swm's operation. Its major advantage over other window managers is a feature called the Virtual Desktop. The Virtual Desktop effectively makes the X root window larger than the physical limits of the display and can be panned in a number of ways, including scrollbars, a panner object, or window manager commands. Besides window management, swm also provides primitive session management. It can save a user's current window layout and restart those clients when X is restarted. swm can restart clients regardless of what toolkit they were built on or what remote host (if any) they were running on. All relevant client information is restored, including window position and size, icon position, and the state of the client. 1. Introduction Why another window manager? That is certainly a valid question given the number of window managers currently available for the X Window System1. Current window managers fall into two categories: easy to use but not very con®gurable, or very con®gurable but complicated to use.
    [Show full text]