LFS プログラミング - 変更履歴

Skylinekakkoii: /* LFSの文字とエスケープコード */ 一部翻訳 "キリル語"には違和感がありますが、Microsoftがそう翻訳しているので...

2017-03-24T13:14:51Z

LFSの文字とエスケープコード: 一部翻訳 "キリル語"には違和感がありますが、Microsoftがそう翻訳しているので...

Skylinekakkoii: /* LFSWorld stats */

2017-03-20T14:13:40Z

LFSWorld stats

Skylinekakkoii: 英版コピー&一部翻訳

2017-03-20T13:40:40Z

英版コピー&一部翻訳

新規ページ

== はじめに ==

By its nature LFS is a very programmer friendly game and, while customisation of the game engine itself is frowned upon, there are many other avenues available for budding addon writers to explore. Whether it's parsing some esoteric file format, writing your own server system, or just grabbing your friend's hotlaps from LFSWorld, LFS has something to keep even the most adventurous hackers busy!

The following category attempts to explain and document the many various programmer topics related to LFS, in hopefully a clear and useful way. Our job of course is not to teach you how to program, there are many, many books about that, but to show you the myriad possibilities for customising LFS which are right at your fingertips.

== プログラミングカテゴリ ==

=== InSim ===

[[InSim]] は、外部プログラムとLive for Speedの通信を可能にするプロトコルです。これを使用すると、LFSとソケット通信を行い、パケットデータの送受信を行うことができます。The InSim protocol describes how each of these packets is formatted, and any programming language which can create a network connection and send and receive strings of binary data can interface with it.

=== InSim Relay ===

With [[InSim Relay]] you can connect to any subscribed host and share a subset of InSim packets. This is mainly used in the creation of spectator style apps, such as LFSRemote.

=== OutSim / OutGauge ===

[[OutSim / OutGauge|OutSim と OutGauge]] も外部プログラムとソケット通信を可能にするものです。InSimと似ていますが、こちらはモーションシミュレーターや外部ダッシュボード(メーターなど)に向けて作られたものです。

=== LFSWorld stats ===

