Core Temp skins specification

Basics

The skin is the the INI-file with the skin settings and the set of images used in the skin. The images must be in the PNG format. This possible to use the alpha channel (transparency) in the images. The INI file must be named coretemp.ini. All files must be placed into the single folder.

INI file contain the section in the square brackets and the values:

[section]
valueName = value

Values can contain the text, numbers, positions, sizes, and colors. There are some syntax rules to define the complex values like the colors and brushes.

Colors definition

Core Temp supports the colors in the RGBA (Red Green Blue Alpha) format. Every color component must be in the range 0-255. The alpha component is the transparency value (0 – transparent, 255 – opaque). The alpha component is optional (it is 255 by default). The color components must be separated by the space.

Brushes and Pens

Core Temp can fill the charts with the Brushes and stroke them with the Pens. In the most cases you can define both Brush and Pen in one parameter. Here is the format description:

color1 = brushName(brush parameters) penName(pen parameters)

The supported brushes are : solidBrush, xGradient, yGradient, radialGradient

The supported pens are: solidPen

solidBrush

Fill the element with to solid color. This brush accept only one parameter - the color. Here is the example of the solid brush that fill the element by the red color:

color1 = solidBrush(255 0 0)

xGradient

Fills the element by the gradient from the left to the right side. This brush accept 2 colors as parameters. The first is the color at the left side and the second color at the right side:

color1 = xGradient(255 0 0, 0 0 255)

yGradient

Fills the element by the gradient from the top to the bottom side. This brush accept 2 colors as parameters. The first is the color at the top side and the second color at the bottom side:

color1 = yGradient(255 0 0, 0 0 255)

radialGradient

Fills the element by the radial gradient This brush accept 2 colors as parameters. The first is the color at the center and the second color at the border:

color1 = yGradient(255 0 0, 0 0 255)

solidPen

Stroke the element with the solid color. The pen accept the two parameters. The first parameter is the color and the second parameter is the stroke width (default is 1):

color1 = solidPen(255 0 0, 2)

Parameters

Elements can depend of the parameters or draw the parapeter text. Parameters can have the text or number values.

load - the core load
temp - the core temperature
temp-max - the maximum temperature
coreidx - core index
cpuidx - cpu index

Section [options]

The section [options] used to define the skin name and author. Possible values:

name – (required) the skin name. This value is shown in the skins list.
author – (optional) the skin author's name
url – (optional) the author's home page

Example:

[options]
name    = Simple
author  = Tordex
url     = http://www.tordex.com

Section [background]

This section defines the background color/image for one core. Possible values:

type - the background type can be image or color.
width - the width of the single core (optional for image)
height - the height of the single core (optional for image)
stateNormal - brush, pen or image for normal plug-in state
stateHover - brush, pen or image when the mouse is over the core
statePressed - brush, pen or image when you click the mouse button

If the value type is image then the values stateNormal, stateHover and statePressed must contain the name of the picture file. When the value type is color then the values stateNormal, stateHover and statePressed must contain the brush and/or the pen definition.

Example of the image background:

[background]
type         = image
width        = 50
height       = 10
stateNormal  = bg.png
stateHover   = bgH.png
statePressed = bgH.png

Example of the color background:

[background]
type         = color
width        = 50
height       = 50
stateNormal  =
stateHover   = yGradient(255 255 255, 128 128 128)
statePressed = xGradient(255 255 255, 128 128 128) solidPen(255 0 0 255, 3)

Elements

