home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / mac / sparkle / readme.txt < prev    next >
Encoding:
Text File  |  1994-06-17  |  4.8 KB  |  100 lines
  1. Sparkle 
  2.  
  3. Sparkle is a free program for the Macintosh that can encode or play 
  4. MPEG files and convert them to QuickTime movies. It requires a Mac 
  5. with a 68020 or higher processor, QuickTime 1.6 or higher and System 
  6. 7 or higher. It runs much better with the Thread Manager installed. 
  7. If you don't have the Thread Manager you can obtain it from 
  8. ftp.apple.com  in dts/mac/sys.soft/thread-manager-2-0-1.hqx.
  9. (Note that this supersedes the ftp address given in the program itself, 
  10. because Apple recently re-arranged their ftp site.)
  11. Sparkle runs on PowerPCs but is not yet native so performance will be 
  12. disappointing.  Note that at present Sparkle can only understand the 
  13. video stream of an MPEG file, not the full ISO 11172 stream. However 
  14. Sparkle understands I P and B frames and can usually cope with anomalies 
  15. in the file structure like a file that begins with a set of B frames.
  16. At present most MPEG files consist of only the video stream, so lack OF 
  17. ISO 11172 isn't a real problem yet, but I'll be adding said support ASAP.
  18.  
  19. The version of Sparkle on this CD ROM is 2.02.
  20.  
  21. Sparkle 2.02 is optimized for playback on 24 bit screens. Playback on 16 
  22. bit screens will be slower and playback on 8 bit screens will be painfully 
  23. slow (though at very high quality dithering). 
  24.  
  25. This program was written for distribution over the Internet and I fear 
  26. that CD ROM users may be misled by it in the absence of a few notes.
  27.  
  28. * This program is in a constant state of flux. Sometimes I release new 
  29. versions because I'm satisfied with attaining a certain level of 
  30. functionality. At other times I release very rough code because there is a 
  31. large demand for the code, albeit rough. In particular, the MPEG encoding 
  32. of Sparkle is very slow, uses way more memory than necessary, and may 
  33. encode misleading or incorrect values for some parts of the MPEG stream.
  34. The next release of Sparkle, 2.1, in June 94 or so speeds up MPEG 
  35. playback by 150% to 300% (with special case support for common screen 
  36. depths other than 24 bit), provides real time playback (skipping frames if 
  37. necessary)  and provides substantial additions to the user interface. 
  38. After this I will improve MPEG encoding and add support for ISO 11172 
  39. demuxing and audio. 
  40.  
  41. * If you have a problem with Sparkle, first try to obtain the most recent 
  42. version. New versions are posted to the ftp site 
  43. sumex-aim.stanford.edu in the directory info-mac/grf/util. 
  44. I would suggest that you try a mirror of the sumex-aim site which is 
  45. constantly overloaded. Some suggestions are:
  46.  
  47. ftp.hawaii.edu           128.171.44.70    mirrors/info-mac
  48. src.doc.ic.ac.uk         146.169.2.10     packages/info-mac            
  49. imftp.mgt.ncu.edu.tw     140.115.83.90    /pub/mac/info-mac            
  50.  
  51. Sparkle does eventually drift to commercial providers like AOL and 
  52. Compuserve but I don't have accounts on those so they may ftp sites 
  53. by a month or more.  
  54.  
  55. New versions are released about every two or three months.
  56.  
  57. * If obtaining the most recent version does not solve your problem, feel 
  58. free to mail me. My address is maynard@elwing.otago.ac.nz.  I try 
  59. to fix bugs the moment I learn of them. If you have a suggestion for 
  60. the future, not a bug report, I will add it as soon as I can. However many 
  61. suggestions I receive are things I already have planned that require 
  62. layers upon layers of support code to be written so they may not be 
  63. implemented for a while.
  64.  
  65. * I have in the past given the code to people who request it. However I'm 
  66. not making it generally available because it is, at any given stage, 
  67. riddled with junk from previous versions, along with hooks I've placed for 
  68. future ideas and it's a mess. It is cleaned up as I update it, but other 
  69. parts become a mess. The code requires detailed knowledge of 
  70.  
  71. MPEG
  72. QuickTime
  73. QuickDraw and the Mac OS (and 68K assembly)
  74. Threads and the Mac Thread Manager
  75.  
  76. If you don't know much about any of these areas, trying to learn about 
  77. MPEG from this code will probably waste your time.
  78.  
  79. * The ``kernel'' of Sparkle is based on threads that communicate with each 
  80. other asynchronously. This design offers two important benefits.
  81.  
  82. Firstly it is very easy to write UNIX style code that is 
  83. compute-intensive and runs for a long time, yet maintain interactivity with 
  84. the user and processing events.
  85.  
  86. Secondly the asynch communication means it should be fairly easy to get 
  87. Sparkle to vector all MPEG encoding/decoding to dedicated hardware while 
  88. still using the Sparkle user-interface, time-slicing, memory-management and 
  89. scheduling.
  90.  
  91. * I maintain Sparkle as a hobby, and because of that things proceed 
  92. slowly---I can't devote more than a few hours a week to it.
  93.  
  94. * If someone wants to hire me to do this as a full time job, I'm eager for 
  95. any offers. Please mail me.
  96.  
  97. Maynard Handley
  98. 17 May 1994
  99.  
  100.