Gambar::Metode GetFrameDimensionsCount (gdiplusheaders.h)

Artikel
08/24/2023

Metode Image::GetFrameDimensionsCount mendapatkan jumlah dimensi bingkai dalam objek Gambar ini.

Sintaks

UINT GetFrameDimensionsCount();

Mengembalikan nilai

Jenis: UINT

Metode ini mengembalikan jumlah dimensi bingkai dalam objek Gambar ini.

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 Image::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