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-плане, а затем переключаетесь в 3D-сцену Three.js для взгляда с высоты птичьего полёта или прогулки от первого лица.
Это веб-приложение, которое я устанавливаю, или просто файл, который я открываю?Это один статический HTML-файл без этапов сборки — всё приложение это «index.html», так что достаточно открыть его в любом браузере.
Как его запустить?Откройте «index.html» прямо в браузере либо раздайте папку любым локальным статическим сервером, если не хотите использовать протокол file://.
Нужен ли фреймворк или инструменты сборки для работы с кодом?Нет — это чистые HTML, CSS и JavaScript без фреймворков и этапа сборки; единственная внешняя часть — Three.js r160, загружаемый через CDN.
Можно ли загрузить свою планировку или только встроенное демо?Мастера импорта для произвольных форм дома нет — настройка делается правкой объектов данных ROOMS, WALLS/WINS, MATS и LIB прямо внутри «index.html», чтобы подставить собственную планировку и мебель.
Он полностью работает офлайн?Почти — ваш план автосохраняется локально, — но сам Three.js подгружается с CDN jsDelivr, так что при первом открытии 3D-сцены понадобится интернет.
Куда попадают данные моего проекта?Никуда, кроме вашего собственного браузера — всё приложение хранит своё состояние в localStorage, без участия сервера.
Сколько мебели включает библиотека?Более 60 предметов по категориям: спальня, гостиная, столовая/кухня, ванная, техника и кабинет/отдых; всё перетаскивается из панели библиотеки слева.
Можно ли экспортировать свой дизайн или поделиться им?Да — план можно экспортировать как PNG-изображение либо экспортировать/импортировать целиком в JSON, чтобы переносить между браузерами или машинами.
Поддерживает ли он языки, кроме китайского?Да, в верхней панели есть переключатель китайский/английский — по умолчанию стоит китайский, а выбранный язык запоминается.
Как выглядит режим прогулки от первого лица?На десктопе вы перемещаетесь с WASD и мышью (на сенсорных устройствах — виртуальный джойстик), можете ускоряться с Shift и кликать по дверям, открывая или закрывая их во время прогулки.
Creator
wy51ai
Size
<0.1 MB
Stars
2.4K
Updated
CommitOct 02
Age
19d
Commits · 90 Days