TextOnCurveApi

Scriptable version of the ArtisanTextOnCurve tool: flows a text along an existing curve. With thickness > 0 the letters are solid breps (added to the primary metal layer, ready to boolean/print); with thickness 0 the result is outline curves (added to the primary user layer). The output is plain geometry, exactly like the tool’s Insert button — it does not stay linked to the curve.

from ArtisanPlugin.Scripting import TextOnCurveApi

See also the Python package, ra.text_on_curve.

Methods

Method
Create	Creates the text along curveId and returns the Guids of the added objects (breps and/or curves).

Create

IReadOnlyList<Guid> TextOnCurveApi.Create(
    Guid curveId,
    string text,
    double height = 1.5,
    double thickness = 0,
    double spacing = 0.5,
    string font = "Bienchen",
    double rotation = 0,
    double moveZ = 0,
    string horizontalAlign = "LEFT",
    string verticalAlign = "CENTER",
    bool flipHorizontal = false,
    bool flipVertical = false)

Creates the text along curveId and returns the Guids of the added objects (breps and/or curves). text what to write (required) height letter height in mm (default 1.5) thickness extrusion depth in mm; 0 = curves only (default 0) spacing letter spacing (default 0.5) font installed font name (default “Bienchen”, the tool’s default) rotation letter rotation in degrees moveZ lift above the curve in mm horizontalAlign LEFT | CENTER | RIGHT | JUSTIFY (default LEFT) verticalAlign TOP | CENTER | BOTTOM (default CENTER) flipHorizontal / flipVertical mirror the text

Parameter	Type	Default
curveId	Guid	required
text	string	required
height	double	1.5
thickness	double	0
spacing	double	0.5
font	string	"Bienchen"
rotation	double	0
moveZ	double	0
horizontalAlign	string	"LEFT"
verticalAlign	string	"CENTER"
flipHorizontal	bool	false
flipVertical	bool	false

Returns IReadOnlyList<Guid>.