# How to use City Generator? The entry of City Generator feature is integrated in the drop-down menu of the ‘Terrain’ button in the navigation bar. It supports two ways to fetch city data information.
## 1. D5 Render 3.0-City Feature Overview The city module in D5 Render 3.0 is designed to quickly and efficiently generate buildings and roads around your site, helping you plot swiftly during the analysis and effect drawing stages of the project. This includes two main modes: White mode and Architectural Style mode.
White ModeArchitectural Style Mode
* Whether it is in the white model mode or architectural style mode, we support the following operations. * **Proportional adjustment** of the overall height of the building group * Adjustment of individual building height * **Proportional adjustment** of the overall width of the road group * Adjustment of single road width * In the white model mode, we also support the following operations. * Adjustment of the overall color, map, and opacity of the building group * Adjustments to the overall color, map, and opacity of the road Group * In the architectural style mode, we have three preset styles: **General, European,** and **Transparent Block.** To ensure your customization requirements are met, we have set adjustable parameters for building groups and individual buildings. * In General and European style * For the building group, you can randomly generate a new map for the whole building group by adjusting the random map. The Random Texture option enables the generation of new textures for the entire building group. Additionally, the commercial slider adjusts the degree of modernity of the external facades. * For a single building, you can adjust the elevation map and roof style of that building, and you can copy the elevation map you like to another building. * In Transparent Block Style * For building groups, you can adjust the color and opacity of transparent blocks. * For a single building, you can adjust the first floor height and the standard floor height to control the vertical positioning of floors within the transparent block. *** ## 2. D5 Render 3.0-Detailed Description of City Feature ### 2.1 Select the city area you want to generate #### 2.1.1 Select the city area you want to generate in two ways. {% hint style="info" %} You can enlarge the window by dragging the right and lower sides of the window. In subsequent updates, we will also support the dragging method to enlarge the window. {% endhint %}
Use default map controlsUse your own shp file
#### 2.1.2 Enter a city name to lock the city area you want to generate. Using the following image as an example, we will provide locations based on the name you entered. **Click the location in the drop-down menu** to jump to this area.
#### 2.1.3 Select the generated content of the selection area. By default, building, road, greenery, and water will be downloaded. To include satellite maps, please select the satellite option.
#### 2.1.4 Generation Time The generation speed depends on the size of the selected area. For example, processing a 4 km by 4 km area typically requires up to five minutes. Please wait patiently. ### 2.2 City Level The imported cities are organized into three hierarchical levels: City, Buildings/Roads/Greenery/Water/Satellite/Ground, and individual buildings or roads. Each level allows for the adjustment of specific parameters. The following sections provide a detailed introduction to the two modes: the white model mode and architectural style mode. | City | Buildings/Roads | Individual building/road | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

|

|

| |
|
|
| | |
|
| ### 2.3 White Model Mode {% hint style="warning" %} Note: When you select the entire building group, the height value in the right-hand sidebar is a proportional value. For example, if you set it to 50, the height of all buildings in the group will become 50% of their default height. The same applies to roads. {% endhint %}
#### 2.3.1 Switch Between White Model Mode and Architectural Style Mode The **Style** switch in the right sidebar can be activated when a building group is selected to apply style materials to the entire group. Alternatively, style materials can be assigned to individual buildings when a single building is selected. | Apply materials to the building group as a whole | Apply materials to a single building | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |
|
| |
|
| ### 2.4 Architectural Style Mode #### 2.4.1 Select the button located at the edge of the style list for additional adjustable parameters. When you select an entire building group, you can apply random textures to change the texture style throughout the city on a large scale.
#### 2.4.2 Control of individual architectural styles When you select an individual building, you retain control over its style. {% hint style="warning" %} Note: All buildings with office properties will not change significantly when switching between General and European. {% endhint %} | General | European | Transparent Block | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |
|
|
| #### 2.4.3 Adjustment to the material of individual building facades You can adjust the building facade both **randomly** and by **adjusting the current building properties**. | Random | Adjust the current building properties | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

Random Style 1

|

Residential

| |

Random Style 2

|

Residential

