home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 16 Announce / 16-Announce.zip / MIRDEF.ZIP / MIRDEF.DOC
Text File  |  1992-05-12  |  3KB  |  71 lines

  1. Many of you have asked about Mirrors -- What is it? How does it work?
  2. How do I use it?  Where do I get it?  What follows is a bit more 
  3. detailed description about how Mirrors works.
  4.  
  5. How Mirrors Works
  6.  
  7. First, let's review the architecture and environment in which 
  8. applications running under OS/2 and Windows operate.  They are 
  9. similar.  
  10.  
  11. An application in both environments typically consists of code which 
  12. is designed to process event driven messages as input.  Frequently 
  13. these messages cause the application to use system resources 
  14. which reside in dynamic linked libraries, such as functions to render 
  15. graphic output or access the file system.  The use of these system 
  16. capabilities is provided by way of function calls which are exported 
  17. from various system DLLs.
  18.  
  19. Both development environments locate a number of necessary items 
  20. in separate files.  These include application icons, bit maps, help files, 
  21. and other things.  Here again there is a strong similarity between the 
  22. structure of the two environments.  Although a PM application cannot 
  23. directly use a Windows icon, the process of translating one into the 
  24. other is relatively simple.  Translation of these resources is done 
  25. once, before the application is linked, by a set of conversion utilities 
  26. provided by Mirrors.
  27.  
  28. The similarity of both architectures and the nature of dynamically 
  29. linked libraries are the conditions which enable Mirrors to empower 
  30. Windows applications to run under OS/2.  The Windows application, 
  31. which has been ported to OS/2, continues to make calls to what it 
  32. believes to be the Windows system DLLs.  However, these calls are 
  33. intercepted by the Mirrors DLLs which then passes the call on to the 
  34. appropriate export within the OS/2 system DLLs or implements the 
  35. equivalent functionality using the PM API.  For instance, Windows 
  36. dialog boxes and control classes are implemented entirely by Mirrors.
  37.  
  38. Components of Mirrors
  39.  
  40. Mirrors has two principle components: DLLs and static conversion 
  41. utilities.  
  42.  
  43. The static conversion utilities are simple command
  44. line utilities.  Using them is simple.  For instance, to convert
  45. a Windows Definition File to a PM Definition File you would issue
  46. a command like:  MIRDEF INPUT.DEF OUTPUT.DEF.
  47. It's as easy as that.  The utility will run and produce a PM Def
  48. file for your application.
  49.  
  50. The other component of the Mirrors toolkit are its DLL files, 
  51. which are OS/2 Presentation Manager dynamic link libraries.  These 
  52. allow a Windows application to run virtually unchanged under the 
  53. Presentation Manager.
  54.  
  55. Mirrors acts as a filter between the Windows application code and the 
  56. Presentation Manager.  Mirrors emulates Windows by defining all of 
  57. the necessary Windows functions in the Mirrors DLL. When an 
  58. application calls a Windows function, Mirrors accepts the call and the 
  59. parameters passed with it. Mirrors then implements the function using 
  60. the functions within the OS/2 system DLLs. 
  61.  
  62. Where to Get Mirrors
  63.  
  64. Though developed by Micrografx, Mirrors will be avaialable from IBM.  
  65. Call whatever number you usually do to find out about IBM developers 
  66. kits and so forth.  I don't give a number here because this 
  67. message will probably travel internationally and those numbers 
  68. vary from place to place.
  69.  
  70. Yours, Derrel R. Blain, Micrografx
  71.