BL Library v1.1

This location is for Registered Users Only.
Perhaps you need to login or register.
Contributor: Bertrand Lempereur
A selection of more than 50 gizmos.
6.3 or later
Linux, Mac, Windows
20 Dec 2012

There is a selection of gizmos that i did in production along the years. Every topics of compositing are treated from stylising to pipeline.

Unpack this in your .nuke directory and add simply the from BL import * command line in your


For more informations and doc:


Here is a non-exhaustive list of functions:



Arc is a circle drawer.
I was writing this gizmo to create multi circle animation.
It's very similar to the Arc node in Shake.

LineDraw a simple line between 2 points.

Random is a simple 4 channels random noise generator.

Shape is a gradient based shape drawer.

Star is a simple bridge to the Flare node that allow to create stars shape quickly.



Time is a dynamic time slicer node.
It use a mask and slice it to catch the picture at a different time.

ChannelBox is a channel manager.



Bytes node is similar to the Shake's one. It convert the picture in another byte space. This is of course a simple simulation as Nuke know to work only in 32 floating point color space.

Compress color is very important. This is a common color correction function that push the low color to a value and the high color to another. While tempting to made a color matching between 2 picture this Gizmo might be really usefull.
Similar to Shake's Compress.

Expand is a gizmo similar to the Shake's command of the same name.
Expand does the exact reverse of the Compress node. It stretch the color between to low and high color value.

Same as the Shake's Monochrome node.
You can play independently with the 3 color component.

This node is a Z-depth or Z-buffer Normalizer.
This works by puting every value in absolute and finding the minimum and maximum value of the depth channel and expand this values between 0 and 1.
The trick is that in commom normalizer, the minimum value is always 0 (infinity) so i create a function that avoid computing the 0 for the minimum value.

SaturationRGB let you modify the saturation value per component.

Cut a color Slice of the picture and create a mask of the result.

Threshold the image using a color value, a range of thresholding and a replacement color.



ColorSupress is a simple color supressor using the hue tool.
Despillator is an advanced despill toolset.
HSVKeyer create mask using the hue saturation and value of the color range.
Simple Spill Supress is an old one using simple condition for despill.



LayerAE was also made after a request on production. We were needed off some of the After Effects layer mode.
Here the list of layer mode:

-Color Burn
-Color Dodge
-Soft Light
-Hard Light
-Linear Light
-Intense Light
-Luminance Model



Morphological Filter serie are use to modify binary mask.
5 gizmos are available:

BlurChroma allow you to blur the color of an image without modify it's shape.

Simple Bokeh filter.

IBokeh let you control the effect value throught a mask.

This Color Edge gizmo is a simple edge detection. It use 3 differents algo.
Sobel, Babu and Simple. This filter applied on RGBA channels.


The Convolve node is a collection of convolution matrix taked from Shake, Flame, and some image processing books.
This a good base while creating compositing node and new filter matrix.
there is a list of Matrix:

-Robinson H 3x3
-Kirsch H 3x3
-MexicanHat 5x5
-LineFinding H 5x5
-BoxFilter 7x7
-Gaussian 7x7
-Bartlett 7x7
-MexicanHat 17x17


CurveFilter is a linear filter matrix that is remap with a color lookup to filter every channels independently. The fact that you reshape the matrix by a curve allow you to pass from a filter to another.

Emboss is an advanced embossing effect

IBlur and IDilateErode are mask controled filter.









The Gizmo Solarize is again a clone of the Shake's command of the same name.
Most people think that this command is a graphical oldschool effect and i must say that's exacltly the case on pictures.
But the fact is that Solarization on mask are really usefull.
You can create smooth edges, duplicate your shapes inside gradients, and much more.
Play with it on mask work.







Scroll is an exact copy of the Scroll node in Shake.
This allow you to move a picture by replicating it's border.
Such node is really usefull when working around procedural texture.

ToBBOX was specialy design for animated shapes work.
This gizmo automatically fit a picture inside the bounding box of another.
If you receive roto of an object, you can direcly use this roto as motion source for your matter.




The Bulge function is a copy of the Bulge inside AfterEffect.
Some operators in production ask me for that tool.
This Gizmo is basicaly creating a drop/buble effect on a picture.


ChromaticAberation is a simple lens correction tool.


IDisplace is an advanced displacement node.


Twirl: a simple twirl effect.


Wave is a simple warper that distort your picture with sin, cosine or noise.
You can choose directions, play with ampliture frequency.

GUISwitch is a simple switch using the $gui global variable to detect if a rendering occur in GUI or in command line.

CleanOUT is a simple cleanup node that clamp, crop and delete every unusefull channel.
To use before a Write node.




Filler is a channel filler with inpainting options
Match help you to deal with nodal informations management
Sample a pixel and returns a color
Scanner is a basic color visualisation tool
ScanSlice is use as in gizmo tool
SetBBOXColor similar as the Shake's one 

Please login in order to download these files.


# Marty Blumen 2012-11-29 19:35
very nice.
# julian van mil 2012-12-05 15:43
nice - thanks for sharing
+1 # Ahad Mohebbi 2012-12-22 21:00
very thanks very useful :-)
# Doruk Saglam 2013-01-29 02:04
Hi Bertrand! I've downloaded the library. But somehow we are getting errors on a farm render. I couldn't solve the issue from the or
The only solution seems to be coping the gizmos back into groups :/ Do you suggest any solutions to keep the gizmos as they are without converting them into groups?
# Bertrand Lempereur 2013-01-29 02:10
Maybe you could try to add the line to your file. This is use by Nuke in command line.
# Pratheesh Chandran 2015-09-14 06:02
bl_Bulge: Unknown command , this error shows on Nuke 9.6 on linux os... pls help man
+1 # Saeed Kalhor 2016-02-29 02:11

Copy files into .nuke folder.

Make a file inside .nuke folder and add this line to it:

from BL import *

If you changed the default NUKE_PATH env variable change it back to it's default value.
# PAUL FLANAGAN 2016-09-17 00:34
very cool! thanks for sharing.

You have no rights to post comments

We have 4034 guests and 98 members online