# fanhua-camera

**Repository Path**: TDSI/fanhua-camera

## Basic Information

- **Project Name**: fanhua-camera
- **Description**: 繁华如梦相机 · Fanhua Camera — Android 开源摄影应用：小米「繁华如梦」风格滤镜、徕卡 M9「一瞬」色彩近似、GPU 实时超分（1080p 采集→4K 输出）、硬件/陀螺仪防抖、ML Kit 自动构图、实况照片，9 语种界面。Kotlin + Jetpack Compose + CameraX 全自研，无第三方滤镜库。
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-11
- **Last Updated**: 2026-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 繁花如梦相机 · Fanhua Camera

An open-source Android photography app featuring Mi-style dream filters, Leica M9-inspired color grading, a real-time GLES super-resolution pipeline, hardware/gyroscope stabilization, ML Kit powered auto-composition and Live Photo capture. Built with Kotlin, Jetpack Compose and CameraX — no third-party filter libraries.

小米「繁花如梦」风格滤镜、徕卡 M9「一瞬」色彩近似、GPU 实时超分（1080p 采集 → 4K 输出）、硬件/陀螺仪防抖、ML Kit 自动构图、实况照片，9 语种界面。

## Features

- Mi "Flourishing Dream" and Leica M9 "Moment" film-style filters (color curves, soft bloom, grain, vignette)
- Real-time GLES pipeline: EASU edge-adaptive upsampling + RCAS sharpening (1080p → 4K)
- Custom 3D LUT import (.cube), compatible with Blackmagic / PhotonCamera LUTs, live preview included
- Collapsible Leica filter group to keep the filter strip compact
- Hardware OIS/EIS plus gyroscope software stabilization
- AI auto-composition via ML Kit face detection (rule-of-thirds scoring, crop suggestions)
- Live Photo: one shutter press captures a photo plus a 3-second clip
- CameraX effect pipeline shared between preview and video recording
- Photo / Video / Pro / SuperRes modes, manual focus, zoom, flash
- Hideable camera controls for clean viewfinder, landscape shutter docked to the screen edge
- Debug mode: records pipeline logs, one-tap copy / clear for troubleshooting
- 9 languages (zh-CN / zh-TW / en / ja / ko / es / fr / de / ru)

## Requirements

- Android 8.0+ (minSdk 26), targetSdk 34
- Gradle 8.7 / JDK 21

## Build

```
./gradlew :app:assembleDebug
```

APK output: `app/build/outputs/apk/debug/app-debug.apk`

## Project structure

```
app/src/main/java/com/fanhua/camera/
  ui/           # Compose UI (camera, settings, gallery, common widgets)
  camera/core/  # CameraController, CameraXEngine, CapabilityProbe
  camera/capture/  # CameraX GL filter effect and surface processor
  camera/gl/    # EGL context, GL pipeline, shader passes (EASU / RCAS / bloom / grain)
  camera/filters/  # filter presets and color grades
  camera/stabilize/  # gyroscope stabilization
  camera/analyzer/   # face analyzer and composition engine
  media/        # photo processor (offline filter + upscale), MediaStore
  data/         # DataStore settings, locale manager
```

## Repositories

- GitHub（主仓库 / 推送目标）: <https://github.com/SystemTemp/fanhua-camera>
- Gitee（镜像，自动同步）: <https://gitee.com/TDSI/fanhua-camera>

> 发布新版本时请推送到 GitHub，GitHub Release 会自动同步到 Gitee（代码与 Release 附件）；Gitee 不会反向同步到 GitHub。

## Author

[SystemTemp](https://github.com/SystemTemp)

## License

[Apache-2.0](LICENSE)