rainmeter.docx

1、rainmeterStep.rc：RainmeterIniFile如果Rainmeter.ini没有被放在默认的位置，可以用它来指向定义。RainmeterSkinPath定义skin文件夹的路径，但必须在以独立的子文件夹的形式放在skins文件夹下。RainmeterPluginPath定义插件文件夹路径。RainmeterCurrentConfig目前正起作用的配置文件名，这可以用来强制使用某些配置。你必须同时定义 RainmeterCurrentConfigIni。RainmeterCurrentConfigIni目前正起作用的配置文件。(仅为配置文件，并非路径)RainmeterWin

2、dowX设定窗口的X坐标。RainmeterWindowY设定窗口的Y坐标。Rainmeter.ini文件主要由Rainmeter和Statistics两部分组成，Rainmeter部分包含 一般设定可以用来改变RM的行为表现。此配置是作为所有被打开的Config文件的默认值。一旦Config被打开即会在Rainmeter.ini下将 配置写入自己的那部分中。Statistics下包含着大部分的Measures，请不要手动去修改它。TrayMeasures是个特别的部分，用来定义系统托盘图标的，只要设定了一个正常的有意义的值。以下这些必须放在Rainmeter下(或者放在各个Config中)：

3、WindowX窗口的X坐标，负值有效，相对于右边屏幕位置WindowY窗口的Y坐标，相对于屏幕底部位置。AllowNegativeCoordinates如果设置成1，负坐标将可以正常定义；如果设置成0，则会从桌面右下角抵扣。SavePosition如果设置成1，窗口的位置会被记录在Rainmeter.ini文件中，当RM下次启动时会仍然出现在那个 位置。AlwaysOnTop如果设置成1，此窗口会始终出现在其它窗口的前面，也就是所谓的的始终前置窗口。如果设置成0，窗口位置是 Normal，如果设置成-1，则窗口会后置于其它窗口。-2代表钉在桌面上，2则代表是前置级别最高，前置于其他前置窗口。注

4、意的是-2钉在桌面上仅在 Explorer-Shell下工作。Draggable如果设置成1，窗口可以被鼠标拖动，如果设置成0，这窗口固定。SnapEdges如果设置成1，则窗口在移动中会自动边缘吸附。HideOnMouseOver如果设置成1，当鼠标指针移动到窗口范围内时，窗口便会消失。当鼠标指针移开窗口范围时，窗口又会重新出现。如果按住Shift、Ctrl和Alt时移动鼠标，则窗口不会消失或重现。StartHidden如果设置成1，RM会在系统启动时隐藏，你可以使用!RainmeterShow-bang来使他显形。NativeTransparency如果设置成1则支持本地透明（仅限Win2

5、K&XP）。AlphaValue窗口的透明值，数值范围在0255之间。需要开启NativeTransparency。ClickThrough如果设置成1则鼠标穿透，需要开启NativeTransparency。LeftMouseDownAction当鼠标左键在RM窗口上按下后所执行的命令，注意此处不支持拖动。RightMouseDownAction当鼠标右键在RM窗口上按下后所执行的命令。LeftMouseUpAction当鼠标左键在RM窗口上放开后所执行的命令。RightMouseUpAction当鼠标右键在RM窗口上放开后所执行的命令，注意此处不支持右键环境菜单。MouseOverActi

6、on当鼠标掠过RM窗口时所执行的命令。MouseLeaveAction当鼠标离开RM窗口时所执行的命令。DesktopWorkArea设定桌面工作区域，定义工作区域最大的窗口覆盖，用四个逗号进行值的分割。(e.g. DesktopWorkArea=0,0,1920,1200)注意如果移动Taskbar会重新设定成Windows默认值（改变屏幕分辨率也会出现同 样情况）。TrayIcon设置成0可以屏蔽系统托盘图标。FadeDuration定义窗口淡出的时间值，时间单位为毫秒，设置为0，此项无效。TrayExecuteL, TrayExecuteM, TrayExecuteR, TrayExec

