PS-Image

Multi-purpose utility application for Sony PlayStation (PS1/PSone) textures

Supported File Formats

• Sony PlayStation Texture Image (.TIM) (4/8/16/24bpp)
• Sony PlayStation Texture CLUT (.CLT) (16bpp color palette)
• Sony PlayStation Texture Pixels (.PXL) (4/8/16/24bpp pixels)
• Sony PlayStation Bitstream (.BS) (Version 1/2)
• Sony PlayStation 2 Texture Map (.TM2/*.CL2) (16/24/32bpp palette Storage Mode 1/2, 4/8/16/24/32bpp pixels)
• Bitmap Graphic (.BMP) (4/8bpp palette, 16-bit high color and 24/32bpp A/RGB)
• Microsoft RIFF Palette (.PAL) (32bpp ARGB palette)
• Portable Network Graphics (.PNG) (4/8bpp palette and 24/32bpp A/RGB)
• Joint Photographic Experts Group (.JPG)

Accessibility Features

• DPI Awareness
• Image Scaling (1x-128x)
• TrueType Font support (8px-256px)
• Borderless fullscreen mode/Resizable window
• Basic keyboard and mouse input support
• Modern Open/Save modals
• Toolbar (interactive 64x64 icons created from modifiable PNG) (optional)
• Statusbar (with basic texture information) (optional)
• Configuration loaded/saved on boot/exit

Basic Features

File Open Modal + Drag-n-Drop + Commandline

• Automatically scan any file for PlayStation Texture Images

File Conversion

• Import and export supplemental file types (BMP, PNG, etc.)

(*) Palette colors from supplemental formats are converted from 24-bit (8:8:8) to 15-bit (5:5:5) on import (vice-versa on export)

(*) Color depth (bits per pixel) is not modified on export

Advanced Features

File Creation

• Create and save new PlayStation Texture Images
• Import and export raw data from any file, pixel and/or palette data for all supported file types

File Modifier

• Import and export PlayStation Texture Images to/from any file type

Semi-Transparency Processing

• Preview any PlayStation Texture Image with basic semi-transparency effects (optional)
• Preview any color separate from palette as semi-transparent (CLUT not required)
• Superblack support: solid black pixels (5:5:5:1/8:8:8) are completely transparent
• Superimposed support: color at palette index 0 is semi-transparent (CLUT required)
• Transparency Control Bit (STP) support
• Semi-Transparency Rate (ABR) support
• All bit depth modes supported (4bpp, 8bpp, 16bpp and 24bpp)

Rate	Description
Half	50%back + 50%texture
Full	100%back + 100%texture
Inverse	100%back - 100%texture
Quarter	100%back + 25%texture

Dither

• Preview textures as they would appear on a real Sony PlayStation (1994) with a built-in Dithering Filter (optional)

Filter

• Preview textures with Point, Linear, Anisotropic or no filtering (default)

Texture Modification

Color Lookup Table (CLUT)

• Modify and preview multiple palettes in real-time
• Add, Insert, Delete, Move, Copy and Paste entire palettes
• Palettes are 15-bit high color indexes with semi/transparency support (5:5:5:1)
• 4bpp (16 color palette) and 8bpp (256 color palette) modes supported

Pixels

• Enable or disable semi-transparency (STP flag) for individual palette colors and pixels (4bpp/8bpp/16bpp only)

Bitstream Images

Support for Bitstream images is extremely limited, with only decoding support being reserved for future features

Any resolution supported (640x480 max)

Bitstreams images are decoded to 32bpp raster data

VRAM

Preliminary support for modifying both CLUT and Pixel coordinates is available in "File Properties" window

Preview is not available

Keyboard/Mouse

Option	Description
CTRL+O	Open (any file type)
CTRL+N	Create Sony PlayStation Texture Image (*.TIM)
CTRL+S	Save Sony PlayStation Texture Image (*.TIM)
DOWN/UP	View previous/next texture (when file count > 1)
LEFT/RIGHT	View previous/next color lookup table (palette)
CTRL+MOUSEWHEEL	Adjust image zoom
F11	Enter/Exit fullscreen mode
CTRL+?	About this application
ESC	Exit Application

Commandline

Option	Description
-file "%s"	Open (any file type)

Images

TODO

• General code cleanup, optimization, commenting, etc.
• Pixel editor
• Blit functions
• VRAM features
• Multi-file support
• (?) Mixed Mode support
• (?) Sony PlayStation Bitstream (.BS) creation
• (?) Sony PlayStation Texture Model (.TMD) support

Build

• Microsoft Visual Studio 2022+
• Microsoft Direct-X
• Clone the repo
• Install Microsoft.DXSDK.D3DX nuget package into the project
• Build/Link libjpeg-turbo libraries
• Compile

git clone https://github.com/MeganGrass/ps-image.git

Acknowledgements

Bitstream Decoder

Dither Matrix

CLT and PXL file

PS2 TIM2 Palette De-Swizzle

PSX.dev (Discord)

Copyrights

Sony PlayStation is Copyright (©) Sony Computer Entertainment Inc.

ImGui is Copyright (©) 2014-2025 Omar Cornut

Direct-X is Copyright (©) 1995-2021 Microsoft Corporation

libjpeg-turbo

libpng

zlib