Skip to content

Commit e0c250c

Browse files
MeganGrassMeganGrass
committed
1.1.0.0
1 parent 7ae3bf7 commit e0c250c

File tree

18 files changed

+2241
-1098
lines changed

18 files changed

+2241
-1098
lines changed

‎README.MD‎

Lines changed: 30 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# PS-Image
2-
Multi-purpose utility application for Sony PlayStation (PS1/PSone) images
2+
Multi-purpose utility application for Sony PlayStation (PS1/PSone) textures and images
33

44
## Supported File Formats
55
- Sony PlayStation Texture Image (*.TIM) *(4bpp, 8bpp and 16bpp supported)*
@@ -10,78 +10,85 @@ Multi-purpose utility application for Sony PlayStation (PS1/PSone) images
1010
- Image Scaling *(1x-128x)*
1111
- TrueType Font support *(8px-256px)*
1212
- Borderless fullscreen mode/Resizable window
13-
- Adjustable window color
1413
- Basic keyboard and mouse input support
15-
- Detailed windows with informative tooltips
16-
- Pixel coordinates on mouse hover
1714
- Modern Open/Save modals
18-
- Toolbar *(interactive 64x64 icons created from modifiable PNG)*
19-
- Statusbar *(with basic texture information)*
15+
- Toolbar *(interactive 64x64 icons created from modifiable PNG)* (optional)
16+
- Statusbar *(with basic texture information)* (optional)
2017
- Configuration loaded/saved on boot/exit
2118

2219
## Basic Features
23-
##### **File Open + Drag-n-Drop**
20+
##### **File Open Modal + Drag-n-Drop + Commandline**
2421
- Automatically scan any file for PlayStation Texture Images
25-
##### **File Browser**
26-
- Intuitive file browser with extensive right-click features
2722
##### **File Conversion**
2823
- Convert images to Bitmap Graphic (*.BMP) format
2924
- Color depth is retained in conversion
3025

