@pdfme/pdf-lib 1.18.1 → 1.18.4

package/src/api/operations.ts

@@ -33,11 +33,13 @@ import {
   appendBezierCurve,
   FillRule,
   fillEvenOdd,
+  concatTransformationMatrix,
 } from './operators';
 import { Rotation, degrees, toRadians } from './rotations';
 import { svgPathToOperators } from './svgPath';
 import { PDFHexString, PDFName, PDFNumber, PDFOperator } from '../core';
 import { asNumber } from './objects';
+import type { Space, TransformationMatrix } from '../types'
 
 export interface DrawTextOptions {
   color: Color;
@@ -49,8 +51,27 @@ export interface DrawTextOptions {
   x: number | PDFNumber;
   y: number | PDFNumber;
   graphicsState?: string | PDFName;
+  matrix?: TransformationMatrix;
+  clipSpaces?: Space[];
 }
 
+const clipSpace = ({ 
+  topLeft,
+  topRight,
+  bottomRight,
+  bottomLeft
+}: Space) => 
+  [
+    moveTo(topLeft.x, topLeft.y),
+    lineTo(topRight.x, topRight.y),
+    lineTo(bottomRight.x, bottomRight.y),
+    lineTo(bottomLeft.x, bottomLeft.y),
+    closePath(),
+    clip(),
+    endPath(),
+  ]
+const clipSpaces = (spaces: Space[]) => spaces.flatMap(clipSpace)
+
 export const drawText = (
   line: PDFHexString,
   options: DrawTextOptions,
@@ -84,6 +105,8 @@ export const drawLinesOfText = (
   const operators = [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
     beginText(),
     setFillingColor(options.color),
     setFontAndSize(options.font, options.size),
@@ -116,11 +139,15 @@ export const drawImage = (
     xSkew: Rotation;
     ySkew: Rotation;
     graphicsState?: string | PDFName;
+    matrix?: TransformationMatrix;
+    clipSpaces?: Space[];
   },
 ): PDFOperator[] =>
   [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
     translate(options.x, options.y),
     rotateRadians(toRadians(options.rotate)),
     scale(options.width, options.height),
@@ -162,10 +189,14 @@ export const drawLine = (options: {
   dashPhase?: number | PDFNumber;
   lineCap?: LineCapStyle;
   graphicsState?: string | PDFName;
+  matrix?: TransformationMatrix;
+  clipSpaces?: Space[];
 }) =>
   [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
     options.color && setStrokingColor(options.color),
     setLineWidth(options.thickness),
     setDashPattern(options.dashArray ?? [], options.dashPhase ?? 0),
@@ -192,8 +223,43 @@ export const drawRectangle = (options: {
   borderDashArray?: (number | PDFNumber)[];
   borderDashPhase?: number | PDFNumber;
   graphicsState?: string | PDFName;
-}) =>
-  [
+  matrix?: TransformationMatrix;
+  clipSpaces?: Space[];
+  radius?: number | PDFNumber;
+}) => {
+  let ops = [];
+  
+  if (!options.radius || asNumber(options.radius) <= 0) {
+    ops = [
+      moveTo(0, 0),
+      lineTo(0, options.height),
+      lineTo(options.width, options.height),
+      lineTo(options.width, 0),
+      closePath(),
+    ];
+  } else {
+    let radius = asNumber(options.radius);
+    const width = asNumber(options.width);
+    const height = asNumber(options.height);
+
+    if (radius > width / 2.0 || radius > height / 2.0) {
+      radius = Math.min(width / 2.0, height / 2.0);
+    }
+    const offset = KAPPA * radius;
+    ops = [
+      moveTo(0, radius),
+      appendBezierCurve(0, radius - offset, radius - offset, 0, radius, 0),
+      lineTo(width - radius, 0),
+      appendBezierCurve(width - radius + offset, 0, width, radius - offset, width, radius),
+      lineTo(width, height - radius),
+      appendBezierCurve(width, height - radius + offset, width - radius + offset, height, width - radius, height),
+      lineTo(radius, height),
+      appendBezierCurve(radius - offset, height, 0, height - radius + offset, 0, height - radius),
+      closePath(),
+    ];
+  }
+
+  return [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
     options.color && setFillingColor(options.color),
@@ -201,14 +267,13 @@ export const drawRectangle = (options: {
     setLineWidth(options.borderWidth),
     options.borderLineCap && setLineCap(options.borderLineCap),
     setDashPattern(options.borderDashArray ?? [], options.borderDashPhase ?? 0),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
     translate(options.x, options.y),
     rotateRadians(toRadians(options.rotate)),
     skewRadians(toRadians(options.xSkew), toRadians(options.ySkew)),
-    moveTo(0, 0),
-    lineTo(0, options.height),
-    lineTo(options.width, options.height),
-    lineTo(options.width, 0),
-    closePath(),
+
+    ...ops,
 
     // prettier-ignore
     options.color && options.borderWidth ? fillAndStroke()
@@ -218,6 +283,7 @@ export const drawRectangle = (options: {
 
     popGraphicsState(),
   ].filter(Boolean) as PDFOperator[];
+}
 
 const KAPPA = 4.0 * ((Math.sqrt(2) - 1.0) / 3.0);
 
@@ -300,12 +366,16 @@ export const drawEllipse = (options: {
   borderDashPhase?: number | PDFNumber;
   graphicsState?: string | PDFName;
   borderLineCap?: LineCapStyle;
+  matrix?: TransformationMatrix;
+  clipSpaces?: Space[];
 }) =>
   [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
     options.color && setFillingColor(options.color),
     options.borderColor && setStrokingColor(options.borderColor),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
     setLineWidth(options.borderWidth),
     options.borderLineCap && setLineCap(options.borderLineCap),
     setDashPattern(options.borderDashArray ?? [], options.borderDashPhase ?? 0),
@@ -350,12 +420,16 @@ export const drawSvgPath = (
     borderDashPhase?: number | PDFNumber;
     borderLineCap?: LineCapStyle;
     graphicsState?: string | PDFName;
-    fillRule?: FillRule
+    fillRule?: FillRule;
+    matrix?: TransformationMatrix;
+    clipSpaces?: Space[];
   },
 ) =>
   [
     pushGraphicsState(),
     options.graphicsState && setGraphicsState(options.graphicsState),
+    ...(options.clipSpaces ? clipSpaces(options.clipSpaces) : []),
+    options.matrix && concatTransformationMatrix(...options.matrix),
 
     translate(options.x, options.y),
     rotateRadians(toRadians(options.rotate ?? degrees(0))),