Changeset 505

Show
Ignore:
Timestamp:
05/14/07 21:53:49 (1 year ago)
Author:
gbooker
Message:

Updated readme. Included the GPL license in there since we distribute A52 (GPL code).

Fixes #159

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/Release/Read Me.rtf

    r438 r505  
    22{\fonttbl\f0\fswiss\fcharset77 Helvetica-Bold;\f1\fswiss\fcharset77 Helvetica;} 
    33{\colortbl;\red255\green255\blue255;} 
    4 \margl1440\margr1440\vieww9000\viewh8400\viewkind0 
     4\margl1440\margr1440\vieww16040\viewh15820\viewkind0 
    55\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural 
    66 
    77\f0\b\fs24 \cf0 About 
    88\f1\b0 \ 
    9 Perian is a QuickTime component incorporating libavcodec and friends from the ffmpeg project along with code from the old FFusion component and AVIImporter.component. The code is available under the GPL. The project site is located at <http://trac.cod3r.com/perian/> and the project subversion repository is located at <http://svn.cod3r.com/perian/>.\ 
    10 
    11  
    12 \f0\b Supported Formats 
    13 \f1\b0 \ 
    14 Currently Perian supports most AVI files. I've found one AVI that doesn't\ 
    15 quite play back correctly (audio issues), but other than that it's been reliable. It should cleanly support both XviD and DivX encoded AVI files along with some other minor flavors.\ 
     9Perian aims at providing a single package to provide all your playback needs.  It is a collection of QuickTime components incorporating several libraries:\ 
     10 \'a5 libavcodec from the ffmpeg project along with code from the old FFusion component:\ 
     11        \'a5 MS-MPEG4 v1 & v2\ 
     12        \'a5 DivX\ 
     13        \'a5 3ivX\ 
     14        \'a5 H.264\ 
     15        \'a5 FLV1\ 
     16        \'a5 FSV1\ 
     17        \'a5 VP6\ 
     18        \'a5 H263I\ 
     19        \'a5 VP3\ 
     20        \'a5 HuffYUV\ 
     21        \'a5 ffvhuff\ 
     22        \'a5 MPEG1 & 2 Video\ 
     23        \'a5 Fraps\ 
     24        \'a5 Windows Media Audio v1 & v2\ 
     25        \'a5 Flash ADPCM\ 
     26        \'a5 Xiph Vorbis\ 
     27        \'a5 MPEG layer 2 Audio\ 
     28 \'a5 libavformat from the ffmpeg project along with AVIImporter.component:\ 
     29        \'a5 AVI file format\ 
     30        \'a5 FLV file format\ 
     31 \'a5 libmatroska with matroska-qt.component:\ 
     32        \'a5 MKV file format\ 
     33 \'a5 Subtitle parsing\ 
     34        \'a5 SSA\ 
     35        \'a5 SRT\ 
     36 \'a5 liba52 with A52Codec\ 
     37        \'a5 AC3 audio\ 
     38
     39The code is available under the LGPL. The project site is located at <http://trac.perian.org/> and the project subversion repository is located at <http://svn.perian.org/>.\ 
     40The code for A52Codec is available under GPL. The project site is located at <http://trac.cod3r.com/a52codec/> and the project subversion repository is located at <http://svn.cod3r.com/a52codec/>.\ 
    1641\ 
    1742 
    1843\f0\b Easy Install 
    1944\f1\b0 \ 
    20 For ease of installation, a symlink to /Library/QuickTime has been provided on the disk image.\ 
    21 
    22  
    23 \f0\b Full Install Instructions 
    24 \f1\b0 \ 
    25 To use Perian, simply place it in /Library/QuickTime or ~/Library/QuickTime. \ 
    26 
    27  
    28 \f0\b Note 
    29 \f1\b0 \ 
    30 This is a prerelease-ish version of Perian, bugs will happen, and the final\ 
    31 feature set should grow dramatically. Perian should work in general, and we have tested it as much as is possible.\ 
     45To use Perian, open the disk image, and double click on the Perian.prefPane icon.  It will automatically install and update all of its components.\ 
    3246\ 
    3347 
     
    3953Alexander Strange - Dev\ 
    4054Augie Fackler - Dev\ 
     55Allan Hsu - Dev\ 
    4156\ 
    4257 
     
    4459\f1\b0 \ 
    4560J\'8er\'99me Cornet and his FFusion project for giving me the idea and code to start from Christoph N\'8ageli's AVI Importer from his XviD component, which allowed us to leverage libavformat.\ 
     61FFMPEG project for providing such a rich library.\ 
     62Dag \'81gren and the Mozilla Foundation for the universal charset detector.\ 
     63Matroska for their matroska library.\ 
    4664\ 
    4765All the people that put up with my insane requests for help and free testing, notably MartianSteve from #macsb for the first ICBM test, and Graham Booker for joining up with me and fixing the build every time I add a feature and then run off somewhere like the overcommitted madman I am.\ 
     
    5068\ 
    5169 
    52 \f0\b License\ 
    53 
    54 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural 
     70\f0\b Licenses\ 
     71
    5572 
    56 \f1\b0 \cf0             GNU LESSER GENERAL PUBLIC LICENSE\ 
     73\f1\b0                  GNU LESSER GENERAL PUBLIC LICENSE\ 
    5774                       Version 2.1, February 1999\ 
    5875\ 
     
    558575\ 
    559576\ 
     577                    GNU GENERAL PUBLIC LICENSE\ 
     578                       Version 2, June 1991\ 
     579\ 
     580 Copyright (C) 1989, 1991 Free Software Foundation, Inc.\ 
     581                       59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\ 
     582 Everyone is permitted to copy and distribute verbatim copies\ 
     583 of this license document, but changing it is not allowed.\ 
     584\ 
     585                            Preamble\ 
     586\ 
     587  The licenses for most software are designed to take away your\ 
     588freedom to share and change it.  By contrast, the GNU General Public\ 
     589License is intended to guarantee your freedom to share and change free\ 
     590software--to make sure the software is free for all its users.  This\ 
     591General Public License applies to most of the Free Software\ 
     592Foundation's software and to any other program whose authors commit to\ 
     593using it.  (Some other Free Software Foundation software is covered by\ 
     594the GNU Library General Public License instead.)  You can apply it to\ 
     595your programs, too.\ 
     596\ 
     597  When we speak of free software, we are referring to freedom, not\ 
     598price.  Our General Public Licenses are designed to make sure that you\ 
     599have the freedom to distribute copies of free software (and charge for\ 
     600this service if you wish), that you receive source code or can get it\ 
     601if you want it, that you can change the software or use pieces of it\ 
     602in new free programs; and that you know you can do these things.\ 
     603\ 
     604  To protect your rights, we need to make restrictions that forbid\ 
     605anyone to deny you these rights or to ask you to surrender the rights.\ 
     606These restrictions translate to certain responsibilities for you if you\ 
     607distribute copies of the software, or if you modify it.\ 
     608\ 
     609  For example, if you distribute copies of such a program, whether\ 
     610gratis or for a fee, you must give the recipients all the rights that\ 
     611you have.  You must make sure that they, too, receive or can get the\ 
     612source code.  And you must show them these terms so they know their\ 
     613rights.\ 
     614\ 
     615  We protect your rights with two steps: (1) copyright the software, and\ 
     616(2) offer you this license which gives you legal permission to copy,\ 
     617distribute and/or modify the software.\ 
     618\ 
     619  Also, for each author's protection and ours, we want to make certain\ 
     620that everyone understands that there is no warranty for this free\ 
     621software.  If the software is modified by someone else and passed on, we\ 
     622want its recipients to know that what they have is not the original, so\ 
     623that any problems introduced by others will not reflect on the original\ 
     624authors' reputations.\ 
     625\ 
     626  Finally, any free program is threatened constantly by software\ 
     627patents.  We wish to avoid the danger that redistributors of a free\ 
     628program will individually obtain patent licenses, in effect making the\ 
     629program proprietary.  To prevent this, we have made it clear that any\ 
     630patent must be licensed for everyone's free use or not licensed at all.\ 
     631\ 
     632  The precise terms and conditions for copying, distribution and\ 
     633modification follow.\ 
     634\page \ 
     635                    GNU GENERAL PUBLIC LICENSE\ 
     636   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION\ 
     637\ 
     638  0. This License applies to any program or other work which contains\ 
     639a notice placed by the copyright holder saying it may be distributed\ 
     640under the terms of this General Public License.  The "Program", below,\ 
     641refers to any such program or work, and a "work based on the Program"\ 
     642means either the Program or any derivative work under copyright law:\ 
     643that is to say, a work containing the Program or a portion of it,\ 
     644either verbatim or with modifications and/or translated into another\ 
     645language.  (Hereinafter, translation is included without limitation in\ 
     646the term "modification".)  Each licensee is addressed as "you".\ 
     647\ 
     648Activities other than copying, distribution and modification are not\ 
     649covered by this License; they are outside its scope.  The act of\ 
     650running the Program is not restricted, and the output from the Program\ 
     651is covered only if its contents constitute a work based on the\ 
     652Program (independent of having been made by running the Program).\ 
     653Whether that is true depends on what the Program does.\ 
     654\ 
     655  1. You may copy and distribute verbatim copies of the Program's\ 
     656source code as you receive it, in any medium, provided that you\ 
     657conspicuously and appropriately publish on each copy an appropriate\ 
     658copyright notice and disclaimer of warranty; keep intact all the\ 
     659notices that refer to this License and to the absence of any warranty;\ 
     660and give any other recipients of the Program a copy of this License\ 
     661along with the Program.\ 
     662\ 
     663You may charge a fee for the physical act of transferring a copy, and\ 
     664you may at your option offer warranty protection in exchange for a fee.\ 
     665\ 
     666  2. You may modify your copy or copies of the Program or any portion\ 
     667of it, thus forming a work based on the Program, and copy and\ 
     668distribute such modifications or work under the terms of Section 1\ 
     669above, provided that you also meet all of these conditions:\ 
     670\ 
     671    a) You must cause the modified files to carry prominent notices\ 
     672    stating that you changed the files and the date of any change.\ 
     673\ 
     674    b) You must cause any work that you distribute or publish, that in\ 
     675    whole or in part contains or is derived from the Program or any\ 
     676    part thereof, to be licensed as a whole at no charge to all third\ 
     677    parties under the terms of this License.\ 
     678\ 
     679    c) If the modified program normally reads commands interactively\ 
     680    when run, you must cause it, when started running for such\ 
     681    interactive use in the most ordinary way, to print or display an\ 
     682    announcement including an appropriate copyright notice and a\ 
     683    notice that there is no warranty (or else, saying that you provide\ 
     684    a warranty) and that users may redistribute the program under\ 
     685    these conditions, and telling the user how to view a copy of this\ 
     686    License.  (Exception: if the Program itself is interactive but\ 
     687    does not normally print such an announcement, your work based on\ 
     688    the Program is not required to print an announcement.)\ 
     689\page \ 
     690These requirements apply to the modified work as a whole.  If\ 
     691identifiable sections of that work are not derived from the Program,\ 
     692and can be reasonably considered independent and separate works in\ 
     693themselves, then this License, and its terms, do not apply to those\ 
     694sections when you distribute them as separate works.  But when you\ 
     695distribute the same sections as part of a whole which is a work based\ 
     696on the Program, the distribution of the whole must be on the terms of\ 
     697this License, whose permissions for other licensees extend to the\ 
     698entire whole, and thus to each and every part regardless of who wrote it.\ 
     699\ 
     700Thus, it is not the intent of this section to claim rights or contest\ 
     701your rights to work written entirely by you; rather, the intent is to\ 
     702exercise the right to control the distribution of derivative or\ 
     703collective works based on the Program.\ 
     704\ 
     705In addition, mere aggregation of another work not based on the Program\ 
     706with the Program (or with a work based on the Program) on a volume of\ 
     707a storage or distribution medium does not bring the other work under\ 
     708the scope of this License.\ 
     709\ 
     710  3. You may copy and distribute the Program (or a work based on it,\ 
     711under Section 2) in object code or executable form under the terms of\ 
     712Sections 1 and 2 above provided that you also do one of the following:\ 
     713\ 
     714    a) Accompany it with the complete corresponding machine-readable\ 
     715    source code, which must be distributed under the terms of Sections\ 
     716    1 and 2 above on a medium customarily used for software interchange; or,\ 
     717\ 
     718    b) Accompany it with a written offer, valid for at least three\ 
     719    years, to give any third party, for a charge no more than your\ 
     720    cost of physically performing source distribution, a complete\ 
     721    machine-readable copy of the corresponding source code, to be\ 
     722    distributed under the terms of Sections 1 and 2 above on a medium\ 
     723    customarily used for software interchange; or,\ 
     724\ 
     725    c) Accompany it with the information you received as to the offer\ 
     726    to distribute corresponding source code.  (This alternative is\ 
     727    allowed only for noncommercial distribution and only if you\ 
     728    received the program in object code or executable form with such\ 
     729    an offer, in accord with Subsection b above.)\ 
     730\ 
     731The source code for a work means the preferred form of the work for\ 
     732making modifications to it.  For an executable work, complete source\ 
     733code means all the source code for all modules it contains, plus any\ 
     734associated interface definition files, plus the scripts used to\ 
     735control compilation and installation of the executable.  However, as a\ 
     736special exception, the source code distributed need not include\ 
     737anything that is normally distributed (in either source or binary\ 
     738form) with the major components (compiler, kernel, and so on) of the\ 
     739operating system on which the executable runs, unless that component\ 
     740itself accompanies the executable.\ 
     741\ 
     742If distribution of executable or object code is made by offering\ 
     743access to copy from a designated place, then offering equivalent\ 
     744access to copy the source code from the same place counts as\ 
     745distribution of the source code, even though third parties are not\ 
     746compelled to copy the source along with the object code.\ 
     747\page \ 
     748  4. You may not copy, modify, sublicense, or distribute the Program\ 
     749except as expressly provided under this License.  Any attempt\ 
     750otherwise to copy, modify, sublicense or distribute the Program is\ 
     751void, and will automatically terminate your rights under this License.\ 
     752However, parties who have received copies, or rights, from you under\ 
     753this License will not have their licenses terminated so long as such\ 
     754parties remain in full compliance.\ 
     755\ 
     756  5. You are not required to accept this License, since you have not\ 
     757signed it.  However, nothing else grants you permission to modify or\ 
     758distribute the Program or its derivative works.  These actions are\ 
     759prohibited by law if you do not accept this License.  Therefore, by\ 
     760modifying or distributing the Program (or any work based on the\ 
     761Program), you indicate your acceptance of this License to do so, and\ 
     762all its terms and conditions for copying, distributing or modifying\ 
     763the Program or works based on it.\ 
     764\ 
     765  6. Each time you redistribute the Program (or any work based on the\ 
     766Program), the recipient automatically receives a license from the\ 
     767original licensor to copy, distribute or modify the Program subject to\ 
     768these terms and conditions.  You may not impose any further\ 
     769restrictions on the recipients' exercise of the rights granted herein.\ 
     770You are not responsible for enforcing compliance by third parties to\ 
     771this License.\ 
     772\ 
     773  7. If, as a consequence of a court judgment or allegation of patent\ 
     774infringement or for any other reason (not limited to patent issues),\ 
     775conditions are imposed on you (whether by court order, agreement or\ 
     776otherwise) that contradict the conditions of this License, they do not\ 
     777excuse you from the conditions of this License.  If you cannot\ 
     778distribute so as to satisfy simultaneously your obligations under this\ 
     779License and any other pertinent obligations, then as a consequence you\ 
     780may not distribute the Program at all.  For example, if a patent\ 
     781license would not permit royalty-free redistribution of the Program by\ 
     782all those who receive copies directly or indirectly through you, then\ 
     783the only way you could satisfy both it and this License would be to\ 
     784refrain entirely from distribution of the Program.\ 
     785\ 
     786If any portion of this section is held invalid or unenforceable under\ 
     787any particular circumstance, the balance of the section is intended to\ 
     788apply and the section as a whole is intended to apply in other\ 
     789circumstances.\ 
     790\ 
     791It is not the purpose of this section to induce you to infringe any\ 
     792patents or other property right claims or to contest validity of any\ 
     793such claims; this section has the sole purpose of protecting the\ 
     794integrity of the free software distribution system, which is\ 
     795implemented by public license practices.  Many people have made\ 
     796generous contributions to the wide range of software distributed\ 
     797through that system in reliance on consistent application of that\ 
     798system; it is up to the author/donor to decide if he or she is willing\ 
     799to distribute software through any other system and a licensee cannot\ 
     800impose that choice.\ 
     801\ 
     802This section is intended to make thoroughly clear what is believed to\ 
     803be a consequence of the rest of this License.\ 
     804\page \ 
     805  8. If the distribution and/or use of the Program is restricted in\ 
     806certain countries either by patents or by copyrighted interfaces, the\ 
     807original copyright holder who places the Program under this License\ 
     808may add an explicit geographical distribution limitation excluding\ 
     809those countries, so that distribution is permitted only in or among\ 
     810countries not thus excluded.  In such case, this License incorporates\ 
     811the limitation as if written in the body of this License.\ 
     812\ 
     813  9. The Free Software Foundation may publish revised and/or new versions\ 
     814of the General Public License from time to time.  Such new versions will\ 
     815be similar in spirit to the present version, but may differ in detail to\ 
     816address new problems or concerns.\ 
     817\ 
     818Each version is given a distinguishing version number.  If the Program\ 
     819specifies a version number of this License which applies to it and "any\ 
     820later version", you have the option of following the terms and conditions\ 
     821either of that version or of any later version published by the Free\ 
     822Software Foundation.  If the Program does not specify a version number of\ 
     823this License, you may choose any version ever published by the Free Software\ 
     824Foundation.\ 
     825\ 
     826  10. If you wish to incorporate parts of the Program into other free\ 
     827programs whose distribution conditions are different, write to the author\ 
     828to ask for permission.  For software which is copyrighted by the Free\ 
     829Software Foundation, write to the Free Software Foundation; we sometimes\ 
     830make exceptions for this.  Our decision will be guided by the two goals\ 
     831of preserving the free status of all derivatives of our free software and\ 
     832of promoting the sharing and reuse of software generally.\ 
     833\ 
     834                            NO WARRANTY\ 
     835\ 
     836  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY\ 
     837FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN\ 
     838OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES\ 
     839PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED\ 
     840OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\ 
     841MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS\ 
     842TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE\ 
     843PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,\ 
     844REPAIR OR CORRECTION.\ 
     845\ 
     846  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\ 
     847WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR\ 
     848REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,\ 
     849INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING\ 
     850OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED\ 
     851TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY\ 
     852YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER\ 
     853PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE\ 
     854POSSIBILITY OF SUCH DAMAGES.\ 
     855\ 
     856                     END OF TERMS AND CONDITIONS\ 
     857\page \ 
     858            How to Apply These Terms to Your New Programs\ 
     859\ 
     860  If you develop a new program, and you want it to be of the greatest\ 
     861possible use to the public, the best way to achieve this is to make it\ 
     862free software which everyone can redistribute and change under these terms.\ 
     863\ 
     864  To do so, attach the following notices to the program.  It is safest\ 
     865to attach them to the start of each source file to most effectively\ 
     866convey the exclusion of warranty; and each file should have at least\ 
     867the "copyright" line and a pointer to where the full notice is found.\ 
     868\ 
     869    <one line to give the program's name and a brief idea of what it does.>\ 
     870    Copyright (C) <year>  <name of author>\ 
     871\ 
     872    This program is free software; you can redistribute it and/or modify\ 
     873    it under the terms of the GNU General Public License as published by\ 
     874    the Free Software Foundation; either version 2 of the License, or\ 
     875    (at your option) any later version.\ 
     876\ 
     877    This program is distributed in the hope that it will be useful,\ 
     878    but WITHOUT ANY WARRANTY; without even the implied warranty of\ 
     879    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\ 
     880    GNU General Public License for more details.\ 
     881\ 
     882    You should have received a copy of the GNU General Public License\ 
     883    along with this program; if not, write to the Free Software\ 
     884    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA\ 
     885\ 
     886\ 
     887Also add information on how to contact you by electronic and paper mail.\ 
     888\ 
     889If the program is interactive, make it output a short notice like this\ 
     890when it starts in an interactive mode:\ 
     891\ 
     892    Gnomovision version 69, Copyright (C) year name of author\ 
     893    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\ 
     894    This is free software, and you are welcome to redistribute it\ 
     895    under certain conditions; type `show c' for details.\ 
     896\ 
     897The hypothetical commands `show w' and `show c' should show the appropriate\ 
     898parts of the General Public License.  Of course, the commands you use may\ 
     899be called something other than `show w' and `show c'; they could even be\ 
     900mouse-clicks or menu items--whatever suits your program.\ 
     901\ 
     902You should also get your employer (if you work as a programmer) or your\ 
     903school, if any, to sign a "copyright disclaimer" for the program, if\ 
     904necessary.  Here is a sample; alter the names:\ 
     905\ 
     906  Yoyodyne, Inc., hereby disclaims all copyright interest in the program\ 
     907  `Gnomovision' (which makes passes at compilers) written by James Hacker.\ 
     908\ 
     909  <signature of Ty Coon>, 1 April 1989\ 
     910  Ty Coon, President of Vice\ 
     911\ 
     912This General Public License does not permit incorporating your program into\ 
     913proprietary programs.  If your program is a subroutine library, you may\ 
     914consider it more useful to permit linking proprietary applications with the\ 
     915library.  If this is what you want to do, use the GNU Library General\ 
     916Public License instead of this License.\ 
    560917}