Bitmap Costruttori

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Inizializza una nuova istanza della classe Bitmap.

Overload

Bitmap(Image)	Inizializza una nuova istanza della classe Bitmap a partire dall'immagine esistente.
Bitmap(Stream)	Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.
Bitmap(String)	Inizializza una nuova istanza della classe Bitmap dal file specificato.
Bitmap(Image, Size)	Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.
Bitmap(Int32, Int32)	Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate.
Bitmap(Stream, Boolean)	Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.
Bitmap(String, Boolean)	Inizializza una nuova istanza della classe Bitmap dal file specificato.
Bitmap(Type, String)	Inizializza una nuova istanza della classe Bitmap da una risorsa specificata.
Bitmap(Image, Int32, Int32)	Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.
Bitmap(Int32, Int32, Graphics)	Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate e la risoluzione dell'oggetto Graphics indicato.
Bitmap(Int32, Int32, PixelFormat)	Inizializza una nuova istanza della classe Bitmap con le dimensioni e il formato specificati.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Inizializza una nuova istanza della classe Bitmap con le dimensioni, il formato pixel e i dati pixel specificati.

Bitmap(Image)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap a partire dall'immagine esistente.

C#

public Bitmap (System.Drawing.Image original);

Parametri

original

Image

Oggetto Image da cui creare il nuovo oggetto Bitmap.

Bitmap(Stream)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.

C#

public Bitmap (System.IO.Stream stream);

Parametri

stream

Stream

Flusso di dati utilizzato per caricare l'immagine.

Eccezioni

ArgumentException

stream non contiene dati di immagine o è null.

-oppure-

stream contiene un file di immagine PNG con una singola dimensione superiore a 65.535 pixel.

Esempio

L'esempio di codice seguente illustra come caricare una bitmap da un flusso.

Questo esempio è progettato per essere usato con Windows Forms. Create un modulo contenente un PictureBox oggetto denominato PictureBox1. Incollare il codice nel form e chiamare il InitializeStreamBitmap metodo dal costruttore o Load dal metodo di gestione degli eventi del modulo.

C#

private void InitializeStreamBitmap()
{
    try
    {
        System.Net.WebRequest request = 
            System.Net.WebRequest.Create(
            "http://www.microsoft.com//h/en-us/r/ms_masthead_ltr.gif");
        System.Net.WebResponse response = request.GetResponse();
        System.IO.Stream responseStream = 
            response.GetResponseStream();
        Bitmap bitmap2 = new Bitmap(responseStream);
        PictureBox1.Image = bitmap2;
    }
    catch(System.Net.WebException)
    {
        MessageBox.Show("There was an error opening the image file."
           + "Check the URL");
    }
}

Commenti

È necessario mantenere aperto il flusso per la durata di Bitmap.

A causa di una limitazione del decodificatore GDI+, viene generata un'eccezione System.ArgumentException se si costruisce una bitmap da un file di immagine .png con una singola dimensione maggiore di 65.535 pixel.

Vedi anche

• Tipi di bitmap

Bitmap(String)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dal file specificato.

C#

public Bitmap (string filename);

Parametri

filename

String

Nome e percorso del file bitmap.

Eccezioni

FileNotFoundException

Il file specificato non è stato trovato.

Commenti

Il nome e il percorso del file possono essere relativi all'applicazione o a un percorso assoluto. Usare questo costruttore per aprire le immagini con i formati di file seguenti: BMP, GIF, EXIF, JPG, PNG e TIFF. Per altre informazioni sui formati supportati, vedere Tipi di bitmap. Il file rimane bloccato fino a quando non Bitmap viene eliminato .

Vedi anche

• Tipi di bitmap

Bitmap(Image, Size)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.

C#

public Bitmap (System.Drawing.Image original, System.Drawing.Size newSize);

Parametri

original

Image

Oggetto Image da cui creare il nuovo oggetto Bitmap.

newSize

Size