7、uteDL, TrayExecuteDM, TrayExecuteDR鼠标双击系统托盘图标时执行的命令，注意TrayExecuteR权限高于系统托盘的环境菜单。OnRefreshActionConfig刷新时执行的命令。刷新同样会在Config第一次运行时起作用。ConfigEditor定义RM的配置文件编辑器应用程序，默认为Notepad记事本。以下部分必须放在TrayMeasure部分下：Measure托盘显示的名称。TrayMeter这可以是直方图或位图。TrayColor1定义直方图的背景颜色。TrayColor2定义直方图的前景颜色。TrayBitmap定义托盘所用的位图的名称。位图

8、的帧数可以任凭你所想，不过大小必须限制在16*16上。路径需关联于 Rainmeters-Skins文件夹。窗口内的Y坐标，在结尾以加上“r”的形式可以将坐标与前一个meter相关联 (e.g. Y=-10r)。也可以用大写“R”来与前一个Meter的底部边缘关联。WMeter的宽度。如果你 使用可计算出宽度的图片或者字符串表的话可以不需要做定义。如果你使用桌面作为整个RM的背景则需要定义所有插件的长度和宽度，不然窗口的尺寸可能出现计 算错误的情况。HMeter的长度。其余同上“W”参数值。Hidden如果设置成1则Meter隐藏。LeftMouseDownActionRightMouseDo

9、wnActionLeftMouseUpActionRightMouseUpActionMouseOverActionMouseLeaveAction这些和全局设定效果相同， 但仅应用于特定的Meter。此处的设置权限高于全局设置。注意：当窗口被允许拖动的情况下LeftMouseUpAction无效。你需要用DragMargins定义可拖动区域以此来避免Meter的重叠操 作。UpdateDivider此值决定Meter的更新间隔。此值与Update值绑定。比如当Update=1000，UpdateDivider=30则Meter每30s更新一 次。默认值为1.SolidColorMeter的背

10、景色。SolidColor2第二颜色的背景梯 度(颜色渐变的第二颜色)。GradientAngle颜色梯度（颜色渐变）的角度。角度以弧度制定义。 BevelType此项描述的是纯背景颜色周围的斜缘边。0=无，1=凸起，2=凹陷。MeterMeter的类型。有效值如下：HISTOGRAMSTRINGBARBITMAPIMAGELINEROTATORBUTTONHistogramSecondaryMeasureName副Measure的命名。定义在同一个Meter上相关的副直方图。如果其余meter不需要可以不做定义。PrimaryColor主直方图的颜色，颜色模式为RGB，用逗号相隔开(e.g.

11、 PrimaryColor=10,30,255)。SecondaryColor副直方图的颜色。BothColor主直方图与副直方图颜色重叠时所用色。PrimaryImage主直方图所用的背景图片名，可以使用图片或者颜色填充，但不能同时使用。如果你定义了PrimaryImage时（在启用了Secondary Measure的情况下）必须也定义SecondaryImage和BothImage。SecondaryImage副直方图背景图片名。BothImage主直方图与副直方图在重叠时所使用的图片名。Autoscale如果设置成1则直方图会自动缩放至可以显示所有数据值。Flip如果设置成1则数据值反

12、转。StringFontColor字体颜色。Prefix值前显示的字符串。Postfix值尾显示的字符串。FontFace字体名称。FontSize字体大小。StringAlign字符串的排列位置。有效值为：LEFT,CENTER,RIGHT。StringStyle字符串的样式。有效值为：NORMAL，BOLD，ITALIC，BOLDITALIC。Scale测量值的刻度值，即显示值将以测量实际值除以刻度值而得，所以如果设置为1000则将以实际值缩小1000倍显示。如果刻度值有一位小数则显示值也有一位小数。AutoScale如果设置成1，则将自动设定刻度值。此项权限高于Scale。显示值将会自动

13、按照实际比例在结尾加上T，G，M或K等。Percentual如果设置成1则值将以百分数显示。NumOfDecimals显示值将使用小数。AntiAlias如果设置成1，则文字部分将开启抗锯齿功能。Text文字部分显示。如果要显示测量值请使用字符串%1。如果和多个Measures绑定就是用%2，%3等以此类推。ClipString如果设置成1则将以Meter的宽度进行剪辑，多余以字符串末尾将加上省略号显示。Angle文字的倾角，以弧度制记。注意文字大小仍然要被计算就如文字在水平位置时一样。BarBarColorBar的颜色。BarImageBar的背景图片。这可以用来替代BarColor。Bar

