Rainmeter 教程给新手们.doc

RM并没有完美的配置编辑器，所以你需要用你最常用的文本编辑器来手动配置。RM的设定被打散在很多地方，但对于大部分的用户来说，Rainmeter.ini是唯一需要你调整的地方。一般配置文件也就是通配文件就是Rainmeter.ini，皮肤配置文件是在#skin-name#.ini里调整。注意：由于Refresh会把旧的值写回配置文件，所以某些setting不能在Rainmeter运行时更改。所以当你发现部分setting更改无效的时候尝试下把整个RM关闭再修改。Step.rc：RainmeterIniFile如果Rainmeter.ini没有被放在默认的位置，可以用它来指向定义。RainmeterSkinPath定义skin文件夹的路径，但必须在以独立的子文件夹的形式放在skins文件夹下。RainmeterPluginPath定义插件文件夹路径。RainmeterCurrentConfig目前正起作用的配置文件名，这可以用来强制使用某些配置。你必须同时定义RainmeterCurrentConfigIni。RainmeterCurrentConfigIni目前正起作用的配置文件。(仅为配置文件，并非路径)RainmeterWindowX设定窗口的X坐标。RainmeterWindowY设定窗口的Y坐标。Rainmeter.ini文件主要由Rainmeter和Statistics两部分组成，Rainmeter部分包含一般设定可以用来改变RM的行为表现。此配置是作为所有被打开的Config文件的默认值。一旦Config被打开即会在Rainmeter.ini下将配置写入自己的那部分中。Statistics下包含着大部分的Measures，请不要手动去修改它。TrayMeasures是个特别的部分，用来定义系统托盘图标的，只要设定了一个正常的有意义的值。以下这些必须放在Rainmeter下(或者放在各个Config中)：WindowX窗口的X坐标，负值有效，相对于右边屏幕位置WindowY窗口的Y坐标，相对于屏幕底部位置。AllowNegativeCoordinates如果设置成1，负坐标将可以正常定义；如果设置成0，则会从桌面右下角抵扣。SavePosition如果设置成1，窗口的位置会被记录在Rainmeter.ini文件中，当RM下次启动时会仍然出现在那个位置。AlwaysOnTop如果设置成1，此窗口会始终出现在其它窗口的前面，也就是所谓的的始终前置窗口。如果设置成0，窗口位置是Normal，如果设置成-1，则窗口会后置于其它窗口。-2代表钉在桌面上，2则代表是前置级别最高，前置于其他前置窗口。注意的是-2钉在桌面上仅在Explorer-Shell下工作。Draggable如果设置成1，窗口可以被鼠标拖动，如果设置成0，这窗口固定。SnapEdges如果设置成1，则窗口在移动中会自动边缘吸附。HideOnMouseOver如果设置成1，当鼠标指针移动到窗口范围内时，窗口便会消失。当鼠标指针移开窗口范围时，窗口又会重新出现。如果按住Shift、Ctrl和Alt时移动鼠标，则窗口不会消失或重现。StartHidden如果设置成1，RM会在系统启动时隐藏，你可以使用!RainmeterShow-bang来使他显形。NativeTransparency如果设置成1则支持本地透明（仅限Win2K&XP）。AlphaValue窗口的透明值，数值范围在0255之间。需要开启NativeTransparency。ClickThrough如果设置成1则鼠标穿透，需要开启NativeTransparency。LeftMouseDownAction当鼠标左键在RM窗口上按下后所执行的命令，注意此处不支持拖动。RightMouseDownAction当鼠标右键在RM窗口上按下后所执行的命令。LeftMouseUpAction当鼠标左键在RM窗口上放开后所执行的命令。RightMouseUpAction当鼠标右键在RM窗口上放开后所执行的命令，注意此处不支持右键环境菜单。MouseOverAction当鼠标掠过RM窗口时所执行的命令。MouseLeaveAction当鼠标离开RM窗口时所执行的命令。DesktopWorkArea设定桌面工作区域，定义工作区域最大的窗口覆盖，用四个逗号进行值的分割。(e.g. DesktopWorkArea=0,0,1920,1200)注意如果移动Taskbar会重新设定成Windows默认值（改变屏幕分辨率也会出现同样情况）。TrayIcon设置成0可以屏蔽系统托盘图标。FadeDuration定义窗口淡出的时间值，时间单位为毫秒，设置为0，此项无效。TrayExecuteL, TrayExecuteM, TrayExecuteR, TrayExecuteDL, TrayExecuteDM, TrayExecuteDR鼠标双击系统托盘图标时执行的命令，注意TrayExecuteR权限高于系统托盘的环境菜单。OnRefreshActionConfig刷新时执行的命令。刷新同样会在Config第一次运行时起作用。ConfigEditor定义RM的配置文件编辑器应用程序，默认为Notepad记事本。以下部分必须放在TrayMeasure部分下：Measure托盘显示的名称。TrayMeter这可以是直方图或位图。TrayColor1定义直方图的背景颜色。TrayColor2定义直方图的前景颜色。TrayBitmap定义托盘所用的位图的名称。位图的帧数可以任凭你所想，不过大小必须限制在16*16上。路径需关联于Rainmeter's-Skins文件夹。  皮肤皮肤文件放在RM安装根目录下的skins文件夹内。单个皮肤请创立独立子文件夹进行存放。一个可用的皮肤一般包含ini配置文件、image&icon等。单个皮肤文件夹内可以包含多个配置文件但只有一个可以被激活，这也允许skiner定制多种局部差异性皮肤以满足不同用户的需求。注意：请不要在文件夹和配置文件命名时使用空格。皮肤文件通常被划分为四部分：Rainmeter：放置一般设定。Variables：存放变量。Measures：实际测量值。Meters：实际测量值具象化表现方式。在一个measure上捆绑多个meter是可行的。当然不是必须要按照如上的顺序来写，但是如果能将代码写的比简单清晰明了，对于插件的使用者来说可以说会方便很多呢。对于开发者来说尽量将Variables变量放在配置文件的顶部，这样可以方便使用者进行自己的配置。对于需要手动更新的关键字请用#字符来分隔（e.g.#Username#：#Password#）。以下这些必须放在Rainmeter部分中：Background背景图片名，粉红色(255,0,255)可以作为透明背景。支持BMP、JPG、PNG(带有Alpha通道)。BackgroundMode定义背景模式：0=Background定义的图片。1=透明。2=纯色。3=背景图像缩放。BackgroundMargins定义背景图像的边缘，在BackgroundMode=3的时候也不会被缩放。SolidColor如果Background模式设置为2的时候，此项定义背景色。SolidColor2如果Background模式设置为2的时候，此项定义第二颜色的背景梯度（颜色渐变的第二颜色）。GradientAngle如果Background模式设置为2的时候，此项定义颜色梯度（颜色渐变）的角度。角度以弧度制定义。 BevelType此项描述的是纯背景颜色周围的斜缘边。0=无，1=凸起，2=凹陷。UpdateMeters的更新时间，单位是毫秒（1秒=1000毫秒）。默认值为1000（i.e.1秒）DynamicWindowSize如果设置成1，窗口会在每次更新时进行大小重新计算，必要情况下会自动缩放窗口大小。DragMargins定义窗口不允许被拖动的区域。需要定义4个值并以逗号分隔。这个值定义的是不允许拖动的区域。负值是从对边开始计算的。KeepOnScreen设置成1则窗口始终保持在监视器的范围之内。（建议玩全屏降分辨率游戏的用户不要开启此项选项，这样会导致退出游戏后插件移位）Author皮肤作者的名字和E-Mail地址。该字符串会显示在关于的对话框内。AppVersion此插件支持的最低RM引擎版本。如果你认为没必要可以不写。The version is a single number 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.。并非所有的measures能够自动的测算出最低和最高值，所以某些measures请手动配置最高值和最低值。Measures的通用设置Measure这里定义Measures，有效值如下：· CPU· 测算CPU负载（如需独立监控各核占用情况开启PerfMon插件）。· Memory· 测算记忆体总利用率。· PhysicalMemory· 测算物理内存分配。· SwapMemory· 测算Swap分配。· NetIn· 测算网络下载流量。· NetOut· 测算网络上载流量。· NetTotal· 测算网络总流量。· FreeDiskSpace· 测算空闲硬体总量。· PefMon· 测算终端性能数据。· Uptime· 显示系统开机后持续的时间，仅在STRING-meter下工作。· Plugin· 调用外部插件定义Measures。· Registry· 测算注册表值。· Time· 测算即时时间和日期。· Calc· 计算公式。InvertMeasure如果设置成1，反转测量值。（e.g.将空闲硬体容量反转为目前硬体占用容量）IfAboveAction如果实际测量值超过设定值时执行的命令。这个动作在测定值超越设定值时仅会被执行一次，所以如果要再次执行此动作前测定值需低于设定值。IfAboveValueIfAboveAction的设定值。IfBelowAction如果实际测量值低于设定值时执行的命令。这个动作在测定值低于设定值时仅会被执行一次，所以如果要再次执行此动作前测定值需高于设定值。IfBelowValueIfBelowAction的设定值。IfEqualAction当测量值等于IfEqualValue定义的值时执行的命令。当测量值等于设定值时命令仅执行一次，如果需要再次执行，测量值必须先低于或者高于设定值。值四舍五入到整数。IfEqualValueIfEqualAction的设定值。Disabled如果设置成1，在启动时不进行测量。UpdateDivider此值决定着测量频率。此值于Update值绑定。比如Update=1000&UpdateDivider=30，则没30s测算一次。此项默认值为1。MaxValue测算最大值。MinValue测算最小值。Substitute此项可以替换关键词，必须成对出现并用逗号分隔，注意必须要用引号引出。（e.g.Substitute="cat":"dog"表述的是在测量值中将关键词cat全部替换成dog）AverageSize定义窗口的测量平均取值。（e.g.如果设置成10则将输出最后10次测量的平均值）NetInNetInSpeed用户网络接入最高速度。该值单位以1bit/s计。如果这个值缺损或者设置为0，这个值将以实际值决定。注意峰值。TrafficAction当下载数据到达一定量时所执行的行为。TrafficActionTrafficAction的设定值。Interface网卡监测数据。如果此处被设置为0（默认值），所有的端口将被加在一起，如果值为1，则记录第一块网卡，2为第二块.etc.。Cumulative如果设置成1，将监测数据累积(i.e.把监测数据加在一起)。这可以用来检测特定周期的交换数据总量。NetOutNetOutSpeed用户网络输出最高速度。该值单位以1bit/s计。如果这个值缺损或者设置为0，这个值将以实际值决定。TrafficAction当上载数据到达一定量时所执行的行为。TrafficValueTrafficAction的设定值。Interface网卡监测数据。如果此处被设置为0（默认值），所有的端口将被加在一起，如果值为1，则记录第一块网卡，2为第二块.etc.。Cumulative如果设置成1，将监测数据累积(i.e.把监测数据加在一起)。这可以用来检测特定周期的交换数据总量。NetTotalNetTotalSpeed用户网络输入输出最高速度。该值单位以1bit/s计。如果这个值缺损或者设置为0，这个值将以实际值决定。TrafficAction当上载下载总和数据到达一定量时所执行的行为。TrafficValueTrafficAction的设定值。Interface网卡监测数据。如果此处被设置为0（默认值），所有的端口将被加在一起，如果值为1，则记录第一块网卡，2为第二块.etc.。Cumulative如果设置成1，将监测数据累积(i.e.把监测数据加在一起)。这可以用来检测特定周期的交换数据总量。FreeDiskSpaceDrive检测的具体硬体。（e.g."C:"）Total如果设置成1，则反馈数据显示硬体的总容量。Label如果设置成1，则反馈数据显示驱动器标签。PluginPlugin定义实际测量时需用到的插件名。RegistryRegKey注册表项名。RegHKeyHKEY名。有效值有：HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_PERFORMANCE_DATA and HKEY_DYN_DATA.RegValue注册表项值名。仅支持字符串和长字符串。TimeFormat时间表达格式（e.g.“%H:%M:%S”）。你可以从MSDN找到所有的代码格式。TimeZone时区值（e.g.+2.0）.DaylightSavingTime如果设置成1则将开启夏令时（取决于你的本地时间）。这仅在时区TimeZone值被设定的情况下有效。CalcFormula此项定义计算公式。你可以使用其他的Measures来作为Variables。这里还有一个特殊的变量称之为Counter，它在每次更新后增加。这个变量仅在所有其他的Measures更新完毕后更新。注意配置文件都区分大小写，所有的函数都必须大写(e.g.SIN(10*PI)。Operations：· + (add)· - (substract)· * (multiply)· / (divide)· * (power)· % (remainder)· & (bitwise and)· | (bitwise or)· (bitwise xor)· (bitwise not)Logical operations:· <> (not equal)· = (equal)· > (greater than)· < (less than)· && (logical and)· | (logical or)Functions:· ARCTAN· ARCSIN· ARCCOS· COS· SIN· TAN· ABS· EXP· LN· LOG· SQRT· SQR· SGN· SIGN· FRAC· TRUNC· FLOOR· CEIL· ROUND(x, precision)Conditional operator:<condition> ? <true expr.> : <false expr.>Meters每个meter都去要有一个唯一的名称，并在配置文件中加以定义。命名必须用“”符号括起。命名没有特别要求不过不要在一个配置文件中有重复出现，不要在命名中出现空格。General settings for all metersMeasureNameMeter表述的Measure名称。X窗口内的X坐标，在结尾以加上“r”的形式可以将坐标与前一个meter相关联(e.g. X=5r)。也可以用大写“R”来与前一个Meter的右边缘关联。Y窗口内的Y坐标，在结尾以加上“r”的形式可以将坐标与前一个meter相关联(e.g. Y=-10r)。也可以用大写“R”来与前一个Meter的底部边缘关联。WMeter的宽度。如果你使用可计算出宽度的图片或者字符串表的话可以不需要做定义。如果你使用桌面作为整个RM的背景则需要定义所有插件的长度和宽度，不然窗口的尺寸可能出现计算错误的情况。HMeter的长度。其余同上“W”参数值。Hidden如果设置成1则Meter隐藏。LeftMouseDownActionRightMouseDownActionLeftMouseUpActionRightMouseUpActionMouseOverActionMouseLeaveAction这些和全局设定效果相同，但仅应用于特定的Meter。此处的设置权限高于全局设置。注意：当窗口被允许拖动的情况下LeftMouseUpAction无效。你需要用DragMargins定义可拖动区域以此来避免Meter的重叠操作。UpdateDivider此值决定Meter的更新间隔。此值与Update值绑定。比如当Update=1000，UpdateDivider=30则Meter每30s更新一次。默认值为1.SolidColorMeter的背景色。SolidColor2第二颜色的背景梯度(颜色渐变的第二颜色)。GradientAngle颜色梯度（颜色渐变）的角度。角度以弧度制定义。 BevelType此项描述的是纯背景颜色周围的斜缘边。0=无，1=凸起，2=凹陷。MeterMeter的类型。有效值如下：· HISTOGRAM· STRING· BAR· BITMAP· IMAGE· LINE· ROTATOR· BUTTONHistogramSecondaryMeasureName副Measure的命名。定义在同一个Meter上相关的副直方图。如果其余meter不需要可以不做定义。PrimaryColor主直方图的颜色，颜色模式为RGB，用逗号相隔开(e.g. PrimaryColor=10,30,255)。SecondaryColor副直方图的颜色。BothColor主直方图与副直方图颜色重叠时所用色。PrimaryImage主直方图所用的背景图片名，可以使用图片或者颜色填充，但不能同时使用。如果你定义了PrimaryImage时（在启用了Secondary Measure的情况下）必须也定义SecondaryImage和BothImage。SecondaryImage副直方图背景图片名。BothImage主直方图与副直方图在重叠时所使用的图片名。Autoscale如果设置成1则直方图会自动缩放至可以显示所有数据值。Flip如果设置成1则数据值反转。StringFontColor字体颜色。Prefix值前显示的字符串。Postfix值尾显示的字符串。FontFace字体名称。FontSize字体大小。StringAlign字符串的排列位置。有效值为：LEFT,CENTER,RIGHT。StringStyle字符串的样式。有效值为：NORMAL，BOLD，ITALIC，BOLDITALIC。Scale测量值的刻度值，即显示值将以测量实际值除以刻度值而得，所以如果设置为1000则将以实际值缩小1000倍显示。如果刻度值有一位小数则显示值也有一位小数。AutoScale如果设置成1，则将自动设定刻度值。此项权限高于Scale。显示值将会自动按照实际比例在结尾加上T，G，M或K等。Percentual如果设置成1则值将以百分数显示。NumOfDecimals显示值将使用小数。AntiAlias如果设置成1，则文字部分将开启抗锯齿功能。Text文字部分显示。如果要显示测量值请使用字符串%1。如果和多个Measures绑定就是用%2，%3等以此类推。ClipString 如果设置成1则将以Meter的宽度进行剪辑，多余以字符串末尾将加上省略号显示。Angle 文字的倾角，以弧度制记。注意文字大小仍然要被计算就如文字在水平位置时一样。BarBarColorBar的颜色。BarImageBar的背景图片。这可以用来替代BarColor。BarBorder此处定义Bar的边缘。BarOrientationBar的方向性。有效值如下：· HORIZONTAL· VERTICALFlip如果设置为1则反转Bar的方向。BitmapImage注意此项meter由于不会以任何方式显示测量值所以不需要与measure绑定。Image的目的是为了定制皮肤更简单。如果你将它和其他值绑定则可能会出现加载出的是一些字符串。如果此项meter定义了W和H则图像会进行缩放到限制大小范围内。ImageName显示图像名。LineLineCountmeter中Lines的数目，数目无限制。一下的setting都区分lines即单条适应，非全局控制。在控制名后加上line 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则meter反转。 RotatorImageName旋转的图片名。OffsetX离中心偏移的X轴值。OffsetY离中心偏移的Y轴值。StartAngle旋角的始边。以弧度制记，0角度是正向X轴方向。默认顺时针方向旋转。RotationAngle旋角的终边，使用负值来定义逆时针旋转。ValueRemainder以remainder来代替实际测量值。这可以用来绘出有长短指针的时钟。Button这只是个普通的meter无需与任何东西捆绑。目的是让button的表现更简单，可以表现出缩放、模糊等动态效果。ButtonImageButton图像名。图像需要有三帧，可以是水平的也可以是垂直的。ButtonCommandButton点击后执行的命令或者！Bang。 Power Plugin此插件可以用来测量电池状态和目前笔记本的MHz。注意不是所有的笔记本都支持这些。PowerState· ACLINE - 测量是否接上交流电源。(0/1)· STATUS - 测量电池状态(no battery,charging,critiacl,low high)。· STATUS2 - 与STATUS相同除了BatteryFlag in SYSTEM_POWER_STATUS is returned as is。· LIFETIME - 续航时间测量。· PERCENT - 测量续航时间的百分比。· MHZ - 测量现在的CPU MHz。Format与TIME测量相同，仅在PowerState是LIFETIME的情况下适用。 SoundRainmeter支持在动作中播放音频(e.g.TrafficAction)。用内建普通命令或者！bang即可。PLAY soundfile - 播放所给音频一次。PLAYLOOP soundfile - 循环播放所给音频。PLAYSTOP - 停止目前正播放的音频。  Bangs我通篇读了这部分，感觉实在难以解释清楚，我感觉我解释出来的不如直接看原文来的容易让人接受。所以直接引用原文了。如果有能力的人能翻译的比较具体的可以PM给我。The Rainmeter can be controlled also with Litestep !Bang-commands. A bang is a special command that can be executed to change something in the application. You can use the bangs in the various actions that Rainmeter has or just run one from command line by giving it to argiument for Rainmeter.exe. Naturally you can use these from Litestep too.Note that the means that you must supply the argument for the bang (do not include the -chars). The () mean that the argument is no necessary.Most !bangs take also the config as an optional parameter. If the config is defined the bang only applies to that particular config. If it's not given, the !bang is send to all active configs. Use * as the config's name to send it to all configs.The !bangs actually work differently depending where they are handled. If Rainmeter is ran standalone it handles the !bangs itself and adds the name of the config automatically to the end of the argument list. This makes it so that the !bang affects only the config that executed it. If Rainmeter is ran as Litestep's plugin the !bangs are send directly to Litestep which handles them. In this case the name of the config is not added to the arguments so it affects to all active configs. The third case is when the !bang is send via Rainmeter.exe in which case the it is handled by the first Rainmeter config that can be found. ！RainmeterShow(Config)显示Rainmeter窗口。！RainmeterHide(Config)隐藏Rainmeter窗口。！RainmeterToggle(Config)切换Rainmeter窗口。！RainmeterRefresh(Config)重新加载配置文件。如果发现重新加载后并无变化，解决办法是在推出该插件后再修改配置文件，然后重新应用。！RainmeterRedraw(Config)强制刷新窗口，并会更新所有的meters。！RainmeterHideMeterMeter(Config)隐藏所给的Meter。注意隐藏meter不代表关闭meter，所以测量仍在进行，如果你想不让CPU负载多余的不显示的meter，你还必须将相应的measure关闭。！RainmeterShowMeterMeter(Config)显示所给meter，前提是它被隐藏。！RainmeterToggleMeterMeter(Config)切换显示/隐藏所给的meter。！RainmeterMoveMeterXYMeter(Config)移动所给的meter(i.e.并非针对窗口而是将