Skip to content

Releases

Retrocrunch 0.13.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 19:32

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.gd has 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, so flat_depth sorts 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) and near_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

Choose a tag to compare

@github-actions github-actions released this 06 Nov 11:51

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 Godot ORMMaterial3D with 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} and retrocrunch 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.gd colours near-detail and LOD versions by their triangles
    against the converted model (yellow 2x to red 8x, blue for LODs).
  • Godot: psx_vram_overlay.gd draws 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 the vram command.
  • Godot: psx_lights.gd lets 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_depth gives each triangle one depth, so big polygons sort
    as a whole like on a PS1 with no z-buffer; depth_bias nudges a material.
  • PS1 semi-transparency: materials named ..._avg, _add, _add25 or _sub get 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_scale repeats 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

Choose a tag to compare

@github-actions github-actions released this 05 Nov 21:52

The first macOS build, and file-reference checks that work the same on every system.

Added

  • macOS builds for Apple Silicon: Retrocrunch.app with 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 as C:\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

Choose a tag to compare

@github-actions github-actions released this 05 Nov 20:44

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.import that 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, and source/result in convert_model) count
    quads and polygons next to triangles, 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 atlas shows fill_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 suggested visibility_range_end.

Also on itch.io: https://laegh.itch.io/retrocrunch