PbrPipeline

class PbrPipeline

Bases: TypedReferenceCount

The smallest complete PBR frame, for a game without the frame pipeline: the scene drawn by PbrShaderGenerator into a half-float buffer that follows the window’s size, then a full-screen pass that tonemaps it, encodes it as sRGB (unless the window’s framebuffer does) and dithers.

pipeline = PbrPipeline(base.win, base.cam, render) pipeline.tonemap = PbrPipeline.T_neutral

The constructor installs a PbrShaderGenerator on the window’s GSG (unless it has one), turns on the auto shader below the scene root, and moves every display region of the window that shows the camera onto the post pass; cleanup() (or the destructor) undoes it. The exposure is the PBR shader’s (PhysicalCamera::apply on the scene); the tonemappers are the frame pipeline’s (pbr_tonemap.glsl).

Inheritance diagram

digraph inheritance41aa9b4de5 { bgcolor=transparent; rankdir=BT; size="8.0, 12.0"; "DTOOL_SUPER_BASE" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style=""]; "PbrPipeline" [URL="acron.shading.PbrPipeline.html#acron.shading.PbrPipeline",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedReferenceCount" -> "PbrPipeline" [arrowsize=0.75,style=""]; "ReferenceCount" [URL="acron.core.ReferenceCount.html#acron.core.ReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "ReferenceCount" [arrowsize=0.75,style=""]; "TypedObject" [URL="acron.core.TypedObject.html#acron.core.TypedObject",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "TypedObject" [arrowsize=0.75,style=""]; "TypedReferenceCount" [URL="acron.core.TypedReferenceCount.html#acron.core.TypedReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedObject" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; "ReferenceCount" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; }

enum Tonemap

enumerator T_clamp = 0

enumerator T_shoulder = 1

enumerator T_neutral = 2

enumerator T_aces = 3

enumerator T_reinhard = 4

PbrPipeline.__init__()

Sets the pipeline up on a window for the scene below scene, as seen by camera (a Camera’s NodePath). Check is_valid(): without float render targets nothing changes.

PbrPipeline.cleanup()

Gives the window’s display regions back to the camera and removes the scene buffer and the post pass. The shader generator stays installed.

PbrPipeline.get_buffer()

The buffer the scene is drawn into (RGBA16F colour and depth, the size of the window).

static PbrPipeline.get_class_type()

PbrPipeline.get_dither()

Whether the post pass adds half an output step of noise against banding (true by default).

PbrPipeline.get_generator()

The PBR shader generator on the window’s GSG.

PbrPipeline.get_post_camera()

The camera of the post pass, which the window’s display regions show.

PbrPipeline.get_scene_texture()

The scene’s linear, pre-exposed colour, before the post pass.

PbrPipeline.get_tonemap()

The display transform of the post pass; T_shoulder by default.

PbrPipeline.is_valid()

False when the scene buffer could not be made (the driver has no float render targets), or after cleanup().

PbrPipeline.set_dither()

Turns the post pass’s dither on or off.

PbrPipeline.set_tonemap()

Picks the display transform of the post pass.