Every skin can contain any number of elements. The section of the elements have the format [element#] where # is the number of the element beginning from zero. The values set for elements depends of the value type. But there are some common values:

X - the horizontal position of the element
Y - the vertical position of the element
width - the width of the element
height - the height of the element
data - one of the parameters
type - the type of the element. This value can be one of the following: imagePieChart, colorPieChart, colorHRowChart, colorVRowChart, rotateImageChart, image, rect, text, formatedText, imageHRowChart, imageVRowChart, imageSetChart. Other values depend of the value type.

imagePieChart

This chart takes two images and draw them at same place by cropping them using the pie mask.


image1	image2	imagePieChart result

Possible values:

image1 - the picture for data value
image2 - the background images

Example:

[element0]
type        = imagePieChart
data   = load
image1   = pie-normal-free.png
image2   = pie-normal-used.png
X           = 0
Y           = 0
width       = 50
height      = 50

colorPieChart

This is the simple pie chart that uses the brushes and pens. Possible values:

color1 - the brush and/or pen for data value
color2 - the brush and/or pen for background

Example:

[element0]
type        = colorPieChart
data    = temp
color1   = solidBrush(0 0 255) solidPen(255 0 0)
color2   = solidBrush(0 255 0) solidPen(255 0 0)
X           = 0
Y           = 0
width       = 50
height      = 50

colorHRowChart

This is the simple horizontal row chart that uses the brushes and pens. Possible values:

color1 - the brush and/or pen for data value
color2 - the brush and/or pen for background

Example:

[element0]
type        = colorHRowChart
data = load
color1   = yGradient(0 0 255, 0 0 200) solidPen(255 0 0)
color2   = yGradient(0 255 0, 0 200 0) solidPen(255 0 0)
X           = 0
Y           = 1
width       = 100
height      = 20

colorVRowChart

This is the simple vertical row chart that uses the brushes and pens. Possible values:

color1 - the brush and/or pen for data value
color2 - the brush and/or pen for background

Example:

[element0]
type        = colorVRowChart
data = load
color1   = xGradient(0 0 255, 0 0 200) solidPen(255 0 0)
color2   = xGradient(0 255 0, 0 200 0) solidPen(255 0 0)
X           = 1
Y           = 0
width       = 20
height      = 100

rotateImageChart

The Width and Height values are ignored for this chart. X and Y values means the position of the center point. Other values:

startAngle - the angle when the data value is zero
endAngle - the angle when the data value is the maximum
imgCenterX - the horizontal position of the center point in the image
imgCenterY - the vertical position of the center point in the image
image - the picture file to draw

[element0]
type         = rotateImageChart
data = load
image        = needle.png
imgCenterX   = 3
imgCenterY   = 24
startAngle   = -120
endAngle     = 120
X            = 38
Y            = 38

image

Draw the image. The values can be following:

image - image file to draw if the data value is empty.

[element2]
type     = image
image   = myimage.png
X        = 0
Y        = 0

rect

Draw the rectangle with brush and/or pen. The values can be following:

color - the brush and/or pen to draw if the data value is empty.

[element1]
type     = rect
color   = solidBrush(255 0 0 100)
X        = 0
Y        = 0
width    = 10
height   = 10

text

Draw the parameter. Possible values:

color - the text color
unit - can be: show - show the units (%, °F, °C); hide - to hide the units; short - to show the short units (°,%)
font - the font name
align - the text alignment, can be left, right or center
bold - to make text bold assign 1, else 0
italic - to make text italic assign 1, else 0
glowSize - the glow size around the text
glowColor - the glow color
antialias - can be 0 to disable text antialiasing, 1 to enable text antialiasing

[element3]
type      = text
align     = center
data      = temp
unit   = show
font      = Tahoma
color     = 255 255 255
X         = 1
Y         = 18
width     = 148
height    = 10

formattedText

Draw the formatted text. The string can contain any text. The parameters must in form: {paramName}. Possible values:

color - the text color
text - the text to draw
font - the font name
align - the text alignment, can be left, right or center
bold - to make text bold assign 1, else 0
italic - to make text italic assign 1, else 0
glowSize - the glow size around the text
glowColor - the glow color
antialias - can be 0 to disable text antialiasing, 1 to enable text antialiasing

[element3]
type    = formattedText
align   = center
text    = {cpuidx}/{coreidx}: {load}
color   = 255 255 255
font    = Tahoma
X       = 1
Y       = 18
width   = 148
height  = 10

imageHRowChart

Draw the horizontal row chart using the images. Supported values:

align - the align of the chart. Can be left or right
drawType - defines how to draw the row. Can be one of the following: tile, stretch, crop.
image1 - image for data value
image2 - image for background

[element1]
type       = imageHRowChart
data   = load
align      = left
drawType   = stretch
image1  = hTile.png
X          = 1
Y          = 13
width      = 148
height     = 11

imageVRowChart

Draw the vertical row chart using the images. Supported values:

align - the align of the chart. Can be top or bottom
drawType - defines how to draw the row. Can be one of the following: tile, stretch, crop.
image1 - image for data value
image2 - image for background

[element0]
type       = imageVRowChart
data   = temp
align      = bottom
drawType   = tile
image1  = imgTile.png
X          = 2
Y          = 4
width      = 6
height     = 36

imageSetChart

Draw the chart from the set of the images. Supported values:

isVertical - the images slices are vertical
count - images count in the set
image - images set for core

[element0]
type       = imageSetChart
data = load
count      = 28
image      = imgSet.png
isVertical = 0
X          = 10
Y          = 7
width      = 53
height     = 58

Here is the imgSet.png:

imageHistogramStretch, imageHistogramTile

Draw the histogram with the images. Supported parameters for data are temp and load only. Other values:

startFrom - can be one of the values: left, right, top, bottom
dir - the dirrection of the histogram: positive or negative
image - the image file
margins - the margins for sretching (in format <left> <top> <right> <bottom>)

colorHistogram

Draw the histogram with the color. Supported parameters for data are temp and load only. Other values:

startFrom - can be one of the values: left, right, top, bottom
dir - the dirrection of the histogram: positive or negative
color - defines the brush and pen for the histogram
step - (default 1) defines the step for the values