Metin ve URL’den QR Kodu Nasıl Oluşturulur?

QR kodu için içeriği ve ayarları planlama

QR kodu üretmek için önce kodun taşımasını istediğiniz içeriği belirleyin. Bu içerik bir URL, kısa bir açıklama, iletişim bilgisi veya başka bir metin olabilir. Araç, boş olmayan metin ya da URL sağlandığında başarılı işlem sonucunu PNG görselini temsil eden base64 biçimli bir değer olarak döndürür. İçeriği ana veri girişine yazabilir veya metin, URL ve içerik için sunulan eşdeğer girişlerden uygun olanını kullanabilirsiniz.

Kullanım sırasında üç ayarı gözden geçirmek yararlı olur: görsel boyutu, hata düzeltme seviyesi ve renkler. Boyut belirtilmediğinde 256 değeri esas alınır. Ön planın başlangıç rengi siyah, arka planın başlangıç rengi beyazdır; bu iki renk yapılandırılabilir. Hata düzeltme için L, M, Q ve H seçenekleri tanınır. Bir URL girdiğinizde araç, bu adresi QR kodunun içeriği olarak işler; adresin açılmasıyla ilgili bir işlem burada tanımlanmamıştır.

İçerik alanını boş bırakmamak temel başlangıç koşuludur. Ana giriş boş kalır ve başka bir desteklenen girişte de değer bulunmazsa araç görsel üretmeden sonuçlanır. Bu nedenle ayarları değiştirmeden önce dönüştürülecek metnin gerçekten seçtiğiniz alana aktarıldığını kontrol edin. Böylece dönen değerin boş içerik sınırına mı, yoksa başarılı bir PNG sonucuna mı karşılık geldiğini daha kolay ayırt edebilirsiniz.

QR kodu oluşturma işlemini uygulama

QR kodunda yer almasını istediğiniz metni veya URL’yi hazırlayın. Ardından değeri ana veri girişine girin ya da metin, URL veya içerik için sunulan eşdeğer girişlerden birini seçin. Birden fazla alanı doldurmak yerine kullandığınız girişte değer bulunduğundan emin olun.
Görsel boyutunu isteğe göre belirtin. Değer girmezseniz 256 kullanılır. Girilen değer tam sayıya çevrilir; dönüştürme sırasında ValueError veya TypeError türünde bir sorun oluşursa 256 değerine geri dönülür. Dönüştürülmüş sonuç 64 ile 1024 aralığına sınırlandırılır. Bu alanı belirlerken yazdığınız sayının, son PNG’nin piksel ölçüsünü bire bir garanti etmediğini aklınızda tutun.
Hata düzeltme seviyesini seçin. Metin biçimindeki seçenekler L, M, Q ve H’dir. Girdi büyük harfe dönüştürülür; dönüştürülmüş değer bu seçeneklerden biri değilse M kullanılır. Seçim yapmadığınız durumda da başlangıç seviyesi M olur.
Renk seçeneklerini gerekiyorsa değiştirin. Ön plan için başlangıçta siyah, arka plan için beyaz kullanılır. Yapılandırma alanlarında farklı renkler sağlanabiliyorsa seçiminizi burada yapın; renk değiştirmek istemiyorsanız başlangıç değerlerini koruyun.
QR kodu oluşturma işlemini başlatın ve dönen değeri inceleyin. Başarılı sonuç boş olmayan bir base64 dizesi biçimindedir ve bu değer PNG verisine çözümlenir. İçerik sağlanmadığında görsel oluşturulmaz; ayrıca oluşturma bağımlılığı veya üretim süreciyle ilgili bir hata da görsel dönmemesine neden olabilir. Böyle bir durumda önce içeriğin ve ayarların değer taşıdığını kontrol edin, ardından işlemi yeniden deneyin.

Dönen PNG sonucunu ve sınırlarını okuma

Başarılı bir sonuç gördüğünüzde değerlendirmeniz gereken temel işaret, dönen base64 değerinin boş olmamasıdır. Bu değer, QR görselinin PNG biçimindeki verisini taşır; ekranda okunacak kaynak metnin kendisi olarak yorumlanmamalıdır. Sonucu kullanacağınız yerde PNG verisini bekleyen akışın bulunduğundan emin olun.

İstediğiniz boyut ile ortaya çıkan PNG ölçüsünün farklı olması tek başına başarısızlık anlamına gelmez. Çünkü sağlanan değer önce tam sayıya çevrilir, 64 ile 1024 arasına çekilir ve QR modüllerinin ölçeği tam sayı olarak hesaplanır. Bu hesaplama, son piksel ölçüsünü normalize edilmiş istekten ayırabilir. Bu nedenle 300 yazmanız, 300 piksel kenar ölçüsünü kesin olarak ifade etmez.

Hata düzeltme alanında geçerli seçenek dışındaki bir metin kullanıldıysa sonuç M seviyesine yönelir. Böyle bir geri dönüş, yazdığınız değerin kabul edildiğini göstermez; ayarın desteklenen seçeneklerden biriyle yeniden belirtilmesi daha açık bir seçim sağlar. İçerik boşsa karşılaştırılacak PNG değeri bulunmaz. Üretim veya gerekli bağımlılıklarla ilgili bir sorun oluştuğunda da sonuç alınamayabileceğinden, yalnızca alanların doldurulmuş olması başarılı üretimi kanıtlamaz.

Uygulamalı örnek

Etkinlik sayfasını paylaşmak isteyen bir kullanıcı, sayfanın URL’sini QR koduna dönüştürmek üzere içerik olarak sağlar.

Bir etkinlik sayfasının URL’sini içerik olarak girin, boyut alanına 300 yazın ve oluşturma işlemini başlatın. Dönen değerin boş olmadığını ve PNG olarak çözümlendiğini kontrol edin.

Başarılı işlemde boş olmayan ve PNG verisine çözümlenen bir base64 dizesi döner; sonuç ölçüsü 300 piksel olmak zorunda değildir.

Sınırlamalar

Boş içerik ve bazı oluşturma ya da bağımlılık sorunları görsel sonucu olmadan dönebilir; başarılı biçim PNG’dir ve son piksel ölçüsü sağlanan boyuttan ayrılabilir.

Sık yapılan hatalar

Ana veri girişi boş kaldığında veya içerik eşdeğer alanlardan birine aktarılmadığında görsel üretilmez. Metin ya da URL’yi kullandığınız girişe ekleyip oluşturma işlemini yeniden başlatın.

Sık sorulan sorular

İçerik girmeden QR kodu oluşturulabilir mi?

İçerik sağlanmadığında ana giriş boş değerle değerlendirilir ve araç görsel oluşturmadan döner. QR kodu almak için ana veri alanına veya desteklenen eşdeğer girişlerden birine metin ya da URL eklenmelidir.

QR kodunun görsel boyutu nasıl belirlenir?

Boyut yazılmazsa başlangıç değeri 256 olur. Sağlanan değer tam sayıya dönüştürülür, dönüştürme başarısızlığında 256 kullanılır ve sonuç 64 ile 1024 arasında tutulur; modül ölçeği hesabı son PNG ölçüsünü değiştirebilir.

Hata düzeltme seviyeleri hangileridir?

Geçerli metin seçenekleri L, M, Q ve H olarak kabul edilir. Araç bu değerleri büyük harfe çevirir; desteklenmeyen dönüştürülmüş bir değer için M seviyesine başvurur.