Bitmap 클래스

정의

그래픽 이미지의 픽셀 데이터와 그 특성으로 구성되는 GDI+ 비트맵을 캡슐화합니다.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. Bitmap은 픽셀 데이터로 정의된 이미지에서 작업하는 데 사용되는 개체입니다.A Bitmap is an object used to work with images defined by pixel data.

public ref class Bitmap sealed : System::Drawing::Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
상속
특성

예제

다음 코드 예제에서는 새 생성 하는 방법을 보여 줍니다 Bitmap 파일에서 사용 하는 GetPixelSetPixel 이미지 다시 칠하기 방법.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. 또한를 사용 합니다 PixelFormat, Width, 및 Height 속성입니다.It also uses the PixelFormat, Width, and Height properties.

이 예제는 포함 된 Windows Forms에 사용할를 Label, PictureBox, 및 Button 라는 Label1PictureBox1, 및 Button1, 각각.This example is designed to be used with a Windows Forms that contains a Label, PictureBox, and Button named Label1, PictureBox1, and Button1, respectively. 폼에 코드를 붙여 넣고 연결 합니다 Button1_Click 단추를 사용 하 여 메서드 Click 이벤트입니다.Paste the code into the form and associate the Button1_Click method with the button's Click event.

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

설명

비트맵의 픽셀 데이터 그래픽 이미지와 그 특성으로 구성 됩니다.A bitmap consists of the pixel data for a graphics image and its attributes. 비트맵 파일을 저장 하기 위한 다양 한 표준 형식 있습니다.There are many standard formats for saving a bitmap to a file. GDI+GDI+은 다음 파일 형식을 지원 합니다. BMP, GIF, EXIF, JPG, PNG 및 TIFF가 있습니다.supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. 지원 되는 형식에 대 한 자세한 내용은 참조 하세요. 종류의 비트맵합니다.For more information about supported formats, see Types of Bitmaps.

중 하나를 사용 하 여 파일, 스트림 및 기타 원본에서 이미지를 만들 수 있습니다 합니다 Bitmap 생성자 스트림이나 파일 시스템에 저장 합니다 Save 메서드.You can create images from files, streams, and other sources by using one of the Bitmap constructors and save them to a stream or to the file system with the Save method. 이미지가 그려지는 화면 또는 메모리를 사용 하 여 합니다 DrawImage 메서드는 Graphics 개체입니다.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. 이미지 파일을 사용 하 여 작업에 대 한 항목 목록을 참조 하세요 이미지, 비트맵, 아이콘 및 메타 파일을 사용 하 여 작업합니다.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

참고

Bitmap 클래스는 애플리케이션 도메인 간에 액세스할 수 없습니다.The Bitmap class is not accessible across application domains. 예를 들어 동적 AppDomain 및 해당 도메인에서 이러한 개체를 주 애플리케이션 도메인에 다시 전달 여러 브러시, 펜 및 비트맵 만들기, 펜 및 브러시를 사용할 수 있습니다.For example, if you create a dynamic AppDomain and create several brushes, pens, and bitmaps in that domain, then pass these objects back to the main application domain, you can successfully use the pens and brushes. 그러나 호출 하는 경우는 DrawImage 마샬링된을 그리는 방법 Bitmap, 다음 예외를 수신 합니다.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

원격 형식의 "System.Drawing.Image" 필드 "네이티브 이미지"를 찾을 수 없습니다.Remoting cannot find field "native image" on type "System.Drawing.Image".

생성자

Bitmap(Image)

지정된 기존 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

지정한 크기로 조정된 기존의 지정한 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

지정한 크기로 조정된 기존의 지정한 이미지에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

지정된 크기를 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

지정된 Bitmap 개체의 해상도와 지정된 크기를 사용하여 Graphics 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class with the specified size and with the resolution of the specified Graphics object.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

지정된 크기, 픽셀 형식 및 픽셀 데이터를 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

지정된 크기와 형식을 사용하여 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

지정된 데이터 스트림에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

지정된 데이터 스트림에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

지정된 파일에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

