home *** CD-ROM | disk | FTP | other *** search
/ BUG 6 / BUGCD1997_09.BIN / MULMEDIA / MAINACT / SETUP.EXE / MADOCU.HLP (.txt) < prev    next >
OS/2 Help File  |  1997-04-07  |  40KB  |  1,264 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Installation ΓòÉΓòÉΓòÉ
  3.  
  4. MainActor needs some additional software packages to run correctly:
  5.  
  6. o   Software required by the OS/2 version.
  7.  
  8. o   Software required by the Windows version.
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 1.1. OS/2 Installation ΓòÉΓòÉΓòÉ
  12.  
  13. This archive contains versions of TIMER0.SYS and DIVE. They are not installed 
  14. automatically and will have to be installed by hand.
  15.  
  16. Please note that these files are copyrighted by IBM and are included in the 
  17. MainActor archive by agreement of IBM Germany.
  18.  
  19.  
  20. ΓòÉΓòÉΓòÉ 1.1.1. Installing DIVE ΓòÉΓòÉΓòÉ
  21.  
  22. DIVE is used by MainActor for displaying video. The archive dive.zip contains 
  23. the DIVE related files. Please copy the *.LUT files into the \mmos2 directory 
  24. and the dive.dll into the \mmos2\dll directory. 
  25.  
  26. Make sure that you do not have a newer version installed, Warp v+4 has DIVE 
  27. already installed and you dont need to replace it.
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 1.1.2. Installing TIMER0.SYS ΓòÉΓòÉΓòÉ
  31.  
  32. TIMER0.SYS is needed by MainActor for syncing audio and video streams. If 
  33. TIMER0.SYS is not installed, video and audio streams will not be synced correctly.
  34.  
  35. To install TIMER0.SYS, extract the files from the timer0.zip archive and 
  36. install them with the device driver installer (DDINSTAL) utility. Make sure to 
  37. remove the readonly attributes of the \os2\boot\clock*.sys files first with: 
  38. attrib -r \os2\boot\clock*.sys.
  39.  
  40. Make sure that you do not have a newer version installed, Warp v4 has 
  41. TIMER0.SYS already installed and you dont need to replace it.
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 1.2. Windows Installation ΓòÉΓòÉΓòÉ
  45.  
  46. MainActor needs DirectX, especially DirectDraw and DirectSound, for playback.
  47.  
  48. If you are running Windows NT 4.0 or Windows95 Release 2, DirectX is already 
  49. installed, otherwise download the latest DirectX runtime release from the 
  50. Microsoft Homepage at http://www.microsoft.com.
  51.  
  52. Also, your graphics card manufacturer should have DirectX enabled drivers available.
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  56.  
  57. MainActor is a multimedia processing package. It allows you to load, edit, play 
  58. and save / convert animations, pictures and sounds of various formats and of 
  59. any size.
  60.  
  61. MainActor features animation processing and editing functions and is the most 
  62. powerful part of this package.
  63.  
  64. MainView is the external player of MainActor. It is useful when you only want 
  65. to play an animation and don't want to load MainActor just for that. MainView 
  66. can also be associated to other programs.
  67.  
  68. Both MainActor and MainView use the same modules for processing the various 
  69. formats and are therefore quite flexible and expandeable.
  70.  
  71. A sequencer add-on for MainActor is in work.
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 2.1. Available Platforms ΓòÉΓòÉΓòÉ
  75.  
  76. MainActor is currently available for Windows 95 / NT 4.0 and OS/2.
  77.  
  78. We hope to support other platforms as well one day. All systems for which IBM's 
  79. excellent VisualAge C++ development platform is available, is a possible and 
  80. easy target platform, like AIX, Solaris, HP-Unix etc.
  81.  
  82. MainActor always uses the fastest video and audio playback system available on 
  83. each platform, like DIVE under OS/2 and DirectX under Windows 95 / NT 4.0.
  84.  
  85. If you decide to register MainActor, you automatically get a license for all 
  86. platforms MainActor is or will be running on.
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 2.2. Additional Products ΓòÉΓòÉΓòÉ
  90.  
  91. Additional animation related products : 
  92.  
  93. o   mainCODEC/2 for OS/2
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 2.2.1. mainCODEC/2 ΓòÉΓòÉΓòÉ
  97.  
  98. mainCODEC/2 is part of MainActor but is distributed as a separate archive.
  99.  
  100. It contains a subset of the MainActor modules as MMPM/2 codecs. These codecs 
  101. allow the supported formats to be used within the native OS/2 multimedia 
  102. system, for example inside the player or VideoIN.
  103.  
  104. mainCODEC/2 can be downloaded from our Web Pages (http://www.mainconcept.de) 
  105. and our BBS (+49-(0)241-4090446).
  106.  
  107. Also, it should be available per ftp at hobbes.nmsu.edu.
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 3. MainActor ΓòÉΓòÉΓòÉ
  111.  
  112. MainActor is the animation processing part of the MainActor package.
  113.  
  114. You can load, edit and play/show every animation, picture and sound format for 
  115. which MainActor has the proper loader module. You can save any animation, 
  116. picture and sound format for which MainActor has the proper saver module.
  117.  
  118. The currently supplied modules are listed by selecting the Loader Modules... 
  119. and Saver Modules... items of the Help menu. For a list of feature of these 
  120. modules, see The Modules.
  121.  
  122. MainActor features detailed online help. For additional information, please 
  123. have a look at the User Guide.
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 3.1. Start Options ΓòÉΓòÉΓòÉ
  127.  
  128. You can pass MainActor the names of projects to load.
  129.  
  130. For example mactr.exe gfx\mov\test.mov pix\art.pcx would load the animation 
  131. test.mov and the picture art.pcx right after MainActor has started.
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 3.2. FAQ ΓòÉΓòÉΓòÉ
  135.  
  136. The frequently asked questions document for MainActor can be requested by 
  137. sending email to mafaq@mainconcept.de.
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 3.3. User Guide ΓòÉΓòÉΓòÉ
  141.  
  142. This guide explains the functionality of MainActor as well as the vocabulary 
  143. used by the online help and this documentation.
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 3.3.1. Working with Projects ΓòÉΓòÉΓòÉ
  147.  
  148. A project is either an animation, one or several pictures, a sound or an video 
  149. stream. An animation or sound is always a project of its own, the name of the 
  150. project will be the name of the animation/sound.
  151.  
  152. Pictures are handled differently. All pictures of a given format are grouped 
  153. together in one project, the name of the project will be the name of the format 
  154. of the pictures, like IFF or JPEG. This way you can group any number of 
  155. pictures together and convert them into an animation.
  156.  
  157. Video streams are used for MPEG. They have an unknown quantity of frames.
  158.  
  159. Every project has its own pop-up menu which is identical to the Project menu. 
  160. If you press the right mouse button in the containers whitespace, the File menu 
  161. will be shown as a pop-up menu.
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 3.3.1.1. Loading Projects ΓòÉΓòÉΓòÉ
  165.  
  166. There are several ways how to load a project.
  167.  
  168. Under OS/2 we included our own file requester with MainActor, this way you can 
  169. select any number of files very easily, for example load a whole directory or a 
  170. range of files. If you choose to use the system file requester you will have to 
  171. select any single file per hand.
  172.  
  173. Again under OS/2, a different way is to drag and drop the file icons over the 
  174. project list. This way you can also load any number of files.
  175.  
  176. However, under Windows we simply use the system file requester, as it is 
  177. powerful enough to simply select any number of files directly.
  178.  
  179.  
  180. ΓòÉΓòÉΓòÉ 3.3.1.2. Playing Projects ΓòÉΓòÉΓòÉ
  181.  
  182. Simply double click on the project or select the Play Project... item of the 
  183. Project menu.
  184.  
  185. For additional help for the functionality available during playback, consult 
  186. the online help of the display window.
  187.  
  188. Under Windows, you also have full screen functionality, for a description of 
  189. the possible key commands please have a look at the online help of the display 
  190. window (simply press F1 in window playback mode).
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 3.3.1.3. Removing Projects ΓòÉΓòÉΓòÉ
  194.  
  195. Use the Remove Project item of the Project menu if you want to remove a 
  196. specific project. Also, if you want to remove all currently loaded frames, you 
  197. can use the Remove All item of the File menu.
  198.  
  199. Under OS/2 you can aslo drag and drop the project icon over a shredder object.
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 3.3.2. Working with Frames ΓòÉΓòÉΓòÉ
  203.  
  204. The frames of the current project are displayed in the frame list. A frame is 
  205. an image which is either part of an animation or a picture in a picture list.
  206.  
  207. If the frame is part of a picture list, the frames can be sorted, single or 
  208. various pictures can be removed or their locations can be changed by drag and 
  209. drop. This is not possible for animation frames, as these are mostly dependent 
  210. on a each other in a linear fashion.
  211.  
  212. The icons of frames in an animation indicate if the frame is a key frame or a 
  213. delta frame.
  214.  
  215. Frames have the Frames menu available as a pop-up menu.
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 3.3.2.1. Key/Delta Frames ΓòÉΓòÉΓòÉ
  219.  
  220. Frames inside an animation can be stand alone frames, these frames do not need 
  221. another frame to decompress correctly. These frames are called key frames.
  222.  
  223. Delta frames need other frames (mostly the previous frames) to decompress. This 
  224. is done to reduce the size of the frames inside an animation, as only the 
  225. differences from the previous to the next frame have to be processed.
  226.  
  227. First generation animation formats (like FLI, FLC, IFF-Anim) mostly have a key 
  228. frame as the first frame and all other frames are delta frames. Second 
  229. generation animation formats, like AVI and Quicktime mostly have key frames 
  230. every few seconds. This enables the playback software to quickly find a 
  231. specific position inside the stream and to skip frames when playback gets too slow.
  232.  
  233. Inside MainActor, gray frame icons in the frame list indicate key frames, 
  234. transparent icons indicate delta frames.
  235.  
  236.  
  237. ΓòÉΓòÉΓòÉ 3.3.2.2. Selecting Frames ΓòÉΓòÉΓòÉ
  238.  
  239. Frames can be simply selected with the mouse or by selecting one of the Select 
  240. or Deselect sub menu items of the Edit menu.
  241.  
  242. The items of the Frames menu often work on all selected frames, like the items 
  243. for removing and saving.
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 3.3.2.3. Showing Frames ΓòÉΓòÉΓòÉ
  247.  
  248. A frame can be displayed by simply double clicking on it or by selecting the 
  249. Show Frames... item of the Frames menu.
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 3.3.2.4. Sorting Frames ΓòÉΓòÉΓòÉ
  253.  
  254. Frames can be sorted by hand or automatically by their size or filename.
  255.  
  256. To sort the frames by hand, simply drag and drop the frames to their new 
  257. location inside the frame list (OS/2 only).
  258.  
  259. The sub menu items of the Sort Frames item of the Frames menu sort the frames 
  260. by their size or filename.
  261.  
  262. Sorting frames is only possible if the frames are part of a picture list.
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 3.3.2.5. Removing Frames ΓòÉΓòÉΓòÉ
  266.  
  267. You can remove the currently selected frames by selecting the Remove Frames 
  268. item of the Frames menu or by dragging the frames to a shredder object (OS/2 only).
  269.  
  270. Removing frames is only possible if the frames are part of a picture list.
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 3.3.3. Working with Timecodes ΓòÉΓòÉΓòÉ
  274.  
  275. Every frame of an animation or picture list has a timecode associated to it. 
  276. The timecode controls the time the frame is shown during playback. MainActor 
  277. displays the timecode in milliseconds, therefore a timecode of 1000 would mean 
  278. that the frame would be displayed exactly one second.
  279.  
  280. Projects can have two different kinds of timecodes: Global or local timecodes.
  281.  
  282. Pictures have always a default local timecode of 1 second.
  283.  
  284. Converting projects with different timecode methods can be tricky, have a look 
  285. at the Timecode Translation.
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 3.3.3.1. Global Timecodes ΓòÉΓòÉΓòÉ
  289.  
  290. Global timecodes only support one timecode per animation, meaning that every 
  291. frame has to have the same timecode.
  292.  
  293. These animation formats, for example AVI/FLI/FLC, often insert additional 
  294. frames into the animation for timing purposes. These frame are dummy frames and 
  295. have a size of zero, they just have the purpose to slow down playback for the 
  296. last 'real' frame.
  297.  
  298. You can set the global timecode of an animation by selecting the Global 
  299. Timecode... item of the Project menu.
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 3.3.3.2. Local Timecodes ΓòÉΓòÉΓòÉ
  303.  
  304. Local timecodes can be set for every frame of an animation and allow a 
  305. different timecode for each frame. Local timecodes can be found in Quicktime 
  306. and IFF-AnimX animation formats. You can however not set the local timecodes of 
  307. Quicktime animations inside MainActor.
  308.  
  309. Additionally, MainActor treats picture lists as if they would have a local 
  310. timecode feature. You can therefore set the timecodes of pictures. This is 
  311. useful for quickly making a slide show as a preview of an animation or to set 
  312. the timecodes prior to saving, so that the resulting animation automatically 
  313. has the right timecodes associated to it.
  314.  
  315. You can change the local timecodes of the currently selected frame by choosing 
  316. the Local Timecodes... item of the Frames menu.
  317.  
  318.  
  319. ΓòÉΓòÉΓòÉ 3.3.4. Working with Audio ΓòÉΓòÉΓòÉ
  320.  
  321. MainActor is able to save out sound from animations directly into a sound saver 
  322. module, currently only the WAV saver.
  323.  
  324. You are also able to load WAV files, but you can currently only play them or 
  325. re-save them as WAV. The sound modules will come in handy when the sequencer is 
  326. ready to be included in MainActor as you can use them to import audio data into 
  327. the sequencer.
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 3.3.5. Notes on Saving ΓòÉΓòÉΓòÉ
  331.  
  332. Saving new pictures or animations is quite easy, you can save all frames or 
  333. just the selected frames of the frame list to the new format.
  334.  
  335. When saving pictures, MainActor will automatically enumerate the new pictures, 
  336. like "test0003.bmp". The start index can be set within MainActor.
  337.  
  338. There are however some things you need to know, like how MainActor deals with 
  339. Timecode Translations or handles 8Bit Palettes.
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 3.3.5.1. 8Bit Palettes ΓòÉΓòÉΓòÉ
  343.  
  344. When you save a new 8Bit (256 color) animation, MainActor will use a customized 
  345. palette for the whole animation. That means that MainActor will not save a new 
  346. palette once the source palette changes but tries to create an optimized 
  347. palette for the new animation which will then be used for all frames.
  348.  
  349. We think this approach results in smoother animations, especially on platforms 
  350. which write directly to the color space, like low level DOS, Amiga and MAC viewers.
  351.  
  352. The generation of the animation is, however, slower, as MainActor has to 
  353. process all frames to generate the source palette.
  354.  
  355. If you want to convert an video stream (MPEG) to an 8bit image or animation 
  356. format, MainActor uses a default 8bit palette. This is due to the fact that 
  357. MainActor doesnt know the size of the stream and decoding the whole stream to 
  358. find out the right palette could take lots of time. However, as you can load 
  359. another palette inside the Palette Editor, you can load in any other custom 
  360. palette you would like to use for converting.
  361.  
  362. It is possible to edit the palette prior to saving.
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ 3.3.5.2. Editing 8bit Palettes ΓòÉΓòÉΓòÉ
  366.  
  367. You can edit 8bit palettes prior to saving with the palette editor. Useful if 
  368. you want to optimize the palette, but as MainActor changes the color indices 
  369. while optimizing the palette it becomes a must when you want to set a specific 
  370. color index as color 0, for example if you want to save the color as 
  371. transparent with the GIF saver.
  372.  
  373. With the color editor you always have full control over the palettes you save 
  374. in your 8bit animations or pictures.
  375.  
  376. The palette editor is able to load/save your palettes, this way you can load in 
  377. any custom palette you created with other programs (or MainActor) for saving.
  378.  
  379.  
  380. ΓòÉΓòÉΓòÉ 3.3.5.3. Timecode Translation ΓòÉΓòÉΓòÉ
  381.  
  382. There can be some problems while converting local timecode animations to global 
  383. timecode animation formats.
  384.  
  385. Converting global timecode animation formats to local timecode animation 
  386. formats is easy, because MainActor can set every local timecode to the global 
  387. timecode of the source project.
  388.  
  389. This does not work the other way round, as you can set the global timecode of 
  390. the animation to only one of the local timecodes of the source project. 
  391. MainActor tries to calculate the best global timecode for the new project and 
  392. inserts dummy frames behind frames which have higher timecodes than the new 
  393. global one.
  394.  
  395. This all sounds a little complicated but we hope MainActor does the job without 
  396. you even noticing it.
  397.  
  398. If you are not satisfied with the timing of a certain animation, you can always 
  399. split it up into pictures, load them as a picture lists and can set the 
  400. timecodes of the pictures yourself. If you want to add dummy frames in the 
  401. resulting animation, simply add the same picture various times into the picture 
  402. list. Of course, a later version of MainActor will have a sequencer which will 
  403. make this kind of work very easy indeed.
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ 4. MainView ΓòÉΓòÉΓòÉ
  407.  
  408. MainView is the player only part of MainActor. Useful if you just want to play 
  409. an animation or want to run an animation from within another program.
  410.  
  411. MainView can play every format for which MainActor has the proper loader 
  412. module. Saving is not supported from within MainView.
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 4.1. Start Options ΓòÉΓòÉΓòÉ
  416.  
  417. MainView features different options for the different platforms : 
  418.  
  419. o   Start Options for the OS/2 version.
  420.  
  421. o   Start Options for the Windows version.
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 4.1.1. OS/2 Start Options ΓòÉΓòÉΓòÉ
  425.  
  426. Starting MainView by clicking on its icon opens a file requester. Otherwise you 
  427. can pass the name on the command line.
  428.  
  429. Note that you can also drop the icon of the animation or picture on the 
  430. MainView icon.
  431.  
  432. The syntax for MainView is: mainview.exe [options] filename.
  433.  
  434. If you do not pass any options on the command line, MainView will use the 
  435. global settings of MainActor.
  436.  
  437. MainView supports the following options in this release:
  438.  
  439.            -(c|cache)
  440.            Cache Data. This option will load all data of the animation into a 
  441.            ram cache before playing. This will speed up animation playback. If 
  442.            not enough free ram is available, MainView will free the already 
  443.            allocated memory and play directly from harddisk/cdrom. This option 
  444.            is off by default.
  445.  
  446. -(v|volume) number
  447.            Set the sound volume, the range for the number is 0-100. Default is 80.
  448.  
  449. -(tbl|toolbarlocation) location
  450.            Sets the initial location of the control toolbar. Location can be 
  451.            one of the following strings: top, bottom, left, right, floating and hidden.
  452.  
  453.            -(hw|hidewindow)
  454.            Hide the load window, the window which displays the progress of the 
  455.            loading process. The window will not be shown. This option is off by default.
  456.  
  457.            -(das|disableautostart)
  458.            This option will stop MainView to start animations automatically.
  459.  
  460.            -(cfr|customfilerequester)
  461.            Use the custom file requester instead of the system file requester. 
  462.            This option is off by default.
  463.  
  464. -(r|repeat) number
  465.            The number indicates how many times the project shall be repeated 
  466.            while playing. Default is 1.
  467.  
  468. Example: mainview -volume 80 -tbl bottom dino.mov would play the dino.mov 
  469. animation with a sound volume of 80 and the toolbar would be located at the 
  470. bottom of the window.
  471.  
  472.  
  473. ΓòÉΓòÉΓòÉ 4.1.2. Windows Start Options ΓòÉΓòÉΓòÉ
  474.  
  475. Starting MainView by clicking on its icon opens a file requester. Otherwise you 
  476. can pass the name on the command line.
  477.  
  478. The syntax for MainView is: mainview.exe [options] filename.
  479.  
  480. If you do not pass any options on the command line, MainView will use the 
  481. global settings of MainActor.
  482.  
  483. MainView supports the following options in this release:
  484.  
  485.            -(c|cache)
  486.            Cache Data. This option will load all data of the animation into a 
  487.            ram cache before playing. This will speed up animation playback. If 
  488.            not enough free ram is available, MainView will free the already 
  489.            allocated memory and play directly from harddisk/cdrom. This option 
  490.            is off by default.
  491.  
  492. -(v|volume) number
  493.            Set the sound volume, the range for the number is 0-100. Default is 100.
  494.  
  495. -(tbl|toolbarlocation) location
  496.            Sets the initial location of the control toolbar. Location can be 
  497.            one of the following strings: top, bottom, left, right, floating and hidden.
  498.  
  499.            -(hw|hidewindow)
  500.            Hide the load window, the window which displays the progress of the 
  501.            loading process. The window will not be shown. This option is off by default.
  502.  
  503.            -(das|disableautostart)
  504.            This option will stop MainView to start animations automatically.
  505.  
  506. -(r|repeat) number
  507.            The number indicates how many times the project shall be repeated 
  508.            while playing. Default is 1. Note, animation with sound will always 
  509.            only play once.
  510.  
  511.            -(fs|fullscreen)
  512.            Enables full screen playback.
  513.  
  514.            -(sts|scaletoscreen)
  515.            Only available in full screen mode. The images of the project will 
  516.            always be scaled to the full size of the screen.
  517.  
  518.            -(ubm|usebestmode)
  519.            Only available in full screen mode. Normally, MainView takes the 
  520.            screen mode of the windows user interface for playback. This option 
  521.            enables MainView to search for the best mode available for the 
  522.            project on your system.
  523.  
  524. Example: mainview -volume 80 -tbl bottom dino.mov would play the dino.mov 
  525. animation with a sound volume of 80 and the toolbar would be located at the 
  526. bottom of the window.
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ 5. The Modules ΓòÉΓòÉΓòÉ
  530.  
  531. MainActor supports various modules and codecs. The modules are updated 
  532. frequently and more will be added in future releases. 
  533.  
  534. o   Loader Modules 
  535.  
  536. o   Saver Modules 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 5.1. Loader Modules ΓòÉΓòÉΓòÉ
  540.  
  541. Currently supplied loader modules:
  542.  
  543. o   AVI
  544.  
  545. o   BMP
  546.  
  547. o   DL
  548.  
  549. o   FLC/FLI
  550.  
  551. o   GIF
  552.  
  553. o   GIF-Anim
  554.  
  555. o   IFF
  556.  
  557. o   IFF-Anim3/5/7/8/J
  558.  
  559. o   JPEG
  560.  
  561. o   MPEG
  562.  
  563. o   PCX
  564.  
  565. o   Quicktime
  566.  
  567. o   WAV
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 5.1.1. AVI ΓòÉΓòÉΓòÉ
  571.  
  572.            Type:
  573.            Animation (Supports Sound)
  574.  
  575.            Codecs:
  576.  
  577.                       o   Cinepak
  578.  
  579.            o   Intel Indeo v2.1 / v3.1 / v3.2 / v4.1 (Windows Only)
  580.  
  581.            o   Microsoft RLE 
  582.  
  583.            o   Microsoft Video 1 
  584.  
  585.            o   Motion JPEG 
  586.  
  587.                       o   Ultimotion
  588.  
  589.            o   Uncompressed
  590.  
  591.            Notes:
  592.  
  593.            o   AVI uses global timecodes.
  594.  
  595.            o   If you encounter an AVI animation which MainActor does not play 
  596.                correctly or uses an codec unknown by MainActor, please inform us.
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 5.1.2. BMP ΓòÉΓòÉΓòÉ
  600.  
  601. Type: 
  602.            Picture 
  603.  
  604.            Codecs:
  605.  
  606.            o   RunLength Encoding 
  607.  
  608.            o   Uncompressed
  609.  
  610.            Notes:
  611.            None
  612.  
  613.  
  614. ΓòÉΓòÉΓòÉ 5.1.3. DL ΓòÉΓòÉΓòÉ
  615.  
  616.            Type:
  617.                                  Animation
  618.  
  619.            Codecs:
  620.  
  621.            o   Type 1 (Untested)
  622.  
  623.            o   Type 2 
  624.  
  625.            Notes:
  626.  
  627.            o   Type 1 and 2 DL animations are always uncompressed.
  628.  
  629.            o   Type 3 animations are not supported, in fact we did never even 
  630.                see one. 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 5.1.4. FLI/FLC ΓòÉΓòÉΓòÉ
  634.  
  635.            Type:
  636.                                  Animation
  637.  
  638.            Codecs:
  639.  
  640.                       o   ByteRun
  641.  
  642.            o   Byte LineCoding 
  643.  
  644.            o   Clear Screen 
  645.  
  646.                       o   Uncompressed
  647.  
  648.            o   Word LineCoding (FLC only)
  649.  
  650.            Notes:
  651.  
  652.            o   FLI / FLC animations are limited to 256 colors.
  653.  
  654.            o   FLI only supports resolutions of 320 * 200.
  655.  
  656.            o   FLI / FLC use global timecodes.
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 5.1.5. GIF ΓòÉΓòÉΓòÉ
  660.  
  661. Type: 
  662.            Picture 
  663.  
  664.            Codecs:
  665.  
  666.            o   GIF-LZW
  667.  
  668.            Notes:
  669.  
  670.            o   GIF supports 256 colors only. 
  671.  
  672.            o   The LZW decoding/encoding is officially licensed from UniSys.
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 5.1.6. GIF-Anim ΓòÉΓòÉΓòÉ
  676.  
  677. Type: 
  678.            Animation 
  679.  
  680.            Codecs:
  681.  
  682.            o   GIF-LZW
  683.  
  684.            Notes:
  685.  
  686.            o   GIF-Anim supports local timecodes.
  687.  
  688.            o   GIF supports 256 colors only. 
  689.  
  690.            o   The LZW decoding/encoding is officially licensed from UniSys.
  691.  
  692.  
  693. ΓòÉΓòÉΓòÉ 5.1.7. IFF ΓòÉΓòÉΓòÉ
  694.  
  695. Type: 
  696.            Picture 
  697.  
  698.            Codecs:
  699.  
  700.            o   ByteRun Encoding 
  701.  
  702.            Notes:
  703.            Supports HAM6/8 and EHB.
  704.  
  705.  
  706. ΓòÉΓòÉΓòÉ 5.1.8. IFF-Anim3/5/7/8/J ΓòÉΓòÉΓòÉ
  707.  
  708. Type: 
  709.            Animation 
  710.  
  711.            Codecs:
  712.  
  713.            o   ByteRun Encoding 
  714.  
  715.            o   Various LONG and WORD delta codecs 
  716.  
  717.            Notes:
  718.  
  719.            o   Supports HAM6/8 and EHB.
  720.  
  721.            o   Supports local timecodes.
  722.  
  723.  
  724. ΓòÉΓòÉΓòÉ 5.1.9. JPEG ΓòÉΓòÉΓòÉ
  725.  
  726. Type: 
  727.            Picture 
  728.  
  729.            Codecs:
  730.  
  731.            o   JPEG
  732.  
  733.            Notes:
  734.            Based on the source code of the Independent JPEG group.
  735.  
  736.  
  737. ΓòÉΓòÉΓòÉ 5.1.10. MPEG ΓòÉΓòÉΓòÉ
  738.  
  739.            Type:
  740.            Video Stream 
  741.  
  742.            Codecs:
  743.  
  744.                       o   MPEG-I
  745.  
  746.            o   MPEG-II 
  747.  
  748.            Notes:
  749.  
  750.            o   The MPEG module is different as the other animation modules. It 
  751.                is solved as an video stream module, that means that no 
  752.                information about the single frames inside the stream are 
  753.                available. You can however play and save/convert the stream as 
  754.                usual, you just cannot process single frames inside the stream.
  755.  
  756.            o   The MPEG stream has to be video only. Audio and video streams 
  757.                with audio information are currently not supported.
  758.  
  759.  
  760. ΓòÉΓòÉΓòÉ 5.1.11. PCX ΓòÉΓòÉΓòÉ
  761.  
  762. Type: 
  763.            Picture 
  764.  
  765.            Codecs:
  766.  
  767.            o   RunLength Encoding 
  768.  
  769.            Notes:
  770.            None
  771.  
  772.  
  773. ΓòÉΓòÉΓòÉ 5.1.12. Quicktime ΓòÉΓòÉΓòÉ
  774.  
  775.            Type:
  776.            Animation (Supports Sound)
  777.  
  778.            Codecs:
  779.  
  780.            o   Apple Animation 
  781.  
  782.            o   Apple Graphics 
  783.  
  784.                       o   Cinepak
  785.  
  786.            o   Intel Indeo v2.1 / v3.1 / v3.2
  787.  
  788.            o   Motion JPEG 
  789.  
  790.            Notes:
  791.  
  792.            o   Quicktime supports local timecodes.
  793.  
  794.            o   If you encounter an Quicktime animation which MainActor does not 
  795.                play correctly or uses an codec unknown by MainActor, please 
  796.                inform us.
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 5.1.13. WAV ΓòÉΓòÉΓòÉ
  800.  
  801. Type: 
  802.                       Sound 
  803.  
  804.            Codecs:
  805.  
  806.            o   Pulse Code Modulation 
  807.  
  808.            Notes:
  809.            None
  810.  
  811.  
  812. ΓòÉΓòÉΓòÉ 5.2. Saver Modules ΓòÉΓòÉΓòÉ
  813.  
  814. Currently supplied saver modules:
  815.  
  816. o   AVI
  817.  
  818. o   BMP
  819.  
  820. o   FLC/FLI
  821.  
  822. o   GIF / GIF-Anim
  823.  
  824. o   JPEG
  825.  
  826. o   Video Data 
  827.  
  828. o   Quicktime
  829.  
  830. o   WAV
  831.  
  832.  
  833. ΓòÉΓòÉΓòÉ 5.2.1. AVI ΓòÉΓòÉΓòÉ
  834.  
  835.            Type:
  836.            Animation (Supports Sound)
  837.  
  838.            Codecs:
  839.  
  840.            o   Cinepak (Only Windows)
  841.  
  842.            o   Intel Indeo v3.1 (OS/2) / v3.2 (Windows) / v4.1 (Windows)
  843.  
  844.            o   Microsoft RLE 
  845.  
  846.            o   Motion JPEG 
  847.  
  848.            o   Ultimotion (Only OS/2)
  849.  
  850.            o   Uncompressed
  851.  
  852.            Options:
  853.  
  854.            Motion JPEG Quality Compression Quality
  855.                       Defines the jpeg compression quality for the Motion JPEG codec.
  856.  
  857.            MMPM/2 or ICM Compression Quality
  858.                       The compression quality for the multimedia codec 
  859.                       subsystem (MMPM/2 for OS/2 and ICM for Windows). -1 is 
  860.                       the default quality of the codec.
  861.  
  862.            MMPM/2 or ICM Key Frame Rate
  863.                       The Key frame rate of the system codec. 1 means every 
  864.                       frame is a key frame, 2 means every second frame is a key 
  865.                       frame etc. -1 is the default rate of the codec.
  866.  
  867.            Notes:
  868.  
  869.            o   MainActor generated AVIs have been compatibility tested on 
  870.                nearly all platforms, including Windows 3.1 / W95 / NT, OS/2 and ActiveMOVIE.
  871.  
  872.  
  873. ΓòÉΓòÉΓòÉ 5.2.2. BMP ΓòÉΓòÉΓòÉ
  874.  
  875. Type: 
  876.            Picture 
  877.  
  878.            Codecs:
  879.  
  880.            o   Uncompressed
  881.  
  882.            Options:
  883.            None
  884.  
  885.            Notes:
  886.            None
  887.  
  888.  
  889. ΓòÉΓòÉΓòÉ 5.2.3. FLI / FLC ΓòÉΓòÉΓòÉ
  890.  
  891.            Type:
  892.                                  Animation
  893.  
  894.            Codecs:
  895.  
  896.                       o   ByteRun
  897.  
  898.            o   Byte LineCoding (FLI Only)
  899.  
  900.            o   Word LineCoding (FLC Only)
  901.  
  902.            Options:
  903.            None
  904.  
  905.            Notes:
  906.  
  907.            o   FLI / FLC animations are limited to 256 colors.
  908.  
  909.            o   FLI only supports resolutions of 320 * 200.
  910.  
  911.            o   FLI / FLC use global timecodes.
  912.  
  913.  
  914. ΓòÉΓòÉΓòÉ 5.2.4. GIF / GIF-Anim ΓòÉΓòÉΓòÉ
  915.  
  916. Type: 
  917.            Picture / Animation 
  918.  
  919.            Codecs:
  920.  
  921.            o   GIF-LZW
  922.  
  923.            Options:
  924.  
  925.                                  Interlace
  926.                       Enables interlace compression.
  927.  
  928.            Background Index
  929.                       Identifies the color index which will be used as the 
  930.                       background color of the image.
  931.  
  932.            Transparent Index 
  933.                       Identifies the color index which will be set to 
  934.                       transparent, i.e. the background shines through.
  935.  
  936.            Netscape   Loop
  937.                       (GIF-Anim  Only)
  938.                                  Specifies how many times the animation will be 
  939.                                  repeated inside the Netscape browser, 
  940.                                  Microsoft support this option too.
  941.  
  942.            Notes:
  943.  
  944.            o   GIF supports 256 colors only. 
  945.  
  946.            o   The GIF-Anim saver supports local timecodes, it is therefore 
  947.                possible to convert AVI or Quicktime animations to GIF-Anim 
  948.                without loss of timing information.
  949.  
  950.            o   The LZW decoding/encoding is officially licensed from UniSys.
  951.  
  952.  
  953. ΓòÉΓòÉΓòÉ 5.2.5. JPEG ΓòÉΓòÉΓòÉ
  954.  
  955.            Type:
  956.            Picture
  957.  
  958.            Codecs:
  959.  
  960.            o   JPEG
  961.  
  962.            Options:
  963.  
  964.            Compression Quality
  965.                       The quality used for compressing the images.
  966.  
  967.            Notes:
  968.            Based on the source code of the Independent JPEG group.
  969.  
  970.  
  971. ΓòÉΓòÉΓòÉ 5.2.6. Video Data ΓòÉΓòÉΓòÉ
  972.  
  973. Type: 
  974.            Picture 
  975.  
  976.            Codecs:
  977.  
  978.            o   Video binary 
  979.  
  980.            Options:
  981.            None
  982.  
  983.            Notes:
  984.            Splits the compressed video data from animations. Very useful to 
  985.            save standalone image data from animation formats. For example 
  986.            motion JPEG AVIs and Quicktimes contain standalone JPEG image data 
  987.            for each frame. Using this saver module you can save them into 
  988.            single files without having to decompress and then compress them again.
  989.  
  990.  
  991. ΓòÉΓòÉΓòÉ 5.2.7. MPEG ΓòÉΓòÉΓòÉ
  992.  
  993.            Type:
  994.            Animation
  995.  
  996.            Codecs:
  997.  
  998.            o   MPEG-I PAL (25 fps)
  999.  
  1000.            o   MPEG-I NTSC (30 fps)
  1001.  
  1002.            o   MPEG-II PAL (25 fps)
  1003.  
  1004.            o   MPEG-II NTSC (30 fps)
  1005.  
  1006.            Options:
  1007.  
  1008.            Ignore     Timecodes
  1009.                       MPEG streams always have a fixed frames per second rate. 
  1010.                       When this option is on (which is the default) then 
  1011.                       MainActor simply inserts the frames into the stream and 
  1012.                       ignores the timecodes of the source project. If this 
  1013.                       option is disabled, MainActor inserts additional frames 
  1014.                       into the stream to preserve the timing of the source 
  1015.                       project, but this results in bigger MPEG files.
  1016.  
  1017.            MPEG-I Bits per Second
  1018.                       Defines the bit rate of the generated MPEG-I stream.
  1019.  
  1020.            MPEG-II Bits per Second
  1021.                       Defines the bit rate of the generated MPEG-II stream.
  1022.  
  1023.                                  Interlaced
  1024.                       If enabled, this option will activate the interlace mode. 
  1025.                       Animation will then consist of fields rather than frames.
  1026.  
  1027.            Top        Field
  1028.                       This field can either be one or zero and is only valid if 
  1029.                       the Interlaced option is on. It defines the field which 
  1030.                       is first encoded, either the first (0) or second (1) line 
  1031.                       of each frame.
  1032.  
  1033.            Notes:
  1034.  
  1035.            o   The code this module is based on and is copyrighted by the MPEG 
  1036.                Software Simulation Group.
  1037.  
  1038.  
  1039. ΓòÉΓòÉΓòÉ 5.2.8. Quicktime ΓòÉΓòÉΓòÉ
  1040.  
  1041.            Type:
  1042.            Animation (Supports Sound)
  1043.  
  1044.            Codecs:
  1045.  
  1046.            o   Cinepak (Windows only)
  1047.  
  1048.            o   Intel Indeo v3.1 (OS/2) / v3.2 (Windows) / v4.1 (Windows)
  1049.  
  1050.            o   Motion JPEG 
  1051.  
  1052.            o   Uncompressed
  1053.  
  1054.            Options:
  1055.  
  1056.            Motion JPEG Quality Compression Quality
  1057.                       Defines the jpeg compression quality for the Motion JPEG codec.
  1058.  
  1059.            MMPM/2 or ICM Compression Quality
  1060.                       The compression quality for the multimedia codec 
  1061.                       subsystem (MMPM/2 for OS/2 and ICM for Windows). -1 is 
  1062.                       the default quality of the codec.
  1063.  
  1064.            MMPM/2 or ICM Key Frame Rate
  1065.                       The Key frame rate of the system codec. 1 means every 
  1066.                       frame is a key frame, 2 means every second frame is a key 
  1067.                       frame etc. -1 is the default rate of the codec.
  1068.  
  1069.            Notes:
  1070.  
  1071.            o   MainActor generated Quicktimes have been compatibility tested on 
  1072.                many platforms, including Quicktime for Windows, ActiveMOVIE and MacOS.
  1073.  
  1074.  
  1075. ΓòÉΓòÉΓòÉ 5.2.9. WAV ΓòÉΓòÉΓòÉ
  1076.  
  1077.            Type:
  1078.            Sound
  1079.  
  1080.            Codecs:
  1081.  
  1082.            o   Pulse Code Modulation 
  1083.  
  1084.            Options:
  1085.            None
  1086.  
  1087.            Notes:
  1088.            Use this module to split sound from animations.
  1089.  
  1090.  
  1091. ΓòÉΓòÉΓòÉ 6. Mailing Lists ΓòÉΓòÉΓòÉ
  1092.  
  1093. We are running mailing lists for every MainActor version. If you are interested 
  1094. in the product we recommend to join the list to get the latest information on MainActor.
  1095.  
  1096. o   OS/2 Mailing List.
  1097.  
  1098. o   Windows Mailing List.
  1099.  
  1100. You can get the frequently asked question (FAQ) text file for MainActor by 
  1101. sending email to mafaq@mainconcept.de.
  1102.  
  1103.  
  1104. ΓòÉΓòÉΓòÉ 6.1. OS/2 Mailing List ΓòÉΓòÉΓòÉ
  1105.  
  1106. To join to the mailing list send email to steward@mainconcept.de.
  1107.  
  1108. SUBSCRIBE os2-MainActor <your email address>
  1109.            Adds your email address to the mailing list.
  1110.  
  1111. UNSUBSCRIBE os2-MainActor <your email address>
  1112.            Deletes your email address from the mailing list.
  1113.  
  1114.            LISTS
  1115.            Will send a list of all available mailing lists on our server.
  1116.  
  1117.            HELP
  1118.            Will send the help page for all available commands on our server.
  1119.  
  1120.  
  1121. ΓòÉΓòÉΓòÉ 6.2. Windows Mailing List ΓòÉΓòÉΓòÉ
  1122.  
  1123. To join to the mailing list send email to steward@mainconcept.de.
  1124.  
  1125. SUBSCRIBE win-MainActor <your email address>
  1126.            Adds your email address to the mailing list.
  1127.  
  1128. UNSUBSCRIBE win-MainActor <your email address>
  1129.            Deletes your email address from the mailing list.
  1130.  
  1131.            LISTS
  1132.            Will send a list of all available mailing lists on our server.
  1133.  
  1134.            HELP
  1135.            Will send the help page for all available commands on our server.
  1136.  
  1137.  
  1138. ΓòÉΓòÉΓòÉ 7. Credits ΓòÉΓòÉΓòÉ
  1139.  
  1140. We have to thank the following people:
  1141.  
  1142. o   Mark Podlipec. Some of the AVI and Quicktime decoders included in MainActor 
  1143.     are based upon his work.
  1144. o   The Independent JPEG group for their JPEG source.
  1145. o   The folks at IBM for their great VisualAge C++ environment.
  1146. o   The MPEG Software Simulation Group for their MPEG source.
  1147. o   Norbert Bogenrieder for the artwork and the icons.
  1148.  
  1149.  
  1150. ΓòÉΓòÉΓòÉ 8. Registration ΓòÉΓòÉΓòÉ
  1151.  
  1152. If you decide to register MainActor, we will send you a personal serial number 
  1153. which will be able to unlock all future versions of this software on all 
  1154. available platforms. 
  1155.  
  1156. MainActor is currently running on OS/2 and Windows 95 / NT 4.0. 
  1157.  
  1158. The fee for MainActor is 99,- DM (appr. $60) or any equivalent sum in your 
  1159. local currency. Please no foreign checks (except EuroChecks). We do take 
  1160. Master/EuroCard and VISA.
  1161.  
  1162. You can contact us at : 
  1163.  
  1164. MainConcept, GbR Moenig/Zabel
  1165. Hermann-Heusch-Platz 3
  1166. D-52062 Aachen
  1167. Germany
  1168.  
  1169. Tel:  +49-(0)241-4090444
  1170. FAX:  +49-(0)241-4090445
  1171. BBS:  +49-(0)241-4090446
  1172.  
  1173. Email: info@mainconcept.de
  1174. http://www.mainconcept.de
  1175.  
  1176. You can also order at BMT Micro (http://www.bmtmicro.com). Please have a look 
  1177. at the file bmtmicro.txt included in this package.
  1178.  
  1179. Online registration for the Windows version is also available at http://www.buydirect.com.
  1180.  
  1181.  
  1182. ΓòÉΓòÉΓòÉ 9. History ΓòÉΓòÉΓòÉ
  1183.  
  1184. The history lists the last three revisions of MainActor, together with the bug 
  1185. fixes, improvements and new features of every revision.
  1186.  
  1187.  
  1188. ΓòÉΓòÉΓòÉ 9.1. Version 0.65 ΓòÉΓòÉΓòÉ
  1189.  
  1190. o   Added a system codec interface which adds Intel Indeo support to the AVI 
  1191.     and Quicktime loader modules and Intel Indeo v3.1 and Ultimotion support to 
  1192.     the AVI saver module.
  1193. o   Added the MMPM/2 quality and key frame rate options to the AVI saver 
  1194.     module. These options define the behaviour of the system codecs.
  1195. o   Fixed a stupid bug in the quicktime loader module which could cause crashes 
  1196.     while loading a qt animation.
  1197. o   Changed the CVID decompression routines (AVI/Quicktime) to generate more 
  1198.     vivid colors.
  1199. o   Added global playback settings for MainActor and MainView.
  1200.  
  1201.  
  1202. ΓòÉΓòÉΓòÉ 9.2. Version 0.80 ΓòÉΓòÉΓòÉ
  1203.  
  1204. General improvements : 
  1205.  
  1206. o   Updated the general look of MainActor and added the preview window.
  1207. o   New Quicktime saver module. This one was requested frequently from our users.
  1208. o   New video data saver module. This saver saves the video chunks from 
  1209.     animations. Very useful for splitting stand-alone video chunks without 
  1210.     having to decompress them. For example JPEG video from Motion JPEG files.
  1211. o   IMA4 Mono and Stereo support for the Quicktime loader module.
  1212. o   Improvements to the AVI saver module, the saver included in v0.65 had 
  1213.     compatibility problems with ActiveMOVIE and other programs.
  1214. o   Added the Index option to the Saver Window. Also added the Time field which 
  1215.     displayes the timecode of the already saved frames.
  1216. o   Updated the documentation and joined the Windows and OS/2 versions.
  1217. o   MainActor now recognizes key frames inside animations and displays them in 
  1218.     the frame list as frames with gray icons.
  1219. o   MainActor/MainView are now able to resume playback at any specific position 
  1220.     inside the animation.
  1221. o   MainActor now handles animations with sound different as previous versions. 
  1222.     Every frame of the animation has now the correct audio data associated to it.
  1223.  
  1224. OS/2 specific improvements : 
  1225.  
  1226. o   Fixed a bug which was there right from the beginning: Closing the playback 
  1227.     window could crash the whole system. This only happened with some graphic 
  1228.     card drivers.
  1229.  
  1230. Windows specific improvements : 
  1231.  
  1232. o   MainActor now uses the native file requester.
  1233. o   Improved DirectX support, especially under Windows NT 4.0.
  1234. o   MainActor now ships with the latest versions of IBMs open class libraries 
  1235.     (Fixpack 2). This fixes some user interface problems.
  1236.  
  1237.  
  1238. ΓòÉΓòÉΓòÉ 9.3. Version 1.00 ΓòÉΓòÉΓòÉ
  1239.  
  1240. General improvements : 
  1241.  
  1242. o   Lots of bugfixes, both in the modules and in MainActor itself. All 
  1243.     known/reported bugs of v0.80 were fixed.
  1244. o   New WAV loader module.
  1245. o   New MPEG-I/II stream loader and MPEG-I/II animation saver modules.
  1246. o   New Multi-language support. Currently supported languages are english and german.
  1247. o   Some improvements to the interface, i.e. toolbar, logo etc.
  1248. o   Much faster JPEG support, both for still and motion JPEG.
  1249. o   Support for JPEG frames with missing huffman tables, these are mostly 
  1250.     generated by video capture hardware. We tested this feature with animations 
  1251.     generated by FAST and Miro hardware.
  1252. o   Improvements to the Palette Editor, i.e. you can now load / save palettes.
  1253. o   New Save Options window and improvements to the Save Window. New options 
  1254.     include support for interpolation while scaling and error diffusion when dithering.
  1255.  
  1256. OS/2 specific improvements : 
  1257.  
  1258. o   Video/audio syncronization would loose sync of about 3/4 tenths of a second 
  1259.     for every 15 minutes of video. This has been fixed but was only noticeably 
  1260.     when playing animations with at least five minutes playback time.
  1261.  
  1262. Windows specific improvements : 
  1263.  
  1264. o   New Video Capture