Görüntü Ekleme - Dinamik Görüntü Kılavuzu

PDF4me Oluşturulan belgelere dinamik görüntü ekleme olanağı sunarak, şablonları veri kaynaklarınızdan logolar, fotoğraflar, grafikler, diyagramlar ve diğer görsel içeriklerle doldurmanıza olanak tanır. Görüntüler herkese açık olarak sağlanabilir. URLs veya Base64-kodlanmış dizeler.

---

Görüntü Sözdizimi Gereksinimleri

The image syntax must be placed inside a Text Box in Word for proper image population. Create a text box at the desired location in your template before adding image merge fields.

---

Görüntü Ekleme Yöntemleri

PDF4me Şablonlara görüntü verisi sağlamak için iki yöntem desteklenmektedir:

Yöntem 1: Kamuoyu İmajı URL

Herkese açık görsel kullanın. URLs Web kaynaklarından resim eklemek.

Sözdizimi:

<<image [imageUrl]>>

Veri Örneği:

{
  "imageUrl": "https://public-url/image.png"
}

Kullanım Örnekleri:

• Şirket logoları halka açık sunucularda barındırılıyor.
• E-ticaret platformlarından alınan ürün görselleri
• Çevrimiçi olarak oluşturulan ve barındırılan grafikler ve çizelgeler.
• Herkese açık kaynak görselleri

---

Yöntem 2: Base64 Kodlanmış Görüntüler

Görselleri eklemek için Base64-Görüntü dosyasının kodlanmış dize gösterimi.

Sözdizimi:

<<image [imageBase64]>>

Veri Örneği:

{
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+KAAAACXBIWXMAABcSAAAXEgFnn9JSAACU6ElEQVR4nOz953tjR5bn+34jtoMn6D2ZSaaRL5lSmR5z5t5/+9xzZqZ7qktSeksmvfcG3mzsveO+2ACVUklKUspMksj1eZ7qqpZECCCZ+CEiVqyljDEGIYQQQlxr+rKfgBBCCCH+OAl0IYQQogtIoAshhBBdQAJdCCGE6AIS6EIIIUQXkEAXQggh..."
}

Avantajlar:

• İnternet bağlantısı olmadan da çalışır.
• Güvenli - harici bağımlılık yok
• Görüntü verileri üzerinde tam kontrol
• Hassas belgeler için uygundur.

---

Görüntü Biçimlendirme Seçenekleri

Biçimlendirme seçeneklerini kullanarak resimlerin metin kutularına nasıl sığacağını kontrol edin. Bu seçenekler, resim boyutlandırmasını ve en boy oranı davranışını belirler.

En Boy Oranını Koruyun

Sözdizimi: <<image [imageUrl] -keepRatio>>

Davranış:

• Metin kutusunun boyutunu korur.
• Görüntüyü metin kutusunun sınırları içine sığacak şekilde ölçeklendirir.
• Orijinal görüntü en boy oranını korur.
• Oranlar farklıysa, resim metin kutusunun tamamını kaplamayabilir.

En İyi Kullanım Alanı: Bozulmanın önlenmesi gereken logolar, simgeler ve görseller.

---

Uygun Boy

Sözdizimi: <<image [imageUrl] -fitHeight>>

Davranış:

• Metin kutusunun genişliğini korur.
• Metin kutusunun yüksekliğini, resmin en boy oranına uyacak şekilde ayarlar.
• Resim metin kutusunu tamamen dolduruyor.
• Metin kutusunun boyutları, görseli sığdırmak için değişiyor.

En İyi Kullanım Alanı: Esnek düzenlerde değişken yükseklikteki resimler

---

Uygun Genişlik

Sözdizimi: <<image [imageUrl] -fitWidth>>

Davranış:

• Metin kutusunun yüksekliğini korur.
• Metin kutusunun genişliğini, resmin en boy oranına uyacak şekilde ayarlar.
• Resim metin kutusunu tamamen dolduruyor.
• Görseli sığdırmak için metin kutusunun genişliği değişiyor.

En İyi Kullanım Alanı: Yatay bannerlar, sabit yüksekliğe sahip başlıklar

---

Uygun Beden

Sözdizimi: <<image [imageUrl] -fitSize>>

Davranış:

• Metin kutusunun boyutlarını resim boyutuna uyacak şekilde değiştirir.
• Orijinal görüntü boyutlarını kullanır.
• Görüntü gerçek boyutunda gösteriliyor.
• Metin kutusu, resmin boyutlarına tam olarak uyacak şekilde yeniden boyutlandırılır.

En İyi Kullanım Alanı: Orijinal görüntü boyutunun tam olarak korunması gerektiğinde

