# 3DFace

## <img src="https://3375153115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5uhW8FwQpXQj8tHUULMo%2Fuploads%2FIEFxydwe88d0gPhZO5Y2%2FG2_01_SUBD_SINGLE_FACE.png?alt=media&#x26;token=5dbe28bc-6c29-4210-84bf-4111614a4f33" alt="" data-size="line"> 3DFace <a href="#profiles" id="profiles"></a>

The 3DFace command creates mesh or SubD faces that can be standalone or added to an existing mesh or SubD.

<div align="left"><img src="https://docs.mcneel.com/rhino/8/help/en-us/image/topic_illustrations/3dface_mesh_subd.png" alt=""></div>

A mesh face (left) and a SubD face (right)

* When meshes or SubDs are pre-selected, the 3DFace command starts in the [Append](https://docs.mcneel.com/rhino/8/help/en-us/commands/3dface.htm#Append) mode.

### Command-line options

#### **Output**

* **Mesh:** Creates mesh faces.

<div align="left"><img src="https://docs.mcneel.com/rhino/8/help/en-us/image/topic_illustrations/3dface_mesh.gif" alt=""></div>

* **SubD:** Creates SubD faces.

**Interpolated (Yes/No)**

<div align="left"><figure><img src="https://docs.mcneel.com/rhino/8/help/en-us/image/topic_illustrations/3dface_interpolated.gif" alt=""><figcaption><p>Yes                                                                No</p></figcaption></figure></div>

Conceptually, this is the difference between what the [Curve](https://docs.mcneel.com/rhino/8/help/en-us/commands/curve.htm) and [InterpCrv](https://docs.mcneel.com/rhino/8/help/en-us/commands/interpcrv.htm) commands do. The Curve command turns input points into the curve's control points. The InterpCrv command creates a curve to pass the input points.

#### **Append**

#### Selects an existing mesh or SubD to which the new faces will be added.

* During appending new faces, press ESC to cancel the current face creation. Press ESC one more time to cancel the command.

#### **PolygonType (Triangle/Quad/Ngon)**

#### Specifies to create triangle, quad, or n-gon faces.

* When PolygonType=Ngon, picking not enough points adds a triangle or quad face.

#### **FromEdge**

* **Yes:** Each new face is started by selecting an existing mesh or SubD boundary edge.
  * **Chain (Yes/No):** Create faces along an edge chain. The edge chain can be from an existing mesh or the current creating mesh.
  * **FromEdgeReset**
    * **Yes:** Resets FromEdge to No in the next 3DFace command session.
    * **No:** Remembers the setting of FromEdge for the next 3DFace command session.
* **No:** Each new face is created by picking points.

Each new face is created by picking points.

#### **InPlane (Yes/No)**

Set Yes to define a plane with the first three points and constrain the rest points of the current face on that plane. This option only takes effect when PolygonType=Quad/Ngon.

<div align="left"><img src="https://docs.mcneel.com/rhino/8/help/en-us/image/topic_illustrations/3dface_inplane.gif" alt=""></div>

#### **WeldAngle (Only for Output=Mesh)**

The welding tolerance for mesh edges in degrees. Welding applies to edges around new faces. The default angle is 180 degrees that welds all edges.

#### **Mode (SingleFace/MultipleFaces)**

Specifies to create only one or more faces in a command session.

#### **Undo**

Removes the previous pick.

For more information, please refer to the [Rhino documentation](https://docs.mcneel.com/rhino/8/help/en-us/commands/3dface.htm#\(null\)).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rhinoartisan.com/commands/subd/primitives-subd/3dface.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
