unsharp

unsharp — (Un)Sharpen using Gaussian blur

Synopsis

struct              GstUnsharp;

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GstObject
               +----GstElement
                     +----GstBaseTransform
                           +----GstVideoFilter
                                 +----GstUnsharp

Properties

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

Description

History

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

  • 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

Details

struct GstUnsharp

struct GstUnsharp;

Property Details

The "amount" property

  "amount"                   gdouble               : Read / Write

[luma and chroma] (Un)sharpness amount.

Allowed values: [-2,2]

Default value: 1


The "chroma-amount" property

  "chroma-amount"            gdouble               : Read / Write

[chroma override] (Un)sharpness amount.

Allowed values: [-4,2]

Default value: 1


The "chroma-matrix" property

  "chroma-matrix"            guint                 : Read / Write

[chroma override] Search Matrix Size.

Allowed values: <= 63

Default value: 3


The "matrix" property

  "matrix"                   guint                 : Read / Write

[luma and chroma] Search Matrix Size.

Allowed values: [3,63]

Default value: 3