Example: Create an Area with a Hole

Creating areas is easy, as shown in the Editing Drawings topic , but creating areas that include one or more holes involves a slight nuance.   In this example we will create an area with one hole in it.

 

We begin by creating a new drawing.

 

 

 Open the drawing, and then, as described in the Editing Drawings topic, we choose Create Area for the mode button in the main toolbar.    We open the drawing and click the Create Area tool.  

 

 

To see the coordinates, click on the Coordinates tab in the Info pane.    We click to start creating an area.

 

 

In the drawing we begin clicking to create coordinates that define the boundary of our area using straight line segments.  The Coordinates tab of the Info pane automatically reports coordinates as we click to add new vertices.   The mouse cursor appears with a box around it if we have snapping on.  We can turn snapping on or off when editing by pressing the Spacebar.

 

 

We click at each location we want to mark a coordinate.

 

 

With each click the proposed area boundary grows.

 

 

At the last coordinate for the area boundary we Shift-Click to mark the coordinate, to indicate that terminates a branch in the area structure, and to indicate we intend to continue creating the area.  Another way to terminate a branch is to right-click in the drawing and choose End Current Branch from the context menu.

 

 An inverted T symbol appears in the right margin of the coordinates list to mark the end coordinate of the branch.  

 

 

We then click again to indicate the coordinate that will begin the boundary of the "hole" inside the area. The preceding last coordinate in the branch is marked with an inverted T symbol, indicating the end of a branch.

 

 

As before, each time we click to create a coordinate the boundary of the proposed "hole" is expanded one more segment.

 

 

At the last coordinate we click to mark the coordinate.

 

 

We then right-click the mouse anywhere, to call up the context menu for creating the area.  

 

 

In the context menu we choose Save Changes.  We could also have pressed Ctrl-Enter as a keyboard shortcut.

 

 

The result is an area object that has a "hole" in it.  We can Alt-click the area to show its attribute values in the Info pane.

 

 

We click on the Coordinates tab of the Info pane to see coordinates.

 

 

We can see the area is created from two branches, the ends of each branch being marked by an inverted T symbol.   One branch is the outer area boundary while the other branch is the inner boundary that defines the hole in the area.

 

This example continues into the related example topic, Example: Create an Area with Holes and Islands.

Notes

More holes, please - If we wanted to create more than one hole within the area we could have Shift-clicked the last coordinate of the hole boundary and then clicked into the drawing again to start the next boundary for a hole.

 

Clicking on whole number coordinates - Sometimes when creating objects in drawings, or labels in a labels component, for example, when using Manifold as a CAD editor or using Manifold to create diagrams for illustrations, we would like the coordinates we click for objects to be whole numbers, such as X,Y values of -165, 40 and not -165.4954783999, 40.9398312223.   

 

We can do that by first choosing View - Zoom to Native before we begin clicking to create objects.  That adjusts the scale in use so that each pixel on screen that can be clicked corresponds to a whole number coordinate value.   That works for either standalone drawing or label windows or for drawing or labels layers in a map window.

See Also

Drawings

 

Coordinates

 

Info Pane

 

Example: Draw Lines, Areas and Points - Simple example of using basic mouse moves to add points, lines and areas to a drawing.

 

Example: Trace an Area in a Map over an Image Background - In a map with a drawing layer above an image layer, create an area object in the drawing by tracing over the outlines of something seen in the image layer below.

 

Example: Create a Line using the Info Pane - Step by step creation and modification of a line in a drawing using the Info pane Coordinates tab.

 

Example: Create an Area with Holes and Islands - Create an area in a drawing where the area includes holes and also islands.

 

Example: Create a Multipoint - How to create multipoints. This topic provides two examples:  First we create a multipoint and then next we create a multipoint having two branches.  The purpose of this topic is to help teach the implementation of geometry in Manifold and other typical spatial packages using a somewhat unusual and rarely met object type, the multipoint, which combines what appear to be many separate points into a single multipoint object.