Back to files

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