WIC Meta Verilerine Genel Bakış

Bu konu başlığında, Windows Imaging Bileşeni (WIC) tarafından sağlanan görüntüleme meta verileri desteği tanıtılmaktadır. Görüntü meta verilerini, meta veri sorgu dilini ve meta veri işleyicisi genişletilebilirliğini okuma ve yazma işlemlerine giriş sağlar.

Görüntü meta verileri, görüntüyü yakalamak için kullanılan cihaz veya görüntünün boyutları gibi görüntü hakkında ek bilgiler sağlayan bir görüntü dosyasının içine eklenmiş verilerdir. Görüntü dosyasının içinde yer alsa da, bu meta veriler işleme verilerinin bir parçası değildir. WIC, Genişletilebilir Meta Veri Platformu (XMP), Değiştirilebilir Görüntü Dosyası (EXIF) ve Png Metin Verileri (tEXt) gibi birçok yaygın meta veri biçimi için bu meta verileri okumanızı ve yazmanızı sağlayan arabirimler sağlar.

Bu konu aşağıdaki bölümleri içerir.

• Önkoşullar
• Giriş
• Görüntü Meta Verilerini Okuma
• Görüntü Meta Verileri Yazma
• Meta Veri Genişletilebilirliği
• Desteklenen Meta Veriler Biçimleri
• Meta Veri Bileşeni Özeti
• İlgili konular

Önkoşullar

Bu konuyu anlamak için, Windows Imaging Bileşenine Genel Bakışaçıklandığı gibi WIC kodlayıcı ve kod çözücü arabirimleri ve bunların ilgili Bileşen Nesne Modeli (COM) bileşenleri hakkında bilgi sahibi olmanız gerekir. Ayrıca, günümüzde kullanılan bazı görüntüleme meta veri biçimleri hakkında genel bir bilgi sahibi olmanıza yardımcı olur.

Giriş

Meta veriler bir görüntü hakkında genişletilmiş bilgiler sağlar. Bu bilgiler çeşitli şekillerde kullanılabilir. Resim açıklama, derecelendirme, kategori etiketleri ve telif hakkı bilgileri gibi meta veriler içerebilir. Meta verilere erişmek varlık yönetimi, dosya konumu veya telif hakkı bilgilerini belirleme gibi görevlerin gerçekleştirilmesini kolaylaştırır. Örneğin, Windows Vista'daki Windows Fotoğraf Galerisi resimlere açıklama ve kategori etiketleri eklemenize olanak tanır. Bu, görüntülerin daha iyi keşfedilmesini ve görüntüleri kategorilere ayırmanın kullanışlı bir yolunu sağlar. WIC API'lerini ve yaygın meta veri biçimlerini kullanarak, uygulamalar bu tür meta verileri resimlere veya görüntülerden kolayca yazabilir veya okuyabilir.

Aşağıdaki diyagramda, eklenmiş meta veri blokları ve meta veri öğeleri içeren bir JPEG dosyasının içeriği gösterilmektedir.

ile jpeg görüntüsü

Bu örnek görüntüde, meta veriler bir görüntü çerçevesi içinde görüntü dosyasına eklenir. JPEG biçimi birden çok görüntü çerçevesini desteklemez, bu nedenle meta veriler kavramsal olarak bu tek kareye eklenir. TIFF gibi birden çok kareyi destekleyen biçimlerde, bu diyagramda gösterildiği gibi her görüntü çerçevesine meta veriler eklenmiş olabilir. Günümüzde yaygın olmasa da ve yerel görüntü codec'leri tarafından desteklenmese de, bazı görüntü biçimleri görüntü çerçevesi dışındaki meta verileri de destekleyebilse de. WIC, hem kare düzeyinde meta verileri hem de meta verileri görüntünün tek tek çerçevesinin dışında işleyecek kadar esnektir.

Görüntü Meta Verilerini Okuma

WIC API'leri, uygulamaların görüntü meta verilerini okumasını ve yazmasını kolaylaştıran COM bileşenleri sağlar.

