API Reference

Complete API Reference

Editor内でもショート形式で利用可能:

Asset Constructors

コンストラクタは、エディタで使用される主要なアセットタイプを作成します。変数に割り当てると、エディタはそれを認識し、Ctrl+Clickで一致するアセットエディタを開くことができます。

List Methods

[]または[value1, value2, ...]でリストを作成します。list[index]でエントリを読み取り、上書きし、for (var i = 0; i < list.length(); i = i + 1)で繰り返します。

Operators

演算子は、一般的な計算を行うための小さな記号です。剰余演算子は、タイマー、インデックス、アニメーションステップ、または繰り返しパターンをラップする際に特に便利です。

Object Properties

オブジェクトは、スクリプトが通常移動させたり変更したりするものです。これらの関数は、オブジェクトの位置、スプライト、衝突動作、レイヤー、ビジュアルティントを読み取ったり更新したりします。

Sprite Functions

スプライト関数は、スプライトのピクセルデータとアニメーション速度を検査または変更できます。ほとんどのゲームはエディタでスプライトを描画しますが、これらの関数は手続き型効果、デバッグ、または簡単なランタイムの変更に便利です。

Animation Functions

アニメーション関数は、複数のフレームを持つスプライトを使用するオブジェクトに作用します。コードで現在のアニメーションフレームを検査したり強制したりしたいときに使用します。

Transform Functions (Flip/Rotation)

変換関数は、オブジェクトのスプライトがどのように描画されるかを、スプライト自体を編集せずに変更します。複数の方向で1つのスプライトを再利用するのに適しています。

デフォルトの中心オフセットは[0.5, 0.5]で、スプライトの中央を回転します。[0, 0]はオブジェクトの左上の位置を中心に回転させ、[1, 1]はlocation + (width, height)を回転の中心にします。

古いプロジェクトへの警告: Tiniest2D 1.8以降、getRotation()とsetRotation()は四分の一回転の値ではなく度数を使用します。回転したオブジェクトのコライダーは物理学やシーンクエリに影響を与えます。

Collision Types

衝突タイプは、オブジェクトが衝突チェックにどのように参加するかを決定します。オブジェクトの役割に応じてタイプを選択します: 壁は通常静的で、プレイヤーは通常動的で、ピックアップはしばしばトリガーとなります。

Scene Functions

シーン関数は、アクティブなシーン、シーン内のオブジェクト、背景色や重力などのシーン全体の設定を制御します。また、位置や名前によってオブジェクトを見つけるための検索ヘルパーも提供します。

Audio Playback

オーディオ再生関数は、スクリプトからオーディオアセットを開始および停止します。playAudio()はハンドルを返し、後でその特定の再生インスタンスを停止したり確認したりできます。

Screen Functions

画面関数は、ウィンドウサイズを知る必要がある場合や、画面ピクセルからワールド位置に変換する必要がある場合に役立ちます。これは、マウスの狙い、クリック検出、カメラ対応のUIに便利です。

Window Mode

エクスポートされたゲームのウィンドウモードを制御します。これらの関数はエディタ内でプレイする際には効果がありません（エディタはウィンドウ状態に対してより高い権限があります）。

Example:

func start() {
    // ウィンドウモードを設定します（WINDOW_MAXIMIZEDはエクスポートされたゲームのデフォルトです）
    setWindowMode(WINDOW_MAXIMIZED())
}

Note: エクスポートされたゲームで setWindowMode() が呼ばれない場合、デフォルトは WINDOW_MAXIMIZED です。

UI Functions

UIは仮想スクリーンスペース解像度を使用します。デフォルトのUI空間は 100 x 100 です。 フォントサイズは、uiPushFontSize(size) で次のテキストウィジェットのために拡張でき、uiPopFontSize() で元に戻します。フォントの色は、uiPushFontColor(r, g, b[, a]) でスタックでき、UI要素の塗りつぶしは uiPushElementColor(r, g, b[, a]) でスタックできます。即時モードUIの残りと同様に、これらのオーバーライドは現在のフレームのUIを構築する際に適用されます。押されたサイズが 0 またはそれ以下の場合、エンジンは自動サイズを使用します。