3126
## Advanced Features
3227
##### **File Creator**
33-
- Create PlayStation Texture Images (with options to load raw pixel+palette data from any location in any file type on creation)
28+
- Create and save new PlayStation Texture Images
29+
- Import/Export pixel and/or palette data to/from any file (RAW)
30+
- Import/Export pixel and/or palette data to/from PlayStation Texture Images
3431
##### **File Modifier**
35-
- Extract/Replace any PlayStation Texture Image in any file type
36-
##### **Raw Data**
37-
- Extract/Replace raw pixel+palette data in PlayStation Texture Images
32+
- Replace/Extract PlayStation Texture Images to/from any file type
3833
##### **Transparency**
3934
- Enable/Disable preview of color transparency
40-
- Preview transparent pixels as any color (default: magic pink)
41-
- 4bpp, 8bpp and 16bpp modes supported
35+
- Preview transparent pixels as any color separately from palette (default: magic pink)
36+
- Superimposed transparency support, where transparent color is always palette index 0 (optional)
4237
##### **Dither**
4338
- Preview textures as they would appear on a real Sony PlayStation (1994) with a built-in [Dithering Filter](https://en.wikipedia.org/wiki/Dither) (optional)
44-
- All depth modes supported
39+
##### **Filter**
40+
- Preview textures with Point, Linear, Anisotropic or no filtering (default)
4541

4642
## Texture Modification
4743
##### **Color Lookup Table (CLUT)**
4844
- Modify and preview any palette in real-time
4945
- Add, Insert, Delete, Move, Copy and Paste entire palettes
5046
- Palettes are [15-bit](https://en.wikipedia.org/wiki/High_color) high color [indexes](https://en.wikipedia.org/wiki/Indexed_color) with truecolor [transparency](https://en.wikipedia.org/wiki/Palette_(computing)#Transparency_in_palettes) (superblack pixel) support
51-
- 4bpp *(16 color palette)* and 8bpp *(256 color palette)* modes supported
47+
- 4bpp *(16 color palette)* and 8bpp/16bpp *(256 color palette)* modes supported
48+
- Microsoft RIFF Palette (*.PAL) support
5249

5350
## Bitstream Images
5451
Support for Bitstream images is extremely limited, with only decoding support being reserved for future features
5552

5653
Any resolution supported ([640x480](https://en.wikipedia.org/wiki/PlayStation_technical_specifications#:~:text=Resolutions) max)
5754

58-
Bitstreams images are decoded to 32bpp
55+
Bitstreams images are decoded to 32bpp raster data
56+
57+
## VRAM
58+
Preliminary support for modifying both CLUT and Pixel coordinates is available (_"File"_ window for pixels, _"Palette"_ window for palette)
59+
60+
Preview is not available
5961

6062
## Keyboard/Mouse
6163
| Option | Description |
6264
| :-------- | :-------------------------------- |
6365
| `CTRL+O` | Open (any file type) |
64-
| `CTRL+R` | Open Raw Sony PlayStation Texture Image data |
65-
| `CTRL+N` | Create New Sony PlayStation Texture Image (*.TIM) |
66+
| `CTRL+N` | Create Sony PlayStation Texture Image (*.TIM) |
6667
| `CTRL+S` | Save Sony PlayStation Texture Image (*.TIM) |
6768
| `DOWN/UP` | View previous/next texture (when file count > 1) |
68-
| `LEFT/RIGHT` | View previous/next color lookup table (color palette) |
69+
| `LEFT/RIGHT` | View previous/next color lookup table (palette) |
6970
| `CTRL+MOUSEWHEEL` | Adjust image zoom |
7071
| `F11` | Enter/Exit fullscreen mode |
7172
| `CTRL+?` | About this application |
7273
| `ESC` | Exit Application |
7374

75+
## Commandline
76+
| Option | Description |
77+
| :-------- | :-------------------------------- |
78+
| `-file "%s"` | Open (any file type) |
79+
7480
## Images
7581
![General Usage](/images/ps-image_00.jpg?raw=true "General Usage")
76-
![Dithering Off, image scaled to 65.5x, mouse cursor hovering pixel (21, 5)](/images/ps-image_02.jpg?raw=true "Dithering Off, image scaled to 65.5x, mouse cursor hovering pixel (21, 5)")
77-
![Dithering On, image scaled to 65.5x, mouse cursor hovering pixel (21, 6)](/images/ps-image_01.jpg?raw=true "Dithering On, image scaled to 65.5x, mouse cursor hovering pixel (21, 6)")
82+
![Dithering Off, image scaled to 64x, mouse cursor hovering pixel (21, 5)](/images/ps-image_02.jpg?raw=true "Dithering Off, image scaled to 64x, mouse cursor hovering pixel (21, 5)")
83+
![Dithering On, image scaled to 64x, mouse cursor hovering pixel (21, 6)](/images/ps-image_01.jpg?raw=true "Dithering On, image scaled to 64x, mouse cursor hovering pixel (21, 6)")
7884
![Open RAW data prompt](/images/ps-image_03.jpg?raw=true "Open RAW data prompt")
7985

8086
## TODO
8187
- General code cleanup, optimization, commenting, etc.
8288
- Pixel editor
8389
- Blit functions
8490
- VRAM features
91+
- Multi-file support
8592
- File import (*.BMP, *.PNG, etc.)
8693
- (?) Sony PlayStation Bitstream (*.BS) creation
8794
- (?) Sony PlayStation Texture Model (*.TMD) support
@@ -106,7 +113,3 @@ Sony PlayStation is Copyright (©) [Sony Computer Entertainment Inc.](https://so
106113
[ImGui](https://github.com/ocornut/imgui) is Copyright (©) 2014-2025 Omar Cornut
107114

108115
[Direct-X](https://learn.microsoft.com/en-us/windows/win32/directx) is Copyright (©) 1995-2021 Microsoft Corporation
109-
110-
## Changelog
111-
Version 1.0.0.0 (January 1, 2025)
112-
- Initial release

0 commit comments

Comments
 (0)