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

Família de produtos GroupDocs.Watermark Cloud

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:

Localizar e substituir marca d'água usando uma API Rest

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:

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;
}
Localizar e substituir marca d'água de texto usando a API REST

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;
}
Localizar e substituir imagem de marca d'água usando a API REST

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.

Veja também