Levels

std.Levels(vnode clip[, float[] min_in, float[] max_in, float[] gamma=1.0, float[] min_out, float[] max_out, int[] planes=[0, 1, 2]])

Adjusts brightness, contrast, and gamma.

The range [min_in, max_in] is remapped into [min_out, max_out]. Note that the range behavior is unintuitive for YUV float formats since the assumed range will be 0-1 even for the UV-planes.

For example, to convert from limited range YUV to full range (8 bit):

clip = std.Levels(clip, min_in=16, max_in=235, min_out=0, max_out=255, planes=0)
clip = std.Levels(clip, min_in=16, max_in=240, min_out=0, max_out=255, planes=[1,2])

The default value of max_in and max_out is the format’s maximum allowed value. Note that all input is clamped to the input range to prevent out of range output.

min_in, max_in, gamma, min_out and max_out can each be specified per plane. When fewer values than planes are given, the last value is reused for the remaining planes. The two-call example above can therefore also be written as a single call:

clip = std.Levels(clip, min_in=16, max_in=[235, 240], min_out=0, max_out=255)

Warning

The default ranges are 0-1 for floating point formats. This may have an undesired

effect on YUV formats.

clip

Clip to process. It must have integer sample type and bit depth between 8 and 16, or float sample type and bit depth of 32. If there are any frames with other formats, an error will be returned.

gamma

Controls the degree of non-linearity of the conversion. Values greater than 1.0 brighten the output, while values less than 1.0 darken it.

planes

Specifies which planes will be processed. Any unprocessed planes will be simply copied.