Añadir superposición de texto a GIF usando REST en Java - Código de ejemplo

Este ejemplo muestra cómo configurar una marca de agua de texto y aplicarla a cada fotograma de un archivo GIF.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén instaladas correctamente y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Superponer texto en GIF con API REST usando cURL

A continuación se presentan los comandos cURL que realizan la misma operación desde una terminal. Ilustran el flujo de trabajo completo de REST: autenticación, carga, marca de agua y descarga.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Reemplace YOUR_ACCESS_TOKEN en las siguientes llamadas con el token devuelto arriba.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

Para obtener más detalles sobre los cuerpos de solicitud y los formatos de respuesta, consulte la documentación oficial de la API.

Desglosando la adición de superposición de texto a GIF usando REST en Java - Cómo funciona

1. Inicializar el cliente API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") crea un objeto de configuración que contiene sus credenciales. La instancia WatermarkApi utiliza esta configuración para firmar cada solicitud.

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

2. Especifique los archivos de origen y destino - FileInfo y OutputFileInfo indican al servicio dónde leer el GIF original y dónde escribir el resultado. Ambos pueden hacer referencia a un nombre de almacenamiento personalizado.

   FileInfo inputFile = new FileInfo();
   inputFile.setFilePath("input.gif");
   inputFile.setStorageName("MyStorage");
   

3. Configurar la marca de agua de texto - TextWatermarkOptions contiene todas las propiedades visuales: texto, fuente, tamaño, color, opacidad, rotación y alineación. Configurar pageRange a "1-" garantiza que cada fotograma del GIF animado reciba la superposición.

TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");

4. Construir y enviar la solicitud - AddWatermarkRequest agrupa la información del archivo y las opciones. Llamar a watermarkApi.addWatermark(request) realiza la operación en el servidor y devuelve la ruta del archivo procesado.

   AddWatermarkRequest request = new AddWatermarkRequest();
   request.setFileInfo(inputFile);
   request.setOutputFileInfo(outputFile);
   request.setOptions(textOptions);
   AddWatermarkResponse response = watermarkApi.addWatermark(request);
   

5. Manejar la respuesta - La respuesta contiene la ruta del archivo de salida. En una aplicación real, normalmente descargarías el archivo o pasarías la ruta a otro servicio.

Para obtener una lista completa de clases y propiedades, consulte la referencia de API.

Instalación y configuración de GroupDocs.Watermark Cloud SDK for Java

Agrega la dependencia de Maven a tu pom.xml (o la entrada equivalente de Gradle). Esto incluye la versión 23.8 del SDK.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Requisitos previos

• Java 8 o superior
• Una cuenta activa de GroupDocs Cloud
• Client ID y Client Secret (disponibles en el panel de GroupDocs Cloud)

Ejemplo de configuración

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Descargue los últimos JARs desde la página de descarga. Para uso en producción, aplique una licencia válida obtenida de la página de licencia temporal.

Conclusión

Agregar superposición de texto a GIF usando REST en Java se convierte en una operación repetible del lado del servidor con la ayuda del GroupDocs.Watermark Cloud SDK for Java. El SDK abstrae la complejidad de manejar fotogramas animados, permitiéndote centrarte en el contenido de tus subtítulos o mensajes promocionales. Después de integrar el código de ejemplo o el flujo de trabajo cURL, puedes ajustar finamente los estilos de fuente, colores y opacidad para que coincidan con tu marca. Recuerda asegurar una licencia de producción; los detalles de precios están disponibles en la página del producto, y se puede obtener una licencia temporal para pruebas a través de la página de licencia temporal. ¡Feliz codificación!

Preguntas frecuentes

• ¿Cómo agrego una superposición de texto a un GIF usando REST en Java cuando el texto cambia por usuario?
  Construya el objeto TextWatermarkOptions en tiempo de ejecución con la cadena específica del usuario, luego invoque la misma llamada addWatermark. La API procesa cada solicitud de forma independiente, por lo que el contenido dinámico es totalmente compatible.

• ¿Puedo añadir subtítulos a un GIF animado sin afectar su velocidad de animación?
  Sí. La marca de agua se aplica a cada fotograma mientras se conserva el retraso original del fotograma. Simplemente establezca pageRange en "1-" para que cada fotograma reciba la misma superposición.

