Homemaker Add-on 项目教程

1. 项目目录结构及介绍

Homemaker Add-on 项目的目录结构如下：

homemaker-addon/
├── dist/
├── docs/
├── molior/
├── share/
├── tests/
├── topologist/
├── .gitignore
├── readthedocs.yaml
├── LICENSE
├── Makefile
├── README.md
├── __init__.py
├── blender_manifest.toml
├── brep2ifc.py
├── coding.md
├── dxf2ifc.py
├── requirements.txt
├── setup.py
└── widgets.blend

目录介绍

• dist/: 存放打包后的发行文件。
• docs/: 存放项目文档。
• molior/: 项目的主要代码目录。
• share/: 存放共享资源文件。
• tests/: 存放测试代码。
• topologist/: 与 Topologic 相关的代码。
• .gitignore: Git 忽略文件配置。
• readthedocs.yaml: ReadTheDocs 配置文件。
• LICENSE: 项目许可证文件。
• Makefile: 项目构建文件。
• README.md: 项目介绍和使用说明。
• init.py: Python 包初始化文件。
• blender_manifest.toml: Blender 插件清单文件。
• brep2ifc.py: 将 BREP 文件转换为 IFC 文件的脚本。
• coding.md: 编码规范文档。
• dxf2ifc.py: 将 DXF 文件转换为 IFC 文件的脚本。
• requirements.txt: 项目依赖文件。
• setup.py: 项目安装脚本。
• widgets.blend: Blender 插件的 UI 文件。

2. 项目启动文件介绍

项目的启动文件是 __init__.py，它包含了插件的初始化代码。该文件的主要作用是注册插件并定义插件的入口点。

# __init__.py

import bpy

bl_info = {
    "name": "Homemaker Add-on",
    "blender": (2, 80, 0),
    "category": "Object",
}

def register():
    # 注册插件
    pass

def unregister():
    # 注销插件
    pass

if __name__ == "__main__":
    register()

3. 项目配置文件介绍

项目的配置文件主要包括 blender_manifest.toml 和 requirements.txt。

blender_manifest.toml

该文件是 Blender 插件的清单文件，定义了插件的基本信息和依赖关系。

[blender]
name = "Homemaker Add-on"
version = "1.0"
author = "Bruno Postle"
description = "Design buildings the pointy-clicky way"
category = "Object"

requirements.txt

该文件列出了项目运行所需的 Python 依赖包。

topologic
pyyaml

通过以上配置文件，用户可以了解项目的依赖关系和基本信息，从而更好地进行安装和配置。