Section Variables セクション変数
Measures and meters can be referenced as variables. These are called section variables, and they can provide several kinds of information about the meter or measure. Lua scripts can also be called inline and most will work right out of the box and plugins can also add support but will be on a more case by case basisメジャーとメーターは変数として参照できます。これらはセクション変数と呼ばれ、メーターまたはメジャーに関するいくつかの種類の情報を提供できます。Luaスクリプトはインラインで呼び出すこともでき、ほとんどはそのまま使用でき、プラグインもサポートを追加できますが、ケースバイケースで対応する予定です。
Usage使用法
A meter or measure is referenced as a section variable by placing the section name in brackets ([]). The value provided by a section variable can be changed by adding parameters after a colon (:). Multiple parameters are separated by commas (,). Spaces are allowed after a comma.メーターまたは小節は、セクション名を大括弧（[]）で囲むことによってセクション変数として参照されます。セクション変数によって提供される値は、コロン（）の後にパラメータを追加することによって変更できます:。複数のパラメータはカンマ（,）で区切ります。コンマの後にスペースを入れることができます。
[SectionName:P1,P2]
Note: Normal or built-in variables take priority over section variables, which means that while they can be used within section variables, for example: [#Foo#:#Bar#], the reverse, such as #[Foo][Bar]#, is not valid.注：通常変数または組み込み変数はセクション変数よりも優先されます。つまり[#Foo#:#Bar#]、次のように、セクション変数内で使用できますが、のような逆#[Foo][Bar]#は無効です。
This limitation can be addressed by using the Nesting Variables form of the variables.この制限は、変数のネスト変数形式を使用して対処できます。
Example: [#[&Foo][&Bar]]例： [#[&Foo][&Bar]]
Dynamic Variables動的変数
Section variables are always dynamic. DynamicVariables=1 will always be needed on a measure or meter section where the variable is used in an option value.セクション変数は常に動的です。DynamicVariables=1変数がオプション値で使用されている小節またはメーターセクションでは、常に必要になります。
Meter Parametersメーターパラメータ
- None無し
-
Section variables for meters have no value without a parameter.メーターのセクション変数は、パラメーターなしでは値を持ちません。
:X,:YExample:[MeterName:X]:X、:Y例：[MeterName:X]-
The current X or Y position of the meter.メーターの現在のXまたはY位置。
Notes: This provides the "real" X or Y value, which is the position of the top-left corner of the meter area. This is always an integer, even if the meter has no X and Y options set, or if the options use formulas, variables or relative positions.注：これは、メーター領域の左上隅の位置である「実際の」XまたはY値を提供します。メーターにXおよびY オプションが設定されていない場合や、オプションに数式、変数、または相対位置が使用されている場合でも、これは常に整数です。
The values for X or Y may be different than the values in the meter options if StringAlign is used on a String meter.StringAlignがStringメーターで使用されている場合、XまたはYの値はメーターオプションの値とは異なる場合があります。
:W,:HExample:[MeterName:W]:W、:H例：[MeterName:W]-
The current width or height of the meter.メーターの現在の幅または高さ。
Notes: This provides the "real" W or H value. This is always an integer, even if the meter has no W and H options set, or if the options use formulas or variables.注：これは「実際の」WまたはH値を提供します。メーターにW オプションとH オプションが設定されていない場合や、オプションで数式や変数が使用されている場合でも、これは常に整数です。
The values for W or H may be different than the values in the meter options if Padding is used.パディングが使用されている場合、WまたはHの値はメーターオプションの値とは異なる場合があります。
:XW,:YHExample:[MeterName:XW]:XW、:YH例：[MeterName:XW]-
The current X or Y position and W or H width or height of the meter added together. This will provide the current position of the end of the meter in the X+width or Y+height dimension.現在のXまたはY位置とメーターのWまたはH幅または高さを足し合わせたもの。これにより、メーターの端の現在位置がX +幅またはY +高さ寸法で提供されます。
This equates to, and can be used in place of,
X=([SomeMeter:X] + [SomeMeter:W])orY=([SomeMeter:Y] + [SomeMeter:H])to position a meter relative to the end of another meter.これは、メーターを別のメーターの端に相対して配置しX=([SomeMeter:X] + [SomeMeter:W])たりY=([SomeMeter:Y] + [SomeMeter:H])、その端を基準にして配置したりすることに相当します。Notes:ノート：
This uses the "real" X/Y/W/H values. This is always an integer, even if the meter has no X and Y options or W and H options set, or if the options use formulas or variables.これは「実際の」X / Y / W / H値を使用します。メーターにXとYのオプションまたはWとHのオプションが設定されていない場合や、オプションに数式や変数が使用されている場合でも、これは常に整数です。
The values for X or Y may be different than the values in the meter options if StringAlign is used on a String meter.StringAlignがStringメーターで使用されている場合、XまたはYの値はメーターオプションの値とは異なる場合があります。
The values for W or H may be different than the values in the meter options if Padding is used.パディングが使用されている場合、WまたはHの値はメーターオプションの値とは異なる場合があります。
Measure Parameters測定パラメータ
- NoneExample:
[MeasureName]なし例：[MeasureName] -
If no parameters are given, the measure's string value is provided.パラメータが指定されていない場合は、数値データの文字列値が提供されます。
:Example:[MeasureName:]:例：[MeasureName:]-
If a blank parameter is given, the measure's number value is provided, with up to ten decimal places of precision.空白のパラメータが指定されている場合、小数位の数値が小数点以下10桁までの精度で提供されます。
:nExample:[MeasureName:10]:n例：[MeasureName:10]-
The measure's number value, with the number of decimal places given.指定された小数桁数を含む、小節の数値。
Multiple Parameters: This parameter may be combined with Scale and Percentual.複数のパラメータ：このパラメータはスケールとパーセントと組み合わせることができます。
:/nExample:[MeasureName:/1024]:/n例：[MeasureName:/1024]-
The measure's number value, scaled by the divisor given.指定された約数で尺度化された、数値データの数値。
Multiple Parameters: This parameter may be combined with Decimals and Percentual.複数のパラメータ：このパラメータは、DecimalsとPercentualと組み合わせることができます。
:%Example:[MeasureName:%]:%例：[MeasureName:%]-
The measure's number value, as a percentual value.メジャーの数値として、percentual値。
Multiple Parameters: This parameter may be combined with Decimals and Scale.複数のパラメータ：このパラメータは、DecimalsとScaleと組み合わせることができます。
:MinValue:MaxValueExample:[MeasureName:MaxValue]:MinValue:MaxValue例：[MeasureName:MaxValue]-
The measure's MinValue or MaxValue number value.メジャーのMinValueプロパティまたはMaxValueを数値。
Multiple Parameters: This parameter may be combined with Decimals and Scale.複数のパラメータ：このパラメータは、DecimalsとScaleと組み合わせることができます。
:EscapeRegExpExample:[MeasureName:EscapeRegExp]:EscapeRegExp例：[MeasureName:EscapeRegExp]-
The measure's string value will be treated as a PCRE Regular Expression pattern, and all regular expression reserved characters, which are
.^$*+?()[{\|, will be "escaped" with\.メジャーの文字列値はPCRE正規表現パターンとして扱われ、すべての正規表現予約文字は.^$*+?()[{\|「でエスケープ」され\ます。 :EncodeURLExample:[MeasureName:EncodeURL]:EncodeURL例：[MeasureName:EncodeURL]-
The measure's string value will be URL-Encoded.メジャーの文字列値はURLエンコードされます。
:TimestampExample:[MeasureName:Timestamp]:Timestamp例：[MeasureName:Timestamp]-
This will only return a value when used with a Time measure. The measure's Windows timestamp value. This will allow you to obtain the numeric value of the Windows timestamp from a Time measure that has a Format option, and won't have the timestamp as the normal number value.これは、Timeメジャーと一緒に使用した場合にのみ値を返します。メジャーのWindowsタイムスタンプ値。これにより、フォーマットオプションを持つTimeメジャーからWindowsタイムスタンプの数値を取得でき、タイムスタンプは通常の数値としては得られません。
関連記事
- Nesting Variables 入れ子の変数
- Mouse Variables マウス変数
- Character Reference Variables 文字参照変数
- Built-In Variables 組み込み変数
スポンサーリンク
