Method drawRectangle

src/api/pdf-page.ts:853–898

* Draw a rectangle on the page. * * @example * ```typescript * // Filled rectangle * page.drawRectangle({ * x: 50, y: 500, width: 200, height: 100, * color: rgb(0.95, 0.95, 0.95), * }); * * // Stroked rectangle with rounded corners * page.drawRectangle({ * x

(options: DrawRectangleOptions)

   * ```
   */
  drawRectangle(options: DrawRectangleOptions): void {
    // Register graphics state for opacity if needed
    let gsName: string | undefined;

    if (options.opacity !== undefined || options.borderOpacity !== undefined) {
      gsName = this.registerGraphicsState({
        fillOpacity: options.opacity,
        strokeOpacity: options.borderOpacity,
      });
    }

    // Register patterns if provided
    const fillPatternName = options.pattern ? this.registerPattern(options.pattern) : undefined;
    const strokePatternName = options.borderPattern
      ? this.registerPattern(options.borderPattern)
      : undefined;

    // Calculate rotation center if rotating
    let rotate: { angle: number; originX: number; originY: number } | undefined;

    if (options.rotate) {
      const bounds = { x: options.x, y: options.y, width: options.width, height: options.height };
      const defaultOrigin = { x: options.x + options.width / 2, y: options.y + options.height / 2 };
      const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
      rotate = { angle: options.rotate.angle, originX: origin.x, originY: origin.y };
    }

    const ops = drawRectangleOps({
      x: options.x,
      y: options.y,
      width: options.width,
      height: options.height,
      fillColor: options.color,
      fillPatternName,
      strokeColor: options.borderColor,
      strokePatternName,
      strokeWidth: options.borderWidth,
      dashArray: options.borderDashArray,
      dashPhase: options.borderDashPhase,
      cornerRadius: options.cornerRadius,
      graphicsStateName: gsName ? `/${gsName}` : undefined,
      rotate,
    });

    this.appendOperators(ops);
  }

  /**
   * Draw a line on the page.