Agregar una marca de agua a la imagen en PDF | Cómo agregar una marca de agua a documentos PDF utilizando .NET

Agregar una marca de agua a un PDF es un requisito común para proteger documentos, indicar confidencialidad o marcar sus archivos. En este artículo, le guiaremos a través de los detalles sobre cómo poner una marca de agua en un PDF con unas pocas líneas de código. Ya sea que desee marcar imágenes dentro de PDFs o un documento PDF completo, esta guía cubre todo lo que necesita.

• ¿Por qué agregar una marca de agua con imagen a un PDF?
• API REST de manipulación de PDF
• Imagen de marca de agua usando C#
• Cómo insertar una marca de agua usando cURL
• Aplicación gratuita en línea para marcas de agua en PDF

¿Por qué agregar una marca de agua de imagen a un PDF?

• Protege tus documentos de la distribución no autorizada.
• Haz que tu marca sea coherente en todos los archivos PDF.
• Indique el estado confidencial o de borrador claramente.

API REST para Manipulación de PDF

El GroupDocs.Watermark Cloud SDK for .NET te permite agregar, gestionar y personalizar marcas de agua de imágenes en documentos PDF con pocos pasos. Con este SDK, puedes proteger tus PDFs, mantener la coherencia de la marca y controlar la apariencia de la marca de agua programáticamente sin necesidad de software de escritorio.

👉 - Aparte de PDF, también puedes procesar Word, PPTX, Excel, y varios archivos de imágenes con esta API.

Características de las marcas de agua en imágenes PDF

• Agrega marcas de agua de imágenes a archivos PDF fácilmente utilizando .NET.
• Aplicar marcas de agua a todas las páginas o a páginas específicas de un PDF.
• Personaliza la opacidad, el tamaño, la alineación y la rotación de las marcas de agua de las imágenes.
• Actualice o elimine las marcas de agua de imagen existentes en los documentos PDF según sea necesario.

Instalación

Instale el SDK a través de NuGet en su proyecto .NET:

PM> NuGet\Install-Package GroupDocs.Watermark-Cloud -Version 23.8.0

Marca de agua de imagen usando C#

Por favor, sigue las instrucciones a continuación para agregar una marca de agua de imagen a un archivo PDF utilizando C# .NET.

Paso 1. – Configurar la API.

var configuration = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
var watermarkApi = new WatermarkApi(configuration);

Paso 2. – Especificar el nombre del archivo PDF de entrada.

var fileInfo = new FileInfo
{
    FilePath = "SourceFile.pdf"
};

Paso 3. – Definir las características de la marca de agua.

WatermarkOptions = new PdfWatermarkOptions
{
    ImageWatermark = new ImageWatermark
    {
        FilePath = "logo.png",
        HorizontalAlignment = "Center",
        VerticalAlignment = "Center",
        Opacity = 0.5
    }
}

Paso 4. – Insertar marca de agua de imagen.

var response = watermarkApi.AddWatermark(request);

• Puede insertar una marca de agua en PDF en posiciones específicas, ajustar la opacidad o escalar la imagen.

// Para más ejemplos, por favor visite https://github.com/groupdocs-watermark-cloud/groupdocs-watermark-cloud-dotnet

var configuration = new Configuration("XXXXXXX-XXXXXXX-XXXXXX-XXXXXXX", "XXXXXXXXXXXX");
var watermarkApi = new WatermarkApi(configuration);

var fileInfo = new FileInfo
{
    // input pdf file available in cloud storage
    FilePath = "sample.pdf",
};

var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { FilePath = "confidential.jpg" }
            }
        }
    },
    ProtectLevel = WatermarkOptions.ProtectLevelEnum.DocumentAndImages
};
// crear solicitud para agregar una marca de agua a la imagen
var request = new Requests.AddRequest(options);
// Insertar marca de agua de imagen en archivo PDF
var response = watermarkApi.Add(request);

Cómo insertar una marca de agua usando cURL

La REST API también te permite agregar marcas de agua de imágenes a documentos PDF utilizando comandos cURL. Esta función es útil si prefieres trabajar directamente con solicitudes HTTP en lugar de SDKs.

Paso 1 – Obtener el Token de Acceso

curl -X POST "https://api.groupdocs.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"

Paso 2 – Insertar Marca de Agua en PDF

curl -v -X POST "https://api.groupdocs.cloud/v1.0/watermark" \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{  \"FileInfo\": {    \"FilePath\": \"sourceFile.pdf\",    \"StorageName\": \"internal\"  },  \"OutputFolder\": \"resultant\",  \"WatermarkDetails\": [    {      \"ImageWatermarkOptions\": {        \"Image\": {          \"FilePath\": \"confidential.jpeg\",          \"StorageName\": \"internal\"        }      },      \"Position\": {        \"X\": 120,        \"Y\": 120,        \"Width\": 200,        \"Height\": 200,        \"HorizontalAlignment\": \"center\",        \"VerticalAlignment\": \"center\",        \"Margins\": {          \"Right\": 100,          \"Left\": 100,          \"Top\": 100,          \"Bottom\": 100        },        \"ScaleFactor\": 1,        \"RotateAngle\": 180,        \"ConsiderParentMargins\": true,        \"IsBackground\": true      },      \"Opacity\": 1    }  ],  \"PdfOptions\": {    \"PrintOnlyAnnotationWatermarks\": true,    \"Rasterize\": true  }}"

Reemplace {ACCESSTOKEN} con el token generado arriba.

Aplicación gratuita en línea para marcas de agua en PDF

Si estás interesado en probar la funcionalidad de Cloud SDK sin un fragmento de código, puedes considerar utilizar nuestra aplicación gratuita Online PDF Watermark App. Todo lo que necesitas hacer es subir el documento PDF de entrada, especificar el archivo de imagen y descargar el PDF con marca de agua, sin escribir una sola línea de código.

Conclusión

En este artículo, hemos aprendido que el uso de GroupDocs.Watermark Cloud SDK para .NET para marcar archivos PDF es una solución rápida, confiable y flexible para desarrolladores y empresas por igual. Permite agregar marcas de agua de imagen, controlar su posición, opacidad y tamaño, y aplicarlas a todas o a páginas seleccionadas sin necesidad de software de escritorio como Adobe Acrobat. Pruebe utilizar esta API para generar documentos PDF profesionales, seguros y fácilmente manejables.

Preguntas Frecuentes – FAQs

1. ¿Puedo agregar una marca de agua de imagen a páginas específicas de un PDF? Sí. Puede elegir aplicar la marca de agua de la imagen a todas las páginas o solo a páginas seleccionadas en el PDF.

2. ¿Es posible marcar con una marca de agua un PDF sin modificar el archivo original? Sí. La API genera un nuevo PDF con marca de agua mientras mantiene el documento original intacto.

3. ¿Necesito instalar Adobe Acrobat u otro software externo? No. Todas las operaciones se ejecutan en la nube, no se requiere software de escritorio.

4. ¿Puedo reemplazar o eliminar una marca de agua de imagen existente en un PDF? Sí. El SDK te permite actualizar o eliminar marcas de agua existentes en documentos PDF en cualquier momento.

5. ¿Hay una versión gratuita de la API de marca de agua? Sí. Crea una cuenta de prueba gratuita para probar las funciones de marcas de agua en línea.

Enlaces útiles

• Guía del Desarrollador
• Referencia de API
• GitHub Repository
• Foro de Soporte
• Live Demos

Artículos Relacionados

• Extraer texto de PowerPoint en C# .NET
• Exportar PDF como imágenes JPEG utilizando API REST de .NET
• Extraer imágenes de un documento de Word en C# .NET