Renthyl 2.0.0-alpha

[codex128]

This release features a total rewrite of Renthyl with a brand-new API! All components are now customizable and monolithic classes such as ResourceList and RenderObjectMap have been completely done away with.

• RenthylCore no longer depends on JMonkeyEngine! Engine specific implementations and utilities have been moved to the RenthylJme module (previously RenthylPlus). This means that Renthyl may now be used by other Java game engines, or even be used for non-rendering tasks.
• ResourceTickets have been fully replaced by the Socket interface. Socket has proven to be more flexible and effective in controlling resource sharing and dependencies between passes. Includes a full suite of Socket implementations!
• Connecting passes by ticket/socket name has been replaced. Instead use getter methods on the pass to access the Sockets and make the connections. It's proven to be far more flexible and easier to use. Plus it gives dearly missed access control to the pass class, and no need to remember arbitrary names anymore!
• Introduces RenderingQueue to control low-level graph execution. Included is BasicRenderingQueue... write your own if dissatisfied!
• Complete rewrite of resource allocation. It no longer uses unchangeable monolithic classes such as ResourceList and RenderObjectMap. Use your own resource allocator if desired!
• Connectables have been replaced by Renderables: a much cleaner and unassuming API.
• Render passes no longer care what FrameGraph they are part of. They can even be involved in multiple FrameGraphs.
• No need to explicitly initialize Renthyl before using its components!
• Graph savability via Savable has officially been dropped. We are now emphasizing building FrameGraphs programmatically rather than a theoretical graphical editor.
• Render settings are now controlled via ContextSetting implementations.
• ...and many many more changes...

Here is a taste of a rendering pass using the new API:

public class DownsamplingPass extends RasterTask {
    
    private final TransitiveSocket<Texture2D> in = new TransitiveSocket<>(this);
    private final AllocationSocket<Texture2D> out;
    private final AllocationSocket<FrameBuffer> frameBuffer;
    private final TextureDef<Texture2D> texDef = TextureDef.texture2D();
    private final FrameBufferDef bufferDef = new FrameBufferDef();
    private final Camera camera = new Camera(1024, 1024);
    
    public DownsamplingPass(ResourceAllocator allocator) {
        addSocket(in);
        out = addSocket(new AllocationSocket<>(this, allocator, texDef));
        frameBuffer = addSocket(new AllocationSocket<>(this, allocator, bufferDef));
    }
    
    @Override
    protected void renderTask() {
        Texture2D inTex = in.acquireOrThrow("Input texture required");
        int w = inTex.getImage().getWidth();
        int h = inTex.getImage().getHeight();
        context.getCamera().pushResize(camera, w, h, false);
        texDef.setSize(w, h);
        texDef.setSamples(inTex.getImage().getMultiSamples());
        texDef.setFormat(inTex.getImage().getFormat());
        bufferDef.setColorTarget(out.acquire());
        FrameBuffer fbo = frameBuffer.acquire();
        context.getFrameBuffer().pushValue(fbo);
        context.clearBuffers(true, false, false);
        context.renderTextures(inTex, null);
        context.getCamera().pop();
        context.getFrameBuffer().pop();
    }

}

---

This discussion was created from the release Renthyl 2.0.0-alpha.