# 如何使用地形-城市功能？
D5城市功能目前支持地图控件导入以及.shp 文件直接导入，以快速生成对应地理环境， 帮助设计师大幅减轻配景搭建的工作量，并在项目真实的周边环境中推敲方案。
# 1\. 城市功能概况
城市模块旨在为您快速高效地生成场地周边的建筑和道路情况，帮助您在项目前期的分析和效果图阶段快速出图。因此我们为您提供了两种主要模式。
白模模式 VS 建筑风格模式
* 不管是在白模还是建筑风格的状态下我们都将支持您的以下操作
* 建筑组整体高度的 **按比例** 调整
* 单个建筑高度的调整
* 道路组整体宽度的 **按比例** 调整
* 单条道路宽度的调整
* 在白模模式下，我们还支持您进行
* 建筑组整体颜色、贴图、不透明度的调整
* 道路组整体颜色、贴图、不透明度的调整
* 在建筑风格模式下，我们为您预设了 **通用，欧洲，透明体块** 三种不同风格。同时为了确保您的自定义需求，我们针对建筑组和单个建筑都设置了可调参数
* 在通用和欧洲风格中
* 针对建筑组您可以通过调整随机贴图为整个建筑组随机生成新的贴图，同时可以通过商业氛围控制其中现代风格外立面的比例
* 针对单个建筑，您可以调整该建筑的立面贴图和屋顶样式，同时您可以将心仪的立面贴图复制到别的建筑上
* 在透明体块风格中
* 针对建筑组您可以调整透明体块的颜色和不透明度
* 针对单个建筑，您可以深入调节首层高度和标准层高度来控制透明体块中楼板的位置
---
# 2\. 城市功能详细说明
## 2.1选择您要生成城市的区域
### 2.1.1您有两种方式选择您想要生成的城市区域
您可以通过拖拽对话框的右侧和下侧放大窗口，在后续的更新中我们也将支持通过对角线拖拽的方式放大窗口。
1. **使用我们自带的地图控件**
地图控件窗口
2. **使用您自己的 shp 文件**
导入 shp 文件界面
### 2.1.2输入地名锁定您想生成的城市区域
以下图为例，我们会根据您输入的名称提供一些地点，您需要 **单击下拉菜单中的地点** 跳转到该区域。
### 2.1.3您可以对选择区域的生成内容进行选择
在默认状态下建筑，道路，卫星图我们将为您一次性下载。
### 2.1.4生成时间
生成的速度会根据您框选区域的大小相关，通常4km\*4km的范围最多需要5mins左右的时间，请您耐心等待。
## 2.2城市层级
如您所见，您所导入的城市最多有 **三个层级**，分别是** 城市**、** 建筑组/道路组/卫星图/地面**、** 单个建筑/单条道路**。当您选中不同层级时您可以对不同的参数进行调整，接下来，我们将在白模和建筑风格两个模式下进行详细介绍。** 城市**
* 城市导入的默认状态会选择整个城市
* 左侧边栏单击城市同样可以选择整个城市
建筑组/道路组
* 单击任一建筑您会择选整个建筑组
* 单击任一道路您会选择整个道路组
* 建筑组和道路组同样可以通过左侧边栏单击选择
单个建筑/单条道路
* 双击任一建筑，您会选择当前建筑
* 双击任一道路，您会选择当前道路
* 单个建筑和单条道路同样可以通过左侧边栏单击选择
* 道路与道路组支持风格效果器，提供默认风格并可编辑贴图，自定义道路外观
* 支持交叉路口等道路类型
* 支持编辑道路控制点，灵活调整道路走向与形态
### 编辑与管理
* 批量选择的建筑或道路可通过右键菜单转换为独立组或分离组，便于独立调整
## 2.3白模模式
::: warning 注意
当您选择到整个建筑组时，右侧边栏的高度是一个 **比例值**，即当您将其调整为50，建筑组中所有的建筑高度都会变成该建筑默认高度的50%，道路同理。
:::
### 2.3.1白模模式和建筑风格模式的切换
您可以在选中建筑组时打开右侧边栏的风格开关对整个建筑组赋予风格材质，也可以在选中单个建筑时对单个建筑赋予风格材质。 **为建筑组整体赋予材质：**
开启“风格”开关--->可切换不同风格的材质
**为单个建筑赋予材质：**
选中单个建筑，开启“风格”开关--->可切换不同风格的材质
## 2.4建筑风格模式
### 2.4.1风格列表边上的按钮展开更多可调参数
在选中整个建筑组时，您可以随机贴图来大范围切换整个城市的贴图样式
### 2.4.2对单个建筑风格的控制
当您选择了单个建筑的时候您依旧可以对它的风格样式进行控制。
::: warning 注意
注意，所有属性为 **办公** 的建筑在切换通用和欧洲时不会有非常明显的变化。
:::
通用
欧洲
透明体块
### 2.4.3对单个建筑立面材质的调整
您可以通过 **随机** 和 **调整当前建筑属性** 两种方式对建筑立面进行调整 **随机：**
随机样式一
随机样式二
办公
住宅
您可以通过复制将当前建筑的材质赋予别的建筑
复制前 → 复制后
### 2.4.4对单个建筑屋顶材质的调整
单击下图中的这个按钮对建筑的 **屋顶样式** 进行调整
我们为您提供了三种屋顶样式的预设，分别是，平屋顶，草坪屋顶和楼梯间。以该建筑为例为您说明不同样式的效果。
>**在这里，有两点您需要特别注意**
>
> 1. 如果您默认生成的屋顶已经是楼梯间屋顶，此时您再次选择楼梯间则在显示效果上不会有任何变化，平屋顶同理。
> 2. 只要您离开默认屋顶，选择上述任意一种屋顶，平屋顶都会默认被勾选。
>
平屋顶
草坪屋顶
楼梯间
草坪+楼梯间
## Shapefile 格式文件导入说明
> 1\. .shp 文件是 ESRI Shapefile 格式，一种广泛用于地理信息系统（GIS）的数据格式。
> 它通常包含矢量数据，如点、线和多边形，用于表示地理特征，例如建筑物、道路、河流和行政区划等。
> 2\. 可从GIS平台（如OpenStreetMap、ArcGIS Online）下载所需的Shapefile文件，或使用GIS软件（如QGIS、ArcGIS）创建自定义的Shapefile文件。
### 导入.shp
1. 主界面顶部菜单栏-地形按钮新增下拉菜单，新增“城市”选项。点击后在弹出的窗口中可以选择.shp文件导入（支持多选），上传的单个文件最大为10MB；
2. 选择文件导入后，D5渲染器将自动解析.shp文件中的地理信息，并根据数据生成相应的三维模型或地形元素；
3. 导入的每个文件作为一组，分为建筑、道路和其他三种类型存储在场景资源列表中，支持整组移动、旋转。
> 1\. Shapefile 通常包含多个相关文件（例如：.shp, .shx, .dbf 等），请选择主文件（.shp）进行导入；
> 2\. 选择 .shp 文件后，系统会自动识别并加载同一目录下具有相同基础名称的其他相关文件（如 .shx 和 .dbf），请确保所有相关文件完整无缺，并存放在同一目录中以保证正确读取;
> 3\. 目前支持解析 polygon 和 polyline 两种数据类型，其他数据类型可能导致解析失败.
加载超过10M的.shp文件，会提示相关报错
Shapefile文件内容
导入.shp文件
### 参数编辑
#### 1\. 建筑组与其他组
* 高度（组内整体按比例调整）&随机高度
* 材质基础色&基础色贴图
* 建筑不透明度开关
* UV调整参数（包含三向映射修复、随机UV）
* （选中组内建筑单体）高度
#### 2\. 道路组
* 宽度
* 材质基础色&基础色贴图
* UV调整参数（包含三向映射修复、随机UV）
## 常见问题
### 1\. 导入.shp文件后，显示解析失败？
1. 鼠标悬停在“解析失败”上，可显示失败原因。
2. 当前已知的解析失败的原因：
\- **不支持的数据类型**：目前支持解析的数据类型polygon和polyline（其他数据类型可能导致解析失败）。
\-**Shapefile文件内容**：确保所有相关文件（如 .shp、.shx、.dbf 等）齐全并放在同一目录下。
\-**读写权限** ：确保当前 Windows 账号有权限 访问、读取和写入当前的Shapefile 文件及其相关文件，特别是文件存储于网络驱动器或共享文件夹时。