# Sceneform-EQR__从git的Sceneform-EQR同步

**Repository Path**: tanyunxiu/EQ-Renderer-Sample-Proj

## Basic Information

- **Project Name**: Sceneform-EQR__从git的Sceneform-EQR同步
- **Description**: EQ-Renderer的示例工程。EQ-Renderer是基于sceneform（filament）扩展的一个用于安卓端的三维AR渲染器。 当前接入了ARCore、AREngine、ORB-SLAM，可快速地进行AR开发。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://blog.csdn.net/qq_41140324/category_12571725.html
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2024-01-30
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

>Sceneform-EQR is an extension for Google's Sceneform Android SDK, designed for applications in graphics, video, augmented reality (AR), and virtual reality (VR). It currently integrates ARCore, AREngine, and ORB-SLAM, and offers multiple scene options—including AR scenes, VR scenes, and custom background scenes—to support a wide range of native 3D development needs.


- Readme.md[中文](./README_CN.md)

# Sceneform - EQR

> The **EQ-Renderer** module is now open-source. It includes integrations with **AREngine**, **ORB-SLAM**, and other extensions based on Google's Sceneform SDK.

---

[![Filament](https://img.shields.io/badge/Filament-v1.53.0-8bb903)](https://github.com/google/filament)

[![ARCore](https://img.shields.io/badge/ARCore-v1.45.0-8bb903)](https://github.com/google-ar/arcore-android-sdk)

[![AREngine](https://img.shields.io/badge/AREngine-v4.0.0.5-8bb903)](https://developer.huawei.com/consumer/cn/doc/graphics-References/ar-engine-java-api-0000001064060313)

---

## Introduction

**Sceneform** is a 3D framework featuring a physically-based renderer optimized for mobile devices. It allows you to easily build augmented reality (AR) applications without directly using OpenGL.

**(Sceneform) EQ-Renderer** is an Android-native 3D renderer built as an extension of Sceneform. It currently supports **ARCore**, **AREngine**, and **ORB-SLAM**, making it a fast and flexible tool for AR development.

---

## Getting Started

### Directory Structure

* `Eq-Renderer`: A rendering library for Android, extended from Sceneform (based on Filament)
* `SampleProj`: Sample application project

```
├─Eq-Renderer
│  └─Android
│      └─eq-renderer
└─SampleProj
    └─app
```

### Run the Sample

1. Open **Android Studio**
2. Go to **File > Open**, select `SampleProj`, and click **OK**
3. Click **Run 'app'** to launch the `app` module

---

## API Documentation

> **sceneform-eqr** is an extension of Sceneform. Its APIs are largely consistent with those of the original Sceneform.

You can refer to the following official documents for more information on Sceneform usage:

> Note:
> Sceneform versions **1.15 and earlier** use `.sfa` and `.sfb` formats for loading models.
> Starting from **version 1.16**, only **GLTF 2.0** models are supported via `gltfio`. See [Filament](https://github.com/google/filament) for details.

* Google Sceneform 1.16: [GitHub source archive](https://github.com/google-ar/sceneform-android-sdk)
* Sceneform 1.15 Docs: [Google Developer Guide (Chinese)](https://developers.google.cn/sceneform/develop/getting-started?hl=zh-cn)

---

## Blog Series

**EQ-Renderer** is an Android-native rendering engine based on Google's Sceneform (Filament). The blog series below walks through how to use it with Android Studio for efficient development.

**CSDN Blog**
[Sceneform-EQR: Android Native 3D Rendering Engine](https://blog.csdn.net/qq_41140324/category_12571725.html)

**CnBlogs**
[Android Native AR Development](https://www.cnblogs.com/eqgis/tag/%E5%AE%89%E5%8D%93%E5%8E%9F%E7%94%9FAR%E5%BC%80%E5%8F%91/)

---

## Feature Preview

* Load **GLTF** models in standard 3D scenes 
<img src="./doc/img/a3.png" style="zoom:33%;" />

* Load **GLTF** models in AR scenes 

<img src="./doc/img/a4.png" style="zoom:33%;" />

* Support for **GLTF model animation**

<img src="./doc/img/g3.gif" style="zoom:100%;" />

* Tap gesture interaction

<img src="./doc/img/a1.gif" style="zoom:67%;" />

* Gesture-based model manipulation:
  (One-finger rotate, two-finger pan, two-finger zoom)
  

<img src="./doc/img/g4.gif" style="zoom:67%;" />

* **Example: AR Launcher**

  > Render native Android Views in AR
  >
  > <img src="./doc/img/g1.gif" style="zoom:67%;" />

  > Dual-screen display support, useful for XR glasses
  >
  > <img src="./doc/img/a2.png" style="zoom:67%;" />

* **Example: AR Graffiti** (Custom textures, animated textures, video textures, displacement mapping)

  > Breathing effect using custom materials compiled with Filament's `matc` tool
  >
  > <img src="./doc/img/g5.gif" style="zoom:67%;" />

  > Flowing texture using a video as texture map
  >
  > <img src="./doc/img/g6.gif" style="zoom:67%;" />

---

## Repository

> You don't need to compile the Eq-Renderer source. Just use the **AAR**.

Repository:
[http://repo.eqgis.cn/com/eqgis/eq-renderer](https://repo.eqgis.cn/com/eqgis/eq-renderer)

```groovy
maven {
    allowInsecureProtocol = true
    url "http://repo.eqgis.cn"
}
```