From: Shamus Hammons Date: Thu, 5 Feb 2004 15:25:57 +0000 (+0000) Subject: 1.0.7 update X-Git-Tag: 1.0.7~67 X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=cf2ca159d3c52d318c0d4a166373dbe626a108e1;p=virtualjaguar 1.0.7 update --- diff --git a/INSTALL b/INSTALL index 9825915..d61565e 100644 --- a/INSTALL +++ b/INSTALL @@ -1,3 +1,4 @@ +--------------------------------------------- Virtual Jaguar v1.0.7 GCC/SDL release INSTALL --------------------------------------------- @@ -16,10 +17,6 @@ requirements for compiling the sources: Optionally you need a Atari Jaguar (CD) boot ROM which is available on the Internet. We can't include the boot ROM since it's still copyrighted. -Also, I would recommend that you have at least 20MB of free space. The .o's -can be quite big and the binary is likely to be about a 1.5MB in size (with -UPX and/or strip this could downsize to about 400K). - COMPILING: If you sure you have the minimum software requirements, you can safely compile diff --git a/Makefile.unix b/Makefile.unix index 1471ee0..e5bb302 100644 --- a/Makefile.unix +++ b/Makefile.unix @@ -27,9 +27,9 @@ CFLAGS = -Wall -Wno-switch -Wno-non-virtual-dtor -O2 -D$(SYSTYPE) -Dstricmp="str LDFLAGS = $(CFLAGS) -LIBS = -L/usr/local/lib `sdl-config --libs` -lstdc++ -lz -l$(GLLIB) +LIBS = -L/usr/local/lib -L/usr/lib `sdl-config --libs` -lstdc++ -lz -l$(GLLIB) -INCS = -I. -Isrc -Isrc/include -I/usr/local/include +INCS = -I. -Isrc -Isrc/include -I/usr/local/include -I/usr/include THECC = $(CC) $(CFLAGS) $(INCS) diff --git a/Makefile.win32 b/Makefile.win32 index 21480fb..ebcc4d0 100644 --- a/Makefile.win32 +++ b/Makefile.win32 @@ -27,9 +27,9 @@ CFLAGS = -Wall -Wno-switch -Wno-non-virtual-dtor -O2 -D$(SYSTYPE) -Dstricmp="str LDFLAGS = $(CFLAGS) -LIBS = -L/usr/local/lib `sdl-config --libs` -lstdc++ -lz -l$(GLLIB) +LIBS = -L/usr/local/lib -L/usr/lib `sdl-config --libs` -lstdc++ -lz -l$(GLLIB) -INCS = -I. -Isrc -Isrc/include -I/usr/local/include +INCS = -I. -Isrc -Isrc/include -I/usr/local/include -I/usr/include THECC = $(CC) $(CFLAGS) $(INCS) diff --git a/docs/README b/docs/README index e3574da..5196209 100644 --- a/docs/README +++ b/docs/README @@ -1,33 +1,83 @@ +-------------------------------------------- Virtual Jaguar v1.0.7 GCC/SDL release README -------------------------------------------- +-------------- - DISCLAIMER - +-------------- Or, "O liability, I do disclaim thee!" Ported by SDLEMU (Niels Wagenaar & Carwin Jones) and is based upon the -original work from Potato Emulation. For requirements please consult the -INSTALL file for more information about supported OS's and software -requirements. +original work by David Raingeard of Potato Emulation. For requirements please +consult the INSTALL file for more information about supported OS's and +software requirements. The use of this software is entirely at your own risk. We can't be held responsible for damage done to you hardware and/or software. This software requires the use of the Atari Jaguar (CD) boot ROM and/or Commercial ROM -images. You may only use the ROM images if you own the cartridges itself. -The use of Commercial ROMs without owning the original cartridge is illegal -in most countries and could result in fines and/or legal actions. +images. You may only use the ROM images if you own the cartridges itself. The +use of Commercial ROMs without owning the original cartridge is illegal in +most countries and could result in fines and/or legal actions. This software is released under the GPL license. For more information I direct you to the GPL.TXT. You may hack/change the code anyway you like. You may not -commercially sell this software. - -If you make changes, release the source code to the public and send us the -changes you made to the original authors. +commercially sell this software. If you make changes, release the source code +to the public and send the changes you made to the original authors. The products and brands used in these documents and/or sourcecode are owned by their respective companies. -- What is Virtual Jaguar GCC/SDL? +---------------------------------------------------------------- +- IMPORTANT NOTE ABOUT JAGUAR FILE FORMATS--READ THIS OR ELSE! - +---------------------------------------------------------------- + +There seems to be a lot of confusion surrounding the various file formats that +Jaguar programs come in, and a lot of this confusion seem to come from +Cowering's GoodJag renaming tool. Note that it simply gets some files wrong, +and it also incorrectly renames cartridge images with an extension that +belongs to an already established extension (.jag is a Jaguar Server +executable--read on). To clarify, there are basically four major types of +Jaguar binary images that are NOT cartridge images: + + .abs + .jag + .rom + .bin + +The first type, the .abs file, is a DRI/Alcyon format absolute location +executable. These come in two different flavors and contain load and run +addresses in their headers. Note that some files which have an .abs extension +are really incorrectly labelled .bin files with no header information +whatsoever. + +The second type, the .jag file, is a Jaguar Server executable. These files +contain header information that tells you where to load and run the file's +executable code. Note that as of this writing (1/1/2004) that the GoodJag ROM +renaming tool by Cowering incorrectly renames Jaguar cartridge ROM dumps to +have a .jag extension (a better choice, and the one supported by Virtual +Jaguar, is .j64)--if you're trying to run a ROM image with a .jag extension on +VJ, it will misinterpret it as a Jaguar Server executable and likely fail to +run. + +The third type, the .rom file, is an Alpine Board/ROM Image file. These files +have no header, but are known to load and run at $802000 in the Jaguar memory +space. Again, these are *different* from cartridge dumps since they load at a +higher address than a Jaguar cartridge. + +The fourth type, the .bin file, is simply a Jaguar executable with no header. +Since these files contain no information about where they load and execute, +Virtual Jaguar does not support this file type. Go bug the author to release +either a file with headers or a file in Alpine ROM format. Virtual Jaguar is +not omniscient! ;-) + +There is a fifth type of file that is supported by Virtual Jaguar, the .j64 +file, which is simply a 1, 2, or 4 Meg dump of a Jaguar cartridge ROM which +loads at $800000 in the Jaguar memory space. + +----------------------------------- +- What is Virtual Jaguar GCC/SDL? - +----------------------------------- Virtual Jaguar is software dedicated to emulating the Atari Jaguar hardware on a standard PC. The software was originally developed by David Raingeard of @@ -51,15 +101,18 @@ are particularly welcome! :) More information about SDL can be found at http://www.libsdl.org. -- Using Virtual Jaguar GCC/SDL +-------------------------------- +- Using Virtual Jaguar GCC/SDL - +-------------------------------- After compiling the binary (see INSTALL) you can now run original Atari Jaguar -games. These games are distributed on cartridges and can there for cannot be -used on a PC. To use these games on Virtual Jaguar GCC/SDL you need to get ROM -images. Besides the ROM images from commercial games you must also obtain the -Atari Jaguar (CD) boot ROM which you must copy to the BIOS directory. For legal -issues concerning ROM images please consult the DISCLAIMER at the beginning of -this file. +games. These games are distributed on cartridges and can therefore cannot be +used on a PC (we're still waiting for that Jaguar-on-a-PCI-card that you plug +into your late model PC, complete with cartridge slot ;-). To use these games +on Virtual Jaguar GCC/SDL you need to get ROM images. Besides the ROM images +from commercial games you must also obtain the Atari Jaguar (CD) boot ROM +which you must copy to the BIOS directory. For legal issues concerning ROM +images please consult the DISCLAIMER at the beginning of this file. After obtaining the Atari Jaguar (CD) boot ROM and several ROMs you can now use Virtual Jaguar using the following command: @@ -101,7 +154,9 @@ to change the key layout, simply edit the vj.cfg file and change the keys. :) NOTE: There are quite a few keys mapped to debugging functions at present. You have been warned! -- Finally +----------- +- Finally - +----------- If you find bugs, enhance the code or simply have questions, drop us an e-mail at sdlemu AT ngemu DOT com or drop a message on the SDLEMU Official Forum. diff --git a/docs/TODO b/docs/TODO index 61d997d..2afb3a7 100644 --- a/docs/TODO +++ b/docs/TODO @@ -1,6 +1,10 @@ Stuff to add/fix for the next release of Virtual Jaguar ------------------------------------------------------- +- It would be nice to have the emulator pick up where you last left off, or at + least give you the option of continuing from your last session. This would + require save states, 'natch. ;-) [Shamus] +- Cycle accuracy for GPU/DSP/OP/Blitter. [Shamus] - Need to propogate blitter fixes in the A1 <- A2 direction to the A1 -> A2 direction and the GPU fixes to various instructions to the DSP. [Shamus] - It would be nice to have "save states" for instant save/load capability.