Bitmap 클래스

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

System.Drawing.Common v8.0.0

Source:

Bitmap.cs

그래픽 이미지의 픽셀 데이터와 그 특성으로 구성되는 GDI+ 비트맵을 캡슐화합니다. Bitmap은 픽셀 데이터로 정의된 이미지에서 작업하는 데 사용되는 개체입니다.

public ref class Bitmap sealed : System::Drawing::Image

[System.Serializable]
public sealed class Bitmap : System.Drawing.Image

[<System.Serializable>]
type Bitmap = class
    inherit Image

Public NotInheritable Class Bitmap
Inherits Image

상속

Object

MarshalByRefObject

Image

Bitmap

특성

SerializableAttribute

예제

다음 코드 예제를 사용 하 여 GetPixel 파일에서 새 Bitmap 생성 하는 방법을 보여 줍니다.는 및 SetPixel 이미지를 다시 칠하기 위해 메서드. 또한 , Width및 Height 속성을 사용합니다PixelFormat.

이 예제는 각각 , 및 라는 , PictureBox및 Button 를 Label1PictureBox1Button1포함하는 LabelWindows Forms 사용하도록 설계되었습니다. 코드를 양식에 붙여넣고 메서드를 Button1_Click 단추의 Click 이벤트와 연결합니다.

private:
   Bitmap^ image1;
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         
         // Retrieve the image.
         image1 = gcnew Bitmap( "C:\\Documents and Settings\\All Users\\"
         "Documents\\My Music\\music.bmp",true );
         int x;
         int y;
         
         // Loop through the images pixels to reset color.
         for ( x = 0; x < image1->Width; x++ )
         {
            for ( y = 0; y < image1->Height; y++ )
            {
               Color pixelColor = image1->GetPixel( x, y );
               Color newColor = Color::FromArgb( pixelColor.R, 0, 0 );
               image1->SetPixel( x, y, newColor );

            }

         }
         
         // Set the PictureBox to display the image.
         PictureBox1->Image = image1;
         
         // Display the pixel format in Label1.
         Label1->Text = String::Format( "Pixel format: {0}", image1->PixelFormat );
      }
      catch ( ArgumentException^ ) 
      {
         MessageBox::Show( "There was an error."
         "Check the path to the image file." );
      }

   }

Bitmap image1;

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    try
    {
        // Retrieve the image.
        image1 = new Bitmap(@"C:\Documents and Settings\All Users\" 
            + @"Documents\My Music\music.bmp", true);

        int x, y;

        // Loop through the images pixels to reset color.
        for(x=0; x<image1.Width; x++)
        {
            for(y=0; y<image1.Height; y++)
            {
                Color pixelColor = image1.GetPixel(x, y);
                Color newColor = Color.FromArgb(pixelColor.R, 0, 0);
                image1.SetPixel(x, y, newColor);
            }
        }

        // Set the PictureBox to display the image.
        PictureBox1.Image = image1;

        // Display the pixel format in Label1.
        Label1.Text = "Pixel format: "+image1.PixelFormat.ToString();
    }
    catch(ArgumentException)
    {
        MessageBox.Show("There was an error." +
            "Check the path to the image file.");
    }
}

Dim image1 As Bitmap

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    Try
        ' Retrieve the image.
        image1 = New Bitmap( _
            "C:\Documents and Settings\All Users\Documents\My Music\music.bmp", _
            True)

        Dim x, y As Integer

        ' Loop through the images pixels to reset color.
        For x = 0 To image1.Width - 1
            For y = 0 To image1.Height - 1
                Dim pixelColor As Color = image1.GetPixel(x, y)
                Dim newColor As Color = _
                    Color.FromArgb(pixelColor.R, 0, 0)
                image1.SetPixel(x, y, newColor)
            Next
        Next

        ' Set the PictureBox to display the image.
        PictureBox1.Image = image1

        ' Display the pixel format in Label1.
        Label1.Text = "Pixel format: " + image1.PixelFormat.ToString()

    Catch ex As ArgumentException
        MessageBox.Show("There was an error." _
            & "Check the path to the image file.")
    End Try
End Sub

설명

비트맵은 그래픽 이미지의 픽셀 데이터와 해당 특성으로 구성됩니다. 비트맵을 파일에 저장하기 위한 많은 표준 형식이 있습니다. GDI+는 BMP, GIF, EXIF, JPG, PNG 및 TIFF 파일 형식을 지원합니다. 지원되는 형식에 대한 자세한 내용은 비트맵 유형을 참조하세요.

