System.Drawing.Imaging Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan fungsionalitas pencitraan GDI+ tingkat lanjut. Fungsionalitas grafis dasar disediakan oleh System.Drawing namespace layanan.
Kelas
BitmapData |
Menentukan atribut gambar bitmap. Kelas BitmapData ini digunakan oleh LockBits metode dan UnlockBits(BitmapData) kelas Bitmap . Tidak bisa diwariskan. |
CachedBitmap |
Mewakili salinan yang bergantung pada perangkat yang Bitmap cocok dengan pengaturan perangkat (tampilan) objek tertentu Graphics saat ini. Menghindari langkah memformat ulang saat penyajian, yang dapat secara signifikan meningkatkan performa. |
ColorMap |
Menentukan peta untuk mengonversi warna. Beberapa metode ImageAttributes kelas menyesuaikan warna gambar dengan menggunakan tabel remap warna, yang merupakan array ColorMap struktur. Tidak bisa diwariskan. |
ColorMatrix |
Menentukan matriks 5 x 5 yang berisi koordinat untuk ruang RGBAW. Beberapa metode ImageAttributes kelas menyesuaikan warna gambar dengan menggunakan matriks warna. Kelas ini tidak dapat diwariskan. |
ColorPalette |
Menentukan array warna yang membentuk palet warna. Warnanya adalah warna ARGB 32-bit. Tidak bisa diwariskan. |
Encoder |
Objek Encoder merangkum pengidentifikasi unik global (GUID) yang mengidentifikasi kategori parameter encoder gambar. |
EncoderParameter |
Digunakan untuk meneruskan nilai, atau array nilai, ke encoder gambar. |
EncoderParameters |
Merangkum array EncoderParameter objek. |
FrameDimension |
Menyediakan properti yang mendapatkan dimensi bingkai gambar. Tidak bisa diwariskan. |
ImageAttributes |
Berisi informasi tentang bagaimana warna bitmap dan metafile dimanipulasi selama penyajian. |
ImageCodecInfo |
Kelas ini ImageCodecInfo menyediakan anggota penyimpanan dan metode yang diperlukan untuk mengambil semua informasi terkait tentang encoder dan dekoder gambar yang diinstal (disebut codec). Tidak bisa diwariskan. |
ImageFormat |
Menentukan format file gambar. Tidak bisa diwariskan. |
Metafile |
Mendefinisikan metafile grafis. Metafile berisi rekaman yang menjelaskan urutan operasi grafis yang dapat direkam (dibangun) dan diputar kembali (ditampilkan). Kelas ini tidak dapat diwariskan. |
MetafileHeader |
Berisi atribut dari yang terkait Metafile. Tidak bisa diwariskan. |
MetaHeader |
Berisi informasi tentang metafile format windows (WMF). |
PropertyItem |
Merangkum properti metadata yang akan disertakan dalam file gambar. Tidak bisa diwariskan. |
WmfPlaceableFileHeader |
Mendefinisikan metafile yang dapat ditempatkan. Tidak bisa diwariskan. |
Enum
ColorAdjustType |
Menentukan objek GDI+ mana yang menggunakan informasi penyesuaian warna. |
ColorChannelFlag |
Menentukan saluran individual dalam ruang warna CMYK (sian, magenta, kuning, hitam). Enumerasi ini digunakan oleh SetOutputChannel metode . |
ColorMapType |
Menentukan jenis peta warna. |
ColorMatrixFlag |
Menentukan jenis gambar dan warna yang akan dipengaruhi oleh pengaturan penyesuaian warna dan skala abu-abu dari ImageAttributes. |
ColorMode |
Menentukan dua mode untuk nilai komponen warna. |
DitherType |
Menyediakan fungsionalitas pencitraan GDI+ tingkat lanjut. Fungsionalitas grafis dasar disediakan oleh System.Drawing namespace layanan. |
EmfPlusRecordType |
Menentukan metode yang tersedia untuk digunakan dengan metafile untuk membaca dan menulis perintah grafik. |
EmfType |
Menentukan sifat rekaman yang ditempatkan dalam file Enhanced Metafile (EMF). Enumerasi ini digunakan oleh beberapa konstruktor di Metafile kelas . |
EncoderParameterValueType |
Menentukan jenis data yang EncoderParameter digunakan dengan Save metode atau SaveAdd gambar. |
EncoderValue |
Digunakan untuk menentukan nilai parameter yang diteruskan ke encoder gambar JPEG atau TIFF saat menggunakan Save(String, ImageCodecInfo, EncoderParameters) metode atau SaveAdd(EncoderParameters) . |
ImageCodecFlags |
Menyediakan atribut encoder/decoder gambar (codec). |
ImageFlags |
Menentukan atribut data piksel yang Image terkandung dalam objek . Properti Flags mengembalikan anggota enumerasi ini. |
ImageLockMode |
Menentukan bendera yang diteruskan ke parameter LockBits bendera metode . Metode ini LockBits mengunci sebagian gambar sehingga Anda dapat membaca atau menulis data piksel. |
MetafileFrameUnit |
Menentukan satuan pengukuran untuk persegi panjang yang digunakan untuk mengukur dan memosisikan metafile. Ini ditentukan selama pembuatan Metafile objek. |
MetafileType |
Menentukan jenis metafiles. Properti Type mengembalikan anggota enumerasi ini. |
PaletteFlags |
Menentukan jenis data warna dalam palet sistem. Data dapat berupa data warna dengan data alfa, skala abu-abu saja, atau data halftone. |
PaletteType |
Menyediakan fungsionalitas pencitraan GDI+ tingkat lanjut. Fungsionalitas grafis dasar disediakan oleh System.Drawing namespace layanan. |
PixelFormat |
Menentukan format data warna untuk setiap piksel dalam gambar. |
Delegasikan
PlayRecordCallback |
Delegasi ini tidak digunakan. Untuk contoh menghitung rekaman metafile, lihat EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
Keterangan
Perhatian
Namespace System.Drawing
layanan memiliki beberapa batasan untuk sistem operasi dan jenis aplikasi tertentu.
Di Windows,
System.Drawing
tergantung pada pustaka asli GDI+, yang dikirim sebagai bagian dari OS. Beberapa SKU Windows, seperti Windows Server Core atau Windows Nano, tidak menyertakan pustaka asli ini sebagai bagian dari OS. Jika Anda menggunakan namespace layanan ini dan pustaka tidak dapat dimuat, pengecualian akan dilemparkan pada durasi.Beberapa jenis di
System.Drawing
namespace mengandalkan GDI+, yang tidak didukung di layanan Windows dan aplikasi ASP.NET Core dan ASP.NET. Jenis-jenis ini ada dalam paket System.Drawing.Common NuGet dan sertakan System.Drawing.Bitmap dan System.Drawing.Font. Namun, jenis primitif di namespace layanan, seperti System.Drawing.Color, , System.Drawing.SizeSystem.Drawing.Point, dan System.Drawing.Rectangle, dapat digunakan dalam aplikasi apa pun.Di .NET 5 dan versi sebelumnya, paket System.Drawing.Common NuGet berfungsi di Windows, Linux, dan macOS. Namun, ada beberapa perbedaan platform. Di Linux dan macOS, fungsionalitas GDI+ diimplementasikan oleh pustaka libgdiplus). Pustaka ini tidak diinstal secara default di sebagian besar distribusi Linux dan tidak mendukung semua fungsionalitas GDI+ di Windows dan macOS. Ada juga platform di mana libgdiplus tidak tersedia sama sekali. Untuk menggunakan jenis dari paket System.Drawing.Common di Linux dan macOS, Anda harus menginstal libgdiplus secara terpisah. Untuk informasi selengkapnya, lihat Menginstal .NET di Linux atau Menginstal .NET di macOS.
Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common NuGet hanya didukung pada sistem operasi Windows. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.
Jika Anda tidak dapat menggunakan System.Drawing
aplikasi Anda, alternatif yang direkomendasikan termasuk ImageSharp, SkiaSharp, Komponen Pencitraan Windows, dan Microsoft.Maui.Graphics.
Kelas ini Metafile menyediakan metode untuk merekam dan menyimpan metafiles. Kelas ini Encoder memungkinkan pengguna untuk memperluas GDI+ untuk mendukung format gambar apa pun. Kelas ini PropertyItem menyediakan metode untuk menyimpan dan mengambil metadata dalam file gambar.
Perhatian
Kelas dalam System.Drawing.Imaging namespace tidak didukung untuk digunakan dalam layanan Windows atau ASP.NET. Mencoba menggunakan kelas ini dari dalam salah satu jenis aplikasi ini dapat menghasilkan masalah yang tidak terduga, seperti performa layanan yang berkurang dan pengecualian run-time.