Meta verileri okumanın birincil yolu, belirli meta veri öğelerine erişmek için meta veri sorgu okuyucusu (IWICMetadataQueryReader) kullanmaktır. Meta veri sorgu okuyucu bileşeni codec tarafından desteklenir ve kod çözücü seviyesinde veya daha yaygın olan yöntemle, yani tek tek görüntü çerçeveleri üzerinden erişilebilir. Aşağıdaki kod, sorgu okuyucunun GetMetadataQueryReader yöntemini kullanarak tek bir çerçeve için sorgu okuyucuya nasıl erişeceklerini gösterir.

// Get the query reader
if (SUCCEEDED(hr))
{
    hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}

Sorgu okuyucu, belirli meta veriler hakkında bilgi almak için yöntemler ve alınacak meta veri öğesini belirtmek için bir araç sağlar. Aşağıdaki kod, App1 iç içe görüntü dosyası dizini (IFD) bloğu içinde belirli bir meta veri öğesi istemek için bir sorgu ifadesi kullanır. Bu, sorgu okuyucusunun GetMetadataByName yöntemi kullanılarak yapılır. Aşağıdaki kod, MicrosoftPhoto derecelendirme değerini almak için sorgu okuyucunun kullanılmasını gösterir.

PROPVARIANT value;
PropVariantInit(&value);

LPCWSTR pwzRatingQuery = L"/app1/ifd/{ushort=18249}";

if (SUCCEEDED(hr))
{
    hr = pQueryReader->GetMetadataByName(pwzRatingQuery, &value);
}

Yukarıdaki örnekteki pwzRatingQuery değişkeni, MicrosoftPhoto derecelendirmesi meta veri öğesine erişmek için sorgu dizesidir. Bu dize meta veri sorgu dili kullanılarak oluşturulur. Bu dizeyi oluşturmak için, tek tek meta veri öğelerini almak için meta veri biçimi ve meta veri sorgu dili bilgisi gerekir. Meta veri sorgu dili hakkında daha fazla bilgi için bkz. Meta Veri Sorgu Diline Genel Bakış.

Arka planda sorgu okuyucu, sorgu ifadesi tarafından açıklanan meta verilere erişmek için meta veri okuyucuyu (IWICMetadataReader) kullanır. Sorgu okuyucu kullanmaya ek olarak, meta verileri okumak için doğrudan bir meta veri okuyucuya da erişebilirsiniz. Blok okuyucu (IWICMetadataBlockReader) arabirimini sorgulayarak kod çözücüden veya tek tek çerçevelerden meta veri okuyucu alabilirsiniz.

Görüntü Meta Verileri Yazma

Meta veri yazma işlemi, meta veri sorgu yazıcısının (IWICMetadataQueryWriter) kullanılması dışında okunma biçimine benzer. Sorgu yazıcı arabirimi görüntü kodlayıcı tarafından uygulanır ve sorgu okuyucuda olduğu gibi meta verilere hem kodlayıcıda hem de tek karelerde (görüntü biçimi desteğine bağlı olarak) erişilir.

Aşağıdaki kod, bir kodlayıcı çerçevesinden sorgu yazıcısının nasıl alındığını ve daha önce okunan derecelendirme değerinin nasıl kaldırılacağını gösterir.

// Get the frame's query writer
if (SUCCEEDED(hr))
{
    hr = pFrameEncode->GetMetadataQueryWriter(&pFrameQWriter);
}

if (SUCCEEDED(hr))
{
    hr = pFrameQWriter->RemoveMetadataByName(L"/app1/ifd/{ushort=18249}");
}

Meta veri yazmanın bir diğer yolu da hızlı meta veri güncelleştirmeleri kullanmaktır. Hızlı meta veri kodlama, görüntü dosyasını yeniden kodlamak zorunda kalmadan görüntü meta verilerini yazmanın bir yoludur. Bu, meta veri biçiminin doldurulmuş bir bölgesine yeni meta veri bilgileri yazılarak yapılır. Hızlı meta veri kodlayıcı (IWICFastMetadataEncoder) görüntü kod çözücüsü temelinde bileşen fabrikasından alınır. Hızlı meta veri kodlayıcı daha sonra meta verileri yazmak üzere kullanılan bir sorgu yazıcı alır. Son olarak, hızlı kodlayıcı değişikliği uygular.

Aşağıdaki kod, hızlı meta veri kodlayıcının nasıl alınıp MicrosoftRating değerini yazmak için nasıl kullanılacağını gösterir.

