https://github.com/smithsonian/dpo-cook
DPO Cook - 3D Model/Geometry/Texture Processing Server
https://github.com/smithsonian/dpo-cook
Last synced: over 1 year ago
JSON representation
DPO Cook - 3D Model/Geometry/Texture Processing Server
- Host: GitHub
- URL: https://github.com/smithsonian/dpo-cook
- Owner: Smithsonian
- License: apache-2.0
- Created: 2018-10-04T08:33:55.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-19T13:00:00.000Z (over 1 year ago)
- Last Synced: 2025-03-31T08:12:12.175Z (over 1 year ago)
- Language: TypeScript
- Size: 2.56 MB
- Stars: 76
- Watchers: 12
- Forks: 10
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Smithsonian DPO Cook
3D Model/Geometry/Texture Processing Server.
### Important
This is alpha software under active development. Breaking changes can happen anytime, without prior notice.
You are welcome to experiment with the software, but please understand that we can't provide support at this time.
For questions, issues and bug reports, please open an issue on Github.
### Introduction
Processing 3D meshes can be tedious. For tasks such as mesh decimation, creation of UV coordinates, map baking, and
file conversion, dozens of tools are available. There is currently no "one size fits all" solution. Often it takes a
lot of time and patience to find a chain of tools which work nicely together.
The Cook service simplifies the processing of 3D model, mesh, and texture data by providing a simplified
interface for about a dozen of the most widely used processing tools. Tools are abstracted into tasks. For example,
mesh decimation is available as a task with a unified set of parameters, regardless whether it is executed using
tool A or B.
The Cook executes on recipes. A recipe is a JSON document describing a processing workflow, where a set of files
is processed by multiple tools. Recipes offer "intelligent branching": depending on the outcome of one tool, it
can decide what to do next. If a recipe fails on a task using tool A, it can simply decide to try again using tool B.
Recipes are controlled by a set of global parameters. Instead of entering the same information again and again
for each tool to be executed, parameters are defined once and then automatically fed to each involved tool.
### Web API, web UI and CLI
Currently, the Cook can be operated in three ways:
- Restful web API
- Web-based user interface
- Remote command line interface
The remote CLI is no longer part of this repository. You can find it here: https://github.com/Smithsonian/dpo-cook-cli.git
### Documentation
This project, including its documentation, is under active development.
- [Documentation Home](https://smithsonian.github.io/dpo-cook)
### Questions / Comments / Issues
Please open an issue and we will respond ASAP.
### Contributions
We welcome any contributions to the project. Please open a PR for any bug fixes and open an issue for any major changes or feature ideas.
### Feature Requests
Given that the Smithsonian 3D team has limited resources, our implementation of new features will be limited to those that are directly aligned with the strategic goals and objectives of the institution. We are, however, happy to accept and review any PRs for functionality that will add value for our community at large.