View source for 3D VIEW/Edit

__NOTOC__{{DISPLAYTITLE:Edit}}[[File:Edit-ss.png|right|framed|<center>'''Edit''' mode when [[Settings/Printer/Features/Hardware/Extruder Count|more than one extruder]] is present.</center>]]Edit mode allows the user to make minor changes to the model currently loaded in [[3D View]].

== [[View Controls]] ==

[[File:View Controls.png]]

View Controls is a set of tools which allow the user to manipulate the view and/or models currently displayed.

In Edit mode, the following tools are avaiable:

*[[View Controls#Reset View|Reset View]]
*[[View Controls#Rotate|Rotate]]
*[[View Controls#Move|Move]]
*[[View Controls#Zoom|Zoom]]
*[[View Controls#Select Part|Select Part]]

== ROTATE ==

[[File:Edit-Rotate-example.gif|right|thumb|350px|<center>A model rotated around the X Axis, 45 degrees at a time.</center>]]The '''ROTATE''' function allows the user to rotate the model a specific number of degrees around a specified axis.

[[File:Edit-Rotate.png]]

=== Degrees ===

Enter the number of degrees to rotate the model.

=== Axes buttons ===

Click the button for the axis around which to rotate the model to perform the rotation.

=== Align to Bed ===

Will cause MatterControl to attempt to bring the part down flat, adjacent to the bed. Useful for resetting the position of the model.

<br clear=all>

== SCALE ==

[[File:Edit-Scale-example.gif|right|thumb|350px|<center>A model scaled to 1, 2, then 3 times its size.</center>]]The '''SCALE''' section allows the user to change the size of the model.

[[File:Edit-Scale.png]]

=== Ratio ===

The '''Ratio''' field allows the user to specify a positive whole or decimal number which will be multiplied by the existing model's dimensions.

==== Presets ====

The '''Ratio''' field has several presets for common translations:

*mm to in (.0393)
*in to mm (25.4)
*mm to cm (.1)
*cm to mm (10)
*reset (1)

=== X ===

The '''X''' field allows for direct specification of the dimension of the model's size along the X axis.

=== Y ===

The '''Y''' field allows for direct specification of the dimension of the model's size along the Y axis.

=== Z ===

The '''Z''' field allows for direct specification of the dimension of the model's size along the Z axis.

=== Lock Ratio ===

If checked, the '''Lock Ratio''' option maintains the ratio of the model's dimensions relative to each other. For example, if a model's dimensions are X:20, Y:20, Z:50 and the Y value is changed to 10, X becomes 10 and Z becomes 25 automatically.

<br clear=all>
== MIRROR ==

[[File:Edit-Mirror-example.gif|right|thumb|350px|<center>A model mirrored over the Z axis.</center>]]The '''MIRROR''' section allows the user to translate a model over an axis.

[[File:Edit-Mirror.png]]

=== X ===

Click the '''X''' button to translate the model over the X axis.

=== Y ===

Click the '''Y'' button to translate the model over the Y axis.

=== Z ===

Click the '''Z''' button to translate the model over the Z axis.

<br clear=all>
== MATERIALS ==

[[File:Multi-extrusion.png|right|thumb|350px|<center>Two aligned models: one to be printed with Extruder 1 and the other with Extruder 2.</center>]]The '''MATERIALS''' section allows the user to specify which extruder will be used to print a model. 

This section is shown only when the [[Settings/Printer/Features/Hardware/Extruder Count|Extruder Count]] setting is set to a value greater than 1.

See also: [[Multi-Extrusion]]

[[File:Edit-Materials.png]]
<br clear=all>
== DISPLAY ==

The '''DISPLAY''' section allows the user to toggle certain visual options.

[[File:Edit-Display.png]]

=== Show Print Bed ===

If enabled, the graphical print bed is displayed.

[[File:Edit-Show Print Bed-example.gif|350px]]

=== Show Print Area ===

If enabled, a translucent box appears to indicate the build volume. The box's height is set by the [[Settings/Printer/Print Area/Size and Coordinates/Build Height|Build Height]] setting.

[[File:Edit-Show Print Area-example.gif|350px]]

=== Shaded ===

Shows only the faces of the model.

=== Outlines ===

Shows the faces and lines of a model, but does not include lines which connect vertices of single flat polygons.

=== Polygons ===

Shows all faces and lines of a model, including all lines which connect vertices of single flat polygons.

[[File:Edit-Display-example.gif|none|thumb|400px|<center>Cycling between Shaded, Outlines, and Polygons.</center>]]

<br clear=all>
== Insert ==

[[File:3D_View-Insert.png]]

Opens the operating system file manager so a model file can be selected for addition to any existing models in the current view. 

== Ungroup ==

[[File:Edit-Ungroup.png]]

Separates unconnected models. This is typically used if multiple models are loaded into MatterControl as part of one STL file.

Once ungrouped, the models can be selected and edited individually.

== Group ==

[[File:Edit-Group.png]]

Combines all models currently displayed. The combined "model" can then be selected and edited as a whole.

== Align ==

[[File:Edit-Align.png]]

Moves ungrouped models into a grid pattern relative to the currently selected model, then group all models.

== Arrange ==

[[File:Edit-Arrange.png]]

Centers all models in a grid pattern.

== Copy ==

[[File:Edit-Copy.png]]

Makes a copy of the currently selected model.

== Remove ==

[[File:Edit-Remove.png]]

Deletes the currently selected model.

== Cancel ==

[[File:Edit-Save-prompt.png|right|framed|<center>If unsaved changes have been made, the user is prompted.</center>]][[File:Edit-Cancel.png]]

Exits Edit mode. The user is prompted to save any unsaved changes.
<br clear=all>
== Save ==

[[File:Edit-Save.png]]

Saves changes to the model.

== Save As ==

[[File:Edit-Save-As-ss.png|right|framed|<center>The '''Save New Design''' window.</center>]][[File:Edit-Save-As.png]]

Opens the '''Save New Design''' dialog box which prompts the user to save a new file in a specified location.
[[Category:Incomplete]]