Struttura Size che rappresenta le dimensioni del nuovo oggetto Bitmap.

Eccezioni

Exception

Operazione non riuscita.

Bitmap(Int32, Int32)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate.

C#

public Bitmap (int width, int height);

Parametri

width

Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.

height

Int32

Altezza, in pixel, del nuovo oggetto Bitmap.

Eccezioni

Exception

Operazione non riuscita.

Commenti

Questo costruttore crea un Bitmap oggetto con un PixelFormat valore di enumerazione pari a Format32bppArgb.

Bitmap(Stream, Boolean)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.

C#

public Bitmap (System.IO.Stream stream, bool useIcm);

Parametri

stream

Stream

Flusso di dati utilizzato per caricare l'immagine.

useIcm

Boolean

true per utilizzare la correzione dei colori per questo oggetto Bitmap; in caso contrario, false.

Eccezioni

ArgumentException

stream non contiene dati di immagine o è null.

-oppure-

stream contiene un file di immagine PNG con una singola dimensione superiore a 65.535 pixel.

Commenti

È necessario mantenere aperto il flusso per la durata di Bitmap.

A causa di una limitazione del decodificatore GDI+, viene generata un'eccezione System.ArgumentException se si costruisce una bitmap da un file di immagine .png con una singola dimensione maggiore di 65.535 pixel.

Vedi anche

• Tipi di bitmap

Bitmap(String, Boolean)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dal file specificato.

C#

public Bitmap (string filename, bool useIcm);

Parametri

filename

String

Nome del file bitmap.

useIcm

Boolean

true per utilizzare la correzione dei colori per questo oggetto Bitmap; in caso contrario, false.

Esempio

Nell'esempio di codice seguente viene illustrato come costruire una nuova bitmap da un file. Nell'esempio vengono usati i GetPixel metodi e SetPixel per ricolorare l'immagine. Usa anche la PixelFormat proprietà .

Questo esempio è progettato per essere usato con un Windows Form che contiene rispettivamente un LabelPictureBox oggetto , e Button denominato PictureBox1Label1e Button1. Incollare il codice nel modulo e associare il Button1_Click metodo all'evento del Click pulsante.

C#

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.");
    }
}

Commenti

Usare questo costruttore per aprire le immagini con i formati di file seguenti: BMP, GIF, EXIF, JPG, PNG e TIFF. Per altre informazioni sui formati supportati, vedere Tipi di bitmap. Il file rimane bloccato fino a quando non Bitmap viene eliminato .

Vedi anche

• Tipi di bitmap

Bitmap(Type, String)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap da una risorsa specificata.

C#

public Bitmap (Type type, string resource);

Parametri

type

Type

Classe utilizzata per estrarre la risorsa.

resource

String

Nome della risorsa.

Esempio

Nell'esempio di codice seguente viene illustrato come costruire una bitmap da un tipo e come usare il Save metodo . Per eseguire questo esempio, incollare il codice in un Windows Form. Gestire l'evento del Paint modulo e chiamare il ConstructFromResourceSaveAsGif metodo , passando e come PaintEventArgs

C#

private void ConstructFromResourceSaveAsGif(PaintEventArgs e)
{

    // Construct a bitmap from the button image resource.
    Bitmap bmp1 = new Bitmap(typeof(Button), "Button.bmp");

    // Save the image as a GIF.
    bmp1.Save("c:\\button.gif", System.Drawing.Imaging.ImageFormat.Gif);

    // Construct a new image from the GIF file.
    Bitmap bmp2 = new Bitmap("c:\\button.gif");

    // Draw the two images.
    e.Graphics.DrawImage(bmp1, new Point(10, 10));
    e.Graphics.DrawImage(bmp2, new Point(10, 40));

    // Dispose of the image files.
    bmp1.Dispose();
    bmp2.Dispose();
}

Commenti

