Mosavid, tek bir görseli binlerce küçük parçadan oluşan bir mozaik olarak yeniden kurup bunu video halinde üreten bir Python aracı. Projeyi, klasik photomosaic fikrini yalnızca statik çıktı veren bir betik olmaktan çıkarıp izlenebilir, paylaşılabilir ve sosyal medya odaklı bir üretim aracına dönüştürmek için hazırladım.
Neyi çözüyor?
Photomosaic üretmek tek başına ilginç olsa da çoğu araç burada duruyor. Mosavid’de odak noktası yalnızca son görüntü değil, mozaiğin nasıl oluştuğunu da görsel olarak anlamlı hale getirmekti.
Bu yüzden proje:
- statik mozaik çıktı üretebiliyor
- mozaiğin adım adım kurulduğu oluşum videoları hazırlayabiliyor
- aynı içeriği hızlandırılmış, karşılaştırmalı ve hazır ayar akışlarına uyarlayabiliyor
- farklı en-boy oranı ihtiyaçlarını tek bir CLI altında toplayabiliyor
Ana kullanım senaryoları
Oluşum videosu (satisfying)
Karoları sırayla yerleştirip izleme hissini öne çıkaran çıktı üretir. Spiral, rastgele ya da satır satır gibi yerleşim stratejileri ile birlikte farklı animasyon tipleri kullanılabiliyor.
Hızlandırılmış video (timelapse)
Mozaiğin oluşumunu hedef süreye sığdıran hızlandırılmış bir çıktı üretir. Özellikle demo ve kısa ürün tanıtımı videoları için pratik bir mod.
Karşılaştırma videosu (comparison)
Orijinal görsel ile mozaik sonucu aynı akışta gösterir. Önce/sonra mantığıyla ilerlediği için özellikle sunum ve vitrin kullanımına uygun.
Statik görsel ve videodan videoya
Araç yalnızca video üretmekle sınırlı değil. İstenirse doğrudan mozaik görsel oluşturabiliyor veya video girişindeki her kareyi mozaikleyerek videodan videoya çıktı verebiliyor.
Tasarım kararları
- Tek araç içinde birden fazla üretim modu sunması
- Komut satırı seviyesinde animasyon tipi, yerleşim sırası, çözünürlük ve en-boy oranı kontrolü vermesi
- Sosyal medya odaklı hazır ayar yaklaşımıyla kısa denemeleri hızlandırması
quick-testakışıyla maliyetli render sürecine girmeden hızlı önizleme sağlaması- Hazır karo görsel havuzu ile ilk kullanımı kolaylaştırması
Kısa örnekler
# Paketi kur
pip install mosavid
# Mozaik oluşumunu video olarak üret
mosavid satisfying \
--input examples/1.jpg \
--output mosaic.mp4 \
--animation drop_in \
--order spiral \
--tiles-per-second 5 \
--stride 10
# Hızlı test üret
mosavid quick-test -i examples/1.jpg
Teknik yapı
Proje, photomosaic üretimini tek parça bir betik yerine alt modüllere ayıran daha düzenli bir yapıyla ilerliyor.
core/: karo yükleme, renk eşleme ve mozaik yerleşim mantığıgenerators/: oluşum, hızlandırılmış ve karşılaştırmalı çıktı üreticilerieffects/: animasyonlar, geçişler, ilerleme göstergesi ve metin yerleştirme katmanıaudio/: arka plan müziği ve ses efektlericonfig/: hazır ayarlar ve varsayılan seçenekler
Bu yapı sayesinde aynı mozaik motoru farklı video modlarında tekrar kullanılabiliyor. Kullanım deneyimi tek bir CLI altında kalırken çıktı biçimleri modüler olarak ayrılıyor.
Ürün kararları
- Çoklu çıktı modu: Aynı çekirdek sistem üzerinden farklı formatlarda içerik üretilebiliyor
- Hazır ayar yaklaşımı: Kullanıcıyı onlarca parametreyle baş başa bırakmadan kısa yol sunuyor
- En-boy oranı desteği: 16:9, 9:16 ve 1:1 formatları doğrudan destekliyor
- Yerleşim algoritmaları: Sadece görsel kaliteyi değil animasyon hissini de etkileyen önemli bir karar alanı açıyor
Bağlantılar
- GitHub deposu: github.com/aliyilmazco/mosavid
- Sürüm: v1.0.0
Durum
Mosavid, yaratıcı kodlama ile araç ergonomisini birleştiren bir yan proje. Teknik olarak görüntü işleme, eşleme ve render akışına dayanıyor; ürün tarafında ise hızlı deneme, tekrar üretilebilir çıktı ve paylaşılabilir kısa video üretimi üzerine kuruluyor.