建筑的定制材质和参数

• Example of creating a Building object示例：创建Building对象
• Filter parameters description过滤器参数的说明。
• The Procedural Generation Assets add-on containing ready-to-use materials and textures to customize buildingsProcedural Generation Assets 附加组件包含用于自定义建筑的即用型材质和纹理

UNIGINE provides a set of built-in materials for generated buildings: they are inherited from mesh_base and named according to the rules. You can also create your custom textures and set up materials. However, your textures should meet a set of requirements described below.UNIGINE 为生成的建筑物提供了一组内置材质：它们继承自 mesh_base 并根据 命名 规则。 您还可以创建自定义纹理并设置材质。 但是，您的纹理应该满足下面描述的一组要求。

Four types of textures should be prepared for a building: a texture for the basement, a texture for the wall with windows (and sometimes doors), a texture for the solid wall, and a texture for the roof. The UV map of each part of the building depends on the size of the wall segment that is shown on the texture.应该为建筑物准备四种类型的纹理：地下室的纹理、带有窗户（有时还有门）的墙壁的纹理、实心墙的纹理和屋顶的纹理。 每个 建筑物部分 的 UV 贴图取决于纹理上显示的墙段的大小。

注意

Textures for walls differ depending on the part of the building they are applied to: if a texture is applied to Basement, it should depict Basement and Underground Basement.墙壁的纹理根据它们应用于建筑物的部分而有所不同：如果将纹理应用于 Basement，它应该描绘 Basement 和 Underground Basement。

• For Underground Basement and Basement, a single texture for a wall is applied. The texture height corresponds to the height of all these parts (in sum), and the texture is stretched vertically to fit this part of the building.Underground Basement和Basement单一结构墙。结构高度对应的高度(总之)，所有这些部分和纹理是垂直延伸到建筑的这部分。

  

  Texture for Underground Basement and Basement质地为Underground Basement和Basement

• For the Ground Floor, an individual texture is applied. The texture height is applied to the building using the Row Size value as the floor height.对于Ground Floor，应用了单独的纹理。 使用 Row Size 值作为楼层高度将纹理高度应用于建筑物。

  Texture with windows for Ground FloorGround Floor的窗户纹理	Solid texture for Ground FloorGround Floor的实心纹理

• For Upper Floors, a single texture for a wall with windows is applied.对于Upper Floors，一个带有窗户的墙的单一纹理被应用。

  Texture with windows for Upper FloorsUpper Floors的窗户纹理	Solid texture for Upper FloorsUpper Floors的实心纹理

  There are two parameters — Rows per Texture and Columns per Texture — that form a grid for this texture.有两个参数Rows per Texture 和 Columns per Texture，它们形成了这个纹理的网格。

  

  The texture for the upper floors with windows is applied wherever possible along the wall from the first floor upward and from the center to the building corners horizontally and is cut according to these imaginary grid lines, creating one surface. Edges are tiled using the solid texture and form another surface.带窗户的上层的纹理尽可能地沿着墙壁从一层向上，从中心水平到建筑角落，并根据这些想象的网格线切割，创建一个表面。边缘使用固体纹理平铺，形成另一个表面。

• For Roof, two textures should be applied — for the roof and the ridges. Ridges are used to cover the connection of two roof planes.对于Roof，应该应用两种纹理——屋顶和山脊。脊线用于覆盖两个屋顶平面的连接处。

  Roof texture屋顶纹理
  Ridges texture山脊纹理

  The roof material can be used as is or change the color based on the imagery data. Enabling the corresponding option allows multiplying the material albedo by the color taken from the imagery data.屋顶材质可以按原样使用，也可以根据图像数据更改颜色。 启用 相应的选项 允许将材质反照率乘以从照片数据中获取的颜色。

注意

Each material should be inherited from mesh_base.每个材质都应该从mesh_base继承。

