TÜRKÇE BRAILLE SEÇİM DENETLEYİCİSİ 0.7.0 — Windows 64 bit

Başlatma: Bu klasördeki BrailleDenetleyici.exe dosyasını açın.
Python kurulması gerekmez. analyzer klasörünü EXE'nin yanından ayırmayın.
.NET Framework 4.5 veya üstü gerekir (Windows 10/11'de bulunur).

DOSYA DENETİMİ
Dosya incele (Alt+V): SVG, PDF, PNG, JPEG, STL ve temel 3MF.
PDF sayfasını seçebilir; 3D için kesit Z yüksekliği ve tasarım nokta çapını
girebilirsiniz. Ayrıntılar, destek sınırları ve örnekler DOSYA-KULLANIM.txt
içindedir. Dosya sonucu önce özette okunur; Alt+T ile tabloya geçilir.

SEÇİLİ METİN
1. Word veya editörde incelemek istediğiniz metni seçin.
2. Denetleyiciye geçin. Açık editör penceresi listesinden belgeyi seçin.
   Gerekirse Pencereleri yenile düğmesini kullanın.
3. Seçili metni incele düğmesine basın (Alt+S).
4. Sonuçtan sonra etkin alan doğrudan karşılık tablosunun ilk hücresidir.
   Alt+T tabloya döner; Alt+R ayrı salt okunur metin raporuna gider.
   Yukarı/aşağı ok satırı, sağ/sol ok sütunu değiştirir.
   Tab tablodan çıkar. Üç sütun: Kaynak, Braille (nokta dizisi), Braille ASCII.
   Kaynak karakter başına bir satır vardır. Birden fazla hücre üreten kaynak
   karakter tekrarlanmaz; hücreler sütun içinde dikey çizgiyle ayrılır.
   Ligatürde birden çok kaynak karakter aynı satırda bulunabilir.
5. Seçili satırı seslendir düğmesi Windows'un yüklü konuşma sesini kullanır.
   Satırdaki her hücrenin numarasını, noktalarını ve ASCII adını ayrı okur.
   Türkçe ses yüklü değilse telaffuz farklı olabilir. Sesi durdur düğmesi vardır.
   Ekran okuyucunuz ayrıca standart Windows denetimlerini okuyabilir.

Örnek: ş → noktalar 1, 4, 6 → Braille ASCII yüzde işareti (%).
Buradaki % kaynak metindeki ş'nin ASCII kodu değildir; aynı Braille hücresinin
altı noktalı BRF gösterimidir. Ş karakteri belgede ş olarak kalır.
7 veya 8. nokta bulunan hücreye altı noktalı ASCII karşılığı uydurulmaz.

DOĞRULAMANIN ANLAMI
Word'de seçilen pencereye doğrudan bağlanılır. Diğer editörlerde Windows
UI Automation kullanılır. Seçimle beraber paragraf bağlamı okunur; örneğin
12345'in yalnız 3'ünü seçmek yeni rakam işareti eklemez.
Belgenin metni, fontu veya kaydı değiştirilmez. Bazı eski RichEdit erişilebilirlik
sağlayıcıları font okurken imleci oynatır; program özgün seçimi geri korur.
Seçim internete gönderilmez, panoya otomatik erişilmez, dosyaya kaydedilmez.

Bizim Metin, Matematik ve Kod ailelerimiz desteklenir. Windows'un yüklediği
fontun verisi doğrudan okunup özeti paket fontuyla karşılaştırılır. Bu veri
alınamazsa kurulum dosyası kontrol edilir. Eski sürümse güncelleme istenir.
Sonuç, HarfBuzz'un paket TTF'sinden hesapladığı hücrelerdir. Editörün gerçekten
çizdiği pikselleri veya baskı noktalarını ölçmez. Editör eski fontu önbellekte
tutuyorsa yeniden açılmalıdır. PDF/PIAF son çıktı doğrulamasının yerini tutmaz.
Unicode Braille (U+2800–U+28FF) doğrudan hücre olarak okunur; özel fontun
bu Unicode karakterlerini farklı çizip çizmediği kontrol edilmez.

İLK SÜRÜM SINIRLARI
- Word seçimi ve standart Windows RichTextBox sağlayıcısı sınandı.
  Not Defteri'nin bütün sürümleri ve diğer editörler tek tek sınanmadı.
  Editör seçimi/font bilgisini sunmazsa açık hata verilir.
- Paragraf bağlamı tek fontlu olmalıdır; karışık fontlu bağlam desteklenmez.
- Seçim ve bağlam toplamı en fazla 10.000 karakterdir; 20 saniyelik zaman
  sınırı vardır. Parola alanları atlanır. Yönetici olarak açılmış editörlere
  normal yetkili program erişemeyebilir.
- Eski BrailleTeknikTurkce, Yusuf'un fontu ve bilinmeyen başka fontlar henüz
  otomatik çözümlenmez. Bunların hücreleri bizim fontumuza göre tahmin edilmez.
- Kalın/italik gibi yapay biçimlendirme ve fiziksel nokta ölçüsü incelenmez.
- Gerçek NVDA/JAWS oturumu, Türkçe ses kalitesi ve macOS sürümü sınanmadı.

ELLE YAPIŞTIRMA
Seçim alınamazsa metni kendiniz kopyalayıp isteğe bağlı metin alanına
yapıştırabilir, yorumlama biçimini seçip Yapıştırılanı önizle'ye basabilirsiniz.
Bu kip, seçtiğiniz paket fontuyla bir önizlemedir; kaynak editörün fontunu
doğruladığı anlamına gelmez. Bağlamın kaybolmaması için bütün sözcük/sayıyı alın.

PAYLAŞMA
BrailleDenetleyici klasörünü tüm alt klasörleriyle birlikte paylaşın veya
TurkceBraille-TamPaket-v0.7.0.zip dosyasını verin. Tek EXE yeterli değildir.
Yalnız font isteyen kişiye DogrudanFontlar/TurkceBrailleMetin-Regular.ttf yeter.

Teknik kaynaklar:
https://learn.microsoft.com/en-us/dotnet/framework/ui-automation/ui-automation-textpattern-overview
https://raw.githubusercontent.com/liblouis/liblouis/master/tables/en-us-brf.dis
