themes.html

系统任务管理器

</li>
<li>
decal_warn.png<br>
	Same as decal_alarm.png, except it is triggered by a less serious
	warning event.  Set the number of frames for this image in the gkrellmrc:
&nbsp &nbsp &nbsp  decal_warn_frames n
</li>
<li>
decal_misc.png<br>
	A vertical stack of decals used for various monitors.  I have tried
	to make these theme generic, but you could touch them up to better
	match your theme.
</li>
<li>
decal_button.png<br>
	A general purpose button image which monitors may scale to different
	sizes.  There are two vertically stacked button image frames with the
	button out image on top of the button pressed image.  This image is not
	used in GKrellM version 1.x.
</li>
</ul>
<h4>Optional data plotting images</h4>
<ul>
<li>
data_in.png</li><li>
data_in_grid.png</li><li>
data_out.png</li><li>
data_out_grid.png<br>
	If these images exist they are used to plot data on the charts.
	You can have textured or 3D plotted data to go with your bg_chart.
	The data_in_grid and data_out_grid should be 1 or 2 pixel high
	images and are drawn where the plotted data crosses a chart grid line.
	If any of these do not exist data plotting falls back to using the
	in_color and out_color specified in gkrellmrc.  Any shading effect you
	put into a data image should probably track shading on your bg_chart.
	Shading effects are not very apparent on low data density charts,
	so get a big compile or net download going to see the effects.
</li>
</ul>

<h4>Optional spacer images </h4>
<ul>
<li>
spacer_top.png</li><li>
spacer_bottom.png</li><li>
spacer_top_chart.png</li><li>
spacer_bottom_chart.png</li><li>
spacer_top_meter.png</li><li>
spacer_bottom_meter.png<br>
	Spacer images form a visual separator between monitors.  Spacers are
	rendered to a default height of 3 pixels unless set otherwise in the
	gkrellmrc.  Borders for these images are set in the gkrellmrc with
	spacer_top_border and spacer_bottom_border lines.  Spacer images can
	be set for all monitors, chart styled monitors only, meter styled only,
	Theme subdirectories may have a custom version of this image.
	For example, a meter monitor with two panels can be either of:
<pre>
	    without spacers:              with spacers:
	---------------------         ---------------------    spacer_top
	|                   |         ---------------------
	|                   |         |                   |    bg_meter
	---------------------         ---------------------
	|                   |         |                   |    bg_meter
	|                   |         ---------------------
	---------------------         ---------------------    spacer_bottom
</pre>
</li>
</ul>

<h4>Optional cap images </h4>
<ul>
<li>
cap_top_left_chart.png</li><li>
cap_bottom_left_chart.png</li><li>
cap_top_right_chart.png</li><li>
cap_bottom_right_chart.png</li><li>
cap_top_left_meter.png</li><li>
cap_bottom_left_meter.png</li><li>
cap_top_right_meter.png</li><li>
cap_bottom_right_meter.png<br>
	Cap images are drawn on the left and right frames aligned to the
	top and bottom of each monitor.  Left cap images are left adjusted
	in the left frame and right cap images are right adjusted in the right
	frame.  They can be turned off for specific monitors.  Meter monitors
	can be a single panel so it's probably difficult to design a theme with
	both top and bottom meter cap images.  These images are not scaled.
	</li>
</ul>

<h4>Builtin monitor custom images</h4>
<ul>
<li>
cpu/nice.png</li><li>
cpu/nice_grid.png<br>
	Used to plot the cpu nice time data in a color different from either
	the data_in or data_out colors.  If these images don't exist and the
	cpu_nice_color and cpu_nice_grid_color strings are not
	set in the gkrellmrc, cpu nice time will use the data_in color.
</li><li>
mail/krell_penguin.png<br>
	This is the multi frame penguin animation for new mail notification.
	However, it does not have to be a penguin - any alternative will do.
	Frame 0 is displayed when there is no new mail to announce and so
	should be left blank.  When the penguin animation is enabled, new
	mail to announce triggers the display of frames 1 through depth-2
	as an animation moving across the width of the mail monitor panel. 
	Since frame depth-1 is not fully visible, it is not displayed and
	is left blank.  The depth must be specified in the gkrellmrc:
&nbsp &nbsp &nbsp StyleMeter mail.krell_depth = d
</li><li>
mail/decal_mail.png<br>
	This is the stationary envelope animation in the mailcheck panel.
	If envelope animation is enabled, frame 1 is shown by default and
	a new mail count increase triggers frames 1 through depth-1 to be
	shown as an animation.
	If envelope animation is disabled, frame 1 is shown by default and
	frame 0 is shown when a new mail count increase is detected.
	This image is applied by default to all themes.
	The number of frames is specified in the gkrellmrc file:
&nbsp &nbsp &nbsp decal_mail_frames n
</li><li>
mem/krell_buffers.png<br>
	An extra krell in the mem panel which shows kernel buffers usage.  It
	should probably be de-emphasized with respect to the main panel krell.
	Offset and depth parameters for it can be set in the gkrellmrc
	(see "Notes on making a GKrellM theme" for expand-mode options):
