**** FORK CHANGELOG ****
** 29th July 2023 (by LiquidSevens)
- forked from Bios-Marcel's archived repo
- updated stdafx.h to resolve compile errors
- compiled for x86 and x64, published both releases

========================================================================
    CONSOLE APPLICATION : fastman92 IMG Console Project Overview
========================================================================

AppWizard has created this fastman92 IMG Console application for you.

This file contains a summary of what you will find in each of the files that
make up your fastman92 IMG Console application.


fastman92 IMG Console.vcxproj
    This is the main project file for VC++ projects generated using an Application Wizard.
    It contains information about the version of Visual C++ that generated the file, and
    information about the platforms, configurations, and project features selected with the
    Application Wizard.

fastman92 IMG Console.vcxproj.filters
    This is the filters file for VC++ projects generated using an Application Wizard. 
    It contains information about the association between the files in your project 
    and the filters. This association is used in the IDE to show grouping of files with
    similar extensions under a specific node (for e.g. ".cpp" files are associated with the
    "Source Files" filter).

fastman92 IMG Console.cpp
    This is the main application source file.

/////////////////////////////////////////////////////////////////////////////
Other standard files:

StdAfx.h, StdAfx.cpp
    These files are used to build a precompiled header (PCH) file
    named fastman92 IMG Console.pch and a precompiled types file named StdAfx.obj.

/////////////////////////////////////////////////////////////////////////////
Other notes:

AppWizard uses "TODO:" comments to indicate parts of the source code you
should add to or customize.

/////////////////////////////////////////////////////////////////////////////


*****************************************************************************


=============================================================================
=                  fastman92 IMG Console 1.9 by fastman92                   =
=============================================================================
This open-source tool, easy to use IMG Console allows to create/modify GTA IMG archives with simplicity.
And two modes are available: interactive mode and script mode.
In interactive mode you can type commands from keyboard and execute in command prompt.
Script mode will be useful for modders who want to create automatic modification of IMG archives and depends on script file.
An application works with more one version of IMG archives:

• version 1 (GTA III, GTA VC, GTA III Mobile)
• version 2 (GTA SA)

IMG archive of max 8 terabytes is supported.
- - - - - - -  - - - - - - - - - -

***** Usage (after you installed mod)
• To run application in interactive mode just run fastman92ImgConsole32.exe/fastman92ImgConsole64.exe without any parameters.
• Type -help to get list of available commands.
• It's also possible to run script by specifying additional parameter as in example:
  fastman92ImgConsole.exe -script "myScript.txt"
  
***** Script syntax:
Each command is preceeded by '-' (dash)
Empty lines will be skipped.
// is used to comment line.

**** Example of script:
-open "test.img"
// -import "test.txt"
-import "my.txt"

-rename "my.txt" "look.txt"
-close
  
***** IMG limits:
128 MB - max filesize
8 TB - max .img archive size

IMG class used in tool can reach these limits with no errors.
  
**** Note:
C++ programmers may take (GTASA_CRC32.h, GTASA_CRC32.cpp, IMG.h and IMG.cpp) and use these files in newly compiled programs.

**** Changelog
** 1.9
- added new commands (rebuildIfArchiveWasModified, rebuildIfMoreUselessSpaceThanValueOrArchiveWasModified)
- design of IMG class was a bit modified

** 1.8
- added new command -printString
- fixed RootPath problem in script mode, file paths are relative to the directory with executed script
- IMG class recreated with std::list for ListOfEntries instead of indexes, it's better for programmers

** 1.7
- fixed crash when ImportFromDirectory command was executed on existing, but empty directory

** 1.6
- line numbers are displayed in case of command error in script mode
- application has got a console title
- implemented proper handling of binary IPL files, they're dependant on each other when adding/replacing
- fixed FindFirstEmptySpaceForFile, can return offset before the first file now

** 1.5
- fixed error with offsets occuring when there existed files of 0 length in IMG archive
- fixed crashing when command name was unexpectedly too long (buffer overflow)
- fixed comments, they work now, use // two slashes at the beginning of line
- added new command: -importFromDirectory "path\\to\\directory"
- added new command: -getAmountOfUnusedSpace
It imports all files from specified directory.

** 1.4
- fixed export command, second argument is directory path now.

** 1.3
- delete & rename commands crashed a console when specified file in IMG archive did not exist. Fixed.

** 1.2
- export command crashed a console when specified file in IMG archive did not exist. Fixed.

** 1.1:
- added -rebuild and -rebuildifmoreuselessspacethan commands
- added line numbers in script mode
- comments were introduced and require two slashes //
- empty lines in script file are being skipped now
- fixed RebuildArchive function in IMG class
- fixed GetSizeOfUnusedSpace function in IMG class

**** Thanks to:
Function-X for creating EXE icon.
JF-Mir2 for letting me to fix an error with incorrect DLLs for 64-bit Windows, when Microsoft C++ Reditributable is not installed
seggaeman for noticing error in help, unneccessary dashes before strings.
ThirteenAG for telling me of crashing bug when importing from existing, but empty directory.

Copyright (c) 2012, fastman92
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

***** Informations:
Date of release: 12-05-2013 (d-m-Y)
Author: fastman92
Version: 1.9
For: GTA San Andreas
E-mail: fastman92@gmail.com
Visit fastman92-page.tk