           Cv 5.1 - The viewer for game grapix and archives
                   (c) 1996-2000 by TeLAMoN of 2XS
           ------------------------------------------------
                     
This program and all add-ons are freeware. Do not redistribute it for commercial
purposes without the express written consent of the author ! Feel free to copy
and spread the files as long as they are unmodified. 

The published sources may be used for free as long as credit is given. Any
changes should be reported to the author. If you want to create your own
extensions for the Cv5 tool please give any feedback.

If you have any questions, statements or whatever feel free to contact the author
under the.TeLAMoN@gmx.net or visit my homepage under
http://www.cs.tu-berlin.de/~mickyk/cv.html. 

Changes:
--------
08/30/2000
Removed the "Unforeseen consequences..."-bug within the acvmpq.dll, 
that occurs with some d2-mpq's. Also there is a new cvdc6.dll included.

08/28/2000
Removed the bug, that crashes the acvMPQ.dll with some d2-mpq's

08/26/2000
Some improvements on the memory-management. Should work some stadier now.

07/21/2000
Fixed the bug, that deletes the last per RMB extracted file from an archive.

06/20/2000
Fixes the bug, that freezes the browser, after extracting a file with right-click and 
changes the mpq-logic again, 'coz the old mpq's doesn't include a filelist. So I've
mixed the old with the new logic. Sorry for the inconveniences.

06/13/2000
I've changed the mpq-logic. You don't need the f***ing data-files any longer! Thanx to
Justin Olbrantz(Quantam)[mailto:omega@dragonfire.net] and his mopaq api. I've got the idea
from his documentation. 

File-contents:
--------------
The delivered zip-archive should include:

cv.ini               -  config file
Cv5.exe              -  main program                        <---- new release 08/26/2000
diablo.pal           -  default palette
readme.txt           -  this document
AddOns/cvbmp.dll     -  Addon Bitmaps
AddOns/cvgif.dll     -  AddOn GIF's
AddOns/cvtga.dll     -  AddOn TGA's
AddOns/cvjpg.dll     -  AddOn JPG's
AddOns/cvpcx.dll     -  AddOn PCX's
AddOns/cvcel.dll     -  AddOn Cel's (diablo)
AddOns/cvcl2.dll     -  AddOn Cl2's (diablo)
AddOns/cvdc6.dll     -  AddOn Cel's version 6 (Diablo II)
AddOns/cvgrp.dll     -  AddOn Grp's (starcraft)
ArcOns/acvmtf.dll    -  AddOn MTF-archivs (darkstone)
ArcOns/cvmpq.dll     -  AddOn MPQ-archivs (Blizzard-stuff)  <---- new release 08/26/2000
ArcOns/mpqdata/*     -  some data-files for the old mpq-files (diablo/starcraft)
ArcOns/mpq.ini       -  inifile for working with the old mpq's
Temp/                -  Temp-folder

More addons may be found on my webpage. Take frequently a look. Please be sure you
have the folder-structure as above described after extracting the zip-archive.

How to use it
-------------
After starting the Cv5.exe you may browse your drives for valid files or archives.
Archives can be browsed in the same way as folders. If you have found a supported
file select it and look at the bottom of the browser-dialog. There you'll find
some information about the selected file. If it is supported you'll find it's 
contents in the frame-list on the right side of the browser-dialog. Select the 
frame(s) you want to view and press the view button. 
Or doubleclick on the file you want to see. ;)=)
If you have a file with more than one frame you can animate them. Please enter the
start- and end-frame in the "frame-from" and "to" controls and push the play-button.
Change the play-speed by using the "+" and "-" controls or enter the value directly.

Palette:
Most gfx-files will support their own palettes. If not, the loaded palette will be used
(diablo.pal by default). You can change the palette by loading a different one by
selecting the "load" button.
!!! - NEW - !!!
If you try to load a Diablo II palette be sure to check the DiabloII flag in the palette
dialog 'coz D2-palttes have flipped r(ed) and b(lue) components.

TRN:
TRN's are color-translation-tables. Use them to flip the palette-indices from the loaded
default palette (TRN'S have no influence on palettes delivered by the gfx-files!!!).
It's used for Diablo(TM) to create other-colored units or uniques.

Save:
Use the save-button at top to save single frames and the save-button in the animator
to save the selected animation (or multi-frame-file) as it is supported by the 
addOns.

Scipts:
Scripting is very experimental !!! Use it carefully. Scriptfiles are for animations only.
A script-file may contain the following lines:

// this is a comment
01
02
03
03 MIRROR_X
02 MIRROR_X
01 MIRROR_X
01 MIRROR_Y
02 MIRROR_X MIRROR_Y

That means the animator will play the frames 01-03 and then the frames 03-01 mirrored on
the x-achsis then the frame 01 mirrored on the y-achsis and at last the frame 02 mirrored
on the x- and y-achsis. After that he will start at top.

Be carefull !!! The animator will NOT check, if the selected frame is valid !!! If you want
the animator to play frame 08 mirrored on X and the file contains only 6 frames the Cv5 will
crash.

Ok, if you have more questions please contact me.

Ohh, at least one feature that may be usefull - if you are browsing an archive and want to
extract one file use your RIGHT mouse-button on that file and select a path where to store
it. It will get its original file-name.


  ___________________  ___      ____  _____________  _________________
 /______   _________/\/  /\    /    \/\   __   __  \/\______________  \
 \     /  /\_____   \/  /  \  /  /\  \ \  \ \  \ \  \/ _______  __ /\  \
  \___/  / /  __/\__/  /   / /  /__\  \ \  \ \__\ \  \/\  ___ \/\  \ \  \
     /  / /  /__\/ /  /__ / /  ______  \ \  \/  /  \  \ \ \_/\ \ \  \ \  \
    /__/ /______/\/______/\/__/\    /\__\ \__\_/\   \__\ \______\ \__\ \__\
    \  \ \      \ \      \ \  \ \__/ /  / /  /   \  /  / /     / /  /  /  /
     \__\/\______\/\______\/\__\/  \/__/\/__/     \/__/\/_____/\/__/ \/__/

__the.TeLAMoN@gmx.net______________________________________________________________06/20/2000