<pre>
	    set_integer mem_krell_buffers_yoff y
	    set_integer mem_krell_buffers_depth d
	    set_integer mem_krell_buffers_x_hot x
	    set_string  mem_krell_buffers_expand expand-mode
</pre>
</li><li>
mem/krell_cache.png<br>
	An extra krell in the mem panel which shows kernel buffers usage.  It
	should probably be de-emphasized with respect to the main panel krell.
	Offset and depth parameters for it can be set in the gkrellmrc
	(see "Notes on making a GKrellM theme" for expand-mode options):
<pre>
	    set_integer mem_krell_cache_yoff y
	    set_integer mem_krell_cache_depth d
	    set_integer mem_krell_cache_x_hot x
	    set_string  mem_krell_cache_expand expand-mode
</pre>
</li><li>
net/decal_net_leds.png<br>
	A vertical stack of 4 leds in the order:<br>
<pre>
			rx_off, rx_on, tx_off, tx_on
</pre>
	The net LEDs are stenciled onto the bg_panel backgrounds of Net
	chart monitors.  They may have non rectangular shapes with
	transparency.  The rx and tx LEDs may overlap in complex ways
	because they are individually stenciled onto the net bg_panels.
</li><li>
timer/bg_timer.png<br>
	This is a background for the timer part of the TimerButton meter
	monitor and is superimposed on top of its bg_meter.
	It can be used to highlight the timer and visually separate it
	from the button.  A border can be set for it in the gkrellmrc:
<pre>
		set_image_border timer_bg_timer l,r,t,b
</pre>
</li><li>
sensors/bg_volt.png<br>
	A framing background for the voltage values of the voltage sensor
	monitor.  Run "gkrellm -demo" using the default theme to see it if
	you don't have hardware sensor monitoring.  You can also set a border
	for this image in the gkrellmrc:
<pre>
		set_image_border sensors_bg_volt l,r,t,b
</pre>
	Probably the top and bottom border should be only 1 or 2.
</li><li>
timer/decal_timer_button.png<br>
	This is a vertical stack of button images for the button in the
	TimerButton monitor.  There are 4 frames in the order:
<pre>
		off, pressed, standby, on
</pre>
</li>
</ul>
</blockquote>


<h3>Notes on making a GKrellM theme</h3>
<blockquote>
<ol>
<li>
	A theme directory can exist anywhere for development purposes and can be
	specified on the command line:
<pre>
       gkrellm -t theme_dir
</pre>
   Hit the F5 key to reload a theme as you make changes.
</li><li>
	Detail images are drawn on bg_panel or bg_meter backgrounds as
   layers and each image may have transparency.
</li><li>
Krells have several style parameters which you can set in the gkrellmrc.
   But note: it is possible for a plugin coder to write code such that his
   krell will not honor these settings.
<ul>
<li>
  krell_yoff<br>
	Adjusts a krell's vertical offset into a panel or meter area.
</li><li>
  krell_depth<br>
	To build a krell with depth, vertically stack krell images
     in a krell_panel or krell_meter image and specify the number of frames
     in a krell_depth line in the gkrellmrc.  The frame displayed will
     be a function of the depth and horizontal x position of the krell:
<pre>
       Depth 1: One frame displayed at all positions.
             2: Display frame 0 at x = 0, frame 1 at all other positions.
         n > 2: Display frame 0 at x = 0, frame n-1 at x = full_scale, and
                remaining frames at positions proportional to x/full_scale.
</pre>
</li><li>
	krell_x_hot<br>
	This is an offset in pixels from the left edge of a krell image.
     Krell images are drawn so that the krell x_hot spot is drawn at the
     current krell position in a panel or meter area (except for bar-mode
     krells, see below).
</li><li>
	krell_left_margin & krell_right_margin<br>
     The range of krell motion across a panel width may be constrained
     between a left and right margin where the margins are number of pixels
     from the left or right panel edge respectively.  These style setings are
     new in GKrellM version 1.2.9.
</li><li>
	krell_expand<br>
	The default is for a krell to be drawn at the same size
     as its original image.  But, if a krell_expand value is set, the krell
     width will be rendered to match the width of the GKrellM window.
     The krell_expand values are:
<ul>
<li>left<br>
			The krell image area from the left edge to the x_hot spot is
           rendered to fit the GKrellM monitor width.  Look at the
           GKrellMSS plugin's VU meter krells for examples of this krell type.
</li><li>
	right<br>
			The krell image area from the x_hot spot to the right edge is
           rendered to fit the GKrellM monitor width.  This may not be useful.
</li><li>
	bar-mode<br>
			The total krell image width is rendered to fit the GKrellM
           monitor width.  Additionally, the krell x_hot spot is ignored.
           Instead, the krell position is indicated by drawing only the portion
           of the rendered krell image from its left edge to the current
           krell position.  The visual appearance is then a static "bar"
           across the panel width with only the left portion up to
           the current krell position visible.  This is new in version 1.2.5.
