home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / misc / jcgraph / helpfile / stepbystep.hlp < prev    next >
Text File  |  1995-02-27  |  7KB  |  126 lines
  1. \font Helvetica 15
  2. \title Step by step example.
  3.  
  4.     We will produce a graph made of 3 rows of 3 planes each and output it as
  5. AegisDraw2000.
  6.  
  7.     The first step is data creation. To do so, use your favorite text editor.
  8. It is important that it should not produce a file containing special control
  9. characters that would not be recognized by JcGraph (stay ASCII international).
  10.     After your text editor is loaded, start by entering "1002" (without the
  11. delimiters). This sequence help JcGraph identify the file type, to be sure
  12. that it is really compatible. Note that all value should be comma-separated.
  13.     Next, enter the number of column that your file will contain, "3" in our
  14. example. Do the same thing for the number of line. Follows a number which
  15. will set the space between each cotation in the scale on the side of the
  16. graph; for example, if your data range from 0 to 100 and you specify 25,
  17. the cotation scale will output "0","25","50","75","100". This number use
  18. the same value unit as the data itself.
  19.     The next number (floating point), is the one by which every cotation
  20. value will be multiplied ; for example, if you enter "1.24", each cotation
  21. of the scale will be muliplied by 1.24. This permits to access floating
  22. point value without changing the data itself. Note that only 3 decimals
  23. positions will be kept for now and that a value of 0 will result in an
  24. integer form (ie no decimal point).
  25.     The next step is the value entry. As we chose to produce a 3 by 3 data
  26. file, there will be 9 consecutive values (they can be on the same line but
  27. should always be comma-separated).
  28.     The 3 next value are text strings that will identify your columns (they
  29. should always be filled). Same procedure for each line. Note that the
  30. orientation is always the same. Rows represents variation and lines are
  31. diferent products type.
  32.  
  33. Here is the resulting data file from the example:
  34. 1002,
  35. 3,3,10,0,
  36. 10,20,30,
  37. 50,60,60,
  38. 15,32,17,
  39. Jan,Fev,Mar,
  40. Gaz,Oil,Fer,
  41.  
  42. Save this result as "test3X3.asc".
  43.  
  44.     The next major step is to load this data file in JcGraph. First, run
  45. JcGraph. Note that once JcGraph is startes, there can be a 3 to 5 second
  46. break before you see anything happen, this is normal.
  47.     Now, choose "Open..." from the project menu (Amiga+O)
  48. IMPORTANT: JcGraph accepts command from the interface window only. So, every
  49. time you want to perform an operation, you should select it (if not already
  50. selected). It is also worth to mention that when there is no data loaded in
  51. JcGraph, the interface's title bar will display "No Data".
  52.     A file requester will pop up asking "Choose an ASCII data file". It's
  53. utilisation is not described here for brievty but can get extended help by
  54. pressing HELP or SHIFT-F1 when it is active.
  55.     Find et select your file "test3X3.asc" and select "Open" from the lower
  56. left corner of the file requester's window. The mouse pointer will change
  57. for a small clock until your data file is openned. This should'nt be long.
  58.  The title bar should now display "test3X3.asc".
  59.     The window titled "Preview" gives an approximation of what the final
  60. graph will look like, in this case, data is graphed as 3D blocks. For
  61. example purpose, we will choose another type of graphic.
  62.     Choose "Load..." (Amiga+T) from the "GraphType" menu. Another file
  63. requester should appear. If JcGraph is correctly installed, a number of
  64. file ending with ".grf" extension should be listed in the window. You can
  65. now choose the type of graph that best suit your needs. For the example,
  66. choose "3D_BrokenPlanes.grf" then "Load...". After a short period of time,
  67. you should see the new graph type reflected in the Preview window. Note that
  68. the wireframe representation of the preview window is used for real-time
  69. manipulation, the final output is filled with colors.
  70.     The actual three-dimensionnal perspective doesn't do justice to the 3D
  71. effect, so we will rotate the graph using the interface window's gadgets.
  72. There is two main section that divide the interface window:
  73. 1. To the left, there is two gadget labelled "Undo" and "Render". We will
  74. discuss their respective function later.
  75. 2. To the right, there is 4 lines of gadgets. These ones control rotation
  76. values and perspective of the graph.
  77.     Line 1: Rotation around X.
  78.     Line 2: Rotation around Y.
  79.     Line 3: Rotation around Z.
  80.     Line 4: Perspective control.
  81.  
  82.     For example purpose, we will not discuss these any further  (they are
  83. described in section 5). For now, just select the first gadget from the top
  84. (the rectangular one, with a "0" in it) and replace the "0" by "-30". Press
  85. RETURN. Do the same with the next gadget, but this time, replace "0" by "30".
  86. You will immediatly see the change in the preview window. The effect is a
  87. lot more dynamic.
  88.     Now, if you want to look at the final result, select the "Render" gadget
  89. from the interface window. The mouse pointer will change for a longer period
  90. of time. After a while, the pointer should get back to normal and you should
  91. see the final result in the Output window. If it is obscured by another
  92. window, just bring it to the front (but remember to click back in the
  93. interface window in order to do any other manipulation on the graph).
  94.     From here, there could some constatation:
  95. 1. It's nice (I hope so :-)
  96. 2. It's too small.
  97. 3. You don't like the colors.
  98.  
  99. We will solve all the problems, one at a time.
  100. 1. It's nice: That's not really a problem.
  101. 2. It's too small: Grab the sizing gadget (the one at the lower right of
  102. the Output window) and drag it to the desired size. Now, re-press "Render"
  103. and "voila!".
  104. 3. You don't like the colors: It is the next step.
  105.  
  106. Color choice:
  107. Choose the "Color..." (Amiga+k) option under the "Edit" menu. A requester
  108. named "Data color selector" should pop up. To the left, you should see all
  109. available colors... to the right, the values to be colored. You will
  110. probably recognize the texts associated with each line of value. There is
  111. also two more entries named "Background" and "Floor" which will permits
  112. respectively to change the colors of the background, behind the data and
  113. the floor, under the data (compare with the final result for better
  114. understanding). Select "Floor". A white rectangle will appear around the
  115. selected area. Then, choose a color on the left. The little box at the left
  116. of the "Floor" text should reflects the color you selected. When you are
  117. satisfied with the color you choosed, click on the close gadget to validate
  118. your entry (the one at the upper-left of the window). To see the result,
  119. selct "Render" one more time.
  120.     The final step is to save the file as "AegisDraw2000". To do so, select
  121. "Draw2000" from sub-menu "Fromat..." from menu "Project" (Amiga+4). Then,
  122. choose "Save as..." from "Project" (Amiga+A) that will pop up a file
  123. requester asking for the file name of the resulting graph. Enter the name,
  124. then press RETURN. The file should now be available for use in any
  125. compatible software.
  126.