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, Courier, Arial (veya Helvetica), TimesNewRoman, Symbol ve ZapfDingbats dahil olmak üzere IronPDF'deki Standart Yazı Tiplerini şu anda 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 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şleterek DrawText yöntemiyle desteklenmektedir. 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)

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

IronPDF'nin DrawBitmap yöntemi, mevcut PDF belgelerine bitmapler 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.

The DrawBitmap yöntemi, büyük resimlerle en iyi şekilde çalışır. Küçük çözünürlüklü görüntüler kullandığınızda, aşağıdaki istisnayla karşılaşabilirsiniz: IronPdf.Exceptions.IronPdfNativeException: 'Görüntü çizerken hata: veri uzunluğu (567000) beklenenden daha az (756000)'. Bu sorunu aşmak için, tüm boyutlardaki görüntüleri işleyen Image Stamper'ı kullanı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

Hangi Ek Parametreler Mevcuttur?

• PixelFormat: PixelFormat özelliği, bitmap için renk veri formatını belirtir ve öncelikli olarak şeffaflık desteğini kontrol eder. Varsayılan değer Format32bppArgb. Parametreyi bir seçenek olarak ileterek piksel enum formatları Format32bppRgb ve Format32bppArgb 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, bitmap çizerken yöntemin sayfa dönüşünü göz ardı edip etmediğini belirler. Varsayılan olarak, değer yanlıştır. 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