---

Uygun Beden Sınırlı

Sözdizimi: <<image [imageUrl] -fitSizeLim>>

Davranış:

• Metin kutusunun boyutunu resim boyutuna göre ayarlar.
• Orijinal metin kutusu boyutlarını aşmayacaktır.
• Resim daha küçükse metin kutusunu küçültebilirsiniz.
• Metin kutusunun genişlemesini engeller.

En İyi Kullanım Alanı: Maksimum görüntü boyutunu sınırlarken daha küçük görüntülere izin vermek.

---

Biçimlendirme Karşılaştırması

Biçim Seçeneği	Genişlik	Yükseklik	En Boy Oranı	Metin Kutusu Boyutu
-keepRatio	Sabit	Sabit	Korunmuş	Değişmemiş
-fitHeight	Sabit	Değişken	Korunmuş	Yükseklik değişiklikleri
-fitWidth	Değişken	Sabit	Korunmuş	Genişlik değişiklikleri
-fitSize	Değişken	Değişken	Korunmuş	İkisi de değişiyor
-fitSizeLim	Değişken	Değişken	Korunmuş	Kısıtlanmış

---

Pratik Örnekler

Örnek 1: Şirket Logosu

Şablon:

[Create a text box in header]
<<image [companyLogo] -keepRatio>>

Veri:

{
  "companyLogo": "https://company.com/images/logo.png"
}

---

Örnek 2: Ürün Görselleri

Şablon:

<<foreach [product in products]>>
Product: <<[product.name]>>
[Text box:] <<image [product.imageUrl] -fitHeight>>
Price: $<<[product.price]>>

<</foreach>>

Veri:

{
  "products": [
    {
      "name": "Laptop Pro",
      "imageUrl": "https://example.com/laptop.jpg",
      "price": "1299.99"
    },
    {
      "name": "Wireless Mouse",
      "imageUrl": "https://example.com/mouse.jpg",
      "price": "29.99"
    }
  ]
}

---

Örnek 3: İmza Resmi (Base64)

Şablon:

Authorized Signature:
[Text box:] <<image [signatureBase64] -fitSizeLim>>

Name: <<[signatoryName]>>
Date: <<[signatureDate]:"dd.MM.yyyy">>

Veri:

{
  "signatureBase64": "iVBORw0KGgoAAAANSUhEUgA...[truncated]",
  "signatoryName": "John Smith",
  "signatureDate": "2024/01/15"
}

---

Tablolardaki Görüntü

Görsel sunumlarınızı daha düzenli hale getirmek için resim ekleme özelliğini tablo yapılarıyla birleştirin.

Ürün Kataloğu Tablosu

Şablon:

Product | Image | Price
<<foreach [item in catalog]>>
<<[item.name]>> | [Text box: <<image [item.imageUrl] -keepRatio>>] | $<<[item.price]>>
<</foreach>>

---

Koşullu Görüntü Ekleme

Yalnızca görüntü verileri mevcut olduğunda görüntü ekleyin.

İsteğe bağlı Logo Örneği

Şablon:

<<if [logoUrl != null]>>
[Text box:] <<image [logoUrl] -keepRatio>>
<</if>>

Varsayılan Görüntü Yedekleme

Şablon:

<<if [productImage != null]>>
[Text box:] <<image [productImage] -fitHeight>>
<<else>>
[Text box:] <<image [defaultProductImage] -fitHeight>>
<</if>>

---

Belgede Birden Çok Görüntü

Tek bir veri kaynağından birden fazla dinamik görüntü içeren belgeler oluşturun.

Örnek: Grafikler içeren rapor

Şablon:

Sales Report - <<[reportMonth]:"MMMM yyyy">>

Revenue Chart:
[Text box:] <<image [revenueChartUrl] -fitWidth>>

Expense Chart:
[Text box:] <<image [expenseChartUrl] -fitWidth>>

Growth Chart:
[Text box:] <<image [growthChartUrl] -fitWidth>>

---

Görüntü Kalitesiyle İlgili Hususlar

Görüntü için En İyi Uygulamalar URLs

1. Kullanmak HTTPS - Güvenli URLs güvenlik uyarılarını önleyin
2. Kalıcı URLs - Emin olmak URLs erişilebilir kalmak
3. Uygun boyut - Çıktı için uygun boyutta görseller kullanın.
4. Biçim uyumluluğu - Yaygın formatlar: PNG, JPG, GIF
5. CDN barındırma - Güvenilir içerik dağıtım ağları kullanın.

En İyi Uygulamalar için Base64 Görseller

