2
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
3
<!ENTITY % English "INCLUDE">
6
<refentry lang="&language;">
8
<title>KDE User's Manual</title>
9
<date>2010-10-21</date>
10
<productname>K Desktop Environment</productname>
14
<refentrytitle><command>plasmoidviewer</command></refentrytitle>
15
<manvolnum>1</manvolnum>
19
<refname><command>plasmoidviewer</command></refname>
20
<refpurpose>Run Plasma widgets in their own window</refpurpose>
25
<command>plasmoidviewer</command>
27
<group choice="opt"><option>-c, --containment</option> <replaceable> name</replaceable></group>
28
<group choice="opt"><option>-f, --formfactor</option> <replaceable> name</replaceable></group>
29
<group choice="opt"><option>--list</option></group>
30
<group choice="opt"><option>--list-wallpapers</option></group>
31
<group choice="opt"><option>--list-containments</option></group>
32
<group choice="opt"><option>-l, --location</option> <replaceable> name</replaceable></group>
33
<group choice="opt"><option>-p, --pixmapcache</option> <replaceable> size</replaceable></group>
34
<group choice="opt"><option>-s, --screenshot</option></group>
35
<group choice="opt"><option>--screenshot-all</option></group>
36
<group choice="opt"><option>-t, --theme</option> <replaceable> name</replaceable></group>
37
<group choice="opt"><option>-w, --wallpaper</option> <replaceable> name</replaceable></group>
38
<arg choice="opt">applet</arg>
39
<arg choice="opt">args</arg>
40
<arg choice="opt">--list-remote</arg>
41
<arg choice="opt">KDE Generic Options</arg>
42
<arg choice="opt">Qt Generic Options</arg>
47
<title>Description</title>
48
<para><command>plasmoidviewer</command> is a graphical tool allowing developers to
49
test Plasma applets.</para>
51
<para>Only installed applets will be found.
52
<command>kbuildsycoca4</command> may need to be run for newly-installed
53
applets to be found.</para>
57
<title>Options</title>
61
<term><option>-c, --containment <replaceable>name</replaceable></option></term>
62
<listitem><para>Name of the containment plugin [null].</para></listitem>
65
<term><option>-f, --formfactor <replaceable>name</replaceable></option></term>
66
<listitem><para>The formfactor to use (horizontal, vertical, mediacenter or planar) [planar].</para></listitem>
69
<term><option>--list</option></term>
70
<listitem><para>Displays a list of known applets.</para></listitem>
73
<term><option>--list-wallpapers</option></term>
74
<listitem><para>Displays a list of known wallpapers.</para></listitem>
77
<term><option>--list-containments</option></term>
78
<listitem><para>Displays a list of known containments.</para></listitem>
81
<term><option>-l, --location <replaceable>name</replaceable></option></term>
82
<listitem><para>The location constraint to start the Containment with (floating,
83
desktop, fullscreen, top, bottom, left, right) [floating].</para></listitem>
86
<term><option>-p, --pixmapcache <replaceable>size</replaceable></option></term>
87
<listitem><para>The size in KB to set the pixmap cache to.</para></listitem>
90
<term><option>-s, --screenshot</option></term>
91
<listitem><para>Takes a screenshot of the widget and saves it the working directory as
92
<pluginname>.png.</para></listitem>
95
<term><option>-s, --screenshot-all</option></term>
96
<listitem><para>Takes a screenshot of each widget and saves it the working directory as
97
<pluginname>.png.</para></listitem>
100
<term><option>-t, --theme <replaceable>name</replaceable></option></term>
101
<listitem><para>Desktop SVG theme to use.</para></listitem>
104
<term><option>-w, --wallpaper <replaceable>name</replaceable></option></term>
105
<listitem><para>Name of the wallpaper plugin. Requires a containment plugin
106
to be specified.</para></listitem>
109
<term><option><replaceable>applet</replaceable></option></term>
110
<listitem><para>Name of applet to view; may refer to the plugin name or be a path
111
(absolute or relative) to a package. If not provided, then an attempt is made to
112
load a package from the current directory.</para></listitem>
115
<term><option><replaceable>args</replaceable></option></term>
116
<listitem><para>Optional arguments of the applet to add.</para></listitem>
119
<term><option><replaceable>--list-remote</replaceable></option></term>
120
<listitem><para>List zeroconf announced remote widgets.</para></listitem>
128
<title>See Also</title>
130
<para>More detailed user documentation is available from <ulink
131
url="help:/plasma-desktop">help:/plasma-desktop</ulink>
132
(either enter this <acronym>URL</acronym> into &konqueror;, or run
133
<userinput><command>khelpcenter</command>
134
<parameter>help:/plasma-desktop</parameter></userinput>).</para>
139
<title>Authors</title>
140
<para><command>plasmoidviewer</command> was written by
141
<personname><firstname>Aaron</firstname><surname>Seigo</surname></personname> <email>aseigo@kde.org</email>.</para>