생성자 중 Bitmap 하나를 사용하여 파일, 스트림 및 기타 원본에서 이미지를 만들고 메서드를 사용하여 스트림 또는 파일 시스템에 Save 저장할 수 있습니다. 이미지는 개체의 메서드 Graphics 를 사용하여 화면 또는 메모리에 DrawImage 그려집니다. 이미지 파일 작업에 대한 topics 목록은 이미지, 비트맵, 아이콘 및 메타파일 작업을 참조하세요.

참고

.NET 6 이상 버전에서는 이 형식을 포함하는 System.Drawing.Common 패키지가 Windows 운영 체제에서만 지원됩니다. 플랫폼 간 앱에서 이 형식을 사용하면 컴파일 시간 경고 및 런타임 예외가 발생합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조하세요.

참고

Bitmap 클래스는 애플리케이션 도메인 간에 액세스할 수 없습니다. 예를 들어 동적 AppDomain 및 해당 도메인에서 이러한 개체를 주 애플리케이션 도메인에 다시 전달 여러 브러시, 펜 및 비트맵 만들기, 펜 및 브러시를 사용할 수 있습니다. 그러나 마샬링된 Bitmap를 DrawImage 그리기 위해 메서드를 호출하면 다음 예외가 발생합니다.

원격은 "System.Drawing.Image" 형식에서 필드 "네이티브 이미지"를 찾을 수 없습니다.

생성자

Bitmap(Image)	지정된 기존 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Image, Int32, Int32)	지정한 크기로 조정된 기존의 지정한 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Image, Size)	지정한 크기로 조정된 기존의 지정한 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Int32, Int32)	지정된 크기를 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Int32, Int32, Graphics)	지정된 Bitmap 개체의 해상도와 지정된 크기를 사용하여 Graphics 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	지정된 크기, 픽셀 형식 및 픽셀 데이터를 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Int32, Int32, PixelFormat)	지정된 크기와 형식을 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Stream)	지정된 데이터 스트림에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Stream, Boolean)	지정된 데이터 스트림에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(String)	지정된 파일에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(String, Boolean)	지정된 파일에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.
Bitmap(Type, String)	지정된 리소스에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.

속성

Flags	이 Image의 픽셀 데이터에 대한 특성 플래그를 가져옵니다. (다음에서 상속됨 Image)
FrameDimensionsList	이 Image에 있는 프레임의 크기를 나타내는 GUID의 배열을 가져옵니다. (다음에서 상속됨 Image)
Height	이 Image의 높이(픽셀)를 가져옵니다. (다음에서 상속됨 Image)
HorizontalResolution	이 Image의 가로 해상도(인치 당 픽셀 수)를 가져옵니다. (다음에서 상속됨 Image)
Palette	이 Image에 사용되는 색상표를 가져오거나 설정합니다. (다음에서 상속됨 Image)
PhysicalDimension	이 이미지의 너비와 높이를 가져옵니다. (다음에서 상속됨 Image)
PixelFormat	이 Image의 픽셀 형식을 가져옵니다. (다음에서 상속됨 Image)
PropertyIdList	이 Image에 저장된 속성 항목의 ID를 가져옵니다. (다음에서 상속됨 Image)
PropertyItems	이 Image에 저장된 모든 속성 항목(메타데이터)을 가져옵니다. (다음에서 상속됨 Image)
RawFormat	이 Image의 파일 형식을 가져옵니다. (다음에서 상속됨 Image)
Size	이 이미지의 너비와 높이를 픽셀로 가져옵니다. (다음에서 상속됨 Image)
Tag	이미지에 대한 추가 데이터를 제공하는 개체를 가져오거나 설정합니다. (다음에서 상속됨 Image)
VerticalResolution	이 Image의 세로 해상도(인치 당 픽셀 수)를 가져옵니다. (다음에서 상속됨 Image)
Width	이 Image의 너비(픽셀)를 가져옵니다. (다음에서 상속됨 Image)

메서드