14、Border此处定义Bar的边缘。BarOrientationBar的方向性。有效值如下：HORIZONTALVERTICALFlip如果设置为1则反转Bar的方向。BitmapImage注意此项meter由于不会以任何方式显示测量值所以不需要与measure绑定。Image的目的是为了定制皮肤更简单。如果你将它和其他值绑定则可能会出现加载出的是一些字符串。如果此项meter定义了W和H则图像会进行缩放到限制大小范围内。ImageName显示图像名。LineLineCountmeter中Lines的数目，数目无限制。一下的setting都区分lines即单条适应，非全局控制。在控制名后加上li

15、ne number即可。注意第一条line不用加上任何标记 (e.g.“LineColor=255,255,0”;LineColor2=0,0,0)。MeasureNameNLine的measure名。LineColorNLine N的颜色。ScaleNLine N的缩放倍数。AutoScale如果设置成1则Lines会自动缩放以显示出所有的值。HorizontalLines如果设置成1则水平线将显示在直方线后。HorizontalLineColorHorizontal Lines的颜色。AntiAlias如果设置成1则开启抗锯齿选项。LineWidthLines的宽度。Flip如果设置成1则

16、meter反转。RotatorImageName旋转的图片名。OffsetX离中心偏移的X轴值。OffsetY离中心偏移的Y轴值。StartAngle旋角的始边。以弧度制记，0角度是正向X轴方向。默认顺时针方向旋转。RotationAngle旋角的终边，使用负值来定义逆时针旋转。ValueRemainder以remainder来代替实际测量值。这可以用来绘出有长短指针的时钟。Button这只是个普通的meter无需与任何东西捆绑。目的是让button的表现更简单，可以表现出缩放、模糊等动态效果。ButtonImageButton图像名。图像需要有三帧，可以是水平的也可以是垂直的。ButtonC

17、ommandButton点击后执行的命令或者！Bang。皮肤皮肤文件放在RM安装根目录下的skins文件夹内。单个皮肤请创立独立子文件夹进行存放。一个可用的皮肤 一般包含ini配置文件、image&icon等。单个皮肤文件夹内可以包含多个配置文件但只有一个可以被激活，这也允许skiner定制多种局 部差异性皮肤以满足不同用户的需求。注意：请不要在文件夹和配置文件命名时使用空格。皮肤文件通常被划分为四部分：Rainmeter：放置一般设定。Variables：存放变量。Measures：实际测量值。Meters：实际测量值具象化表现方式。在一个measure上捆绑多个meter是可行的。当然不是

18、必须要按照如上的顺序来写，但是如果能将代码写的比简单清晰明了，对于插件的使用者来说可以说会方便很多呢。对于开发者来说尽量将Variables变量放在配置文件的顶部，这样可以方便使用者进行自己的配置。对于需要手动更新的关键字请用#字符来分隔（e.g.#Username#：#Password#）。以下这些必须放在Rainmeter部分中：Background背景图片名，粉红色(255,0,255)可以作为透明背景。支持BMP、JPG、PNG(带有Alpha 通道)。BackgroundMode定义背景模式：0=Background定义的图片。1=透明。2=纯色。3=背景图像缩放。Backgroun

19、dMargins定义背景图像的边缘，在BackgroundMode=3的时候也不会被缩放。SolidColor如果Background模式设置为2的时候，此项定义背景色。SolidColor2如果Background模式设置为2的时候，此项定义第二颜色的背景梯度（颜色渐变的第二颜色）。GradientAngle如果Background模式设置为2的时候，此项定义颜色梯度（颜色渐变）的角度。角度以弧度制定义。 BevelType此项描述的是纯背景颜色周围的斜缘边。0=无，1=凸起，2=凹陷。UpdateMeters的更新时间，单位是毫秒（1秒=1000毫秒）。默认值为1000（i.e.1秒）Dy

20、namicWindowSize如果设置成1，窗口会在每次更新时进行大小重新计算，必要情况下会自动缩放窗口大小。DragMargins定义窗口不允许被拖动的区域。需要定义4个值并以逗号分隔。这个值定义的是不允许拖动的区域。负值是从对边开始计算的。KeepOnScreen设置成1则窗口始终保持在监视器的范围之内。（建议玩全屏降分辨率游戏的用户不要开启此项选项，这样会导致退出游戏后插件移位）Author皮肤作者的名字和E-Mail地址。该字符串会显示在关于的对话框内。AppVersion此插件支持的最低RM引擎版本。如果你认为没必要可以不写。The version is a single numbe

