DOSYA DENETİMİ — 0.7.0, 9 Kasım 2026

Destek: SVG; PDF'nin seçilen sayfası; PNG, JPG/JPEG; ikili ve metin STL;
temel 3MF çekirdek mesh/bileşen modeli. Fontlar 0.5.0 olarak kalır.
Bu araç nokta düzenini denetler; fiziksel kabartmanın veya tüm 3D modelin
basılabilirlik/standart uygunluk onayı değildir.

ORTAK KULLANIM
1. İstersen beklenen metni gir (örneğin XC234y) ve Metin profilini seç.
2. PDF için sayfa numarasını; 3D için aşağıdaki Z/çap alanlarını doldur.
3. Dosya incele düğmesi veya Alt+V ile dosyayı seç.
4. Sonuç özeti EŞLEŞİYOR/EŞLEŞMİYOR veya referans verilmedi bilgisini verir.
   PDF özetinde sayfa, 3D özetinde kesit Z yüksekliği ayrıca yazılır.
5. Alt+T: hücre tablosu. Sağ/sol ok: sütun. Yukarı/aşağı ok: hücre.
   Alt+R: ayrıntılı rapor. Seçili satırı seslendir: nokta ve ASCII karşılığı.

PNG / JPEG / PDF
- Açık zemin üzerindeki koyu, dolu daire noktaları gerekir. Logo, normal yazı,
  çerçeve ve gölge nokta içermeyen Braille alanını ayrı dışa aktarın/kırpın.
- Nokta çapı görüntüde en az 12 piksel olmalı. PNG tercih edilir; yüksek
  kaliteli JPEG desteklenir. Perspektifli/eğik ve gölgeli fiziksel kabartma
  fotoğrafları için güvenilir tanıma sağlanmaz; temiz çizim dışa aktarımı kullanın.
- PDF yazı metninden çevrilmez; seçilen sayfa PDFium ile görüntülenerek okunur.
  Yalnız seçilen sayfa denetlenir. Çok sayfalı PDF'nin kalan sayfaları için
  sayfa numarasını değiştirip dosyayı yeniden açın. Şifreli PDF desteği yoktur.
- Piksel eşiği 128'dir. 1–2 piksellik koyu gürültü bileşenleri göz ardı edilir
  ve raporda sayısı verilir. Kenarda kesilen, içi boş, daire olmayan veya
  belirgin farklı boydaki şekiller reddedilir. Geometrik tolerans vardır.
- En fazla 16 milyon piksel. PDF en çok 300 dpi ile bu sınıra sığdırılır.
  Noktalar bu nedenle küçülürse yalnız Braille alanını ayrı sayfa olarak alın.

STL / 3MF — SEÇİLEBİLİR YATAY KESİT
Arkadaşından modelin zemin üst yüzeyi yüksekliğini, nokta tepe yüksekliğini
ve tasarım nokta çapını öğren. Modelde noktalar XY düzlemi üzerinde ve +Z'ye
doğru kabarmalı; yazı +Z yönünden bakıldığında okunmalı (+X sağ, +Y yukarı).

Örnek: zemin üstü Z=1, nokta tepeleri Z=1.6 ise kesit Z=1.3 seç.
Tasarım nokta çapı 1.5 ise çap alanına 1.5 yaz. Bunlar paket örneğinin
değerleridir; arkadaşının modeline otomatik uygulanmamalıdır.
Z kesitini yatay yüzeyin tam üzerine koyma; arada noktaları kesen değer seç.

- STL ölçü birimi bildirmez. Z ve çap, o dosyanın tasarım biriminde girilir.
  Model mm ile hazırlanmışsa mm kullan; inç dosyasına mm değeri girme.
- 3MF ölçü birimi mm'ye dönüştürülür; Z ve çap alanları mm'dir.
- Yalnız o yükseklikteki kapalı dairesel kesitlerin merkezleri okunur.
  Nokta tepeleri, taban çapı, diğer yükseklikler, boşluklar, alt yüzey ve tüm
  mesh topolojisi doğrulanmaz. Bir kesitin eşleşmesi, tüm modelin doğru olduğu
  anlamına gelmez. Gerekirse birkaç ayrı yükseklikte kontrol et.
- Çap alanı ızgara ölçeği için tasarım referansıdır; kesitte ölçülen çap değildir.
  Yarım küre noktada kesit çapı taban çapından küçük olabilir.
- Zemin/logonun kesiti, açık veya çakışan konturlar, farklı boydaki noktalar
  reddedilir. Yatay olmayan yüzeye sarılmış Braille bu sürümde desteklenmez.
- STL: ikili ve metin. 3MF: build öğeleri, bileşenler, dönüşümler ve birimler.
  Uzantılı/dilimleyici proje 3MF'leri reddedilebilir. Bu durumda dilimleyiciden
  yalnız geometriyi temel 3MF veya STL olarak dışa aktarın. G-code, OBJ, AMF,
  STEP, dilimlenmiş takım yolları ve yazıcıya özgü proje formatları desteklenmez.
- En fazla 250.000 üçgen. 3MF açılmış toplam veri en fazla 100 MB'dır.

ORTAK SINIRLAR
Izgara bizim altı noktalı fontun oranlarını esas alır: nokta çapı 150,
hücre içi aralık 250, hücre ilerlemesi 600, satır ilerlemesi 1000.
Rasterde ölçek merkezlerden yaklaşık belirlenir; 3D'de girilen tasarım çapı
kullanılır. Farklı aralık oranları veya çok satırda farklı satır aralığı
reddedilebilir. Boş başlangıç/bitiş hücreleri ve kaynak harfler geri çıkarılmaz.
Seyrek noktalar birden fazla hizaya uyarsa tahmin yapılmaz. Referans metinle
hizalama seçilirse bunun bağımsız doğrulama olmadığı açıkça belirtilir.
Dosyalar değiştirilmez veya internete gönderilmez; dış başvurular indirilmez.
Dosya boyutu en fazla 40 MB (SVG için ayrıca 5 MB); en fazla 10.000 nokta.
Yardımcı işlem 20 saniyede yanıt vermezse sonlandırılır; daha küçük alan/model kullan.

PAKET ÖRNEKLERİ
Ornekler/PNR.png, PNR.jpg, PNR.pdf, PNR.stl, PNR.3mf aynı XC234y metnidir:
9 hücre, 24 nokta. PDF sayfa 1; STL/3MF Z=1.3, çap=1.5.
Örnek 3D model zemin ve silindirlerden oluşan test geometrisidir; fiziksel
kabartma veya baskıya hazır ürün önerisi değildir.

Arkadaşının gerçek tasarım/dilimleyici dosyaları ve fiziksel baskı henüz
sınanmadı. Destek, tanımlı test dosyalarıyla doğrulandı; her dosyaya garanti yoktur.
SVG'nin ayrıntılı koşulları SVG-KULLANIM.txt içinde ayrıca açıklanır.

Kaynaklar:
PDFium: https://pypdfium2.readthedocs.io/en/stable/python_api.html
3MF: https://github.com/3MFConsortium/spec_core/blob/master/3MF%20Core%20Specification.md