UI State Constants

UI関数は状態定数を返しますので、スクリプトはウィジェットがアイドル、ホバー、保持、またはクリックされているかどうかを知ることができます。通常、ボタンアクションのためにチェックする値は UI_CLICKED() です。

Camera Functions

カメラ位置はビューの中心を表します。ズームは画面サイズに関係なく一貫した垂直ワールドビューを維持します。

Zoom behavior: ズームはウィンドウサイズやアスペクト比に関係なく一貫した垂直ワールドビューを維持します。広い画面ではより多くの水平方向が表示されますが、垂直方向は同じ量が表示されます。

Input Functions

入力関数はゲームがキーボードとマウスの状態に反応できるようにします。 Pressed は一フレームのアクション、Held は連続的な動き、Released はボタンが離されたときに発生するアクションに使用します。

Mouse Button Constants

マウスボタン定数はマウス入力関数に渡されます。生の数字よりもコードを読みやすくします。

Key Constants

キー定数はキーボード入力関数に渡されます。エンジンは文字、数字、ファンクションキー、矢印、そして少数の一般的な特別キーを公開します。

Letters: KEY_A() から KEY_Z()

Numbers: KEY_0() から KEY_9()

Function keys: KEY_F1() から KEY_F12()

Special keys: | Constant | Key | |----------|-----| | KEY_SPACE() | スペースバー | | KEY_ENTER() | エンター/リターン | | KEY_ESCAPE() | エスケープ | | KEY_TAB() | タブ | | KEY_BACKSPACE() | バックスペース | | KEY_DELETE() | デリート | | KEY_SHIFT() | シフト | | KEY_CTRL() | コントロール | | KEY_ALT() | オルト | | KEY_LEFT() | 左矢印 | | KEY_RIGHT() | 右矢印 | | KEY_UP() | 上矢印 | | KEY_DOWN() | 下矢印 | | KEY_HOME() | ホーム | | KEY_END() | エンド |

Math Functions

数学のヘルパーは、移動、アニメーション、ランダム性、および値の制限に使用される一般的な計算をカバーします。スクリプトを短く、読みやすく保ちます。

Utility Functions

ユーティリティ関数は、特定のアセットタイプに属さない一般的なヘルパーです。 print() は学習中に特に役立ちます。スクリプトが何をしているのかを示します。

String Functions

文字列関数は、テキスト値で操作します。現時点では、このセクションは意図的に小さいです。

Storage Functions

ゲームデータをファイルに保存および読み込みします。数値、文字列、ブール値、リスト（入れ子のリストを含む）をサポートします。スプライト、シーン、オブジェクト、またはオーディオ値はサポートしていません。

例: プレイヤーの進行状況を保存およびロードする

// プレイヤーデータを保存
var playerData = [100, "Player1", true, [1, 2, 3]]
var savePath = getAppDataPath() + "/MyGame/save.dat"
if (save(savePath, playerData)) {
    print("ゲームが保存されました！")
}

// プレイヤーデータをロード
if (fileExists(savePath)) {
    var loaded = load(savePath)
    if (loaded != null) {
        var health = loaded[0]
        var name = loaded[1]
        var hasKey = loaded[2]
        var inventory = loaded[3]
    }
}

// 暗号化された保存（データを簡単に検査されないように隠すため）
var secretData = ["secret", 12345]
save(getAppDataPath() + "/MyGame/config.dat", secretData, "binary", "mySecretKey")
var decrypted = load(getAppDataPath() + "/MyGame/config.dat", "mySecretKey")

// テキスト形式（人が読める形式、デバッグに便利）
save(getAppDataPath() + "/MyGame/debug.txt", playerData, "text")

注意:

• バイナリ形式（デフォルト）は圧縮されており、より速いです
• テキスト形式は人が読める形式で、デバッグに便利です
• 誤った暗号化キーは null を返します（データはゴミになります）
• 保存時にディレクトリは自動的に作成されます