Una marca de agua es una imagen o texto superpuesto que se utiliza para mostrarse en documentos con diversos fines. A veces, es posible que deba reemplazar o editar la marca de agua insertada con un nuevo texto o imagen. Este artículo se centrará en cómo encontrar y reemplazar texto o imágenes de marcas de agua utilizando una API REST.
En este artículo se tratarán los siguientes temas:
- API REST de marca de agua y SDK de .NET
- Busque y reemplace la marca de agua de texto usando una API REST
- Buscar y reemplazar la imagen de la marca de agua mediante una API REST
API REST de marca de agua y SDK de .NET
Para buscar y reemplazar la marca de agua, utilizaré la API .NET SDK de GroupDocs.Watermark Cloud. Le permite agregar, eliminar, buscar y reemplazar marcas de agua mediante programación de imágenes y documentos de formatos admitidos. Actualmente, también proporciona SDK de Java para la API de la nube.
El SDK de GroupDocs.Watermark Cloud para .NET se puede instalar en su proyecto de Visual Studio desde el administrador de paquetes NuGet como se muestra a continuación:
También puede instalar el paquete NuGet con el siguiente comando en la consola del Administrador de paquetes:
Install-Package GroupDocs.Watermark-Cloud
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 MyClientId = "YOUR-CLIENT-ID";
string MyClientSecret = "YOUR-CLIENT-SECRET";
var config = new Configuration(MyClientId, MyClientSecret);
var watermarkApi = new WatermarkApi(config);
var fileApi = new FileApi(config);
var storageApi = new StorageApi(config);
Busque y reemplace la marca de agua de texto usando una API REST
Puede encontrar y reemplazar el texto de la marca de agua de sus documentos PDF siguiendo los sencillos pasos que se mencionan a continuación:
- Subirthe PDF document to the Cloud
- Buscar y reemplazar marca de agua de texto del archivo PDF cargado
- Descargarthe updated file
Sube el documento PDF
En primer lugar, cargue el documento PDF que contiene la marca de agua en la nube utilizando cualquiera de los siguientes métodos:
- Usando el panel
- Cargue el archivo usando Upload File API desde el navegador
- Cargue mediante programación utilizando el ejemplo de código que se proporciona a continuación:
var path = @"C:\Files\";
string MyStorage = null;
var file = Directory.GetFiles(path, "Sample.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);
var fileStream = File.Open(file, FileMode.Open);
fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, MyStorage));
fileStream.Close();
}
Como resultado, el archivo PDF se cargará en Cloud Storage y estará disponible en la sección de archivos de su tablero.
Buscar y reemplazar marca de agua de texto
El siguiente fragmento de código muestra cómo buscar y reemplazar una marca de agua de texto de un archivo PDF cargado mediante una API REST.
public static string FindAndReplaceTextWatermark(WatermarkApi watermarkApi)
{
var options = new ReplaceOptions
{
FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Sample.pdf"
},
TextSearchCriteria = new TextSearchCriteria
{
SearchText = "Watermark Text"
},
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
}
};
var request = new ReplaceRequest(options);
var result = watermarkApi.Replace(request);
return result.Path;
}
También puede configurar la fuente, el tamaño del texto, los colores de primer plano y de fondo para el texto de la marca de agua utilizando el siguiente código de ejemplo:
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
FontFamily = "Arial",
Size = 20d,
ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}
Descargar el archivo actualizado
Los ejemplos de código anteriores guardarán el archivo PDF con un nuevo texto o imagen de marca de agua en la nube. Puede descargarlo utilizando el siguiente ejemplo de código:
var downloadRequest = new DownloadFileRequest(file, MyStorage);
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.pdf"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Buscar y reemplazar la imagen de la marca de agua mediante una API REST
El ejemplo de código simple que se proporciona a continuación demuestra cómo encontrar y reemplazar la imagen de la marca de agua mediante una API REST. Siga los pasos mencionados anteriormente para cargar y descargar un archivo.
public static string FindAndReplaceImageWatermark(WatermarkApi watermarkApi)
{
var options = new ReplaceOptions
{
FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Sample.pdf"
},
ImageSearchCriteria = new ImageSearchCriteria
{
ImageFileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "sample_watermark.png"
}
},
ReplaceImageOptions = new ReplaceImageOptions
{
Image = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
{
FilePath = "Logo.png"
}
}
};
var request = new ReplaceRequest(options);
var result = watermarkApi.Replace(request);
return result.Path;
}
Conclusión
En conclusión, ha aprendido a buscar y reemplazar la marca de agua de texto o imagen de un documento PDF en la nube con la API REST de .NET Watermark usando C#. Además, también aprendió cómo cargar los archivos en la nube mediante programación y luego descargarlos de la nube. Además, puede aprender otras funciones útiles de GroupDocs.Watermark Cloud API en la documentación. En caso de cualquier ambigüedad, no dude en ponerse en contacto con soporte.