home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 13 / 13.iso / p / p034 / 1.ddi / ARCAHELP / HELP.ZIP / GNLIB.HLP < prev    next >
Encoding:
Text File  |  1992-02-02  |  6.9 KB  |  175 lines
  1. GNLIB                                                   Menu: Non-menu command
  2. ==============================================================================
  3. Generates a library of entities for placing in the model.
  4.  
  5.          1. (CHAR) name of library description file (.lib) (up to 8 chars.)
  6.  
  7. Description
  8. This command creates libraries of entities from a library description file.
  9. The libraries created can then be used to place the entities in your models.
  10.  
  11. The libraries are defined in a library description file with a name of up to
  12. eight characters and the extension .LIB.  You may create as many library
  13. description files as you wish.
  14.  
  15. A library description file contains the list of entities included in one or
  16. more libraries.  There are three types of libraries: symbols (lib), 3D
  17. (lib3d), and openings (libop).
  18.  
  19. The following is the layout required for a library description file:
  20.  
  21.           lib=libname
  22.           table1description1
  23.           table2description2
  24.           .
  25.           .
  26.           lib3d=libname
  27.           chair1description1
  28.           .
  29.           .
  30.           libop=libname
  31.           win1<w1>description1
  32.           win2<w2>description2
  33.           win3description3
  34.  
  35. Each library within the file is headed by a line:
  36.  
  37. lib=libname     where the library consists of 2D symbols
  38. lib3d=libname   where the library consists of 3D objects
  39. libop=libname   where the library consists of openings
  40.  
  41. The library name is the name that the system searches for when calling the
  42. library.  The system creates a drawing file (.III and .DDD) for each of the
  43. libraries listed in the library description file, i.e., libname.III and
  44. libname.ddd.
  45.  
  46. The list following the library name is a list of library elements.  These
  47. elements are ordinary drawing files with extensions .III and .DDD which must
  48. reside either in the working directory or in \ARCALIB.  They will appear in
  49. the graphic menu when the library is called.
  50.  
  51. You may add a short description after the element name, such as:
  52.          TBL4CHR1  table and 4 chairs (110x60)
  53.  
  54. where    "TBL4CHR1" is the name of the library element and
  55.          "table and 4 chairs (110x60)" is the description.
  56.  
  57. The description can be up to 40 characters and will appear above the entity
  58. when viewing this item of the graphic library in more detail.
  59.  
  60. It is recommended to group objects of the same type within individual
  61. libraries.  For example, all sanitary fitting symbols within one library and
  62. all doors of a specific type within another.  The library is retained by the
  63. system for use in future sessions until it is erased or overwritten.
  64.  
  65. The following are examples of .LIB files:
  66.  
  67.      3d.lib
  68.  
  69.           lib3d=3D_chairs
  70.           CH1   livingroom_chair1
  71.           CH2   livingroom_chair2
  72.           CH3   livingroom_chair3
  73.           CH4   study_deskchair
  74.  
  75.           lib3d=3D_beds
  76.           BED1  mainbdrm_dblbed
  77.           BED2  childsrm_singlebed
  78.  
  79.           open.lib
  80.  
  81.           libop=l$open
  82.           door1<w2> simple door
  83.           dbldoor1double 180cm
  84.           slwindo1  <w1> sliding window
  85.           window1  <w1> simple window
  86.           w-open <w1>
  87.           d-open  <w1>
  88.  
  89. Note that an `_' in the .LIB file element description will appear as a blank
  90. when it is displayed with the element.  The element description can be updated
  91. using the \edcom command.
  92.  
  93. After defining the libraries use \gnlib to generate them.
  94.  
  95. If an object is bad, missing or empty, the system will issue a message.
  96.  
  97. In order to call a library that you have created, it is necessary to include
  98. it in the pull-down menu.  This is done by editing the .POP file in the
  99. directory \ARCA.
  100.  
  101. NOTE: Make a backup copy of the .POP file before making any alterations to it.
  102.  
  103. In the file you will find a section similar to the following:
  104.          %plac.pop
  105.          3-DELEMENTS;@-lib8|jc\drag|;
  106.          SANITARY FITTINGS;@-lib7|jc\drag|;
  107.          WC;@ . . .
  108.  
  109. The first part of each line, i.e., up to the `;', is what will appear in the
  110. pull-down menu.  This is followed by @-libname, which is the library name as
  111. defined in the .LIB file.  |jc clears the input.  \drag| activates the \drag
  112. command.
  113.  
  114. If you wish to add your own libraries to the pull-down menu, change the
  115. existing lines or add new lines immediately after the existing ones.  Type a
  116. short description followed by `;@-' and your library name.
  117.  
  118. After changing the .POP file it is necessary to compile the system or, extract
  119. the new file with the extension .POP (e.g., plac.pop) and place it in the
  120. \ARCA\USERDEF subdirectory.
  121.  
  122. To compile the system go to the \ARCA directory and type:
  123.          COMPILE
  124.  
  125. NOTE: If you want to add a few entities to a library, use the \olib command
  126. (option `a') to create a new library.  If you want to add a large number of
  127. entities to an existing element or opening library without losing the existing
  128. elements, make sure you extract all the elements using the \olib command
  129. (option `e').  For all library types, add existing element names and
  130. descriptions to the library definition file.
  131.  
  132. Using the Symbols Library
  133.  
  134. The elements in this library must be created in plan view on the xy plane and
  135. at (0,0).
  136.  
  137. Once an entity has been included in the library, its original drawing file may
  138. be deleted as the entity itself is stored in the library file.
  139.  
  140. Using the 3D Library
  141.  
  142. The elements in this library must be created at (0,0,0).
  143.  
  144. When elements from this library are selected, a reference to the drawing file
  145. is used, therefore the original drawing file must not be deleted.
  146.  
  147. Using the Openings Libraries
  148.  
  149. The elements in this library must be created in plan view on the xy plane and
  150. at (0,0).
  151.  
  152. Openings for placing within walls may be:
  153.     a. fixed size entities
  154.     b. elastic entities stretchable in one direction only (e.g., windows)
  155.     c. elastic entities stretchable in two directions (e.g., door symbols)
  156.  
  157. When creating an opening, two sets of "control" lines must be added in the
  158. drawing file.  The first set indicates the width of the opening to be cut in
  159. the wall when using the \odrag command.  The second set defines the alignment
  160. of the opening within the wall, e.g., both external faces of the wall.  The
  161. lines must be of line type 4 and line color 1 and will not be seen when the
  162. entity is placed.
  163.  
  164. In order to make the item an elastic entity in one direction it is necessary
  165. to add "<w1>" after the file name and before the description in the library
  166. description file, e.g., window1 <w1> standard window.  For elastic entities in
  167. two directions add "<w2>" after the file name.
  168.  
  169. NOTE: When designing elastic openings it is important to bear in mind that the
  170. entity is stretched or shrunk along its original X axis and relative to its
  171. central axis.  It is essential that the basic X dimensions be 1.
  172.  
  173. Once an opening entity has been included in the library, its original drawing
  174. file may be deleted as the entity itself is stored in the library file.
  175.