1. Dosya boyutunu optimize edin - Kodlamadan önce görüntüleri sıkıştırın
2. Uygun çözünürlüğü kullanın. - Hedeflenen çıktı çözünürlüğüyle eşleştirin
3. Veri boyutunu dikkate alın. - Büyük Base64 Dizeler, veri yükünün boyutunu artırır.
4. Biçim seçimi - PNG şeffaflık adına, JPG fotoğraflar için
5. Kodlama kalitesi - Uygun olduğundan emin olun. Base64 kodlama

---

Word'de Metin Kutusu Ayarları

Görüntü Yer Tutucuları Oluşturma

1. Metin Kutusu Ekle:

   • Word Şerit → Ekle → Metin Kutusu
   • İstenilen konuma metin kutusu çizin.
   • Metin kutusunun boyutunu, resmin yaklaşık boyutlarına göre ayarlayın.

2. Metin Kutusunu Yapılandır:

   • İstenirse metin kutusu kenarlıklarını kaldırabilirsiniz.
   • Şeffaflık için metin kutusunun dolgusunu "Dolgu Yok" olarak ayarlayın.
   • Metin kaydırma ayarlarını gerektiği gibi yapılandırın.

3. Resim Ekleme Sözdizimi:

   • Metin kutusunun içine tıklayın.
   • Görüntü birleştirme alanı sözdizimini yazın
   • Uygun biçimlendirme seçeneğini ekleyin.

---

Görüntü Ekleme Sorun Giderme

Sık Karşılaşılan Sorunlar

Sorun: Görüntü oluşturulan belgede görünmüyor.
Çözüm: Resim sözdiziminin normal bir paragraf değil, metin kutusu içinde olduğundan emin olun.

Sorun: Görüntü bozuk görünüyor.
Çözüm: Kullanmak -keepRatio en boy oranını korumak için

Sorun: Resim çok büyük veya çok küçük
Çözüm: Metin kutusunun boyutunu ayarlayın veya uygun sığdırma seçeneğini kullanın.

Sorun: Base64 Resim yüklenemedi.
Çözüm: Doğrulamak Base64 Kodlama tamamlandı ve geçerli.

Sorun: URL Resim yüklenmiyor
Çözüm: Kontrol etmek URL erişilebilirliği sağlamak HTTPSGörüntü formatını doğrulayın.

Sorun: Görüntü konumu yanlış
Çözüm: Word şablonunda metin kutusunu yeniden konumlandırın

---

Gelişmiş Görüntüleme Teknikleri

Duyarlı Görüntü Boyutlandırma

Farklı boyutlarda görüntülenebilecek belgeler için:

[Large text box:] <<image [headerImage] -fitSizeLim>>

Bu, gerekirse görüntünün küçülmesine olanak tanır ancak metin kutusunun sınırlarının ötesine genişlemesini engeller.

Resim ve alt yazı

Şablon:

[Text box:] <<image [chartUrl] -fitWidth>>

Figure <<[$index + 1]>>: <<[chartTitle]>>
Source: <<[chartSource]>>

Koşullu Görüntü Biçimlendirme

Veri özelliklerine göre biçimlendirme seçin:

<<if [imageOrientation == "landscape"]>>
[Wide text box:] <<image [imageUrl] -fitWidth>>
<<else>>
[Tall text box:] <<image [imageUrl] -fitHeight>>
<</if>>

---

Örnek: Ürün Bilgi Formu

Şablon:

<<[productName]:caps>>

Product Image:
[Text box 300x300:] <<image [productImageUrl] -keepRatio>>

Specifications:
• Model: <<[modelNumber]>>
• Category: <<[category]>>
• Price: $<<[price]:"F2">>

Additional Images:
<<foreach [img in additionalImages]>>
[Text box 150x150:] <<image [img.url] -keepRatio>>
<<[img.caption]>>
<</foreach>>

Company Logo:
[Text box 200x60:] <<image [companyLogoBase64] -fitHeight>>

---

:::İpucu Görüntü Optimizasyonu En iyi sonuçlar için, görüntüleri veri kaynağınıza dahil etmeden önce optimize edin. Görüntüleri uygun boyutlara yeniden boyutlandırın ve dosya boyutunu küçültürken kaliteyi korumak için sıkıştırın.

:::

:::Uyarı Metin Kutusu Gereksinimi Resimler, Word şablonlarında mutlaka metin kutularının içine yerleştirilmelidir. Normal paragraflardaki resim sözdizimi, resimleri doğru şekilde görüntülemez. Her dinamik resim konumu için her zaman bir metin kutusu yer tutucusu oluşturun.

:::