A marca d’água é uma imagem, logotipo, padrão ou texto sobreposto colocado sobre uma fotografia ou imagem. Ele pode ser usado para identificar o criador da imagem. Você pode adicionar uma marca d’água a qualquer imagem programaticamente na nuvem. Este artigo se concentrará em como adicionar uma marca d’água a imagens usando uma API REST em Java.
Os seguintes tópicos serão abordados neste artigo:
- API REST de marca d’água e SDK Java
- Adicionar marca d’água de texto a imagens usando uma API REST
- Adicionar marca d’água de imagem a imagens usando uma API REST
API REST de marca d’água e SDK Java
Para colocar uma marca d’água em uma imagem, usarei a API Java SDK of GroupDocs.Watermark Cloud. Ele permite que você adicione, remova, pesquise e substitua programaticamente marcas d’água de imagens e documentos de formatos suportados, como PDF, Microsoft Word e Powerpoint. Atualmente, também fornece SDK .NET para a API Cloud.
Você pode facilmente usar GroupDocs.Watermark Cloud em seus aplicativos Java baseados em Maven adicionando a seguinte configuração 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>
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 clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
Adicionar marca d’água de texto a imagens usando uma API REST
Você pode adicionar marca d’água de texto a fotos ou arquivos de imagem seguindo as etapas simples mencionadas abaixo:
- Carregarthe JPG image to the Cloud
- Adicionar marca d’água de texto à imagem usando Java
- Downloadthe watermarked image
Carregue a imagem JPG
Em primeiro lugar, carregue o arquivo de imagem JPG para a nuvem usando o exemplo de código abaixo:
// inicialização da API
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// criar solicitação de upload de arquivo
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
Como resultado, o arquivo JPG será carregado no Cloud Storage e estará disponível na seção de arquivos do seu painel.
Adicionar marca d’água de texto à imagem JPG usando Java
Você pode adicionar uma marca d’água de texto à imagem JPEG programaticamente seguindo as etapas abaixo.
- Crie uma instância de WatermarkApi
- Defina o caminho do arquivo de imagem JPEG no modelo FileInfo
- Defina WatermarkOptions e defina FileInfo
- Definir TextWatermarkOptions
- Defina o texto, a família da fonte, o tamanho da fonte e o alinhamento do texto
- Definir a cor do primeiro plano do texto da marca d’água
- Definir posição da marca d’água
- Defina WatermarkDetails e defina TextWatermarkOptions e Position
- Definir detalhes da marca d’água para listar
- Criar AddRequest com WatermarkOptions
- Obtenha resultados chamando o método WatermarkApi.add()
O exemplo de código a seguir mostra como adicionar texto como marca d’água a uma imagem usando uma API REST.
// inicialização da API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// definir o caminho do arquivo JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definir opções de marca d'água
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definir opções de marca d'água de texto
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// definir a cor do texto da marca d'água
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// definir detalhes da marca d'água
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// definir a posição da marca d'água
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// definir detalhes da marca d'água
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// criar solicitação de adição de marca d'água
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Adicionar marca d’água de texto à imagem
Baixe a imagem atualizada
Os exemplos de código acima salvarão o arquivo de imagem com marca d’água na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:
// inicialização da API
FileApi apiInstance = new FileApi(clientId, clientSecret);
// criar solicitação de download de arquivo
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
Adicionar marca d’água de imagem a imagens usando a API REST
Você pode adicionar uma marca d’água de imagem ou logotipo à imagem JPEG programaticamente seguindo as etapas abaixo.
- Crie uma instância de WatermarkApi
- Defina o caminho do arquivo de imagem JPEG no modelo FileInfo
- Defina WatermarkOptions e defina FileInfo
- Definir ImageWatermarkOptions
- Definir FilePath de uma imagem PNG para marca d’água com
- Definir posição da marca d’água
- Defina WatermarkDetails e defina ImageWatermarkOptions e Position
- Definir detalhes da marca d’água para listar
- Criar AddRequest com WatermarkOptions
- Obtenha resultados chamando o método WatermarkApi.add()
O exemplo de código a seguir mostra como adicionar uma imagem como marca d’água a uma imagem JPEG usando uma API REST. Siga as etapas mencionadas anteriormente para fazer upload e download dos arquivos.
// inicialização da API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// definir o caminho do arquivo JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definir opções de marca d'água
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definir detalhes da marca d'água
WatermarkDetails watermarkDetails = new WatermarkDetails();
// definir opções de imagem de marca d'água
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// definir a posição da marca d'água
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// definir opções de marca d'água de imagem
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// criar Adicionar Solicitação
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Adicionar marca d’água de imagem à imagem
Experimente on-line
Experimente a seguinte ferramenta de marca d’água on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/watermark/jpeg
Conclusão
Concluindo, você aprendeu como adicionar marca d’água de texto ou imagem a uma imagem JPEG na nuvem. Você também aprendeu como carregar programaticamente os arquivos de imagem na nuvem e baixá-los da nuvem. Você pode aprender mais sobre GroupDocs.Watermark Cloud API na documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para entrar em contato com suporte.