353 lines
11 KiB
Markdown
353 lines
11 KiB
Markdown
# PROJECT_MODULE_INDEX
|
||
|
||
> 本文档只基于本地工作区扫描生成，不依赖 Git 远程信息。
|
||
|
||
- 生成时间: 2026-02-28 16:41:46
|
||
- 目标: 为后续优化/重构提供 功能模块 -> 文件 的快速定位索引
|
||
|
||
## 0. 关联分析文档
|
||
|
||
- 优化分析（本轮）: `PROJECT_OPTIMIZATION_ANALYSIS.md`
|
||
- Qt 清理迁移清单: `QT_TO_IMGUI_MIGRATION_CHECKLIST.md`
|
||
- 历史模块分析: `IMGUI_MODULE_ANALYSIS.md`
|
||
|
||
## 1. 一级目录规模（Python）
|
||
|
||
| 目录 | 文件数 | 代码行数 |
|
||
|---|---:|---:|
|
||
| core | 40 | 19892 |
|
||
| gui | 1 | 7 |
|
||
| project | 2 | 759 |
|
||
| root | 2 | 812 |
|
||
| scene | 10 | 3792 |
|
||
| scripts | 18 | 1378 |
|
||
| ssbo_component | 3 | 1907 |
|
||
| templates | 1 | 1282 |
|
||
| tools | 1 | 73 |
|
||
| TransformGizmo | 5 | 3705 |
|
||
| ui | 63 | 17403 |
|
||
|
||
## 2. 功能模块 -> 关键文件映射
|
||
|
||
### 应用启动与组装
|
||
|
||
- 模块职责: 程序入口、系统初始化、模块装配
|
||
- 对应文件:
|
||
- Start_Run.py
|
||
- main.py
|
||
- templates/main_template.py
|
||
|
||
### 世界与运行时核心
|
||
|
||
- 模块职责: 世界生命周期、输入事件、选择、命令、资源、碰撞、地形等
|
||
- 对应文件:
|
||
- core/world.py
|
||
- core/event_handler.py
|
||
- core/selection.py
|
||
- core/Command_System.py
|
||
- core/tool_manager.py
|
||
- core/script_system.py
|
||
- core/resource_manager.py
|
||
- core/collision_manager.py
|
||
- core/terrain_manager.py
|
||
- core/model_drag_drop.py
|
||
- core/InfoPanelManager.py
|
||
- core/CustomMouseController.py
|
||
- core/imgui_style_manager.py
|
||
- core/imgui_webview.py
|
||
- core/selection_outline.py
|
||
- core/render_pipeline_utils.py
|
||
|
||
### VR 系统
|
||
|
||
- 模块职责: VR 管理、渲染阶段、交互、追踪、性能、可视化、配置
|
||
- 对应文件:
|
||
- core/vr_manager.py
|
||
- core/vr/config/vr_config.py
|
||
- core/vr/config/joystick_config.py
|
||
- core/vr/config/shadow_stage.py
|
||
- core/vr/rendering/stages.py
|
||
- core/vr/interaction/actions.py
|
||
- core/vr/interaction/grab.py
|
||
- core/vr/interaction/joystick.py
|
||
- core/vr/interaction/teleport.py
|
||
- core/vr/tracking/controllers.py
|
||
- core/vr/visualization/controllers.py
|
||
- core/vr/visualization/effects.py
|
||
- core/vr/performance/monitoring.py
|
||
- core/vr/performance/optimization.py
|
||
- core/vr/testing/test_mode.py
|
||
|
||
### 场景管理
|
||
|
||
- 模块职责: 模型导入、灯光管理、序列化、IO、切片转换
|
||
- 对应文件:
|
||
- scene/scene_manager.py
|
||
- scene/scene_manager_impl.py
|
||
- scene/scene_manager_model_mixin.py
|
||
- scene/scene_manager_light_mixin.py
|
||
- scene/scene_manager_serialization_mixin.py
|
||
- scene/scene_manager_io_mixin.py
|
||
- scene/scene_manager_convert_tiles_mixin.py
|
||
- scene/util.py
|
||
- scene/tree_roles.py
|
||
|
||
### 项目管理
|
||
|
||
- 模块职责: 项目创建、打开、保存、资源清单
|
||
- 对应文件:
|
||
- project/project_manager.py
|
||
|
||
### 编辑器面板 (ImGui)
|
||
|
||
- 模块职责: 顶部/左侧/中心/右侧属性面板、弹窗、运行时动作、创建对象、动画工具
|
||
- 对应文件:
|
||
- ui/panels/editor_panels.py
|
||
- ui/panels/editor_panels_top.py
|
||
- ui/panels/editor_panels_left.py
|
||
- ui/panels/editor_panels_center.py
|
||
- ui/panels/editor_panels_right.py
|
||
- ui/panels/editor_panels_right_transform.py
|
||
- ui/panels/editor_panels_right_material.py
|
||
- ui/panels/editor_panels_right_collision.py
|
||
- ui/panels/panel_delegates.py
|
||
- ui/panels/property_helpers.py
|
||
- ui/panels/runtime_actions.py
|
||
- ui/panels/create_actions.py
|
||
- ui/panels/app_actions.py
|
||
- ui/panels/dialog_panels.py
|
||
- ui/panels/script_panels.py
|
||
- ui/panels/interaction_panels.py
|
||
- ui/panels/object_factory.py
|
||
- ui/panels/animation_tools.py
|
||
|
||
### LUI 编辑器与组件
|
||
|
||
- 模块职责: LUI 管理、属性编辑、交互编辑、组件定义
|
||
- 对应文件:
|
||
- ui/lui_manager.py
|
||
- ui/lui_function.py
|
||
- ui/LUI/lui_manager_editor.py
|
||
- ui/LUI/lui_manager_interaction.py
|
||
- ui/LUI/lui_function_properties.py
|
||
- ui/LUI/lui_function_components.py
|
||
- ui/LUI/lui_shared.py
|
||
- ui/widgets.py
|
||
- ui/icon_manager.py
|
||
|
||
### LUI 内建控件与皮肤
|
||
|
||
- 模块职责: LUI 基础控件实现与皮肤资源脚本
|
||
- 对应文件:
|
||
- ui/Builtin/Elements.py
|
||
- ui/Builtin/LUI*.py
|
||
- ui/Builtin/RectTransform.py
|
||
- ui/Skins/Metro/LUIMetroSkin.py
|
||
- ui/Skins/Metro/copy_frames.py
|
||
|
||
### Transform Gizmo
|
||
|
||
- 模块职责: 移动/旋转/缩放 gizmo 与事件
|
||
- 对应文件:
|
||
- TransformGizmo/transform_gizmo.py
|
||
- TransformGizmo/move_gizmo.py
|
||
- TransformGizmo/rotate_gizmo.py
|
||
- TransformGizmo/scale_gizmo.py
|
||
- TransformGizmo/events.py
|
||
|
||
### SSBO 选取与编辑
|
||
|
||
- 模块职责: 基于 SSBO 的对象选取与编辑器
|
||
- 对应文件:
|
||
- ssbo_component/ssbo_editor.py
|
||
- ssbo_component/ssbo_controller.py
|
||
- ssbo_component/demo_component.py
|
||
|
||
### 脚本样例与测试
|
||
|
||
- 模块职责: 内置脚本、旋转/移动/缩放测试脚本
|
||
- 对应文件:
|
||
- scripts/*.py
|
||
|
||
### 开发工具
|
||
|
||
- 模块职责: 辅助分析脚本
|
||
- 对应文件:
|
||
- tools/open_source_rate.py
|
||
|
||
## 3. 配置与运行关键文件
|
||
|
||
- config/vr_settings.json
|
||
- core/vr/config/vr_settings.json
|
||
- vr_actions/actions.json
|
||
- vr_actions/bindings_index.json
|
||
- vr_actions/bindings_oculus.json
|
||
- vr_actions/bindings_vive.json
|
||
- imgui.ini
|
||
- requirements/requirements.txt
|
||
- requirements/clean-requirements.txt
|
||
- requirements/conda-requirements.txt
|
||
- requirements/environment.yml
|
||
|
||
## 4. 第三方/外部子树说明
|
||
|
||
- RenderPipelineFile/: 第三方渲染管线源码与工具，Python 文件 246 个，约 31629 行。
|
||
- 优化建议: 优先在本项目业务目录改动（core/, ui/, scene/, project/, ssbo_component/, TransformGizmo/），避免直接修改第三方目录。
|
||
|
||
## 5. 完整 Python 文件索引（含行数）
|
||
|
||
| 文件 | 行数 |
|
||
|---|---:|
|
||
| core/__init__.py | 23 |
|
||
| core/collision_manager.py | 1050 |
|
||
| core/Command_System.py | 576 |
|
||
| core/CustomMouseController.py | 185 |
|
||
| core/event_handler.py | 576 |
|
||
| core/imgui_style_manager.py | 428 |
|
||
| core/imgui_webview.py | 189 |
|
||
| core/InfoPanelManager.py | 1460 |
|
||
| core/model_drag_drop.py | 485 |
|
||
| core/render_pipeline_utils.py | 17 |
|
||
| core/resource_manager.py | 471 |
|
||
| core/script_system.py | 817 |
|
||
| core/selection.py | 2461 |
|
||
| core/selection_outline.py | 263 |
|
||
| core/terrain_manager.py | 571 |
|
||
| core/tool_manager.py | 133 |
|
||
| core/vr/__init__.py | 31 |
|
||
| core/vr/config/__init__.py | 8 |
|
||
| core/vr/config/joystick_config.py | 226 |
|
||
| core/vr/config/shadow_stage.py | 145 |
|
||
| core/vr/config/vr_config.py | 216 |
|
||
| core/vr/interaction/__init__.py | 9 |
|
||
| core/vr/interaction/actions.py | 484 |
|
||
| core/vr/interaction/grab.py | 329 |
|
||
| core/vr/interaction/joystick.py | 561 |
|
||
| core/vr/interaction/teleport.py | 331 |
|
||
| core/vr/performance/__init__.py | 9 |
|
||
| core/vr/performance/monitoring.py | 972 |
|
||
| core/vr/performance/optimization.py | 287 |
|
||
| core/vr/rendering/__init__.py | 10 |
|
||
| core/vr/rendering/stages.py | 712 |
|
||
| core/vr/testing/__init__.py | 6 |
|
||
| core/vr/testing/test_mode.py | 609 |
|
||
| core/vr/tracking/__init__.py | 9 |
|
||
| core/vr/tracking/controllers.py | 391 |
|
||
| core/vr/visualization/__init__.py | 8 |
|
||
| core/vr/visualization/controllers.py | 631 |
|
||
| core/vr/visualization/effects.py | 174 |
|
||
| core/vr_manager.py | 2970 |
|
||
| core/world.py | 1059 |
|
||
| gui/__init__.py | 7 |
|
||
| main.py | 770 |
|
||
| project/__init__.py | 10 |
|
||
| project/project_manager.py | 749 |
|
||
| scene/__init__.py | 10 |
|
||
| scene/scene_manager.py | 17 |
|
||
| scene/scene_manager_convert_tiles_mixin.py | 473 |
|
||
| scene/scene_manager_impl.py | 15 |
|
||
| scene/scene_manager_io_mixin.py | 962 |
|
||
| scene/scene_manager_light_mixin.py | 403 |
|
||
| scene/scene_manager_model_mixin.py | 919 |
|
||
| scene/scene_manager_serialization_mixin.py | 749 |
|
||
| scene/tree_roles.py | 3 |
|
||
| scene/util.py | 241 |
|
||
| scripts/a.py | 25 |
|
||
| scripts/BouncerScript.py | 99 |
|
||
| scripts/ColorChangerScript.py | 157 |
|
||
| scripts/ComboAnimatorScript.py | 36 |
|
||
| scripts/example_script.py | 44 |
|
||
| scripts/FollowerScript.py | 66 |
|
||
| scripts/MoverScript.py | 88 |
|
||
| scripts/R_P.py | 110 |
|
||
| scripts/R_R.py | 110 |
|
||
| scripts/Rotate_H_Script.py | 181 |
|
||
| scripts/Rotate_P_Script.py | 181 |
|
||
| scripts/Rotate_R_Script.py | 44 |
|
||
| scripts/RotatorScript.py | 36 |
|
||
| scripts/ScalerScript.py | 88 |
|
||
| scripts/test_quick_script.py | 25 |
|
||
| scripts/TestMover.py | 38 |
|
||
| scripts/TestRotator.py | 25 |
|
||
| scripts/TestScaler.py | 25 |
|
||
| ssbo_component/demo_component.py | 70 |
|
||
| ssbo_component/ssbo_controller.py | 1055 |
|
||
| ssbo_component/ssbo_editor.py | 782 |
|
||
| Start_Run.py | 42 |
|
||
| templates/main_template.py | 1282 |
|
||
| tools/open_source_rate.py | 73 |
|
||
| TransformGizmo/events.py | 14 |
|
||
| TransformGizmo/move_gizmo.py | 950 |
|
||
| TransformGizmo/rotate_gizmo.py | 1412 |
|
||
| TransformGizmo/scale_gizmo.py | 860 |
|
||
| TransformGizmo/transform_gizmo.py | 469 |
|
||
| ui/Builtin/__init__.py | 0 |
|
||
| ui/Builtin/Elements.py | 242 |
|
||
| ui/Builtin/LUIBlockText.py | 74 |
|
||
| ui/Builtin/LUIButton.py | 169 |
|
||
| ui/Builtin/LUICanvas.py | 97 |
|
||
| ui/Builtin/LUICheckbox.py | 65 |
|
||
| ui/Builtin/LUIFormattedLabel.py | 38 |
|
||
| ui/Builtin/LUIFrame.py | 54 |
|
||
| ui/Builtin/LUIHorizontalLayout.py | 13 |
|
||
| ui/Builtin/LUIInitialState.py | 32 |
|
||
| ui/Builtin/LUIInputField.py | 180 |
|
||
| ui/Builtin/LUIInputHandler.py | 5 |
|
||
| ui/Builtin/LUILabel.py | 63 |
|
||
| ui/Builtin/LUILayouts.py | 80 |
|
||
| ui/Builtin/LUIObject.py | 12 |
|
||
| ui/Builtin/LUIProgressbar.py | 54 |
|
||
| ui/Builtin/LUIRadiobox.py | 73 |
|
||
| ui/Builtin/LUIRadioboxGroup.py | 31 |
|
||
| ui/Builtin/LUIRegion.py | 5 |
|
||
| ui/Builtin/LUIRoot.py | 5 |
|
||
| ui/Builtin/LUIScrollableRegion.py | 119 |
|
||
| ui/Builtin/LUISelectbox.py | 158 |
|
||
| ui/Builtin/LUISkin.py | 34 |
|
||
| ui/Builtin/LUISlider.py | 185 |
|
||
| ui/Builtin/LUISprite.py | 12 |
|
||
| ui/Builtin/LUISpriteButton.py | 23 |
|
||
| ui/Builtin/LUITabbedFrame.py | 77 |
|
||
| ui/Builtin/LUIVerticalLayout.py | 13 |
|
||
| ui/Builtin/RectTransform.py | 73 |
|
||
| ui/icon_manager.py | 123 |
|
||
| ui/LUI/__init__.py | 1 |
|
||
| ui/LUI/lui_function_components.py | 1149 |
|
||
| ui/LUI/lui_function_properties.py | 1601 |
|
||
| ui/LUI/lui_manager_editor.py | 1593 |
|
||
| ui/LUI/lui_manager_interaction.py | 1351 |
|
||
| ui/LUI/lui_shared.py | 62 |
|
||
| ui/lui_function.py | 31 |
|
||
| ui/lui_manager.py | 199 |
|
||
| ui/panels/__init__.py | 0 |
|
||
| ui/panels/animation_tools.py | 1390 |
|
||
| ui/panels/app_actions.py | 1097 |
|
||
| ui/panels/create_actions.py | 147 |
|
||
| ui/panels/dialog_panels.py | 992 |
|
||
| ui/panels/editor_panels.py | 20 |
|
||
| ui/panels/editor_panels_center.py | 187 |
|
||
| ui/panels/editor_panels_left.py | 543 |
|
||
| ui/panels/editor_panels_right.py | 742 |
|
||
| ui/panels/editor_panels_right_collision.py | 210 |
|
||
| ui/panels/editor_panels_right_material.py | 222 |
|
||
| ui/panels/editor_panels_right_transform.py | 89 |
|
||
| ui/panels/editor_panels_top.py | 319 |
|
||
| ui/panels/interaction_panels.py | 128 |
|
||
| ui/panels/object_factory.py | 390 |
|
||
| ui/panels/panel_delegates.py | 512 |
|
||
| ui/panels/property_helpers.py | 1583 |
|
||
| ui/panels/runtime_actions.py | 356 |
|
||
| ui/panels/script_panels.py | 287 |
|
||
| ui/Skins/__init__.py | 0 |
|
||
| ui/Skins/Default/__init__.py | 0 |
|
||
| ui/Skins/Metro/__init__.py | 0 |
|
||
| ui/Skins/Metro/copy_frames.py | 31 |
|
||
| ui/Skins/Metro/LUIMetroSkin.py | 24 |
|
||
| ui/widgets.py | 38 |
|
||
|
||
## 6. 使用方式（优化流程建议）
|
||
|
||
1. 先在 功能模块 -> 关键文件映射 中定位模块。
|
||
2. 再到 完整 Python 文件索引 按文件名快速跳转。
|
||
3. 优先处理高行数核心文件（如 core/selection.py, core/vr_manager.py, ui/panels/property_helpers.py）。
|