readme.txt

一个解RAR文件的开发库源码

UniquE RAR File Library v0.3.4
The free file lib for the demoscene
multi-OS version (Win32, Linux and SunOS)
18.03.2001

1.) About the URARFileLib

     The UniquE RAR File Library gives you the ability to access RAR archives
     (any compression method supported in RAR v2.0 including Multimedia 
     Compression and encryption) directly from your program with ease an by
     adding only 12kB (6kB UPX-compressed) additional code to your program. 
     Both 'solid' and 'normal' ('normal' is recommended for fast random access 
     to the files!) archives are supported. Memory-to-memory and disk-to-memory
	 decompression is supported. This FileLib is made for the demo scene, 
     so it's designed for easy use within your demos and intros. 
     Please read the "License.txt" to learn more about thow you may use URARFileLib
     in your productions. And for sure, there is absolute no warranty! If 
     you loose a compo because the filelib dont work, don't blame me, better use an other
     file lib before you enter a compo if you don't trust this peace of software. Again,
     YOU USE IT AT YOUR OWN RISK. Delete all files from the URARFileLib archive from your
     storage device and stop reading.

     Still reading? Good, thank you giving URARFileLib a try. Please
     check http://www.mountpoint.ch/unique/project/urarfilelib/ for a newer
     version before you complain about bugs. Else, I would be very happy to
     read your feedback with suggestions, criticism, wishes etc. Please mail
     me a link to your demo if it's done, I'd like to have a lookt at it!

             Regards
             Christian Scheurer aka. UniquE of Vantage
             [e-mail]


2.) Win32

     If you use Microsoft's Visual C++ v6.0 and Windows 2000 you shouldn't have
     any problem since the Win32 system used to develop the URARFileLib was this.
     See the example and you'll understand how it works. Make sure to include the
     urarlib.c and the urarlib.h file in your project and your project include path.
     From this moment, you should be able to compile your project and to access RAR
     archives with one line of code. The lib can be configured in with 'urarlib.h'.



3.) Linux (i386)

     The very first versions of URARFileLib where created on a SuSE Linux system
     before I continued the development under Win32. Johannes Winkelmann was so
     kind to make the URARFileLib compile and work under Linux again. Please see
     the ./linux - directory and have a look at the example. It is as easy as the
     Win32-version to use. And don't forget to configure the lib with 'urarlib.h'.



4.) SunOS

     We had the chance to make a SunOS version on the worstations at school. It
     is nearly the same as in the Linux version, but you *have to* define
     'NON_INTEL_BYTE_ORDER' because Motorola uses big endian encoding in its CPUs.
     Configure this also in the 'urarlib.h'.



5.) configuration / advanced settings

     Remove the "_DO_CRC32_CHECK" and "_DEBUG_LOG" definitions in urarlib.h if 
     you want a tiny program with a maximum of speed speed and minimal size.
     I suggetst letting the "_DO_CRC32_CHECK" definition in the release so
     you can detect and handle errors/data corruption and removing "_DEBUG_LOG"
     since I don't like software that writes logfiles somewhere without 
     acknowledgement. And it may also cause errors if i.e. the disk is write
     protected. But "_DEBUG_LOG" is a great thing for searching errors.
     Assembly extentions can be enabled by defining the symbol _USE_ASM.


6.) final words

     That's it. Thanks for reading this file. Please send me a link where I can
     download your production that uses the URARFileLib and give me a short 
     feedback if you want.

	e-mail       : [e-mail]
        my home      : http://www.mountpoint.ch/unique			
	vantage home : http://www.vantage.ch