PSXPREV - Playstation (PSX) File Previewer/Extractor
C# Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Classes Misc changes May 29, 2018
Contrib/DiscUtils-master
Forms
Properties
Shaders
packages
App.config
OpenTK.dll.config
PSXPrev.csproj
PSXPrev.csproj.user Misc changes May 29, 2018
PSXPrev.sln
Program.cs
README.md
packages.config Initial Commit Jan 12, 2017

README.md

psxprev - async version

PSXPREV - Playstation (PSX) File Previewer/Extractor

PsxPrev, a TMD/PMD/TIM PlayStation file scanner.

Sample This tool uses:
OpenTK - https://github.com/opentk/opentk
DiscUtils - https://github.com/DiscUtils/DiscUtils
Daniele de Santis Playstation Icons - http://www.danieledesantis.net/

You'll need to run it:
An OpenGL 3.0 compatible video card
.NET Framework 4.5
Treat it as an experimental release and use this tool as your own risk!
(The tool can use a big ammount of memory to scan the files, so, be careful.)
Usage:
PSXPrev folder/iso [filter] [-tmd] [-tmdAlt] [-pmd] [-tim] [-timAlt] [-tod] [-hmdmodels] [-log] [-noverbose]

  • folder/iso - folder where are the files to be scanned or an ISO file path to scan the ISO contents
  • filter - use this parameter to specify a filter of files to be scanned (eg: *.tod)
  • tmd - add this parameter to scan for tmd models
  • tmdAlt - add this parameter to scan for tmd models using an alternative parser
  • pmd - add this parameter to scan for pmd models
  • tim - add this parameter to scan for tim textures
  • timAlt - add this parameter to scan for tim textures using an alternative parser
  • tod - add this paramete rto scan for tod animations
  • hmdmodels - add this parameter to scan for hmd models (wip)
  • log - add this parameter to generate a scanning log text file
  • noverbose - add this parameter to dont show log on the console window
A console window will appear, the application will scan each byte of the files inside the folder/filter you specified trying to find the files types you specified, so, it can take a bit of time for this process to end.

After the scan has been completed, a new window will open, with the tabs:
Models: This is where you see the models that has been found on the scan
Textures: This is where you see the textures that has been found on the scan
VRAM Preview: This is where you have a replica of PSX Video RAM, which consist of 32 256x256 textures. You can use these pages to compose the final textures applied to the models.
Animations: This is a working in progress panel where you have animation list and controls, and a field to assign a loded entity to the animation preview.

Usage tips:
To Apply a Texture to a Model, first you have to look at the VRAM Page property of the Model you want to apply the Texture.After that have to draw the textures (at the VRAM Tab, called Draw to VRAM) on the desired VRAM Page (which is pre-defined in the Texture Properties area). After that, if you come back to the Model Tab, you may see your Model textured, if it has Uvs property enabled (True).
To Export a Model or Multiple Models, tick their checkboxes at the Model Tab, click at Export Selected button, select the desired Output Format and the Output Folder. (Textures and materials will be automatically exported)
To Export a Texture or Multiple Textures, select them at the Texture Tab, click at Export Selected button and select the desired Output Folder.

Known issues/limitations:
The two 3D exportable file formats has disadvantages, .OBJ files cannot have vertex color information, and .PLY files will group all the sub-models in one single model. I'm looking for a better format for the exporter. An experimental .OBJ exporter option with Vertex Color is available.
The tool will only find files that are explicitly conformant to the file formats it's looking for. Any compressed file cannot be scanned.

License (BSD License 2.0):
Copyright (c) 2018, Ricardo Reis
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.
* Neither the name of the nor the
names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.

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