https://github.com/midwan/amiga-lw-plugin
LightWave 3D 5.x plugins for AmigaOS, cross-compiled with GCC
https://github.com/midwan/amiga-lw-plugin
Last synced: 2 months ago
JSON representation
LightWave 3D 5.x plugins for AmigaOS, cross-compiled with GCC
- Host: GitHub
- URL: https://github.com/midwan/amiga-lw-plugin
- Owner: midwan
- License: gpl-3.0
- Created: 2026-04-04T15:10:20.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T19:24:41.000Z (2 months ago)
- Last Synced: 2026-04-05T19:24:48.229Z (2 months ago)
- Language: C
- Size: 79.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Amiga LightWave Plugin
LightWave 3D 5.x plugins for AmigaOS, cross-compiled with GCC.
Current version: `0.7.0`
## 0.7.0 Highlights
- Fixed scene persistence for the **Fresnel** and **PBR** shaders so object
property saves now stick correctly when the plugins are attached.
- Simplified **PBR Shader** to match its current implementation: AO and
environment light are now documented and exposed as fast normal-based
approximations, while blurred reflections remain the ray-traced feature.
- Expanded **LensFlare** to support a configurable flare-source cap up to 50.
- Optimized **ObjSwap** for larger replacement sets with faster sorting and
frame lookup.
## Plugins
### ObjSwap
Object Replacement plugin for Layout. Automatically swaps objects based on
frame number derived from filename suffixes.
Given a base object `Ship.lwo`, the plugin scans the directory for
`Ship_010.lwo`, `Ship_100.lwo` etc. and replaces the object at the
corresponding frames. If no exact frame match exists, the most recent
replacement before the current frame is used.
### Fresnel
Physically-based Fresnel shader for Layout. Adds realistic angle-dependent
reflectivity to surfaces using Schlick's approximation. Edges become more
reflective and less transparent at glancing angles — essential for convincing
glass, water, and polished surfaces. Configurable IOR, power, and independent
control over reflection, diffuse and transparency effects.
### PBR Shader
Combined PBR-lite shader that brings modern material concepts to LightWave 5.x.
Includes variable metallic intensity (0-100), roughness (normal perturbation),
ambient occlusion and environment-light approximations based on the surface
normal, plus blurred reflections using multi-sample ray tracing. For
angle-dependent Fresnel effects, stack with the standalone Fresnel plugin.
### LensFlare
Post-render image filter that detects bright specular highlights and composites
glow and hexagonal star streaks over the rendered image. Finds the brightest
specular hotspots up to a configurable cap (default 8, maximum 50) and renders
warm-tinted flares with configurable threshold, radius, streak length, and
intensity. Applied via the Effects/Image Processing panel.
## Toolchain
Uses `sacredbanana/amiga-compiler:m68k-amigaos` Docker image providing:
- `m68k-amigaos-gcc` 6.5.0b (GCC cross-compiler)
- Full AmigaOS NDK headers and libraries
- libnix (no ixemul.library dependency)
## Building
```bash
./build.sh # Build SDK library + all plugins
./build.sh objswap # Build ObjSwap only
./build.sh fresnel # Build Fresnel only
./build.sh pbr # Build PBR Shader only
./build.sh lensflare # Build LensFlare only
./build.sh clean # Clean build artifacts
```
CI builds run automatically via GitHub Actions using the same Docker image.
## Installation
Copy the `.p` file(s) from `build/` to your LightWave plugins directory
on the Amiga, then add the plugin lines to your LW config file:
```
Plugin ObjReplacementHandler ObjSwap objswap.p ObjSwap
Plugin ObjReplacementInterface ObjSwap objswap.p ObjSwap
Plugin ShaderHandler Fresnel fresnel.p Fresnel
Plugin ShaderInterface Fresnel fresnel.p Fresnel
Plugin ShaderHandler PBR pbr.p PBR Shader
Plugin ShaderInterface PBR pbr.p PBR Shader
Plugin ImageFilterHandler LensFlare lensflare.p LensFlare
```
## SDK
The `sdk/` directory contains the LightWave 5.x SDK headers and support
library, patched for GCC compatibility:
- `sdk/include/` — LW SDK headers (with GCC XCALL_ support added to `plug.h`)
- `sdk/lib/` — Built server library (`server.a`) and startup code (`serv_gcc.o`)
- `sdk/source/` — Server library source, GCC startup assembly, stubs
## Project Structure
```
├── build.sh # Docker build wrapper
├── Makefile # Build system
├── VERSION # Semver version
├── .github/workflows/ # CI
├── sdk/
│ ├── include/ # LW 5.x SDK headers
│ ├── lib/ # Built libraries
│ └── source/ # Library source
└── src/
├── objswap/ # ObjSwap plugin source
├── fresnel/ # Fresnel shader source
├── pbr/ # PBR shader source
└── lensflare/ # Lens flare image filter source
```