Livewallpaper

(wikify slightly)
 
(5 intermediate revisions not shown)
Line 1: Line 1:
-
LiveWallpaper
+
API(Draft) for external theme :
-
 
+
<ol>
-
API for external theme:
+
<li>
-
 
+
You need to create XML file with description your external theme. See example below:
-
1. You need to create xml file with description your external theme.
+
-
See example below:
+
Example for external theme Abstractile:
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>
-
<theme>
+
Where
-
  <name>Abstractile</name>
+
* <code>name</code> - name of theme.
-
  <exec_path>/usr/lib/xscreensaver/abstractile</exec_path>
+
* <code>exec_path</code> - path to the executable binary file for this theme.
-
  <window_id>-window-id</window_id>
+
* <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.
-
  <view>-view</view>
+
* <code>view</code> - option name for the view number on which your application will be started). Your application should take this option.
-
  <category>xscreensaver</category>
+
* <code>category</code> - category name for theme.
-
</theme>
+
</li>
-
                                                                                  Where
+
<li>
-
name - name of Theme
+
Your application must go to sleep on the D-Bus signal:
-
exec_path - path for execute binary file for this theme
+
<pre>
-
window_id - name of parameter for X11 Window ID. This ID have to receive livewallpaper
+
interface='org.maemo.livewp', member='pause_livebg_on_view%i'
-
view - name of parameter for number of view on desktop (where your application start). This number have to receive livewallpaper
+
</pre>
-
category - name of category for theme
+
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.