Livewallpaper

(wikify slightly)
 
(8 intermediate revisions not shown)
Line 1: Line 1:
-
LiveWallpaper
+
API(Draft) for external theme :
 +
<ol>
 +
<li>
 +
You need to create XML file with description your external theme. See example below:
-
API for external theme
+
Example for external theme Abstractile:
 +
<source lang="xml">
 +
<theme>
 +
<name>Abstractile</name>
 +
<exec_path>/usr/lib/xscreensaver/abstractile</exec_path>
 +
<window_id>-window-id</window_id>
 +
<view>-view</view>
 +
<category>xscreensaver</category>
 +
</theme>
 +
</source>
 +
Where
 +
* <code>name</code> - name of theme.
 +
* <code>exec_path</code> - path to the executable binary file for this theme.
 +
* <code>window_id</code> - option name for the X11 Window ID. Your application should take value from this option and to use this 'window' for drawing.
 +
* <code>view</code> - option name for the view number on which your application will be started). Your application should take this option.
 +
* <code>category</code> - category name for theme.
 +
</li>
 +
<li>
 +
Your application must go to sleep on the D-Bus signal:
 +
<pre>
 +
interface='org.maemo.livewp', member='pause_livebg_on_view%i'
 +
</pre>
 +
and wake up on the D-Bus signal:
 +
<pre>
 +
interface='org.maemo.livewp', member='play_livebg_on_view%i'
 +
</pre>
 +
where %i - view number.
 +
</li>
 +
</ol>
 +
       
[[Category:Software]]
[[Category:Software]]

Latest revision as of 11:10, 23 August 2010

API(Draft) for external theme :

  1. You need to create XML file with description your external theme. See example below: Example for external theme Abstractile:
    <theme>
     <name>Abstractile</name>
     <exec_path>/usr/lib/xscreensaver/abstractile</exec_path>
     <window_id>-window-id</window_id>
     <view>-view</view>
     <category>xscreensaver</category>
    </theme>

    Where

    • name - name of theme.
    • exec_path - path to the executable binary file for this theme.
    • window_id - option name for the X11 Window ID. Your application should take value from this option and to use this 'window' for drawing.
    • view - option name for the view number on which your application will be started). Your application should take this option.
    • category - category name for theme.
  2. Your application must go to sleep on the D-Bus signal:
    interface='org.maemo.livewp', member='pause_livebg_on_view%i'
    

    and wake up on the D-Bus signal:

    interface='org.maemo.livewp', member='play_livebg_on_view%i'
    

    where %i - view number.