| You can copy the material of the current building to another building. | Before copying | After copying | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |
|
| #### 2.4.4 Adjustments to the roof material of individual buildings Click this button in the image below to adjust the roof style of the building
We provide you with three default roof styles, namely: flat roof, green roof and stairwell. Take the building below as an example to see the effect of different styles. {% hint style="warning" %} Please note the two points below: 1\. If the roof generated by default is already a stairwell roof, selecting the stairwell option again will not alter the visual display in any way. The same applies to flat roofs. 2\. Whenever you depart from the default roof and select any of the aforementioned roof types, the flat roof option will be automatically selected. {% endhint %}
| Flat Roof | Green Roof | Roof with Stairwell | Mix | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |
|
|
|
| *** ## City Feature Guide I ### OSM Integration Integrates the open source data from OpenStreetMap to automatically analyze and generate roads, buildings, terrain, and other topography features, enabling effortless site context creation. > *Note:* > > *\*OSM (OpenStreetMap) file is a map data file based on the OpenStreetMap data. These files contain the topography information of roads, buildings, terrain, etc., and are widely used in map drawing and urban planning.* #### 1. OSM import * Click Terrain-City, then zoom in and out in the pop-up window to the desired range using the '+' & '-' controls or the mouse wheel. * Supports quick location of the target area by entering its name or moving the selection box. The area is restricted to **4km\*4km**. * Supports filtering and importing certain topography features such as buildings, roads, greenland, water, or satellite images. {% hint style="warning" %} **Note:** 1. For better performance and efficiency, it is recommended to choose a moderate area to prevent excessive processing time due to large areas. 2. This feature requires online access to OSM data. Please ensure a stable Internet connection for smooth download and analysis of OSM data. 3. Please enable the "FPS Booster for Complex Geometry" when flickers appear after importing the city model. {% endhint %}
#### 2. Parameter Editing After the import is complete, the map model will appear in the viewport, with its topography elements as a group within the object list.
**Building Group Settings** * Elevation (based on original heights)\&Random elevation * Base color\&Base color map * Opacity option * UV parameters(including Triplanar and UV Randomizer) * (Single building within group) Height **Road Group Settings** * Width * Base color\&Base color map * UV parameters(including Triplanar and UV Randomizer) **Water, Greenland Groups** * Base color\&Base color map * UV parameters(including Triplanar and UV Randomizer) **Satellite, Ground Groups** * Base color\&Base color map
#### 3. Delete/replace City group * Right-click it from the object list to delete the whole city group * Select the city group from the object list, and click 'Reselect' icon in the right sidebar. Select area in the pop-up window to **recreate**.
### Shapefile(.shp) Import Supports Shapefile import for effortless site context creation. > *\*.shp file is ESRI Shapefile data format widely used in geographic information systems (GIS). It typically contains vector data, such as points, lines, and polygons to represent geographic features including buildings, roads, rivers, and administrative divisions.* #### 1. .Shp Import * Click Terrain-City, and import .shp file in the pop-up window. Supports multi-selection and uploading single file up to **10 MB**. If the size is exceeded, a pop-up error will be reported. * D5 automatically analyzes the geographic information in the .shp file and generates corresponding 3D models. * Each imported file is stored as a group in the object list, containing three types of objects: "Buildings," "Roads," and "Undefined." Supports repositioning or rotating the entire group. {% hint style="warning" %} **Note:** 1. Shapefile usually contains several related files (e.g. .shp, .shx, .dbf, etc.), please select the main file (.shp) to import. 2. After selecting .shp file, the system will automatically identify and load other related files (such as .shx and .dbf) with the same base name in the same directory. Please ensure that all related files are complete and stored in the same directory for correct reading. 3. Currently supports parsing **polygon** and **polyline** data types, other data types may cause parsing failure. {% endhint %}
#### 2. Parameter Editing **Building and Undefined Group:** * Elevation (based on original heights)\&Random elevation * Base color\&Base color map * Opacity option * UV parameters(including Triplanar and UV Randomizer) * (Single building within group) Height **Road Group:** * Width * Base color\&Base color map * UV parameters(including Triplanar and UV Randomizer) {% hint style="info" %} **FAQs** 1. Hover over ‘’Fail’ to display the reason for the failure. 2. Possible causes and solutions for parsing failure: \- **Unsupported data type:** D5 currently supports polygon and polyline data. Other data formats might fail to be analyzed. \- **Shapefile content:** Ensure that all related files (such as .shx and .dbf) are complete and placed in the same directory. \- **Read\&Write permissions:** Ensure that the current Windows account has permissions to access, read, and write the current Shapefile file and its related files, especially if the file is stored on a network drive or shared folder. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.d5render.com/user-guide/tool/how-to-use-city-generator.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.