ノードを知る on Godot 4 レシピ

Label

Mon, 01 Jan 0001 00:00:00 +0000

`Label`

ラベル は、フォーマットされていないテキストを表示するための コントロールノードであり、テキストの配置や折り返しなどの制御オプションを備えています。

ノードのプロパティ

完全なリストについてはドキュメントを参照してください。以下では、ノードで最も一般的に使用されるプロパティについて説明します。

text - このプロパティはラベルの表示内容を決定します。コード内で変更することで、ラベルに表示させる内容を更新できます。数値を表示する場合は、必ず文字列に変換してください！例えば、指定された数値値でラベルを更新する場合：

func update_label(value):
 $Label.text = str(value)

align - このプロパティを使用すると、テキストを右揃え/中央揃え/左揃えにできます。
percent_visible - このプロパティは表示する文字数を制限します。例えば値を 0.5 に設定するとコンテンツの半分が表示されます。この値をアニメーション化することで「タイプライター効果」を作成できます。

スクリプトの追加方法

テキスト プロパティに何らかの文字を入力するとすぐに、Godotのデフォルトフォントが要件に対して小さすぎることに気付くでしょう。以下に変更方法を説明します。

まず、プロジェクトフォルダにTTFまたはOTFフォントファイルが保存されていることを確認してください。

Labelの「カスタムフォント」セクションにて、“Custom Fonts"を選択してください。DynamicFontは、指定された書体でテキストを表示するリソース型です。

追加した"DynamicFont"を選択し、“Font/Font Data"で"Load"を選び、フォントファイルを選択します。また、フォントのサイズも設定してください。

Path2D と PathFollow2D

Mon, 01 Jan 0001 00:00:00 +0000

ℹ️ 留意事項

この記事は Godot 3から Godot 4 へ内容の書き換え中です。 Godot4では存在しない変数、関数が含まれている場合があります。もしその場合はリポジトリのIssuesまでご報告ください。

`Path2D と PathFollow2D`

パスとは 2D 空間における点の連続であり、Curve2D リソースによって定義されます。Path2D ノードを使用すると、2D 空間でパスを配置できるほか、エディター内で新規パスを作成することもできます。

パスには様々な用途があります。敵モブが辿る巡回経路、アニメーション効果のための曲がりくねった道、移動プラットフォームの動作パターンなどを作成できます。

`Curve2D`について【】

パスのデータはこのリソースオブジェクトに保持されています。これには曲線の数学的表現が含まれており、そのデータと対話するための方法が提供されています。APIドキュメントに詳細が記載されていますが、ここでは特に役立つメソッドをご紹介します。

add_point() / remove_point() / clear_points()

コード内でパスのポイントを操作する必要がある場合、これらの関数が役立ちます。

get_closest_point()

このメソッドは、空間内の任意の点に最も近い経路上のポイントを返します。

get_closest_offset()

上記と異なる点として、この方法は指定された地点に最も近い経路上の位置を返します。ただし、この位置は経路上に定義された2つの特定のポイント間に位置する場合もあります。

tesselate()

このメソッドは曲線上の点のリストを返します。これらの点は、曲率が高い経路部分に密集して配置されます。

経路の描画方法

Path2D ノードを選択すると、アイコンバーに以下の新しいアイコンが表示されます。

アイコンのいずれかを選択すると、マウスカーソルの動作が変更されます。ホバーするとそれぞれの名前を確認できます。

ポイントを選択 - クリック＆ドラッグで既存のポイントを移動できます。
コントロールポイントを選ぶ - ポイントに調整ハンドルを追加し、カーブ形状を調整できます（詳細は後述）。
ポイントを追加(空きポイントに) - 空白部分をクリックすることで新しいポイントを作成します。
点を削除 - クリックすると指定したポイントを削除します。
曲線を閉じる - 曲線の最終ポイントと最初のポイントを接続してループ状に仕上げます。

