ConstructionAxisInput.setByNormalToFaceAtSnapPoint Method

Parent Object: ConstructionAxisInput
Defined in namespace "adsk::fusion" and the header file is <Fusion/Construction/ConstructionAxisInput.h>

Description

This input method is for creating a construction axis normal to a specified face or sketch profile and that passes through the location described by a snap point. A snap point captures the same information that the user supplies in the UI when they hover over an entity and pick a snap location: the host entity, an optional reference entity, the picked 3D point in world space, and a ConstructionSnapPointTypes value that classifies the selection. Build the snap with ConstructionSnapPoint.create. Supported snap-point types include vertex (DefaultConstructionSnapPointType on a BRepVertex, SketchPoint, or ConstructionPoint), edge midpoint, edge start/end, arc center, face center, and tangent on a curved face (cylinder/cone, sphere, torus, or spline). The point does not have to lie on the face. This can result in a parametric or non-parametric construction axis depending on whether the parent component is parametric or is a direct edit component.

Syntax

"constructionAxisInput_var" is a variable referencing a ConstructionAxisInput object.

returnValue = constructionAxisInput_var.setByNormalToFaceAtSnapPoint(face, snapPoint)
"constructionAxisInput_var" is a variable referencing a ConstructionAxisInput object.

#include <Fusion/Construction/ConstructionAxisInput.h>

returnValue = constructionAxisInput_var->setByNormalToFaceAtSnapPoint(face, snapPoint);
"constructionAxisInput_var" is a variable referencing a ConstructionAxisInput object.

returnValue = constructionAxisInput_var.setByNormalToFaceAtSnapPoint(face, snapPoint);

Return Value

Type Description
boolean Returns true if the creation of the ConstructionAxisInput is successful.

Parameters

Name Type Description
face BRepFace The face (BRepFace object) to create the axis normal to.
snapPoint ConstructionSnapPoint The ConstructionSnapPoint describing the location the axis passes through.

Samples

Name Description
Construction Axis API Sample Demonstrates creating construction axis in various ways.

Version

Introduced in version September 2026