android-camera-cutout

KO | EN

gitlite — search

#api #codex #docker #typescript #markdown #artificial-intelligence #awesome-list #cli #open-source #cpp

android-camera-cutout

(★ 9)

A lightweight Android 12+ Jetpack Compose library for detecting display camera cutouts, tracing notch/hole-punch shapes, and rendering customizable cutout overlays and animations.

파일 탐색기

ZIP 다운로드

- .gitignore
- build.gradle.kts
- - cutout-emission-demo.gif
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- .gitignore
- build.gradle.kts
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
jitpack.yml
LICENSE
README.md
settings.gradle.kts

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A lightweight Android 12+ Jetpack Compose library for detecting display camera cutouts, tracing notch/hole-punch shapes, and rendering customizable cutout overlays and animations.

## Status

Early extraction from Momentarium. The API is usable, but may change before `1.0.0`.

## Features

- Reads Android `DisplayCutout` information from window insets.
- Uses the exact `cutoutPath` when available.
- Falls back to an oval inside the cutout bounds.
- Draws a configurable overlay around the camera cutout.
- Optionally emits a filled copy of the cutout shape once or infinitely.
- Emits app-provided Compose content from the detected cutout.
- Supports a Fujifilm Instax-style print motion with a white developing wash.
- Includes a debug route and sample app for quick device verification.

## Requirements

- Android 12+ / API 31+
- Jetpack Compose

## Sample Usage

```kotlin
window.enableCameraCutoutLayout()
enableEdgeToEdge()

setContent {
    MaterialTheme {
        CameraCutoutDebugRoute(
            emissionConfig = CameraCutoutEmissionConfig(
                enabled = true,
                travelPx = 300f,
                durationMillis = 3000,
                repeatMode = CameraCutoutEmissionRepeatMode.Infinite,
            ),
        )
    }
}
```

This configuration emits a filled copy of the detected cutout, moves it 300 px downward over 3000 ms, fades it after reaching the destination, and repeats indefinitely.

## Custom Printed Content

Use `CameraCutoutContentEmissionOverlay` when the app should provide the emitted content, such as a photo, card, QR code, or receipt-style view.

```kotlin
Box(modifier = Modifier.fillMaxSize()) {
    AppContent()

CameraCutoutContentEmissionOverlay(
        modifier = Modifier.fillMaxSize(),
        emissionConfig = CameraCutoutEmissionConfig(
            enabled = true,
            travelPx = 300f,
            durationMillis = 3000,
            repeatMode = CameraCutoutEmissionRepeatMode.Infinite,
        ),
    ) {
        Image(
            painter = painterResource(R.drawable.printed_photo),
            contentDescription = null,
            modifier = Modifier
                .width(120.dp)
                .aspectRatio(0.75f),
        )
    }
}
```

The library handles cutout detection, origin placement, travel timing, and fade timing. The app owns the content that appears to print from the notch.

## Instax-Style Print

Use `CameraCutoutEmissionMotion.InstaxPrint` when the content should appear to print out from just below the cutout, start almost white, develop into the final image, then disappear.

```kotlin
CameraCutoutContentEmissionOverlay(
    modifier = Modifier.fillMaxSize(),
    emissionConfig = CameraCutoutEmissionConfig(
        enabled = true,
        travelPx = 300f,
        durationMillis = 3000,
        fadeDurationMillis = 600,
        repeatMode = CameraCutoutEmissionRepeatMode.Once,
        motion = CameraCutoutEmissionMotion.InstaxPrint(
            initialWashAlpha = 0.95f,
            developDurationMillis = 900,
            startScale = 0.92f,
            endScale = 1f,
        ),
    ),
) {
    PrintedPhoto()
}
```

## Modules

- `camera-cutout`: the reusable library.
- `sample`: a small app that demonstrates the cutout overlay on real devices.

## License

MIT

android-camera-cutout

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README