Filigran, bir fotoğrafın veya görüntünün üzerine yerleştirilmiş bir görüntü, logo, desen veya metindir. Görüntünün yaratıcısını tanımlamak için kullanılabilir. Bulutta programlı olarak herhangi bir görüntüye filigran ekleyebilirsiniz. Bu makale, Java’da bir REST API kullanarak resimlere nasıl filigran ekleneceğine odaklanacaktır.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Filigran REST API ve Java SDK
- REST API kullanarak Görüntülere Metin Filigranı Ekleyin
- REST API kullanarak Görüntülere Görüntü Filigranı Ekleyin
Filigran REST API ve Java SDK
Bir görüntüyü filigranlamak için GroupDocs.Watermark Cloud’un Java SDK’sı API’sini kullanacağım. PDF, Microsoft Word ve Powerpoint gibi desteklenen biçimlerdeki görüntülerden ve belgelerden programlı olarak filigran eklemenize, kaldırmanıza, aramanıza ve değiştirmenize olanak tanır. Şu anda, Bulut API’si için .NET SDK da sağlamaktadır.
Aşağıdaki pom.xml yapılandırmasını ekleyerek GroupDocs.Watermark Cloud’u Maven tabanlı Java uygulamalarınızda kolayca kullanabilirsiniz.
<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>
Lütfen adımları ve mevcut kod örneklerini izlemeye başlamadan önce gösterge tablosundan İstemci Kimliğinizi ve İstemci Sırrınızı alın. Kimliğinizi ve Sırrınızı aşağıda gösterildiği gibi koda ekleyin:
String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
REST API kullanarak Görüntülere Metin Filigranı Ekleyin
Aşağıda belirtilen basit adımları izleyerek fotoğraflara veya görüntü dosyalarına metin filigranı ekleyebilirsiniz:
- Yüklemekthe JPG image to the Cloud
- Java Kullanarak Görüntüye Metin Filigranı Ekleyin
- İndirmekthe watermarked image
JPG Resmini Yükle
Öncelikle, aşağıda verilen kod örneğini kullanarak JPG resim dosyasını Buluta yükleyin:
// api başlatma
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// dosya yükleme isteği oluştur
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
Sonuç olarak, JPG dosyası Cloud Storage’a yüklenecek ve kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
Java kullanarak JPG Görüntüsüne Metin Filigranı Ekleyin
Aşağıda verilen adımları izleyerek programlı olarak JPEG görüntüsüne bir metin filigranı ekleyebilirsiniz.
- Bir WatermarkApi örneği oluşturun
- FileInfo modelinde JPEG görüntü dosyası yolunu ayarlayın
- WatermarkOptions’ı tanımlayın ve FileInfo’yu ayarlayın
- TextWatermarkOptions’ı tanımla
- Metin, Yazı Tipi Ailesi, Yazı Tipi Boyutu ve Metin Hizalamasını Ayarlama
- Filigran metnini ayarla Ön plan rengi
- Filigran Konumunu tanımla
- WatermarkDetails’i tanımlayın ve TextWatermarkOptions ve Position’ı ayarlayın
- Filigran Ayrıntılarını Listeye Ayarla
- WatermarkOptions ile AddRequest oluşturun
- WatermarkApi.add() yöntemini çağırarak sonuçları alın
Aşağıdaki kod örneği, REST API kullanarak bir görüntüye filigran olarak nasıl metin ekleneceğini gösterir.
// api başlatma
WatermarkApi apiInstance = new WatermarkApi(configuration);
// JPG dosya yolunu ayarla
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// Filigran Seçeneklerini tanımlayın
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// Metin Filigranı Seçeneklerini tanımlayın
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// filigran metin rengini ayarla
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// Filigran Ayrıntılarını tanımlayın
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// Filigran konumunu ayarla
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// filigran ayrıntılarını ayarla
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// filigran ekleme isteği oluştur
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Güncellenen Resmi İndirin
Yukarıdaki kod örnekleri, filigranlı görüntü dosyasını buluta kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:
// api başlatma
FileApi apiInstance = new FileApi(clientId, clientSecret);
// indirme dosyası isteği oluştur
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
REST API kullanarak Görüntülere Görüntü Filigranı Ekleyin
Aşağıda verilen adımları izleyerek programlı olarak JPEG görüntüsüne bir görüntü veya logo filigranı ekleyebilirsiniz.
- Bir WatermarkApi örneği oluşturun
- FileInfo modelinde JPEG görüntü dosyası yolunu ayarlayın
- WatermarkOptions’ı tanımlayın ve FileInfo’yu ayarlayın
- ImageWatermarkOptions’ı tanımlayın
- Bir PNG görüntüsünün FilePath’ini filigran olarak ayarlayın
- Filigran Konumunu tanımla
- WatermarkDetails’i tanımlayın ve ImageWatermarkOptions ve Position’ı ayarlayın
- Filigran Ayrıntılarını Listeye Ayarla
- WatermarkOptions ile AddRequest oluşturun
- WatermarkApi.add() yöntemini çağırarak sonuçları alın
Aşağıdaki kod örneği, REST API kullanarak bir görüntünün bir JPEG görüntüsüne filigran olarak nasıl ekleneceğini gösterir. Dosyaları yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.
// api başlatma
WatermarkApi apiInstance = new WatermarkApi(configuration);
// JPG dosya yolunu ayarla
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// Filigran Seçeneklerini tanımlayın
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// Filigran Ayrıntılarını tanımlayın
WatermarkDetails watermarkDetails = new WatermarkDetails();
// Filigran Görüntüsü Seçeneklerini tanımlayın
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// Filigran konumunu ayarla
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// Görüntü Filigranı Seçeneklerini ayarlayın
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// İstek Ekle oluştur
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Çevrimiçi Deneyin
Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi Filigran aracını deneyin. https://products.groupdocs.app/watermark/jpeg
Çözüm
Sonuç olarak, bulutta bir JPEG görüntüsüne nasıl metin veya görüntü filigranı ekleyeceğinizi öğrendiniz. Görüntü dosyalarını programlı olarak buluta nasıl yükleyeceğinizi ve ardından bunları buluttan nasıl indireceğinizi de öğrendiniz. Belgelerden GroupDocs.Watermark Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşim kurmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda destek ile iletişime geçmekten çekinmeyin.