fastman92 IMG Console

[fastman92]

fastman92 IMG Console

 

 

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.

- - - - - - - - - - - - - - - - -

 

Download

 

***** 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 © 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: [email protected]

Visit fastman92-page.tk

Edited July 19, 2016 by fastman92

[ThirteenAG]

Damn, where were this tool when i tried to organize my 3.96gb gta3.img with IMG manager. Succeed though, splitted it with IMG manager 1.5, then organized with spark and img organizer, rebuilded all archives with img manager 2.0beta. One hell of a quest. But it's done and seems working, so... requesting IMG Organizer for GTA 3 and VC

Edited September 12, 2012 by ThirteenAG

[headmetalbanger]

Cool, thanks 'fastman92', (respect)

[fastman92]

I released fastman92 IMG Console 1.1, there are many fixes and added new possibilities.

[direstraits]

Now i use this for modify VC because of the multiple replace function.

 

Good work.

 

5x

[ThirteenAG]

I noticed a bug:

 

-open "models/gta3.img"-export "null.dff" "models/exported/null.dff"

 

If null.dff doesn't exist, console just crashes. gta3.img v.1 from GTA3.

[fastman92]

Thanks for the info.

 

fastman92 IMG Console 1.2 has been released.

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

 

Concerning the IMG Organizer for GTA 3 and GTA VC, there is one more thing to do:

 

IMG & Stream Limit Adjuster for GTA VC.

Until breaking the limitation of amount of IMG archives, only 8 IMG archives may be loaded in GTA VC. One archive is always loaded - gta3.img

By now your IMG organizer shouldn't create more than 7 additional archives and put names in gta.dat, otherwise game will crash.

 

IMG & Stream Limit Adjuster is only available to GTA SA at the moment.

Edited September 22, 2012 by fastman92

[direstraits]

Can you please add the following command?

 

-importfromfolder "C:\\Test"

 

It basically import all files from a folder to IMG archive.

 

One last thing, How comment a line? I tried this:

 

-open "gta3.img"//This will import hermes-import "hermes.dff"-import "hermes.txd"

 

 

But it says :

'-' expected, but '/' found.

 

[fastman92]

direstraits, thanks for reply.

 

fastman92 IMG Console 1.5 released:

 

- 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.

[HackMan128]

 

jeez, everywhere "fastman92" http://media.gtanet.com/gtaforums/images/html/emoticons/mercie_blink.gif

Anyway, isn't too much these IMG editors?

 

Oh my God, sorry for that post, I don't even know why I even wrote that bs.

The tool is great and have potential. Console feature, scripted quick work and light size is the main thing that proper modding needs.

 

Thank You and sorry once again.

Edited October 18, 2021 by HackMan128
Being young and crazy.

[fastman92]

 

jeez, everywhere "fastman92"

Anyway, isn't too much these IMG editors?

if you're about stuff then all of or projects below are different projects. Made for different purpose:

IMG C++ class: for programmers, to include in project solution.

Native IMG Builder - build IMG archive from directory structure like probably R★ did.

farman92 IMG Console - use commands to operate on archive.

 

IMG stream & limit adjuster - increase limit on number of IMG archives that a game can load.

IMG Organizer - splits big game archives into small archives with structure inspired by GTA IV.

[Logofero]

Only good thing is why the program does not accept console commands are passed as arguments without file script.txt?

Example I want to unpack the model simple bat file created extract.bat it added text:

fastman92ImgConsole32.exe -open "C:\\Games\\GTA-SA\\models\\gta3.img" -export "bullet.dff" "bullet_backup\\" -close

But in reality, this design does not work. Disappointing..

[fastman92]

Only good thing is why the program does not accept console commands are passed as arguments without file script.txt?

 

Example I want to unpack the model simple bat file created extract.bat it added text:

fastman92ImgConsole32.exe -open "C:\\Games\\GTA-SA\\models\\gta3.img" -export "bullet.dff" "bullet_backup\\" -close

But in reality, this design does not work. Disappointing..

 

Because IMG console doesn't support arguments like this.

[Logofero]

 

Only good thing is why the program does not accept console commands are passed as arguments without file script.txt?

 

Example I want to unpack the model simple bat file created extract.bat it added text:

fastman92ImgConsole32.exe -open "C:\\Games\\GTA-SA\\models\\gta3.img" -export "bullet.dff" "bullet_backup\\" -close

But in reality, this design does not work. Disappointing..

 

Because IMG console doesn't support arguments like this.

 

Why not enable console commands, simplify and expand its mission. The more that is named console img.

