~ubuntu-branches/ubuntu/natty/gst-entrans/natty

« back to all changes in this revision

Viewing changes to docs/plugins/html/gst-entrans-plugins-unsharp.html

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2010-09-13 19:49:29 UTC
  • Revision ID: james.westby@ubuntu.com-20100913194929-qz90a14xyxln9yfz
Tags: upstream-0.10.2
Import upstream version 0.10.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>unsharp</title>
 
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">
 
16
</head>
 
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">
 
19
<tr valign="middle">
 
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>
 
25
</tr>
 
26
<tr><td colspan="5" class="shortcuts">
 
27
<a href="#gst-entrans-plugins-unsharp.synopsis" class="shortcut">Top</a>
 
28
                 | 
 
29
                <a href="#gst-entrans-plugins-unsharp.description" class="shortcut">Description</a>
 
30
                 | 
 
31
                <a href="#gst-entrans-plugins-unsharp.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
32
                 | 
 
33
                <a href="#gst-entrans-plugins-unsharp.properties" class="shortcut">Properties</a>
 
34
</td></tr>
 
35
</table>
 
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>
 
39
<td valign="top">
 
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>
 
42
</td>
 
43
<td valign="top" align="right"></td>
 
44
</tr></table></div>
 
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>;
 
49
</pre>
 
50
</div>
 
51
<div class="refsect1" lang="en">
 
52
<a name="gst-entrans-plugins-unsharp.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
53
<pre class="synopsis">
 
54
  <a
 
55
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
56
>GObject</a>
 
57
   +----GstObject
 
58
         +----GstElement
 
59
               +----GstBaseTransform
 
60
                     +----<a
 
61
href="/usr/share/gtk-doc/html/gst-plugins-base-libs-0.10/gst-plugins-base-libs-gstvideofilter.html#GstVideoFilter"
 
62
>GstVideoFilter</a>
 
63
                           +----GstUnsharp
 
64
</pre>
 
65
</div>
 
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
 
81
</pre>
 
82
</div>
 
83
<div class="refsect1" lang="en">
 
84
<a name="gst-entrans-plugins-unsharp.description"></a><h2>Description</h2>
 
85
<p>
 
86
</p>
 
87
<div class="refsect2" lang="en">
 
88
<a name="id561893"></a><h3>History</h3>
 
89
<p>
 
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.
 
98
</p>
 
99
<p>
 
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.
 
105
</p>
 
106
<p>
 
107
It sometimes  makes  sense  to  sharpen  the sharpen the luma
 
108
and to blur the chroma, for example:
 
109
</p>
 
110
<pre class="programlisting">
 
111
unsharp luma=0.8 matrix=5 chroma_amount=-0.2 chroma_matrix=3
 
112
</pre>
 
113
<p>
 
114
</p>
 
115
<p>
 
116
</p>
 
117
<div class="itemizedlist"><ul type="disc">
 
118
<li>
 
119
mplayer unsharp filter [Rémi Guyomarch]
 
120
</li>
 
121
<li>
 
122
Also available in transcode (unsharp filter)
 
123
</li>
 
124
</ul></div>
 
125
<p>
 
126
</p>
 
127
</div>
 
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">
 
132
<tbody>
 
133
<tr>
 
134
<td><p><span class="term">plugin</span></p></td>
 
135
<td>
 
136
          <a class="link" href="gst-entrans-plugins-plugin-mencoder.html#plugin-mencoder">mencoder</a>
 
137
        </td>
 
138
</tr>
 
139
<tr>
 
140
<td><p><span class="term">author</span></p></td>
 
141
<td>Mark Nauwelaerts &lt;mnauw@users.sourceforge.net&gt;,
 
142
    Rémi Guyomarch</td>
 
143
</tr>
 
144
<tr>
 
145
<td><p><span class="term">class</span></p></td>
 
146
<td>Filter/Effect/Video</td>
 
147
</tr>
 
148
</tbody>
 
149
</table></div>
 
150
</div>
 
151
<p>
 
152
</p>
 
153
</div>
 
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>
 
159
<p>
 
160
</p>
 
161
</div>
 
162
</div>
 
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>
 
173
</div>
 
174
<hr>
 
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>
 
183
</div>
 
184
<hr>
 
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: &lt;= 63</p>
 
192
<p>Default value: 3</p>
 
193
</div>
 
194
<hr>
 
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>
 
203
</div>
 
204
</div>
 
205
</div>
 
206
<div class="footer">
 
207
<hr>
 
208
          Generated by GTK-Doc V1.11</div>
 
209
</body>
 
210
</html>