メインコンテンツまでスキップ

外部力パラメータ

外部から適用される力に関するパラメータです。

ソースを見る

Gravity​

Gravity​

重力 - ボーンに適用される重力ベクトル。

プロパティ値
型FVector
デフォルト(0, 0, 0)
カテゴリForce
// 下向きの重力を適用
Gravity = FVector(0, 0, -1.0f);

bUseLegacyGravity​

レガシー重力方式 - Gravityの適用方式を指定します。

プロパティ値
型bool
デフォルトfalse
カテゴリForce
値説明
true従来互換（位置に 0.5 * Gravity * dt^2 を加算）
falseAnimDynamics互換（速度に Gravity * dt を加算してから位置更新）

bUseDefaultGravityZProjectSetting​

プロジェクト設定の重力使用 - Gravityベクトルにプロジェクト設定の DefaultGravityZ（絶対値）を乗算するフラグ。

プロパティ値
型bool
デフォルトfalse
カテゴリForce

bUseWorldSpaceGravity​

ワールド空間重力 - 重力をワールド座標系で扱うかどうかのフラグ。

プロパティ値
型bool
デフォルトtrue
カテゴリForce

Wind​

bEnableWind​

風の有効化 - 外力としてWindDirectionalSourceの影響を受けるかどうかのフラグ。

プロパティ値
型bool
デフォルトfalse
カテゴリForce

WindScale​

風のスケール - WindDirectionalSourceによる風の影響度。ClothやSpeedTreeとの併用目的で使用します。

プロパティ値
型float
デフォルト1.0
編集条件bEnableWind == true
カテゴリForce

Wind External Force

Wind Directional Sourceとの連携

注記

WindScaleはbEnableWindがtrueの場合のみ有効です。

WindDirectionNoiseAngle​

風方向ノイズ - WindDirectionalSourceによる風方向に与えるノイズ（角度）。風向きにランダムなゆらぎを与え、機械的な揺れを和らげます。

プロパティ値
型float
デフォルト0.0
単位度
範囲0 以上
編集条件bEnableWind == true
カテゴリForce

Simple External Force​

SimpleExternalForce​

単純な外力ベクトル - 任意の方向に力を適用できます。

プロパティ値
型FVector
デフォルト(0, 0, 0)
カテゴリForce|External Force

bUseWorldSpaceSimpleExternalForce​

ワールド空間外力 - 単純な外力をワールド座標系で扱うかどうかのフラグ。

プロパティ値
型bool
デフォルトtrue
カテゴリForce|External Force

External Force プリセット​

バージョン情報

v1.16.0で追加

External Forceプリセットシステム

プリセットの種類と適用フロー

External Force設定1

External Force設定2

External Forceデモ

External Forceプリセットによる揺れの制御

ExternalForces​

外力プリセット（Instanced Struct） - 外力のプリセット。C++で独自のプリセットを追加可能です。

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Force|External Force",
    meta = (BaseStruct = "/Script/KawaiiPhysics.KawaiiPhysics_ExternalForce", ExcludeBaseStruct))
TArray<FInstancedStruct> ExternalForces;

CustomExternalForces（実験的機能）​

カスタム外力（Instanced Property） - BP・C++で独自のプリセットを追加可能です。

UPROPERTY(EditAnywhere, BlueprintReadWrite, Instanced, Category = "Force|External Force",
    meta=(DisplayName="CustomExternalForces(EXPERIMENTAL)"))
TArray<TObjectPtr<UKawaiiPhysics_CustomExternalForce>> CustomExternalForces;
警告

この機能は非常に実験的です。AnimNodeをクリックするか、Animation Blueprintをコンパイルしないと正常に動作しない場合があります。

タグ​

KawaiiPhysicsTag​

フィルタリング用タグ - ExternalForceなどで使用するフィルタリング用のGameplayTag。

プロパティ値
型FGameplayTag
カテゴリTag

Filter Tag

GameplayTagによるフィルタリング設定

// タグを使用した外力の適用
FGameplayTagContainer FilterTags;
FilterTags.AddTag(FGameplayTag::RequestGameplayTag("KawaiiPhysics.Hair"));
UKawaiiPhysicsLibrary::AddExternalForcesToComponent(MeshComp, ExternalForces, Owner, FilterTags);

AnimNotifyによる外力制御​

バージョン情報

v1.17.0で追加

AnimNotifyを使用してアニメーション中に外力を制御できます。

AnimNotifyState External Force

AnimNotifyStateによる外力の適用

ランタイム制御・Blueprint API​

外力はBlueprintから動的に追加・除去できます（AddExternalForce / AddExternalForcesToComponent / RemoveExternalForcesFromComponent）。

Blueprint Nodes

Blueprint用の外力制御ノード

手順とシグネチャは以下を参照してください。

関連ページ​

このページは外部力パラメータのリファレンスです。実際の使い方は以下のガイドを参照してください。