Adding Area Dimension Process
The process is an interactive one which allows adding a new 3D area dimension to a model by specifying multiple points.
Common type of the process (TypeScript):
export type AddAreaDimensionProcess = {
name: "AddAreaDimension"
snap?: SnapOptions
options: C3DViewDimensionOptions
events: {
onNew?: () => string
onCreate?: (uuid: string) => C3DUserData
onValue?: (value: number) => string
}
}
The option snap
allows to move the points indicated by the user’s mouse cursor to the
nearest vertices of the triangle. More details in the section
Snap option. This option is disabled by default.
Options
The process uses the same options as the corresponding PMI object does. They are described here.
Callbacks
Available events.
onNew() is emitted before creating a new dimension. Returns a string which is used as a dimension label text instead of the default value.
onCreate(uuid) is emitted after creating a new dimension. It receives a UUID of a new object and allows to set custom dimension properties by returning them as an object.
onValue(value) is emitted when calculating an overall area, receives a calculated value and returns a string of a dimension label text.
Note
The default label text in the absence of options.text
, events.New
and events.onValue
is just a digit of a calculated area.
Running
To run the process, you should call the command RunProcessCommand
with the AddAreaDimension name of a process.
Example of running the process (TypeScript):
view.runCommand({
name: "RunProcessCommand",
process: {
name: "AddAreaDimension",
options: {},
events: {
onValue: (value: number) => `${value.toFixed(2)} m`
}
}
})
Updating
Updating allows to change any options which are set when process is run.
Common type of the updating command (TypeScript):
type UpdateProcess = {
name: "UpdateProcessCommand"
options: {
name: "AddAreaDimension"
text?: string
underlineText?: boolean
font?: {
family?: string,
size?: number,
}
colors?: {
text?: C3DViewRGB
textBkg?: C3DViewRGB
lines?: C3DViewRGB
}
}
}
Example of the command to update area dimension font size (TypeScript):
view.runCommand({
name: "UpdateProcessCommand",
options: {
name: "AddAreaDimension",
font: {
size: 20
}
}
})