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
| Nama | Deskripsi |
|---|---|
| BitmapData |
Menentukan atribut gambar bitmap. Kelas BitmapData ini digunakan oleh LockBits metode UnlockBits(BitmapData) dan Bitmap kelas . Tidak dapat diwariskan. |
| CachedBitmap |
Mewakili salinan tergantung perangkat dari 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 dapat 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 dapat 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 dapat diwariskan. |
| ImageAttributes |
Berisi informasi tentang bagaimana bitmap dan warna 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 dapat diwariskan. |
| ImageFormat |
Menentukan format file gambar. Tidak dapat 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 Metafile. Tidak dapat diwariskan. |
| MetaHeader |
Berisi informasi tentang metafile format windows (WMF). |
| PropertyItem |
Merangkum properti metadata yang akan disertakan dalam file gambar. Tidak dapat diwariskan. |
| WmfPlaceableFileHeader |
Menentukan metafile yang dapat ditempatkan. Tidak dapat diwariskan. |
Enum
| Nama | Deskripsi |
|---|---|
| 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 metode SetOutputChannel. |
| 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 |
Menentukan bagaimana gambar dialihkan dengan palet warna yang dikurangi. |
| 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 kelas Metafile. |
| EncoderParameterValueType |
Menentukan jenis data EncoderParameter yang digunakan dengan metode gambar Save atau SaveAdd. |
| EncoderValue |
Digunakan untuk menentukan nilai parameter yang diteruskan ke encoder gambar JPEG atau TIFF saat menggunakan metode Save(String, ImageCodecInfo, EncoderParameters) atau SaveAdd(EncoderParameters). |
| ImageCodecFlags |
Menyediakan atribut encoder/decoder gambar (codec). |
| ImageFlags |
Menentukan atribut data piksel yang terkandung dalam objek Image. Properti Flags mengembalikan anggota enumerasi ini. |
| ImageLockMode |
Menentukan bendera yang diteruskan ke parameter bendera metode LockBits. Metode LockBits mengunci sebagian gambar sehingga Anda dapat membaca atau menulis data piksel. |
| MetafileFrameUnit |
Menentukan unit pengukuran untuk persegi panjang yang digunakan untuk mengukur dan memosisikan metafile. Ini ditentukan selama pembuatan objek Metafile. |
| 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 |
Menentukan jenis palet warna. |
| PixelFormat |
Menentukan format data warna untuk setiap piksel dalam gambar. |
Delegasikan
| Nama | Deskripsi |
|---|---|
| PlayRecordCallback |
Delegasi ini tidak digunakan. Untuk contoh menghitung rekaman metafile, lihat EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
Keterangan
Caution
Namespace System.Drawing memiliki beberapa batasan untuk sistem operasi dan jenis aplikasi tertentu.
Pada Windows,
System.Drawingtergantung 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 waktu proses.Beberapa jenis di namespace
System.Drawingmengandalkan 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.Dalam .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+ pada 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 Install .NET di Linux atau Install .NET di macOS.
Dalam versi .NET 6 dan 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 dengan aplikasi Anda, Alternatif yang direkomendasikan termasuk ImageSharp, SkiaSharp, Windows Komponen Pencitraan, dan Microsoft. Maui.Graphics.
Kelas ini Metafile menyediakan metode untuk merekam dan menyimpan metafiles. Kelas ini Encoder memungkinkan pengguna memperluas GDI+ untuk mendukung format gambar apa pun. Kelas ini PropertyItem menyediakan metode untuk menyimpan dan mengambil metadata dalam file gambar.
Caution
Kelas dalam namespace System.Drawing.Imaging tidak didukung untuk digunakan dalam layanan Windows atau ASP.NET. Mencoba menggunakan kelas ini dari dalam salah satu jenis aplikasi ini dapat menghasilkan masalah tak terduga, seperti performa layanan yang berkurang dan pengecualian run-time.
