Repository navigation
Releases
Releases · bbayram-l/retrocrunch
Retrocrunch 0.13.0
Closer to the PS1 hardware (as documented in psx-spx), with each big change behind a
switch that's off by default. See "PS1 accuracy switches" in the guide.
Added
- Godot:
psx_lights.gdhas an Authentic mode: three lights per object plus ambient,
as the GTE's light matrix held, with point and spot lights turned into a direction
from the light to the object, dimmed by distance, the way PS1 games did on the CPU.
Extended (8 lights per vertex) stays the default. - PS1 sorting data (Export > PS1 sorting data,
--ps1-sort,ps1_sort): every triangle
gets its own vertices carrying its centre, soflat_depthsorts by the average depth
of the corners like the PS1's ordering table, the same in every renderer. - Godot PS1 materials:
stp_mode(only partly transparent texels blend in the PS1 blend
modes, opaque ones draw solid, like the STP bit),fog_ps1_curve(fog follows
1/distance like the GTE's depth cueing),ps1_dither_rule(no dither on unlit
textures and flat untextured surfaces, like the GPU) andnear_drop(polygons too
near the camera are dropped, as PS1 games did instead of clipping). - The demo renders under the 240-line screen pass, with split walls, night fog that
ends at the draw distance, help behind F1 and keys for the new switches (P, G, J, O).
Changed
- PS1 blend modes read the background at 5 bits per channel, as the 15-bit
framebuffer holds it. - The debug readouts (speed limit, draw distance, heatmap legend, VRAM overlay) draw on
the root canvas, so they stay sharp under the screen pass.
Also on itch.io: https://laegh.itch.io/retrocrunch
Retrocrunch 0.12.0
PS1 limits for whole Godot scenes, and PS1 rendering details for Godot: moving
per-vertex lights, sorting without a z-buffer and the PS1's blend modes. Plus pixelised
PBR material sets.
Added
- PBR material sets in the Texture tab. Opening any map of a set (
<name>_basecolor,
_normal/_normalogl,_height,_ambientocclusion,_metallic,_roughness,
_emissive...) loads the whole set. Every map is pixelised onto the colour texture's
grid, AO/roughness/metallic are packed into one_orm.png(R/G/B), and "Save
material..." also writes a GodotORMMaterial3Dwith nearest filtering. AO and normal
relief can be baked into the colour instead. "Batch materials..." does every set in a
folder and its subfolders. DirectX normal maps are converted to OpenGL. Also as
crunch_texture {material: true}andretrocrunch texture --material. - Godot:
psx_draw_distance.gd(written with every Godot export) finds how far the
camera can see before the objects in view pass a polygon budget, and cuts everything
farther (like Silent Hill without its fog) or tints it red. A debug tool for finding
how far each scene can draw. - The Godot PS1 Budget dock's limits are settings, saved per project: polygon budget,
VRAM size (1, 2, 4 or 8 MB), framebuffers kept in VRAM (0, 1 or 2) and their
resolution. Free texture memory follows from them (724 KB for the PS1 default). - Near-camera tessellation (
tessellate,--tessellate, Export > Near detail; 0-3):
versions with long edges split (<name>_near1.glb...) that the Godot scene of a
static model shows up close, like PS1 games did against affine texture warping.
Each version's pieces carry their triangle ratio as metadata. - Godot:
psx_detail_heatmap.gdcolours near-detail and LOD versions by their triangles
against the converted model (yellow 2x to red 8x, blue for LODs). - Godot:
psx_vram_overlay.gddraws a picture of PS1 video memory over the game: the
textures on screen packed next to the framebuffers and colour tables, as a PS1 game
would, with totals and what doesn't fit. Same packing as thevramcommand. - Godot:
psx_lights.gdlets ordinary DirectionalLight3D, OmniLight3D and SpotLight3D
nodes light the PS1 materials, per vertex like the PS1's GTE (up to 8, nearest first,
up to 2x brightness), before the 15-bit colour and dither. - Godot PS1 materials:
flat_depthgives each triangle one depth, so big polygons sort
as a whole like on a PS1 with no z-buffer;depth_biasnudges a material. - PS1 semi-transparency: materials named
..._avg,_add,_add25or_subget the
PS1 blend rules (B/2+F/2, B+F, B+F/4, B-F), computed on 8-bit values like the
hardware (psx_average/add/add_quarter/subtract.gdshader). - Godot PS1 materials:
uv_scalerepeats a texture across plain meshes. examples/godot_demo: a Godot project with all of the above on a night street that's
far over budget: PS1 materials, lamps and a flashlight, the speed limit, draw
distance, near-detail road with the heatmap, the VRAM overlay and the budget dock,
with a fly camera and a key for every mode.
Changed
- Godot PS1 materials always write depth (for
flat_depth), which turns off the GPU's
early depth test for them; at PS1 scene sizes the cost is small. - The draw distance node and the budget dock skip LOD and near-detail versions outside
their distance band, as Godot does; they counted every version before. - The budget dock's "To fit" line now gives the distance to draw up to and names only
the farthest few objects to clip; a big street listed over a hundred.
Fixed
- The Texture tab lagged with large (4K) images: it counted the original's colours on
every frame. - The Sprite Lights preview lagged with large images: the lit preview is now computed on
all cores and at most 1024 px wide, and the maps regenerate when a slider is released.
Also on itch.io: https://laegh.itch.io/retrocrunch
Retrocrunch 0.11.1
The first macOS build, and file-reference checks that work the same on every system.
Added
- macOS builds for Apple Silicon:
Retrocrunch.appwith a Fox icon, ad-hoc signed, in
a zip with the guide and the Blender and Godot folders. Every tagged version is now
published on GitHub Releases for Windows and macOS.
Fixed
- File references inside models (textures, MTL files, glTF buffers) are checked the same
way on every system. On macOS, Windows-style references such asC:\Users\...or
\\host\share\...weren't recognised as pointing outside the model's folder. - glTF files whose buffer or image URIs contain a backslash are now refused on every
system. URIs must use/; on macOS a name with a backslash could be a different file
than the one checked.
Also on itch.io: https://laegh.itch.io/retrocrunch
Retrocrunch 0.11.0
PS1 budgets for whole scenes: polygons counted the PS1 way, and two Godot tools that
measure and simulate a scene's cost.
Fixed
- Reduced characters no longer lose their arms and legs when one part (a dense, seamed
head) resists reduction: at 600 triangles CesiumMan kept 587 on the head and almost
nothing elsewhere. The reduction now lets a few UV seams move when that keeps far more
of the shape, so every limb survives (the head drops to 85). - Godot exports now include a
.glb.importthat turns off Godot's automatic mesh LODs.
Godot drew distant models with a fraction of their triangles (a 600-triangle
character at 150), so they looked smoother than the budget and every polygon count
was off.
Added
- Model reports (
inspect_model, andsource/resultinconvert_model) count
quadsandpolygonsnext totriangles, for budgets in the PS1 sense where a flat
quad is one polygon. Two triangles make a quad when they share an edge (same corner
positions and UVs), are within 10 degrees of flat and form a convex shape. - The convert report's
atlasshowsfill_percent, the share of the atlas the model
actually covers. Everything else is padding and gaps that still cost VRAM. The GUI
shows it under the atlas settings. - Godot:
psx_speed_limit.gd(written with every Godot export) caps the frame rate to
what the PS1 GPU could draw, from the triangles Godot drew each frame: 180 textured
polygons per ms, so 60 fps up to 3000, 30 up to 6000, 20 up to 9000. Flat shading,
PAL and a smooth mode are options. - Godot: a scene budget editor add-on (
godot/addons/retrocrunch_budget). Its dock
measures the open scene: polygons in view against 3000/6000, texture VRAM in PS1
formats against 724 KB (shared textures counted once), the most detailed objects, and
which far objects to clip to fit, with a suggestedvisibility_range_end.
Also on itch.io: https://laegh.itch.io/retrocrunch