home *** CD-ROM | disk | FTP | other *** search
/ M.u.C.S. Disc 2000 / MUCS2000.iso / anwend / family / gens.doc < prev    next >
Text File  |  1996-10-02  |  6KB  |  224 lines
  1.     DOCUMENTATION for GENS.DAT
  2.     **************************
  3.  
  4.  
  5.     Its a simple text file (CR,LF) containing two parts:
  6.     - 8 first lines are reserved for the fonts
  7.     - the other lines for your family
  8.  
  9.  
  10. ~~~~~~~~~~~~~~~~~
  11. First part: FONTS
  12. ~~~~~~~~~~~~~~~~~
  13.     Family uses four fonts:
  14.     - roman: normal text
  15.     - italic: the little text under a photo
  16.     - bold: the name
  17.     - italic bold: the buttons
  18.  
  19.     You must know the ID of every font to pass it to Family, if no
  20. font correspond to this ID, then the system font is used. The IDs are
  21. given by ID_FONT.PRG that creates ID_FONT.TXT. I've found in it:
  22.  
  23.     05011 dutch 801 roman
  24.     05012 dutch 801 italic
  25.     05013 dutch 801 bold
  26.     05014 dutch 801 bold italic
  27.  
  28.     These are the four fonts I use with Speedo 5.
  29.  
  30.     You must also indicate the point size of every font. So the 8
  31. first lines are these:
  32.  
  33. ID of the roman font
  34. its size
  35. ID of the italic font
  36. its size
  37. ID of the bold font
  38. its size
  39. ID of the italic bold font
  40. its size
  41.  
  42.     Here are my settings:
  43.  
  44. 5011
  45. 12
  46. 5012
  47. 10
  48. 5013
  49. 16
  50. 5014
  51. 14
  52.  
  53. ~~~~~~~~~~~~~~~~~~~~~~~~
  54. Second part: Your Family
  55. ~~~~~~~~~~~~~~~~~~~~~~~~
  56.  
  57.     Starting on the 9th line, you enter the description of the members
  58. of your family. There are only two special characters: ? and * for unknow
  59. information or unappliable information.
  60.  
  61.     THE INFORMATION ORDER IS FIXED, NO FANTASY!
  62.  
  63.     Every person has a variable number of lines, here they are:
  64.  
  65. Index:        ; the position of the person into this file starting at 0.
  66. Last Name    ; Upper case, it's better, I put 'X' if unknown.
  67. First Name    ; Lower case, it's better.
  68. Birthdate or ?
  69.         ; ? if unknown
  70.         ; the program only adds 'born' before it, so you can use
  71.         ; different sentences:
  72.         ; on july, 1st, 1952      -> born on july, 1st, 1952
  73.         ; in 1952        -> born in 1952
  74.         ; between 1950 and 1953    -> born between 1950 and 1953
  75. Birth place or ?
  76.         ; ? if unknown
  77.         ; the program adds 'in ' before, or 'born in' if the
  78.         ; bithdate was unknown
  79. Death date or ? or *
  80.         ; ? if dead but date unknown
  81.         ; * if still alive, so the next line MUSN'T appear
  82. Death place or ?
  83.         ; ? if unknown, don't put this line if still alive
  84. Wedding date or ? or *
  85.         ; ? if married but date unknown
  86.         ; * if not married, so the next two lines MUSN'T appear
  87. Wedding place or ?
  88.         ; ? if unknow
  89.         ; this line musn't appear if not married
  90. Husband or Wife's index or -1
  91.         ; if into GENS.DAT, the index, -1 if not present
  92. Father's index or -1
  93.         ; -1 if not into GENS.DAT
  94. Mother's index or -1
  95.         ; same as above
  96. First child index or -1
  97.         ; -1 if not children or if they're not into GENS.DAT
  98. Next brother or siter's index or -1
  99.         ; -1 if no brother and sister
  100.         ; if the last child, I put the index of the first: it
  101.         ; loops!
  102. Sound file or *
  103.         ; * if no sound
  104.         ; name+extension if present, it must be located into the
  105.         ; SONS folder (exemple: peter.avr)
  106. First photo file or *
  107.         ; * if no photo
  108.         ; its name and extension, it must be located into the
  109.         ; IMAGES folder. See Images.DOC for 16 and 256 colors
  110.         ; options.
  111. first photo legend
  112.         ; a simple line text
  113. Second photo file
  114. second photo legend
  115. ....
  116.         ; you can specify up to 7 photos per person. Those lines
  117.         ; are grouped two by two. When this list is ended, put a
  118.         ; line with *.
  119. first line for Some facts or *
  120. second line for some fact or *
  121. ...
  122.         ; you can specify up to 7 lines. Their width depends on
  123.         ; the font you use. Put a single * when this list is
  124.         ; ended.
  125.  
  126.  
  127.     That's all for one person. The next one start on the line
  128. immediatelmy following the '*'. The Index must be the previous + 1.
  129.  
  130.  
  131.     HOW TO END THE FILE????
  132.  
  133.     Just put -1 as the index. You must do this, else the program
  134. crashes.
  135.  
  136.     Here are some examples:
  137.  
  138. Voici quelques exmples de personnes:
  139.  
  140. 12            ; he is the 13th of this file
  141. SMITH
  142. Peter
  143. on october, 4th, 1951    ; birthdate
  144. Paris            ; birth place
  145. *            ; still alive
  146. *            ; not married
  147. 14            ; his father has index 14
  148. 15            ; his mother has index 15
  149. -1            ; no children
  150. 20            ; his next brother has index 20
  151. peter.pac        ; a sound
  152. peter01.12b        ; first photo
  153. With his mother, 1959    ; the legend
  154. peter02.12b        ; second photo
  155. His first bike, 1963    ; second legend
  156. *            ; no more photos
  157. *            ; no facts
  158. 13              ; here starts the next person
  159. ....
  160.  
  161.  
  162.     Other example:
  163.  
  164. 8            ; he is the 9th of this file
  165. WATSON
  166. Philip
  167. in the 1920's        ; not precise
  168. ?            ; unknown birth place
  169. ?            ; dead, but don't know when
  170. in China        ; cause it was very far
  171. in the 1960's        ; not precise
  172. between 1939 and 1945    ; married during second world war
  173. Paris            ; in Paris
  174. -1            ; unknow wife
  175. -1            ; father unknown
  176. -1            ; mother unknown
  177. -1            ; no children known
  178. 10            ; but a brother (the 11th in this file)
  179. *            ; no sound
  180. *            ; no photo
  181. He wrote his last letter
  182. to his brother in 1958.    ; but a fact.
  183. *
  184.  
  185.  
  186. ~~~~~~~
  187. Summary
  188. ~~~~~~~
  189.  
  190.     Print it, it will be useful while entering your family:
  191.  
  192. >>> Every line starts on the first column
  193. >>> most of all with * and ? characters or filenames.
  194.  
  195. Index or -1 for the end of file
  196. LAST NAME
  197. First name
  198. Birth date or ?
  199. Birth place or ?
  200. Death date or ? or * if still alive
  201. Death place or ? (not present if still alive)
  202. Wedding date or ? or * if not married
  203. Wedding place or ? (not present if not married)
  204. Husband or Wife's index or -1 if unknown (not present if not married)
  205. Father's index or -1
  206. Mother's index or -1
  207. First child's index or -1
  208. Next brother or sister's index or -1
  209. Sound file or *
  210. Photo file #1 or *
  211. Photo legend
  212. Photo file #2 or *
  213. Photo legend
  214. ... up to 7 photos
  215. Text line #1 'Some facts' or *
  216. Text line #2 'Some facts' or *
  217. ... up to seven lines
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.