From 60c1003845035ad4cd0e9ea50862bad7626faf0e Mon Sep 17 00:00:00 2001 From: Pixel Date: Sat, 21 Sep 2002 18:47:46 +0000 Subject: Added the Pcsx source. --- PcsxSrc/Docs/ChangeLog.txt | 255 ++++++++++++++++++++++++++++++++ PcsxSrc/Docs/CodingStyle.txt | 29 ++++ PcsxSrc/Docs/License.txt | 342 +++++++++++++++++++++++++++++++++++++++++++ PcsxSrc/Docs/Readme.txt | 189 ++++++++++++++++++++++++ PcsxSrc/Docs/ToDo.txt | 8 + 5 files changed, 823 insertions(+) create mode 100644 PcsxSrc/Docs/ChangeLog.txt create mode 100644 PcsxSrc/Docs/CodingStyle.txt create mode 100644 PcsxSrc/Docs/License.txt create mode 100644 PcsxSrc/Docs/Readme.txt create mode 100644 PcsxSrc/Docs/ToDo.txt (limited to 'PcsxSrc/Docs') diff --git a/PcsxSrc/Docs/ChangeLog.txt b/PcsxSrc/Docs/ChangeLog.txt new file mode 100644 index 0000000..4bd94cd --- /dev/null +++ b/PcsxSrc/Docs/ChangeLog.txt @@ -0,0 +1,255 @@ +ChageLog: + v1.3: + * Fixed icon colors for 15/16bits, thanks to jang2k (linuzappz) + + * Fix silly bug on PsxCounters.c for SPUasync (linuzappz) + + * Refixed the mdecs, more correct. PsxHw.c, Mdec.c, and small fixes on + WndMain.c/Plugin.c, thanks to jang2k (linuzappz) + + * Fix for some mdecs on MdecWrite1, Mdec.c, thanks to psychojak (linuzappz) + + * CVGS Mcds now are detected by file size, also fixes to SaveMcd, + and added support for .gme mcds, Sio.c, thanks to jang2k (linuzappz) + + * Fixed Pcsx title for some win32, small fix in Gte.c, and added + icons for win32 mcd dlg (still unanimated), WndMain.c, + thanks to jang2k (linuzappz) + + * Added rename syscall, PsxBios.c (linuzappz) + + * Fixed bug in MTC2 in linux define, Gte.c (linuzappz) + + * Minor fixes to GtkGui.c (linuzappz) + + * More to PsxBios.c (linuzappz) + + * Fixed bug when S_addr == 0 in Misc.c (linuzappz) + + * Now won't close the plugins if the user press escape more than once, + WinMain.c, plugin.c (linuzappz) + + * Added SPUasync support, thanks to Andy and Iori (linuzappz) + + * Removed the BREAK code, since the bios rom doens't handles it, + thanks to psychojak (linuzappz) + + * Some bugfixes to Gte.c, thanks to jang2k (linuzappz) + + * "hokuto no ken" / "Crash Bandicot 2" ... fix, thanks to Taka (linuzappz) + + * Renamed/rewrote some stuff for pcsx2 compat ;) (linuzappz) + + * Small speedups for Mdec.c (linuzappz) + + * Rewrote DisR3000A.c (linuzappz) + + * Improved and rewrote partially HLE stuff (linuzappz) + + * Rewrote the way we call syscalls (linuzappz) + + * Added in Gte.c SUM_FLAG to opcodes that didn't have it, thanks to Taka (linuzappz) + + * CdlPause Acknowledge irq timing changed to 0x40000, thanks to Taka (linuzappz) + + * Fixed bug in recBLTZAL and recBGEZAL, thanks to Taka (linuzappz) + + * Fixed bug in Sio.c, thanks to gunshinn (linuzappz) + + * Fixed bug in Hw.c, thanks to bilgerat (linuzappz) + + * Fixes to Gte.c, thanks to roor (shadow) + + v1.2: + * Added Reg2 to cdrStruct, for Reg2 == 0x18 (non-interrupted cmds) (linuzappz) + + * Fixed one bug in Counters, count < 0 (linuzappz) + + * Now the cursor will be hidden in Win32 after OpenPlugins. (linuzappz) + + * Refixed Getlocl (linuzappz) + + * Fixed recJALR, 31 for _Rd_ (linuzappz) + + * Fixes to Gte.c (linuzappz) + + * Optimized iR3000A.c for speed (linuzappz) + + * Rewritten branch opcodes on iR3000A.c and removed cache stuff (linuzappz) + + * PRevID changed to 0x2, thanks to shadow (linuzappz) + + * Added PADstartPoll and PADpoll support, thanks to gunshinn (linuzappz) + + * Speed improvements to iR3000A.c (linuzappz) + + * Rewrote the cycles tests stuff, removed the workaround that reseted to 0x80000000 + (linuzappz) + + * CDRgetBufferSub and fixes to CDREAD stuff, CdRom.c, plugins.c/h (linuzappz + + * Correct Mouse, AnalogJoystick and AnalogPad emulation, contributed by + gunshinn (linuzappz) + + * MOVZX and MOVSX to ix86.h and iR3000A.h (linuzappz) + + * Improved Memcard Dialog on Linux (linuzappz) + + * Counters again use BIAS (linuzappz) + + * Autodetect psx type should be fine now, Misc.c (linuzappz) + + * Removed nasm stuff (linuzappz) + + * Fixed VK_F10 in Plugin.c, WndMain.c (linuzappz) + + * LWC2/SWC2 now in Gte.c/h, Interpreter.c, iR3000A.c (linuzappz) + + * Fixed gte_Cxx in MVMVA, Gte.c (linuzappz) + + * Fixed a bug within PIC stuff, Plugin.c (win32 and linux) (linuzappz) + + * Rewrote bios_printf, Bios.c (linuzappz) + + * gtk_widget_hide changed for gtk_widget_destroy, thanks to lu_zero (linuzappz) + + * Fix for cpuIrq.cycle, now it won't freeze when reaching 0xffffffff, since + we now reset when reaches 0x80000000, Counters.c (linuzappz) + + * Counters 1 and 2 (in mode 0x100) should be a little more accurate now (linuzappz) + + * Made workaround for Gran Turismo, WndMain.c, ConfigurePlugins.c, LnxMain.c, + Config.c, GtkGui.c (linuzappz) + + * cp2NCLIP added in iGte.asm (linuzappz) + + * Fixed some bugs on Memory.c (memset to memLUT) and ConfigurePlugins.c + (strlen("HLE") + 1), thanks to Taka (linuzappz) + + * Refixed XA quality, now should be perfect always, Decode_XA.c, and a bug on + the spu dma is now fixed, Dma.c, thanks to Iori for this (linuzappz) + + * Fixed a bug in cp2MTC2 in iGte.asm, movsx now used (linuzappz) + + * cdReadTime is now divided by 75, thanks to calb, and the CDREAD_INT is set + on a irq reset, CdRom.c/h (linuzappz) + + v1.1: + * Fixed a bug in R3000A.c, hwReset() after the cpuIrq reset (linuzappz) + + * Refixed RootCounters, still need to clean, Counters.c (linuzappz) + + * Fixed XA quality, still in some games quality is not perfect (maybe cdrom bug) + Decode_XA.c (linuzappz) + + * Reset var is now unused in CdRom.c, instead cdr.Ctrl is now used (linuzappz) + + * Small speedup for Hw.c, Sio.c/h (linuzappz) + + * Added cdrRead2 handling and fixed cddma, thanks to shunt, CdRom.c (linuzappz) + + * Cleaned a bit Memory.c, R3000A.c and Hw.c (linuzappz) + + * Support for VGS Memory Card Format (*.mem), Sio.c (linuzappz) + + * Rewrote cdirq handling, CdRom.c/h, R3000A.c (linuzappz) + + * Speed up on iR3000A.c code for cop2 (linuzappz) + + * Improved cdrom decoder and cdirq handling, CdRom.c/h (linuzappz) + + * Cleaned error checking on plugins.c/h (linuzappz) + + * Improved SysPrintf as SysMessage, System.h, LnxMain.c, WndMain.c (linuzappz) + + * Added sioInterrupt call, for cleaner code, Sio.c/h, R3000A.c (linuzappz) + + * Cleaned a little initial regs, R3000A.c (linuzappz) + + * Fixes to Dma stuff (HW_DMA_PCR is now used), hwDma3 set now only to + (chcr) 0x11000000 and 0x11400100, Hw.c, CdRom.c (linuzappz) + + * Added status seek flag to SeekL and SeekP, CdRom.c (linuzappz) + + * Icon animated support for McdDlg, GtkGui.c, Sio.c/h (linuzappz) + + * Gettd now returns frame too, CdRom.c (linuzappz) + + * Fixed bug in CdlPlay, CdRom.c (linuzappz) + + * SPUupdate interface support Counters.c/h, plugins.c/h (linuzappz) + + * Added CDRCMD_DEBUG flag in Debug.h, for CdRom.c cmd debug only (linuzappz) + + * AUTOPAUSE stuff improved on Cdrom.c (linuzappz) + + * Icon stuff and more on McdDlg, WndMain.c/GtkGui.c, Sio.c/h (linuzappz) + + * Fixed PsxAuto buf in Misc.c (linuzappz) + + * Memory Card Manager improved to handle blocks, still need + lotta work, WndMain.c/GtkGui.c, Sio.c/h (linuzappz) + + * Fixed in LoadCdrom the System.cnf a bit more (linuzappz) + + * Added Unused data to freeze functions and fixed LoadState to fail only for + STvX (linuzappz) + + * More fixes to Gte.c, added another gte debug in Debug.h/WndMain.c + + * Fixed a bug in RemoveCmdQueue, CdRom.c (linuzappz) + + * Fixed Registry compatibility between versions in Win32, ConfigurePlugins.c + (linuzappz) + + * Gte.c: total rewrite. Rage racer,Ridge racer,Bloady roar,Ridge racer 4 + now WORKS!!! (some small problems still althought ;p) + Bios.c: some more comment opcodes to biosInit.(i think that all exists now) + (shadow) + + * Bios.c: fixed ResetEntryInt & HookEntryInt (hex was opposite) + add some names to BiosInit (commented) + A0:3b, A0:3c, A0:4a, A0:4c, added (shadow) + + * Added LoadCdrom(), for HLE cdrom support, Misc.c, LnxMain.c, GtkGui.c, + WndMain.c (linuzappz) + + * More to Bios.c: longjmp, mem2vram (thought that might fix some demos + but not. Maybe need a recheck..), InitPAD + biosInterrupt (some changes.. + Not seems to work okay.. but dunno..), bios_GPU_dw (probably buggy need a + recheck), bios_atoi, bios_atol, bios_index, bios_rindex, bios_strchr, + bios_strrchr, bios_strpbrk, bios_strspn, bios_strcspn, bios_strtok, + bios_strstr. + And add some names of bios opcodes to the table.(commentted) (shadow) + + * Bios.c, added: SendGPU, StartPAD, GPU_SendPackets, GPU_GetGPUStatus, + toupper, tolower, bcopy, bzero, bcmp (shadow) + + * Now you can change Bios and Plugins Path, in both Win32/Linux, + ConfigurePlugins.c, Config.c, plugins.c, Wnd/LnxMain.c, Memory.c, (linuzappz) + + * StatesC in Linux same as Win32, Plugin.c (linuzappz) + + * Fixed rcntRcount, removed one BIAS, Counters.c (linuzappz) + + * Added CheckCdrom() after you change a cdrom, Cdrom.c (linuzappz) + + * Fixed iMdec.asm, still need to fix colours, they aren't 100% right (linuzappz) + + * F8 now set to make a snapshot (linuzappz) + + * Added bios syscalls names in Bios.c/R3000A.c (linuzappz) + + * GetTD and GetTN cmds are now non-blocking and added error code, + CdRom.c (linuzappz) + + * Simplified queuing code and now reads are done like cmds (instead of + using the synk stuff), CdRom.c/R3000A.c (linuzappz) + + * Made a workaround for iso cdrom plugins, when they changed the dir, + Plugin.c/WndMain.c (linuzappz) + + * Fixed bug in CdRom.c (gcc3 support) (linuzappz) + + v1.0: + * First source code public release. \ No newline at end of file diff --git a/PcsxSrc/Docs/CodingStyle.txt b/PcsxSrc/Docs/CodingStyle.txt new file mode 100644 index 0000000..4b44c97 --- /dev/null +++ b/PcsxSrc/Docs/CodingStyle.txt @@ -0,0 +1,29 @@ +## PCSX CODING STYLE + +typedef struct { // { within struct + int i; +} name; + +void func(int i) { // { within func declaration + if () { // same + switch () { // same + default: + printf(); // 1 tab per level (considering the default and the code in it + // as diferent ones + } + } + + for (;;) { // same for while + } +} + +Also try to align the code: + Something = x; + AnotherThing = x; +but not always: + i = x; + Something = x; + +tab = 4 +indent = 4 + diff --git a/PcsxSrc/Docs/License.txt b/PcsxSrc/Docs/License.txt new file mode 100644 index 0000000..7d1f860 --- /dev/null +++ b/PcsxSrc/Docs/License.txt @@ -0,0 +1,342 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. + + diff --git a/PcsxSrc/Docs/Readme.txt b/PcsxSrc/Docs/Readme.txt new file mode 100644 index 0000000..a8deded --- /dev/null +++ b/PcsxSrc/Docs/Readme.txt @@ -0,0 +1,189 @@ + Pcsx - Pc Psx Emulator + ---------------------- + +Contents +-------- + +1) General +2) How it works +3) Supported games +4) TroubleShoot +5) Credits + +-------------------------------------------------------------------------------- + +1) General + ------- + +Pcsx is a PSX emulator. What that really means? It means that it emulates the +way that a PSX works and tries to translate PSX machine language to PC language. +That is very hard to be done and we can't speak for 100% success in any time. +The hardware would always be better than the software so if you wanna play games +then better get a real PSX. Pcsx is capable to run many games, but may others +don't. We are working on it ;). The members of the team are very advanced coders +and they will continue the work on the Pcsx as far as they have enough time to +work on it. Real life comes first and sometimes it is much more demanding. + +The team of Pcsx + +-------------------------------------------------------------------------------- + +2) How it works + ------------ + +Steps: +------ + 1) Put a bios on bios directory (recommended: scph1001.bin) (optional) + 2) Put plugins in plugin directory + 3) Open the emu + 4) Configure plugins from configuration menu and Memcards from Mcd Manager + 5) Restart + 6) Put a cd in your cdrom drive + 7) Press Run CD and the game might work ;P + +Quick Keys: +---------- + F1: Save State + F2: Increase State Num + F3: Load State + F4: Show State-Pic + F5: Sio Irq Dis/Enable + F6: Black&White Mdecs Dis/Enable + F7: Dis/Enable Xa + F8: Makes a Snapshot + The 2 next keys are only implemented if the cdrom plugin doesn't support + the CDRgetStatus interface. + F9: Press to simulate an open case (to change cdroms in game) + F10: And this to close it + +Cpu Options: +----------- + * Disable Xa Decoding: + Disables xa sound, if you don't want sound this might + speed up a little movies (mostly) and the game itself. + + * Sio Irq Always Enabled: + Enable this only when pads or memcards doesn't works, + but usually brokes compatibility with them. + + * Spu Irq Always Enabled: + May help your game to work, but usually doesn't helps. + + * Black & White Movies: + Speed up for slow machines on movies. + + * Disable CD-DA: + Will disable CD audio. + + * Enable Console Output: + Displays the psx text output. + + * Enable Interpreter Cpu: + Enables interpretive emulation (recomiler by default), + it may be more compatible, but it's slower. + + * Psx System Type: + Autodetect: Try to autodetect the system. + NSTC/PAL: Specify it for yourself. + +Internal HLE Bios: +----------------- + If you select this instead of a regular bios (ie. "scph1001.bin") + Pcsx will emulate the bios (this might not work in all cases but it is + quite advanced), you can try it and see which one works better, notice + that the HLE bios might be faster than a regular one and may make some + games work better. + +-------------------------------------------------------------------------------- + +3) Supported Games + --------------- + +Here is a small list with games that pcsx support. Notice that it might have +some glitches on sound or gfx but it is considered playable. :) + + Crash Bandicoot 1 + Time crisis + Mickey Wild adventure + Coolboarders 3 + Street fighter EX+a + Street fighter EX2 plus + Breath of fire 3 + Breath of fire 4 + Quake II + Alone in the Dark 4 + Tekken 3 + +and probably lots more. +Check www.psxfanatics.com or www.ngemu.com for compatibility lists. + +------------------------------------------------------------------------------------------------ + +4) Troubleshoot + ------------ + + -QUE: My favourite game doesn't work + -AN: Wait for the next release, or get another emu ;) + -QUE: Can I have a bios image? + -AN : No + -QUE: CD audio is crappy... + -AN : If it doesn't work then disable it :) + +------------------------------------------------------------------------------------------------ + +5) Credits + ------- + +PCSX is the work of the following people: + +main coder: + Linuzappz , e-mail: linuzappz@pcsx.net +co-coders: + Shadow , e-mail: shadow@pcsx.net +ex-coders: + Pete Bernett, e-mail: psswitch@online.de + NoComp , e-mail: NoComp@mailcity.com + Nik3d , e-mail: +webmaster: + Akumax , e-mail: akumax@pcsx.net + +Team would like to thanks: +-------------------------- +Ancient :Shadow's small bother for beta testing pcsx and bothering me to correct it :P +Roor :for his help on cd-rom decoding routine :) +Duddie, +Tratax, +Kazzuya :for the great work on psemu,and for the XA decoder :) +Calb :for nice chats and coding hits ;) We love you calb ;) +Twin :for the bot to #pcsx on efnet, for coding hints and and :) +Lewpy :Man this plugin is quite fast! +Psychojak :For beta testing Pcsx and donating a great amount of games to Shadow ;) +JNS :For adding PEC support to Pcsx +Antiloop :Great coder :) +Segu :He knows what for :) +Null :He also knows :) +Bobbi +cdburnout :For putting Pcsx news to their site and for hosting.. +D[j] :For hosting us ;) +Now3d :For nice chats,info and blabla :) +Ricardo Diaz:Linux version may never have been released without his help +Nuno felicio:Beta testing, suggestions and a portugues readme +Shunt :Coding hints and nice chats :) +Taka :Many fixes to Pcsx +jang2k :Lots of fixes to Pcsx :) + +and last but not least: +----------------------- +James : for all the friendly support +Dimitris: for being good friend to me.. +Joan: The woman that make me nuts the last couple months... + +------------------------------------------------------------------------------------------------ + +Official website: http:/www.pcsx.net + +If I forgot someone beat me :P +"What you feel is what you are,and what you are is beatiful." +Log off +Shadow/ Linuzappz + diff --git a/PcsxSrc/Docs/ToDo.txt b/PcsxSrc/Docs/ToDo.txt new file mode 100644 index 0000000..9555b72 --- /dev/null +++ b/PcsxSrc/Docs/ToDo.txt @@ -0,0 +1,8 @@ +To do for Pcsx: + * Continue Bios emulation. (linuzappz) + * Fix CdRom code. (linuzappz) + * Fix Gte and speed it up, convert it to fixed point. + * Check Sio in games that don't work. + * Port to other platforms and cpus. + * NetPlay support. + * Finish the Memory Card Manager (only last for win32). -- cgit v1.2.3