Uma marca d’água é uma imagem ou texto sobreposto usado para exibição em documentos para várias finalidades. Às vezes, pode ser necessário substituir ou editar a marca d’água inserida por um novo texto ou imagem. Este artigo se concentrará em como localizar e substituir texto ou imagens de marca d’água usando uma API REST.
Os seguintes tópicos serão abordados neste artigo:
- API REST de marca d’água e SDK .NET
- Localizar e substituir marca d’água de texto usando uma API REST
- Localizar e substituir imagem de marca d’água usando uma API REST
API REST de marca d’água e SDK .NET
Para pesquisar e substituir marca d’água, usarei a API .NET SDK do GroupDocs.Watermark Cloud. Ele permite que você adicione, remova, pesquise e substitua marcas d’água de imagens e documentos de formatos suportados de forma programática. Atualmente, também fornece Java SDK para a API Cloud.
O GroupDocs.Watermark Cloud SDK para .NET pode ser instalado em seu projeto do Visual Studio a partir do gerenciador de pacotes NuGet, conforme mostrado abaixo:
Você também pode instalar o pacote NuGet usando o seguinte comando no console do Gerenciador de pacotes:
Install-Package GroupDocs.Watermark-Cloud
Obtenha seu ID de cliente e Segredo do cliente no painel antes de começar a seguir as etapas e os exemplos de código disponíveis. Adicione seu ID e Secret no código conforme demonstrado abaixo:
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);
Localizar e substituir marca d’água de texto usando uma API REST
Você pode localizar e substituir o texto da marca d’água de seus documentos PDF seguindo as etapas simples mencionadas abaixo:
- Carregarthe PDF document to the Cloud
- Localizar e substituir marca d’água de texto do arquivo PDF carregado
- Downloadthe updated file
Carregar o documento PDF
Em primeiro lugar, carregue o documento PDF que contém a marca d’água na nuvem usando um dos seguintes métodos:
- Usando o painel
- Carregue o arquivo usando Upload File API do navegador
- Carregue programaticamente usando o exemplo de código fornecido abaixo:
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, o arquivo PDF será carregado no Cloud Storage e estará disponível na seção de arquivos do seu painel.
Localizar e substituir marca d’água de texto
O trecho de código a seguir mostra como localizar e substituir uma marca d’água de texto de um arquivo PDF carregado usando uma 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;
}
Você também pode definir fonte, tamanho do texto, cores de primeiro plano e de fundo para o texto da marca d’água usando o seguinte exemplo de código:
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
FontFamily = "Arial",
Size = 20d,
ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}
Baixe o arquivo atualizado
Os exemplos de código acima salvarão o arquivo PDF com um novo texto ou imagem de marca d’água na nuvem. Você pode baixá-lo usando o seguinte exemplo 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);
}
Localizar e substituir imagem de marca d’água usando uma API REST
O exemplo de código simples fornecido abaixo demonstra como localizar e substituir a imagem da marca d’água usando uma API REST. Siga as etapas mencionadas anteriormente para fazer upload e download de um arquivo.
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;
}
Conclusão
Concluindo, você aprendeu como pesquisar e substituir a marca d’água de texto ou imagem de um documento PDF na nuvem com a API REST de marca d’água .NET usando C#. Além disso, você também aprendeu como fazer o upload programático dos arquivos na nuvem e, em seguida, baixá-los da nuvem. Além disso, você pode aprender vários outros recursos úteis do GroupDocs.Watermark Cloud API na documentação. Em caso de ambiguidade, sinta-se à vontade para entrar em contato com suporte.