Filigran, çeşitli amaçlarla belgelerde görüntülemek için kullanılan üst üste bindirilmiş bir görüntü veya metindir. Bazen eklenen filigranı yeni bir metin veya resimle değiştirmeniz veya düzenlemeniz gerekebilir. Bu makale, bir REST API kullanarak filigran metninin veya resimlerinin nasıl bulunup değiştirileceğine odaklanacaktır.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Filigran REST API ve .NET SDK
- REST API kullanarak Metin Filigranını Bulun ve Değiştirin
- REST API kullanarak Filigran Görüntüsünü Bulun ve Değiştirin
Filigran REST API ve .NET SDK
Filigranı aramak ve değiştirmek için .NET SDK of GroupDocs.Watermark Cloud API’sini kullanacağım. Desteklenen biçimlerdeki resimlerden ve belgelerden programlı olarak filigran eklemenize, kaldırmanıza, aramanıza ve değiştirmenize olanak tanır. Şu anda, Cloud API için Java SDK da sağlamaktadır.
.NET için GroupDocs.Watermark Cloud SDK, aşağıda gösterildiği gibi NuGet Paket yöneticisinden Visual Studio projenize yüklenebilir:
NuGet Paketini, Paket Yöneticisi konsolunda aşağıdaki komutu kullanarak da kurabilirsiniz:
Install-Package GroupDocs.Watermark-Cloud
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 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);
REST API kullanarak Metin Filigranını Bulun ve Değiştirin
Aşağıda belirtilen basit adımları izleyerek PDF belgelerinizdeki filigran metnini bulabilir ve değiştirebilirsiniz:
- Yüklemekthe PDF document to the Cloud
- Metin Filigranını Bul ve Değiştir yüklenen PDF dosyasından
- İndirmekthe updated file
PDF Belgesini Yükle
Öncelikle filigranı içeren PDF belgesini aşağıdaki yöntemlerden birini kullanarak Buluta yükleyin:
- Gösterge tablosunu kullanma
- Dosyayı tarayıcıdan Upload File API kullanarak yükleyin
- Aşağıda verilen kod örneğini kullanarak programlı olarak yükleyin:
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();
}
Sonuç olarak, PDF dosyası Cloud Storage’a yüklenecek ve kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
Metin Filigranı Bul ve Değiştir
Aşağıdaki kod parçacığı, bir REST API kullanarak yüklenen bir PDF dosyasından bir metin filigranının nasıl bulunacağını ve değiştirileceğini gösterir.
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;
}
Aşağıdaki kod örneğini kullanarak filigran metni için yazı tipi, metin boyutu, ön plan ve arka plan renklerini de ayarlayabilirsiniz:
ReplaceTextOptions = new ReplaceTextOptions
{
Text = "Confidential",
FontFamily = "Arial",
Size = 20d,
ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}
Güncellenmiş Dosyayı İndirin
Yukarıdaki kod örnekleri, PDF dosyasını bulutta yeni bir filigran metni veya görüntüsü ile kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:
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);
}
REST API kullanarak Filigran Görüntüsünü Bulun ve Değiştirin
Aşağıda verilen basit kod örneği, bir REST API kullanarak filigran görüntüsünün nasıl bulunacağını ve değiştirileceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.
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;
}
Çözüm
Sonuç olarak, C# kullanarak .NET Watermark REST API ile buluttaki bir PDF belgesindeki metin veya görüntü filigranını nasıl arayacağınızı ve değiştireceğinizi öğrendiniz. Ayrıca, dosyaları programlı olarak buluta nasıl yükleyeceğinizi ve ardından buluttan nasıl indireceğinizi de öğrendiniz. Ayrıca, GroupDocs.Watermark Cloud API’nin diğer çeşitli kullanışlı özelliklerini belgelerden öğrenebilirsiniz. Herhangi bir belirsizlik durumunda, destek ile iletişime geçmekten çekinmeyin.