if (SUCCEEDED(hr))
{
    IWICFastMetadataEncoder *pFME = NULL;
    IWICMetadataQueryWriter *pFMEQW = NULL;

    hr = pFactory->CreateFastMetadataEncoderFromFrameDecode(
        pFrameDecode,
        &pFME);

    if (SUCCEEDED(hr))
    {
        hr = pFME->GetMetadataQueryWriter(&pFMEQW);
    }

    if (SUCCEEDED(hr))
    {
        // Add additional metadata
        PROPVARIANT value;

        PropVariantInit(&value);

        value.vt = VT_UI4;
        value.uiVal = 99;
        hr = pFMEQW->SetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);

        PropVariantClear(&value);
    }

    if (SUCCEEDED(hr))
    {
        hr = pFME->Commit();
    }
}

Tüm meta veri biçimleri hızlı meta verileri desteklemez. Yerel olarak desteklenen hangi biçimlerin hızlı meta veri kodlamayı desteklediğini görmek için, bu belgenin devamında yer alan desteklenen Desteklenen Meta Veri Biçimleri bölümündeki tabloya bakın.

Arka planda, sorgu yazıcısı sorgu ifadesi tarafından açıklanan meta verileri yazmak için bir meta veri yazıcı (IWICMetadataWriter) kullanır. Sorgu okuyucu kullanmaya ek olarak, meta verileri yazmak için doğrudan bir meta veri yazıcıya da erişebilirsiniz. Blok yazıcı (IWICMetadataBlockWriter) arabirimini sorgulayarak, kod çözücüden veya her bir çerçeveden bir meta veri yazıcı elde edebilirsiniz.

Meta Veri Genişletilebilirliği

Daha önce belirtildiği gibi WIC, yaygın meta veri biçimleri için meta verileri okumak ve yazmak için çeşitli meta veri işleyicileri sağlar. Ancak yerel olarak desteklenmeyen bazı meta veri biçimleri vardır. Bu nedenle WIC, meta veri desteğini diğer biçimlere genişletebilen ek meta veri işleyicileri oluşturmaya yönelik API'ler sağlar.

Diğer meta veri biçimlerini tam olarak desteklemek için iki tür işleyici geliştirilmelidir: meta verileri okumak için meta veri okuyucu ve meta veri yazmak için bir meta veri yazıcı. Bu iki işleyici genellikle belirli bir biçim için çiftler halinde uygulansa da, bu bir gereksinim değildir. Yalnızca okuma özelliğinin veya yalnızca yazma yeteneğinin gerekli olduğu bazı durumlar olabilir.

WIC API'lerini kullanarak meta veri genişletilebilirliği hakkında daha fazla bilgi için bkz. Meta Veri Genişletilebilirliğine Genel Bakış.

Desteklenen Meta Veri Biçimleri

WIC, çeşitli yaygın meta veri biçimleri için destek sağlar. Aşağıdaki tabloda desteklenen meta veri biçimleri, sürümleri, meta veri biçimini destekleyen görüntü biçimleri ve meta veri biçiminin hızlı meta veri kodlamasını destekleyip desteklemediği listelenmektedir. Hızlı meta veri kodlaması hakkında daha fazla bilgi için bu belgenin önceki Görüntü Meta Verileri Yazma bölümüne bakın.

Meta Veri Bileşeni Özeti

Aşağıdaki tabloda meta verileri destekleyen WIC arabirimleri ve bunların ilgili bileşenleri açıklanmaktadır. Bu bileşenler görüntünün meta verilerine erişim sağlar. Bu bileşenler hakkında daha fazla bilgi için bkz. Windows Imaging Bileşenine Genel Bakış.

Aşağıdaki tabloda WIC meta veri bileşenleri açıklanmaktadır. Bu bileşenler, önceki tabloda listelenen bileşenler tarafından sunulan bir görüntüdeki meta verileri okumanızı ve yazmanızı sağlar.

İlgili konular

kavramsal

Windows Görüntüleme Bileşenine Genel Bakış

Meta Veri Sorgu Diline Genel Bakış

Okuma ve Yazma Görüntü Meta Verilerine Genel Bakış

Meta Veri Genişletilebilirliğine Genel Bakış

Nasıl Yapılır: Meta Veri ile JPEG Görüntüsünü Yeniden Kodlama