21、r that can be calculated like this: Major * 1000 + Minor. E.g. a value for Rainmeter 0.11.4 would be 11004.本文来自：主题一族（），访问原文链接:Measures每个Measures的命名必须唯一并且需要放用“”字符框起。只要在一个配置文件中命名不重复，名称可以随意。不要在命名中使用空格。Meters和Measures的命名是捆绑的，也就是同一指向的要命名相同。注意：为了使测量值能显示相对最低和最高值，某些meters需要一系列的值如Bar、Histogram，etc.。并非所有的meas

22、ures能够自动的测算出最低和最高值，所以某些measures请手动配置最高值和最低值。Measures的通用设置Measure这里定义Measures，有效值如下：CPU 测算CPU负载（如需独立监控各核占用情况开启PerfMon插件）。 Memory 测算记忆体总利用率。 PhysicalMemory 测算物理内存分配。 SwapMemory 测算Swap分配。 NetIn 测算网络下载流量。 NetOut 测算网络上载流量。 NetTotal 测算网络总流量。 FreeDiskSpace 测算空闲硬体总量。 PefMon 测算终端性能数据。 Uptime 显示系统开机后持续的时间，仅在S

23、TRING-meter下工作。 Plugin 调用外部插件定义Measures。 Registry 测算注册表值。 Time 测算即时时间和日期。 Calc 计算公式。 InvertMeasure如果设置成1，反转测量值。（e.g.将空闲硬体容量反转为目前硬体占用容量）IfAboveAction如果实际测量值超过设定值时执行的命令。这个动作在测定值超越设定值时仅会被执行一次，所以如果要再次执行此动作前测定值需低于设定值。IfAboveValueIfAboveAction的设定值。IfBelowAction如果实际测量值低于设定值时执行的命令。这个动作在测定值低于设定值时仅会被执行一次，所以如果

24、要再次执行此动作前测定值需高于设定值。IfBelowValueIfBelowAction的设定值。IfEqualAction当测量值等于IfEqualValue定义的值时执行的命令。当测量值等于设定值时命令仅执行一次，如果需要再次执行，测量值必须先低于或者高于设定值。值四舍五入到整数。IfEqualValueIfEqualAction的设定值。Disabled如果设置成1，在启动时不进行测量。UpdateDivider此值决定着测量频率。此值于Update值绑定。比如Update=1000&UpdateDivider=30，则没30s测算一次。此项默认值为1。MaxValue测算最大值。Min

25、Value测算最小值。Substitute此项可以替换关键词，必须成对出现并用逗号分隔，注意必须要用引号引出。（e.g.Substitute=cat:dog表述的是在测量值中将关键词cat全部替换成dog）AverageSize定义窗口的测量平均取值。（e.g.如果设置成10则将输出最后10次测量的平均值）NetInNetInSpeed用户网络接入最高速度。该值单位以1bit/s计。如果这个值缺损或者设置为0，这个值将以实际值决定。注意峰值。TrafficAction当下载数据到达一定量时所执行的行为。TrafficActionTrafficAction的设定值。Interface网卡监测数据

26、。如果此处被设置为0（默认值），所有的端口将被加在一起，如果值为1，则记录第一块网卡，2为第二块.etc.。Cumulative如果设置成1，将监测数据累积(i.e.把监测数据加在一起)。这可以用来检测特定周期的交换数据总量。NetOutNetOutSpeed用户网络输出最高速度。该值单位以1bit/s计。如果这个值缺损或者设置为0，这个值将以实际值决定。TrafficAction当上载数据到达一定量时所执行的行为。TrafficValueTrafficAction的设定值。Interface网卡监测数据。如果此处被设置为0（默认值），所有的端口将被加在一起，如果值为1，则记录第一块网卡，2为第二块.etc.。Cumulative如果设置成1，将监测数据累积(i.e.把监测数据加在一起)。这可以用来检测特定周期的交换数据总量。