SURE Editor (Edit Mode)


SURE Editor can be used to manually edit and save meshes after processing.

General

To activate edit mode in the SURE Editor, switch on the additional editing box is going to pop up on the right of the UI. In the vicinity of the current mouse position the mesh editor is always going to load the highest available LOD of the mesh to ensure all editing is based on that LOD level. When zooming out after editing the mesh lower LOD levels are loaded which not yet contain any changes.

basic shortcuts
1 - 7select different tools
ctrl + z

undo last action

ctrl + y

redo last action

The SURE Editor Cheat Sheet lists the most important keyboard shortcuts and can be printed.

SURE_Editor_Cheat_Sheet.pdf

Tools

Peak Removal

The peak removal tool can be used to flatten out peaks and noise in a circular area of the mesh. When the tool is active, the area that is going to be flattened is indicated by a red circle highlighting all faces that are going to be affected. After the tool has been triggered the modified faces are indicated in yellow.

peak removal shortcuts
1select peak removal tool

ctrl + mouse wheel

scale area that the tool will flatten

ctrl + left click

trigger tool


Example:

Peak Removal Polygon

The peak removal polygon allows users to draw a custom polygon selection that can be used for peak removal instead of using a circular selection as in the standard peak removal tool. You need to set at least 3 points before executing the tool.

It's advisable to look at the mesh in wireframe mode in order to judge the results of your edit.

peak removal polygon shortcuts
2select peak removal polygon tool
ctrl + left clickset corner point of selection
ctrl + right click / enter

execute tool on current selection

escape

cancel current selection



Example:
                     Mesh before editing                                          Peak removal selection                                        Mesh after editing

Edge Sharpening

The edge sharpening tool can be used to insert sharp edges into the mesh. The tool is going to delete the visually highlighted vertices of the mesh and fill the resulting hole while inserting the user defined sharp edge.

It's advisable to look at the mesh in wireframe mode in order to judge the results of your edit.

edge sharpening shortcuts
3select edge sharpening tool
ctrl + mouse wheelscale area that will be removed by tool
ctrl + left clickinsert selection point (tool is triggered automatically when second point is inserted) - note that the tool automatically snaps to the nearest mesh vertex to simplify the refinement.
escapecancel current selection


Example:
                     Mesh before editing                                       Edge sharpening selection                                        Mesh after editing

Spherical Eraser

The spherical eraser tool can be used to delete disconnected flying mesh parts that often appear in 3D meshes. All vertices that are highlighted in red will be removed as soon as the tool is triggered.


spherical eraser shortcuts
4select spherical eraser tool
ctrl + mouse wheel

scale the spherical selection

ctrl + left clicktrigger deletion of highlighted mesh parts


Example:
                      Mesh before editing                                                   Spherical Selection                                                    Mesh after editing

Measuring Tool

This tool can be used to measure the distance between two points on the mesh surface.

Measuring tool shortcuts
5measuring tool
ctrl + left click

set starting/end  point of measuring tape

ctrl + right clickcancel current measurement
Escapecancel current measurement

The measured distance is automatically copied to the clipboard.

Example:

Measuring Polygon Tool

This tool can be used to measure the perimeter of a polygon. The perimeter equals the sum of the lengths of its sides.

Measuring tool shortcuts
6measuring tool
ctrl + left click

add measuring tape point

ctrl + right clickfinish polygon measurement
Escapecancel current measurement

Example:

clicking

Mesh Info Tool

This tool can be used to query information about the tile of the mesh, the user clicks on. This information includes details about the file location of the mesh as well as the coordinate

Measuring tool shortcuts
7info tool
ctrl + left click

create mesh info marker

Escape

remove current info marker

The path on the filesystem of the currently marked mesh tile is automatically copied to the clipboard.

Example:

Temporary files

In order to allow for undo / redo of individual edits the mesh editor writes temporary mesh files. These files are written to a location on the hard disk which is specified by the user on start-up of the editor or can be changed at a later point in time via the editor menu entry "Set temporary file location". Be aware that this shouldn't be done in the middle of an editing session, since the editor won't be able to find previous temporary files for undo / redo any more.

Since the editor has to save meshes per edit that is applied, the disk space required for temporary files will incrementally grow with each edit. The temporary folder will be cleaned on each save operation. Alternatively, discarding all changes or closing the editor will also empty the temporary folder.

Fast access to the hard disk is crucial when it comes to editing performance since the editor has to write files to the temporary folder for each edit. Prefer local folders over ones that require network access, using a SSD would be ideal.

LOD Update

Since editing is applied to the LOD 0 geometry of the mesh, it is necessary to recalculate all other LOD levels in order for the changes to be applied to them as well.

To do LOD recalculation go to the "Editor" menu and select "Update LOD" option. To run lod recalculation, activate the checkbox.

Recalculating LOD and texture is done on a per tile basis. For all tiles that have been edited at least once LOD will have to be recalculated. In order to do this the mesh editor will save a temporary mesheditor_modifiedTilesList.txt that is passed to the LOD regeneration module. You can see the location of the list that is used in the Texturing Tool window. You can also select your own file containing a list of tiles that you want to regenerate LOD for.

LOD update is included in the following licenses:

  • SURE Aerial
  • SURE Professional
  • SURE Editor Standalone

Texture Update

Edited areas won't contain valid texture, as the underlying geometry has changed. To produce a consistent edited mesh therefore, it is also necessary to recalculate the texture within the edited areas.

To do so please go to the "Editor" menu and select "Recalculate Texture". Recalculating the texture is a two step process in which first the LOD levels will be updated and afterwards texture will be recalculated for all LOD levels. Required are the input images and orientations of the original dataset.


The Texturing update is included in the following licenses:

  • SURE Aerial + Meshing Addon
  • SURE Professional

Saving

Saving can be done from the "Editor" menu by selecting either "Save Mesh" or "Save As ...".

The "Save As ..." feature will involve saving the whole mesh including edited and unedited parts of the mesh to a new location, so please make sure you have enough disk space available. This operation can take a long time depending on the size of your mesh, since it is equivalent to copying the whole mesh.

The "Save Mesh" feature will overwrite the mesh in place. This is faster than "Save As ..." since only the modified mesh parts will have to be saved, but your original mesh will be overwritten. Please make sure to keep a safety copy of your mesh in case you might need it again.

Retrieve list of edited tiles

Sometimes it can be useful to generate a list of all mesh tiles that were edited. One example would be if the edited mesh tiles are supposed to be used to generate improved DSMs & TrueOrthos.

A list of all edited tiles can be generated from the "Editor" menu by selecting the "Export list of edited tiles" entry.