Questo costruttore combina lo spazio dei nomi del tipo specificato con il nome stringa della risorsa e cerca una corrispondenza nel manifesto dell'assembly. Ad esempio, è possibile passare il Button tipo e Button.bmp a questo costruttore e cercherà una risorsa denominata System.Windows.Forms.Button.bmp.

Vedi anche

• Tipi di bitmap

Bitmap(Image, Int32, Int32)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.

C#

public Bitmap (System.Drawing.Image original, int width, int height);

Parametri

original

Image

Oggetto Image da cui creare il nuovo oggetto Bitmap.

width

Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.

height

Int32

Altezza, in pixel, del nuovo oggetto Bitmap.

Eccezioni

Exception

Operazione non riuscita.

Bitmap(Int32, Int32, Graphics)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate e la risoluzione dell'oggetto Graphics indicato.

C#

public Bitmap (int width, int height, System.Drawing.Graphics g);

Parametri

width

Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.

height

Int32

Altezza, in pixel, del nuovo oggetto Bitmap.

g

Graphics

Oggetto Graphics che specifica la risoluzione del nuovo oggetto Bitmap.

Eccezioni

ArgumentNullException

g è null.

Commenti

Il nuovo Bitmap creato da questo metodo accetta rispettivamente la DpiX risoluzione orizzontale e verticale dalle proprietà e DpiY di g.

Bitmap(Int32, Int32, PixelFormat)

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap con le dimensioni e il formato specificati.

C#

public Bitmap (int width, int height, System.Drawing.Imaging.PixelFormat format);

Parametri

width

Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.

height

Int32

Altezza, in pixel, del nuovo oggetto Bitmap.

format

PixelFormat

Formato pixel per il nuovo oggetto Bitmap. Deve specificare un valore che inizia con Format.

Eccezioni

ArgumentException

Viene specificato un valore PixelFormat il cui nome non inizia con Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.

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

Origine:

Bitmap.cs

Inizializza una nuova istanza della classe Bitmap con le dimensioni, il formato pixel e i dati pixel specificati.

C#

public Bitmap (int width, int height, int stride, System.Drawing.Imaging.PixelFormat format, IntPtr scan0);

Parametri

width

Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.

height

Int32

Altezza, in pixel, del nuovo oggetto Bitmap.

stride

Int32

Integer che specifica l'offset di byte tra l'inizio di una linea di digitalizzazione e la successiva. In genere, ma non necessariamente, rappresenta il numero di byte in formato di pixel (ad esempio, 2 x 16 bit per pixel) moltiplicato per la larghezza della bitmap. Il valore passato a questo parametro deve essere un multiplo di quattro.

format

PixelFormat

Formato pixel per il nuovo oggetto Bitmap. Deve specificare un valore che inizia con Format.

scan0

IntPtr

Puntatore a una matrice di byte in cui sono contenuti i dati del record.

Eccezioni

ArgumentException

Viene specificato un valore PixelFormat il cui nome non inizia con Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) costruttore . Questo esempio è progettato per essere usato con Windows Forms e richiede un PaintEventArgs parametro , che è un parametro dell'eventoPaint.

C#

private void BitmapConstructorEx(PaintEventArgs e)
{

    // Create a bitmap.
    Bitmap bmp = new Bitmap("c:\\fakePhoto.jpg");
    
   // Retrieve the bitmap data from the bitmap.
    System.Drawing.Imaging.BitmapData bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), 
        ImageLockMode.ReadOnly, bmp.PixelFormat);

    //Create a new bitmap.
    Bitmap newBitmap = new Bitmap(200, 200, bmpData.Stride, bmp.PixelFormat, bmpData.Scan0);

    bmp.UnlockBits(bmpData);

    // Draw the new bitmap.
    e.Graphics.DrawImage(newBitmap, 10, 10);
}

Commenti

Il chiamante è responsabile dell'allocazione e della liberazione del blocco di memoria specificato dal scan0 parametro . Tuttavia, la memoria non deve essere rilasciata finché non viene rilasciata la relazione Bitmap .