「ポイントを追加」を選択し、エディターウィンドウ内でクリックしてポイントを作成します。

より滑らかで丸みを帯びた曲線を作成するには、「制御点を選択」を選択し、カーブ上の任意の点をドラッグして「内向き」「外向き」ハンドルを調整してください。

経路の追跡

単体ではPath2Dノードにはほとんど機能がありません。経路に沿って移動するには、PathFollow2D ノードも併せて使用が必要です。これは親の Path2D に沿って移動する役割を持つノードです。

RayCast2D

Mon, 01 Jan 0001 00:00:00 +0000

ℹ️ 留意事項

RayCast2D

レイキャスティング はゲーム開発で広く用いられる手法です。「レイを飛ばす(キャストする)」とは、ある点から直線を伸ばし、それが何かに衝突するか限界に達するまで移動させる操作を指します。

ノードのプロパティ

RayCast2D ノードを追加して、インスペクターを確認します。

以下に主要な特性をご説明します。

Enabled

この機能を無効にするとレイキャスト操作が無効化されます。

Exclude Parent

このプロパティにより、レイは親オブジェクトとの衝突を無視するようになります。デフォルトで有効になっています。

Target Position

これはレイの到達点です。※注：この座標系はローカル座標です。

また、「衝突対象」セクションにも注意してください。初期設定ではレイはオブジェクトのみを検出するため、領域も検知したい場合や代わりに使用したい場合は、ここで設定する必要があります。

便利な機能

ノードの機能一覧はAPIドキュメントで確認できます。特に便利な主要機能をご紹介します。

is_colliding()

ブール型関数。レイが何らかの物体と衝突しているかどうかを判定します。

get_collision_point()

レイが衝突している場合、この関数は衝突位置をグローバル座標系で返します。

get_collider()

衝突が発生している場合、この関数は衝突中のオブジェクトへの参照を返します。

get_collision_normal()

別の有用な情報として、衝突点における衝突オブジェクトの法線ベクトルを示します。

使用例

レイキャストには多様な用途があります。可視判定（AはBを確認できるか、その間に障害物はないか）、近接検出（壁や地面、障害物の近くにいるか）などです。以下に実用的な使用例をご紹介します。

1. 射撃

高速で移動する発射物には、障害物を「すり抜けてしまう」という問題がよく発生します。これは、衝突判定が1フレーム内で検出できないほど物体の移動速度が速いためです。代替案として、経路（あるいはレーザーなど）を表現するには Raycast2D を使用する方法があります。

ここに、銃の先端にレイキャストが取り付けられたプレイヤースプライトがあります。target_positionは(250, 0)に設定されています。

プレイヤーが射撃した際、レイが何かに衝突しているかどうかを判定します。

func _input(event):
 if event.is_action_pressed("shoot"):
 if $RayCast2D.is_colliding():
 print($RayCast2D.get_collider().name)

2. エッジ検出処理

以下の方法でmobに下向きレイキャストを2つ追加してください。

モブキャラクターのスクリプト内で、レイが衝突を停止したときを確認します。その時点までに境界線に到達したことを意味するので、向きを変える必要があります。

func _physics_process(delta):
 velocity.y += gravity * delta
 if not $RayRight.is_colliding():
 dir = -1
 if not $RayLeft.is_colliding():
 dir = 1
 velocity.x = dir * speed
 $AnimatedSprite.flip_h = velocity.x > 0
 velocity = move_and_slide(velocity, Vector2.UP)

動作中の様子をご覧ください。

ノードを知る on Godot 4 レシピ

Label

Label

ノードのプロパティ

スクリプトの追加方法

Path2D と PathFollow2D

Path2D と PathFollow2D

Curve2Dについて【】

経路の描画方法

経路の追跡

RayCast2D

RayCast2D

ノードのプロパティ

便利な機能

使用例

1. 射撃

2. エッジ検出処理

`Label`

`Path2D と PathFollow2D`

`Curve2D`について【】