home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 5 / amigaformatcd05.iso / readerstuff / daniel_searle / readme.doc < prev    next >
Text File  |  1996-08-13  |  4KB  |  83 lines
  1. Readme file for 'GEOtoSBP'
  2.  
  3. This program converts GEO ASCII (VideoScape ASC) files to the vector file
  4. format used by the AB3D-II TKG editors.
  5.  
  6. This program was written in AMOS Pro by Danny Searle after finding the
  7. vector object editor for AB3D-II TKG very difficult to use!
  8.  
  9. The program will only accept GEO ASCII (VideoScape ASC) format vector files
  10. at the moment, mainly because it is the simplest vector format I could
  11. find. You can easily convert most vector formats to GEO ASCII using Pixel
  12. Pro, that includes the version given away free by Amiga Format a while
  13. back.
  14.  
  15. Before you rush off to convert all your 2,000,000 polygon super detailed
  16. alien creatures you must take note of the limitations of vector files used
  17. in AB3D-II and of the conversion process. Firstly my program only converts
  18. point position data, and nothing about polygons, lines, edges, faces, or
  19. textures. "Pah! useless!" I here you say, but there is a very good reason
  20. for this limitation, and it is the fact that faces in the AB3D-II vector
  21. editor must be defined with the edges going clockwise around its points
  22. acording to the way it is faceing. The other limitation set this time by
  23. the AB3D-II editors is that individual vector files can have a maximum of
  24. only 50 points (and 50 polygons). So say you have a designed a robot in
  25. your faviourite vector editing program, you must split it into bits. A good
  26. idea is to split bits off acording to how they will animate, for example, a
  27. robot with a head, body arms, and legs may be split into 8 separate pieces,
  28.   1 - Head
  29.   2 - Body
  30.   3 - Left arm
  31.   4 - Right arm
  32.   5 - Left upper leg
  33.   6 - Left lower leg
  34.   7 - Right upper leg
  35.   8 - Right lower leg
  36. Then load the bits into the "objed", add faces (clockwise) and wrap
  37. textures, save the files, load and join them in the "animeditor" and
  38. animate your robot! It's not as simple as that but read the AB3D-II
  39. "HOW2..." docs for more detailed instruction.
  40.  
  41. To convert an object is simple, once it is in GEO ASCII format, go to a
  42. CLI window and type in "GEOtoSBP [in file] [out file] [scale-factor]",
  43. replacing [in file] with the path and filename of your GEO ASCII object,
  44. [out file] with the path and filename of the converted file and
  45. [scale-factor] with a scale factor (see below).
  46.  
  47. A scale factor must be used because vector files in AB3D-II have large
  48. co-ordinate values with no decimal places (intiger values) and GEO ASCII
  49. files have small co-ordinate values with 8 decimal places. Their is no real
  50. guide to the value of the scale factor, but when I convert Imagine objects
  51. with Pixel Pro to GEO ASCII files, I find a value of 75 is about right.
  52.  
  53. It is a good idea to make sure your objects are all positioned correctly in
  54. your faviourite vector editing program before conversion, because it is a
  55. real pain to move a number of objects accurately with the "animeditor" used
  56. in AB3D-II, you have been warned!
  57.  
  58. DISCLAIMER:
  59.  
  60. Although I can asure you that the only data altered by running the program
  61. will be the output file you specify, I have to protect myself, so...
  62. You use GEOtoSBP at your own risk!
  63. I can not be held resposerble for loss of data, or any other harm my
  64. program may inflict on defenceless vector objects!
  65.  
  66. This program is GIFTWARE, so send all generous donations, new cars,
  67. computer equipment, T.V.'s, HI-FI's, VCR's, and coments etc.. to the
  68. following address,
  69.  
  70.     Danny Searle
  71.     Talbot Cottage
  72.     Gerald Road
  73.     BIRKENHEAD
  74.     Merseyside
  75.     L43 2LA
  76.  
  77. I hope you find this program as useful as I have,
  78.  
  79.         _
  80.      _ //  Long live the Amiga!
  81.      \X/   Down with the PeeCee!
  82.  
  83.