Lewati ke konten utama

Metadata gambar yang diekspor oleh Glasswall

Saat dioperasikan dalam mode ekspor, Glasswall menghasilkan gambar yang disematkan dalam file PDF dalam bentuk sepasang file:

  • File yang berisi data gambar mentah
  • File yang berisi metadata yang menjelaskan format gambar

File metadata berbentuk objek JSON yang berisi pasangan atribut Name/Value berikut.

Atribut wajib

Nilai-nilai ini akan ada untuk setiap gambar terlepas dari format, penggunaan, atau encoding-nya dan akan selalu ada terlepas dari skema encoding atau ruang warna yang digunakan.

Lebar

Bilangan bulat tak bertanda yang menunjukkan lebar gambar dalam piksel.

Tinggi

Bilangan bulat tak bertanda yang menunjukkan tinggi gambar dalam piksel.

Komponen

Bilangan bulat tak bertanda yang menunjukkan jumlah nilai intensitas yang digunakan untuk merepresentasikan setiap piksel; misalnya, gambar monokrom sederhana akan memiliki nilai Components sebesar 1, gambar yang dikodekan RGB akan memiliki nilai komponen sebesar 3, dan gambar yang dikodekan CMYK akan memiliki nilai komponen sebesar 4.

BitsPerComponent

Bilangan bulat tak bertanda yang menunjukkan jumlah bit per komponen warna; misalnya, gambar monokrom sederhana akan memiliki nilai BitsPerComponent sebesar 1, gambar skala abu-abu yang dikodekan dengan 256 tingkat intensitas akan memiliki nilai BitsPerComponent sebesar 8, demikian pula gambar RGB yang dikodekan dengan resolusi warna 24 bit.

Panjang

Bilangan bulat tak bertanda yang menunjukkan jumlah byte data yang diharapkan dalam aliran data gambar.

Atribut opsional

Selain itu, file metadata juga dapat berisi pasangan atribut Name/Value opsional berikut ketika data tambahan diperlukan untuk menjelaskan penggunaan dan/atau dekode agar gambar dapat dirender secara akurat.

ImageMask

Nilai Boolean yang menunjukkan bahwa gambar dimaksudkan untuk digunakan sebagai mask guna menampilkan atau menyembunyikan bagian dari gambar lain yang mendasarinya.

Filter

Nilai string yang menunjukkan algoritme pengodean yang digunakan. Algoritme pengodean yang tersedia dijelaskan dalam pembahasan tentang stream filter di PDF Specification (ISO32000-1, Section 7.4), dan nilai umum mencakup CCITTFaxDecode, LZWDecode (kompresi Lempel-Zif-Welch, seperti yang digunakan misalnya pada format GIF), DCTDecode (kompresi transformasi kosinus diskret, seperti yang digunakan pada JPEG), atau FlateDecode (kompresi zlib deflate).

DecodeParms

Nilai string yang berisi parameter tambahan apa pun yang diperlukan oleh algoritme dekode untuk mendekode data gambar dengan benar.

JBIG2

Segmen data global yang akan digunakan saat memproses data gambar yang dikodekan JBIG2.type of colourspace

Matte

Nilai boolean yang menunjukkan bahwa gambar dimaksudkan untuk digunakan sebagai matte untuk membentuk bagian dari gambar komposit mis. dengan colour keying atau alpha blending.

Atribut ruang warna

ColorSpaceFamily

Nilai string yang menunjukkan jenis ruang warna yang akan digunakan jika gambar akan dirender sebagaimana dimaksud seperti dijelaskan dalam spesifikasi PDF (ISO32000-1, Section 8.6).

Ruang warna perangkat.

Ruang warna sederhana (DeviceGray, DeviceRGB, dan DeviceCMYK) tidak memerlukan deskripsi lebih lanjut dan menunjukkan bahwa nilai sampel gambar (piksel) dapat digunakan secara langsung.

Ruang warna berbasis CIE

Ruang warna berbasis CIE harus didasarkan pada standar internasional untuk spesifikasi warna yang dibuat oleh Commission Internationale de l’Éclairage (International Commission on Illumination). Ruang ini menentukan warna dengan cara yang independen dari karakteristik perangkat output tertentu mana pun. Keluarga ruang warna dalam kategori ini mencakup CalGray, CalRGB, Lab, dan ICCBased. Saat ini hanya ruang warna berbasis ICC (ColorSpaceFamily ICCBased) yang didukung, dan, dalam kasus ini atribut berikut akan ada.

ColorSpaceIccProfileData

Nilai string yang berisi profil warna lintas platform ICC dalam format standar ICC. Karena ini adalah urutan byte arbitrer, nilainya disajikan dalam encoding Base64 agar dapat direpresentasikan dalam nilai string JSON.

ColorSpaceAlternate

Nilai string yang menunjukkan ruang warna alternatif yang dapat digunakan untuk merender gambar jika output berbasis ICC tidak didukung.

Ruang warna terindeks

Ruang warna terindeks (nilai ColorSpaceFamily adalah Indexed) merepresentasikan setiap nilai piksel (atau sampel) menggunakan satu nilai tunggal yang berfungsi sebagai indeks ke dalam tabel yang berisi nilai output aktual, atau kumpulan nilai aktual; jumlah nilai dalam tabel lookup akan sesuai dengan ruang warna dasar. Sebagai contoh, dengan menggunakan ruang warna dasar DeviceRGB, setiap entri dalam tabel lookup akan berisi 3 nilai. Entri tabel lookup akan disajikan dalam satu array dengan komponen warna muncul secara berurutan. Untuk ruang warna indeks, atribut berikut akan ada.

ColorSpaceBaseFamily

Nilai string yang menunjukkan ruang warna yang digunakan untuk nilai lookup terindeks.

ColorSpaceBaseComponents

Bilangan bulat tak bertanda yang menunjukkan jumlah komponen dalam ruang warna dasar dan dengan demikian jumlah nilai dalam setiap entri pada tabel lookup ruang warna terindeks.

ColorSpaceIccProfileData

Data profile ruang warna berbasis ICC untuk ruang warna dasar berbasis ICC - hanya ada jika ColorSpaceBaseFamily memiliki nilai ICCBased.

ColorSpaceLookupData

Array bilangan bulat tak bertanda yang berisi tabel lookup untuk ruang warna terindeks.