• ¿Qué formatos son compatibles para el color del texto superpuesto?
  El SDK acepta códigos de color HEX (p. ej., #FF0000) y nombres de color estándar de HTML. Consulte la referencia de API para la lista completa.

• ¿Necesito una licencia para desarrollo y pruebas?
  Una licencia temporal es suficiente para la evaluación y pruebas. Para implementaciones en producción, compre una licencia completa en la página del producto y aplíquela mediante la API de licencias del SDK.

Read More

• Añadir texto superpuesto a un GIF usando la API REST en C#
• Añadir marca de agua a imágenes usando Java
• Añadir marca de agua a Word en Java - Creador de marcas de agua

Requisitos y configuración

Antes de comenzar, asegúrese de tener lo siguiente:

• Java 8 o superior instalado.
• Maven o Gradle para la gestión de dependencias.
• Una cuenta de GroupDocs Cloud con client ID y client secret.
• Acceso al almacenamiento en la nube donde residirán los archivos Excel.

Agrega la dependencia de Maven a tu pom.xml (o el fragmento equivalente de Gradle):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Puedes descargar los últimos JARs desde la página de descarga. Después de agregar la dependencia, crea un objeto de configuración con tus credenciales:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Con el cliente listo, puedes pasar al flujo de trabajo real de protección con contraseña.

Proteger con contraseña Excel mediante REST en Java: Guía paso a paso

Paso 1: Cargar el documento de origen

Defina la ubicación del archivo XLSX de origen en su almacenamiento en la nube.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Paso 2: Establecer la ruta de destino

Especifique dónde se guardará el libro de trabajo protegido.

String outputPath = "output_protected.xlsx"; // destination file

Paso 3: Configurar opciones de protección con contraseña

Cree un objeto ProtectOptions, adjunte la información del archivo, la ruta de salida y la contraseña deseada.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Paso 4: Construir la solicitud de protección del documento

Envuelva las opciones en un ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Paso 5: Ejecutar la solicitud y manejar la respuesta

Llame al método de la API y procese cualquier error.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Para obtener más detalles sobre cada clase, consulte la referencia de API.

Ejemplo completo y funcional para proteger con contraseña Excel mediante REST en Java

El siguiente código demuestra el proceso completo de principio a fin.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de archivo (input.xlsx, output_protected.xlsx) para que coincidan con sus ubicaciones reales, verifique que todas las dependencias requeridas estén instaladas correctamente y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o comuníquese con el equipo de soporte para obtener ayuda.

Proteger libro de Excel mediante API REST usando cURL

A continuación se muestra un conjunto de comandos cURL que realizan la misma operación de protección con contraseña directamente contra los puntos finales REST.

1. Autenticar y obtener un token de acceso

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

La respuesta contiene un access_token que usarás en llamadas posteriores.

2. Cargar el archivo XLSX de origen

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Solicitar protección con contraseña

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Descargar el libro de trabajo protegido

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Estos comandos le permiten integrar el flujo de trabajo de protección en scripts o canalizaciones CI. Para obtener más detalles, consulte la documentación oficial de la API.

Conclusión

Implementar proteger con contraseña Excel mediante REST en Java es sencillo con el GroupDocs.Merger Cloud SDK for Java. Al seguir los pasos anteriores, puedes proteger los libros de Excel, automatizar el proceso en aplicaciones del lado del servidor y mantener los datos sensibles seguros. Recuerda obtener una licencia adecuada para uso en producción; la información de precios está disponible en la página del producto y puedes comenzar con una licencia temporal para evaluar la biblioteca. ¡Feliz codificación!

Preguntas frecuentes

• ¿Cómo difiere la protección con contraseña de Excel mediante REST en Java del cifrado local?
  La API en la nube realiza el cifrado en el servidor, por lo que no necesitas gestionar bibliotecas criptográficas localmente. El SDK maneja la construcción de la solicitud y el análisis de la respuesta, simplificando la integración.

• ¿Es posible establecer opciones de protección adicionales, como el modo de solo lectura?
  La clase ProtectOptions actual se centra en la protección mediante contraseña. Para funciones de seguridad más avanzadas, consulte la referencia de API para ver si hay parámetros más recientes.

• ¿Qué formatos de archivo son compatibles con la protección por contraseña?
  La Merger API actualmente admite XLSX, DOCX, PPTX, y PDF para cifrado. Consulte la documentación oficial para obtener la lista completa.

• ¿Necesito una licencia para ejecutar el ejemplo en un entorno de desarrollo?
  El desarrollo y las pruebas pueden realizarse con una licencia temporal. Las implementaciones en producción requieren una licencia de pago, que puedes adquirir a través de la página del producto.

Leer más

• Proteger con contraseña archivos PowerPoint en Node.js
• Proteger con contraseña archivos Excel usando la API REST en Python
• Combinar hojas de Excel en Java - Fusionador de archivos Excel