지정된 파일에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

지정된 리소스에서 Bitmap 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Bitmap class from a specified resource.

속성

Flags

Image의 픽셀 데이터에 대한 특성 플래그를 가져옵니다.Gets attribute flags for the pixel data of this Image.

(다음에서 상속됨 Image)
FrameDimensionsList

Image에 있는 프레임의 크기를 나타내는 GUID의 배열을 가져옵니다.Gets an array of GUIDs that represent the dimensions of frames within this Image.

(다음에서 상속됨 Image)
Height

Image의 높이(픽셀)를 가져옵니다.Gets the height, in pixels, of this Image.

(다음에서 상속됨 Image)
HorizontalResolution

Image의 가로 해상도(인치 당 픽셀 수)를 가져옵니다.Gets the horizontal resolution, in pixels per inch, of this Image.

(다음에서 상속됨 Image)
Palette

Image에 사용되는 색상표를 가져오거나 설정합니다.Gets or sets the color palette used for this Image.

(다음에서 상속됨 Image)
PhysicalDimension

이 이미지의 너비와 높이를 가져옵니다.Gets the width and height of this image.

(다음에서 상속됨 Image)
PixelFormat

Image의 픽셀 형식을 가져옵니다.Gets the pixel format for this Image.

(다음에서 상속됨 Image)
PropertyIdList

Image에 저장된 속성 항목의 ID를 가져옵니다.Gets IDs of the property items stored in this Image.

(다음에서 상속됨 Image)
PropertyItems

Image에 저장된 모든 속성 항목(메타데이터)을 가져옵니다.Gets all the property items (pieces of metadata) stored in this Image.

(다음에서 상속됨 Image)
RawFormat

Image의 파일 형식을 가져옵니다.Gets the file format of this Image.

(다음에서 상속됨 Image)
Size

이 이미지의 너비와 높이를 픽셀로 가져옵니다.Gets the width and height, in pixels, of this image.

(다음에서 상속됨 Image)
Tag

이미지에 대한 추가 데이터를 제공하는 개체를 가져오거나 설정합니다.Gets or sets an object that provides additional data about the image.

(다음에서 상속됨 Image)
VerticalResolution

Image의 세로 해상도(인치 당 픽셀 수)를 가져옵니다.Gets the vertical resolution, in pixels per inch, of this Image.

(다음에서 상속됨 Image)
Width

Image의 너비(픽셀)를 가져옵니다.Gets the width, in pixels, of this Image.

(다음에서 상속됨 Image)

메서드

Clone()

Image의 정확한 복사본을 만듭니다.Creates an exact copy of this Image.

(다음에서 상속됨 Image)
Clone(Rectangle, PixelFormat)

지정된 Bitmap 열거형과 함께 Rectangle 구조체에서 정의된 해당 PixelFormat 개체의 섹션 복사본을 만듭니다.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

지정된 Bitmap 열거형과 함께 정의된 해당 PixelFormat 섹션의 복사본을 만듭니다.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

Image에서 사용하는 리소스를 모두 해제합니다.Releases all resources used by this Image.

(다음에서 상속됨 Image)
Dispose(Boolean)

Image에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(다음에서 상속됨 Image)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
FromHicon(IntPtr)

창 핸들에서 아이콘까지 Bitmap을 만듭니다.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

지정된 Windows 리소스에서 Bitmap을 만듭니다.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

지정된 단위로 이미지의 범위를 가져옵니다.Gets the bounds of the image in the specified unit.

(다음에서 상속됨 Image)
GetEncoderParameterList(Guid)

지정된 이미지 인코더가 지원하는 매개 변수에 대한 정보를 반환합니다.Returns information about the parameters supported by the specified image encoder.

(다음에서 상속됨 Image)
GetFrameCount(FrameDimension)

지정된 크기의 프레임 수를 반환합니다.Returns the number of frames of the specified dimension.

(다음에서 상속됨 Image)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetHbitmap()

Bitmap에서 GDIGDI 비트맵 개체를 만듭니다.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