Clone()	이 Image의 정확한 복사본을 만듭니다. (다음에서 상속됨 Image)
Clone(Rectangle, PixelFormat)	지정된 Bitmap 열거형과 함께 Rectangle 구조체에서 정의된 해당 PixelFormat 개체의 섹션 복사본을 만듭니다.
Clone(RectangleF, PixelFormat)	지정된 Bitmap 열거형과 함께 정의된 해당 PixelFormat 섹션의 복사본을 만듭니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	이 Image에서 사용하는 리소스를 모두 해제합니다. (다음에서 상속됨 Image)
Dispose(Boolean)	Image에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 Image)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
FromHicon(IntPtr)	창 핸들에서 아이콘까지 Bitmap을 만듭니다.
FromResource(IntPtr, String)	지정된 Windows 리소스에서 Bitmap을 만듭니다.
GetBounds(GraphicsUnit)	지정된 단위로 이미지의 범위를 가져옵니다. (다음에서 상속됨 Image)
GetEncoderParameterList(Guid)	지정된 이미지 인코더가 지원하는 매개 변수에 대한 정보를 반환합니다. (다음에서 상속됨 Image)
GetFrameCount(FrameDimension)	지정된 크기의 프레임 수를 반환합니다. (다음에서 상속됨 Image)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetHbitmap()	이 Bitmap에서 GDI 비트맵 개체를 만듭니다.
GetHbitmap(Color)	이 Bitmap에서 GDI 비트맵 개체를 만듭니다.
GetHicon()	아이콘에 대한 핸들을 반환합니다.
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetPixel(Int32, Int32)	해당 Bitmap의 지정된 픽셀의 색을 가져옵니다.
GetPropertyItem(Int32)	지정된 속성 항목을 이 Image에서 가져옵니다. (다음에서 상속됨 Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	이 Image의 축소판 그림을 반환합니다. (다음에서 상속됨 Image)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Bitmap을 시스템 메모리에 잠급니다.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Bitmap을 시스템 메모리에 잠급니다.
MakeTransparent()	기본 투명 색을 이 Bitmap에 대해 투명하게 만듭니다.
MakeTransparent(Color)	해당 Bitmap의 지정된 색 투명을 만듭니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
RemovePropertyItem(Int32)	지정된 속성 항목을 이 Image에서 제거합니다. (다음에서 상속됨 Image)
RotateFlip(RotateFlipType)	Image를 회전하거나, 대칭 이동하거나, 회전하여 대칭 이동합니다. (다음에서 상속됨 Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	지정된 인코더 및 이미지 인코더 매개 변수를 사용하여 이 이미지를 지정된 스트림에 저장합니다. (다음에서 상속됨 Image)
Save(Stream, ImageFormat)	이 이미지를 지정된 형식의 지정된 스트림에 저장합니다. (다음에서 상속됨 Image)
Save(String)	이 Image를 지정된 파일이나 스트림에 저장합니다. (다음에서 상속됨 Image)
Save(String, ImageCodecInfo, EncoderParameters)	지정된 인코더 및 이미지 인코더 매개 변수를 사용하여 이 Image를 지정된 파일에 저장합니다. (다음에서 상속됨 Image)
Save(String, ImageFormat)	이 Image를 지정된 형식으로 지정된 파일에 저장합니다. (다음에서 상속됨 Image)
SaveAdd(EncoderParameters)	Save 메서드에 대한 이전 호출에 지정된 파일이나 스트림에 프레임을 추가합니다. 이 메서드를 사용하여 다중 프레임 이미지에서 선택한 프레임을 다른 다중 프레임 이미지에 저장합니다. (다음에서 상속됨 Image)
SaveAdd(Image, EncoderParameters)	Save 메서드에 대한 이전 호출에 지정된 파일이나 스트림에 프레임을 추가합니다. (다음에서 상속됨 Image)
SelectActiveFrame(FrameDimension, Int32)	크기와 인덱스로 지정한 프레임을 선택합니다. (다음에서 상속됨 Image)
SetPixel(Int32, Int32, Color)	이 Bitmap에서 지정된 픽셀의 색을 설정합니다.
SetPropertyItem(PropertyItem)	이 Image에 속성 항목(메타데이터)을 저장합니다. (다음에서 상속됨 Image)
SetResolution(Single, Single)	해당 Bitmap의 해상도를 설정합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
UnlockBits(BitmapData)	시스템 메모리에서 해당 Bitmap 잠금을 해제합니다.

명시적 인터페이스 구현

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

대상 개체를 직렬화하는 데 필요한 데이터로 SerializationInfo를 채웁니다. (다음에서 상속됨 Image)

추가 정보

• PictureBox
• 이미지, 비트맵 및 메타파일
• 이미지, 비트맵, 아이콘 및 메타파일 사용