home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / atccnr.zip / atccnr.ipf < prev    next >
Text File  |  1993-10-12  |  5KB  |  136 lines
  1. :userdoc.
  2. :title.Help for Air Traffic Control Container
  3. :docprof.
  4. :ctrldef.
  5. :ctrl ctrlid=a controls='PREVIOUS SEARCH PRINT INDEX CONTENTS ESC BACK FORWARD' coverpage.
  6. :ectrldef.
  7. :body.
  8.  
  9. :h1 res=1.General Help
  10. :i1.General Help
  11. :p.Welcome to :hp2.Air Traffic Control Container:ehp2.,
  12. a very simple ATC radar simulator whose main purpose is to
  13. provide an interesting example of OS/2 PM Container programming.
  14. Its design was stimulated by the author's visit in October, 1993,
  15. to Bay TRACON, the main air traffic control location for the San
  16. Francisco Bay Area.
  17.  
  18. :i1.OS/2 Bay Area User Group
  19. :i1.Developers SIG
  20. :p.ATC Container was originally written for a presentation by the
  21. author to the OS/2 Bay Area User Group's
  22. :link reftype=fn refid=devsig.Developers SIG:elink., on container
  23. programming.
  24.  
  25. :p.ATC Container illustrates several areas of
  26. container programming:
  27. :ul.
  28. :li.Multiple views
  29. :li.Inserting multiple container records
  30. :li.Explicitly positioning records
  31. :li.Enumerating container contents
  32. :li.Using a PM Timer to move the container objects at regular intervals
  33. :li.Multiple context menus
  34. :li.Container background owner-drawing
  35. :li.Bitmaps for screen drawing performance
  36. :li.Randomly generating aircraft (always good to know)
  37. :eul.
  38.  
  39. :i1.Program Author
  40. :p.:link reftype=fn refid=db.Dave Briccetti &. Associates:elink.
  41. .br
  42. P.O. Box 1713
  43. .br
  44. Lafayette, CA  94549-7013
  45. .br
  46. USA
  47. .br
  48. 510 945-7565
  49. .br
  50. CompuServe: 74475,1072, Internet: daveb@netcom.com
  51. :p.Copyright (c) 1993, David C. Briccetti
  52. .br
  53. All Rights Reserved.
  54.  
  55. :fn id=db.
  56. :p.Dave Briccetti &. Associates
  57. has been developing sophisticated OS/2 applications
  58. for users and clients since 1987.
  59. :p.As you might have guessed,
  60. Dave Briccetti is a private pilot.
  61. :efn.
  62.  
  63. :fn id=devsig.
  64. :p.The :hp2.Developers SIG:ehp2. is a very technical subset of the
  65. OS/2 Bay Area User Group membership.  The group meets once a month
  66. in Silicon Valley, and covers such topics as:
  67. :ul.
  68. :li.PM Programming
  69. :li.Workplace Shell programming
  70. :li.SOM programming
  71. :li.C++ and other object-oriented languages and facilities
  72. :li.Productive application development
  73. :eul.
  74. :p.For more information about the Developers SIG, contact Dave
  75. Briccetti.
  76. :efn.
  77.  
  78. :h1.Views
  79. :i1.Views
  80. :p.ATC Container starts up in the :hp2.Radar View:ehp2., which bears
  81. a slight resemblance to the ARTS III radar scopes in use in some
  82. facilities.  The jet icons represent targets being tracked, and the
  83. numbers below each icon represent the aircraft's altitude and speed.
  84. The altitude shown has the two rightmost zeroes removed for brevity.
  85. The speed has one zero removed.
  86.  
  87. :p.The other views do not provide positional information.  The
  88. :hp2.Name:ehp2. view just shows the icons and title text.  The
  89. :hp2.Text:ehp2. view just shows the title text.
  90.  
  91. :p.The :hp2.Details:ehp2. view shows much more information about
  92. each aircraft, including the current and assigned heading,
  93. altitude, and speed.
  94.  
  95. :p.To change views, click in the container with the context menu
  96. mouse button when the mouse pointer is not over an aircraft.
  97.  
  98. :h1.Controlling Aircraft
  99. :i1.Controlling Aircraft
  100. :p.ATC Container allows you to control aircraft.  Click on an
  101. aircraft to bring up a context menu.  Select the :hp2.Control
  102. Aircraft:ehp2. menu item.
  103.  
  104. :p.A dialog box appears with spin buttons which allow you to
  105. assign a new heading, altitude, and speed.  The aircraft will
  106. gradually maneuver to comply with your instructions.
  107.  
  108. :h1.Limitations
  109. :i1.Limitations
  110. :p.ATC Container has many limitations.
  111.  
  112. :dl break=all.
  113. :dt.Aircraft Maneuvering Rates
  114. :dd.The rates at which the aircraft change heading, altitude,
  115. and speed are not realistic.  For example, a standard rate turn is
  116. 3 degrees per second, and these aircraft turn at 1 degree per
  117. second.  Also, the program doesn't know enough about the compass
  118. to know that in order to change from heading 010 to 350 a 20 degree
  119. left turn would be appropriate.  Instead, it will turn right.
  120. :dt.Scroll Bars
  121. :dd.As aircraft move off the scope, scroll bars appear.  The
  122. program does not have proper support for scrolling.
  123. :dt.Crashing
  124. :dd.The program crashes occasionally
  125. :dt.Lack of cleanup
  126. :dd.The program does not free the memory it allocates, but
  127. sloppily relies on the C runtime library and/or OS/2 to clean
  128. up at program termination.
  129. :dt.Limited Usefulness
  130. :dd.ATC Container is an interesting container example, but it
  131. is far from a real ATC simulator.
  132. :edl.
  133.  
  134. :index.
  135. :euserdoc.
  136.