# Magiz_SketchUpExtension

**Repository Path**: zhou_shi_hu/Magiz_SketchUpExtension

## Basic Information

- **Project Name**: Magiz_SketchUpExtension
- **Description**: SketchUp插件，用于处理大量体块的建筑造型，可定义，可拓展。
- **Primary Language**: Ruby
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 39
- **Forks**: 4
- **Created**: 2020-02-29
- **Last Updated**: 2025-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Magiz v0.4.3 开源版本（已停止更新）

![banner](Magiz_Demo.gif)

## 导致 SU 闪退 ？

Sketchup 2024 以及之后的版本似乎不支持它们自己的老的加密方式了，安装从 Extension Warehouse 下载的 Magiz 插件 (v.0.4.0) 会导致 SU 崩溃。

这还真不是我的问题。上传 Sketchup 官方插件库，首选会进行代码审查，然后官方帮你将 rb 格式的源码加密成 rbs 格式，再在官网发布。这套流程在 SU2023 以前是没问题的，但从 24 版开始会导致 SU 崩溃，而我没法修正。

### 解决方案

出现问题的朋友，请先手动删除已安装的插件。插件文件位于`C:\Users\Administrator\AppData\Roaming\SketchUp\SketchUp 2024\SketchUp\Plugins\`，其中 Administrator 是你的 windows 账户名称，SketchUp 2024 对应了安装插件的 SU 版本，按您的实际情况修改。进入文件夹，删除 Zhouxi_Magiz.rb 和 Zhouxi_Magiz 文件夹，SU 就能正常启动了。

然后再下载安装 [v.0.4.3](https://gitee.com/zhou_shi_hu/Magiz_SketchUpExtension/releases/tag/v.0.4.3)，实测 SU 2025 可用。

### 了解一下新版本以及更多插件？

[www.architech.fun](http://www.architech.fun/)

---

## 更新一览

v0.4.3 `2025-04-24`

> 针对导致 SU24/25 崩溃的问题进行说明
>
> 整合了捐赠才送的样式 PTN_V1.mgz
>
> 删除了弹窗

v0.4.2 `2020-04-24`

> 修复管理器完全失效的 BUG
>
> 增加了三种可以调用的材质名称。NIL 为无材质，TSP 为透明材质，RND 为 50%概率生成体块的材质
>
> 优化弹窗，点击可以直接前往 Gitee

v0.4.1 `2020-04-05`

> 修复管理器的 css 文件不再外部引入

v0.4.0 `2020-03-04`

> 重写了全部代码，将样式相关数据统一打包成文件存储和载入，激动到失眠

v0.3.0 `2020-02-20`

> 一些已被遗忘的代码优化调整

v0.2.0 `2020-02-13`

> 全新的 UI 界面，可以指定样式进行变幻
>
> 重写了全部代码，支持在群组内进行变幻
>
> 可以对组件进行变幻，增加了三种住宅的设计，通过材质名称加入“R2”进行标记
>
> 增加了一种仅进行体块组合，不绘制细节的精简变幻模式
>
> 为了方便 Indexz 统计指标，变幻时可以保留外部材质，重置体块时可以恢复

v0.1.0 `2019-11-19`

> 第一个版本！

---

## 开源版本使用说明

SketchUp 插件，用于处理大量体块的建筑造型，可定义，可拓展。
[演示](https://gitee.com/zhou_shi_hu/Magiz/blob/master/Magiz_Demo.gif) / [实际项目录屏](https://www.bilibili.com/video/BV1PE41137Q2/) / [常见问题](https://gitee.com/zhou_shi_hu/Magiz/blob/master/常见问题.md) / [更新日志](https://gitee.com/zhou_shi_hu/Magiz/blob/master/CHANGELOG.md)

### 基本操作

![任务栏图标](https://images.gitee.com/uploads/images/2020/0229/140445_1b70bdf7_5749239.png 'ToolBar.png')

1.  选中一个或多个群组或组件
2.  通过任务栏图标进行操作，四个按钮从左至右分别代表：有细节的变形、无细节的变形、重置体块、样式选择器
3.  样式选择器关闭时，变形均为随机变形。打开样式选择器并选中一个样式以后，变形均为按指定样式变形

### 注意事项

对位于群组内的群组（或组件）进行变换， **需要保证外部群组没有拉伸变形** ，否则其内部的群组（或组件）变形会发生异常。

### 运行机制

随机变形会根据是否是群组，是否超过 24m，在四种类型下进行随机样式选择

|                  | h<24m                   | h>24m                 |
| ---------------- | ----------------------- | --------------------- |
| 群组 - Group     | 多层公建 - TierBuilding | 高层公建 - Skyscraper |
| 组件 - Component | 多层住宅 - Villa        | 高层住宅 - Apartment  |

### 自定义样式

样式可以通过编辑 Patterns 文件夹中的 mgz 文件进行自定义和拓展
加入文件夹中的每个 mgz 文件在 SketchUp 启动时会自动载入样式管理器
mgz 文件为 Json 格式。文件结构说明以及创建和编辑教程参见[ **WIKI** ](https://gitee.com/zhou_shi_hu/Magiz/wikis/)
[**PTN_Editor**](https://gitee.com/zhou_shi_hu/Magiz_Patterns/blob/master/Magiz_PTN_Editor.rb) 已更新！请查看 [**演示视频**](https://www.bilibili.com/video/BV1Ee411x7wb/)

`Patterns文件夹一般位于：`
`C:\Users\Administrator\AppData\Roaming\SketchUp\SketchUp 2018\SketchUp\Plugins\Zhouxi_Magiz\`

### 安装教程

1.  从发行版下载最新的 [v.0.4.3](https://gitee.com/zhou_shi_hu/Magiz/releases) 文件
2.  SketchUp2017 版本及以上，窗口(Window) ---> 插件管理器(Extension Manager) ---> 安装

#### 版权声明

对软件的任何修改和商业使用需要保持开源，声明修改的内容，并保留此开源协议和版权声明副本

[GNU General Public License v3.0](https://gitee.com/zhou_shi_hu/Magiz/blob/master/LICENSE)
Copyright © 2019-2020 周曦