home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0000 - 0009 / ibm0000-0009 / ibm0003.tar / ibm0003 / MEWEL12.ZIP / README.1ST < prev    next >
Encoding:
Text File  |  1989-07-22  |  11.1 KB  |  253 lines
  1.                             MEWEL WINDOW SYSTEM
  2.                  (Magma Extensible Window and Event Library)
  3.                                 VERSION 1.0
  4.                                     by
  5.                         Marc Adler / Magma Systems
  6.                   Association of Shareware Professionals
  7.  
  8.                               Magma Systems
  9.                             15 Bodwell Terrace
  10.                         Millburn, New Jersey 07041
  11.                     (voice) 201-912-0192 (10-5 PM EST)
  12.                  (BBS)   201-912-0668 (24 hrs, 1200 baud)
  13.  
  14.  
  15.  
  16. Greetings,
  17.  
  18.     If you've gotten this far, then you must be interested in what the
  19. MEWEL has to offer! So, please read through this diatribe and let us know
  20. what you think!
  21.  
  22.  
  23. WHY WRITE ANOTHER WINDOW LIBRARY???
  24.  
  25. One of the things which Magma Systems specializes in is writing trader
  26. workstations for large financial institutions (see more below). Most of the 
  27. time, our work is done using Microsoft Windows, PM, or SunView. Howeverm
  28. one of our clients wanted a PC-based workstation which could not only run
  29. on the standard AT-class machine, but which could also work on 8088-based
  30. laptops. Graphics was out as far as thins company was concerned, so that
  31. eliminated Microsoft Windows. So, we had to write our own windowing system.
  32.  
  33. One of the issues involved in building trader workstations is the
  34. asynchronous nature of the input which comes in. Input could come in
  35. asynchronously from the keyboard, mouse, touch screen, network, and com
  36. port. When the user paused to interact with a menu or a dialog box, the
  37. input processing and window updating could not be halted. Therefore, an
  38. event-driven, message passing system was needed.
  39.  
  40. We looked at all of the major PC-based window libraries, but none of them
  41. fitted the message-passing model which we needed. The ideal thing to use
  42. was Microsoft Windows, but as mentioned above, a graphical system was ruled
  43. out. We had done some work for Microsoft using their internal windowing
  44. system (the same windowing system used in the QuickC, MS-WORKS, and
  45. Codeview front ends), but not only was their system not commercially
  46. available, but lacked the power and sophisticated API which we needed.
  47. Therefore, we decided to roll our own. Thus, MEWEL was born. 
  48.  
  49.  
  50. WHAT MAKES MEWEL DIFFERENT?
  51.  
  52. MEWEL stands for Magma Extensible Window and Event Library.
  53.  
  54. MEWEL uses the same kind of event-driven, message passing model which is
  55. used by windowing systems like X-Windows, MS-Windows, SunView, and PM. In
  56. fact, since we do a lot of MS-Windows consulting, we designed the internals 
  57. of MEWEL to be very similar to MS-Windows. We even provided a set of
  58. #defines which redefine some of our API functions in terms of the
  59. corresponding ones in MS-Windows. A person could even learn to program
  60. MEWEL by reading Charlie Petzold's book on Windows!
  61.  
  62. As far as we know, none of the other commercial PC-based windowing
  63. libraries implements all of the gadgets which are required by an SAA
  64. application, such as radio buttons, checkboxes, dialog boxes, pushbuttons,
  65. and scrollbars along with mouse support. Certainly, none of the others have 
  66. the message passing model which is absolutely necessary in today's window
  67. systems.
  68.  
  69. As with our ME Text Editor, we will give the user the option to purchase
  70. the complete source code to MEWEL. This will let users have the opportunity 
  71. to see how a modern window system is written. We like to keep an open
  72. system so that there will be no secrets from our users.
  73.  
  74.  
  75.  
  76. A SEMI-INTERESTING STORY
  77.  
  78. A major computer magazine was looking to add a totally new front-end onto a 
  79. popular software product which they distribute. One of the major goals was
  80. that this application was to be compatible with the CUA (Common User
  81. Access) guidelines set down by IBM's SAA. This meant that the front-end had
  82. to contain mouse support, dialog boxes, scrollbars, button controls,
  83. pulldown menus, and the various other gadgets which are found in most other
  84. windowing systems. The programmers in charge of this project went out and
  85. ordered all of the commercial windowing libraries they could find. However,
  86. none of them had the combination of features which this project required.
  87.  
  88. While MEWEL was still in development, one of my friends who knew the leader 
  89. of the project told him about MEWEL. After meeting with the project leader, 
  90. and hearing his woes about choosing a windowing system, I spent a few hours 
  91. and wrote a complete front-end for them, even down to the popular Open-File 
  92. dialog box which programs like Microsoft Windows uses.
  93.  
  94. To this day, their decision lies between MEWEL and another commercial
  95. windowing library which has been out for several years. All of the other
  96. windowing libraries were eliminated! This other library might win out for
  97. the reason that they have a relatively mature product compared to MEWEL at
  98. this point, however, if they choose this system, they will have to imple-
  99. ment most of the CUA gadgets themselves! 
  100.  
  101.  
  102. SO, VAT'S ON DA DISK???
  103.  
  104. I have included some sample applications in this archive. These are 
  105.   1) A simple dialog editor which can be used to build MEWEL dialog
  106. templates.
  107.   2) A demo of manipulating listboxes.
  108.   3) A mouse demo.
  109.   4) A demo of scrollbars.
  110.   5) A demo of multiple timers and sound
  111.   6) A menu editor.
  112.   7) A demo of the PC Magazine benchmarks front-end which they asked us to do.
  113.   8) The resource compiler (RC.EXE)
  114.   9) Large-model library for Microsoft C 5.1 and Turbo C 2.0
  115.  
  116. There are two parts of the eventual MEWEL documentation included here.
  117. WINREF.ARC is the reference section to the manual, and includes
  118. descriptions of each MEWEL API function and each message which is passed
  119. through the system. Also included is the preface to the manual and the
  120. chapter on programming object-oriented systems.
  121.  
  122. There are four libraries which come with MEWEL - Microsoft C, large & medium
  123. models, and Turbo C, large & medium models. I must emphasize that we have tried
  124. to keep the source as ANSI-comptaible as possible, so that porting to another
  125. compiler should be a trivial task.
  126.  
  127.  
  128. JUST WHO THE HECK ARE YOU???
  129.  
  130. I'm glad you asked that. Magma Systems is composed of Marc Adler, who
  131. focuses as the central hub, the guiding light, and all around nice guy,
  132. plus a revolving asteroid-belt of various independent consultants. Our
  133. business is divided into two parts - consulting and product development.
  134.  
  135. We consult for a number of the larger Wall Street financial firms, con-
  136. centrating on Microsoft Windows, OS/2, Presentation Manager, Sun
  137. Workstations, etc. (You get the idea.) Among us, we have developed several
  138. trader workstations, all using some kind of windowing system or another.
  139.  
  140. The second part of Magma Systems is the product development division. We
  141. are the creators of the popular shareware word processor, New York Word, as 
  142. well as the commercial ME Text Editor. In addition, we were contracted by
  143. Microsoft to write the front-end for their SQL Server (it's the SAF program 
  144. which is distributed with SQL Server), and we are coming out with a DBase
  145. clone for a major database manufacturer.
  146.  
  147. In addition, we have had several articles published by the Microsoft
  148. Systems Journal and by Unix Today magazine.
  149.  
  150. When I am not doing all of this stuff, I enjoy tinkering around with my
  151. newborn kid, and find much relaxation in playing my drums and marimba.
  152.  
  153. This pitch is not as blatantly promotional as it seems. I love reading the
  154. biographies/credits of the authors of magazine articles and software
  155. packages. It always helps if you know the mindset of the author of a
  156. package you are using/evaluating.
  157.  
  158.  
  159. LEGALESE and LIMITATIONS
  160.  
  161.   The MEWEL demo package can be used for a 30-day trial evaluation period.
  162. You can develop applications for personal use only, not for commercial
  163. use or use by more than one person. After this period, if you still want to 
  164. use MEWEL, you *must* register your copy. Please fill out the registration
  165. form which is included in the MEWEL archive - it is in the file called
  166. REGISTER.DOC  - and enclose a check for the proper amount. Checks *must* be
  167. drawn on a US bank and payable in US dollars.
  168.  
  169.  
  170. OK! ENOUGH ALREADY! HOW DO I CONTACT YOU??? AND, HOW MUCH???
  171.  
  172. Here's the poop:
  173.  
  174.   MEWEL package without source :  $150.00 plus $5 s/h in US ($20 overseas)
  175.     includes full printed manual, Microsoft and Turbo C medium and large
  176.     model libraries, technical support, and demos.
  177.  
  178.   MEWEL package with complete source : $295.00 plus $5 s/h in US ($20 overseas)
  179.  
  180.   Magma Systems
  181.   15 Bodwell Terrace
  182.   Millburn, New Jersey  07041
  183.  
  184.   (201) 912 - 0192 (voice -- 10 to 5 weekdays)
  185.   (201) 912 - 0668 (BBS - 1200 baud 24 hrs)
  186.   BIX : magma
  187.   CompuServe : [71520,75]
  188.  
  189.  
  190.  
  191. TECHNICAL SUPPORT
  192.  
  193.     Technical support is available thorugh a variety of channels :
  194.  
  195. 1) We have a 24 hr BBS at (201) 912 - 0668. (1200 baud)
  196. 2) We have a vendor support conference on BIX (join 'magma').
  197. 3) We will be getting a vendor support conference on Compuserve. In
  198. additon, you can e-mail questions to PPN [71520,75].
  199. 4) You can reach us through the Magma Systems office.
  200. 5) We are only several of the big BBSs in New Jersey (Software Society,
  201. Microsellar, Arc Exchange).
  202.  
  203.     Non-registered  users  are  entitled  to one question of the form "Does
  204. MEWEL do this...?". Registered users receive full technical support. 
  205.  
  206.  
  207.  
  208. WHILE WE HAVE YOU HERE...A PLUG FOR OUR ME TEXT EDITOR
  209.  
  210.     ME has the following powerful features which aid you in your source
  211. code editing : 
  212.  
  213.         Virtual memory allows you to edit files as big as disk. In
  214.                 addition, the editor will swap your current session to disk 
  215.                 to free up more memory for compiles.
  216.  
  217.         Multiple windows - both horizontal and vertical. Windows can be
  218.                 zoomed and resized.
  219.  
  220.         Powerful C-like macro language allows you to add new commands or
  221.                 to modify existing ones.
  222.  
  223.         Regular expressions for searching and substitution.
  224.  
  225.         Line marking (including discontiguous line marking)
  226.  
  227.         Column block operations
  228.  
  229.         Run your compiler from within ME and examine errors interactively
  230.  
  231.         Capture a DOS session in a window
  232.  
  233.         Real, variable width tabs.
  234.  
  235.         Toggle between alternate display modes from within your editing
  236.                 session. ME allows you to create external drivers which 
  237.                 support different video boards and monitors. ME lets you
  238.                 toggle between 25 and 43 line modes if you have an EGA.
  239.  
  240.         Keystroke macros, with the ability to assign a keystroke macro to
  241.         another key and to generate a macro program from the keystrokes. 
  242.  
  243.     The most popular shareware editor, QEDIT (by Sammy Mitchell), does
  244. not have a powerful macro language, does not support virtual memory,
  245. does not have discontiguous line marking, will not capture a DOS session in 
  246. a window, does not have regular expressions, and does not have an OS/2
  247. version yet.
  248.  
  249.     BRIEF (tm Solution Systems) will not let you toggle video modes from
  250. within a session, will not capture a DOS session in a window, does not have 
  251. discontiguous line marking, does not come with a source code option, and
  252. has a LISP-like macro language. 
  253.