floorplan-3d README

The project's README from github.com/wy51ai/floorplan-3d. As one markdown file: README.md.

户型装修设计

纯前端的户型装修设计工具:在 2D 平面图上摆放家具、拆改墙体、测量尺寸,一键切换到 Three.js 3D 场景,可以鸟瞰,也可以第一人称漫游。整个应用就是一个 index.html,无需构建,打开即用。

功能

2D 平面布置

3D 场景

方案与统计

快速开始

git clone <仓库地址>
cd <仓库目录>

然后直接用浏览器打开 index.html。也可以起一个本地静态服务器:

python3 -m http.server 8000
# 访问 http://localhost:8000

Three.js 通过 jsDelivr CDN 加载,首次打开 3D 场景需要联网。

快捷键

按键 作用
T 切换 2D / 3D
V / M / X 选择 / 测量 / 拆改墙体
R / Shift+R 选中家具顺时针 / 逆时针旋转 90°
Delete / Backspace 删除选中家具
Ctrl/⌘ + D 复制选中家具
Ctrl/⌘ + Z,Ctrl/⌘ + Shift + Z 撤销,重做
F 适应窗口
+ / - 放大 / 缩小
[ / ] 展开 / 收起左侧家具库、右侧面板
Shift + F 全屏
Esc 取消当前操作
漫游:WASD / 方向键,Shift,E 移动,快走,开关门

技术栈

自定义户型

户型数据写在 index.html 里:

改这些数据就能换成自己的户型。

floorplan-3d (wy51ai/floorplan-3d)

Searching Database…

这是什么?一个纯前端的户型平面图和室内设计工具:你可以在 2D 平面图上摆放家具、拆除或添加墙体、测量尺寸,然后切换到 Three.js 3D 场景进行鸟瞰或第一人称漫游。
这是需要安装的 Web 应用,还是打开就能用的文件?它是一个零构建步骤的单一静态 HTML 文件——整个应用就是「index.html」,用任何浏览器打开它就足以使用。
怎么把它跑起来?直接在浏览器中打开「index.html」;如果你不想用 file:// 协议,也可以用任意本地静态服务器托管这个文件夹。
修改代码需要框架或构建工具吗?不需要——它就是纯 HTML、CSS 和 JavaScript,没有框架也没有构建步骤;唯一的外部部分是通过 CDN 加载的 Three.js r160。
我能加载自己的户型图,还是只能用内置演示?没有面向任意户型的导入向导——你需要直接在「index.html」里编辑 ROOMS、WALLS/WINS、MATS 和 LIB 这些数据对象,换成自己的布局和家具。
它能完全离线运行吗?大部分可以——你的方案会自动保存到本地——但 Three.js 本身是从 jsDelivr CDN 获取的,所以首次打开 3D 场景时需要联网。
我的设计数据会去向哪里?只存在你自己的浏览器里——整个应用把状态保存在 localStorage 中,不涉及任何服务器。
素材库里有多少家具?超过 60 件,涵盖卧室、客厅、餐厅/厨房、卫浴、家电以及书房/休闲等类别,全部可以从左侧素材面板拖入。
我能导出或分享我的设计吗?可以——你可以把平面图导出为 PNG 图片,也可以把完整方案导出/导入为 JSON,在浏览器或机器之间迁移。
它支持中文以外的语言吗?支持,顶栏有一个中英文切换开关——默认为中文,并会记住你选择的语言。
第一人称漫游模式是什么样的?在桌面上用 WASD 加鼠标移动(触屏设备用虚拟摇杆),可以按 Shift 疾跑,探索时还可以点击门来打开或关闭。
Creator
wy51ai
Size
<0.1 MB
Stars
2.6K
Updated
CommitOct 02
Age
21d
Commits · 90 Days