</li><li>
left-scaled, right-scaled, bar-mode-scaled<br>
           Same as above except the rendering of the krell width is scaled
           to fit the width between the krell left and right margins.  If both
           krell_left_margin and krell_right_margin are zero, these modes are
           equivalent to left, right, and bar-mode respectively.  These are
           new in version 1.2.9
</li><li>
     To sumarize the difference between a bar-mode and left expanded krell:<br>
        The bar-mode krell position is fixed on a panel and only a
          fractional part of its width is drawn.  The draw is from the krell
          left margin to a right position between the left and right margins
          that corresponds to the current krell value.
        The left expanded krell position is moved so its x_hot spot is
          placed on a panel at a position corresponding to its current krell
          value.  The entire krell width is drawn but will be clipped at the
          krell left and right margins.
</li>
</ul>
</ul>
<li>Run "gkrellm -demo" to see some less frequently used features you may
   not have available or enabled, such as cpu temps or the battery monitor.
</li>
</ol>
</blockquote>


<h3>Theme Alternatives</h3>
<blockquote>

If there is a line in your gkrellmrc:
<pre>
    theme_alternatives = N
</pre>
then you can have 1 to N different gkrellmrc and image alternatives
that can be selected in the Themes tab.  For each alternative N,
you can have an optional gkrellmrc_N whose options will override any
set in the base level gkrellmrc.  If any image_N.png exists, it will
be used in place of the base image.png.  This can be used to give
some flexibility to your theme.  You could have more than one frame
style or different font colors and sizes.  For example if you have
<pre>
    theme_alternatives = 2
</pre>
Then you would have 3 gkrellmrc files:
<pre>
	gkrellmrc        (always applied)
	gkrellmrc_1      (applied after gkrellmrc for theme alternative 1)
	gkrellmrc_2      (applied after gkrellmrc for theme alternative 2)
</pre>
And you can have alternative images selectively applied depending on
the alternative selected.  If you had these images:
<pre>
	bg_meter.png
	krell.png
	krell_1.png
	fs/krell.png
	fs/bg_meter_2.png
</pre>
then, these images would be used:
<pre>
Default Alternative 0:
	Base images: bg_meter krell    fs monitor images: fs/krell bg_meter
Alternative 1:
	Base images: bg_meter krell_1  fs monitor images: fs/krell bg_meter
Alternative 2:
	Base images: bg_meter krell    fs monitor images: fs/krell fs/bg_meter_2
</pre>
</blockquote>


<h3>The gkrellmrc file</h3>
<blockquote>

Adjustments to label positions, margins, label colors/fonts, image borders,
krell parameters, frame rendering, etc  are made in the gkrellmrc file.
Setting these values may have a variable effect on different monitors
because the programmer may use the values to differing degrees.  For
example, margins may affect a label or some text decal but not affect
other text decals because the programmer explicitely centers the decal.
<p>
The possible gkrellmrc lines are listed here.
<p>
The author line credits the theme maker.  This will appear in the Themes
configuration window.
<pre>
	author = "yourname  email address"
</pre>
Theme alternatives are possible, see above.
<pre>
    theme_alternatives = N
</pre>

If allow_scaling is true, then net LED position and size is scaled according
to the chart_width/chart_width_ref ratio.  chart_width_ref is the width
you use for designing images and placing LEDs.
<pre>
	chart_width_ref  = w
	allow_scaling    = {true | false}
</pre>

<h4>Frames</h4>
Frames can be rendered to heights and widths different from the
drawn image sizes.  0 means use the drawn image width or height.
<pre>
	frame_top_height  = h
	frame_bottom_height  = h
	frame_left_width  = w
	frame_right_width  = w
</pre>

Regions of the bg_chart, bg_panel, or bg_meter images may be overlapped onto
the left and right frames.  A simple use would be to overlap some bg_chart
pixels so a chart can have a surrounding bevel outside of the active chart
drawing area.  This would be used in conjunction with giving the chart a
top and bottom margin (with StyleChart *.margins) since a top and bottom chart
margin is converted to a spacer that is also outside the active drawing area.
The panel overlap values are used for bg_panel, bg_meter, space_top, and
spacer_bottom images.  These are new in GKrellM version 2.1.0 and 1.3.0.
<pre>
	frame_left_chart_overlap = n
	frame_right_chart_overlap = n
	frame_left_panel_overlap = n
	frame_right_panel_overlap = n
</pre>

Spacers can also overlap the left and right frames.  The overlap values
are applied to all spacers, but overlapping can be turned off for
specific monitors.  These are new in GKrellM version 2.1.0 and 1.3.0.
<pre>
	frame_left_spacer_overlap = l
	frame_right_spacer_overlap = r
	spacer_overlap_off monitor-name
</pre>