| Name | kriptomatte JSON |
| Version |
0.0.14
JSON |
| download |
| home_page | None |
| Summary | Decode Cryptomattes in EXR file to PNG masks. |
| upload_time | 2024-07-22 11:27:22 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.5 |
| license | None |
| keywords |
cryptomatte
exr
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Kriptomatte: Making Cryptomattes Easier for 2D Artists
This document outlines the Kriptomatte project, which aims to bring Cryptomatte functionality to Krita, the popular open-source painting software.
[中文](readme_sc.md)
## What is Kriptomatte and What is this repo?
Kriptomatte is a tool that helps artists work with Cryptomattes, which are special masks embedded within EXR image files. These masks isolate objects, materials, and assets, making them easier to select and manipulate in video post-processing software.
Unfortunately, typical 2D image editing software doesn't work well with Cryptomattes, so artists often rely on ID Passes. While many popular software packages, such as Blender, lack the option to render ID passes, the codes in this repo (Kriptomatte Phase 1) offer a solution. Kriptomatte converts Cryptomatte information into ID Pass-like masks that can be used in painting software like Krita, Photoshop, and Clip Studio.
Seperated Masks are also exported for a finer control.
## Project Phases
The Kriptomatte project is planned for four phases:
### Phase 1: Python Script (Current Phase)
https://pypi.org/project/kriptomatte/
This phase focuses on creating a Python script that can extract Cryptomatte information from EXR files and convert it into separate, colored PNG images with alpha channels. This makes Cryptomattes more accessible to artists who can use these PNGs for painting in any software they prefer.
### Phase 2: Standalone Executable
Phase 2 will rewrite the Python script in C++ to create a faster, standalone executable program. This program won't require any command-line experience; artists can simply drag and drop their EXR files onto the executable to generate the PNGs.
### Phase 3a & 3b: Krita Integration
The final phases involve integrating Kriptomatte functionality directly into Krita. Phase 3a will focus on creating a C++ port of the code, while Phase 3b will develop a Python plugin for Krita.
# Usage
## Installation
You can install the script using `pip` from your **command prompt** (also known as a **terminal**). If you're unfamiliar with the concept, think of it as a special window where you type commands for your computer to execute. Here's how to open it on Windows: **hold Shift** and **right-click** on your desktop, then select **"Open PowerShell here"** or **"Open Windows Terminal here."** Once the terminal opens, copy and paste one of the following commands to install:
```bash
python -m pip install kriptomatte
# or
pip install kriptomatte
```
## Use from Terminal
After installation, you can use the script in your terminal. Open the terminal again, navigate to the directory containing your EXR file, and run the following command, replacing "path/to/your/file.exr" with the actual path to your file:
To easily find the path to your EXR file on Windows, left-click it, then type `alt + 3`.
This will copy the file location to your clipboard. You can then paste it into the command.
If the hotkey doesn't work, you can find a light blue option to copy the file path in the top-left corner of your File Explorer.
```bash
kriptomatte -i "path to your exr file"
# for example
kriptomatte -i "C:\Users\GrandArth\Pictures\sample.exr"
```
## Important Note:
Currently, the script only supports Cryptomattes stored in 32-bit EXR files. Ensure your EXR files are rendered with 32-bit precision for the script to work correctly.
# Code Reference
```ref
Friedman, Jonah, and Andrew C. Jones. 2015. “Fully Automatic ID Mattes with Support for Motion Blur and Transparency.” In ACM SIGGRAPH 2015 Posters, 1–1. Los Angeles California: ACM. https://doi.org/10.1145/2787626.2787629.
“OpenEXR Bindings for Python.” n.d. Accessed July 17, 2024. https://www.excamera.com/sphinx/articles-openexr.html.
“Psyop/Cryptomatte.” (2015) 2024. Python. Psyop. https://github.com/Psyop/Cryptomatte.
“Synthesis-AI-Dev/Exr-Info: Package with Helper Modules to Process EXR Files Generated by Renders.” n.d. Accessed July 21, 2024. https://github.com/Synthesis-AI-Dev/exr-info.
```
Raw data
{
"_id": null,
"home_page": null,
"name": "kriptomatte",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": null,
"keywords": "Cryptomatte, EXR",
"author": null,
"author_email": "GrandArth <risiamuxms@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/bc/f6/3fd408db88b81b11a03507706c1f6d7303e5c2db1527eee95151265a542a/kriptomatte-0.0.14.tar.gz",
"platform": null,
"description": "\n# Kriptomatte: Making Cryptomattes Easier for 2D Artists\nThis document outlines the Kriptomatte project, which aims to bring Cryptomatte functionality to Krita, the popular open-source painting software.\n\n[\u4e2d\u6587](readme_sc.md)\n\n## What is Kriptomatte and What is this repo?\n\nKriptomatte is a tool that helps artists work with Cryptomattes, which are special masks embedded within EXR image files. These masks isolate objects, materials, and assets, making them easier to select and manipulate in video post-processing software. \n\nUnfortunately, typical 2D image editing software doesn't work well with Cryptomattes, so artists often rely on ID Passes. While many popular software packages, such as Blender, lack the option to render ID passes, the codes in this repo (Kriptomatte Phase 1) offer a solution. Kriptomatte converts Cryptomatte information into ID Pass-like masks that can be used in painting software like Krita, Photoshop, and Clip Studio.\n\n\n\nSeperated Masks are also exported for a finer control.\n\n\n\n## Project Phases\n\nThe Kriptomatte project is planned for four phases:\n\n### Phase 1: Python Script (Current Phase)\n\nhttps://pypi.org/project/kriptomatte/\n\nThis phase focuses on creating a Python script that can extract Cryptomatte information from EXR files and convert it into separate, colored PNG images with alpha channels. This makes Cryptomattes more accessible to artists who can use these PNGs for painting in any software they prefer.\n\n### Phase 2: Standalone Executable\n\nPhase 2 will rewrite the Python script in C++ to create a faster, standalone executable program. This program won't require any command-line experience; artists can simply drag and drop their EXR files onto the executable to generate the PNGs.\n\n### Phase 3a & 3b: Krita Integration\n\nThe final phases involve integrating Kriptomatte functionality directly into Krita. Phase 3a will focus on creating a C++ port of the code, while Phase 3b will develop a Python plugin for Krita.\n\n\n# Usage\n\n## Installation \n\nYou can install the script using `pip` from your **command prompt** (also known as a **terminal**). If you're unfamiliar with the concept, think of it as a special window where you type commands for your computer to execute. Here's how to open it on Windows: **hold Shift** and **right-click** on your desktop, then select **\"Open PowerShell here\"** or **\"Open Windows Terminal here.\"** Once the terminal opens, copy and paste one of the following commands to install:\n\n```bash\npython -m pip install kriptomatte\n# or\npip install kriptomatte\n```\n\n## Use from Terminal\n\nAfter installation, you can use the script in your terminal. Open the terminal again, navigate to the directory containing your EXR file, and run the following command, replacing \"path/to/your/file.exr\" with the actual path to your file:\n\nTo easily find the path to your EXR file on Windows, left-click it, then type `alt + 3`.\nThis will copy the file location to your clipboard. You can then paste it into the command.\nIf the hotkey doesn't work, you can find a light blue option to copy the file path in the top-left corner of your File Explorer.\n\n```bash\nkriptomatte -i \"path to your exr file\"\n# for example\nkriptomatte -i \"C:\\Users\\GrandArth\\Pictures\\sample.exr\"\n```\n\n## Important Note:\n\nCurrently, the script only supports Cryptomattes stored in 32-bit EXR files. Ensure your EXR files are rendered with 32-bit precision for the script to work correctly.\n\n# Code Reference\n\n```ref\nFriedman, Jonah, and Andrew C. Jones. 2015. \u201cFully Automatic ID Mattes with Support for Motion Blur and Transparency.\u201d In ACM SIGGRAPH 2015 Posters, 1\u20131. Los Angeles California: ACM. https://doi.org/10.1145/2787626.2787629.\n\u201cOpenEXR Bindings for Python.\u201d n.d. Accessed July 17, 2024. https://www.excamera.com/sphinx/articles-openexr.html.\n\u201cPsyop/Cryptomatte.\u201d (2015) 2024. Python. Psyop. https://github.com/Psyop/Cryptomatte.\n\u201cSynthesis-AI-Dev/Exr-Info: Package with Helper Modules to Process EXR Files Generated by Renders.\u201d n.d. Accessed July 21, 2024. https://github.com/Synthesis-AI-Dev/exr-info.\n```",
"bugtrack_url": null,
"license": null,
"summary": "Decode Cryptomattes in EXR file to PNG masks.",
"version": "0.0.14",
"project_urls": {
"Homepage": "https://github.com/GrandArth/Kriptomatte-Phase-1",
"Issues": "https://github.com/GrandArth/Kriptomatte-Phase-1/issues"
},
"split_keywords": [
"cryptomatte",
" exr"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23dd925d4efef1ebfddacd42296b8a584fbf4a0c9008aa68835868731f3c2911",
"md5": "3ead3139e76e76e05e719ee0bfa85627",
"sha256": "61cfcca9bc729bb555f3a75b4d1884fd0de215931fe5a002dc61936fc489688d"
},
"downloads": -1,
"filename": "kriptomatte-0.0.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3ead3139e76e76e05e719ee0bfa85627",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 27971,
"upload_time": "2024-07-22T11:27:19",
"upload_time_iso_8601": "2024-07-22T11:27:19.810951Z",
"url": "https://files.pythonhosted.org/packages/23/dd/925d4efef1ebfddacd42296b8a584fbf4a0c9008aa68835868731f3c2911/kriptomatte-0.0.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bcf63fd408db88b81b11a03507706c1f6d7303e5c2db1527eee95151265a542a",
"md5": "ac5a8902c8ac236acbdf937cab3804ea",
"sha256": "f2df868e00e7b57f8e9054691eb58baf9ddd5d1765d6457eb7b1874b1cec69d4"
},
"downloads": -1,
"filename": "kriptomatte-0.0.14.tar.gz",
"has_sig": false,
"md5_digest": "ac5a8902c8ac236acbdf937cab3804ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 1256100,
"upload_time": "2024-07-22T11:27:22",
"upload_time_iso_8601": "2024-07-22T11:27:22.833583Z",
"url": "https://files.pythonhosted.org/packages/bc/f6/3fd408db88b81b11a03507706c1f6d7303e5c2db1527eee95151265a542a/kriptomatte-0.0.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-22 11:27:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GrandArth",
"github_project": "Kriptomatte-Phase-1",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kriptomatte"
}
