API referenceText

pdfWriteAngleText

Draw a single straight line of text rotated by Angle around

CategoryText output
AvailabilityPartial — Radius/YOrigin accepted but completely unused; weaker Unicode support (see chapter table)

Purpose — Draw a single straight line of text rotated by Angle around (PosX, PosY).

Description — compatibility shim. The exported signature includes Radius and YOrigin — parameters whose names suggest text placed along a circular arc — but the wrapper's implementation calls the internal writer with only (PosX, PosY, Angle, Text); Radius and YOrigin are never read anywhere in the call chain. This function always draws straight (non-curved) rotated text at the given point, regardless of what you pass for Radius/YOrigin. For actual arc (curved-baseline) text, see pdfDrawTextArc (a different, separate API, not this one). Font-kind dispatch: TrueType → Identity-H GIDs via WriteAngleTextBlockGID; everything else (including CID-predefined fonts, which get no special-case here unlike pdfWriteText) → raw-byte WriteAngleTextBlock. The non-TrueType W path encodes via CP_ACP (see the chapter-level table), not the WinAnsi-safe path.

Declarations

C
BOOL32 __stdcall pdfWriteAngleTextA(PPDF IPDF, const char* AText, double Angle, double PosX, double PosY, double Radius, double YOrigin);
BOOL32 __stdcall pdfWriteAngleTextW(PPDF IPDF, const wchar_t* AText, double Angle, double PosX, double PosY, double Radius, double YOrigin);
Delphi
function pdfWriteAngleTextA(const IPDF: PPDF; const AText: PAnsiChar; Angle, PosX, PosY, Radius, YOrigin: Double): LongBool; stdcall; external 'LumasPdf.dll';
function pdfWriteAngleTextW(const IPDF: PPDF; const AText: PWideChar; Angle, PosX, PosY, Radius, YOrigin: Double): LongBool; stdcall; external 'LumasPdf.dll';

Parameters

ParameterTypeDescription
IPDFPPDFInstance handle with an open page and font.
ATextstringText to draw.
AngleDoubleRotation in degrees, counter-clockwise from horizontal.
PosX, PosYDoubleRotation pivot / text origin.
RadiusDoubleAccepted but ignored — see Description.
YOriginDoubleAccepted but ignored — see Description.

Return valueTRUE on success; FALSE on a missing precondition or empty text.

Remarks — After a successful call, FLastTextPosX/Y are set to the starting PosX/PosY — unlike pdfWriteText, which reports the end of the run. This is a second, independent inconsistency between the two writers beyond the encoding difference.

See alsopdfDrawTextArc (separate API for true curved-baseline text)

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
[return: MarshalAs(UnmanagedType.Bool)]
Area
Text
Category

Text

Exported names

pdfWriteAngleTextA pdfWriteAngleTextW

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.