Skip to main content

v0.122 KHR_texture_basisu 拡張対応

これは実験的機能です

KHR_texture_basisu 拡張 に対応する機能です。

KHR_texture_basisu 拡張を使用した glTF / VRM ファイルを用意することで、実行時ロードと描画の効率化が図れます。

対応するモデルと環境

モデルファイルに含まれる KTX basisu テクスチャは、予め上下反転しておく必要があります。

Editor ImportRuntime Import
通常のテクスチャ-TBD
上下反転したテクスチャ-
warning

Unity は内部的にすべてのテクスチャを上下反転しています。 したがって Runtime に圧縮テクスチャをインポートしようとした場合、上下反転した状態で圧縮しておくのが効率的です。 ただし上下反転した状態では glTF として正しい状態にはならないため、Unity 以外のツールでの利用には注意が必要です。

導入方法

1. KTX for Unity パッケージを導入

KTX for Unity パッケージが必要です。 パッケージ公式の導入方法 に従ってインストールしてください。

note

UniVRM は KTX for Unity パッケージの存在を検知して、自動的に対応コードを有効化します。 具体的には USE_COM_UNITY_CLOUD_KTX シンボルが有効化されます

2. インポート時にオプションを有効化

glTF ファイルをパースして得られる GltfData クラスに存在する ExtensionSupportFlags プロパティを設定します。 具体的には以下の 2 点です。

  • GltfData.ExtensionSupportFlags.ConsiderKhrTextureBasisu
    • true に設定
    • モデルに定義されている KHR_texture_basisu 拡張を考慮してインポートすることを明示するフラグです。
  • GltfData.ExtensionSupportFlags.IsAllTexturesYFlipped
    • true に設定
    • モデルに含まれるテクスチャが Unity 専用に上下反転されていることを明示するフラグです。

これらを設定した GltfData を、通常の手順でインポートします。 以下がサンプルコードです。

public class LoadYFlippedBasisuModel : MonoBehaviour
{
async void Start()
{
await LoadGltfModelAsync();
await LoadVrm10ModelAsync();
}

async Task LoadGltfModelAsync()
{
var path = @"C:\foo\bar\baz.gltf";
using var data = new AutoGltfFileParser(path).Parse();

// NOTE: KHR_texture_basisu 拡張のロードを有効化します。これは Runtime でのみ有効です。
data.ExtensionSupportFlags.ConsiderKhrTextureBasisu = true;

// NOTE: 上下反転されたテクスチャを含むモデルの場合、このフラグを有効化します。
// 現在はこのフラグを有効化しないと読み込めません。
data.ExtensionSupportFlags.IsAllTexturesYFlipped = true;

using var loader = new ImporterContext(data);
var model = await loader.LoadAsync(new RuntimeOnlyAwaitCaller());
model.ShowMeshes();
}

async Task LoadVrm10ModelAsync()
{
var path = @"C:\foo\bar\baz.vrm";
using var data = new AutoGltfFileParser(path).Parse();

data.ExtensionSupportFlags.ConsiderKhrTextureBasisu = true;
data.ExtensionSupportFlags.IsAllTexturesYFlipped = true;

var vrm10Data = Vrm10Data.Parse(data);
using var loader = new Vrm10Importer(vrm10Data);
var model = await loader.LoadAsync(new RuntimeOnlyAwaitCaller());
model.ShowMeshes();
}
}

参考