Pvr2Image v.1.1 converter ( .pvr --> .png/.tga/.bmp)

[VincentNL]

Due to NaomiLib experience, had to learn how obscure .PVR formats were processed and convert them to RGBA formats.
A number of types which existed in SDK (alias,BGRA,bump,YUV420), were never addressed by existing converters so just decided to write one to cover all official variations.

Pvr2Image is a very simple app that converts every .PVR type in standard RGBA images (.png by default) without efforts!

* Select one or multiple .PVR / .PVP and choose an extraction folder, you'll get .png and .act files, that's all!

Win release:
https://github.com/VincentNLOBJ/pvr2image/releases

Git:
https://github.com/VincentNLOBJ/pvr2image

Pip:

Code: Select all

pip install pvr2img==1.1.0

Credits to:
* Egregiousguy for YUV420 to YUV420p conversion
* Kion for VQ handling and logic
* tvspelsfreak for SR conversion info on Bump to normal map

Supported PVR types

Code: Select all

[Texture Format:]

ARGB_1555
RGB_565
ARGB_4444
YUV_422
BUMP
RGB_555
ARGB_8888
YUV_420

[Pixel Format]:

TWIDDLED
TWIDDLED_MM
VQ
VQ_MM
PALETTIZE4
PALETTIZE4_MM
PALETTIZE8
PALETTIZE8_MM
RECTANGLE
STRIDE
TWIDDLED_RECTANGLE
ABGR
ABGR_MM
SMALLVQ
SMALLVQ_MM
TWIDDLED_MM_DMA

[colgate]

This is awesome!

[ateam]

Great work, man! Thank you for this.

[cbnj]

This little thing will ease much work for extracting textures, i have a question tough.. does automatically un-prs the zombie revenge pvr textures at converssion? Probably this question is more related to the pvr extractor.

[PkR]

Hi Vincent, thank you for your work. I haven't seen YUV420 supported previously, but all the other pixel codecs were added in a VRSharp fork in the Shenmue modding SDK several years ago: https://github.com/Shenmue-Mods/Shenmue ... elCodec.cs

Using those as a base with some fixes, recently Texture Editor in SA Tools was updated to handle all of those pixel codecs as well, again except YUV420.

I think it would be a good idea to have a set of sample textures to test various PVR texture formats. I can contribute samples of almost all those pixel and data formats, but I've never seen an actual NJD_TEXFMT_ABGR and NJD_TEXFMT_ABGR_MM texture, have you seen any games using this format?

[VincentNL]

Hi Vincent, thank you for your work. I haven't seen YUV420 supported previously, but all the other pixel codecs were added in a VRSharp fork in the Shenmue modding SDK several years ago: https://github.com/Shenmue-Mods/Shenmue ... elCodec.cs

Using those as a base with some fixes, recently Texture Editor in SA Tools was updated to handle all of those pixel codecs as well, again except YUV420.

I think it would be a good idea to have a set of sample textures to test various PVR texture formats. I can contribute samples of almost all those pixel and data formats, but I've never seen an actual NJD_TEXFMT_ABGR and NJD_TEXFMT_ABGR_MM texture, have you seen any games using this format?

Thanks for reporting!
Would had loved to have known about SM VRSharp before diving into all the Twiddle VQ and Bump SDK refs, my solution for twiddle came from predetermined autodetect LUT tables for standard and stride, so I'm curious to look into yours!



As per 0xE texture mode, commonly referred as BMP or BGRA can be found as uncompiled .PVR in below mentioned SDK path:

Code: Select all

SDKs\R10.1\Sample\Kamui2\k2Mask

For any tests, let us move our discussion to Discord:
https://discord.gg/PCXJYtt3

This little thing will ease much work for extracting textures, i have a question tough.. does automatically un-prs the zombie revenge pvr textures at converssion? Probably this question is more related to the pvr extractor.

Prs compression is well known and supported by other tools afaik, so decompress to buffer before reading should be enough I suppose.
May look into that as an extra parameter if there's enough interest

[TapamN]

I wrote a DC texture encoder and compressor that supports all formats the hardware supports (including some formats not supported by tvspelsfreak's convertor), and it can output previews of the resulting texture. The previews are generated by decoding the resulting texture data, so it has a built-in texture decoder for this that might have saved you some trouble. The preview even converts DC spherical normal maps to cartesian normals. It doesn't currently have support for directly converting .PVR to PNG or anything, but it was on the todo list.

The converter is mainly intended to output it's own format, which has more features than .PVR, but it does have some support for generating .PVR files (including small VQ textures), since I used PVR Viewer to help test the output before I had the decoder working and tested. (I found out PVR Viewer's handling of VQ YUV is bugged...) There might be some bugs in the generated .PVR header, though, since I've only tested the resulting files in PVR Viewer.

[VincentNL]

@Pkr @TapamN, did you find any documentation regarding masks?

Texture Mode: [ Ninja /Naomi]

Code: Select all

NJD_TEXFMT_TYPE_MASK / NM_TEXTURE_FORMATMASK          	(0xFF00)
         

Pixel Mode: [ Ninja /Naomi]

Code: Select all

NJD_TEXFMT_COLOR_MASK / NM_TEXTURE_PIXELMASK		(0xFF)

[PkR]

Those are bit masks. They're only used to separate pixel and data format values from each other because those are packed into a single 2-byte value.