NAME¶
yuvmedianfilter - A filter for yuv images produced by the mjpeg tools
SYNOPSIS¶
yuvmedianfilter [
-r num] [
-R num] [
-t
num] [
-T num] [
-I num] [
-f]
[
-w num] [
-s num] [
-v num]
[
-h]
DESCRIPTION¶
yuvmedianfilter is designed to enhance/filter images. It takes the input
from STDIN and writes output to STDOUT.
This filter looks around the current point for a radius and averages the values
that fall inside a threshold. So the image is softened and the edges become
more sharp. If the input material is noisy (it is always noisy but you do not
always see it) the output images are improved and the encoder spends less
bandwidth encoding noise. The more sophisticated version of image filtering is
yuvdenoise. But you can use both programs in the encoding procces. It cannot
process a recorded file and write the improved version to another file.
OPTIONS¶
yuvmedianfilter accepts the following options:
- -r num
- Radius for luma median (default: 2 pixels)
- -R num
- Radius for chroma median (default: 2 pixels)
- -t num
- Trigger threshold for luma (default: 2 [0=disable])
- -T num
- Trigger threshold for chroma (default: 2 [0=disable])
- -I num
- Interlacing type (0=no, 1=yes, default: taken from yuv stream)
- -f
- Fast mode, i.e. the threshold is ignored, and a simple mean of the
surrounding values is calculated.
- -w num
- In fast mode, the weight given to the current value versus the surrounding
values. Default is 8.
Note that certain combinations of radii and weights have been optimized to
be even faster -- radius 1 and weight 2.667, radius 1 and weight 8, and
radius 2 and weight 8.
- -c num
- In slow mode, more than this fraction of the pixels must be within the
threshold; otherwise the pixel is simply the weighted mean of pixels
within a radius of 1. Default is 0.33333.
- -s num
- Number of beginning frames to skip. The first num frames are written to
stdout unfiltered. This is useful for resuming an interrupted job without
having to duplicate work.
- -v num
- Verbosity level (0, 1 or 2)
- -h
- Print out a help message
BUGS¶
It is slow. Using a radius greater than the default of 2 is painfully slow.
AUTHOR¶
This man page was written by Bernhard Praschinger.
The yuvmedianfilter program was written by Mike Bernson, and adapted to the
yuv4mpeg2 stream header format by Steven M. Schultz.
If you have questions, remarks, problems or you just want to contact the
developers, the main mailing list for the MJPEG-tools is:
mjpeg-users@lists.sourceforge.net
- For more info, see our website at
- http://mjpeg.sourceforge.net
SEE ALSO¶
mjpegtools(1),
jpeg2yuv(1),
lav2yuv(1),
mpeg2enc(1),
ppmtoy4m(1),
yuv2lav(1),
yuvdenoise(1),
yuvscaler(1)