Skip to main content

クライミングウォールの平面を可視化するツール

Project description


HoldSplitter

~ Unmasking the Wall: Hold by Hold ~
PyPI - Version PyPI - Format PyPI - Implementation PyPI - Status PyPI - Downloads PyPI - Downloads GitHub Repo stars forks - Sunwood-ai-labs GitHub Last Commit GitHub Top Language GitHub Release GitHub Tag GitHub Actions Workflow Status

[🌐 Website][🐱 GitHub] [🐦 Twitter][🍀 Official Blog]


JA doc EN doc

[!IMPORTANT] このリポジトリのリリースノートやREADME、コミットメッセージの9割近くはclaude.aiChatGPT4を活用したAIRA, SourceSage, Gaiah, HarmonAI_IIで生成しています。

HoldSplitterは、ボルダリング壁面の3Dモデルからホールドを分離し、クライミングルートの分析と理解を革新的に支援するPythonツールです。

🎥 Demo

※デモ動画は後日追加予定です。

🚀 Getting Started

HoldSplitterをインストールするには、以下のコマンドを実行してください:

pip install hold-splitter

使用例:

from hold_splitter.main_script import run_blender_script

run_blender_script(fbx_path="path/to/your/model.fbx", offset=0.1, split_threshold=0.1)

📝 Features

  • FBXファイルからのボルダリング壁面3Dモデルの読み込み
  • 壁面とホールドの自動分離
  • 分離されたホールドの個別オブジェクト化
  • Blenderを利用した高度な3D処理
  • Blenderファイル(.blend)形式での出力
  • Unreal Engine 5 (UE5)などの3Dソフトウェアへの簡単なインポート

🛠 Requirements

  • Python 3.10以上
  • Blender 4.2以上

🤝 Contributing

プロジェクトへの貢献を歓迎します!バグレポート、機能リクエスト、プルリクエストなど、お気軽にご参加ください。

📄 License

このプロジェクトはMITライセンスで公開されています。

🙏 Acknowledgements

このプロジェクトは、以下の素晴らしいオープンソースプロジェクトに支えられています:

  • Blender
  • NumPy
  • Open3D
  • PyMeshLab
  • Matplotlib
  • Loguru
  • tqdm

🔄 Updates

  • v0.1.0: 初期リリース。FBXファイルからのホールド分離基本機能を実装。
  • v0.1.1: Blenderスクリプトの改善。ホールド分離の精度向上。
  • v0.2.0: PyPI パッケージ名を "HoldSplitter" から "hold-splitter" に変更し、README を更新。

🎮 UE5 Integration

HoldSplitterは、処理結果をBlenderファイル(.blend)形式で出力することで、Unreal Engine 5 (UE5)などの3Dソフトウェアやゲームエンジンへの簡単なインポートを可能にしています。この設計により以下の利点があります:

  1. 直接インポート: UE5を含む多くの3D制作ソフトウェアでBlenderファイルを直接インポートできます。

  2. データ保持: 3Dモデルのジオメトリだけでなく、マテリアル、テクスチャ、階層構造なども保持されます。

  3. 整理された構造: 分離されたホールドは個別のコレクション内に整理され、UE5でインポート時に自動的に整理された状態で取り込めます。

  4. 柔軟な編集: 必要に応じて、後からBlenderで追加の編集や調整を行うことが容易です。

  5. ゲーム開発向け: クライミングシミュレーターやVR体験の開発など、多様な応用シナリオをサポートします。

これにより、HoldSplitterは3Dモデル処理から実際のゲーム開発まで、シームレスなワークフローを提供します。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hold_splitter-0.3.1.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

hold_splitter-0.3.1-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file hold_splitter-0.3.1.tar.gz.

File metadata

  • Download URL: hold_splitter-0.3.1.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for hold_splitter-0.3.1.tar.gz
Algorithm Hash digest
SHA256 245d90f44e85a2915f453e2af3d2f2939b6f9ccafebe0dc68d526982d932e997
MD5 44c798887569d9e913a09907820f5d41
BLAKE2b-256 d1aae9d7396635c56fd7f73fb54e323fa6874c7453942aa91500f5c09acdf2fd

See more details on using hashes here.

File details

Details for the file hold_splitter-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for hold_splitter-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8a273359227a1c55706bc929016f70bbb38d3746b317ba5dbe36a24a4c602f84
MD5 08a288f8637afd8985f5a40c86049edb
BLAKE2b-256 87e1d657c1aa728559d11fb7884b911a00e99713e377527fda42dad4c844d7cb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page