C# ile PDF'lere Metin ve Bitmap Çizme

Koordinat Sistemini Anlamak

Metin çizmeden önce, PDF koordinat sistemini anlayın. Orijin (0,0), sayfanın sol alt köşesinde bulunur; X değerleri sağa doğru, Y değerleri ise 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?

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

ZapfDingbats yazı tipi ▲ gibi sembolleri gösterebilir. Desteklenen sembollerinin kapsamlı bir listesi için Zapf Dingbats üzerine Wikipedia'yı ziyaret edin.

PDF üzerinde yazı tipi örneği

Metni Satır Sonlarıyla Nasıl Ekleyebilirim?

Metin çizme eylemi, satır sonu karakterlerini destekler ve metni daha iyi biçimlendirme ve görsel netlik için yerleşik satır sonları ile oluşturmanıza olanak tanır. Bu, çok satırlı açıklama eklerken veya yapılandırılmış metin düzenleri oluştururken kullanışlıdır.

Bunu sağlamak için metin dizesine 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 DrawText yöntemi ile desteklenir ve tipografi seçeneklerinizi standart yazı tiplerinin ötesine taşır. Bu özellik, marka tutarlılığını korurken veya özel fontlarla çalışırken gereklidir. Gelişmiş yazı tipi yönetimi için PDF'lerde yazı tiplerini yönetme rehberimize bakın.

Aşağıda, metin için eklenen Pixelify Sans Fontu 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ı dikkate alın:

• Sayfa Boyutları: Sayfa boyutlarını almak için pdf.Pages[pageIndex].Width ve pdf.Pages[pageIndex].Height kullanın
• Döndürme: Döndürme parametresi, açılı metin için derece (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 bitmap eklemenizi sağlar. Bu yöntem, mevcut PDF dosyalarına resim damgalamanıza olanak sağlayan Image Stamper özelliğine benzer şekilde çalışır. Karmaşık görüntü işleme ihtiyaçlarınız için PDF'lere görsel ekleme kılavuzumuzu inceleyin.

Ö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

Hangi Ek Parametreler Mevcuttur?

• PixelFormat: PixelFormat özelliği, bitmap için renk veri biçimini belirtir ve öncelikle saydamlı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'lerdeki arka plan ve ön plan öğeleriyle çalışırken faydalıdır.

• IgnorePageRotation: Bu bool özelliği, yöntemin bitmap çizilirken sayfa döndürmeyi göz ardı edip etmeyeceğini belirler. Varsayılan olarak, değer false'dur. Dönüşten bağımsız olarak tüm sayfalara tutarlı bir şekilde filigran uygularken özellikle faydalıdır.

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

PDF'ler üzerine metin ve görüntü çizerken, bu pratik uygulamaları göz önünde bulundurun:

1. Dinamik Filigranlama: Şirket logoları veya "GİZLİ" damgaları ekleyerek hassas belgeleri işaretleyin
2. Sayfa Numaralandırma: Tüm sayfalarda tutarlı konumlarda sayfa numaraları yerleştirin.
3. İmza Yerleştirme: Formlarda belirlenen yerlere imza görselleri ekleyin
4. Başlık/Altbilgi Geliştirmesi: Mevcut başlıkları dinamik içerikle tamamlayın

PDF işlemlerini hata ayıklama ve izleme için, çizim işlemlerini izlemek ve doğru yürütülmesini sağlamak amacıyla özel kaydetme uygulayın.

Performans Hususları

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

• Bellek kullanımını en aza indirmek için mümkün olduğunda toplu işlemler yapın
• Bitmap nesnelerini kullandıktan sonra serbest bırakarak kaynakları boşaltın
• Sık kullanılan görselleri ön yüklemeyi düşünün, performansı artırmak için

Başka neler yapabileceğinizi görmek için hazır mısınız? Öğretici sayfamıza buradan göz atın: PDF Düzenle