Gambar::Metode GetFrameDimensionsList (gdiplusheaders.h)

Artikel
08/24/2023

Metode Image::GetFrameDimensionsList mendapatkan pengidentifikasi untuk dimensi bingkai objek Gambar ini.

Sintaks

Status GetFrameDimensionsList(
  [out] GUID *dimensionIDs,
  [in]  UINT count
);

Parameter

[out] dimensionIDs

Jenis: GUID*

Penunjuk ke array yang menerima pengidentifikasi. GUID yang mengidentifikasi berbagai dimensi didefinisikan dalam Gdiplusimaging.h.

[in] count

Jenis: UINT

Bilangan bulat yang menentukan jumlah elemen dalam array dimensiID . Panggil metode Image::GetFrameDimensionsCount untuk menentukan nomor ini.

Menampilkan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Metode ini mengembalikan informasi tentang gambar beberapa bingkai, yang datang dalam dua gaya: beberapa halaman dan beberapa resolusi.

Gambar multi-halaman adalah gambar yang berisi lebih dari satu gambar. Setiap halaman berisi satu gambar (atau bingkai). Halaman ini (atau gambar, atau bingkai) biasanya ditampilkan secara berurutan untuk menghasilkan urutan animasi, seperti dalam file GIF animasi.

Gambar resolusi ganda adalah gambar yang berisi lebih dari satu salinan gambar pada resolusi yang berbeda.

Windows GDI+ dapat mendukung jumlah halaman arbitrer (atau gambar, atau bingkai), serta jumlah resolusi arbitrer.

Contoh

Aplikasi konsol berikut membuat objek Gambar berdasarkan file TIFF. Kode memanggil metode Image::GetFrameDimensionsCount untuk mengetahui berapa banyak dimensi bingkai yang dimiliki objek Gambar . Masing-masing dimensi bingkai tersebut diidentifikasi oleh GUID, dan panggilan ke GetFrameDimensionsList mengambil GUID tersebut. GUID pertama berada pada indeks 0 dalam array pDimensionIDs . Panggilan ke metode Image::GetFrameCount menentukan jumlah bingkai dalam dimensi yang diidentifikasi oleh GUID pertama.

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   Image* image = new Image(L"Multiframe.tif");

   // How many frame dimensions does the Image object have?
   UINT count = 0;
   count = image->GetFrameDimensionsCount();
   printf("The number of dimensions is %d.\n", count);
   GUID* pDimensionIDs = (GUID*)malloc(sizeof(GUID)*count);

   // Get the list of frame dimensions from the Image object.
   image->GetFrameDimensionsList(pDimensionIDs, count);

   // Display the GUID of the first (and only) frame dimension.
   WCHAR strGuid[39];
   StringFromGUID2(pDimensionIDs[0], strGuid, 39);
   wprintf(L"The first (and only) dimension ID is %s.\n", strGuid);

   // Get the number of frames in the first dimension.
   UINT frameCount = image->GetFrameCount(&pDimensionIDs[0]);
   printf("The number of frames in that dimension is %d.\n", frameCount);
    
   free(pDimensionIDs);
   delete(image);
   GdiplusShutdown(gdiplusToken);
   return 0;
}

Kode sebelumnya, bersama dengan file tertentu, Multiframe.tif, menghasilkan output berikut:

The number of dimensions is 1.
The first (and only) dimension ID is {7462DC86-6180-4C7E-8E3F-EE7333A7A483}.
The number of frames in that dimension is 4.

Anda dapat mencari GUID yang ditampilkan di Gdiplusimaging.h dan melihat bahwa itu adalah pengidentifikasi untuk dimensi halaman. Jadi output program memberi tahu kita bahwa file Multiframe.tif memiliki empat halaman; yaitu, empat bingkai dalam dimensi halaman.

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusheaders.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll