summaryrefslogtreecommitdiff
path: root/trunk/browser-plugin/README
blob: 26abf069210b8f3934e8d0f38c07c8ddbc33e3b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
Notes on the plugin's internals
===============================


Envars of interest
===================

export TOTEM_EMBEDDED_DEBUG_SYNC=1
- Pass --sync to the totem-plugin-viewer

export TOTEM_EMBEDDED_DEBUG_FATAL=1
- Pass --g-fatal-warnings to the totem-plugin-viewer

export TOTEM_EMBEDDED_GDB=1
- Launch a gdb session inside an xterm to capture crashes and errors
  from the totem-plugin-viewer

export MOZ_PLUGIN_PATH=`pwd`
- Mozilla/Gecko/Firefox envar to lookup the browser plugins in the current
  directory

Special topics: Complex plugin
==============================

The complex plugin supports multiple plugins working together, see
[http://service.real.com/help/library/guides/realone/ProductionGuide/HTML/realpgd.htm?page=htmfiles/embed.htm].

To implement this, we maintain a list of totem complex plugins.
The plugins are partitioned into classes by their 'console' name; and a
random plugin (well, the first one instantiated) is chosen as representant.
This one owns the plugin viewer and all viewer interaction of the linked plugins
are done trough it. When this plugin is destroyed, we search for a new
representant, transfer the viewer ownership to it and update the representant
pointer in all of the classes' plugins.

Special topics: NarrowSpace plugin
==================================

The NarrowSpace plugin currently handles only a small portions of the possible
PARAMETERS possible:
http://www.apple.com/quicktime/tutorials/embed2.html