La marca de agua es una imagen, logotipo, patrón o texto superpuesto que se coloca sobre una fotografía o imagen. Se puede utilizar para identificar al creador de la imagen. Puede agregar una marca de agua a cualquier imagen mediante programación en la nube. Este artículo se centrará en cómo agregar una marca de agua a las imágenes mediante una API REST en Java.
En este artículo se tratarán los siguientes temas:
- API REST de marca de agua y SDK de Java
- Agregue una marca de agua de texto a las imágenes usando una API REST
- Agregue una marca de agua de imagen a las imágenes usando una API REST
API REST de marca de agua y SDK de Java
Para aplicar una marca de agua a una imagen, usaré la Java SDK de GroupDocs.Watermark Cloud API. Le permite agregar, eliminar, buscar y reemplazar mediante programación marcas de agua de imágenes y documentos de formatos admitidos como PDF, Microsoft Word y Powerpoint. Actualmente, también proporciona .NET SDK para la API de la nube.
Puede usar fácilmente GroupDocs.Watermark Cloud en sus aplicaciones Java basadas en Maven agregando la siguiente configuración pom.xml.
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>19.12</version>
<packaging>jar</packaging>
</dependency>
Obtenga su ID de cliente y Secreto de cliente del panel de control antes de comenzar a seguir los pasos y los ejemplos de código disponibles. Agregue su ID y secreto en el código como se muestra a continuación:
String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
Agregue una marca de agua de texto a las imágenes usando una API REST
Puede agregar una marca de agua de texto a fotos o archivos de imagen siguiendo los sencillos pasos que se mencionan a continuación:
- Subirthe JPG image to the Cloud
- Agregar marca de agua de texto a la imagen usando Java
- Descargarthe watermarked image
Sube la imagen JPG
En primer lugar, cargue el archivo de imagen JPG en la nube usando el ejemplo de código que se muestra a continuación:
// inicialización de la API
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// crear solicitud de carga de archivo
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
Como resultado, el archivo JPG se cargará en Cloud Storage y estará disponible en la sección de archivos de su tablero.
Agregue una marca de agua de texto a una imagen JPG usando Java
Puede agregar una marca de agua de texto a la imagen JPEG mediante programación siguiendo los pasos que se indican a continuación.
- Crear una instancia de WatermarkApi
- Establecer la ruta del archivo de imagen JPEG en el modelo FileInfo
- Defina WatermarkOptions y configure FileInfo
- Definir TextWatermarkOptions
- Establezca el texto, la familia de fuentes, el tamaño de fuente y la alineación del texto
- Establecer texto de marca de agua Color de primer plano
- Definir la posición de la marca de agua
- Definir WatermarkDetails y establecer TextWatermarkOptions y Position
- Establecer detalles de marca de agua en la lista
- Crear AddRequest con WatermarkOptions
- Obtenga resultados llamando al método WatermarkApi.add()
El siguiente ejemplo de código muestra cómo agregar texto como marca de agua a una imagen mediante una API REST.
// inicialización de la API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// establecer la ruta del archivo JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definir opciones de marca de agua
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definir las opciones de marca de agua de texto
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// establecer el color del texto de la marca de agua
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// definir detalles de marca de agua
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// establecer la posición de la marca de agua
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// establecer detalles de marca de agua
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// crear Agregar solicitud de marca de agua
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Agregar marca de agua de texto a la imagen
Descargar la imagen actualizada
Los ejemplos de código anteriores guardarán el archivo de imagen con marca de agua en la nube. Puede descargarlo utilizando el siguiente ejemplo de código:
// inicialización de la API
FileApi apiInstance = new FileApi(clientId, clientSecret);
// crear solicitud de archivo de descarga
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
Agregue una marca de agua de imagen a las imágenes usando la API REST
Puede agregar una marca de agua de imagen o logotipo a la imagen JPEG mediante programación siguiendo los pasos que se indican a continuación.
- Crear una instancia de WatermarkApi
- Establecer la ruta del archivo de imagen JPEG en el modelo FileInfo
- Defina WatermarkOptions y configure FileInfo
- Definir opciones de marca de agua de imagen
- Establezca FilePath de una imagen PNG en marca de agua con
- Definir la posición de la marca de agua
- Defina WatermarkDetails y configure ImageWatermarkOptions y Position
- Establecer detalles de marca de agua en la lista
- Crear AddRequest con WatermarkOptions
- Obtenga resultados llamando al método WatermarkApi.add()
El siguiente ejemplo de código muestra cómo agregar una imagen como marca de agua a una imagen JPEG mediante una API REST. Siga los pasos mencionados anteriormente para cargar y descargar los archivos.
// inicialización de la API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// establecer la ruta del archivo JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definir opciones de marca de agua
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definir detalles de marca de agua
WatermarkDetails watermarkDetails = new WatermarkDetails();
// definir opciones de imagen de marca de agua
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// establecer la posición de la marca de agua
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// establecer opciones de marca de agua de imagen
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// crear Agregar solicitud
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Agregar marca de agua de imagen a la imagen
Prueba en línea
Pruebe la siguiente herramienta gratuita de marca de agua en línea, que se desarrolla utilizando la API anterior. https://products.groupdocs.app/watermark/jpeg
Conclusión
En conclusión, ha aprendido cómo agregar texto o una marca de agua de imagen a una imagen JPEG en la nube. También aprendió cómo cargar mediante programación los archivos de imagen en la nube y luego descargarlos desde la nube. Puede obtener más información sobre GroupDocs.Watermark Cloud API en la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador. En caso de ambigüedad, no dude en ponerse en contacto con soporte.