unsharp

unsharp — (Un)Sharpen using Gaussian blur

Properties

gdouble amount Read / Write
gdouble chroma-amount Read / Write
guint chroma-matrix Read / Write
guint matrix Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBaseTransform
                    ╰── GstVideoFilter
                        ╰── GstEntransUnsharp

Description

This filter blurs or sharpens an image depending on the sign of amount. You can either set amount for both luma and chroma or you can set it individually (recommended), which will be the case if chroma-amount provides a valid (amount) value as override. A positive value for amount will sharpen the image, a negative value will blur it. A sane range for amount is -1.5 to 1.5.

The (square) matrix (and possible override chroma-matrix) sizes must be odd and define the range/strength of the effect. Sensible ranges are 3x3 to 7x7.

It sometimes makes sense to sharpen the sharpen the luma and to blur the chroma, for example:

unsharp luma=0.8 matrix=5 chroma_amount=-0.2 chroma_matrix=3

History

  • mplayer unsharp filter [Rémi Guyomarch]
  • Also available in transcode (unsharp filter)


Element Information

plugin

mencoder

author

Mark Nauwelaerts <mnauw@users.sourceforge.net>, Rémi Guyomarch

class

Filter/Effect/Video

Functions

Types and Values

GstEntransUnsharp

typedef GstUnsharp GstEntransUnsharp;

Property Details

The “amount” property

  “amount”                   gdouble

[luma and chroma] (Un)sharpness amount.

Flags: Read / Write

Allowed values: [-2,2]

Default value: 1


The “chroma-amount” property

  “chroma-amount”            gdouble

[chroma override] (Un)sharpness amount.

Flags: Read / Write

Allowed values: [-4,2]

Default value: 1


The “chroma-matrix” property

  “chroma-matrix”            guint

[chroma override] Search Matrix Size.

Flags: Read / Write

Allowed values: <= 63

Default value: 3


The “matrix” property

  “matrix”                   guint

[luma and chroma] Search Matrix Size.

Flags: Read / Write

Allowed values: [3,63]

Default value: 3