# glsl-blend

**Repository Path**: liu_autumn/glsl-blend

## Basic Information

- **Project Name**: glsl-blend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-02-04
- **Last Updated**: 2024-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# glsl-blend

Photoshop blending modes in glsl for use with [glslify](https://github.com/stackgl/glslify).
Blending modes include Screen, Multiply, Soft Light, Vivid Light, Overlay, etc.
Implementations sourced from this article on [Photoshop math](https://mouaif.wordpress.com/2009/01/05/photoshop-math-with-glsl-shaders/).

### Demo
<http://jamieowen.github.io/glsl-blend>



## Installation
```shell
npm install glsl-blend
```

[![NPM](https://nodei.co/npm/glsl-blend.png)](https://nodei.co/npm/glsl-blend/)

[![stable](http://badges.github.io/stability-badges/dist/stable.svg)](http://github.com/badges/stability-badges)

## Standard Usage

Blend modes can be imported individually using the standard glslify preprocessor syntax.

```glsl
#pragma glslify: blendAdd = require(glsl-blend/add)
#pragma glslify: blendAverage = require(glsl-blend/average)
#pragma glslify: blendColorBurn = require(glsl-blend/color-burn)
#pragma glslify: blendColorDodge = require(glsl-blend/color-dodge)
#pragma glslify: blendDarken = require(glsl-blend/darken)
#pragma glslify: blendDifference = require(glsl-blend/difference)
#pragma glslify: blendExclusion = require(glsl-blend/exclusion)
#pragma glslify: blendGlow = require(glsl-blend/glow)
#pragma glslify: blendHardLight = require(glsl-blend/hard-light)
#pragma glslify: blendHardMix = require(glsl-blend/hard-mix)
#pragma glslify: blendLighten = require(glsl-blend/lighten)
#pragma glslify: blendLinearBurn = require(glsl-blend/linear-burn)
#pragma glslify: blendLinearDodge = require(glsl-blend/linear-dodge)
#pragma glslify: blendLinearLight = require(glsl-blend/linear-light)
#pragma glslify: blendMultiply = require(glsl-blend/multiply)
#pragma glslify: blendNegation = require(glsl-blend/negation)
#pragma glslify: blendNormal = require(glsl-blend/normal)
#pragma glslify: blendOverlay = require(glsl-blend/overlay)
#pragma glslify: blendPhoenix = require(glsl-blend/phoenix)
#pragma glslify: blendPinLight = require(glsl-blend/pin-light)
#pragma glslify: blendReflect = require(glsl-blend/reflect)
#pragma glslify: blendScreen = require(glsl-blend/screen)
#pragma glslify: blendSoftLight = require(glsl-blend/soft-light)
#pragma glslify: blendSubtract = require(glsl-blend/subtract)
#pragma glslify: blendVividLight = require(glsl-blend/vivid-light)
```

A foreground and background color is needed to perform a blend operation.

```glsl
#pragma glslify: blend = require(glsl-blend/screen)

void main() {
    vec4 bgColor = texture2D(bg, vUv);
    vec4 fgColor = texture2D(foreground, vUv);

    vec3 color = blend(bgColor.rgb, fgColor.rgb);
    gl_FragColor = vec4(color, 1.0);
}
```

Blend modes can also specify an additional opacity parameter.
```glsl
float opacity = 0.75;
vec3 color = blend(bgColor.rgb, fgColor.rgb, opacity );
```

## Modal Usage

The [demo](http://jamieowen.github.io/glsl-blend) shows all blend modes switchable via a drop down.

For this, there is an additional 'all' glsl function that can be required to import all blend mode functions at once and
specify which one to use via an integer.  Integers for each blend mode can be imported using the javascript [modes](http://github.com/jamieowen/glsl-blend/blob/master/modes.js) module, and passed as a uniform to the shader.

```javascript
// javascript
var modes = require( 'glsl-blend/modes' );

// using stackgl
myShader.uniforms.blendMode = modes.HARD_LIGHT;
```

```glsl
// glsl
#pragma glslify: blend = require(glsl-blend/all)
uniform int blendMode;

// ...

vec3 color = blend( blendMode, bgColor.rgb, fgColor.rgb, 0.75 );
```

## Todo

* Add Hue, Luminance, Saturation & Color Modes.
* Implement color conversion functions for the above as separate glsl modules.


## Contributing

See [stackgl/contributing](https://github.com/stackgl/contributing).

## License

MIT. See [LICENSE.md](https://github.com/jamieowen/glsl-blend/blob/master/LICENSE.md) for details.