home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / LIB / x11r6pl13_lib_v0.6.read_me.txt < prev   
Text File  |  2009-11-06  |  11KB  |  343 lines
  1. ------------------------------------------------------------------------------
  2.  
  3.   I decide to share to the OS-9 community a trap version of X11R6pl13
  4. X Window System libraries. This is beta version with probably a few uncovered
  5. bugs inside ;-)
  6.   I hope it may be usefull for samebody, however.
  7.  
  8.   Please, send any comments and bug reports to: aha@it.pw.edu.pl
  9.  
  10. Adam
  11.  
  12. ------------------------------------------------------------------------------
  13.  
  14.                                                       Warsaw, 22.03.96
  15.  
  16.            X11R6pl13 X Window System libraries
  17.            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18.                  OS-9 trap version 0.6
  19.                  ~~~~~~~~~~~~~~~~~~~~~
  20.  
  21. X11 R6 libraries, trap version
  22. apply to patch level 13
  23.  
  24. This distribution for OS-9 contains the fallowing directories:
  25.  
  26.   EXAMPLE         - example of using trap handler
  27.       basicwin.c
  28.       xengine.c
  29.       makefile
  30.   INCLUDE         - header files for X11 and os9unix.l
  31.   LIBS
  32.       X11R6shl   - trap handler
  33.       X11R6shl.l - user to trap interface library
  34.       os9unix.l  - unix to os9 interface library
  35.  
  36. Following X libraries are included into X11R6shl trap handler:
  37.  
  38.   - FSlib
  39.   - ICElib
  40.   - PEX5lib
  41.   - SMlib
  42.   - X11lib
  43.   - Xaulib
  44.   - Xawlib
  45.   - XDMCPlib
  46.   - Xextlib
  47.   - XIElib
  48.   - Xilib
  49.   - XMUlib
  50.   - Xtlib
  51.   - XTSTlib
  52.  
  53. The X11R6shl trap handler supports more than 1600 X11 functions!
  54.  
  55. Release notes:
  56.   1. Following CFLAGS are desired during compilation:
  57.       CFLAGS  = -ibtp=020d
  58.  
  59.   2. In every callback function which can use global or static variables or
  60.      call any run-time library function (ie: printf, malloc) you should
  61.      put two 'magic' functions: Begin_CallBack_Procedure() at the beginning of
  62.      your callback function and End_CallBack_Procedure() at the end of it.
  63.      For example:
  64.  
  65.         XtCallbackProc redraw_callback(w, event, params, nparams)
  66.           Widget         w;
  67.           XEvent         *event;
  68.           String         *params;
  69.           Cardinal       *nparams;
  70.           {
  71.           Arg             args[10];
  72.           static int      flag = 0;
  73.  
  74.  ---->    Begin_CallBack_Procedure();
  75.  
  76.           XtSetArg(args[0], XtNwidth, 0);
  77.           XtGetValues(w, args, 2);
  78.  
  79.           if (++flag>10)
  80.             {
  81.             system ("sleep 15");
  82.  ! -->      exit();
  83.             }
  84.  
  85.           if( flag > 5 )
  86.             {
  87.  ! -->      End_CallBack_Procedure();
  88.             return;
  89.             }
  90.  
  91.           width = args[0].value;
  92.           height = args[1].value;
  93.  
  94.           XFreePixmap(XtDisplay(engine), enginePixmap);
  95.           enginePixmap = XCreatePixmap(XtDisplay(engine),XtWindow(engine), 
  96.                          width, height, DefaultDepth(XtDisplay(engine), 0));
  97.  
  98.  ---->    End_CallBack_Procedure();
  99.           }
  100.  
  101.   3. NOTE: Following identyficators are not a constant values:
  102.  
  103.              asciiSinkObjectClass
  104.              asciiSrcObjectClass
  105.              asciiTextWidgetClass
  106.              asciiStringWidgetClass
  107.              asciiDiskWidgetClass
  108.              boxWidgetClass
  109.              commandWidgetClass
  110.              dialogWidgetClass
  111.              formWidgetClass
  112.              gripWidgetClass
  113.              labelWidgetClass
  114.              listWidgetClass
  115.              menuButtonWidgetClass
  116.              multiSinkObjectClass
  117.              multiSrcObjectClass
  118.              panedWidgetClass
  119.              pannerWidgetClass
  120.              portholeWidgetClass
  121.              repeaterWidgetClass
  122.              scrollbarWidgetClass
  123.              simpleWidgetClass
  124.              simpleMenuWidgetClass
  125.              smeObjectClass
  126.              smeBSBObjectClass
  127.              smeLineObjectClass
  128.              stripChartWidgetClass
  129.              templateWidgetClass
  130.              textWidgetClass
  131.              textSinkObjectClass
  132.              textSrcObjectClass
  133.              toggleWidgetClass
  134.              treeWidgetClass
  135.              viewportWidgetClass
  136.              sessionShellWidgetClass
  137.              shellWidgetClass
  138.              overrideShellWidgetClass
  139.              wmShellWidgetClass
  140.              transientShellWidgetClass
  141.              topLevelShellWidgetClass
  142.              applicationShellWidgetClass
  143.              vendorShellWidgetClass
  144.              widgetClassRec
  145.              _XtQString
  146.              _XtAppDestroyCount
  147.              _XtperDisplayList
  148.              XtCXtToolkitError
  149.              XtShellStrings
  150.              XtStrings
  151.              _XtGlobalTM
  152.              _Xdebug
  153.              compositeWidgetClass
  154.              compositeClassRec
  155.              constraintClassRec
  156.              constraintWidgetClass
  157.              coreWidgetClass
  158.              widgetClass
  159.              _XtInheritTranslations
  160.              hookObjectClass
  161.              hookObjClassRec
  162.              colorConvertArgs
  163.              screenConvertArg
  164.              objectClass
  165.              objectClassRec
  166.              rectObjClass
  167.              rectObjClassRec
  168.              shellClassRec
  169.              overrideShellClassRec
  170.              wmShellClassRec
  171.              transientShellClassRec
  172.              topLevelShellClassRec
  173.              applicationShellClassRec
  174.              sessionShellClassRec
  175.              vendorShellClassRec
  176.              _IceConnectionObjs
  177.              _IceConnectionStrings
  178.              _IceConnectionCount
  179.              _IceProtocols
  180.              _IceLastMajorOpcode
  181.              _IceAuthCount
  182.              _IceAuthNames
  183.              _IcePoAuthProcs
  184.              _IcePaAuthProcs
  185.              _IceVersionCount
  186.              _IceVersions
  187.              _IceWatchProcs
  188.              _IceErrorHandler
  189.              _IceIOErrorHandler
  190.              XawWidgetArray
  191.              XawWidgetCount
  192.              asciiSinkClassRec
  193.              asciiSrcClassRec
  194.              asciiTextClassRec
  195.              asciiStringClassRec
  196.              asciiDiskClassRec
  197.              boxClassRec
  198.              commandClassRec
  199.              dialogClassRec
  200.              formClassRec
  201.              gripClassRec
  202.              labelClassRec
  203.              listClassRec
  204.              menuButtonClassRec
  205.              multiSinkClassRec
  206.              multiSrcClassRec
  207.              panedClassRec
  208.              pannerClassRec
  209.              portholeClassRec
  210.              repeaterClassRec
  211.              scrollbarClassRec
  212.              simpleMenuClassRec
  213.              simpleClassRec
  214.              smeBSBClassRec
  215.              smeLineClassRec
  216.              smeClassRec
  217.              stripChartClassRec
  218.              FMT8BIT
  219.              XawFmt8Bit
  220.              XawFmtWide
  221.              _XawTextActionsTable
  222.              _XawTextActionsTableCount
  223.              textClassRec
  224.              textSinkClassRec
  225.              textSrcClassRec
  226.              toggleClassRec
  227.              treeClassRec
  228.              viewportClassRec
  229.              PEXDisplayInfoHeader
  230.              PEXPickCache
  231.              PEXPickCacheSize
  232.              PEXPickCacheInUse
  233.              PEX_fp_convert
  234.              _SmcOpcode
  235.              _SmsOpcode
  236.              _SmVersionCount
  237.              _SmcVersions
  238.              _SmsVersions
  239.              _SmAuthCount
  240.              _SmAuthNames
  241.              _SmcAuthProcs
  242.              _SmsAuthProcs
  243.              _SmsNewClientProc
  244.              _SmsNewClientData
  245.              _SmcErrorHandler
  246.              _SmsErrorHandler
  247.  
  248.     so, you cannot use it for example in this way:
  249.  
  250.               MyClassRec myClassRec = {
  251.                   { /* core fields */
  252.                     /* superclass  */ &widgetClassRec,
  253.                     ...
  254.                   }
  255.               };
  256.  
  257.               WidgetClass myWidgetClass = &myClassRec;
  258.  
  259.     You should use it following way instead:
  260.  
  261.               MyClassRec myClassRec = {
  262.                   { /* core fields */
  263.                     /* superclass  */ NULL,
  264.                     ...
  265.                   }
  266.               };
  267.  
  268.               WidgetClass myWidgetClass = &myClassRec;
  269.  
  270.     and before initialization:
  271.  
  272.               #include <IntrinsicI.h>
  273.  
  274.               myWidgetClass -> core_class.superclass = &widgetClassRec;
  275.  
  276.   4. <Error #000:102 (E$BusErr) A bus trap error occurred.>
  277.      or
  278.      <Error #000:104 (E$IllIns) An illegal instruction exception occurred.>
  279.      This is a result of leaving uncleared points 1 .. 3!
  280.      It may happen also when your '.Xdefaults' file has unproper values
  281.      (for example missing font names)
  282.  
  283.   5. Set envar XENVIRONMENT to pointing your '.Xdefaults' file, i.e:
  284.         setenv XENVIRONMENT /dd/x11r6/.Xdefaults
  285.  
  286.   6. Set envar XAPPLRESDIR to pointing application specific resource file, i.e
  287.      if you start 'xcalc' and have resource file 'XCalc' in '/dd/XRES' directory,
  288.      you should set:
  289.         setenv XAPPLRESDIR /dd/XRES
  290.  
  291.   7. Set envar XLOCALEDIR to pointing system specific locale database, ie:
  292.         setenv XLOCALEDIR /dd/LOCALE
  293.  
  294.  
  295. COPYRIGHT OF OS-9 PORT:
  296.  
  297. This software is Copyright (C)  Adam  Hajduk,   1996.  You are free to copy,
  298. modify and distribute this software  as you see  fit, and to  use it for any
  299. purpose.
  300.  
  301. DISCLAIMER:
  302.  
  303. The author makes no warranties, either expressed or implied, with respect to
  304. this software, its quality, performance, merchantability, or fitness for any
  305. particular purpose.  This software  is distributed AS IS.   The user of this
  306. software  assumes all risks  as to its quality  and performance. In no event
  307. shall  the  author be  liable  for  any  direct,  indirect or  consequential
  308. damages, even if the author  has been advised  as to the possibility of such
  309. damages.
  310.  
  311. AUTHOR OF OS-9 PORT:         Adam Hajduk
  312.  
  313.     Snail mail:                               E-mail: aha@it.pw.edu.pl
  314.     Warsaw University of Technology,
  315.     Faculty of Transport,
  316.     ul. Koszykowa 75
  317.     00-662 Warsaw,
  318.     POLAND
  319.  
  320.  
  321.  
  322. ABOUT X WINDOW SYSTEM:
  323.  
  324. Copyright (c) 1993, 1996  X Consortium
  325.  
  326. Permission is hereby granted, free of charge, to any person obtaining
  327. a copy of this software and associated documentation files (the
  328. "Software"), to deal in the Software without restriction, including
  329. without limitation the rights to use, copy, modify, merge, publish,
  330. distribute, sublicense, and/or sell copies of the Software, and to
  331. permit persons to whom the Software is furnished to do so, subject to
  332. the following conditions:
  333.  
  334. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  335. OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  336. MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  337. IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
  338. OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  339. ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  340. OTHER DEALINGS IN THE SOFTWARE.
  341. ------------------------------------------------------------------------------
  342.  
  343.