home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / utilities / demos / x-dve2 / readme.doc < prev    next >
Encoding:
Text File  |  1995-10-03  |  14.7 KB  |  479 lines
  1. ********************************************************************
  2.  
  3.        ClassX - Via Francesca 463 - I 56030 Montecalvoli (PI)
  4.        ------------------------------------------------------
  5.                       Tel+Fax +39 587 749206
  6.  
  7.           X-DVE demo English documentation (c) ClassX 1995
  8.           Chapters are marked with the "*)" symbol.
  9.  
  10. ********************************************************************
  11.  
  12.  
  13. *) About this demo disk:
  14.  
  15.         This disk contains the DEMO version of X-DVE2.
  16.      ---------------------------------------------------
  17.      Commercial unauthorized use is strictly prohibited.
  18.  
  19. You cannot include this demo and related files (such as cliparts etc.)
  20. in commercial products without written permission that can be obtained
  21. from ClassX.
  22.  
  23.  
  24. *) Important:
  25.  
  26.     The following chapters refer to X-DVE1.12, but they're also good
  27.     for a preliminar test of new version.
  28.     If you want to know more about the new features of X-DVE2, you'll
  29.     find more information at the end of this document.
  30.  
  31. ********************************************************************
  32.  
  33.  
  34. *) About X-DVE v1.12
  35.  
  36. X-DVE is an integrated package, designed to edit, render and play animations.
  37.  
  38. It can handle 3 kinds of object:
  39. -Texts (max 80 characters / amigafont / colorfont / compugraphic / any style 
  40. / outline / background).
  41. -Brushes (256 col max / iff / any size)
  42. -AnimBrushes (256 col max / iff-anbr / any size)
  43.  
  44.  
  45. The available resolutions are:
  46.  
  47. - ORIGINAL CHIPSET
  48.  
  49. NORMAL
  50. 320 x 512 x 32 col
  51. 640 x 512 x 16 col
  52. 1028 x 512 x 16 col
  53.  
  54. OVERSCAN
  55. 384 x 566 x 32 col
  56. 768 x 566 x 16 col
  57. 1472 x 566 x 16 col
  58.  
  59.  
  60. - AGA CHIPSET
  61.  
  62. NORMAL
  63. 320 x 512 x 256 col
  64. 640 x 512 x 256 col
  65. 1028 x 512 x 256 col
  66.  
  67. OVERSCAN
  68. 384 x 566 x 256 col
  69. 768 x 566 x 256 col
  70. 1472 x 566 x 256 col
  71.  
  72.  
  73. X-DVE can apply the builtin effects (perspectives, slides and winds) to any 
  74. kind of object, without limitations.
  75. It also provides a fast colour remapping and transparencies masking on user
  76. demand.
  77. An extra feature, allows to render every object using a customizable light
  78. source, giving the animations a professional, solid feeling.
  79. The approach used to create animations is very simple and it's based on a
  80. frames-storyboard concept.
  81. Every object has its own life, fully independent from the others.
  82. This means that the objects are completely asyncrhonous and can enter or exit
  83. the screen in a parallel way (simply, they can not only be sequential).
  84. The "life" of the object is handled by X-DVE as an IN-PAUSE-OUT phase
  85. sequence.
  86. Each phase-lenght can be programmed in frames, so IN and OUT effects will be
  87. faster or smoother, according to the number of frames of the relative phases.
  88. Animations can be rendered on disk with separate IFF frames, or in memory,
  89. directly in XFA (eXtra Fast Animation) proprietary format.
  90. X-DVE comes complete with the XFA-Util (Redistributable PD player-converter)
  91. which gives also a complete AREXX interface and DiskAnim facilities.
  92.  
  93.  
  94. *) Coding
  95.  
  96. X-DVE has been developed under the constant control of Commodore's 
  97. Enforcer, in a totally system friendly way and it is written using the 
  98. conjunction of three languages:
  99.  
  100. -Blitz II of Acid for the main code, the user interface, the 
  101. object handling and the support routines.
  102.  
  103. -Sas C for the mathematical calculations of the effects, for processor
  104. optimized 3D mapping and all graphics functions.
  105.  
  106. -680x0 Assembler for the eXtra Fast Animation code and other speed-
  107. related functions.
  108.  
  109. One of our aims, is to be as much system friendly as we can, and we 
  110. are sure that X-DVE will never create any kind of problem on any 2.0+ 
  111. Amiga machine.
  112. Anyway X-DVE will attempt to trap all undesirable Low-Memory and Fatal 
  113. errors which could happen in a MultiTasking environment.
  114. If such errors happen, X-DVE will attempt to release all allocated 
  115. resources and save the current script in "T:X-DVE_Crash.script".
  116.  
  117.  
  118. *) Limitations
  119.  
  120. X-DVE has been coded in a flexible and expandable way.
  121. However, we have limited the maximum number of objects to 100 and the 
  122. maximim frames to 10.000 (200 secs of 50 fps animation).
  123. If anyone thinks these limits are too tight, please let us know.
  124.  
  125.  
  126. *) System requirements
  127.  
  128. Any Amiga with OS 2.0+ and at least 2Mb ram.
  129. Suggested: 4Mb or more Fast ram + Hard disk.
  130. Owners of A4000 or Math Coprocessors can obtain dramatic speed increases. 
  131.  
  132.  
  133. *) Limitations of the demo version
  134.  
  135. X-DVE demo is nearly complete and you can test any feature without limitations.
  136. Of course there are some little differencies between this demo and the
  137. commercial version.
  138.  
  139. The demo version is
  140. - unable to save X-DVE scripts;
  141. - unable to load XFA animations;
  142. - unable to save XFA animations;
  143. - unable to render iff frames;
  144. - unable to handle more than 150 animation frames;
  145.   (commercial version handles upto 10000 frames)
  146.  
  147. The demo version lacks of
  148. - the Arexx/intuition XFA player (XFA_Util);
  149. - clipart and demo scripts included in the commercial version;
  150. - the user's manual
  151.  
  152.  
  153. *) How to start the demo
  154.  
  155. This demo can be used directly from disk or copied to your HD, dragging the
  156. drawer called "X-DVE_DEMO" into any partition.
  157. The first thing to do, before starting X-DVE_DEMO is to doubleclick the right
  158. "-> LIB" icon, according to your processor's version (you can get your
  159. processor version with the "CPU" shell command).
  160.  
  161.  
  162. - If you got a plain 68000 you have to doubleclick "68000" icon;
  163. - If you got a 68020/68030/68040LC and no FPU you have to doubleclick "68020"
  164.   icon;
  165. - If you got a 68020/68030 and a FPU you have to doubleclick "68030" icon;
  166. - If you got a full 68040/68060 you have to doubleclick "68040" icon;
  167.  
  168. This operation will execute a shell script to assign the right xfa.library
  169. version (Warning: if you choose the wrong processor version, X-DVE may either
  170. crash or appear very slow during rendering).
  171. Now you can successfully run X-DVE_DEMO and begin to see what is capable to do.
  172. When you've finished with the demo, we suggest you to doubleclick the
  173. "UnAssign" icon, in order to eliminate the previous assignments.
  174.  
  175.  
  176. *) The Interface
  177.  
  178. The editor is divided into several zones:
  179.  
  180. -The Object list
  181. It is designed to display every object's name, the IN and OUT effect 
  182. icons and the relative IN, OUT and PAUSE frames.
  183. Double-Clicking on the names colummn, will bring up the object 
  184. requester (each kind of object has its kind of requester).
  185. Clicking on the Effects column, will bring up the Setup-Object 
  186. requester.
  187.  
  188.  
  189. -The Object box
  190. --Cycle Text/Brush/AnimBrush
  191. This button allows the selection of the kind of the object to be added 
  192. at the list.
  193.  
  194. --Button ADD
  195. This button opens an object requester, just to add an object to the 
  196. list.
  197.  
  198. --Button MOD
  199. This button opens the object requester, just to modify the currently 
  200. selected object.
  201.  
  202. --Button DEL
  203. This button allows to delete one or more objects from the list
  204.  
  205. --Button REP
  206. This button allows to replicate an object and its settings.
  207.  
  208. This is useful to make lists of equally-spaced objects in a 
  209. mouseclick.
  210.  
  211. --Button "Arrow-Up"
  212. This button shifts up the current object in the list (render 
  213. priority).
  214.  
  215. --Button "Arrow-Down"
  216. This button shifts down the current object in the list (render 
  217. priority).
  218.  
  219.  
  220. -The Project box
  221.  
  222. --Button INF
  223. This button displays an informative list-box.
  224.  
  225. --Button PRF
  226. This button allows to setup the editor's palette and the status of the 
  227. workbench.
  228.  
  229. --Button NEW
  230. This button allows to start a new project or setup the currently used 
  231. render-screen.
  232.  
  233.  
  234. -The Script box
  235.  
  236. --Button LOAD
  237. This button allows to load or join scripts in various ways.
  238.  
  239. --Button SAVE
  240. This button allows to save the current script
  241.  
  242. --Icon "SUN" (a sun-shaped icon)
  243. This button brings up the Light source requester, by which users can 
  244. customize its colour and 3D position.
  245.  
  246. --Icon "TIMER" (a chronograph-shaped icon)
  247. This button brings up the frames-storyboad requester, so that the 
  248. object phases can be graphically controlled and modified in a more 
  249. intuitive manner.
  250.  
  251.  
  252. -The Palette box
  253.  
  254. --Button LOAD
  255. This button allows the loading of the current work-palette from a 
  256. standard IFF file.
  257.  
  258. --Button EDIT
  259. This button allows the editing of the current work-palete through the 
  260. builtin palette requester.
  261.  
  262.  
  263. -The Anim box
  264.  
  265. --Button PLAY
  266. This button brings up the requester used to setup and play XFA 
  267. animations.
  268.  
  269. --Button DSK
  270. This button brings up the requester used to setup paths and files for 
  271. disk-based rendering.
  272.  
  273. --Button MEM
  274. This button brings up the render-mem requester and allows to control 
  275. various rendering functions.
  276.  
  277.  
  278. -The Setup-Object requester
  279.  
  280. This requester allows to define the entire life of the object.
  281. First of all the fields Start Frame, In, Pause, Out, must be filled 
  282. with reasonable values (es: Start=0 In=50 Pause=50 Out=50 will setup 
  283. the object to enter at the start of the animation with a 50 frames In 
  284. efx, stay in pause for 1 sec end exit with a 50 frames Out efx).
  285. If the user wants to render this object with the light source, he 
  286. simply have to enable the "Light" checkbox.
  287. The PAUSE button allows to setup the position where the object must 
  288. reach during the pause phase.
  289. The positioning can be made via mouse, or by filling the X and Y 
  290. fields in the PAUSE box (they represent the upper-left corner in 
  291. pixels). 
  292. Clicking on the "Set" button (in IN and OUT boxes) , will pop up a 
  293. small requester by which users can select the kind of the effect (3D - 
  294. SLIDE - WIND).
  295.  
  296. For every kind of effect, X-DVE has a requester:
  297.  
  298. -3D
  299. There is a list of ready-made settings, but the user can setup his own 
  300. IN (or OUT) position and rotations.
  301.  
  302. -SLIDE
  303. This requester presents 24 different icons, each one associated with a 
  304. slide effect.
  305.  
  306. -WIND
  307. There is a list of ready-made settings, but the user can setup his own 
  308. parameters just to create new effects (the details are in the user's 
  309. manual).
  310.  
  311. The "Ramp" checkbox allows to give 3D and SLIDE effects an extra 
  312. automatic acceleration (OUT) or deceleration (IN) feature.
  313.  
  314. The COPY and PASTE buttons can be used to copy an effect to the 
  315. internal buffer and paste it to an object.
  316. The PREVIEW button will show the various effects of the current 
  317. object, following the user's settings.
  318. During the preview, the 3D efx and the Wind efx are traced in a 
  319. stylized (usually solid blocks) way.
  320.  
  321.  
  322. *) Small Tutorial
  323.  
  324. -Start X-DVE and click Project/NEW.
  325. -Select a medium 640x512x8 colours resolution.
  326. -Click Palette/EDIT button and edit your work-palette.
  327. -Click Object/ADD and select a font.
  328. -Write a string in the appropriate field.
  329. -Select the desired colours and click "SHOW".
  330. -If it's OK, confirm the object.
  331. -Click on the column right to the object name (this will bring up the 
  332. Setup-Object requester).
  333. -Fill in the frame fields (start=0 In=50 Pause=50 Out=50).
  334. -Choose a pause position with the "PAUSE" button.
  335. -Select your preferred In effect.
  336. -Select your preferred Out effect.
  337. -Click "Preview" and you'll see an approximate view of the effects. 
  338. (during the preview, left mouse to pause and right mouse to stop).
  339. -Confirm the settings with "OK" (in the Setup-Object requester).
  340. -Click Anim/MEM button.
  341. -Select 32Bit I compression and click the RENDER button
  342. -When X-DVE has finished the rendering, you can see the animation by 
  343. clicking on the VIEW button.
  344. -Now exit the RENDER requester and click Anim/PLAY button.
  345. -You have some choices: play mode/LOOP (on) means that the animation 
  346. will cycle indefinitely (until right mouse button is clicked).
  347. pause/AUTO (on) means that the played will search all the pause points 
  348. in the animation and will stay on the frame until the user clicks the 
  349. left mouse button.
  350.  
  351.  
  352. *) The demo scripts
  353.  
  354. This demo version includes some ready-made demonstration scripts:
  355.  
  356. demo_animbrush.script
  357. It shows how animbrushes can be included in any animation.
  358.  
  359. demo_diskin.script
  360. A nice way to show the animation/titling capabilities of X-DVE.
  361.  
  362. demo_intro.script
  363. A simple intro with WIND/3D effects.
  364.  
  365. demo_light.script
  366. The use of lightsource to render an object.
  367.  
  368. demo_rep.script
  369. How to use the "REP" facility to build titles with a mouseclick.
  370.  
  371. demo_tri.script
  372. A nice animation to introduce the logo of a "dummy" firm.
  373.  
  374. Just load one of these scripts and render it through Anim/MEM button.
  375. They all MUST be rendered in 16BitI or 32BitI (suggested) modes.
  376. Remember that 16Bit and 32Bit modes are reserved for XFA-Util's DiskPlay
  377. facility, as they are not optimized for direct play (and use some extra
  378. memory).
  379. Animations can be played with or without the LOOP/AUTOPAUSE options and 
  380. we suggest you to try both modes.
  381.  
  382.  
  383. *) Where to buy X-DVE or get more information
  384.  
  385. - Italy:
  386.  
  387.   ClassX Development
  388.   Via Francesca 463
  389.   I - 56030 Montecalvoli (PI)
  390.   tel + 39 587 749206
  391.   fax + 32 578 749206
  392.  
  393. -Germany:
  394.  
  395.   Casablanca Multimedia GmbH
  396.   Wiemelhauser Straße 247 a
  397.   D - 44799 Bochum
  398.   tel +49 234 72035
  399.   fax +49 234 72060
  400.  
  401. - England:
  402.  
  403.   Looking for a good distributor.
  404.  
  405.  
  406.  
  407. ****************************************************************************
  408.  
  409.      #  #  #         #     # ####### #     #  #####          #  #  #
  410.       # # #          ##    # #       #     # #     #          # # # 
  411.        ###           # #   # #       #     # #                 ###  
  412.      #######         #  #  # #####   #     #  #####          #######
  413.        ###           #   # # #       #  #  #       #           ###  
  414.       # # #          #    ## #       # # # # #     #          # # # 
  415.      #  #  #         #     # ####### ##   ##  #####          #  #  #
  416.  
  417. ****************************************************************************
  418.  
  419.  
  420. *) X-DVE2
  421.  
  422.     Finally X-DVE2 is ready!
  423.     New features ?
  424.  
  425.     -    Automatic support of OS3.xx picture DataTypes
  426.  
  427.     -    New "MultiBrush" object, to import image sequencies from disk
  428.  
  429.     -    Multiline Text objects with programmable spacing and centering
  430.  
  431.     -    Brush Object can now load the first frame of any IFF-Anim
  432.  
  433.     -    Antialising
  434.  
  435.     -    New attributes for every object: Bevel, 3D, Shadow, Background, Solid,
  436.         Outline (no limitations: attributes can be programmed in colours,
  437.         thickness, direction)
  438.     
  439.     -    Programmable resolution, from 320x200 to 1472x592 pixel
  440.  
  441.     -    Better IFF rendering (render the whole script or a single frame)    
  442.  
  443.     -    10 New Slide effects (with the stunning "Melt" and "Carpet")
  444.     
  445.     -    New "Warp" family with 40 effects (ready to use 3D sequencies)
  446.  
  447.     -    Lots of new Wind effects (3 new base formulas)
  448.  
  449.     -    Wind effects now supports the "Ramp" mode
  450.  
  451.     -    Single object or full script frame-by-frame preview with
  452.         VCR-like controls
  453.  
  454.     -    Support of continuous-loop animations (for logos, etc.)
  455.  
  456.     -    Render speed doubled for 3D, Warp and Lightsourced effects
  457.     
  458.     -    1/16 of Degree precision for 3D rotations
  459.  
  460.     -    Compression speed highly improved
  461.  
  462.     -    Faster play speed under OS2.xx
  463.  
  464.     -    Restylized user interface, even more intuitive and flexible
  465.  
  466.  
  467.     More (not included in the demo version) ?
  468.  
  469.     -    New XFA-Util2 with complete Intuition/ARexx interface, for easy
  470.         XFA handling.
  471.     
  472.     -    New XFAPlay with complete CLI/ARexx/Intuition interface
  473.  
  474.     -    ClipArt, Brushes, AnimBrushes, Fonts and ready X-DVE scripts.
  475.  
  476.  
  477. ****************************************************************************
  478. ****************************************************************************
  479. <EOF>