home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 March / Chip_1998-03_cd.bin / zkuste / delphi / WhiteAnts / CONTSTRM.ZIP / ReadMe.TXT < prev    next >
Encoding:
Text File  |  1997-01-10  |  6.6 KB  |  184 lines
  1. +----------------------------------------------------------------------------+
  2. |                                      ⌐  ⌐                                  |
  3. |                                    ⌐⌐ ⌐ ⌐ ⌐                                |
  4. |                                 ⌐⌐⌐ ⌐   ⌐  ⌐                               |
  5. |                                 ⌐⌐    ⌐ ⌐   ⌐                              |
  6. |                  ⌐             ⌐⌐     ⌐  ⌐                                 |
  7. |                 ⌐ ⌐            ⌐⌐⌐    ⌐⌐  ⌐                                |
  8. |             ⌐⌐  ⌐  ⌐      ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐  ⌐                                    |
  9. |            ⌐  ⌐⌐  ⌐⌐      ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐                                  |
  10. |            ⌐ ⌐⌐⌐ ⌐⌐⌐⌐⌐⌐ ⌐⌐⌐ ⌐   ⌐⌐⌐⌐⌐⌐⌐⌐                                   |
  11. |           ⌐ ⌐⌐ ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐ ⌐   ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐      Copyright ⌐ 1996-1997 by:  |
  12. |           ⌐ ⌐⌐⌐⌐⌐⌐ ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐  ⌐ ⌐⌐⌐⌐⌐ ⌐⌐                                 |
  13. |          ⌐ ⌐⌐⌐⌐⌐⌐⌐   ⌐⌐⌐⌐⌐ ⌐⌐⌐⌐    ⌐⌐ ⌐⌐ ⌐      WHITE ANTS SYSTEMHOUSE BV  |
  14. |         ⌐  ⌐⌐⌐⌐⌐⌐⌐ ⌐⌐⌐ ⌐⌐⌐ ⌐⌐ ⌐       ⌐⌐⌐⌐      Geleen 12                  |
  15. |         ⌐ ⌐⌐⌐⌐⌐⌐⌐    ⌐   ⌐⌐   ⌐⌐⌐       ⌐       8032 GB Zwolle             |
  16. |           ⌐⌐⌐⌐⌐⌐     ⌐            ⌐ ⌐           Netherlands                |
  17. |      ⌐⌐⌐  ⌐⌐⌐⌐⌐      ⌐     ⌐⌐     ⌐  ⌐                                     |
  18. |            ⌐⌐       ⌐              ⌐  ⌐⌐⌐ ⌐     Tel. +31 38 453 86 31      |
  19. |      ⌐              ⌐              ⌐            Fax. +31 38 453 41 22      |
  20. |      ⌐             ⌐               ⌐⌐                                      |
  21. |    ⌐              ⌐                  ⌐⌐         www.whiteants.com          |
  22. |  ⌐⌐              ⌐                     ⌐ ⌐      support@whiteants.com      |
  23. |                 ⌐                                                          |
  24. +----------------------------------------------------------------------------+
  25.  
  26.  
  27.  
  28.                 S T R E A M S   &   C O N T A I N E R S   1.1
  29.                 =============================================
  30.  
  31.  
  32.  
  33. CONTENTS
  34. --------
  35. * History
  36. * Introduction
  37. * Description
  38. * Files
  39. * Install
  40. * White Ants
  41. * Technical Support
  42. * How To Reach Us
  43.  
  44.  
  45. HISTORY
  46. -------
  47. Jan 10, 1997 - Release 1.1
  48.                Improved.
  49.                The binary output format for filters remains unchanged.
  50.  
  51.              - Release 1.0
  52.                Available with beta 1 of ModelMaker 1.5.
  53.  
  54.  
  55. INTRODUCTION
  56. ------------
  57.  
  58. Streams & Containers 1.0 is Freeware (more info see Disclaim.txt) and contains
  59. 16 bits Delphi 1.0 units CONTAINR and FILTERS which implement and extend BP7.0
  60. style collections and streams.
  61.  
  62.  
  63. DESCRIPTION
  64. -----------
  65.  
  66. TFilter is a TStream descendant which adds the Put / Get object streaming
  67. capabilities to a TStream instance. TFilter does not actually read or write
  68. data but delegates this to an attached stream. This stream can be owned or not.
  69.  
  70. Filters adhere to the decorator pattern.
  71. Filters can be cascaded:
  72.    Filter1 => Filter2 => Filter3 => TStream. (such as TFileStream)
  73.  
  74. Some additional filters are included:
  75. - BufferedFilter buffers it's IO
  76. - BufFileFilter is a combination of a TBufferedFilter with a TFileStream
  77. - TCycleFilter is a filter that is able to read and write cyclic object
  78.   structures like: Parent saves children and children save their parent.
  79. - TClipBrdFilter reads and writes is a binary clipboard stream, allowing you
  80.   to stream classes to the clipboard the same way you stream them to a file
  81. - TOffsetFilter which lets you treat a section in an other stream as new
  82.   complete stream, including Position := 0, Size etc.
  83.  
  84. Utility procedures include
  85. - Reading and writing of PChar and TStrings from/to a TFilter
  86. - Copying a TStreamable instance by first putting it to memory and then getting
  87.   it back.
  88.  
  89. For classes to be streamable, they HAS TO be a TStreamable descendant AND be
  90. registered as streamable using the RegisterStreamable procedure.
  91.  
  92. TContainer is an abstract base class which defines an interface for list like
  93. data types. TCollection is a direct descendant which implements a TContainer
  94. using a Delphi 1.0 TList class. TCollection add to TList
  95. - Ownership of items (property OwnesItems)
  96. - Sorting of list (property Sorted / CanSort)
  97. - Duplicate behavior (property Duplicates)
  98. - OnChange notifications
  99. - Streamable behavior (TContainer is a streamable class) allowing you to Put a
  100.   whole container at once on a stream: Filter.Put(List)
  101.  
  102. This version of FILTERS and CONTAINR fix some bugs and extend the
  103. exiting functionality.
  104.  
  105.  
  106. FILES
  107. -----
  108.  
  109. Main files
  110. - README.TXT    This file
  111. - DISCLAIM.TXT  The file containing the disclaimer for Streams & Containers
  112. - CONTAINR.PAS  Contains TContainer and TCollection classes
  113. - FILTERS.PAS   Contains TFilter classes
  114. - NUMUTILS.PAS  Contains numeric utilities needed by CONTAINR and FILTERS
  115. - STRUTILS.PAS  Contains string utilities needed by CONTAINR
  116.  
  117. Demo files
  118. - CONTSTRM.EXE  The demo executable
  119. - CONTSTRM.DPR  The demo project
  120. - CONTSTRM.RES  The demo project resource
  121. - EDITFRM.PAS   The demo sample editing dialog form source file
  122. - EDITFRM.DFM   The demo sample editing dialog form resource file
  123. - MAINFRM.PAS   The demo main form source file
  124. - MAINFRM.DFM   The demo main form resource file
  125. - STRMSAMP.PAS  Contains TSampleList and TSample classes which demonstrate
  126.         containers and streaming
  127. - SAMPLE1.SMP   A Sample file containing a streamed TSampleList
  128.  
  129.  
  130. INSTALL
  131. -------
  132.  
  133. - Unzip CONTSTRM.ZIP, for example in directory c:\CONTSTRM
  134. - Open the project file CONTSTRM.DPR and compile the project
  135. - You do NOT need to install any components other than provided by Delphi 1.0
  136.  
  137.  
  138. WHITE ANTS
  139. ----------
  140.  
  141. White Ants systemhouse BV is specialised in developing software in Borland
  142. Delphi for all Microsoft Windows platforms.
  143.  
  144. Our main activities are:
  145.  
  146. 1) Turnkey building of customer specific software.
  147.    Varying from single applications to complex real-time distributed computer
  148.    systems and multi-tier client/server solutions.
  149.  
  150. 2) Tools and components for professional colleague software developers.
  151.    Including the Delphi CASE tool ModelMaker.
  152.  
  153.  
  154. Visit our website for information about us and our latest tools and components:
  155.  
  156.    www.whiteants.com
  157.  
  158. Or e-mail us at info@whiteants.com
  159.  
  160.  
  161. TECHNICAL SUPPORT
  162. -----------------
  163.  
  164. Please e-mail us at support@whiteants.com if you have any problems or find any
  165. bugs in this code.
  166. We do not offer support on our FREEWARE by telephone, fax or letter.
  167.  
  168.  
  169. HOW TO REACH US
  170. ---------------
  171.  
  172. White Ants systemhouse BV
  173. Geleen 12
  174. 8032 GB Zwolle
  175. Netherlands
  176.  
  177. Tel. +31 38 453 86 31
  178. Fax. +31 38 453 41 22
  179.  
  180. www.whiteants.com
  181. support@whiteants.com
  182.  
  183.  
  184.