filament下載 - filament原始碼下載

filament

其他源碼

v1.56.0

下載

燈絲

Filament 是一個基於實體的即時渲染引擎，適用於 Android、iOS、Linux、macOS、Windows 和 WebGL。它被設計為在 Android 上盡可能小、盡可能高效。

下載

下載 Filament 版本以存取穩定版本。燈絲發布檔案包含產生資產所需的主機端工具。

確保始終使用與運行時庫相同版本的工具。這對於matc （材質編譯器）尤其重要。

如果您想自行建立 Filament，請參閱我們的建造手冊。

安卓

Android 專案可以簡單地將 Filament 函式庫宣告為 Maven 相依性：

儲存庫 { // ...
    mavenCentral()
}相依性{
    實作 'com.google.android.filament:filament-android:1.56.0'}

以下是com.google.android.filament群組中可用的所有函式庫：

人工製品	描述
	燈絲渲染引擎本身。
	`filament-android`的調試版本。
	用於 Filament 的 glTF 2.0 載入器依賴`filament-android` 。
	KTX 載入、Kotlin 數學和相機實用程式取決於`gltfio-android` 。
	運行時材質建構器/編譯器。該庫很大，但包含完整的著色器編譯器/驗證器/優化器，並支援 OpenGL 和 Vulkan。
	一個比`filamat-android`更小的替代品，只能產生 OpenGL 著色器。它不提供驗證或優化。

iOS系統

iOS 專案可以使用 CocoaPods 安裝最新版本：

 pod '燈絲', '~> 1.56.0'

文件

Filament，深入解釋基於物理的即時渲染、Filament 的圖形功能和實作。本文檔解釋了我們大多數決策背後的數學和推理。本文檔是對圖形程式設計師的 PBR 很好的介紹。
材料，我們材料系統的完整參考文件。本文檔解釋了我們不同的材質模型、如何使用材質編譯器matc以及如何編寫自訂材質。
材料屬性，標準材料模型的參考表。

範例

螢幕空間折射

特徵

蜜蜂

適用於 Android、iOS、Linux、macOS 和 Windows 的本機 C++ API
適用於 Android 的 Java/JNI API
JavaScript API

後端

適用於 Linux、macOS 和 Windows 的 OpenGL 4.1+
適用於 Android 和 iOS 的 OpenGL ES 3.0+
適用於 macOS 和 iOS 的 Metal
適用於 Android、Linux、macOS 和 Windows 的 Vulkan 1.0
適用於所有平台的 WebGL 2.0

渲染

叢集前向渲染器
Cook-Torrance 微面鏡面 BRDF
朗伯漫反射 BRDF
自訂照明/表面著色
HDR/線性照明
金屬工作流程
透明塗層
各向異性照明
近似半透明（次表面）材質
布料/織物/光澤著色
法線貼圖與環境光遮擋貼圖
基於影像的照明
以實體為基礎的相機（快門速度、靈敏度和光圈）
物理光單位
點光源、聚光燈和定向光
鏡面反鋸齒
點、聚光和定向光陰影
層疊陰影
EVSM、PCSS、DPCF 或 PCF 陰影
透明陰影
接觸陰影
螢幕空間環境光遮擋
螢幕空間反射
螢幕空間折射
全球霧
動態解析度（支援 AMD FidelityFX FSR）

後處理

HDR 綻放
景深散景
多種色調映射器：通用（可自訂）、ACES、影片等。
色彩和色調管理：亮度縮放、色域映射
色彩分級：曝光、夜間適應、白平衡、通道混合器、陰影/中間色調/高光、ASC CDL、對比、飽和度等。
TAA、FXAA、MSAA
螢幕空間鏡頭光暈

GLTF 2.0

使用燈絲渲染

本機 Linux、macOS 和 Windows

您必須創建一個Engine 、一個Renderer和一個SwapChain 。 SwapChain是從本機視窗指標（例如 macOS 上的NSView或 Windows 上的HWND ）建立的：

引擎*引擎=引擎::create();
SwapChain* swapChain = 引擎->createSwapChain(nativeWindow);
渲染器*渲染器=引擎->createRenderer();

要渲染幀，您必須建立一個View 、一個Scene和一個Camera ：

相機* 相機 = 引擎->createCamera(EntityManager::get().create());
View* view = engine->createView();
場景*場景=引擎->createScene();

視圖->setCamera(相機);
視圖->setScene(場景);

可渲染物件被加入到場景中：

 Entity renderable = EntityManager::get().create();//建構一個quadRenderableManager::Builder(1)
        .boundingBox({{ -1, -1, -1 }, { 1, 1, 1 }})
        .material(0, 材質實例)
        .geometry(0, RenderableManager::PrimitiveType::TRIANGLES, vertexBuffer, indexBuffer, 0, 6)
        .剔除（假）
        .build(*引擎，可渲染);
場景->addEntity(可渲染);

材質實例是從材質中取得的，材質本身是從matc產生的二進位 blob 載入的：

材質*材質=材質::Builder()
        .package((void*) BAKED_MATERIAL_PACKAGE, sizeof(BAKED_MATERIAL_PACKAGE))
        .build(*引擎);
MaterialInstance*materialInstance = 材質->createInstance();

要了解有關材料和matc更多信息，請參閱材料文件。

要渲染，只需將View傳遞給Renderer ：

 // 如果我們需要跳過一幀，則 beginFrame() 傳回 false if (renderer->beginFrame(swapChain)) { // 對於每個 View
    渲染器->渲染（視圖）；
    渲染器->endFrame();
}

有關 Linux、macOS 和 Windows Filament 應用程式的完整範例，請查看samples/目錄中的來源檔案。這些範例皆基於libs/filamentapp/其中包含使用 SDL2 建立本機視窗並初始化 Filament 引擎、渲染器和視圖的程式碼。

有關如何為基於影像的照明準備環境貼圖的更多信息，請參閱 BUILDING.md。

安卓

有關如何在 Android 上使用 Filament 的範例，請參閱android/samples 。

您必須始終先透過呼叫Filament.init()來初始化 Filament。

在 Android 上使用 Filament 進行渲染與從本機程式碼進行渲染類似（跨語言的 API 基本上相同）。您可以透過將Surface傳遞給createSwapChain方法來渲染到Surface 。這允許您渲染到SurfaceTexture 、 TextureView或SurfaceView 。為了讓事情變得更容易，我們在com.google.android.filament.android套件中提供了一個名為UiHelper的 Android 特定 API。您需要做的就是在助手上設定渲染回呼並將SurfaceView或TextureView附加到它。您仍然負責在onNativeWindowChanged()回呼中建立交換鏈。