evCreate API 5.7 Help

3D Model Editing

The 3D Model Editing subsection of the 3D Editing evCreate API section includes type aliases and functions to manage 3D editing sessions and edit 3D models during active 3D editing sessions.

edit3D namespace

The 3D Model Editing subsection of the 3D Editing evCreate API section is accessed with the edit3D namespace:

evCreate.edit3D.Function()

Type aliases

EvBBox3D

A type alias for an array of the coordinates of a bounding box in 3D space.

EvCoord3D

A type alias for an array of X, Y, and Z coordinates in 3D space.

EvMatrix3D

A type alias for an array of the homogeneous coordinates of a 4×4 homogeneous transformation matrix.

EvPartId

A type alias for a persistent internal unique identifier of a Part item.

EvVector3D

A type alias for an array of the X, Y, and Z coordinates of a vector in 3D space.

Functions

AddOffsetLines(parts: EvItem[]): Promise<EvItem[]>

A function to add offset lines to given parts of a 3D model edited in an active 3D editing session.

EditModel(model: EvItem): Promise<void>

A function to launch a 3D editing session for a given 3D model item.

EnableContextMenu(enable: boolean): void

A function to turn on or off the context menu in the 3D editing mode.

Exit(): Promise<void>

A function to quit a currently active 3D editing session without saving changes.

FindParts(metaValue: EvMetaValue): Promise<EvItem[]>

A function to find part items in a 3D model edited in an active 3D editing session against given metadata.

FitCameraTo(parts?: EvItem[]): Promise<void>

A function to make given parts fully visible and fit the viewport.

GetActiveModel(): undefined | EvItem

A function to get a 3D model item currently edited in an active 3D editing session.

GetBaseUnitLengthInMillimeters(): number

A function to get the base unit of measurement of a 3D model edited in an active 3D editing session converted into millimeters.

GetModelInfo(options?: EvPartQueryOptions): Promise<Ev3DObjectData>

A function to get the 3D attributes of a 3D model edited in an active 3D editing session.

GetPartBoundingBox(parts: EvItem[]): Promise<EvBBox3D>

A function to get the current combined 3D bounding box of given parts of a 3D model edited in an active 3D editing session with part transformations.

GetPartInfo(part: EvItem, options?: EvPartQueryOptions): Promise<Ev3DObjectData>

A function to get the 3D attributes of a given part item of a 3D model edited in an active 3D editing session.

GetPartNeutralBoundingBox(parts: EvItem[]): Promise<EvBBox3D>

A function to get the original combined 3D bounding box of given parts of a 3D model edited in an active 3D editing session without part transformations.

RotatePart(parts: EvItem[], pivot: EvCoord3D, axis: EvVector3D, angle: number): Promise<void>

A function to rotate given parts of a 3D model edited in an active 3D editing session around a given pivot point, along a given axis, by a given angle.

Save(): Promise<void>

A function to quit a currently active 3D editing session and save all the changes done to a 3D model item edited during this session to this 3D model item.

SaveNew(): Promise<void>

A function to quit a currently active 3D editing session and save all the changes done to a 3D model item edited during this session to a newly created 3D model item.

SetPartColor(parts: EvItem[], color: string): Promise<void>

A function to paint given parts of a 3D model edited in an active 3D editing session with a given color.

SetPartGhosted(parts: EvItem[], ghosted: boolean): Promise<void>

A function to turn the ghost effect for given parts of a 3D model edited in an active 3D editing session on or off.

SetPartMetaData(parts: EvItem[], metaData: Ev3DMetadata[]): Promise<void>

A function to create or update given metadata properties of given parts from a 3D model edited in an active 3D editing session.

SetPartOpacity(parts: EvItem[], opacity: number): Promise<void>

A function to manage the opacity (transparency) of given parts from a 3D model edited in an active 3D editing session by a given opacity level.

SetPartPosition(part: EvItem, transformation: EvMatrix3D): Promise<void>

A function to translate or rotate a given part of a 3D model edited in an active 3D editing session by a given 4×4 homogeneous transformation matrix.

SetPartVisible(parts: EvItem[], visible: boolean): Promise<void>

A function to hide or show given parts of a 3D model edited in an active 3D editing session in the viewport.

TranslatePart(parts: EvItem[], by: EvVector3D, locally: boolean): Promise<void>

A function to translate given parts of a 3D model edited in an active 3D editing session by a given translation offset vector.

28 April 2025