C# Kullanarak PDF'lerde Metin ve Bitmap Çizme

Koordinat Sistemi Anlayışı

Metni çizmeden önce PDF koordinat sistemini anlayın. Köken (0,0) sayfanın sol alt köşesinde yer alır, X değerleri sağa, Y değerleri yukarı doğru artar. Bu, kökenin sol üstte olduğu birçok grafik sisteminden farklıdır.

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-text.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 100, Color.Black, Rotation: 0);

pdf.SaveAs("drawText.pdf");

Imports IronPdf
Imports IronSoftware.Drawing

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize:=12, PageIndex:=0, X:=100, Y:=100, Color.Black, Rotation:=0)

pdf.SaveAs("drawText.pdf")

Hangi Yazı Tiplerini Kullanabilirim?

Şu anda DrawText yöntemi, IronPDF'deki Standart Yazı Tiplerini , Courier, Arial (veya Helvetica), TimesNewRoman, Symbol ve ZapfDingbats dahil olmak üzere destekler. Bu yazı tipi türlerinin italik, kalın ve eğik varyantları için Yazı Tiplerini Yönetme makalesinde 'IronPDF'teki Standart Yazı Tipleri' bölümünü ziyaret edin.

ZapfDingbats yazı tipi, ▲ gibi sembolleri gösterebilir. Desteklenen sembollerin kapsamlı bir listesi için Wikipedia'da Zapf Dingbats sayfasını ziyaret edin.

PDF'de Çıkış Yazı Tipi Örneği

Satır Sonlarıyla Metin Nasıl Eklerim?

Metin çizim eylemi, daha iyi biçimlendirme ve görsel açıklık sağlamak için yerleşik yeni satırlar içeren metin oluşturmanıza imkan tanır. Bu, çok satırlı açıklamalar eklerken veya yapılandırılmış metin düzenleri oluştururken kullanışlıdır.

Bunu başarmak için metin dizgesine newline characters (\n) ekleyin. Yukarıdaki örneği kullanarak:

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

' Multi-line text example with proper spacing
Dim textWithNewlines As String = "Some text" & vbLf & "Second line" & vbLf & "Third line with more content"
pdfDoc.DrawText(textWithNewlines, font, position)

' You can also use Environment.NewLine for platform-specific line breaks
Dim platformText As String = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3"
pdfDoc.DrawText(platformText, font, position)

Özel Yazı Tiplerini Nasıl Kullanırım?

Özel yazı tipleri, standart yazı tiplerinin ötesinde tipografi seçeneklerinizi genişleten DrawText yöntemi ile desteklenir. Bu özellik, marka tutarlılığını sağlamak veya özel yazı tipleriyle çalışmak için gereklidir. Gelişmiş yazı tipi yönetimi için, PDF'lerde yazı tipi yönetimi rehberimize bakın.

Aşağıda, metin için eklenmiş Pixelify Sans Yazı Tipi ile bir örnek bulunmaktadır:

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-custom-font.cs

using IronPdf;
using IronSoftware.Drawing;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Add custom font to the PDF
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var addedFont = pdf.Fonts.Add(fontByte);

// Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 600, Color.Black, Rotation: 0);

pdf.SaveAs("drawCustomFont.pdf");

Imports IronPdf
Imports IronSoftware.Drawing
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Add custom font to the PDF
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private addedFont = pdf.Fonts.Add(fontByte)

' Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize:= 12, PageIndex:= 0, X:= 100, Y:= 600, Color.Black, Rotation:= 0)

pdf.SaveAs("drawCustomFont.pdf")

Gelişmiş Metin Konumlandırma

Metni tam olarak konumlandırırken bu ipuçlarını göz önünde bulundurun:

• Sayfa Boyutları: Sayfa boyutlarını almak için pdf.Pages[pageIndex].Width ve pdf.Pages[pageIndex].Height kullanın
• Dönüş: Dönme parametresi açılı metin için dereceleri (0-360) kabul eder
• Renk Seçenekleri: Temel renklerin ötesinde, RGB değerlerini kullanın: Color.FromArgb(255, 100, 100)

IronPDF'nin DrawBitmap yöntemi, mevcut PDF belgelerine bitmapler eklemenizi sağlar. Bu yöntem, mevcut PDF'lere resim damgalamanıza olanak tanıyan Resim Damgacısı özelliğine benzer şekilde çalışır. Karmaşık resim işleme ihtiyaçları için, PDF'lere resim ekleme rehberimize bakın.

Örnek resim

Uygulama Nasıl Görünür?

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-bitmap.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Open the image from file
AnyBitmap bitmap = AnyBitmap.FromFile("ironSoftware.png");

// Draw the bitmp on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300);

pdf.SaveAs("drawImage.pdf");

Imports IronPdf
Imports IronSoftware.Drawing

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Open the image from file
Dim bitmap As AnyBitmap = AnyBitmap.FromFile("ironSoftware.png")

' Draw the bitmap on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300)

pdf.SaveAs("drawImage.pdf")

Çıktı PDF

Başka Hangi Parametreler Mevcut?

• Piksel Formatı: PixelFormat özelliği, bitmap için renk veri formatını belirtir, öncelikle şeffaflık desteğini kontrol eder. Varsayılan değer Format32bppArgb'dir. Parametreyi bir seçenek olarak geçirerek Format32bppRgb ve Format32bppArgb piksel enum formatları arasında seçim yapın. Bu, PDF'lerde arka plan ve ön plan öğeleriyle çalışırken kullanışlı olur.

• Sayfa Döndürmesini Yok Sayma: Bu bool özelliği, bitmap çizerken yöntemin sayfa döndürmesini görmezden gelip gelmeyeceğini belirler. Varsayılan olarak değer false'dur. Özellikle döndürmeye bakılmaksızın tüm sayfalara su işareti uygulandığında kullanışlıdır.

Yaygın Kullanım Durumları ve En İyi Uygulamalar

PDF'lerde metin ve resimler çizerken, şu pratik uygulamaları düşünün:

1. Dinamik Su İşaretleme: Şirket logoları veya "GİZLİ" damgaları hassas belgeler ekleyin
2. Sayfa Numaralandırma: Tüm sayfalarda tutarlı konumlarda sayfa numaraları çizin
3. İmza Yerleştirme: Formlar üzerinde belirlenmiş konumlara imza resimleri ekleyin
4. Üstbilgi/Altbilgi Geliştirme: Mevcut başlıkları dinamik içerik ile tamamlayın

Hata ayıklama ve PDF işlemlerinin izlenmesi için, çizim işlemlerini takip etmek ve doğru yürütmeyi sağlamak üzere özel kaydetme uygulayın.

Performans Dikkatleri

Birden çok sayfa veya büyük belgelerle çalışırken:

• Hafıza kullanımını en aza indirmek için mümkün olduğunda toplu işlemler yapın
• Kullanımdan sonra bitmap nesnelerini atarak kaynakları serbest bırakın
• Performansı artırmak için sık kullanılan resimleri önceden yüklemeyi düşünün

Başka neler yapabileceğinizi görmek için hazır mısınız? Eğitim sayfamızı burada inceleyin: PDF'leri Düzenle