Skip to content

MusabDINC/AirCanvas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 Advanced Air Canvas

Advanced Air Canvas, hiçbir fiziksel kaleme veya ekrana dokunmadan, sadece el hareketlerinizle havada çizim yapmanıza olanak tanıyan yapay zeka destekli bir projedir. Bilgisayar kameranızı veya telefon kameranızı (örn. DroidCam) kullanarak elinizi okur ve sanal bir tuvale yansıtır.

Hiçbir teknik veya kodlama bilgisi gerektirmeden, Tek Tıkla Kurulum özelliği sayesinde birkaç dakika içinde oynamaya veya çizim yapmaya başlayabilirsiniz!


✨ Neler Yapabilirsiniz?

  • 🤚 Havada Kesintisiz Çizim: Yapay zeka teknolojisi (MediaPipe) elinizdeki 21 farklı eklem noktasını anlık olarak takip eder. İşaret parmağınız sihirli bir fırçaya dönüşür.
  • 📐 Otomatik Şekil Düzeltme: Çizdiğiniz kırık dökük ve yamuk şekilleri tespit eder. Eğer bir kare, üçgen veya dikdörtgen çizmeye çalıştıysanız, uygulama bunu sizin için otomatik olarak cetvelle çizilmiş gibi düz ve kusursuz hale getirir.
  • 🖌️ Akıllı Fırça Boyutu: Kalın veya ince çizmek için menülerde boğulmayın. İşaret parmağınız ile başparmağınız arasındaki açıyı (mesafeyi) değiştirerek fırça kalınlığını dinamik olarak ayarlayabilirsiniz.
  • 🎨 Photoshop Mantığında Çalışma: Kamera görüntünüz ve çizimleriniz ayrı dünyalardadır. İki katmanlı (Layer) özel sistem ile hiçbir donma yaşamadan akıcı bir kalite oluşturulur.
  • 🌍 Evrensel Dizin Desteği: Türkçe karakter barındıran (Masaüstü, Belgelerim vs) klasörlerde çökme gibi klasik hataların hepsi kod içerisinde özel bir yama ile engellenmiştir. Projeyi istediğiniz yerde açabilirsiniz.

🖐️ Nasıl Kullanılır? (El Kontrolleri)

Tüm kontrol parmaklarınızın ucunda. Kameranın karşısına geçin ve elinizi kullanın:

Elinizin Hareketi Ne İşe Yarar?
Sadece İşaret Parmağı Havada Çizim yapar. Ekranda fırçanız boya bırakır.
İşaret ve Orta Parmak Havada Gezinme / Seçim. Boya yapmadan renkler arası geçmek, üst menüye tıklatmak veya silgiye dokunmak için kullanılır.
Bütün Parmaklar Açık (El Ayası) Temizlik Vakti. Elinizin tamamını ekrana tutup bir an beklediğinizde devasa tuvali tek hamlede çöpe atıp tertemiz yapar.
Yumruk Yapmak (Eller Kapalı) Bekleme. Hiçbir şey olmaz, fırça gizlenir.
İşaret ve Başparmak Arası Mesafe Çizim yaparken baş parmağınızı yaklaştırırsanız fırça küçülür, açarsanız koca bir spreye dönüşür.

⌨️ İhtiyaç Duyarsanız Klavye Kısayolları

  • q : Uygulamayı güvenli şekilde kapatır.
  • s : O an çizdiğiniz şaheserin ekran görüntüsünü bilgisayarınıza kaydeder.
  • d : Geliştirici Ekranı. Ekranda el iskeletinizi ve oyunun saniyede kaç kareyle (FPS) çalıştığını gösterir.
  • c : Tuvali tamamen temizler (Tamamen açık ele alternatif).

🚀 Nasıl Kurulur ve Çalıştırılır?

Bu projeyi kullanmak için uzun uzun kütüphane kurmanıza veya karmaşık terminal komutları yazmanıza gerek yoktur. Sizin için tüm sistem otomatikleştirilmiştir.

Adım Adım Kurulum (Windows İçin):

1. Python Kurulumu (Eğer yüklü değilse): Bilgisayarınızda Python yüklü olmalıdır.

⚠️ ÖNEMLİ: Yapay zeka modüllerinin (MediaPipe) C++ çekirdekleri şu an resmi olarak Python 3.13 sürümünü desteklememektedir. Bu yüzden lütfen Python 3.10 veya Python 3.11 sürümlerinden birini kurduğunuzdan emin olun. Kurulum ekranında alt kısımdaki "Add Python to PATH" kutucuğunu İŞARETLEMEYİ kesinlikle unutmayın.

2. Projeyi İndirin: Sağ üstteki yeşil Code tuşuna basıp projeyi Download ZIP seçeneğiyle indirin ve masaüstünde veya istediğiniz bir konumda klasöre çıkartın.

3. Tek Tıkla Başlatın: Klasörün içindeki baslat.bat isimli dosyaya çift tıklayın.

Hepsi bu kadar! İlk açılışta siyah bir terminal penceresi açılacak ve sizin için bilgisayarınızın en güvenli teknik alanı olan %LOCALAPPDATA% içerisine izole bir sanal ortam (venv) kuracaktır. İhtiyacınız olan internet dosyaları otomatik olarak indirilir (internet hızınıza göre 1-2 dakika sürebilir). Kurulum biter bitmez kamera ekranınız otomatik açılacaktır. İkinci açışınızda bekleme süresi olmadan 1 saniye içinde kamerayı yansıtacaktır.

AppData Güvencesi: Proje, İzole Ortam Mimarisi kullanır. Projenizi masaüstünde, OneDrive içinde, Türkçe karakterli bir dizinde (Örn: Masaüstü/Projelerim) veya bir USB bellekte çalıştırsanız dahi sistem asla hata vermez. İngilizce dil zorunlulukları veya bulut senkronizasyon hataları tamamen kodla (Junction & AppData tekniği) engellenmiştir.

(macOS veya Linux kullanıyorsanız, terminalden pip install -r requirements.txt ve ardından python main.py komutuyla aynı sonucu alabilirsiniz).


⚙️ Uygulama İçi Ayar Menüsü (GUI)

Uygulama artık tamamen görsel bir Ayar Paneli (Settings Dialog) içermektedir! Uygulamayı başlattığınızda sol menüde yer alan ayarlar ikonuna tıklayarak (veya başlangıçta çıkan ekrandan);

  • Kameralar arası geçiş yapabilir,
  • Görüntü kalitesini (Çözünürlük) ve Hedef FPS değerini ayarlayabilir,
  • Hangi elinizi (Sağ/Sol) dominant kullanmak istediğinizi belirtebilirsiniz. Ayarlarınız .aircanvas dosyanıza kaydedilir ve her girişte hatırlanır!

📜 Lisans Bilgileri

Bu proje MIT Lisansı altında açık kaynaklı olarak paylaşılmaktadır. Dilediğiniz gibi kaynak kodlarını okuyabilir, kopyalayabilir, değiştirebilir, başka projelerinizde kaynak göstererek kullanabilirsiniz.

Geliştirici: Muhammed Musab DİNÇ
Herhangi bir hata veya öneriniz için "Issues" bölümünden bildirim yapabilirsiniz!

About

AI-powered virtual canvas. Paint and draw in the air using only your hand gestures without touching the screen!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors