panel2.cfg ファイルフォーマット

■目次

• 1. 概要
• 2. Syntax
• 3. The This section
• 4. The PilotLamp section
• 5. The Needle section
• 6. The DigitalNumber section
• 7. The DigitalGauge section
• 8. The LinearGauge section
• 9. The Timetable section
• 10. The Windscreen section
• 11. Available subjects

■ 1. 概要

panel2.cfg ファイルは lampやneedle等、運転台パネルを使用するための要素について表示、配置などの場所を定義することにより、2D運転台パネルを作成できます。

panel2.cfg ファイルは任意のエンコードで記述されたプレーンテキストですが encoding, 、好ましい選択としてはバイトオーダー付きのUTF-8です。 The parsing model に用いる数字は ルーズですが、 それでも出力にあたっては 厳密な 出力をすることが望ましいです。 このファイルは必ずTrainフォルダー内に配置する必要があり、 panel2.cfgという名前にする必要があります。 ファイルは各行ごとに上から下に解釈されます。

➟ panel2.cfgのクイックリファレンスも参照して下さい…

■ 2. 文法

ファイル内の各行は空(または空白)飲みにすることが出来、またその行は無視され、新しいセクションの開始をマークするか、セクション内にキーと値のペアを含めることが出来ます。全てのキーと値のペアは、最後に開かれたセクションと関連付けされます。

新しいセクションを開くには、行を開始ブラケット (U+005B) で開始し、終了ブラケット (U+005D)で終了します。 カッコ内のテキストはセクション名を示し、大文字と小文字を区別しません。 行の最初と最後の空白、及びセクション名の最初と最後の空白は無視されます。従って、セクションの先頭は次の形式になります:

キーと値のペアは、キー、等号 (U+003D)、そして値を与えることで示されます。 キーは大文字と小文字を区別しません。 行頭と末尾、及び等号の前後の空白は無視され、または、キーと値を囲む空白は無視されます。 従って、キーと値のペアは次のような書式をとります:

一部の値は、カンマで区切られた複数の部分にさらに分割されます (U+002C)。

コメントは行末のどこでも使用可能です。 コメントはセミコロン (U+003B)で始まります。 コメントは存在する場合、処理される前に全ての行から削除されます。

■ 3. This セクション

This セクションはパネルの背景イメージを用いる為の定義や、解像度を定義します。このセクションは、ファイル内で一度だけ使用できます。

これをを定義することにより、セクションを開始します。

背景画像のどのピクセルがデフォルトのカメラ位置の消失点に対応するかを定義します。これは、2本のレールが直線の線路上で水平線に収束するポイントです。 Center と Origin の関係は、運転台の位置合わせの yaw と pitch に影響します。

背景画像のどのピクセルがデフォルトのカメラ位置の消失点に対応するかを定義します。これは、2本のレールが直線の線路上で水平線に収束するポイントです。 Center と Origin の関係性は、運転台パネルの yaw と pitch に影響します。

■ 4. PilotLampセクション

PilotLamp せくしょんでは、表示または非表示にできるインジケーターを作成できます。此等のセクションは、必要な数だけ使用することが出来ます。

PilotLampセクションを使用する場合は、 DaytimeImage を指定する必要があります。 PilotLampを表示させたい場合は Subject は1を返す必要があります。そうでない場合は非表示になります。

これをを定義することにより、セクションを開始します。

■ 5. Needle セクション

Needle セクションは、 回転する要素、または針を作成します。 此等のセクションは必要な数だけ使用できます。

Needleにはイメージを用い、DaytimeImage (必須) or NighttimeImage (オプション), は Origin で定義された中心により回転し、 Radius が定義されている場合オプションで拡大縮小されます。 描かれている針の画像は上を向いている必要があります。

これをを定義することにより、セクションを開始します。

The Y value in the Origin key-value pair defines the vertical point of rotation, but also defines the actual radius of the element in the bitmap’s own pixel coordinates. If ValueInPixels is set to a different value than this actual radius, the image will be scaled by a factor of Radius / Y, while preserving the Origin-Center relation. If you do not want to scale the image, set ValueInPixels to the same value as Yin the Origin key-value pair, or omit Radius altogether.

Multiplies the images by the color specified by HexColor. Setting HexColor to #FFFFFF (white) preserves the original color of the images, while setting HexColor to #000000 (black) produces black images. Pixels defined as being transparent via TransparentColor are not affected.

Defines the natural frequency. In an undamped oscillatory system, this is the angular frequency in radians per second. As soon as damping is performed, the frequency will decrease with convergence of the oscillator. A natural frequency of 0 will not allow any rotation to be performed. Higher values roughly correspond to radians per second. If specified, DampingRatio should also be specified.

Defines the damping ratio for the oscillatory system. Values between 0 and 1 represent under-damping, 1 represents critical damping and values above 1 represent over-damping. Compare the following illustration in which the angle of rotation changes from 0 to 1 over time:

If specified, NaturalFreq should also be specified.

■ 6. The DigitalNumber section

The DigitalNumber section creates an indicator that can switch between multiple states, useful to build up a display of decimal digits. You can use as many of these sections as required.

The image used for the DigitalNumber, defined by DaytimeImage (required) and NighttimeImage (optional), is comprised of the individual states, which are stacked vertically, anchored at the top of the image. The width of a single state is equal to the width of the image, while the height of a single state is defined by Interval (required). The Subject used needs to return an integer from 0 (first element) to n-1 (last element), where n is the number of elements. If a value outside of that range is returned by Subject, the DigitalNumber will be made invisible.

これをを定義することにより、セクションを開始します。

■ 7. The DigitalGauge section

The DigitalGauge section creates a solid-color square of which only a radial section is shown at a time. You can use as many of these sections as required.

There are three important angles to consider. The InitialAngle defines which angle corresponds to the Minimum value, while LastAngle defines which angle corresponds to the Maximum value. The current value at a given time corresponds to the current angle. The solid-color square will only show the part that is between the current angle and the LastAngle. If InitialAngle is less than LastAngle, the solid-color square will wind clockwise. If InitialAngle is greater than LastAngle, the solid-color square will wind counter-clockwise.

The subject needs to return a value that meaningfully works together with the Minimum and Maximum settings.

これをを定義することにより、セクションを開始します。

If Radius is negative, it is treated as if it was positive, but the entire LED is rotated by 180 degrees.

■ 8. The LinearGauge section

The LinearGauge section creates a panel layer, which uses texture shifting to create a sliding linear gauge. You can use as many of these sections as required.

Consider a standard openBVE face:

As you can see, the horizontal texture-coordinates upon this face are 0 at the right and 1 at the left. Thus, the value given by Minimum represents 0 Maximum, represents 1, and the current value may then be calculated as a simple percentage.

Further, the direction of the texture shift may be changed from horizontal to vertical (or both) by using the Direction parameter.

これをを定義することにより、セクションを開始します。

■ 9. The Timetable section

The Timetable section defines where to place custom timetables. The actual images are loaded via the route file. Only one Timetable section may be used within the file.

これをを定義することにより、セクションを開始します。

■ 10. The Windscreen section

The Windscreen section defines a set of animated raindrops / snowflakes and windscreen wipers.

これをを定義することにより、セクションを開始します。

■ 11. Available subjects

A subject is composed of a base subject and an optional subject suffix. The subject controls what information is fed to the element that uses the subject. For example, a Needle can use the subject kmph to be fed with the current speed of the train in kilometers per hour, or with the mr subject to show the main reservoir pressure.

● Base subjects

If atsi is used with the built-in safety systems ATS and ATC, the following mapping for i applies:

● Suffixes

Example: kmphd1 can be used to feed a DigitalNumber with the tens of the current speed of the train in kilometers per hour. The image used by the DigitalNumber will thus need to be composed of images from 0 to 10 in order to show all possible states kmphd1 can return, where images 0 through 9 correspond to the digits, and 10 corresponds to an image shown at the tens when the speed is below 10 km/h (e.g. another 0-digit, or blank space).