KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

ofxDeferredShading

★ 88 Open GitHub ↗

an openFrameworks addon for shading, lighting, lens simulation.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ofxDeferredShading
![](https://raw.githubusercontent.com/nama-gatsuo/ofxDeferredShading/master/screenshot.gif)

Here is [demo](https://www.youtube.com/watch?v=xhm2CdpSpcI).

## Concept
### Modern OpenGL compatible
I was satisfied with [ofxPostPrpcessing](https://github.com/neilmendoza/ofxPostProcessing) long time, which is fabulous and has so many beautiful vfx in it. I really appreciate the author and contributors.
But there is little problem when I use my own shaders with it. It is not written in "modern" shader version so cannot coexist with the "**programmble renderer**".
At this moment, however we have to decide to abandon legacy but helpful functions including `ofLight`, `glBegin()`-`glEnd()`...
### Photo-realistic in Real-time
And the addon mentioned above has only few effects for photo-real purpose such like "casting shadow". So I decided to reproduce and regather PostProcesses focusing "photo-real" rendering and compatible in modern version.

Now it contains
* Edge detection
* Multiple point-lights with attenuation
* Casting shadow with directional light
    * plus Volumetric light using shadow map
* SSAO: Screen Space Ambient Occlusion
* Depth of Field
    * plus Foreground blurring
    * plus Bokeh point rendering
* Bloom (Kawase's)
* Volumetric fog

## Support
* openFrameworks 0.10.0~ (using glm library)

## Usage
* specify modern version of OpenGL in main.cpp
```C++
int main( ){
    ofGLWindowSettings settings;
    settings.setGLVersion(4, 1); // now we use OpenGL 4.1
    settings.setSize(1024, 768);

ofCreateWindow(settings);
    ofRunApp(new ofApp());
}
```
* declare instances in ofApp.h
    * it's safer to use `std::shared_ptr`    
```C++
// declare in ofApp.h
ofxDeferredProcessing deferred;
ofPtr<ofxDeferred::SsaoPass> ssao;
ofPtr<ofxDeferred::PointLightPass> points;
ofPtr<ofxDeferred::ShadowLightPass> shadow;
ofPtr<ofxDeferred::HdrBloomPass> bloom;
...
```
* init and create Passes in ofApp::setup(), and get reference of Passes
```C++
deferred.init(ofGetWidth(), ofGetHeight());
ssao = deferred.createPass<ofxDeferred::SsaoPass>();
points = deferred.createPass<ofxDeferred::PointLightPass>();
shadow = deferred.createPass<ofxDeferred::ShadowLightPass>();    
bloom = deferred.createPass<ofxDeferred::HdrBloomPass>();
```
* set parameters via reference
```C++
ssao->setOcculusionRadius(5.0);
ssao->setDarkness(1.0);
```
* draw objects between `begin()` and `end()`.
* If you want to HDR color, just specify vertex color bright enough (can be more than 1.0) through `ofFloatColor`'s parameters.
* if you want to use cast shadow (`ShadowLightPass`), you need another draw call for shadow map.

```C++
    // for shadow map
    shadowLightPass->beginShadowMap();
        drawObjs(); // draw something
        lightPass->drawLights(); // draw light bulbs
    shadowLightPass->endShadowMap();

// for rendering pass
    deferred.begin(cam);
        drawObjs(); // exactly the same call above
        lightPass->drawLights();
    deferred.end();
    ```
* Also, you can use own shader for mesh rendering. In this case, you need to write pixel data into color buffer properly like below.

```GLSL
#version 400

uniform int shadowFlag;

in vec4 vPos;
in vec4 vNormal;
in vec4 vColor;
in float vDepth;

layout (location = 0) out vec4 outputColor0; // Color
layout (location = 1) out vec4 outputColor1; // Position
layout (location = 2) out vec4 outputColor2; // Normal and Depth

void main(){

if (shadowFlag == 1) {
        outputColor0.r = vDepth;
        outputColor0.a = 1.;
    } else {
        outputColor0 = vColor;
        outputColor1 = vPos;
        outputColor2 = vec4(vNormal.xyz, vDepth);
    }

}

```

## Reference
### Render Pass
* Basic architecture and "RenderPass" is quoted from [neilmendoza/ofxPostProcessing](https://github.com/neilmendoza/ofxPostProcessing).
* GBuffer design from [hanasaan/ofxDeferredProcessing](https://github.com/hanasaan/ofxDeferredProcessing/)

### Effects
* Defocus blur including foreground blurring from [GPU Gems 3](https://developer.nvidia.com/gpugems/gpugems3/part-iv-image-effects/chapter-28-practical-post-process-depth-field)
* Bokeh rendering from [OpenGL Insights](https://github.com/OpenGLInsights/OpenGLInsightsCode/tree/master/Chapter%2015%20Depth%20of%20Field%20with%20Bokeh%20Rendering)
* Point light with attenuation from [jacres/of-DeferredRendering](https://github.com/jacres/of-DeferredRendering)
* Shadow Mapping from [Learn OpenGL](https://learnopengl.com/Advanced-Lighting/Shadows/Shadow-Mapping)
* Screen Space Ambient occlusion from [Learn OpenGL](https://learnopengl.com/#!Advanced-Lighting/SSAO)
* Kawase's bloom from [Intel's article](https://software.intel.com/en-us/blogs/2014/07/15/an-investigation-of-fast-real-time-gpu-based-image-blur-algorithms)
* Volumetric lighting from [Alexandre Pestana](https://www.alexandre-pestana.com/volumetric-lights/)

## Author
[Ayumu Nagamatsu](http://ayumu-nagamatsu.com/)

ofxDeferredShading

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README