Skip to content
Member Filters
Show Inherited
Show Protected
Show abstract
GR32🞂TCustomBitmap32🞂VertLineMethodPublic

TCustomBitmap32.VertLine

Draws fast vertical 1-pixel wide lines across integer or fixed-point coordinates with optional boundary clipping, alpha blending, and stippling.

Declaration ​

pascal
procedure VertLine(X, Y1, Y2: Integer; Value: TColor32);
procedure VertLineS(X, Y1, Y2: Integer; Value: TColor32);
procedure VertLineT(X, Y1, Y2: Integer; Value: TColor32);
procedure VertLineTS(X, Y1, Y2: Integer; Value: TColor32);
procedure VertLineTSP(X, Y1, Y2: Integer);
procedure VertLineX(X, Y1, Y2: TFixed; Value: TColor32);
procedure VertLineXS(X, Y1, Y2: TFixed; Value: TColor32);

Parameters ​

ParameterTypeDescription
X, Y1, Y2IntegerX column, start Y, and end Y coordinates.
ValueTColor3232-bit ARGB color.

Description ​

The VertLine methods draw fast 1-pixel wide vertical lines between vertical coordinates Y1 and Y2 at column X.

Method variants support integer (Integer) or 16.16 fixed-point (TFixed) coordinates, boundary clipping (S), alpha blending (T), and pattern stippling (P).

Variants ​

VariantCoordinate TypeModifiersDescription
VertLineIntegerDirectFast direct vertical line fill without boundary clipping or alpha blending.
VertLineSIntegerSafeVertical line fill clipped against ClipRect.
VertLineTIntegerTransparentUnclipped vertical line fill with alpha blending using DrawMode / CombineMode.
VertLineTSIntegerTransparent + SafeClipped vertical line fill with alpha blending using DrawMode / CombineMode.
VertLineTSPIntegerTransparent + Safe + StippleClipped alpha-blended vertical line using active stipple pattern.
VertLineXTFixedFixed Sub-pixelUnclipped 16.16 fixed-point vertical line with anti-aliasing.
VertLineXSTFixedFixed Sub-pixel + SafeClipped 16.16 fixed-point vertical line with anti-aliasing.

Example ​

pascal
// Fast direct vertical line
Bitmap.VertLine(50, 10, 200, clRed32);

// Clipped alpha-blended vertical line
Bitmap.VertLineTS(75, 0, 300, clTrBlue32);

See also ​