PDF Add Watermark

PDF Add Watermark

Tipo: pdf-add-watermark  ·  Paquete: PDF Activities v1.2.4  ·  Salida: string

Añade una marca de agua de texto, en diagonal, a todas las páginas de un PDF, y guarda el resultado en un archivo nuevo. Útil para marcar documentos como “COPIA”, “CONFIDENCIAL”, “BORRADOR” o con el nombre del destinatario.

Cómo funciona

Dibuja el text centrado en cada página, por encima del contenido, en Arial negrita, con la opacidad, tamaño, color y ángulo indicados, y crea un PDF nuevo en output. Devuelve la ruta del archivo creado. El original queda intacto.

• El texto va en una sola línea: si es muy largo para el tamaño elegido, se sale de la página. Baja fontSize para textos largos.
• opacity, fontSize y angle admiten un número o una expresión (p. ej. Config["Opacidad"]). Desde la versión 1.2.4. Un valor que no es número es un error, igual que una opacity fuera de 0–1 o un fontSize de 0 o menos.
• Un color distinto de los tres admitidos usa gris.
• Crea la carpeta de output si no existe y sobrescribe el archivo si ya existe.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del PDF origen.
output	string	—	Ruta del PDF resultante.
text	string	—	Texto de la marca de agua. Admite expresiones (p. ej. el nombre del destinatario).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
opacity	number	0.3	Opacidad de 0.0 (invisible) a 1.0 (opaco).
fontSize	number	48	Tamaño de fuente en puntos.
color	string	"gray"	Color: gray · red · blue.
angle	number	45	Ángulo de rotación en grados, en sentido contrario a las agujas del reloj (0 = horizontal).

Salida

Devuelve un string con la ruta del PDF creado (la misma de output).

Errores comunes

Mensaje	Causa y solución
'opacity' debe ser un número. Se recibió: …. (o 'fontSize', 'angle')	El valor escrito o el resultado de la expresión no es un número. Desde la versión 1.2.4.
'opacity' debe estar entre 0 y 1. Se recibió: ….	Opacidad fuera de rango; usa 0.5, no 50. Desde la versión 1.2.4.
'fontSize' debe ser mayor que 0. Se recibió: ….	Tamaño de letra 0 o negativo. Desde la versión 1.2.4.
No se encontró el archivo.	La ruta de path no existe.
'path' es obligatorio. / 'output' es obligatorio. / 'text' es obligatorio.	El parámetro quedó vacío o su expresión dio null.
Error de la biblioteca de PDF al abrir el archivo	PDF protegido con contraseña o dañado. Ver PDF protegidos y dañados.

Ejemplo

Marcar cada copia con el nombre del destinatario:

PDF Add Watermark
  path    = rutaContrato
  output  = "C:/copias/" + cliente.nombre + ".pdf"
  text    = "COPIA — " + cliente.nombre
  opacity = 0.2
  color   = red
  → output: copia
Log   message = "Copia generada: " + copia

Actividades relacionadas

• PDF Create — crear un PDF desde cero.
• PDF Merge — combinar documentos.