Update readme about dependencies, remove exe from repo
This commit is contained in:
parent
2b2ca87ca9
commit
52eedb68df
BIN
FreeImage.dll
BIN
FreeImage.dll
Binary file not shown.
14
README.md
14
README.md
|
@ -49,16 +49,14 @@ git clone https://github.com/ABelliqueux/blender_io_export_psx_mesh.git
|
||||||
|
|
||||||
3. Dependencies
|
3. Dependencies
|
||||||
|
|
||||||
Here are the dependencies you should have in your path :
|
These utilities should be in your [$PATH](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho#44272417) :
|
||||||
|
|
||||||
* [pngquant](https://pngquant.org/) : convert image to 4/8bpp palettized pngs
|
* [pngquant](https://pngquant.org/) : convert image to 4/8bpp palettized pngs
|
||||||
* [ffmpeg](https://ffmpeg.org/) : convert audio to WAV
|
* [ffmpeg](https://ffmpeg.org/) : convert audio to WAV
|
||||||
* [img2tim](https://github.com/Lameguy64/img2tim) : convert image to psx TIM
|
* [img2tim](https://github.com/Lameguy64/img2tim) : convert image to psx TIM - Win32 pre-built bin : https://github.com/Lameguy64/img2tim#download
|
||||||
* [wav2vag](https://github.com/ColdSauce/psxsdk/blob/master/tools/wav2vag.c) : convert WAV to psx VAG
|
* [wav2vag](https://github.com/ColdSauce/psxsdk/blob/master/tools/wav2vag.c) : convert WAV to psx VAG - Win32 pre-built bin : http://psx.arthus.net/tools/wav2vag-win32.zip
|
||||||
* [psxavenc](https://github.com/ABelliqueux/candyk-psx/tree/master/toolsrc/psxavenc) : convert WAV to psx XA
|
* [psxavenc](https://github.com/ABelliqueux/candyk-psx/tree/master/toolsrc/psxavenc) : convert WAV to psx XA - Win32 pre-built bin : http://psx.arthus.net/sdk/candyk-psx-tools.zip
|
||||||
* [xainterleave](https://github.com/ABelliqueux/candyk-psx/tree/master/toolsrc/xainterleave) : interleave psx XA files
|
* [xainterleave](https://github.com/ABelliqueux/candyk-psx/tree/master/toolsrc/xainterleave) : interleave psx XA files - Win32 pre-built bin : http://psx.arthus.net/sdk/candyk-psx-tools.zip
|
||||||
|
|
||||||
Windows executables are provided for convenience in this repo.
|
|
||||||
|
|
||||||
For users with **Imagemagick** installed, there is an option when exporting to use that instead of pngquant.
|
For users with **Imagemagick** installed, there is an option when exporting to use that instead of pngquant.
|
||||||
|
|
||||||
|
|
BIN
img2tim.exe
BIN
img2tim.exe
Binary file not shown.
69
img2tim.txt
69
img2tim.txt
|
@ -1,69 +0,0 @@
|
||||||
img2tim by Lameguy64 of Meido-Tek Productions
|
|
||||||
|
|
||||||
|
|
||||||
This tool converts almost any image file supported by FreeImage into a PlayStation standard TIM
|
|
||||||
texture image file. Made to replace the bmp2tim tool that came with the PsyQ SDK with additional
|
|
||||||
features not present in the original program.
|
|
||||||
|
|
||||||
The program itself is still a work in progress but its complete enough as a usable tool.
|
|
||||||
Alpha-blending options and better color-index conversion have yet to be implemented.
|
|
||||||
|
|
||||||
|
|
||||||
Option Details:
|
|
||||||
|
|
||||||
-b - Set semi-transparent bit on fully black pixels (ignored when -usealpha is specified).
|
|
||||||
|
|
||||||
If the semi-transparent bit on fully black pixels (R0 G0 B0) is set, the pixel will
|
|
||||||
be drawn opaque instead of transparent as fully black is treated by the PlayStation
|
|
||||||
as the transparent color by default.
|
|
||||||
|
|
||||||
-t - Set semi-transparent bit on non fully black pixels.
|
|
||||||
|
|
||||||
This basically enables the output image to be drawn as semi-transparent since
|
|
||||||
semi-transparency is only applied to pixels with the semi-transparency bit set.
|
|
||||||
If the bit is not set, the pixel is always drawn opaque unless its a fully
|
|
||||||
black pixel.
|
|
||||||
|
|
||||||
-org < x y > - Specifies the VRAM offset of the image.
|
|
||||||
|
|
||||||
Keep in mind that the width of the converted tim image may vary from the original
|
|
||||||
image's resolution depending on its color depth. 16-bit has no difference, 8-bit is
|
|
||||||
1/2 of the original and 4-bit is about 1/4 of the original. No offset checking is
|
|
||||||
done so its recommended to check the resulting tim file with timtool.
|
|
||||||
|
|
||||||
-plt < x y > - Specifies the VRAM offset of the CLUT.
|
|
||||||
|
|
||||||
CLUTs are usually 256x1 for 8-bit tims or 16x1 for 4-bit tims. No offset checking is
|
|
||||||
done so its recommended to check the resulting tim file with timtool.
|
|
||||||
|
|
||||||
-o < outFile > - Sets the name of the output file.
|
|
||||||
|
|
||||||
-usealpha - Use the alpha channel (if available) as a transparency mask.
|
|
||||||
|
|
||||||
Most useful when working with png image files that have an alpha channel and tools
|
|
||||||
that utilize it, the alpha channel is used as a transparency mask when converting an
|
|
||||||
image with an alpha channel.
|
|
||||||
|
|
||||||
-alpt < value > - Specifies the threshold value when using the alpha channel as a transparency mask.
|
|
||||||
|
|
||||||
If the alpha value of the pixel is less than the threshold (default: 127), the pixel
|
|
||||||
will be converted as transparent (pixel color replaced to fully black) and opaque if
|
|
||||||
above the threshold (pixel color intact).
|
|
||||||
|
|
||||||
-tindex < col > - Specify color index to be treated as transparent.
|
|
||||||
|
|
||||||
This option only applies to images that are 4-bit/8-bit palletized. Any pixel that has
|
|
||||||
the same color-index specified will be made transparent.
|
|
||||||
|
|
||||||
-tcol < r g b > - Specify RGB color value to be transparent.
|
|
||||||
|
|
||||||
Applies to both non-color index and color index images. Any pixel with a matching color
|
|
||||||
specified will be made transparent (replaced to fully black).
|
|
||||||
|
|
||||||
-bpp < bpp > - Specify the color depth for the output TIM file.
|
|
||||||
|
|
||||||
Currently, a simple color-search algorithm is used when converting images from non-indexed
|
|
||||||
color depths (24-bit/16-bit) to 8-bit or 4-bit and will fail if more than 256 colors are
|
|
||||||
found.
|
|
||||||
|
|
||||||
Supported output color depths: 4, 8, 16, 24
|
|
BIN
pngquant.exe
BIN
pngquant.exe
Binary file not shown.
Loading…
Reference in New Issue