Bitmap에서 GDIGDI 비트맵 개체를 만듭니다.Creates a GDIGDI bitmap object from this Bitmap.

GetHicon()

아이콘에 대한 핸들을 반환합니다.Returns the handle to an icon.

GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetPixel(Int32, Int32)

해당 Bitmap의 지정된 픽셀의 색을 가져옵니다.Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

지정된 속성 항목을 이 Image에서 가져옵니다.Gets the specified property item from this Image.

(다음에서 상속됨 Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

Image의 축소판 그림을 반환합니다.Returns a thumbnail for this Image.

(다음에서 상속됨 Image)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)

Bitmap을 시스템 메모리에 잠급니다.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Bitmap을 시스템 메모리에 잠급니다.Locks a Bitmap into system memory.

MakeTransparent()

기본 투명 색을 이 Bitmap에 대해 투명하게 만듭니다.Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

해당 Bitmap의 지정된 색 투명을 만듭니다.Makes the specified color transparent for this Bitmap.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
RemovePropertyItem(Int32)

지정된 속성 항목을 이 Image에서 제거합니다.Removes the specified property item from this Image.

(다음에서 상속됨 Image)
RotateFlip(RotateFlipType)

Image를 회전하거나, 대칭 이동하거나, 회전하여 대칭 이동합니다.Rotates, flips, or rotates and flips the Image.

(다음에서 상속됨 Image)
Save(Stream, ImageCodecInfo, EncoderParameters)

지정된 인코더 및 이미지 인코더 매개 변수를 사용하여 이 이미지를 지정된 스트림에 저장합니다.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(다음에서 상속됨 Image)
Save(Stream, ImageFormat)

이 이미지를 지정된 형식의 지정된 스트림에 저장합니다.Saves this image to the specified stream in the specified format.

(다음에서 상속됨 Image)
Save(String)

Image를 지정된 파일이나 스트림에 저장합니다.Saves this Image to the specified file or stream.

(다음에서 상속됨 Image)
Save(String, ImageCodecInfo, EncoderParameters)

지정된 인코더 및 이미지 인코더 매개 변수를 사용하여 이 Image를 지정된 파일에 저장합니다.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(다음에서 상속됨 Image)
Save(String, ImageFormat)

Image를 지정된 형식으로 지정된 파일에 저장합니다.Saves this Image to the specified file in the specified format.

(다음에서 상속됨 Image)
SaveAdd(EncoderParameters)

Save 메서드에 대한 이전 호출에 지정된 파일이나 스트림에 프레임을 추가합니다.Adds a frame to the file or stream specified in a previous call to the Save method. 이 메서드를 사용하여 다중 프레임 이미지에서 선택한 프레임을 다른 다중 프레임 이미지에 저장합니다.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(다음에서 상속됨 Image)
SaveAdd(Image, EncoderParameters)

Save 메서드에 대한 이전 호출에 지정된 파일이나 스트림에 프레임을 추가합니다.Adds a frame to the file or stream specified in a previous call to the Save method.

(다음에서 상속됨 Image)
SelectActiveFrame(FrameDimension, Int32)

크기와 인덱스로 지정한 프레임을 선택합니다.Selects the frame specified by the dimension and index.

(다음에서 상속됨 Image)
SetPixel(Int32, Int32, Color)

Bitmap에서 지정된 픽셀의 색을 설정합니다.Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

Image에 속성 항목(메타데이터)을 저장합니다.Stores a property item (piece of metadata) in this Image.

(다음에서 상속됨 Image)
SetResolution(Single, Single)

해당 Bitmap의 해상도를 설정합니다.Sets the resolution for this Bitmap.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
UnlockBits(BitmapData)

시스템 메모리에서 해당 Bitmap 잠금을 해제합니다.Unlocks this Bitmap from system memory.

명시적 인터페이스 구현

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

대상 개체를 직렬화하는 데 필요한 데이터로 SerializationInfo를 채웁니다.Populates a SerializationInfo with the data needed to serialize the target object.

(다음에서 상속됨 Image)

적용 대상

추가 정보