Brush: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
No edit summary
 
(98 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{being updated}}
The brush is a tool in the [[editor]], which allows you to make a 2 dimensional selection in the [[3D Visualization]] of your [[project]] for a specific selected [[Item]]. Once satisfied with the selection, it has to be applied to add it to, or remove it from, the current 2 dimensional geometry of the selected item. While drawing a selection, feedback is given in form of colors, which are explained in the selection legend.
{{Learned|what the brush is|how the brush is implemented in the Tygron Engine|how to use the brush|how the different options of the brush function}}


==The brush==
<youtube>wx2GAfITjYc</youtube>
The brush is a tool in the [[editor]], which allows you to select an area in the [[3D World]], specifically within the [[project detail area]]. By correctly using the brush, it is possible to intricately draw a variety of components or properties in the Tygron Engine, such as [[constructions]] and [[ownership]].


==How is the brush implemented in the Tygron Engine==
==Brush Panel==
[[File:construction18.jpg|framed|left|The Brush panel]]The brush is not directly available in the editor. Instead, it appears when it is required while using the editor. Its effects and abilities are directly related to the type of component you are using the brush for.<br clear=all>
[[File:brush-bottom.png|framed|left|The Brush panel]]The brush panel is not directly visible in the editor. Instead, it appears when it is required while using the editor, for example when clicking on the "Draw Area" button in the [[editor]] detail panel of a [[Building]]. The brush options that are available for configuration depend on the type of [[Item]], or component of an Item, you are using the brush for.
{{clear}}
 
==Brush options==
The brush panel offers a number of options, which will allow you to accurately draw a selection in the 3D visualization.
<br clear=all>
====Selection Type====
[[File:Brush-bottom-type.png|frame|right|The type of brush used for drawing.]]
: ''The type of selection you wish to make. This influences the shapes you draw in the 3D visualization. By using the right selection type, it is possible to make intricate selections, exactly reflecting your intentions.''<br clear=right>
 
====Size====
[[File:Brush-bottom-size.png|frame|right|The size for drawing.]]
: ''The size of the selection you are drawing. Depending the current selection type, the size will influence how large your selection will be. A higher size allows you to draw greater selections more quickly, while a smaller size allows you to make your selection more detailed. For some selection types, such as Ellipse and Poly, the size is used for removing previous selected points.''{{clear|right}}
 
====Operator====
[[File:Brush-bottom-operator.png|frame|right|The operation to perform.]]
: ''The operation you wish to perform with your selection. Depending on what you are currently drawing a selection for, you may have the option to append to the existing spatial element, or to remove from it. For example, you can add to or remove from a building, but you cannot remove ownership, only overwrite it. By setting the operator to "Add", the selection (when applied) will be added to the spatial element. By setting it to "Remove", the selection (when applied) will be subtracted from the spatial element.''{{clear|right}}
 
====Options====
[[File:Brush-bottom-options.png|frame|right|The miscellaneous options.]]
: ''The options offer ways to make drawing easier. The currently available option is "Hide buildings", which will remove building from view. This allows you to draw your selection on the 3D visualization without obstructions.''{{clear|right}}