[http://www.lfsforum.net/showthread.php?t=14480 LFSWorld stats] では、ホストに関する全ての情報(プレイ中のレーサーの情報など)を取得するクエリを使用することができます。

=== ファイルフォーマット ===

LFS独自のたくさんの [[ファイルフォーマット]] は、開発チーム(公式)や、HEXエディタを使った熱狂的なハッカーたち(非公式)によってドキュメント化されています。

== 共通のプログラミング情報 ==

=== データ型 ===

LFSのゲームクライアントはC++によって書かれており、ほとんどのデータ型はC++の言語仕様に準拠しています。The following table represents a breakdown of what each data-type means and what sort of value it holds.

{| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="800"
! colspan="4" style="background-color: #0066CC; color:#FFFFFF;" |'''データ型'''
|- style="background-color: #DFDFDF;"
! style="border: 1px solid #000000;" | LFS
! style="border: 1px solid #000000;" | データ型
! style="border: 1px solid #000000;" | PHP パック型
! style="border: 1px solid #000000;" | 説明
|-
| char
| 1 byte signed integer
| a or C
| An alphanumeric character (or a number between -128 to 127)
|-
| byte
| 1 byte unsigned integer
| C
| A number between 0 and 255
|-
| word
| 2 byte unsigned integer
| v
| A number between 0 and 65,535
|-
| short
| 2 byte signed integer
| s
| A number between -32,768 and +32,767
|-
| unsigned
| 4 byte unsigned integer
| V
| A number between 0 and +4,294,967,295
|-
| int
| 4 byte signed integer
| l
| A number between -2,147,483,648 and +2,147,483,647
|-
| float
| 4 byte floating point number
| f
| A number with a decimal point
|}

In C strings are not first-class data-types, merely arrays of characters, so you will often see strings denoted using the following syntax.

<big><pre>char[16] <variable></pre></big>

This indicates that the variable is a string of 16 characters in length, but in reality as the last character in a C-style string is always NULL, it would only be able to hold a value of 15 characters. For php in this case, you would use the 'a' as the pack format code, with a 16 following after it's declaration.

For example:
<pre>pack('a16', $variable);</pre>

=== LFSの文字とエスケープコード ===

Strings in LFS are C-style strings, meaning that they end with a NULL character, or are often padded with NULL characters. Most other high-level languages have done away with this limitation, so it's important to strip any NULL characters from the end of a string before using it.

LFS handles strings in its own way, it uses Windows codepages sepearared by special escape characters.
----
. The following table represents an attempt to document each of these codepages. In reality it's not 100% accurate, in practice it should give you reasonable results for most purposes.

{| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
! colspan="3" style="background-color: #0066CC; color:#FFFFFF;" |'''Codepages'''
|- style="background-color: #DFDFDF;"
! style="border: 1px solid #000000;" | Code
! style="border: 1px solid #000000;" | Name
! style="border: 1px solid #000000;" | Codepage
|-
| ^L
| Latin 1
| CP1252
|-
| ^G
| Greek
| CP1253
|-
| ^C
| Cyrillic
| CP1251
|-
| ^J
| Japanese
| CP932
|-
| ^E
| Central Europe
| CP1250
|-
| ^T
| Turkish
| CP1254
|-
| ^B
| Baltic
| CP1257
|-
| ^H
| Traditional Chinese
| CP950
|-
| ^S
| Simplified Chinese
| CP936
|-
| ^K
| Korean
| CP949
|}

In addition there are several other escape codes which denote special characters in text.

{| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''Escape Codes'''
|- style="background-color: #DFDFDF;"
! style="border: 1px solid #000000;" | Code
! style="border: 1px solid #000000;" | Character
|-
| ^v
| <nowiki>|</nowiki>
|-
| ^a
| *
|-
| ^c
| :
|-
| ^d
| \
|-
| ^s
| /
|-
| ^q
| ?
|-
| ^t
| "
|-
| ^l
| <
|-
| ^r
| >
|-
| ^h
| #
|-
| ^^
| ^
|}

And finally the colour of text is also denoted using escape codes, a table of which can be found below.

{| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''Colours'''
|- style="background-color: #DFDFDF;"
! style="border: 1px solid #000000;" | Code
! style="border: 1px solid #000000;" | Colour
|-
| ^0
| Black
|-
| ^1
| Red
|-
| ^2
| Light green
|-
| ^3
| Yellow
|-
| ^4
| Blue
|-
| ^5
| Purple
|-
| ^6
| Light blue
|-
| ^7
| White
|-
| ^8
| Dark green (default)
|-
| ^9
| Original text colour and codepage.
|}


[[en:LFS Programming]]

@@ 92 行 / 92 行 @@
 LFS handles strings in its own way, it uses Windows codepages sepearared by special escape characters.
 ----
-. The following table represents an attempt to document each of these codepages. In reality it's not 100% accurate, in practice it should give you reasonable results for most purposes.
+以下の表にあるコードは、それぞれのコードページを参照させるエスケープコードです。この表は、実際には100%正確ではありませんが、ほとんどの目的に対しては期待される結果が得られるでしょう。
 {| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
-! colspan="3" style="background-color: #0066CC; color:#FFFFFF;" |'''Codepages'''
+! colspan="3" style="background-color: #0066CC; color:#FFFFFF;" |'''コードページ'''
 |- style="background-color: #DFDFDF;"
-! style="border: 1px solid #000000;" | Code
+! style="border: 1px solid #000000;" | コード
-! style="border: 1px solid #000000;" | Name
+! style="border: 1px solid #000000;" | 名前
-! style="border: 1px solid #000000;" | Codepage
+! style="border: 1px solid #000000;" | コードページ
 |-
 | ^L
-| Latin 1
+| ラテン語 (Latin 1)
 | CP1252
 |-
 | ^G
-| Greek
+| ギリシア語 (Greek)
 | CP1253
 |-
 | ^C
-| Cyrillic
+| キリル語 (Cyrillic)
 | CP1251
 |-
 | ^J
-| Japanese
+| 日本語 (Japanese)
 | CP932
 |-
 | ^E
-| Central Europe
+| 中央ヨーロッパ (Central Europe)
 | CP1250
 |-
 | ^T
-| Turkish
+| トルコ語 (Turkish)
 | CP1254
 |-
 | ^B
-| Baltic
+| バルト語 (Baltic)
 | CP1257
 |-
 | ^H
-| Traditional Chinese
+| 繁体字 中国語 (Traditional Chinese)
 | CP950
 |-
 | ^S
-| Simplified Chinese
+| 簡体字 中国語 (Simplified Chinese)
 | CP936
 |-
 | ^K
-| Korean
+| 韓国語 (Korean)
 | CP949
 |}
-In addition there are several other escape codes which denote special characters in text.
+他にも、特殊文字を表記するエスケープコードがいくつかあります。
 {| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
-! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''Escape Codes'''
+! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''エスケープコード'''
 |- style="background-color: #DFDFDF;"
-! style="border: 1px solid #000000;" | Code
+! style="border: 1px solid #000000;" | コード
-! style="border: 1px solid #000000;" | Character
+! style="border: 1px solid #000000;" | 文字
 |-
 | ^v
@@ 184 行 / 184 行 @@
 |}
-And finally the colour of text is also denoted using escape codes, a table of which can be found below.
+そして最後に、文字色も以下の表のエスケープコードを使用して表記されています。
 {| border="0" style="border: 1px solid #000000; background-color: #FAFAFA;" width="600"
-! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''Colours'''
+! colspan="2" style="background-color: #0066CC; color:#FFFFFF;" |'''文字色'''
 |- style="background-color: #DFDFDF;"
-! style="border: 1px solid #000000;" | Code
+! style="border: 1px solid #000000;" | コード
-! style="border: 1px solid #000000;" | Colour
+! style="border: 1px solid #000000;" | 色
 |-
 | ^0
-| Black
+| 黒
 |-
 | ^1
-| Red
+| 赤
 |-
 | ^2
-| Light green
+| 黄緑
 |-
 | ^3
-| Yellow
+| 黄
 |-
 | ^4
-| Blue
+| 青
 |-
 | ^5
-| Purple
+| 紫
 |-
 | ^6
-| Light blue
+| 薄青
 |-
 | ^7
-| White
+| 白
 |-
 | ^8
-| Dark green (default)
+| 濃緑 (デフォルト)
 |-
 | ^9
-| Original text colour and codepage.
+| オリジナルの文字色とコードページ
 |}
 <!-- 他言語へのリンク -->
 [[en:LFS Programming]]

@@ 19 行 / 19 行 @@
 [[OutSim / OutGauge|OutSim と OutGauge]] も外部プログラムとソケット通信を可能にするものです。InSimと似ていますが、こちらはモーションシミュレーターや外部ダッシュボード(メーターなど)に向けて作られたものです。
-=== LFSWorld stats ===
+=== LFSWorld ステータス ===
-[http://www.lfsforum.net/showthread.php?t=14480 LFSWorld stats] では、ホストに関する全ての情報(プレイ中のレーサーの情報など)を取得するクエリを使用することができます。
+[http://www.lfsforum.net/showthread.php?t=14480 LFSWorld ステータス] では、ホストに関する全ての情報(プレイ中のレーサーの情報など)を取得するクエリを使用することができます。
 === ファイルフォーマット ===