Drawing validity: Difference between revisions
mNo edit summary |
|||
| (25 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
While [[editor|editing]] or running a [[Planning Session]] for a [[project]], it may be necessary to make a selection in the [[3D Visualization]]. In many cases, there are parts of the [[project map]] that are not valid for selection. For example, when making a selection for placing a [[building|building]], the building may not be placed in a location where a building already exists. Similarly, when making a selection to remove a part of a specific building, any part of the selection that does not actually select the building will be invalid. | |||
Selections may contain both valid and invalid parts. Only valid parts are used when performing an action or calculating associated costs; invalid parts are ignored. | |||
==Validity colors== | ==Validity colors== | ||
[[File: | [[File:brush_construction_validity.jpg|framed|right|A selection which is partially valid and invalid. Only the empty (transparent) parts are valid for selection, the rest of the area is greyish-blue. The green area is selected and valid. The red area is selected and invalid. Note that the bottom of the water is greyish-blue, meaning a selection on the water would be invalid.]] | ||
To indicate what areas would be valid or invalid for selection, and what parts of the selection are actually valid or invalid, colors are used. The meaning of the different colors are listed below. | To indicate what areas would be valid or invalid for selection, and what parts of the selection are actually valid or invalid, colors are used. The meaning of the different colors are listed below. | ||
===Natural colors=== | ===Natural colors=== | ||
This is | This is what the project looks like normally. This means this part of the 3D Visualization would be valid for selection. | ||
=== | ===Greyish-blue=== | ||
This is a part of the | This is a part of the project that is not valid for selection. This can be for a number of reasons. When creating a building, it could be that a building already exists in that location. When removing parts of a building, the selection is only valid when the building is selected. | ||
===Green=== | ===Green=== | ||
This part of the | This part of the project map has been selected, and is also a valid selection. When taking the action for which this selection is made, this part of the 3D Visualization will be affected. | ||
===Red=== | ===Red=== | ||
This part of the | This part of the project map has been selected, but is not a valid selection. When taking the action for which this selection is made, this part of the 3D Visualization will remain unaffected. Other effects of the selection, such as the calculation of a price for the action, are unaffected by invalid parts of the selection. That is to say the price of a building will not increase when an invalid selection is added to the current selection.<!-- | ||
===Yellow=== | ===Yellow=== | ||
This part of the | This part of the project map has been selected, and would be a valid selection. However, due to a non-spatial restriction, this selection is invalid. An example of such a restriction would be the budget of the stakeholder. If the budget is insufficient to pay for the action when the selection becomes larger, but the selection is made larger anyway, the parts of the selection that were added last are made yellow, and are considered invalid.--><br clear=all> | ||
==Exceptions== | ==Exceptions== | ||
Exceptions exist for when a selection is subject to validity. In these | Exceptions exist for when a selection is subject to validity. In these cases, an overlay will be used which is related to the property you are making a selection for. For example, when drawing [[zoning|zones]] in the editor, any place in the 3D Visualization can be selected to be made a part of a zone. The [[Zoning (Overlay)|zoning overlay]] will be made visible. The situation is similar for [[ownership]]. | ||
<includeonly><onlyinclude>Making a selection is subject to validity. For more information on validity, please see [[Drawing validity]].</onlyinclude></includeonly> | |||
< | {{article end | ||
|api= | |||
<div style="column-count:2"> | |||
* [[Api session event editor building add polygons]] | |||
* [[Api session event editor area add polygons]] | |||
* [[Api session event editor zoning add polygons]] | |||
* [[Api session event editor neighborhood add polygons]] | |||
* [[Api session event editor plot add polygons]] | |||
* [[Api session event editor terraintype add polygons]] | |||
* [[Api session event editor building remove polygons]] | |||
* [[Api session event editor area remove polygons]] | |||
* [[Api session event editor zoning remove polygons]] | |||
</div> | |||
}} | |||
Latest revision as of 14:06, 14 July 2026
While editing or running a Planning Session for a project, it may be necessary to make a selection in the 3D Visualization. In many cases, there are parts of the project map that are not valid for selection. For example, when making a selection for placing a building, the building may not be placed in a location where a building already exists. Similarly, when making a selection to remove a part of a specific building, any part of the selection that does not actually select the building will be invalid.
Selections may contain both valid and invalid parts. Only valid parts are used when performing an action or calculating associated costs; invalid parts are ignored.
Validity colors
To indicate what areas would be valid or invalid for selection, and what parts of the selection are actually valid or invalid, colors are used. The meaning of the different colors are listed below.
Natural colors
This is what the project looks like normally. This means this part of the 3D Visualization would be valid for selection.
Greyish-blue
This is a part of the project that is not valid for selection. This can be for a number of reasons. When creating a building, it could be that a building already exists in that location. When removing parts of a building, the selection is only valid when the building is selected.
Green
This part of the project map has been selected, and is also a valid selection. When taking the action for which this selection is made, this part of the 3D Visualization will be affected.
Red
This part of the project map has been selected, but is not a valid selection. When taking the action for which this selection is made, this part of the 3D Visualization will remain unaffected. Other effects of the selection, such as the calculation of a price for the action, are unaffected by invalid parts of the selection. That is to say the price of a building will not increase when an invalid selection is added to the current selection.
Exceptions
Exceptions exist for when a selection is subject to validity. In these cases, an overlay will be used which is related to the property you are making a selection for. For example, when drawing zones in the editor, any place in the 3D Visualization can be selected to be made a part of a zone. The zoning overlay will be made visible. The situation is similar for ownership.
API Endpoints
- Api session event editor building add polygons
- Api session event editor area add polygons
- Api session event editor zoning add polygons
- Api session event editor neighborhood add polygons
- Api session event editor plot add polygons
- Api session event editor terraintype add polygons
- Api session event editor building remove polygons
- Api session event editor area remove polygons
- Api session event editor zoning remove polygons