← Back to branch summary

~ubuntu-branches/ubuntu/lucid/totem/lucid

« back to all changes in this revision

Viewing changes to docs/reference/html/totem-plugins.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2009-12-02 21:56:06 UTC
  • mfrom: (1.11.1 upstream) (2.2.11 sid)
  • Revision ID: james.westby@ubuntu.com-20091202215606-6uum8ai032ebaa9p
Tags: 2.28.4-0ubuntu1
* New upstream version:
  Movie Player:
  - Don't hide the fullscreen popups when the mouse is on top of them
  Thumbnailer:
  - Fix covers not being used any more
  Web browser plugin:
  - Fix potential crasher when using Javascript bindings
  - Fix resolution of absolute URL
* Sync on Debian
* debian/control.in:
  - build-depends on liblaunchpad-integration-dev
  - set vcs url
  - add XB-Npp-Description and XB-Npp-Filename header to the 
    totem-mozilla package to improve ubufox/ubuntu plugin db integration 
  - change refences from Iceweasel to Firefox
  - don't build using libepc, galago those are in universe
  - split totem-plugins package in an extra package for the components 
    which have depends in universe
  - use suggests rather than recommends for universe gstreamer components
* debian/patches/02_lpi.patch,
  debian/patches/90_autotools.patch: 
  - launchpad integration change
* debian/patches/07_disable_web_browser_midi.patch:
  - Disable MIDI support in totem web browser plugin as Karmic's gstreamer
    doesn't support streaming MIDI files over HTTP (LP 463102)
* debian/patches/70_bbc_plugin.patch: 
  - removed Debian APT changes. Made strings translatable.
* debian/rules:
  - don't build complex
* debian/source_totem.py, debian/totem-common.install:
  - use an apport hook to get details on the issue and try to use the right 
    component especially for codec and sound issues
* debian/totem-common.gconf-defaults: 
  - Activate content retrieval plugins (BBC and YouTube) by default      
* debian/totem-plugins-extra.install:
  - install things which have depends in universe in an extra binary

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/totem-plugins.html
34
34
<td valign="top" align="right"></td>
35
35
</tr></table></div>
36
36
<div class="refsect1" title="Introduction">
37
 
<a name="id568703"></a><h2>Introduction</h2>
 
37
<a name="id558019"></a><h2>Introduction</h2>
38
38
<p>Totem is extensible by means of small, dynamically-loadable plugins, which add functionality wanted by some but not others.</p>
39
39
<div class="refsect2" title="Locations">
40
 
<a name="id564746"></a><h3>Locations</h3>
 
40
<a name="id554062"></a><h3>Locations</h3>
41
41
<p>Totem plugins can either be installed in the system path
42
42
                                (e.g. <code class="filename">/usr/lib/totem/plugins/</code>), or in a user's home directory
43
43
                                (e.g. <code class="filename">~/.local/share/totem/plugins/</code>). In either case, each plugin resides in a
46
46
                                directory. This gives the code name of the plugin, as well as some metadata about the plugin such as its human-readable
47
47
                                name, description and author.</p>
48
48
<div class="example">
49
 
<a name="id565415"></a><p class="title"><b>Example 1. Example Plugin Directory</b></p>
 
49
<a name="id554731"></a><p class="title"><b>Example 1. Example Plugin Directory</b></p>
50
50
<div class="example-contents">
51
51
<p>A system-installed plugin called <code class="literal">subtitle-downloader</code> would reside in
52
52
                                        <code class="filename">/usr/lib/totem/plugins/subtitle-downloader</code>, and would (at a
67
67
</div>
68
68
<hr>
69
69
<div class="refsect2" title="The .totem-plugin File">
70
 
<a name="id562562"></a><h3>The <code class="filename">.totem-plugin</code> File</h3>
 
70
<a name="id551878"></a><h3>The <code class="filename">.totem-plugin</code> File</h3>
71
71
<p>The file should use the following template:
72
72
                                </p>
73
73
<pre class="programlisting">[Totem Plugin]
90
90
</div>
91
91
<hr>
92
92
<div class="refsect2" title="Writing a Plugin">
93
 
<a name="id585918"></a><h3>Writing a Plugin</h3>
 
93
<a name="id575235"></a><h3>Writing a Plugin</h3>
94
94
<p>Writing a plugin in C is a matter of creating a new <span class="type"><a
95
95
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
96
96
>GObject</a></span> which inherits
98
98
                                called <code class="literal">foobar</code>:
99
99
                                </p>
100
100
<div class="example">
101
 
<a name="id592380"></a><p class="title"><b>Example 2. Example Plugin Code</b></p>
 
101
<a name="id581696"></a><p class="title"><b>Example 2. Example Plugin Code</b></p>
102
102
<div class="example-contents"><pre class="programlisting">
103
103
#define TOTEM_TYPE_FOOBAR_PLUGIN                (totem_foobar_plugin_get_type ())
104
104
#define TOTEM_FOOBAR_PLUGIN(o)                  (G_TYPE_CHECK_INSTANCE_CAST ((o), TOTEM_TYPE_FOOBAR_PLUGIN, TotemFoobarPlugin))