# collada2obj
[![codecov](https://codecov.io/gh/WrenchRobotics/collada2obj/graph/badge.svg?token=1UXBQPRTHV)](https://codecov.io/gh/WrenchRobotics/collada2obj)
This Python library can be used to easily convert collada (i.e., `.dae`) files
to wavefront (i.e., `.obj` ) files. This transformation between file formats for 3d
models is useful for a variety of applications, though this library was motivated
by the need for this transformation in some robotics applications.
At the moment, this library is a work in progress and is not yet fully functional.
However, the basic functionality is there and the library can be used to convert
simple collada files to obj files.
See the `examples` directory for example usages of the library.
## Installation
To install this library, you can use `pip`:
```bash
pip install collada2obj
```
### Local Installation
If you want to install this library locally (recommended only if you want to tweak/play around with `collada2obj` itself), then you can clone this repository and
install it using `pip` in the following way:
Change to the root directory of this repo
and then run the following command:
```bash
pip install -e .
```
## Usage
```python
from collada2obj import ColladaFileConverter
def main(input_filename: str = "../convert_base_mesh/base.dae", output_filename: str = "./out.obj"):
# Setup
print(
"Create a converter for the Collada file \"{}\" and export to OBJ file \"{}\"."
.format(input_filename, output_filename)
)
converter = ColladaFileConverter(dae_filename=input_filename, obj_filename=output_filename)
converter.export_obj()
if __name__ == '__main__':
main()
```
## Acknowledgements
This library was initially created by the user [@georgethrax](https://github.com/georgethrax) on GitHub.
It was later expanded and refactored by the Wrench Robotics team.
Raw data
{
"_id": null,
"home_page": "https://github.com/kwesiRutledge/collada2obj",
"name": "collada2obj",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "robotics, 3D Modelling, dae, obj",
"author": "Kwesi Rutledge",
"author_email": "thesolitaryecrivain@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a1/1e/306068da05fa79cbdd7212a7a78043591e478c5b28a6c3046ca367e90ed9/collada2obj-0.1.2.tar.gz",
"platform": null,
"description": "\n# collada2obj\n[![codecov](https://codecov.io/gh/WrenchRobotics/collada2obj/graph/badge.svg?token=1UXBQPRTHV)](https://codecov.io/gh/WrenchRobotics/collada2obj)\n\nThis Python library can be used to easily convert collada (i.e., `.dae`) files\nto wavefront (i.e., `.obj` ) files. This transformation between file formats for 3d\nmodels is useful for a variety of applications, though this library was motivated\nby the need for this transformation in some robotics applications.\n\nAt the moment, this library is a work in progress and is not yet fully functional.\nHowever, the basic functionality is there and the library can be used to convert\nsimple collada files to obj files.\n\nSee the `examples` directory for example usages of the library.\n\n## Installation\n\nTo install this library, you can use `pip`:\n\n```bash\npip install collada2obj\n```\n\n### Local Installation\n\nIf you want to install this library locally (recommended only if you want to tweak/play around with `collada2obj` itself), then you can clone this repository and\ninstall it using `pip` in the following way: \n\nChange to the root directory of this repo\nand then run the following command:\n \n```bash\npip install -e .\n```\n\n## Usage\n\n```python\nfrom collada2obj import ColladaFileConverter\n\ndef main(input_filename: str = \"../convert_base_mesh/base.dae\", output_filename: str = \"./out.obj\"):\n # Setup\n print(\n \"Create a converter for the Collada file \\\"{}\\\" and export to OBJ file \\\"{}\\\".\"\n .format(input_filename, output_filename)\n )\n converter = ColladaFileConverter(dae_filename=input_filename, obj_filename=output_filename)\n converter.export_obj()\n\nif __name__ == '__main__':\n main()\n```\n\n## Acknowledgements\n\nThis library was initially created by the user [@georgethrax](https://github.com/georgethrax) on GitHub.\nIt was later expanded and refactored by the Wrench Robotics team. \n",
"bugtrack_url": null,
"license": null,
"summary": "A library that can be used to easily convert a collada file (.dae) to a wavefront file (.obj).",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/kwesiRutledge/collada2obj"
},
"split_keywords": [
"robotics",
" 3d modelling",
" dae",
" obj"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "871ea24259331256c539b681ef75bd0abe03885913895eea13cda8caade2249e",
"md5": "13287db7b5d513a78b49ab6ab9245896",
"sha256": "5fd1427a0e671e4afc0be112f7d1a6fac1a57f6fd26ce0184e4bd27fa653e900"
},
"downloads": -1,
"filename": "collada2obj-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "13287db7b5d513a78b49ab6ab9245896",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7895,
"upload_time": "2024-08-31T14:26:01",
"upload_time_iso_8601": "2024-08-31T14:26:01.987557Z",
"url": "https://files.pythonhosted.org/packages/87/1e/a24259331256c539b681ef75bd0abe03885913895eea13cda8caade2249e/collada2obj-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a11e306068da05fa79cbdd7212a7a78043591e478c5b28a6c3046ca367e90ed9",
"md5": "fc4615db36f2b77d1899d12c6da0660d",
"sha256": "3d517eadb04d1ac3c690a60c596195c65749fd1786709bcee9b2e3cc55de8ce2"
},
"downloads": -1,
"filename": "collada2obj-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "fc4615db36f2b77d1899d12c6da0660d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6757,
"upload_time": "2024-08-31T14:26:03",
"upload_time_iso_8601": "2024-08-31T14:26:03.297254Z",
"url": "https://files.pythonhosted.org/packages/a1/1e/306068da05fa79cbdd7212a7a78043591e478c5b28a6c3046ca367e90ed9/collada2obj-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-31 14:26:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kwesiRutledge",
"github_project": "collada2obj",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "collada2obj"
}