hdr-conversion 0.1.0__tar.gz

hdr_conversion-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "develop"]
+  pull_request:
+    branches: ["main", "develop"]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Env
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest

hdr_conversion-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+      - doc
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Create environment
+        run: uv sync --dev
+
+      - name: Build and deploy docs
+        run: uv run mkdocs gh-deploy --force

hdr_conversion-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Build and Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Env
+        run: uv sync --dev
+
+      - name: Import Test
+        run: uv run pytest
+
+  publish:
+    needs: check
+    if: github.event_name == 'release' && github.event.action == 'published'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}

hdr_conversion-0.1.0/.gitignore

@@ -0,0 +1,214 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+.DS_Store
+
+# Test Images
+images/
+
+# VSCODE settings
+.vscode/

hdr_conversion-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

hdr_conversion-0.1.0/LICENSE

@@ -0,0 +1,8 @@
+The MIT License (MIT)
+Copyright © 2025 <Jack Chou>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

hdr_conversion-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: hdr-conversion
+Version: 0.1.0
+Summary: tools for converting HDR images between different formats
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: colour-science>=0.4.6
+Requires-Dist: imagecodecs>=2025.11.11
+Requires-Dist: pillow-heif>=0.22.0
+Requires-Dist: pillow>=11.3.0
+Requires-Dist: pyexiftool>=0.5.6
+Description-Content-Type: text/markdown
+
+# HDR Format Conversion Tool
+
+[简体中文](README-zhCN.md) | [English](README.md)
+
+> Note: In alpha stage, API may change frequently. Currently, color conversion may be incorrect.
+
+API Reference: [https://jackchou.top/hdr-conversion](https://jackchou.top/hdr-conversion/)
+
+## Project Overview
+
+This project provides Python-based research on HDR format parsing and writing, supporting parsing, writing, and conversion of multiple formats including UltraHDR, Adaptive Gainmap (ISO 21496-1), and pure PQ/HLG formats (ISO 22028-5).
+
+Note: This project is for research and learning purposes only and does not aim for production readiness.
+
+## Getting Started
+
+To install, using `uv` (recommended):
+
+```bash
+uv add hdr-conversion
+```
+
+or use `pip`:
+
+```bash
+pip install hdr-conversion
+```
+
+The package can be imported as follows:
+
+```python
+import hdrconv
+```
+
+## Features
+
+### Parsing
+
+For UltraHDR and Adaptive Gainmap formats, supports structured extraction of:
+
+- Main image data
+- Gainmap image data
+- Gainmap metadata
+
+For pure PQ/HLG formats, supports extraction of image data and related metadata.
+
+### Writing
+
+Writes image data and structured metadata into corresponding formats.
+
+UltraHDR and Adaptive Gainmap formats are implemented through manual byte stream editing combined with existing library JPEG encoding capabilities, while pure PQ/HLG formats are implemented through existing libraries.
+
+### Conversion
+
+Calculates alternate images based on metadata to enable conversion between Gainmap and pure HDR formats.
+
+## Reference Standards
+
+- [UltraHDR](https://developer.android.com/media/platform/hdr-image-format): Version 1.1 released in April 2025
+- [ISO 21496-1](https://www.iso.org/standard/86775.html)
+- [ISO 22028-5](https://www.iso.org/standard/81863.html)
+
+## License
+
+MIT. Please refer to the respective LICENSE files for specific format and dependency details.

hdr_conversion-0.1.0/README-zhCN.md

@@ -0,0 +1,65 @@
+# HDR 格式转换工具
+
+[简体中文](README-zhCN.md) | [English](README.md)
+
+> 注意：处于开发阶段，API 可能会频繁变动。目前，颜色转换可能不正确。
+
+API 参考文档: [https://jackchou.top/hdr-conversion](https://jackchou.top/hdr-conversion/)
+
+## 项目简介
+
+本项目提供基于 Python 的 HDR 格式解析与写入研究，支持包括 UltraHDR、Adaptive Gainmap (ISO 21496-1) 以及纯 PQ/HLG 格式 (ISO 22028-5) 在内的多种格式的解析、写入和转换。
+
+注意：仅用于研究与学习，不以生产可用性为目标。
+
+## 快速开始
+
+使用 `uv` 安装（推荐）：
+
+```bash
+uv add hdr-conversion
+```
+
+或使用 `pip`：
+
+```bash
+pip install hdr-conversion
+```
+
+可以按以下方式导入该包：
+
+```python
+import hdrconv
+```
+
+## 功能
+
+### 解析
+
+对于 UltraHDR 和 Adaptive Gainmap 格式，支持结构化的提取以下内容：
+
+- 主图像数据
+- Gainmap 图像数据
+- Gainmap 元数据
+
+对于纯 PQ/HLG 格式，支持提取图像数据和相关元数据。
+
+### 写入
+
+将图像数据和结构化的元数据写入对应的格式中。
+
+其中，UltraHDR 和 Adaptive Gainmap 格式通过手动编辑字节流与现有库提供的 JPEG 编码能力实现，而纯 PQ/HLG 格式则通过现有的库实现。
+
+### 转换
+
+根据元数据计算替代图像（Alternate Image），实现在 Gainmap 与纯 HDR 格式之间的转换。
+
+## 参考标准
+
+- [UltraHDR](https://developer.android.com/media/platform/hdr-image-format)：2025年4月发布的1.1版本
+- [ISO 21496-1](https://www.iso.org/standard/86775.html)
+- [ISO 22028-5](https://www.iso.org/standard/81863.html)
+
+## 许可证
+
+MIT，具体格式和依赖请参见各自的 LICENSE 文件。

hdr_conversion-0.1.0/README.md

@@ -0,0 +1,65 @@
+# HDR Format Conversion Tool
+
+[简体中文](README-zhCN.md) | [English](README.md)
+
+> Note: In alpha stage, API may change frequently. Currently, color conversion may be incorrect.
+
+API Reference: [https://jackchou.top/hdr-conversion](https://jackchou.top/hdr-conversion/)
+
+## Project Overview
+
+This project provides Python-based research on HDR format parsing and writing, supporting parsing, writing, and conversion of multiple formats including UltraHDR, Adaptive Gainmap (ISO 21496-1), and pure PQ/HLG formats (ISO 22028-5).
+
+Note: This project is for research and learning purposes only and does not aim for production readiness.
+
+## Getting Started
+
+To install, using `uv` (recommended):
+
+```bash
+uv add hdr-conversion
+```
+
+or use `pip`:
+
+```bash
+pip install hdr-conversion
+```
+
+The package can be imported as follows:
+
+```python
+import hdrconv
+```
+
+## Features
+
+### Parsing
+
+For UltraHDR and Adaptive Gainmap formats, supports structured extraction of:
+
+- Main image data
+- Gainmap image data
+- Gainmap metadata
+
+For pure PQ/HLG formats, supports extraction of image data and related metadata.
+
+### Writing
+
+Writes image data and structured metadata into corresponding formats.
+
+UltraHDR and Adaptive Gainmap formats are implemented through manual byte stream editing combined with existing library JPEG encoding capabilities, while pure PQ/HLG formats are implemented through existing libraries.
+
+### Conversion
+
+Calculates alternate images based on metadata to enable conversion between Gainmap and pure HDR formats.
+
+## Reference Standards
+
+- [UltraHDR](https://developer.android.com/media/platform/hdr-image-format): Version 1.1 released in April 2025
+- [ISO 21496-1](https://www.iso.org/standard/86775.html)
+- [ISO 22028-5](https://www.iso.org/standard/81863.html)
+
+## License
+
+MIT. Please refer to the respective LICENSE files for specific format and dependency details.