No console commands - specifically?

 

PS: I like its functionality but lack of support in the first cmd complicates the task.

 

Thanks for your work, I like your application

[fastman92]

 

 

Only good thing is why the program does not accept console commands are passed as arguments without file script.txt?

 

Example I want to unpack the model simple bat file created extract.bat it added text:

fastman92ImgConsole32.exe -open "C:\\Games\\GTA-SA\\models\\gta3.img" -export "bullet.dff" "bullet_backup\\" -close

But in reality, this design does not work. Disappointing..

 

Because IMG console doesn't support arguments like this.

 

Why not enable console commands, simplify and expand its mission. The more that is named console img.

No console commands - specifically?

 

PS: I like its functionality but lack of support in the first cmd complicates the task.

 

Thanks for your work, I like your application

 

Maybe in the future.

[Concavax]

Hi! i make a post about this problem but didn't response... anyway.

 

I have a problem with this tool.

 

I make a video that explain the problem.

 

https://drive.google...iew?usp=sharing

 

Resume:

Img console dint work with skin.img. Can export/import the file but cant rebuild the archive.
Maybe i do something wrong?

[fastman92]

New IMG console coming soon!

Expect a new functionality.

[fastman92]

Version 2.0 released!

 

Changelog:

 

** 2.0, 23-06-2015

- added complete support of fastman92 GTA SA IMG archives. Supported all features like compression and encryption.

- added full support of GTA IV IMG archives.

 

Look -help for new commands.

 

fastman92_GTASA IMG format requires my limit adjuster installed and "enhanced IMG archives" enabled in .ini configuration.

 

 

fastman92 IMG console, download: http://fastman92.ml/index.php/10-fastman92-img-console-2-0

Edited June 23, 2015 by fastman92

[miclin]

nice work.

[Hovac]

Why is there no support for Windows x64?

 

[fastman92]

Why is there no support for Windows x64?

 

You can use a 32-bit version.

I didn't make a 64-bit version because of ZLIB library that I couldn't afford to compile in 64-bit.

[ThirteenAG]

Tried to install GTA LC with 2.0, this happened:

 

With 1.9 everything's fine.

Edited July 8, 2015 by ThirteenAG

[KELASHI]

Maybe large archive support is broken. I tried to import a 4.41GB folder, but got a 4.00GB archive.

[fastman92]

Maybe large archive support is broken. I tried to import a 4.41GB folder, but got a 4.00GB archive.

Thanks for the report. I tried the same and there's something to be fixed.

 

// Edit: I fixed the problem.

I used a DWORD type instead of QWORD in one function.

please wait for IMG console 2.1

 

 

Tried to install GTA LC with 2.0, this happened:

 

With 1.9 everything's fine.

 

You have to create me files that will cause a crash.

 

Anyone, try a -hell command to fix the bugs. Should help.

Edited July 11, 2015 by fastman92

[Igor Bogdanoff]

Can I use your IMG Console in auto-instalator of VCLF mod. You name will be of course included in instalator

[fastman92]

Can I use your IMG Console in auto-instalator of VCLF mod. You name will be of course included in instalator

please wait until the end of today. Then you can.

 

What is VCLF mod?

Edited July 19, 2015 by fastman92

[Inadequate]

What is VCLF mod?

 

Vice City Leftovers Fix

[fastman92]

Version 2.1 released!

Changelog:

** 2.1, 19-07-2015
- removed a useless debugging code when opening the IMG archive version 3
- bug with saving a list of files in IMG version 1 or fixed.
- bug with setting the default encryption and compression type for IMG formats that haven't these features, fixed.
- fixed 8 TB IMG archive support.
- added setArchiveMetadataEncryption command

Look -help for commands.

fastman92_GTASA IMG format requires my limit adjuster installed and "enhanced IMG archives" enabled in .ini configuration.


fastman92 IMG console, download: http://fastman92.ml/index.php/11-fastman92-img-console-2-1


Tomasak, now you can use IMG console for your project, but remember to download the latest version available.

Edited July 19, 2015 by fastman92

[Igor Bogdanoff]

Ok, thanks. Btw this tool is really cool! Unlike others img editors this one is working like charm

Edited July 19, 2015 by Tomasak

[fastman92]

Ok, thanks. Btw this tool is really cool! Unlike others img editors this one is working like charm

Now it's working correctly as it should, has 100% (I hope) correct support of IMG archives, but has one disadvantage: it's a console application as the name implies.

You can also create script files.

I should make it GUI in the future.

Edited July 19, 2015 by fastman92