Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kivy-garden/xcamera
Kivy widget for taking pictures with the camera, optimized for Android. It uses the native Android's APIs to take the pictures, thus ensuring good quality, high resolution, auto-focus, etc.
https://github.com/kivy-garden/xcamera
Last synced: about 1 month ago
JSON representation
Kivy widget for taking pictures with the camera, optimized for Android. It uses the native Android's APIs to take the pictures, thus ensuring good quality, high resolution, auto-focus, etc.
- Host: GitHub
- URL: https://github.com/kivy-garden/xcamera
- Owner: kivy-garden
- License: mit
- Created: 2019-09-10T12:35:17.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-04-03T08:06:40.000Z (9 months ago)
- Last Synced: 2024-11-03T02:37:47.155Z (about 2 months ago)
- Language: Python
- Size: 1.07 MB
- Stars: 44
- Watchers: 13
- Forks: 16
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# XCamera: Android-optimized camera widget
[](https://github.com/kivy-garden/xcamera/actions?query=workflow%3ATests)
[](https://github.com/kivy-garden/xcamera/actions?query=workflow%3AAndroid)
[](https://travis-ci.com/kivy-garden/xcamera)
[](https://coveralls.io/github/kivy-garden/xcamera?branch=develop)
[](https://badge.fury.io/py/xcamera)
XCamera is a widget which extends the standard Kivy Camera widget with more
functionality. In particular:
1. it displays a "shoot button", which the user can press to take pictures
2. on Android, it uses the native APIs to take high-quality pictures,
including features such as auto-focus, high resolution, etc.
3. it includes a method to force landscape mode. On Android, it is often
desirable to switch to landscape mode when taking pictures: you can
easily do it by calling `camera.force_landscape()`, and later
`camera.restore_orientation()` to restore the orientation to whatever it
was before.
Screenshot:
Notes:
* On Android, the `resolution` property of the `XCamera` (and also of the
plain `Camera`) widget controls the **preview size**: in other words, it
only affects the quality of the preview, not the size of the pictures
taken.
* As it is now, the camera will shoot using the default setting for the
picture size, which seems to be what the camera think it is "the best". In
theory, we could add a method to retrieve the list of all possible picture
sizes, and add a property to control it. It would also be nice to add a
new button to allow the user to manually select the preferred size. Pull
requests are welcome :)
## Install & Usage
[xcamera is available on PyPI](https://pypi.org/project/xcamera/).
Therefore it can be installed via `pip`.
```sh
pip3 install xcamera
```
Once installed, the demo should be available in your `PATH` and can be ran from the command line.
```sh
xcamera
```
And the widget can be imported via:
```python
from kivy_garden.xcamera import XCamera
```
## Demo
A full working demo is available in [src/kivy_garden/xcamera/main.py](https://github.com/kivy-garden/xcamera/blob/develop/src/main.py).
You can run it via:
```sh
make run
```
## Develop & Contribute
To play with the project, install system dependencies and Python requirements using the [Makefile](Makefile).
```sh
make
```
Then verify everything is OK by running tests.
```sh
make test
```
If you're familiar with `Docker`, the project can also run in a fully isolated container.
First build the image.
```sh
make docker/build
```
Then you can run tests within the container.
```sh
make docker/run/test
```
Or the application itself.
```sh
make docker/run/app
```