Facilitates integration of image and video capture in applications with a unified API, offering customizable camera components like CameraPreview, supporting multiple platform functionalities.
KaptureX is a library designed to facilitate the integration of image and video capture capabilities in multiplatform applications developed with Kotlin. This library is especially useful for those who want to create applications that support multiple platforms such as Android and iOS, providing a unified API and reusable components.
| Product | Android | iOS |
|---|---|---|
| Camera | ☑️ alpha |
add the dependency build.gradle.kts file:
commonMain.dependencies {
implementation("io.github.estivensh:kaptureX:$version")
}
Below is a basic example of how to use the CameraPreview component in your application:
@OptIn(ExperimentalCameraPreview::class)
@Composable
fun MyCameraScreen() {
val cameraState = rememberCameraState()
CameraPreview(
cameraState = cameraState,
camSelectorOnChanged = { newSelector ->
},
flashModeOnChanged = { newFlashMode ->
},
cameraOptionOnChanged = { newOption ->
}
)
}
The CameraPreview component offers a wide variety of parameters to customize its behavior:
This library was mostly inspired by Camposer.
Camera Library for Android Jetpack Compose. 📸✨
Support it by joining estivensh4 for this
repository. :star:
Also follow me for my next creations! 🤩
Copyright 2024 Estiven Sánchez
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
https:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
| ☑️ alpha |
| Video | ☑️ alpha | ☑️ alpha |
| Flash | ☑️ alpha | ☑️ alpha |
cameraState: Current camera state. Use rememberCameraState() to handle and remember the camera state
camSelector: Selects the camera (front or back). You can handle camera switching using camSelectorOnChanged.
flashMode: Configures the camera's flash mode. You can change it using flashModeOnChanged.
captureMode: Defines the capture mode (image or video).
imageCaptureMode: Sets the image capture mode (high quality or fast speed).
zoomRatio: CControls the zoom level. You can handle zoom changes with onZoomRatioChanged.
isImageAnalysisEnabled: Enables or disables real-time image analysis.
onPreviewStreamChanged: Callback executed when the preview stream changes.
fun CameraSection(
cameraState: CameraState,
useFrontCamera: Boolean,
usePinchToZoom: Boolean
) {
var flashMode by cameraState.rememberFlashMode(FlashMode.valueOf("On"))
var camSelector by rememberCamSelector(if (useFrontCamera) CamSelector.Front else CamSelector.Back)
var zoomRatio by rememberSaveable { mutableStateOf(cameraState.minZoom) }
var zoomHasChanged by rememberSaveable { mutableStateOf(false) }
var cameraOption by rememberSaveable { mutableStateOf(CameraOption.Video) }
val enableTorch = true
CameraPreview(
cameraState = cameraState,
camSelector = camSelector,
captureMode = cameraOption.toCaptureMode(),
flashMode = flashMode,
enableTorch = enableTorch,
zoomRatio = zoomRatio,
isPinchToZoomEnabled = usePinchToZoom,
onZoomRatioChanged = {
zoomHasChanged = true
zoomRatio = it
},
onSwitchToFront = { _ ->
},
onSwitchToBack = { _ ->
},
camSelectorOnChanged = { camSelector = it },
flashModeOnChanged = { flashMode = it },
cameraOptionOnChanged = { cameraOption = it },
cameraOption = cameraOption,
)
}
Surfaced from shared tags and platforms — no rankings paid for.