Correct Image Perspective, bir blister veya ürün fotoğrafından nesneyi otomatik olarak tespit edip (ML Kit Subject Segmentation) kontur analizi ile dörtgen köşelerini bulan ve perspektif düzeltme (warp) uygulayarak düz, üstten görünüm haline getiren bir aksiyondur.

Android tarafında paketlenmiş PoC tabanlı bu aksiyon; kullanıcı kameradan tek bir fotoğraf çeker, çekilen görsel Base64 formatında aksiyona iletilir ve aksiyon, perspektifi düzeltilmiş görseli yine Base64 formatında döndürür. Dönen değer ham bir Base64 string'i olduğundan, bu çıktıyı nasıl kullanacağına kullanıcı karar verir. Örneğin bir Image elementine bağlayabilir, kaydedebilir veya başka bir işleme adımına iletebilir.

Teknik Özellikler

• Otomatik Nesne Tespiti: ML Kit Subject Segmentation kullanılarak görsel içindeki nesne otomatik olarak tanımlanır.
• Kontur Analizi: Tespit edilen nesnenin dörtgen köşeleri kontur analizi ile belirlenir.
• Perspektif Düzeltme (Warp): Köşe koordinatları kullanılarak görsel düzleştirilir ve üstten görünüm (bird's eye view) elde edilir.
• Base64 Girdi: Aksiyon, görseli imageBase64 (String) parametresi aracılığıyla alır.
• String Dönüşü: Perspektifi düzeltilmiş bitmap, String (One) tipinde Base64 olarak döndürülür ve ImageBox bileşeninde görüntülenebilir.
• Mobil Uyumluluk: ML Kit ve kamera erişimi gerektirdiğinden yalnızca mobil uygulamalarda çalışır.

Correct Image Perspective Aksiyonu Uygulama Adımları

• Kuika platformuna giriş yapın ve projenizi açın.
• UI Design modülüne geçin.
• Perspektif düzeltme işlemini başlatmak istediğiniz elementi seçin.
• Properties panelinden + ADD ACTION menüsüne tıklayın.
• Açılan menüden tetikleyici olayı seçin (Initial Actions veya Recurring Actions).
• Aksiyon listesinden önce Photo Take veya Photos From Gallery aksiyonunu ekleyin; Correct Image Perspective bu aksiyonlardan biri olmadan çalışmaz.

• Orta sütundan Device kategorisini seçin.
• Ardından aynı aksiyon zincirinde Correct Image Perspective seçeneğini tıklayın.

Aksiyon Parametreleri

• imageBase64 (String): Perspektif düzeltmesi uygulanacak görselin Base64 kodlanmış verisi. Genellikle kameradan çekilen fotoğraf bu parametreye bağlanır. Bu alana öncelikli olarak Action Result gibi veri kaynaklarından veri aktarılabilir. Ayrıca Method Input, Current, Screen Input, Fixed veya Component gibi farklı kaynaklar da kullanılabilir. Bu kategoriler Symbol Picker üzerinden seçilerek tanımlanabilir.

Gelişmiş Ayarlar

• Don't Trigger Validations: Etkinleştirildiğinde aksiyon çalışırken sayfadaki validasyon kuralları tetiklenmez. Perspektif düzeltme işleminin doğrulama sürecinden bağımsız çalışması gereken senaryolarda kullanılır.

Dönüş Değeri

Correct Image Perspective aksiyonu, işlem tamamlandığında String (One) tipinde Base64 kodlanmış görsel döndürür. Dönen değerle ne yapılacağı kullanıcıya bırakılmıştır; örneğin Action Result kaynağı aracılığıyla bir Image elementine bağlanabilir ya da farklı bir işleme adımına iletilebilir.

Kullanım Senaryosu: Blister Fotoğrafından Düzeltilmiş Görsel Elde Etme

Senaryo: Kullanıcı, ilaç takip uygulamasında bir blister ambalajının fotoğrafını çeker; aksiyon nesneyi otomatik tespit ederek perspektifi düzeltir ve düz, üstten görünümlü görseli ekranda gösterir.

Correct Image Perspective aksiyonu çağrılmadan önce mutlaka bir görsel kaynağı aksiyonu tetiklenmelidir. Görsel, Photo Take veya Photos From Gallery aksiyonu aracılığıyla elde edilerek imageBase64 parametresine aktarılmalıdır.

Senaryo 1 — Kamera ile Görsel Alma (Photo Take)

Akış:

1. Kullanıcı kameradan blister ambalajının fotoğrafını çeker. (Photo Take aksiyonu tetiklenir)
2. Photo Take aksiyonunun döndürdüğü Base64 değeri, Action Result aracılığıyla Correct Image Perspective aksiyonunun imageBase64 parametresine iletilir.
3. Aksiyon ML Kit ile nesneyi tespit eder, kontur analizi ile dörtgen köşelerini bulur ve perspektif düzeltme (warp) uygular.
4. Düzeltilmiş görsel String (One) tipinde Base64 olarak döner.
5. Dönen Action Result değeri, Set Value Of aksiyonu aracılığıyla Image1 elementine bağlanır ve düzeltilmiş görsel ekranda görüntülenir.

Senaryo 2 — Galeriden Görsel Seçme (Photos From Gallery)

Akış:

1. Kullanıcı galerisinden bir blister ambalajı görseli seçer. (Photos From Gallery aksiyonu tetiklenir)
2. Photos From Gallery aksiyonunun döndürdüğü koleksiyondan ilk görselin Base64 verisi, Correct Image Perspective aksiyonunun imageBase64 parametresine iletilir.
3. Aksiyon ML Kit ile nesneyi tespit eder, kontur analizi ile dörtgen köşelerini bulur ve perspektif düzeltme (warp) uygular.
4. Düzeltilmiş görsel String (One) tipinde Base64 olarak döner.
5. Dönen Action Result değeri, Set Value Of aksiyonu aracılığıyla Image2 elementine bağlanır ve düzeltilmiş görsel ekranda görüntülenir.

İleri Seviye Özelleştirmeler

• Zincirleme Aksiyonlar: Düzeltilmiş görsel çıktısı, OCR veya başka bir görüntü işleme aksiyonuna girdi olarak bağlanabilir.
• Kamera ile Entegrasyon: Photo Take aksiyonu ile birlikte kullanılarak kameradan çekilen görsel doğrudan bu aksiyona iletilebilir.
• Koşullu Akış: Dönüş değeri boş geldiğinde (nesne tespit edilemediğinde) Condition aksiyonu ile kullanıcıya uyarı gösterilebilir.

Teknik Riskler

• Nesne Tespiti Başarısızlığı: Arka plan ile nesne arasındaki kontrast düşükse ML Kit doğru segmentasyon yapamayabilir. Yeterli aydınlatma ve net bir arka plan kullanılması önerilir.
• Dörtgen Köşe Bulunamama: Kontur analizi yuvarlak veya düzensiz kenarlı nesnelerde doğru dörtgen köşelerini tespit edemeyebilir.
• Düşük Çözünürlüklü Girdi: imageBase64 parametresine düşük çözünürlüklü görsel iletildiğinde perspektif düzeltme kalitesi düşebilir.
• Validasyon Atlatma: Don't Trigger Validations yalnızca gerekli durumlarda kullanılmalıdır.

Correct Image Perspective aksiyonu, ilaç takip, stok yönetimi ve belge tarama gibi senaryolarda çarpık veya açılı çekilmiş görselleri otomatik olarak düzelterek kullanılabilir hale getirir. ML Kit tabanlı nesne tespiti, kontur analizi ve perspektif düzeltme adımlarını tek bir aksiyonda birleştirerek görüntü işleme süreçlerini basitleştirir ve uygulama kalitesini artırır.