Cómo añadir una marca de agua a un PDF

Qué hace la herramienta y qué necesitas

Una marca de agua ayuda a identificar el uso previsto de un PDF sin sustituir su contenido. Esta herramienta añade un texto configurable sobre cada página, con una opacidad regulable para que el resultado sea más discreto o más visible. El texto se coloca cerca del punto medio vertical, aparece en gris y queda por encima del contenido que ya tenía la página.

Puede servir para señalar documentos como «BORRADOR», «CONFIDENCIAL» o «COPIA DE REVISIÓN». Antes de empezar, prepare un PDF y decida el texto que quiere mostrar. El archivo debe llegar como un valor codificado en base64 y, una vez decodificado, sus bytes deben comenzar con la firma %PDF-.

Pasos para añadir una marca de agua al PDF

1. Prepare el PDF. Use un documento PDF válido y convierta su contenido a un valor codificado en base64. Al decodificarlo, el archivo debe comenzar por %PDF-; un documento de otro tipo no cumple este requisito.

2. Escriba el texto de la marca. Introduzca una cadena de entre 1 y 200 caracteres. Si no proporciona un texto, se utiliza «CONFIDENTIAL» como valor predeterminado. Para un documento en español, puede introducir «CONFIDENCIAL», «BORRADOR» o una indicación similar.

3. Configure la opacidad. El valor predeterminado es 0,3. La herramienta convierte la entrada a número y la mantiene dentro del intervalo de 0,05 a 1,0. Un valor inferior se ajusta a 0,05 y uno superior se ajusta a 1,0, por lo que conviene elegir un número dentro de ese intervalo desde el principio.

4. Procese el archivo. Envíe el PDF codificado, el texto y la opacidad configurada. No hace falta preparar una marca diferente para cada página: el texto suministrado se añade a cada página del PDF.

5. Revise el resultado. Abra el PDF resultante y compruebe que la marca se ve en todas las páginas, que el texto gris tiene la visibilidad deseada y que aparece sobre el contenido existente. Si la marca tapa información importante, pruebe con una opacidad más baja, sin salir del intervalo admitido.

Cómo interpretar el resultado y sus límites

Un resultado correcto debe ser otro PDF en el que el texto indicado aparece como marca de agua en cada página. La posición se sitúa alrededor del punto medio vertical, el texto se muestra en gris y se superpone al contenido original. La opacidad cambia su presencia visual, pero no convierte el valor en un porcentaje: se trata de un número entre 0,05 y 1,0.

Si el resultado no tiene éxito, revise primero dos entradas. Un texto vacío o de más de 200 caracteres se rechaza antes de procesar el PDF. También puede fallar el procesamiento cuando los datos no representan un PDF válido o cuando se produce un error reconocido al trabajar con el documento. En ese caso, vuelva a codificar un PDF válido y compruebe que sus bytes decodificados empiezan por %PDF-.

La herramienta añade la marca sobre el contenido que ya existe. Por eso, una marca muy visible puede cubrir parte del texto, una tabla o una imagen. Elija el texto y la opacidad teniendo en cuenta el diseño de las páginas, y revise el PDF final antes de compartirlo.

Ejemplo práctico

Una persona quiere identificar como borrador un PDF de varias páginas antes de enviarlo a un equipo de revisión.

Codifica en base64 un PDF válido cuyo contenido decodificado comience por %PDF-, introduce «BORRADOR» y establece la opacidad en 0,2. Después, procesa el archivo y revisa las páginas del PDF resultante.

El resultado tiene forma de un PDF en el que «BORRADOR» aparece en gris cerca del punto medio vertical de cada página y se superpone al contenido original.

Limitaciones

• La marca se superpone al contenido original y el archivo de entrada debe ser un PDF cuyos bytes decodificados comiencen por %PDF-.

Errores frecuentes

• Causa: se envía un valor que, al decodificarse, no empieza por %PDF- o no corresponde a un PDF válido. Corrección: vuelva a codificar el PDF correcto y compruebe su firma antes de procesarlo.

Preguntas frecuentes

¿Qué formato debe tener el archivo de entrada?

Sí, siempre que el archivo decodificado comience por %PDF- y el procesamiento del documento sea válido. El resultado incorpora el texto en cada página.

¿Qué texto puedo usar como marca de agua?

Si no introduces un texto, se utiliza «CONFIDENTIAL». Si escribes uno propio, debe tener entre 1 y 200 caracteres; una cadena vacía se rechaza.

¿Cómo se controla la visibilidad de la marca?

La opacidad predeterminada es 0,3. La entrada se convierte a número y queda limitada al intervalo de 0,05 a 1,0; la marca sigue siendo texto gris sobre el contenido del PDF.