For materials to be correctly applied by Sandworm to the generated buildings, follow these rules:为了将材质正确应用到Sandworm生成的建筑中，请遵循以下规则：

• Define a prefix that a group of materials applied to walls (basement, ground floor, and upper floors) will use.定义一个前缀，一群材质应用于墙(地下室，一楼，楼上)将使用。

  You can use the source data material value as the prefix of the material. In this case, the material will be applied automatically to all buildings that have this value assigned.您可以使用源数据材质作为前缀的材质的价值。在这种情况下，材质将自动适用于所有建筑，这个值分配。

  Roof materials also can use a key value of source data as a prefix. In this case, the material will be applied automatically to all roofs that have this value assigned.屋顶材质也可以使用一个键值的源数据作为前缀。在这种情况下，材质将自动适用于所有屋顶，这个值分配。

  If your source data don't have material details, you can choose an arbitrary name.如果您的源数据没有材质的细节，您可以选择一个任意的名称。

• Materials should use the following name postfixes:材质应使用以下名称后缀：

  • *_basement_sw — material for Basement and Underground Basement, a mandatory material which is an anchor for other building materials, except roofs.*_basement_sw 地下室和地下地下室的材质，一个强制性的材质锚为其他建筑材质，除了屋顶。
  • *_ground_sw — material for the Ground Floor wall without doors and windows*_ground_sw Ground Floor墙没有门窗的材质
  • *_ground_windows_sw — material for the Ground Floor wall with doors and windows*_ground_windows_sw Ground Floor墙和门窗的材质
  • *_upper_sw — materials for the Upper Floors wall with doors and windows*_upper_sw Upper Floors墙和门窗的材质
  • *_upper_windows_sw — materials for the Upper Floors wall without doors and windows*_upper_windows_sw Upper Floors墙没有门窗的材质
  • *_ridge_face_sw — materials for the top part of the upper wall to be applied right below the roof. This type of material is used with flat roofs only.*_ridge_face_sw 上壁的顶部的材质将在屋顶下方使用。 这种类型的材质仅与平坦的屋顶 一起使用。
  • *_roof_sw — material for Roof*_roof_sw 屋顶材质
  • *_ridges_sw — material for the Roof ridges connecting the roof sections*_ridges_sw 连接屋顶部分的脊线材质

The basic set of building materials is available in the /core/materials/buildings/ folder. 基本的建筑材质可在/core/materials/buildings/文件夹。

Naming Example命名的例子#

Let's assume we have an area with buildings, which can be made of bricks or wood. If we use OSM data with their specific naming, we should use the following prefixes for building materials:假设我们有一个有建筑物的区域，它可以由砖块或木头制成。如果我们使用具有 特定命名 的 OSM 数据，我们应该为建筑材质使用以下前缀：

建筑	OSM 价值	材质名称
made of bricks砖做的	brick	brick_basement_sw.mat brick_ground_sw.mat brick_ground_windows_sw.mat brick_upper_sw.mat brick_upper_windows_sw.mat brick_ridge_face_sw.mat
made of wood用木头做的	wood	wood_basement_sw.mat wood_ground_sw.mat wood_ground_windows_sw.mat wood_upper_sw.mat wood_upper_windows_sw.mat wood_ridge_face_sw.mat

Then, the roofs of these buildings can be covered with tiles, metal, or concrete. According to the OSM roof material naming, we should name the roof materials as follows:然后，这些建筑物的屋顶可以用瓷砖、金属或混凝土覆盖。 根据 OSM 屋顶材质命名，我们应该将屋顶材质命名为：

屋顶	OSM 价值	材质名称
covered with tiles覆盖着瓷砖	roof_tiles	roof_tiles_roof_sw.mat roof_tiles_ridges_sw.mat
covered with metal覆盖着金属	metal	metal_roof_sw.mat metal_ridges_sw.mat
covered with concrete混凝土覆盖	concrete	concrete_roof_sw.mat concrete_ridges_sw.mat