.. -*- rst -*-
=========
PiCameraX
=========
PiCamera + Extras
-----------------
This package provides a pure Python interface to the `Raspberry Pi`_ `camera`_
module for Python 3.2 or above, with extra features and fixes.
* Lens-shading table support (from rwb27/master)
* Read-write analog gain (from rwb27/master)
* Greyworld AWB (from chrisruk/greyworld)
* Bayer array support for HQ camera (from AlecVercruysse/master)
* Dropped support for Python 2
Why?
----
The upstream waveform80/picamera library has reached a point of stability meaning some more cutting-edge
features will be unsuitable for inclusion, or face delays.
This fork will include new features and fixes more rapidly, allowing the latest camera revisions, and
more experimental software features, to be easily used much earlier than they would otherwise.
Installation
------------
.. code-block::
pip install picamerax
Links
-----
* The code is licensed under the `BSD license`_
* The `source code`_ can be obtained from GitHub, which also hosts the `bug
tracker`_
* The `documentation`_ (which includes installation, quick-start examples, and
lots of code recipes) can be read on ReadTheDocs
* Packages can be downloaded from `PyPI`_, but reading the installation
instructions is more likely to be useful
.. _Raspberry Pi: https://www.raspberrypi.org/
.. _camera: https://www.raspberrypi.org/learning/getting-started-with-picamera/
.. _PyPI: https://pypi.python.org/pypi/picamerax/
.. _documentation: https://picamerax.readthedocs.io/
.. _source code: https://github.com/labthings/picamerax
.. _bug tracker: https://github.com/labthings/picamerax/issues
.. _BSD license: https://opensource.org/licenses/BSD-3-Clause
Developer notes
---------------
Why calendar versioning?
^^^^^^^^^^^^^^^^^^^^^^^^
We want `picamerax` to stay more or less in sync with upstream `picamera`. However, this fork
adds significant new features that would constitute new version numbers under semantic versioning.
If we were to adopt semantic versioning, we would rapidly fall completely out of sync with the
upstream version numbers.
By using calendar versioning, and clearly tracking new additions to the library, we
can ensure the upstream base version is obvious (by looking at its release date in relation to
our current calendar version), without worrying about what new features count as justifying
new semantic versions.
This can change however if everyone else deems it a bad idea.
Raw data
{
"_id": null,
"home_page": "https://github.com/labthings/picamerax",
"name": "picamerax",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "raspberrypi, camera",
"author": "Dave Jones",
"author_email": "dave@waveform.org.uk",
"download_url": "https://files.pythonhosted.org/packages/40/74/50e0993f50345c5ed13f5f9fdd2ee51e3a24a3fe76c3f55546d93ad42062/picamerax-24.3.21.tar.gz",
"platform": "ALL",
"description": ".. -*- rst -*-\n\n=========\nPiCameraX\n=========\n\nPiCamera + Extras\n-----------------\n\nThis package provides a pure Python interface to the `Raspberry Pi`_ `camera`_\nmodule for Python 3.2 or above, with extra features and fixes.\n\n* Lens-shading table support (from rwb27/master)\n* Read-write analog gain (from rwb27/master)\n* Greyworld AWB (from chrisruk/greyworld)\n* Bayer array support for HQ camera (from AlecVercruysse/master)\n* Dropped support for Python 2\n\nWhy?\n----\n\nThe upstream waveform80/picamera library has reached a point of stability meaning some more cutting-edge \nfeatures will be unsuitable for inclusion, or face delays. \nThis fork will include new features and fixes more rapidly, allowing the latest camera revisions, and\nmore experimental software features, to be easily used much earlier than they would otherwise.\n\nInstallation\n------------\n\n.. code-block::\n\n pip install picamerax\n\nLinks\n-----\n\n* The code is licensed under the `BSD license`_\n* The `source code`_ can be obtained from GitHub, which also hosts the `bug\n tracker`_\n* The `documentation`_ (which includes installation, quick-start examples, and\n lots of code recipes) can be read on ReadTheDocs\n* Packages can be downloaded from `PyPI`_, but reading the installation\n instructions is more likely to be useful\n\n\n.. _Raspberry Pi: https://www.raspberrypi.org/\n.. _camera: https://www.raspberrypi.org/learning/getting-started-with-picamera/\n.. _PyPI: https://pypi.python.org/pypi/picamerax/\n.. _documentation: https://picamerax.readthedocs.io/\n.. _source code: https://github.com/labthings/picamerax\n.. _bug tracker: https://github.com/labthings/picamerax/issues\n.. _BSD license: https://opensource.org/licenses/BSD-3-Clause\n\nDeveloper notes\n---------------\n\nWhy calendar versioning?\n^^^^^^^^^^^^^^^^^^^^^^^^\n\nWe want `picamerax` to stay more or less in sync with upstream `picamera`. However, this fork\nadds significant new features that would constitute new version numbers under semantic versioning.\nIf we were to adopt semantic versioning, we would rapidly fall completely out of sync with the \nupstream version numbers. \n\nBy using calendar versioning, and clearly tracking new additions to the library, we\ncan ensure the upstream base version is obvious (by looking at its release date in relation to \nour current calendar version), without worrying about what new features count as justifying \nnew semantic versions.\n\nThis can change however if everyone else deems it a bad idea.\n\n\n",
"bugtrack_url": null,
"license": "BSD License",
"summary": "A pure Python interface for the Raspberry Pi camera module, with extra features and fixes.",
"version": "24.3.21",
"project_urls": {
"Homepage": "https://github.com/labthings/picamerax"
},
"split_keywords": [
"raspberrypi",
" camera"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "16fedbdfc90d4ed652844c6c5dbaaf4c0b7e8801150f933323f6c155e9c9fe33",
"md5": "65e764ccd05b30435fac96fbe423af09",
"sha256": "df5a1d8129cf2449c1dd87caa32bd3c063e08630e8b7009489a8cb1fa3d79f43"
},
"downloads": -1,
"filename": "picamerax-24.3.21-py3-none-any.whl",
"has_sig": false,
"md5_digest": "65e764ccd05b30435fac96fbe423af09",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 158831,
"upload_time": "2024-03-21T12:16:44",
"upload_time_iso_8601": "2024-03-21T12:16:44.898512Z",
"url": "https://files.pythonhosted.org/packages/16/fe/dbdfc90d4ed652844c6c5dbaaf4c0b7e8801150f933323f6c155e9c9fe33/picamerax-24.3.21-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "407450e0993f50345c5ed13f5f9fdd2ee51e3a24a3fe76c3f55546d93ad42062",
"md5": "43b0514c79257fcff170d4e3ed367386",
"sha256": "73dd95203ba7edf02408f93f3520ffe33d352510c7ad2efce5175c85abcdcdf8"
},
"downloads": -1,
"filename": "picamerax-24.3.21.tar.gz",
"has_sig": false,
"md5_digest": "43b0514c79257fcff170d4e3ed367386",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 147161,
"upload_time": "2024-03-21T12:16:46",
"upload_time_iso_8601": "2024-03-21T12:16:46.432317Z",
"url": "https://files.pythonhosted.org/packages/40/74/50e0993f50345c5ed13f5f9fdd2ee51e3a24a3fe76c3f55546d93ad42062/picamerax-24.3.21.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-21 12:16:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "labthings",
"github_project": "picamerax",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "picamerax"
}
JSON
