1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="GStreamer Entrans 0.10 Reference Manual">
8
<link rel="up" href="ch01.html" title="gst-entrans Elements">
9
<link rel="prev" href="gst-entrans-plugins-stamp.html" title="stamp">
10
<link rel="next" href="gst-entrans-plugins-whitebalance.html" title="whitebalance">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="ch01.html" title="gst-entrans Elements">
14
<link rel="chapter" href="ch02.html" title="gst-entrans Plugins">
15
<link rel="chapter" href="ch03.html" title="gst-entrans Helper Elements and Utilities">
17
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
18
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
20
<td><a accesskey="p" href="gst-entrans-plugins-stamp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
21
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
22
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
23
<th width="100%" align="center">GStreamer Entrans 0.10 Reference Manual</th>
24
<td><a accesskey="n" href="gst-entrans-plugins-whitebalance.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
26
<tr><td colspan="5" class="shortcuts">
27
<a href="#gst-entrans-plugins-unsharp.synopsis" class="shortcut">Top</a>
29
<a href="#gst-entrans-plugins-unsharp.description" class="shortcut">Description</a>
31
<a href="#gst-entrans-plugins-unsharp.object-hierarchy" class="shortcut">Object Hierarchy</a>
33
<a href="#gst-entrans-plugins-unsharp.properties" class="shortcut">Properties</a>
36
<div class="refentry" lang="en">
37
<a name="gst-entrans-plugins-unsharp"></a><div class="titlepage"></div>
38
<div class="refnamediv"><table width="100%"><tr>
40
<h2><span class="refentrytitle"><a name="gst-entrans-plugins-unsharp.top_of_page"></a>unsharp</span></h2>
41
<p>unsharp — (Un)Sharpen using Gaussian blur</p>
43
<td valign="top" align="right"></td>
45
<div class="refsynopsisdiv">
46
<a name="gst-entrans-plugins-unsharp.synopsis"></a><h2>Synopsis</h2>
47
<a name="GstUnsharp"></a><pre class="synopsis">
48
<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp-struct" title="GstUnsharp">GstUnsharp</a>;
51
<div class="refsect1" lang="en">
52
<a name="gst-entrans-plugins-unsharp.object-hierarchy"></a><h2>Object Hierarchy</h2>
53
<pre class="synopsis">
55
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
61
href="/usr/share/gtk-doc/html/gst-plugins-base-libs-0.10/gst-plugins-base-libs-gstvideofilter.html#GstVideoFilter"
66
<div class="refsect1" lang="en">
67
<a name="gst-entrans-plugins-unsharp.properties"></a><h2>Properties</h2>
68
<pre class="synopsis">
69
"<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--amount" title='The "amount" property'>amount</a>" <a
70
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
71
>gdouble</a> : Read / Write
72
"<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--chroma-amount" title='The "chroma-amount" property'>chroma-amount</a>" <a
73
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
74
>gdouble</a> : Read / Write
75
"<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--chroma-matrix" title='The "chroma-matrix" property'>chroma-matrix</a>" <a
76
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
77
>guint</a> : Read / Write
78
"<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--matrix" title='The "matrix" property'>matrix</a>" <a
79
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
80
>guint</a> : Read / Write
83
<div class="refsect1" lang="en">
84
<a name="gst-entrans-plugins-unsharp.description"></a><h2>Description</h2>
87
<div class="refsect2" lang="en">
88
<a name="id561893"></a><h3>History</h3>
90
This filter blurs or sharpens an image depending on the sign of
91
<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--amount" title='The "amount" property'>amount</a>. You can either
92
set amount for both luma and chroma or you can set it individually
93
(recommended), which will be the case if
94
<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--chroma-amount" title='The "chroma-amount" property'>chroma-amount</a>
95
provides a valid (amount) value as override.
96
A positive value for amount will sharpen the image, a negative
97
value will blur it. A sane range for amount is -1.5 to 1.5.
100
The (square) <a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--chroma-matrix" title='The "chroma-matrix" property'>matrix</a>
101
(and possible override
102
<a class="link" href="gst-entrans-plugins-unsharp.html#GstUnsharp--chroma-matrix" title='The "chroma-matrix" property'>chroma-matrix</a>) sizes
103
must be odd and define the range/strength of the effect.
104
Sensible ranges are 3x3 to 7x7.
107
It sometimes makes sense to sharpen the sharpen the luma
108
and to blur the chroma, for example:
110
<pre class="programlisting">
111
unsharp luma=0.8 matrix=5 chroma_amount=-0.2 chroma_matrix=3
117
<div class="itemizedlist"><ul type="disc">
119
mplayer unsharp filter [Rémi Guyomarch]
122
Also available in transcode (unsharp filter)
128
<div class="refsect2" lang="en">
129
<a name="id561960"></a><h3>Element Information</h3>
130
<div class="variablelist"><table border="0">
131
<col align="left" valign="top">
134
<td><p><span class="term">plugin</span></p></td>
136
<a class="link" href="gst-entrans-plugins-plugin-mencoder.html#plugin-mencoder">mencoder</a>
140
<td><p><span class="term">author</span></p></td>
141
<td>Mark Nauwelaerts <mnauw@users.sourceforge.net>,
145
<td><p><span class="term">class</span></p></td>
146
<td>Filter/Effect/Video</td>
154
<div class="refsect1" lang="en">
155
<a name="gst-entrans-plugins-unsharp.details"></a><h2>Details</h2>
156
<div class="refsect2" lang="en">
157
<a name="GstUnsharp-struct"></a><h3>GstUnsharp</h3>
158
<pre class="programlisting">typedef struct _GstUnsharp GstUnsharp;</pre>
163
<div class="refsect1" lang="en">
164
<a name="gst-entrans-plugins-unsharp.property-details"></a><h2>Property Details</h2>
165
<div class="refsect2" lang="en">
166
<a name="GstUnsharp--amount"></a><h3>The <code class="literal">"amount"</code> property</h3>
167
<pre class="programlisting"> "amount" <a
168
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
169
>gdouble</a> : Read / Write</pre>
170
<p>[luma and chroma] (Un)sharpness amount.</p>
171
<p>Allowed values: [-2,2]</p>
172
<p>Default value: 1</p>
175
<div class="refsect2" lang="en">
176
<a name="GstUnsharp--chroma-amount"></a><h3>The <code class="literal">"chroma-amount"</code> property</h3>
177
<pre class="programlisting"> "chroma-amount" <a
178
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
179
>gdouble</a> : Read / Write</pre>
180
<p>[chroma override] (Un)sharpness amount.</p>
181
<p>Allowed values: [-4,2]</p>
182
<p>Default value: 1</p>
185
<div class="refsect2" lang="en">
186
<a name="GstUnsharp--chroma-matrix"></a><h3>The <code class="literal">"chroma-matrix"</code> property</h3>
187
<pre class="programlisting"> "chroma-matrix" <a
188
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
189
>guint</a> : Read / Write</pre>
190
<p>[chroma override] Search Matrix Size.</p>
191
<p>Allowed values: <= 63</p>
192
<p>Default value: 3</p>
195
<div class="refsect2" lang="en">
196
<a name="GstUnsharp--matrix"></a><h3>The <code class="literal">"matrix"</code> property</h3>
197
<pre class="programlisting"> "matrix" <a
198
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
199
>guint</a> : Read / Write</pre>
200
<p>[luma and chroma] Search Matrix Size.</p>
201
<p>Allowed values: [3,63]</p>
202
<p>Default value: 3</p>
208
Generated by GTK-Doc V1.11</div>