home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / amos / srmv23.lha / Resource_Banks / Bin / Resource.doc next >
Encoding:
Text File  |  1992-09-03  |  6.8 KB  |  145 lines
  1. *************************************************************
  2. *                                  *
  3. *                SUPER RESOURCE MAKER V.2.3             *
  4. *                                  *
  5. *        By M&F Software Corporation © 1993-1994        *
  6. *                                *
  7. *************************************************************
  8.  
  9.  
  10. This docs are based on the docs included with version 2.2
  11. but have been modified to list new features.
  12.  
  13. Preface
  14.  
  15. This program will be extremely useful to those programmers
  16. who often use the resource maker of the AMOS.
  17. I used the original version for some time and I found it very
  18. frustrating. Infact I had to redefine the elements every time 
  19. I wanted to change their positions, or when developing the image,
  20. founding them not completely coincident with the icon I wished.
  21. If I enlarged a button of one pixel I had to delete the button,
  22. then redefine the box, and replace it on the new icon!!
  23. It is not a problem if you have to remake one or two elements,
  24. but it is quite boring when they are twenty or more!!
  25.  
  26. So I thought of something more efficient, and added some new 
  27. features to the original program, just to make it a little more
  28. flexible. When I started I realized that some more improvement 
  29. could be done, and so I try to give them reality.
  30.  
  31. The most difficult part of the working was not carring out my ideas
  32. but it was the integration of my own procedures in the main program.
  33. I find more difficult understanding other's programs then 
  34. writing them from the beginning, but here I have only to add some 
  35. minor features so I opted for the update.
  36. (Well, I'm not able to write and to read the right location in order 
  37. to build up a bank yet).
  38.  
  39. New features
  40.  
  41. - the request window has been enlarged so that it can contain the new
  42. buttons
  43. - the slider has been improved:
  44.   .the slider is higer so that you can see more elements on the screen
  45.  ..it is more fast in unpdating the window after an operation
  46. ...the scrolling  of the elements is faster (3 elements at once
  47.    instead of the original one at once)
  48. - now the graphic editor supports pages larger than the size of the 
  49.   screen
  50. - you can modify slightly the size and the position of the flashing
  51.   box of any of the element already existing without having to 
  52.   redifine completely the very box
  53. - you can move in a easy way the entire box when you want and where you want
  54. - and what's more important is that all this is made completely automatic
  55. - ith version 2.3 the resolution of the screen is automatically set to suit 
  56.   that of the picture. Now you can load also hires interlacedd pictures and 
  57.   the screen wil be hires interlaced as well. This has been introduced as it 
  58.   seems very stupid having to load only lowres pictures to keep the proportion
  59.   right.
  60. - Added an error handler so that if you try to load a file which is not an IFF
  61.   the program does not quit but displays an error message. 
  62. Instructions
  63.  
  64. -As I saw (and as I think many of you experienced) with the original version
  65. of the program any modification of the already saved bank was to be made by
  66. remaking everything from the beginning.
  67. Now you can spare a lot of time and pain with the new features.
  68.  
  69. -The button SIZE allows you to change the size of the flashing box.
  70. Just press SIZE and INCX,INCY,DECX,DECY to resize the box to your wishes.
  71. The changes are automatically saved. Note that the box will change its 
  72. dimensions according to the kind of the element you are modifing.
  73. So for example if you are modifing a button, a box or a horizontal line the
  74. box will enlarge itself by 8 pixels horizontally and 1 vertically; if it is
  75. a vertical line it will change size 8 pixels horizontally and 3 vertically.
  76.  
  77. -The button TRANS allows you to change the position of the flashing box.
  78. Just press TRANS and INCX,INCY,DECX,DECY to move the box of 8 pixels
  79. horizontally and 1 pixel vertically.
  80.  
  81. -You can use pages larger than the screen as the program will automatically
  82. configure itself to the size of the page you use.
  83. To scroll the pictures just move the pointer close to the border of the screen
  84. and magically the images will move!
  85. Just in the definition of the page, when you create it, use, as horizontal
  86. number, a multiple of sixteen. This is not a must but it is recommended as the 
  87. program rounds the X coordinate to the nearest mulpiple  of 16 and so, if you 
  88. use the far right side of the images, you can lost part of you icons.
  89. Well, just use multiple of sixteen or don't use the far right side of the picture.
  90.  
  91. In detail
  92.  
  93. For people who want to know how I programmed the new features I say...watch them!
  94. You are allowed to make all the changes you want if you respect the condition
  95. written below.
  96. I dont't know any bug, but I know the limitations of my program (oh, sorry, the 
  97. program I modified).
  98. One of the limitation is the rounding of the pictures to one multiple of 16.
  99. I first thought it was my fault the program did something strandge when using
  100. other numbers, but then I see it was an AMOS fault. Infact the Screen Width function
  101. rounds the size to the nearest lower multiple of 16.
  102. The scrolling is made on that number but can be changed.
  103. The value of the increment of the scrolling is held by the 'RR' variable.
  104. Change that number to make the scrolling faster or slower (increment/decrement
  105. the number).The default number is 16.
  106. Note that if you make the value too large the scroll will litterally jump from
  107. one side of the image to the opposite, that's not very...pretty to see.
  108. But it's only a matter of taste and necessities (if you have a very long picture,
  109. i.e. three/four time the width of the screen a very fast scrolling becomes important).
  110.  
  111. I'd like, if you make some more improvement on this program, that you add your
  112. features as procedures as they are more easy to modify or to be replaced by more
  113. powerful routines.
  114.  
  115. I hope my work will be useful to someone out there.
  116.  
  117.  
  118. Distribution conditions
  119.  
  120. This program may be freerly distributed to anyone anywhere on the condition that
  121. my name and the name of my corporation it's not removed from it, even if you modify
  122. it, and no profit is made by doing so.
  123.  
  124. M&F Software Corporation ©1993-1994
  125.  
  126. You can contact me by Internet. My E-Mail is
  127.  
  128. mberetta@varano.ing.unico.it
  129.  
  130. If you have some idea or program that is interesting, just sent it to me.
  131. I will gratefully receive everything that you want to send me.
  132.  
  133. Latest notes
  134.  
  135. -The version 2.2 fixes minor bug that remained from the original version of the program.
  136. The problem were when you tried to load a bank, then entered the graphic editor, and 
  137. then quit the graphic editor just to press the 'Create a new bank' button.
  138. The picture disappeared, but the elements remained in memory. So after loading the
  139. required IFF picture, and having the list empty, the flashing box still was on the 
  140. screen. If you deleted the first element (or if you defined it) the box jumped to the
  141. following element and so on. It was not a terrible bug (just it needed to press the
  142. 'Clear' button, but I managed to fix it with very little pain.
  143.  
  144.  
  145.