0.1.0

kitepdf/io.github.yuroyami.kitepdf.writer/ContentStreamBuilder

ContentStreamBuilder

class ContentStreamBuilder

Builds a page content stream (ISO 32000-1 §8–§9) from typed drawing operations, emitting the raw operator bytes. Each PDF operator takes its operands first, then the operator keyword: r g b rg, x y m, (str) Tj.

Coordinates are in the default user space (origin bottom-left, points). Numbers are formatted without scientific notation (via PdfObjectWriter); names and strings are escaped the same way the serializer escapes them.

Fonts and images are referenced through fontResolver / imageResolver, which map a StandardFont / PdfImage to the resource name the owning PdfBuilder will register in /Resources.

Functions

fun beginText(): ContentStreamBuilder

fun clip(): ContentStreamBuilder

Intersect the clipping path with the current path using the nonzero winding rule (W). Per the spec, a path-painting operator must follow — call endPath to clip without also painting the path, e.g. rectangle(...); clip(); endPath().

fun clipEvenOdd(): ContentStreamBuilder

Like clip, but with the even-odd rule (W*).

fun closePath(): ContentStreamBuilder

fun drawImage(image: PdfImage, x: Double, y: Double, width: Double, height: Double): ContentStreamBuilder

Draw image into the rectangle (x, y) → (x+width, y+height) in user space (x, y is the bottom-left corner). Wrapped in its own q … Q so the image transform doesn't leak into later drawing.

fun endPath(): ContentStreamBuilder

fun endText(): ContentStreamBuilder

fun fill(): ContentStreamBuilder

fun fillAndStroke(): ContentStreamBuilder

fun lineTo(x: Double, y: Double): ContentStreamBuilder

fun moveText(tx: Double, ty: Double): ContentStreamBuilder

fun moveTo(x: Double, y: Double): ContentStreamBuilder

fun nextLine(): ContentStreamBuilder

fun raw(content: String): ContentStreamBuilder

Escape hatch: append literal content-stream source, followed by a newline.

fun rectangle(x: Double, y: Double, w: Double, h: Double): ContentStreamBuilder

fun restore(): ContentStreamBuilder

fun save(): ContentStreamBuilder

fun setCharSpacing(spacing: Double): ContentStreamBuilder

fun setFillGray(g: Double): ContentStreamBuilder

fun setFillRgb(r: Double, g: Double, b: Double): ContentStreamBuilder

fun setFont(font: StandardFont, size: Double): ContentStreamBuilder

fun setLeading(leading: Double): ContentStreamBuilder

fun setLineWidth(w: Double): ContentStreamBuilder

fun setStrokeGray(g: Double): ContentStreamBuilder

fun setStrokeRgb(r: Double, g: Double, b: Double): ContentStreamBuilder

fun setWordSpacing(spacing: Double): ContentStreamBuilder

fun showText(text: String): ContentStreamBuilder

fun stroke(): ContentStreamBuilder

fun text(font: StandardFont, size: Double, x: Double, y: Double, text: String): ContentStreamBuilder

Convenience: draw a single line of text in font at size, with its baseline at (x, y). Wraps BT/Tf/Td/Tj/ET.

fun transform(a: Double, b: Double, c: Double, d: Double, e: Double, f: Double): ContentStreamBuilder

Concatenate a b c d e f onto the current transformation matrix (cm).