==How to use the brush==
==How to use the brush==
The brush panel will appear automatically when you need to draw in the 3D world. Depending on what you wish to draw, the brush will have several options available.
[[File:Draw_selection_animation.gif|300px|right|Drawing a block selection.]]
{{Editor steps|title=draw with the brush|Select the [[#Drawing modes|drawing mode]] you wish to use.|If you wish to [[#Removing|remove]] something, set "Remove" to "On".|In the game area, click and hold down the left mouse button in a single location.|While holding down the left mouse button, drag the cursor to another location in the game area.|Release the mouse button to finish the selection.|Press "[[#Applying|Apply selection]]".}}
The brush panel will appear automatically when you need to draw in the [[3D Visualization]]. Depending on what you wish to draw, the brush will have several options available.
{{Editor steps|title=draw with the brush|Select the [[#Drawing modes|drawing mode]] you wish to use.|If you wish to [[#Removing|remove]] something, set "Remove" to "On".|In the [[3D Visualization]], click the left mouse button on a location to start the selection.|Move your mouse to a new location in the 3D Visualization.|Click again with the left mouse button to progress or finalize the selection area.|Press "[[#Applying|Apply selection]]".}}
 
'''Important''': Holding your left mouse button allow you to move the [[Camera]]. Clicking the left mouse button, which is a press and immediate release of a button, progresses the selection of an area.


==Brush functions explained==
==Brush functions explained==
The brush panel will appear automatically when you need to draw in the 3D World. The Brush will automatically have certain options available or unavailable based on the specific thing you wish to draw. For example, if you wish to draw a road, you will only be able to do so in lines. If you wish to draw terrain, you do not have the option to remove the terrain, etc.
The brush panel will appear automatically when you need to draw in the 3D visualization. The Brush will automatically have certain options available or unavailable based on the specific thing you wish to draw. For example, if you wish to draw a road, you will only be able to do so in lines. If you wish to draw terrain, you do not have the option to remove the terrain, etc.


===Drawing===
===Drawing===
There are several ways to draw using the brush. Depending on what you are drawing, the following options may be available.
There are several ways to draw using the brush. Depending on what you are drawing, the following options may be available.
('''Note that in the following description, selections are created, but not yet applied. There will be no actual effect on the 3D world until the selection is applied later on.''')
('''Note that in the following description, selections are visualized on the client, but not yet applied to the project data. There will be no actual effect on the 3D visualization until the selection is explicitly applied.''')


====New Drawing Modes====
====Selection Types====
Several drawing modes exist to allow you to draw in the 3D world. The default mode modes depends on what you wish to draw. For example, when drawing a road, by default the brush will be set to "Line" mode.
Several selection types exist to allow you to draw in the 3D visualization. The default type depends on what you wish to draw. For example, when drawing a road, by default the brush will be set to "Line" mode.
=====Block=====
=====Block=====
[[File:Brush-block.jpg|100px|right]]
: ''Use this mode to draw rectangular areas consisting of square blocks. When moving the cursor in the 3D visualization, a grid will become visible. This grid will align with nearby spatial elements, such as roads, allowing the user to draw a selection parallel or perpendicular to things already present in the project. Click a first time with the left mouse button to start the selection of a rectangle. Move the mouse to expand the rectangle in the desired direction. Click a second time to add the created rectangle to the current selection. Adjusting the size in the brush panel will make the grid larger or smaller.''
: ''Use this mode to draw square or rectangular areas. When moving the cursor in the 3D world, a grid will become visible. This grid will align with nearby spatial elements, such as roads, allowing the user to draw a selection parallel or perpendicular to things already present in the world. Holding down the left mouse button will add the indicated cells of the grid to the selection. Adjusting the size in the brush panel will make the grid larger or smaller.''<br clear=all>
<gallery widths=100px heights=100px>
File:Brush-block-first.png| First click
File:Brush-block-second.png| Second click after cursor moved
</gallery>


=====Line=====
=====Line=====
[[File:Brush-line.jpg|100px|right]]
: ''The default drawing mode for roads. This mode allows you to draw rectangular areas based on a line between two selected points. Click a first time with the left mouse button in one part of the 3D visualization to start the selection. Move the mouse around in any direction and distance from the first clicked point to create the desired line. Click a second time to confirm the drawn rectangle. Adjusting the size in the brush panel will make the rectangle thicker or thinner.''
: ''The default drawing mode for roads. This mode allows you to draw straight lines. Holding down the left mouse button in one part of the 3D world and releasing it in another will draw a line as selection between the location where the mouse button was pressed and the mouse was released. Adjusting the size in the brush panel will make the line thicker or thinner.''<br clear=all>
<gallery widths=100px heights=100px>
File:Brush-line-first.png| First click
File:Brush-line-second.png| Second click after cursor moved
</gallery>
=====Poly=====
: ''Use this mode to create polygons. Click with the left mouse button in a part of the 3D visualization to start the selection. Move the cursor and consecutively click with the left mouse button to add more points. To remove a previous point, click on a blue point. Finalize the polygon by clicking on or near the first point indicated with a red color.''
<gallery widths=100px heights=100px>
File:Brush-poly-first.png| First click
File:Brush-poly-second.png| Second click after cursor moved
File:Brush-poly-third.png| Third click. Notice the blue point
File:Brush-poly-fourth.png| Fourth click
File:Brush-poly-fifth.png| Fifth click
File:Brush-poly-final.png| Final click near the red point.
</gallery>


=====Circle=====
=====Circle=====
[[File:Brush-circle.jpg|100px|right]]
: ''Use this mode to create circles. Holding down the left mouse button in one part of the 3D visualization and releasing it in another will create a circle-shaped selection, with the center where the mouse button was pressed. The radius of the circle is the distance between where the mouse button was pressed and where it was released.''
: ''Use this mode to create circles. Holding down the left mouse button in one part of the 3D world and releasing it in another will create a circle-shaped selection, with the center where the mouse button was pressed. The radius of the circle is the distance between where the mouse button was pressed and where it was released.''<br clear=all>
<gallery widths=100px heights=100px>
File:Brush-circle-first.png| First click
File:Brush-circle-second.png| Second click after cursor moved
</gallery>


=====Ellipse=====
=====Ellipse=====
[[File:Brush-ellipse.jpg|100px|right]]
: ''Use this mode to create ellipses based on a line segment and two distances to it, along and perpendicular. Click with the left mouse button in one part of the 3D visualization to place the first point. Move the cursor and click a second time to place the second point. This defines the line segment the ellipse will be based on. Move the cursor again away from the line segment to create an ellipse and click a third time to confirm.''
: ''Use this mode to create elipses, aligned with the cardinal directions of the map. Holding down the left mouse button in one part of the 3D world and releasing it in another will create an elipse-shaped selection, of which the east-west axis is equal to the distance the mouse has traveled east or west, and the north-south axis is equal to the distance the mouse has traveled north or south.''<br clear=all>
:''The line segment can also be reset by clicking near the blue point. Resetting the line 's original, indicated with the red point, is also possible by clicking near it, but only when the blue point is not present.''
=====Quad=====
<gallery widths=100px heights=100px>
[[File:Brush-quad.jpg|100px|right]]
File:Brush-ellipse-first.png| First click as red point
: ''Use this mode to create a parallelogram. Holding down the left mouse button in one part of the 3D world and moving it in a straight line defines the length and direction of two opposing sides of the shape. By continuing the hold down the left mouse button and moving the cursor at an angle to the first side, the length and direction of the other two sides are defined.''<br clear=all>
File:Brush-ellipse-second.png| Second click as blue point after cursor moved.
File:Brush-ellipse-move.png| Moving the mouse after the second click.
File:Brush-ellipse-third.png| Third click to confirm ellipse
</gallery>
 
=====Polygon pick=====
=====Polygon pick=====
[[File:Brush-polygon.jpg|100px|right]]
: ''Use this selection type to create selections based on existing visible items, such as building and terrain sections. Clicking on a section of a building in the 3D visualization will add the shape of that section to the selection.''
: ''Use this mode to create selections based on existing constructions. Clicking on a construction in the world will add the shape of that construction to the selection.''<br clear=all>
<gallery widths=100px heights=100px>
File:Brush-pick-first.png| First clicked section
File:Brush-pick-second.png| Second clicked section.
File:Brush-pick-third.png| Third clicked section.
File:Brush-pick-second2.png| Clicking second section again removes it.
File:Brush-pick-fourth.png| Fourth click on road.
</gallery>
 
=====Blueprint=====
: ''Use this selection type to create more detailed selections based on existing areas or geo-data files, such as [[GeoJSON]] and [[DXF]] files. Click From Area to select an area to apply its geometry to the current selection. Click on From Wizard to open the [[Geo Data Wizard]] and follow its step to obtain geometries and apply these to the current selection.''
<gallery widths=100px heights=100px>
File:Brush-blueprint-panel.png| Click ''From Area'' hyperlink.
File:Brush-blueprint-areas.png| Select ''Complex Area'' from selection panel.
File:Brush-blueprint-selection.png| Resulting selection based on area.
File:Brush-blueprint-wizard.png| Alternatively click ''From Wizard'' to open the [[Geo Data Wizard]].
</gallery>
 
=====Single=====
: ''This mode is automatically used when a point needs to be selected. Clicking anywhere in the 3D visualization will place the point there. Only a single point can be placed.''
<gallery widths=100px heights=100px>
File:Brush-single-click.png| First Click.
</gallery>
 
====Fine-tuning your selection====
While making a selection, if you wish to make a selection composed of multiples of the same shape (for example, a large rectangle with an adjacent square), you can draw these shapes consecutively. When you begin drawing the second shape, the first shape remains drawn as selection.
 
You may also wish to combine some of the available drawing modes to create a more complex shape. By switching between drawing modes, without applying or clearing your selection in between, it is possible to preserve a selection made with one drawing mode and add to it with another. For example, to create a square building with a rounded front, you can draw the rectangular area in block mode, switch to circle mode, and draw a circle overlapping the rectangle.
 
Besides adding to your selection, it is also possible to subtract. By starting to draw a new part of your selection in an unselected part of the 3D visualization, the newly drawn selection is added to the current selection. By starting to draw a new part of your selection in a part of the 3D visualization which is already selected, the new selection is actually subtracted from the existing selection. For example, to create a square selection with a concave circular front, you can first draw a square selection, and then draw a circle on the existing selection, making it subtract instead. (Please note that this is different from "{{inlink|Removing}}".)
 
<gallery mode="nolines">
File:Brush-combine.jpg|Combining selection types
File:Brush-subtract.jpg|Subtracting a selection
</gallery>


====Validity====
====Validity====
[[File:brush_construction_validity.jpg|framed|right|A partially invalid selection. Parts of the world are grey to indicate those areas cannot be validly selected. The selection made is green where it is valid, and red where it is not. The reasons for why parts of the selection are invalid are provided.]]
{{:Drawing_validity}}<!--transclusion, because this part is shared with interface-->
{{:Drawing_validity}}<!--transclusion, because this part is shared with interface-->
====Clearing a selection====
If you feel it necessary to remove your current selection entirely and draw anew, you can use the "Clear Selection" button. This removes the selection you have made from the world, without applying it.
<br clear=all>


===Applying===
===Applying===
When you have made a selection, you can click "Apply Selection". At this point, the selection is used to place the building, [[zoning|zone]], ownership or anything else you might have been drawing, in the 3D world.
[[File:Brush-bottom-apply.png|frameless|right]]
When you have made a selection, you can use the "Apply Selection" button. At this point, the selection is used to place the [[Building]], [[Zone]], [[Area]], ownership or anything else you might have been drawing, in the [[3D Visualization]].


===Removing===
===Removing===
[[File:brush_construction_validity_add.jpg|framed|right|Validity of a selection when adding a building.]]
The brush can often also be used to remove elements or properties from the 3D visualization. To do this, you can set the "Operator" setting to "Remove". You will notice your area for valid selections will be (partially) inverted. Places where you were unable to create a valid selection could now be valid, and places where you could make a valid selection will likely be invalid. This is because when you wish to remove something, you must be able to make a valid selection of it. While usually, when you wish to draw something, it cannot be placed again in the same place.
[[File:brush_construction_validity_remove.jpg|framed|right|Validity of a selection when removing the building.]]
<gallery mode="nolines">
File:brush_construction_validity_add.jpg|Validity of a selection when adding a building.
File:brush_construction_validity_remove.jpg|Validity of a selection when removing the building.
</gallery>
 
===Clearing a selection===
[[File:Brush-bottom-clear.png|frameless|right]]
If you feel it necessary to cancel your current selection entirely and draw anew, you can use the "Clear Selection" button. This undoes the selection you have made and will not be applied, thus having no effect.


The brush can often also be used to remove elements or properties from the game area. To do this, you can set the "Remove" setting to "On". You will notice your area for valid selections will probably be inverted. Places where you were unable to create a valid selection could now be valid, and places where you could make a valid selection will likely be invalid. This is because when you wish to remove something, you must be able to make a valid selection of it. While usually, when you wish to draw something, it cannot be placed again in the same place.
{{editor ui nav}}
<br clear=all>

Latest revision as of 09:55, 21 February 2024

The brush is a tool in the editor, which allows you to make a 2 dimensional selection in the 3D Visualization of your project for a specific selected Item. Once satisfied with the selection, it has to be applied to add it to, or remove it from, the current 2 dimensional geometry of the selected item. While drawing a selection, feedback is given in form of colors, which are explained in the selection legend.

Brush Panel

The Brush panel

The brush panel is not directly visible in the editor. Instead, it appears when it is required while using the editor, for example when clicking on the "Draw Area" button in the editor detail panel of a Building. The brush options that are available for configuration depend on the type of Item, or component of an Item, you are using the brush for.

Brush options

The brush panel offers a number of options, which will allow you to accurately draw a selection in the 3D visualization.

Selection Type

The type of brush used for drawing.
The type of selection you wish to make. This influences the shapes you draw in the 3D visualization. By using the right selection type, it is possible to make intricate selections, exactly reflecting your intentions.

Size

The size for drawing.
The size of the selection you are drawing. Depending the current selection type, the size will influence how large your selection will be. A higher size allows you to draw greater selections more quickly, while a smaller size allows you to make your selection more detailed. For some selection types, such as Ellipse and Poly, the size is used for removing previous selected points.

Operator

The operation to perform.
The operation you wish to perform with your selection. Depending on what you are currently drawing a selection for, you may have the option to append to the existing spatial element, or to remove from it. For example, you can add to or remove from a building, but you cannot remove ownership, only overwrite it. By setting the operator to "Add", the selection (when applied) will be added to the spatial element. By setting it to "Remove", the selection (when applied) will be subtracted from the spatial element.

Options

The miscellaneous options.
The options offer ways to make drawing easier. The currently available option is "Hide buildings", which will remove building from view. This allows you to draw your selection on the 3D visualization without obstructions.

How to use the brush

Drawing a block selection.

The brush panel will appear automatically when you need to draw in the 3D Visualization. Depending on what you wish to draw, the brush will have several options available.

How to draw with the brush:
  1. Select the drawing mode you wish to use.
  2. If you wish to remove something, set "Remove" to "On".
  3. In the 3D Visualization, click the left mouse button on a location to start the selection.
  4. Move your mouse to a new location in the 3D Visualization.
  5. Click again with the left mouse button to progress or finalize the selection area.
  6. Press "Apply selection".

Important: Holding your left mouse button allow you to move the Camera. Clicking the left mouse button, which is a press and immediate release of a button, progresses the selection of an area.

Brush functions explained

The brush panel will appear automatically when you need to draw in the 3D visualization. The Brush will automatically have certain options available or unavailable based on the specific thing you wish to draw. For example, if you wish to draw a road, you will only be able to do so in lines. If you wish to draw terrain, you do not have the option to remove the terrain, etc.

Drawing

There are several ways to draw using the brush. Depending on what you are drawing, the following options may be available. (Note that in the following description, selections are visualized on the client, but not yet applied to the project data. There will be no actual effect on the 3D visualization until the selection is explicitly applied.)

Selection Types

Several selection types exist to allow you to draw in the 3D visualization. The default type depends on what you wish to draw. For example, when drawing a road, by default the brush will be set to "Line" mode.

Block
Use this mode to draw rectangular areas consisting of square blocks. When moving the cursor in the 3D visualization, a grid will become visible. This grid will align with nearby spatial elements, such as roads, allowing the user to draw a selection parallel or perpendicular to things already present in the project. Click a first time with the left mouse button to start the selection of a rectangle. Move the mouse to expand the rectangle in the desired direction. Click a second time to add the created rectangle to the current selection. Adjusting the size in the brush panel will make the grid larger or smaller.
Line
The default drawing mode for roads. This mode allows you to draw rectangular areas based on a line between two selected points. Click a first time with the left mouse button in one part of the 3D visualization to start the selection. Move the mouse around in any direction and distance from the first clicked point to create the desired line. Click a second time to confirm the drawn rectangle. Adjusting the size in the brush panel will make the rectangle thicker or thinner.
Poly
Use this mode to create polygons. Click with the left mouse button in a part of the 3D visualization to start the selection. Move the cursor and consecutively click with the left mouse button to add more points. To remove a previous point, click on a blue point. Finalize the polygon by clicking on or near the first point indicated with a red color.
Circle
Use this mode to create circles. Holding down the left mouse button in one part of the 3D visualization and releasing it in another will create a circle-shaped selection, with the center where the mouse button was pressed. The radius of the circle is the distance between where the mouse button was pressed and where it was released.
Ellipse
Use this mode to create ellipses based on a line segment and two distances to it, along and perpendicular. Click with the left mouse button in one part of the 3D visualization to place the first point. Move the cursor and click a second time to place the second point. This defines the line segment the ellipse will be based on. Move the cursor again away from the line segment to create an ellipse and click a third time to confirm.
The line segment can also be reset by clicking near the blue point. Resetting the line 's original, indicated with the red point, is also possible by clicking near it, but only when the blue point is not present.
Polygon pick
Use this selection type to create selections based on existing visible items, such as building and terrain sections. Clicking on a section of a building in the 3D visualization will add the shape of that section to the selection.
Blueprint
Use this selection type to create more detailed selections based on existing areas or geo-data files, such as GeoJSON and DXF files. Click From Area to select an area to apply its geometry to the current selection. Click on From Wizard to open the Geo Data Wizard and follow its step to obtain geometries and apply these to the current selection.
Single
This mode is automatically used when a point needs to be selected. Clicking anywhere in the 3D visualization will place the point there. Only a single point can be placed.

Fine-tuning your selection

While making a selection, if you wish to make a selection composed of multiples of the same shape (for example, a large rectangle with an adjacent square), you can draw these shapes consecutively. When you begin drawing the second shape, the first shape remains drawn as selection.

You may also wish to combine some of the available drawing modes to create a more complex shape. By switching between drawing modes, without applying or clearing your selection in between, it is possible to preserve a selection made with one drawing mode and add to it with another. For example, to create a square building with a rounded front, you can draw the rectangular area in block mode, switch to circle mode, and draw a circle overlapping the rectangle.

Besides adding to your selection, it is also possible to subtract. By starting to draw a new part of your selection in an unselected part of the 3D visualization, the newly drawn selection is added to the current selection. By starting to draw a new part of your selection in a part of the 3D visualization which is already selected, the new selection is actually subtracted from the existing selection. For example, to create a square selection with a concave circular front, you can first draw a square selection, and then draw a circle on the existing selection, making it subtract instead. (Please note that this is different from "Removing".)

Validity

Making a selection is subject to validity. For more information on validity, please see Drawing validity.

Applying

Brush-bottom-apply.png

When you have made a selection, you can use the "Apply Selection" button. At this point, the selection is used to place the Building, Zone, Area, ownership or anything else you might have been drawing, in the 3D Visualization.

Removing

The brush can often also be used to remove elements or properties from the 3D visualization. To do this, you can set the "Operator" setting to "Remove". You will notice your area for valid selections will be (partially) inverted. Places where you were unable to create a valid selection could now be valid, and places where you could make a valid selection will likely be invalid. This is because when you wish to remove something, you must be able to make a valid selection of it. While usually, when you wish to draw something, it cannot be placed again in the same place.

Clearing a selection

Brush-bottom-clear.png

If you feel it necessary to cancel your current selection entirely and draw anew, you can use the "Clear Selection" button. This undoes the selection you have made and will not be applied, thus having no effect.