themes.html

系统任务管理器

Cap images drawn in the left and right frames can be turned off for
specific monitors.  This is new in GKrellM version 2.1.0 and 1.3.0.
<pre>
	cap_images_off monitor-name
</pre>

<h4>Borders</h4>

Borders for images are specified with comma separated numbers in the order:<br>
&nbsp &nbsp &nbsp  <i>left border, right border, top border, bottom border</i>
<p>
Borders for the main GKrellM window frame images.
<pre>
	frame_top_border = l,r,t,b
	frame_bottom_border = l,r,t,b
	frame_left_border = l,r,t,b
	frame_right_border = l,r,t,b
</pre>
Borders for the spacer images.  Only the left and right values are used.
These are new in GKrellM version 2.1.0 and 1.3.0.
<pre>
	spacer_top_border = l,r,x,x
	spacer_bottom_border = l,r,x,x
</pre>
Borders for the frame overlap areas.  Only the top and bottom values are used.
These are new in GKrellM version 2.1.0 and 1.3.0.
<pre>
	frame_left_chart_border = x,x,t,b
	frame_right_chart_border = x,x,t,b
	frame_left_panel_border = x,x,t,b
	frame_right_panel_border = x,x,t,b
</pre>

<h4>Chart data colors</h4>
The data colors plotted on the charts are plotted in two different ways.
If the images data_in.xxx, data_in_grid.xxx, data_out.xxx, and
data_out_grid.xxx exist in the theme dir, they are used to plot data.
If they do not exist, then the colors set here are used.
Grid colors are drawn where the plotted data crosses a grid line.
This allows grid lines to "show through" on high density charts.
Colors are hex triplets ( #rrggbb ) or rgb.txt color names.  Put quotes
around two word rgb_color_names.
<pre>
	chart_in_color       = { #rrggbb | rgb_color_name }
	chart_in_color_grid  = { #rrggbb | rgb_color_name }
	chart_out_color      = { #rrggbb | rgb_color_name }
	chart_out_color_grid = { #rrggbb | rgb_color_name }
</pre>

<h4>Chart view and grid</h4>
The height of the bg_separator image that separates chart data views.
<pre>
	bg_separator_height = 2
</pre>

Some tweaking on drawing the background grid lines.  0 is normal and 1
inhibits grid line drawing at the top and bottom of charts.
This is useful for bg_chart pixmaps that have 3D shading at the top and
bottom and is a cosmetic effect.
<pre>
	bg_grid_mode = {0,1}
</pre>

The default is to fill chart text rectangle extents with the chart
background so the text will be more readable on top of data.  Set this
to draw chart text without first filling (this will also prevent chart
text caching so there will be slightly increased CPU usage.
<pre>
        chart_text_no_fill = {true,false}
</pre>

<h4>Net monitor LEDS</h4>
Negative x values here mean justify |x| pixels from right frame.
Positive x values mean justify x pixels from left frame.
Where to put the LEDs of each net interface monitor in its panel:
<pre>
	rx_led_x = x
	rx_led_y = y
	tx_led_x = -x
	tx_led_y = y
</pre>

<h4>Animated mail decal</h4>
Number of frames in the stationary animated mail decal.  Delay is
number of update ticks between each frame.  Set these if you replace
the default mail decal envelope animation.
<pre>
	decal_mail_frames = 18
	decal_mail_delay = 1
</pre>

<h4>Alert decals</h4>
Number of frames in the alarm and warn decal animation.  Set these if you
have custom decal_alarm.png or decal_warn.png images.
<pre>
	decal_alarm_frames = 10
	decal_warn_frames = 10
</pre>

<h4>Slider krell</h4>
There is a krell image used as a slider control.  Set its depth and x_hot
if you replace the default.  You can have a bar mode krell slider if you
set krell_slider_expand to "bar-mode" (for this depth should be 1).
There is one slider krell for all meter areas and panel areas, so
positioning style settings can be applied only if a monitor has programmed
the ability and this would be documented elsewhere.
<pre>
	krell_slider_depth = d
	krell_slider_x_hot = x
	krell_slider_expand = {left | right | bar-mode}  # New in 1.2.5
</pre>

<h4>Panel buttons</h4>
Borders for the panel and meter buttons.
<pre>
	button_panel_border = l,r,t,b
	button_meter_border = l,r,t,b
</pre>

<h4>Fonts</h4>
In gkrellm versions prior to 2.2.0 default fonts could be set in the gkrellmrc,
but this is no longer recognized and users will just config their
own font preferences if they don't like the built in default.


<h4>Spacer height</h4>
If you use any top or bottom spacer images for monitors you can set something
other than the default 3 pixel height.
The height of the spacers may be set for all monitors, or independently
for chart and meter monitor types, or specifically for individual monitors.
"mon" is a chart or meter monitor
style name as listed below for styles (eg, clock, fs, gkrellmms, etc).

<pre>
	spacer_top_height = h               # set for all monitors
	spacer_bottom_height = h

	spacer_top_height_chart = h         # set for chart type monitors
	spacer_bottom_height_chart = h

	spacer_top_height_meter = h         # set for meter type monitors
	spacer_bottom_height_meter = h

	spacer_top_height mon = h           # set only for monitor "mon"
	spacer_bottom_height mon = h
</pre>

<h4>Extension hooks</h4>
These are ways to get options set for image or feature extensions which
plugins will use.  Builtins may also use these hooks to set parameters.
<p>
If a monitor uses a background image in addition to the standard bg_panel
or bg_chart and its code allows for the image to be themed,
a hook to set the border for that image may have been provided.
It will be necessary to check plugin documentation to find the names, but for
example, say a plugin "frump" uses an additional background image
"bg_special.png" and for setting its border has added an image border
hook "frump_bg_special".  Then if you have made a theme image
frump/bg_special.png for this plugin, you can set the image border with:
<pre>
	set_image_border  frump_bg_special = l,r,t,b
</pre>

Plugins also have a way to request integer or string initialization
values from the gkrellmrc.  Again, check for plugin Theme file documentation.
There could be options like:
<pre>
	set_integer frump_some_integer = n
	set_string  frump_some_color_string = "deep sky blue"
</pre>

New in version 1.2.9, monitors may also define custom styles by adding
a custom style name field to the StyleMeter or StylePanel lines.   These are
probably most useful when a monitor has additional krells.  If these exist
they should be documented in a plugin's Themes or README file.  For example,
if the frump plugin has a standard default krell and one extension krell
which the plugin writer has named "gas-gauge", then the gkrellmrc can first
set values for the standard krell:
<pre>
    StyleMeter  frump.krell_depth = 5
    StyleMeter  frump.krell_yoff = 2
    StyleMeter  frump.krell_expand = bar-mode-scaled
</pre>

The extension gas-gauge krell will use plugin defaults if you do not set
any of its style values.  But when you set its first style value, it will
be initialized to the currently set standard krell values.  So you only
need to specify values that are different from the standard krell, eg:
<pre>
    StyleMeter  frump.gas-gauge.krell_yoff = 10
    StyleMeter  frump.gas-gauge.krell_expand = none
</pre>

*Note: if you theme a plugin, it is a good idea to include all of its themable
parameters in your gkrellmrc in case the plugin's default values change and
break your theme.  Do not rely on the default values.


<h4>Builtin monitor extension hooks</h4>
CPU monitor nice data color (both must be set and they won't be recognized
if there are theme 	cpu/nice.png images):
<pre>
	set_string cpu_nice_color color_string
	set_string cpu_nice_grid_color color_string
</pre>

Net timer monitor border for the optional bg_timer.png image.  If bg_timer.png
exists, it will be placed inside the top margin and bottom margin and at
the left margin of the timer panel.  The timer display will be placed
inside of the borders.
<pre>
	set_image_border timer_bg_timer 1,1,2,2
</pre>

Memory monitor krell_buffers optional image:
<pre>
	set_integer mem_krell_buffers_yoff 0
	set_integer mem_krell_buffers_depth 1
	set_integer mem_krell_buffers_x_hot -1
	set_string  mem_krell_buffers_expand none   # New in 1.2.5
</pre>
Memory monitor krell_cache optional image:
<pre>
	set_integer mem_krell_cache_yoff 0
	set_integer mem_krell_cache_depth 1
	set_integer mem_krell_cache_x_hot -1
	set_string  mem_krell_cache_expand none     # New in 1.2.5
</pre>


<h4>Style settings for the monitors</h4>
Some options can be set to apply globally to areas of all similar monitors,
or can be set to individually apply only to an area of a specific monitor.
This is done with Style lines which can have a global '*' scope name or a 
specific monitor name.  Since these theme specifications begin at
the monitor drawing area level, there are Style lines for each area.
There are StyleChart and StylePanel lines for the chart and panel
areas in the Chart monitors, and a StyleMeter line for the
meter areas in the Meter monitors.
<p>
The builtin Chart monitors are: <i>cpu, proc, disk, inet, net</i>.<br>
To apply a setting to a particular monitor, replace the '*' with
the monitor name.  Plugin Chart monitor style names may be available
which can also be used in place of the '*'.
<p>
The builtin Meter monitors are: <i>apm, cal, clock, fs, host, mail, mem,
   swap, timer, sensors, uptime.</i><br>
Where for backward compatibility, "apm" is used for the Battery monitor.
To apply a setting to a particular monitor, replace the '*' with
the monitor name.  Plugin Meter monitor style names may be available
which can also be used in place of the '*'.
<p>
Notes about Style settings for chart, panel, and meter areas:
<ul>
<li>textcolor line settings are:
<pre>
	       color shadow_color drawing_effect
</pre>
       color or shadow_color may be hex #rrggbb or text rgb_color_names, with
       two word rgb_color_names enclosed in quotes.
</li><li>
	transparency settings are:
<ul><li> 1 - Forces a totally transparent chart, panel, or meter area.</li>
     <li>2 - For a partially transparent chart, panel, or meter area.</li>
</ul>
</li><li>
	For charts only: if top and bottom margins are set, the margin regions
       are converted to spacers and are excluded from the active drawing area.
</li>
</ul>
<p>
Notes about Style settings for panel or meter areas only:
<ul>
<li>label_position is a percent of chart width, so a position of 50
       would horizontally center a label.
</li><li>
<li>label_yoff (new in 2.2.2) is a pixel offset for labels from the top of
	a panel.  If label_yoff is <= 0 (the default), labels are placed at the
	panel top margin.  Use this if for some reason you want to control a
	label's y postion independent of the panel top margin setting.
	Not all panels use labels, so this may be of special case usefulness.
</li><li>
		margins may be used to set all margins at once, or you may individually
       set left_margin, right_margin, top_margin, bottom_margin.  They are used
       for positioning of labels and decal.  margins, left_margin, and
       right_margin are new in 1.2.9.  The old "margin" (no 's') which sets
       both left and right margin to the same value may still be used.
       Krell margins are set independently of panel margins with
       krell_left_margin and krell_right_margin.  Krell vertical positioning
       uses krell_yoff and there are no top or bottom krell margins.
</li><li>
   	krell_depth is the number of frames in the krell image.
</li><li>
   	krell_x_hot is an offset into a krell frame. Set to -1 to set x_hot
	   to center.
</li><li>
	krell_yoff is an offset from a panel or meter area top for krell
       drawing.
</li><li>
	scroll_text_cache_off is a boolean that will prevent use of a scroll text
		decal pixmap for scrolling.  Set this to "yes" if the background
		of scrolling text does not blend well with your panel background on
		monitors such as host, fs, mem, and swap.
		This is new for version
	    2.2.0 and keep in mind there can be an increased CPU usage tradeoff
		when this is set.   Various plugins will probably be updated to use
		scrolling text decals.
</li><li>A theme can assume the <i>large_font, normal_font, small_font</i>
		strings used in font settings will be relatively sized as implied
		by their names even though a user is free to select any font
		he likes for each.
</li>
</ul>

<h4>Style settings applicable to the chart areas of Chart monitors</h4>
<pre>
	StyleChart	*.border = l,r,t,b
	StyleChart	*.margins = x,x,t,b
	StyleChart	*.textcolor = #rrggbb #rrggbb {shadow | none}
	StyleChart	*.alt_textcolor = #rrggbb #rrggbb {shadow | none}
	StyleChart	*.font = {large_font | normal_font | small_font}
	StyleChart	*.transparency = { 1 | 2 }
</pre>

<h4>Style settings applicable to the panel areas of Chart monitors</h4>
<pre>
	StylePanel	*.border = l,r,t,b
	StylePanel	*.label_position = { 0-100 | center | none }
	StylePanel	*.label_yoff = n
	StylePanel	*.margins = l,r,t,b
	StylePanel	*.left_margin = m
	StylePanel	*.right_margin = m
	StylePanel	*.top_margin = m
	StylePanel	*.bottom_margin = m
	StylePanel	*.textcolor = #rrggbb #rrggbb {shadow | none}
	StylePanel	*.alt_textcolor = #rrggbb #rrggbb {shadow | none}
	StylePanel	*.font = {large_font | normal_font | small_font}
	StylePanel	*.alt_font = {large_font | normal_font | small_font}
	StylePanel	*.krell_depth  = d
	StylePanel	*.krell_x_hot  = x
	StylePanel	*.krell_yoff  = y
	StylePanel	*.krell_expand  = none
	StylePanel	*.krell_left_margin  = 0
	StylePanel	*.krell_right_margin  = 0
	StylePanel	*.transparency = { 1 | 2 }
</pre>

<h4>Style settings applicable to the meter areas of Meter monitors</h4>
<pre>
	StyleMeter	*.border = l,r,t,b
	StyleMeter	*.label_position = { 0-100 | center | none }
	StyleMeter	*.label_yoff = n
	StyleMeter	*.margins = l,r,t,b
	StyleMeter	*.left_margin = m
	StyleMeter	*.right_margin = m
	StyleMeter	*.top_margin = m
	StyleMeter	*.bottom_margin = m
	StyleMeter	*.textcolor = #rrggbb #rrggbb {shadow | none}
	StyleMeter	*.alt_textcolor = #rrggbb #rrggbb {shadow | none}
	StyleMeter	*.font = {large_font | normal_font | small_font}
	StyleMeter	*.alt_font = {large_font | normal_font | small_font}
	StyleMeter	*.krell_depth  = d
	StyleMeter	*.krell_x_hot  = x
	StyleMeter	*.krell_yoff  = y
	StyleMeter	*.krell_expand  = none
	StyleMeter	*.krell_left_margin  = 0
	StyleMeter	*.krell_right_margin  = 0
	StyleMeter	*.transparency = { 1 | 2 }
	StyleMeter	*.scroll_text_cache_off = { yes | no }
</pre>
</blockquote>


<hr>
	<address>
	<p align=center>
	<a href="http://www.gkrellm.net" name="www.gkrellm.net">GKrellM Home</a>
	<br>
	Bill Wilson <A HREF="mailto:bill--at--gkrellm.net">bill--at--gkrellm.net</A>
	<br>
	</p>
	</address>

</body>
</html>