Türkçe | English version

SDLPainter — Özellik Listesi

Bu sayfa içerisinde SDLPainter kütüphanesine yönelik önce çıkan özellikler listelenecektir.

Çizim Primitifleri

Çizgi (DrawLine)
Dikdörtgen — stroke ve fill (DrawRect / FillRect)
Yuvarlatılmış dikdörtgen — stroke ve fill (DrawRoundedRect / FillRoundedRect)
Daire — stroke ve fill (DrawCircle / FillCircle)
Elips — stroke ve fill (DrawEllipse / FillEllipse)
Yay (DrawArc), dilim (DrawPie / FillPie), kiriş (DrawChord / FillChord) — açı birimi derece, 0° = +x
Çokgen — stroke ve fill (DrawPolygon / FillPolygon)
Polyline (DrawPolyline)

Görsel Stiller

Pen: renk + kalınlık (geometry-based quad; glLineWidth kullanılmıyor), kesik deseni (SetDashPattern), uç stili (butt/square/round), birleşim stili (miter/bevel/round — miter sınırı aşılınca kendiliğinden bevel'a düşer)
Brush: düz dolgu rengi veya iki uçlu doğrusal/ışınsal gradient. Gradient shader gerektirmez: geçiş köşe renklerine yazılır, enterpolasyonu donanım yapar — bu yüzden batch'i kırmaz, ama hassasiyeti şeklin köşe yoğunluğu kadardır
Opacity: global saydamlık [0.0, 1.0]
Karıştırma modu: kAlpha / kAdditive / kMultiply / kNone. GPU durumu olduğu için batch'i kırar; Vulkan'da mod başına pipeline varyantı başlangıçta üretilir

Yol (Path)

Path — doğru parçaları, quadratic (QuadTo) ve cubic (CubicTo) Bézier eğrileri; her MoveTo yeni bir alt yol başlatır, Close alt yolu kapatır
Eğriler yola eklenirken düzleştirilir (Flatness, varsayılan 0.25 px): kontrol noktası saklanmaz, tessellator'a dokunulmaz ve kalemin tüm stilleri (kesik, uç, birleşim) eğride de çalışır
DrawPath çerçeveyi, FillPath dolguyu çizer
Sınır: FillPath her alt yolu bağımsız doldurur — even-odd / nonzero kuralı yok, dolayısıyla "O" harfi gibi delikli şekiller doğru dolmaz

Transform Stack

Translate, Rotate, Scale
Save / Restore
ResetTransform
3×3 affine matris — glm::mat3 (column-major), bkz. ADR-007

Clipping

Scissor-based rect clip (SetClipRect / ClearClip)

Viewport

SetViewport / ResetViewport — çizimi bir alt dikdörtgenle sınırlar ve koordinatları ona yerelleştirir (bölünmüş ekran, mini harita)
Kırpmadan farkı: kırpma koordinat sistemini değiştirmeden maskeler, viewport sistemin kendisini yeniden tanımlar

Image / Texture

PNG ve JPG yükleme (stb_image)
Tam kaynak rect → hedef rect ölçekleme (atlas dilimleme)
Renk tonlaması (tint) ve aynalama (ImageFlip) — ikisi de vertex'te taşındığı için batch'i kırmaz
Örnekleme filtresi: kLinear (varsayılan) / kNearest (piksel sanatı)
Painter::UpdateImage ile yerinde doku güncelleme (her karede değişen prosedürel dokular)
Painter::DrawImageMesh ile serbest biçimli dokulu ızgara — köşeler bağımsız hareket edebilir
Alpha blending desteği

Çizim Hedefi (RenderTarget)

Painter::CreateRenderTarget ile ekran yerine dokuya çizim — mini harita, son işlem efektleri, iz efekti, pahalı ama nadir değişen katmanların önbelleklenmesi
SetRenderTarget / ResetRenderTarget; hedef bağlıyken koordinatlar hedefe yereldir ve iki backend'de piksel piksel aynı sonucu verir
DrawRenderTarget ile hedefi bir görüntü gibi (tint ve aynalama dahil) bas
ReadRenderTarget ile pikselleri doğrusal RGBA8 olarak geri oku — ekran görüntüsü ve backend parite testleri bunu kullanır
Hedefler tek örneklemlidir (MSAA yok)

Metin

SDL_ttf 3.x üzerinden font yükleme
Glyph cache
Alignment: left / center / right
Rect içine metin yerleştirme
Çok satırlı metin (satır sonu karakteri) ve Font::LineHeight()
Sözcük kaydırma (TextWrap::kWord) — UTF-8 güvenli; CountTextLines() ile çizmeden satır sayısı

Tessellator

Backend'den bağımsız vertex üretimi
Daire/elips için adaptif segment sayısı: max(16, int(radius * 0.5f))
Konkav çokgenler için ear clipping triangulation

Render Batcher

Her çizim çağrısı doğrudan GPU'ya gitmez; RenderBatcher vertex'leri bir arabellekte biriktirir ve yalnızca mod, texture veya opacity değiştiğinde (ya da 8192 vertex limiti dolduğunda) Flush() ile toplu olarak renderer'a iletir. Bu yaklaşım, özellikle çok sayıda küçük şeklin ard arda çizildiği sahnelerde draw call sayısını ciddi ölçüde azaltır.

Backend Desteği

OpenGL 3.3 Core — GLAD loader, GLSL shader'lar
Vulkan 1.1 — SPIR-V pipeline (Phase 5, opsiyonel)
IRenderer arayüzü — yeni backend eklemek için tek implementasyon noktası

Platform Desteği

Linux (GCC / Clang, Ninja)
Windows (MSVC, Visual Studio 2022)
Linux container içinde Windows cross-compile (MinGW-w64)

Altyapı

CMake Presets (8 preset: linux-debug, linux-release, linux-debug-coverage, linux-debug-asan, windows-debug, windows-release, windows-mingw-debug, windows-mingw-release)
Conan 2 bağımlılık yönetimi — SDL_ttf dahil zorunlu paketler, yalnızca Vulkan opsiyonel (-o "&:with_vulkan=True")
Docker multi-stage: geliştirme / headless CI / cross-compile
CI/CD: GitHub Actions (birincil) + GitLab CI (ayna) — build → test → quality → docs; clang-format zorunlu, clang-tidy soft
AddressSanitizer + UBSan preset (linux-debug-asan)
Google C++ Style, clang-format-18
Birim testler (gtest)