Bitmap.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / DEVDIV / depot / DevDiv / releases / whidbey / NetFxQFE / ndp / fx / src / CommonUI / System / Drawing / Bitmap.cs / 1 / Bitmap.cs

                            //------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

namespace System.Drawing { 
    using System.Runtime.InteropServices; 
    using System.Diagnostics;
    using System.Diagnostics.CodeAnalysis; 
    using System;
    using System.Drawing.Design;
    using System.IO;
    using Microsoft.Win32; 
    using System.ComponentModel;
    using System.Drawing.Imaging; 
    using System.Drawing; 
    using System.Drawing.Internal;
    using System.Runtime.Serialization; 
    using System.Security;
    using System.Security.Permissions;

    ///  
    /// 
    ///    Encapsultates a GDI+ bitmap. 
    ///  
    /**
     * Represent a bitmap image 
     */
    [
    Editor("System.Drawing.Design.BitmapEditor, " + AssemblyRef.SystemDrawingDesign, typeof(UITypeEditor)),
    Serializable, 
    ComVisible(true)
    ] 
    public sealed class Bitmap : Image { 
        private static Color defaultTransparentColor = Color.LightGray;
 
        /*
         * Predefined bitmap data formats
         */
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class from the specified file. 
        /// 
        /**
         * Create a new bitmap object from URL
         */ 
        public Bitmap(String filename) {
            IntSecurity.DemandReadFileIO(filename); 
 
            //GDI+ will read this file multiple times.  Get the fully qualified path
            //so if our app changes default directory we won't get an error 
            //
            filename = Path.GetFullPath(filename);

            IntPtr bitmap = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFile(filename, out bitmap); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap));

            if (status != SafeNativeMethods.Gdip.Ok) { 
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status); 
            } 

            SetNativeImage(bitmap); 

            EnsureSave(this, filename, null);
        }
 
        /// 
        ///  
        ///     
        ///       Initializes a new instance of the  class from the specified
        ///       file. 
        ///    
        /// 
        public Bitmap(String filename, bool useIcm) {
            IntSecurity.DemandReadFileIO(filename); 

            //GDI+ will read this file multiple times.  Get the fully qualified path 
            //so if our app changes default directory we won't get an error 
            //
            filename = Path.GetFullPath(filename); 

            IntPtr bitmap = IntPtr.Zero;
            int status;
 
            if (useIcm) {
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFileICM(filename, out bitmap); 
            } 
            else {
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFile(filename, out bitmap); 
            }

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 
 
            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap)); 
                throw SafeNativeMethods.Gdip.StatusException(status);
            }

            SetNativeImage(bitmap); 

            EnsureSave(this, filename, null); 
        } 

        ///  
        /// 
        ///    
        ///       Initializes a new instance of the  class from a specified resource.
        ///     
        /// 
        public Bitmap(Type type, string resource) { 
            Stream stream = type.Module.Assembly.GetManifestResourceStream(type, resource); 
            if (stream == null)
                throw new ArgumentException(SR.GetString(SR.ResourceNotFound, type, resource)); 

            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 

            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status); 
            }
 
            SetNativeImage(bitmap); 

            EnsureSave(this, null, stream); 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class from the specified data stream. 
        /// 
        /** 
         * Create a new bitmap object from a stream
         */
        public Bitmap(Stream stream) {
 
            if (stream == null)
                throw new ArgumentException(SR.GetString(SR.InvalidArgument, "stream", "null")); 
 
            IntPtr bitmap = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap);

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 
 
            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap)); 
                throw SafeNativeMethods.Gdip.StatusException(status);
            }

            SetNativeImage(bitmap); 

            EnsureSave(this, null, stream); 
        } 

        ///  
        /// 
        ///    
        ///       Initializes a new instance of the  class from the specified data
        ///       stream. 
        ///    
        ///  
        public Bitmap(Stream stream, bool useIcm) { 

            if (stream == null) 
                throw new ArgumentException(SR.GetString(SR.InvalidArgument, "stream", "null"));

            IntPtr bitmap = IntPtr.Zero;
            int status; 

            if (useIcm) { 
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStreamICM(new GPStream(stream), out bitmap); 
            }
            else { 
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap);
            }

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 

            if (status != SafeNativeMethods.Gdip.Ok) { 
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status);
            }
 
            SetNativeImage(bitmap);
 
            EnsureSave(this, null, stream); 
        }
 
        /// 
        /// 
        ///    
        ///       Initializes a new instance of the 
        ///       Bitmap class with the specified size, pixel format, and pixel data.
        ///     
        ///  
        public Bitmap(int width, int height, int stride, PixelFormat format, IntPtr scan0) {
            IntSecurity.ObjectFromWin32Handle.Demand(); 

            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromScan0(width, height, stride, (int) format, new HandleRef(null, scan0), out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap); 
        }

        /// 
        ///  
        ///    
        ///       Initializes a new instance of the Bitmap class with the specified 
        ///       size and format. 
        ///    
        ///  
        public Bitmap(int width, int height, PixelFormat format) {
            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromScan0(width, height, 0, (int) format, NativeMethods.NullHandleRef, out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap); 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class with the specified size. 
        /// 
        public Bitmap(int width, int height) : this(width, height, System.Drawing.Imaging.PixelFormat.Format32bppArgb) { 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class with the specified size and target . 
        /// 
        public Bitmap(int width, int height, Graphics g) { 
            if (g == null)
                throw new ArgumentNullException(SR.GetString(SR.InvalidArgument, "g", "null"));

            IntPtr bitmap = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromGraphics(width, height, new HandleRef(g, g.NativeGraphics), out bitmap); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap);
        }
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class, from the specified existing image, with the specified size. 
        /// 
        public Bitmap(Image original) : this(original, original.Width, original.Height) {
        }
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class, from the specified existing image, with the specified size. 
        /// 
        public Bitmap(Image original, int width, int height) : this(width, height) {
            Graphics g = null;
            try { 
                g = Graphics.FromImage(this);
                g.Clear(Color.Transparent); 
                g.DrawImage(original, 0, 0, width, height); 
            }
            finally { 
                if (g != null) {
                    g.Dispose();
                }
            } 
        }
 
        /** 
         * Constructor used in deserialization
         */ 
        private Bitmap(SerializationInfo info, StreamingContext context) : base(info, context) {
        }

        ///  
        /// 
        ///    Creates a  from a Windows handle to an 
        ///    Icon. 
        /// 
        public static Bitmap FromHicon(IntPtr hicon) { 
            IntSecurity.ObjectFromWin32Handle.Demand();

            IntPtr bitmap = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromHICON(new HandleRef(null, hicon), out bitmap);
 
            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            return Bitmap.FromGDIplus(bitmap);
        }

        ///  
        /// 
        ///  
        public static Bitmap FromResource(IntPtr hinstance, String bitmapName) 
        {
            IntSecurity.ObjectFromWin32Handle.Demand(); 

            IntPtr bitmap;

            IntPtr name = Marshal.StringToHGlobalUni(bitmapName); 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromResource(new HandleRef(null, hinstance), 
                                                              new HandleRef(null, name), 
                                                              out bitmap);
            Marshal.FreeHGlobal(name); 

            if (status != SafeNativeMethods.Gdip.Ok) {
                throw SafeNativeMethods.Gdip.StatusException(status);
            } 

            return Bitmap.FromGDIplus(bitmap); 
        } 

        ///  
        /// 
        ///    
        ///       Creates a Win32 HBITMAP out of the image. You are responsible for
        ///       de-allocating the HBITMAP with Windows.DeleteObject(handle). If the image uses 
        ///       transparency, the background will be filled with the specified background
        ///       color. 
        ///     
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        [EditorBrowsable(EditorBrowsableState.Advanced)]
        public IntPtr GetHbitmap() {
            return GetHbitmap(Color.LightGray);
        } 

        ///  
        ///  
        ///     Creates a Win32 HBITMAP out of the image.  You are responsible for
        ///     de-allocating the HBITMAP with Windows.DeleteObject(handle). 
        ///     If the image uses transparency, the background will be filled with the specified background color.
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)]
        [EditorBrowsable(EditorBrowsableState.Advanced)] 
        public IntPtr GetHbitmap(Color background) {
            IntPtr hBitmap = IntPtr.Zero; 
 
            int status = SafeNativeMethods.Gdip.GdipCreateHBITMAPFromBitmap(new HandleRef(this, nativeImage), out hBitmap,
                                                             ColorTranslator.ToWin32(background)); 
            if(status == 2 /* invalid parameter*/ && (this.Width >= Int16.MaxValue || this.Height >= Int16.MaxValue)) {
                throw (new ArgumentException(SR.GetString(SR.GdiplusInvalidSize)));
            }
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
 
            return hBitmap;
        } 

        /// 
        /// 
        ///    Returns the handle to an icon. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        [EditorBrowsable(EditorBrowsableState.Advanced)] 
        public IntPtr GetHicon() {
            IntPtr hIcon = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateHICONFromBitmap(new HandleRef(this, nativeImage), out hIcon);

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            return hIcon; 
        }
 
        /// 
        /// 
        ///    
        ///       Initializes a new instance of the  class, from the specified 
        ///       existing image, with the specified size.
        ///     
        ///  
        public Bitmap(Image original, Size newSize) :
        this(original, (object) newSize != null ? newSize.Width : 0, (object) newSize != null ? newSize.Height : 0) { 
        }

        // for use with CreateFromGDIplus
        private Bitmap() { 
        }
 
        /* 
         * Create a new bitmap object from a native bitmap handle.
         * This is only for internal purpose. 
         */
        internal static Bitmap FromGDIplus(IntPtr handle) {
            Bitmap result = new Bitmap();
            result.SetNativeImage(handle); 
            return result;
        } 
 
        /// 
        ///  
        ///    Creates a copy of the section of this
        ///    Bitmap defined by  with a specified .
        /// 
        // int version 
        public Bitmap Clone(Rectangle rect, PixelFormat format) {
 
            //validate the rect 
            if (rect.Width == 0 || rect.Height == 0) {
                throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString())); 
            }

            IntPtr dstHandle = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCloneBitmapAreaI(
                                                     rect.X, 
                                                     rect.Y, 
                                                     rect.Width,
                                                     rect.Height, 
                                                     (int) format,
                                                     new HandleRef(this, nativeImage),
                                                     out dstHandle);
 
            if (status != SafeNativeMethods.Gdip.Ok || dstHandle == IntPtr.Zero)
                throw SafeNativeMethods.Gdip.StatusException(status); 
 
            return Bitmap.FromGDIplus(dstHandle);
        } 

        /// 
        /// 
        ///     
        ///       Creates a copy of the section of this
        ///       Bitmap defined by  with a specified . 
        ///     
        /// 
        // float version 
        public Bitmap Clone(RectangleF rect, PixelFormat format) {

            //validate the rect
            if (rect.Width == 0 || rect.Height == 0) { 
                throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
            } 
 
            IntPtr dstHandle = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCloneBitmapArea(
                                                    rect.X,
                                                    rect.Y,
                                                    rect.Width, 
                                                    rect.Height,
                                                    (int) format, 
                                                    new HandleRef(this, nativeImage), 
                                                    out dstHandle);
 
            if (status != SafeNativeMethods.Gdip.Ok || dstHandle == IntPtr.Zero)
                throw SafeNativeMethods.Gdip.StatusException(status);

            return Bitmap.FromGDIplus(dstHandle); 
        }
 
        ///  
        /// 
        ///     
        ///       Makes the default transparent color transparent for this 
        ///       .
        ///    
        ///  
        public void MakeTransparent() {
            Color transparent = defaultTransparentColor; 
            if (Height > 0 && Width > 0) 
                transparent = GetPixel(0, Size.Height - 1);
            if (transparent.A < 255) { 
                // It's already transparent, and if we proceeded, we will do something
                // unintended like making black transparent
                return;
            } 
            MakeTransparent(transparent);
        } 
 
        /// 
        ///  
        ///    Makes the specified color transparent
        ///    for this .
        /// 
        [SuppressMessage("Microsoft.Reliability", "CA2000:DisposeObjectsBeforeLosingScope")] 
        public void MakeTransparent(Color transparentColor) {
            if (RawFormat.Guid == ImageFormat.Icon.Guid) { 
                throw new InvalidOperationException(SR.GetString(SR.CantMakeIconTransparent)); 
            }
 
            Size size = Size;

            // The new bitmap must be in 32bppARGB  format, because that's the only
            // thing that supports alpha.  (And that's what the image is initialized to -- transparent) 
            Bitmap result = null;
            Graphics graphics = null; 
            try { 
                result = new Bitmap(size.Width, size.Height, PixelFormat.Format32bppArgb);
                try { 
                    graphics = Graphics.FromImage(result);
                    graphics.Clear(Color.Transparent);
                    Rectangle rectangle = new Rectangle(0,0, size.Width, size.Height);
 
                    ImageAttributes attributes = null;
                    try { 
                        attributes = new ImageAttributes(); 
                        attributes.SetColorKey(transparentColor, transparentColor);
                        graphics.DrawImage(this, rectangle, 
                                           0,0, size.Width, size.Height,
                                           GraphicsUnit.Pixel, attributes, null, IntPtr.Zero);
                    }
                    finally { 
                        if (attributes != null) {
                            attributes.Dispose(); 
                        } 
                    }
                } 
                finally {
                    if (graphics != null) {
                        graphics.Dispose();
                    } 
                }
 
                // Swap nativeImage pointers to make it look like we modified the image in place 
                IntPtr temp = this.nativeImage;
                this.nativeImage = result.nativeImage; 
                result.nativeImage = temp;
            }
            finally {
                if (result != null) { 
                    result.Dispose();
                } 
 
            }
        } 

        /// 
        /// 
        ///    Locks a Bitmap into system memory. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        public BitmapData LockBits(Rectangle rect, ImageLockMode flags, PixelFormat format) { 
            BitmapData bitmapData = new BitmapData();
 
            return LockBits(rect, flags, format, bitmapData);
        }

        ///  
        /// 
        ///    Locks a Bitmap into system memory.  This overload takes a user-defined 
        ///    BitmapData object and is intended to be used with an ImageLockMode.UserInputBuffer. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        public BitmapData LockBits(Rectangle rect, ImageLockMode flags, PixelFormat format, BitmapData bitmapData)
        {

            GPRECT gprect = new GPRECT(rect); 
            int status = SafeNativeMethods.Gdip.GdipBitmapLockBits(new HandleRef(this, nativeImage), ref gprect,
                                                    flags, format, bitmapData); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            return bitmapData;
        }
 

        ///  
        ///  
        ///    Unlocks this  from system memory.
        ///  
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)]
        public void UnlockBits(BitmapData bitmapdata) {
            int status = SafeNativeMethods.Gdip.GdipBitmapUnlockBits(new HandleRef(this, nativeImage), bitmapdata);
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
        } 

        ///  
        /// 
        ///    
        ///       Gets the color of the specified pixel
        ///       in this . 
        ///    
        ///  
        public Color GetPixel(int x, int y) { 

            int color = 0; 

            if (x < 0 || x >= Width) {
                throw new ArgumentOutOfRangeException("x", SR.GetString(SR.ValidRangeX));
            } 

            if (y < 0 || y >= Height) { 
                throw new ArgumentOutOfRangeException("y", SR.GetString(SR.ValidRangeY)); 
            }
 
            int status = SafeNativeMethods.Gdip.GdipBitmapGetPixel(new HandleRef(this, nativeImage), x, y, out color);

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            return Color.FromArgb(color); 
        } 

        ///  
        /// 
        ///    
        ///       Sets the color of the specified pixel in this  .
        ///     
        /// 
        public void SetPixel(int x, int y, Color color) { 
            if ((PixelFormat & PixelFormat.Indexed) != 0) { 
                throw new InvalidOperationException(SR.GetString(SR.GdiplusCannotSetPixelFromIndexedPixelFormat));
            } 

            if (x < 0 || x >= Width) {
                throw new ArgumentOutOfRangeException("x", SR.GetString(SR.ValidRangeX));
            } 

            if (y < 0 || y >= Height) { 
                throw new ArgumentOutOfRangeException("y", SR.GetString(SR.ValidRangeY)); 
            }
 
            int status = SafeNativeMethods.Gdip.GdipBitmapSetPixel(new HandleRef(this, nativeImage), x, y, color.ToArgb());

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
        }
 
        ///  
        /// 
        ///    Sets the resolution for this . 
        /// 
        [SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly")]
        public void SetResolution(float xDpi, float yDpi) {
            int status = SafeNativeMethods.Gdip.GdipBitmapSetResolution(new HandleRef(this, nativeImage), xDpi, yDpi); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 
        }
    } 
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

namespace System.Drawing { 
    using System.Runtime.InteropServices; 
    using System.Diagnostics;
    using System.Diagnostics.CodeAnalysis; 
    using System;
    using System.Drawing.Design;
    using System.IO;
    using Microsoft.Win32; 
    using System.ComponentModel;
    using System.Drawing.Imaging; 
    using System.Drawing; 
    using System.Drawing.Internal;
    using System.Runtime.Serialization; 
    using System.Security;
    using System.Security.Permissions;

    ///  
    /// 
    ///    Encapsultates a GDI+ bitmap. 
    ///  
    /**
     * Represent a bitmap image 
     */
    [
    Editor("System.Drawing.Design.BitmapEditor, " + AssemblyRef.SystemDrawingDesign, typeof(UITypeEditor)),
    Serializable, 
    ComVisible(true)
    ] 
    public sealed class Bitmap : Image { 
        private static Color defaultTransparentColor = Color.LightGray;
 
        /*
         * Predefined bitmap data formats
         */
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class from the specified file. 
        /// 
        /**
         * Create a new bitmap object from URL
         */ 
        public Bitmap(String filename) {
            IntSecurity.DemandReadFileIO(filename); 
 
            //GDI+ will read this file multiple times.  Get the fully qualified path
            //so if our app changes default directory we won't get an error 
            //
            filename = Path.GetFullPath(filename);

            IntPtr bitmap = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFile(filename, out bitmap); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap));

            if (status != SafeNativeMethods.Gdip.Ok) { 
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status); 
            } 

            SetNativeImage(bitmap); 

            EnsureSave(this, filename, null);
        }
 
        /// 
        ///  
        ///     
        ///       Initializes a new instance of the  class from the specified
        ///       file. 
        ///    
        /// 
        public Bitmap(String filename, bool useIcm) {
            IntSecurity.DemandReadFileIO(filename); 

            //GDI+ will read this file multiple times.  Get the fully qualified path 
            //so if our app changes default directory we won't get an error 
            //
            filename = Path.GetFullPath(filename); 

            IntPtr bitmap = IntPtr.Zero;
            int status;
 
            if (useIcm) {
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFileICM(filename, out bitmap); 
            } 
            else {
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromFile(filename, out bitmap); 
            }

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 
 
            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap)); 
                throw SafeNativeMethods.Gdip.StatusException(status);
            }

            SetNativeImage(bitmap); 

            EnsureSave(this, filename, null); 
        } 

        ///  
        /// 
        ///    
        ///       Initializes a new instance of the  class from a specified resource.
        ///     
        /// 
        public Bitmap(Type type, string resource) { 
            Stream stream = type.Module.Assembly.GetManifestResourceStream(type, resource); 
            if (stream == null)
                throw new ArgumentException(SR.GetString(SR.ResourceNotFound, type, resource)); 

            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 

            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status); 
            }
 
            SetNativeImage(bitmap); 

            EnsureSave(this, null, stream); 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class from the specified data stream. 
        /// 
        /** 
         * Create a new bitmap object from a stream
         */
        public Bitmap(Stream stream) {
 
            if (stream == null)
                throw new ArgumentException(SR.GetString(SR.InvalidArgument, "stream", "null")); 
 
            IntPtr bitmap = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap);

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 
 
            if (status != SafeNativeMethods.Gdip.Ok) {
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap)); 
                throw SafeNativeMethods.Gdip.StatusException(status);
            }

            SetNativeImage(bitmap); 

            EnsureSave(this, null, stream); 
        } 

        ///  
        /// 
        ///    
        ///       Initializes a new instance of the  class from the specified data
        ///       stream. 
        ///    
        ///  
        public Bitmap(Stream stream, bool useIcm) { 

            if (stream == null) 
                throw new ArgumentException(SR.GetString(SR.InvalidArgument, "stream", "null"));

            IntPtr bitmap = IntPtr.Zero;
            int status; 

            if (useIcm) { 
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStreamICM(new GPStream(stream), out bitmap); 
            }
            else { 
                status = SafeNativeMethods.Gdip.GdipCreateBitmapFromStream(new GPStream(stream), out bitmap);
            }

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            status = SafeNativeMethods.Gdip.GdipImageForceValidation(new HandleRef(null, bitmap)); 

            if (status != SafeNativeMethods.Gdip.Ok) { 
                SafeNativeMethods.Gdip.GdipDisposeImage(new HandleRef(null, bitmap));
                throw SafeNativeMethods.Gdip.StatusException(status);
            }
 
            SetNativeImage(bitmap);
 
            EnsureSave(this, null, stream); 
        }
 
        /// 
        /// 
        ///    
        ///       Initializes a new instance of the 
        ///       Bitmap class with the specified size, pixel format, and pixel data.
        ///     
        ///  
        public Bitmap(int width, int height, int stride, PixelFormat format, IntPtr scan0) {
            IntSecurity.ObjectFromWin32Handle.Demand(); 

            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromScan0(width, height, stride, (int) format, new HandleRef(null, scan0), out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap); 
        }

        /// 
        ///  
        ///    
        ///       Initializes a new instance of the Bitmap class with the specified 
        ///       size and format. 
        ///    
        ///  
        public Bitmap(int width, int height, PixelFormat format) {
            IntPtr bitmap = IntPtr.Zero;

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromScan0(width, height, 0, (int) format, NativeMethods.NullHandleRef, out bitmap); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap); 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class with the specified size. 
        /// 
        public Bitmap(int width, int height) : this(width, height, System.Drawing.Imaging.PixelFormat.Format32bppArgb) { 
        }

        /// 
        ///  
        ///    Initializes a new instance of the
        ///  
        /// class with the specified size and target . 
        /// 
        public Bitmap(int width, int height, Graphics g) { 
            if (g == null)
                throw new ArgumentNullException(SR.GetString(SR.InvalidArgument, "g", "null"));

            IntPtr bitmap = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromGraphics(width, height, new HandleRef(g, g.NativeGraphics), out bitmap); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            SetNativeImage(bitmap);
        }
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class, from the specified existing image, with the specified size. 
        /// 
        public Bitmap(Image original) : this(original, original.Width, original.Height) {
        }
 
        /// 
        ///  
        ///    Initializes a new instance of the 
        /// 
        /// class, from the specified existing image, with the specified size. 
        /// 
        public Bitmap(Image original, int width, int height) : this(width, height) {
            Graphics g = null;
            try { 
                g = Graphics.FromImage(this);
                g.Clear(Color.Transparent); 
                g.DrawImage(original, 0, 0, width, height); 
            }
            finally { 
                if (g != null) {
                    g.Dispose();
                }
            } 
        }
 
        /** 
         * Constructor used in deserialization
         */ 
        private Bitmap(SerializationInfo info, StreamingContext context) : base(info, context) {
        }

        ///  
        /// 
        ///    Creates a  from a Windows handle to an 
        ///    Icon. 
        /// 
        public static Bitmap FromHicon(IntPtr hicon) { 
            IntSecurity.ObjectFromWin32Handle.Demand();

            IntPtr bitmap = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromHICON(new HandleRef(null, hicon), out bitmap);
 
            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            return Bitmap.FromGDIplus(bitmap);
        }

        ///  
        /// 
        ///  
        public static Bitmap FromResource(IntPtr hinstance, String bitmapName) 
        {
            IntSecurity.ObjectFromWin32Handle.Demand(); 

            IntPtr bitmap;

            IntPtr name = Marshal.StringToHGlobalUni(bitmapName); 

            int status = SafeNativeMethods.Gdip.GdipCreateBitmapFromResource(new HandleRef(null, hinstance), 
                                                              new HandleRef(null, name), 
                                                              out bitmap);
            Marshal.FreeHGlobal(name); 

            if (status != SafeNativeMethods.Gdip.Ok) {
                throw SafeNativeMethods.Gdip.StatusException(status);
            } 

            return Bitmap.FromGDIplus(bitmap); 
        } 

        ///  
        /// 
        ///    
        ///       Creates a Win32 HBITMAP out of the image. You are responsible for
        ///       de-allocating the HBITMAP with Windows.DeleteObject(handle). If the image uses 
        ///       transparency, the background will be filled with the specified background
        ///       color. 
        ///     
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        [EditorBrowsable(EditorBrowsableState.Advanced)]
        public IntPtr GetHbitmap() {
            return GetHbitmap(Color.LightGray);
        } 

        ///  
        ///  
        ///     Creates a Win32 HBITMAP out of the image.  You are responsible for
        ///     de-allocating the HBITMAP with Windows.DeleteObject(handle). 
        ///     If the image uses transparency, the background will be filled with the specified background color.
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)]
        [EditorBrowsable(EditorBrowsableState.Advanced)] 
        public IntPtr GetHbitmap(Color background) {
            IntPtr hBitmap = IntPtr.Zero; 
 
            int status = SafeNativeMethods.Gdip.GdipCreateHBITMAPFromBitmap(new HandleRef(this, nativeImage), out hBitmap,
                                                             ColorTranslator.ToWin32(background)); 
            if(status == 2 /* invalid parameter*/ && (this.Width >= Int16.MaxValue || this.Height >= Int16.MaxValue)) {
                throw (new ArgumentException(SR.GetString(SR.GdiplusInvalidSize)));
            }
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
 
            return hBitmap;
        } 

        /// 
        /// 
        ///    Returns the handle to an icon. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        [EditorBrowsable(EditorBrowsableState.Advanced)] 
        public IntPtr GetHicon() {
            IntPtr hIcon = IntPtr.Zero; 

            int status = SafeNativeMethods.Gdip.GdipCreateHICONFromBitmap(new HandleRef(this, nativeImage), out hIcon);

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status);
 
            return hIcon; 
        }
 
        /// 
        /// 
        ///    
        ///       Initializes a new instance of the  class, from the specified 
        ///       existing image, with the specified size.
        ///     
        ///  
        public Bitmap(Image original, Size newSize) :
        this(original, (object) newSize != null ? newSize.Width : 0, (object) newSize != null ? newSize.Height : 0) { 
        }

        // for use with CreateFromGDIplus
        private Bitmap() { 
        }
 
        /* 
         * Create a new bitmap object from a native bitmap handle.
         * This is only for internal purpose. 
         */
        internal static Bitmap FromGDIplus(IntPtr handle) {
            Bitmap result = new Bitmap();
            result.SetNativeImage(handle); 
            return result;
        } 
 
        /// 
        ///  
        ///    Creates a copy of the section of this
        ///    Bitmap defined by  with a specified .
        /// 
        // int version 
        public Bitmap Clone(Rectangle rect, PixelFormat format) {
 
            //validate the rect 
            if (rect.Width == 0 || rect.Height == 0) {
                throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString())); 
            }

            IntPtr dstHandle = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCloneBitmapAreaI(
                                                     rect.X, 
                                                     rect.Y, 
                                                     rect.Width,
                                                     rect.Height, 
                                                     (int) format,
                                                     new HandleRef(this, nativeImage),
                                                     out dstHandle);
 
            if (status != SafeNativeMethods.Gdip.Ok || dstHandle == IntPtr.Zero)
                throw SafeNativeMethods.Gdip.StatusException(status); 
 
            return Bitmap.FromGDIplus(dstHandle);
        } 

        /// 
        /// 
        ///     
        ///       Creates a copy of the section of this
        ///       Bitmap defined by  with a specified . 
        ///     
        /// 
        // float version 
        public Bitmap Clone(RectangleF rect, PixelFormat format) {

            //validate the rect
            if (rect.Width == 0 || rect.Height == 0) { 
                throw new ArgumentException(SR.GetString(SR.GdiplusInvalidRectangle, rect.ToString()));
            } 
 
            IntPtr dstHandle = IntPtr.Zero;
 
            int status = SafeNativeMethods.Gdip.GdipCloneBitmapArea(
                                                    rect.X,
                                                    rect.Y,
                                                    rect.Width, 
                                                    rect.Height,
                                                    (int) format, 
                                                    new HandleRef(this, nativeImage), 
                                                    out dstHandle);
 
            if (status != SafeNativeMethods.Gdip.Ok || dstHandle == IntPtr.Zero)
                throw SafeNativeMethods.Gdip.StatusException(status);

            return Bitmap.FromGDIplus(dstHandle); 
        }
 
        ///  
        /// 
        ///     
        ///       Makes the default transparent color transparent for this 
        ///       .
        ///    
        ///  
        public void MakeTransparent() {
            Color transparent = defaultTransparentColor; 
            if (Height > 0 && Width > 0) 
                transparent = GetPixel(0, Size.Height - 1);
            if (transparent.A < 255) { 
                // It's already transparent, and if we proceeded, we will do something
                // unintended like making black transparent
                return;
            } 
            MakeTransparent(transparent);
        } 
 
        /// 
        ///  
        ///    Makes the specified color transparent
        ///    for this .
        /// 
        [SuppressMessage("Microsoft.Reliability", "CA2000:DisposeObjectsBeforeLosingScope")] 
        public void MakeTransparent(Color transparentColor) {
            if (RawFormat.Guid == ImageFormat.Icon.Guid) { 
                throw new InvalidOperationException(SR.GetString(SR.CantMakeIconTransparent)); 
            }
 
            Size size = Size;

            // The new bitmap must be in 32bppARGB  format, because that's the only
            // thing that supports alpha.  (And that's what the image is initialized to -- transparent) 
            Bitmap result = null;
            Graphics graphics = null; 
            try { 
                result = new Bitmap(size.Width, size.Height, PixelFormat.Format32bppArgb);
                try { 
                    graphics = Graphics.FromImage(result);
                    graphics.Clear(Color.Transparent);
                    Rectangle rectangle = new Rectangle(0,0, size.Width, size.Height);
 
                    ImageAttributes attributes = null;
                    try { 
                        attributes = new ImageAttributes(); 
                        attributes.SetColorKey(transparentColor, transparentColor);
                        graphics.DrawImage(this, rectangle, 
                                           0,0, size.Width, size.Height,
                                           GraphicsUnit.Pixel, attributes, null, IntPtr.Zero);
                    }
                    finally { 
                        if (attributes != null) {
                            attributes.Dispose(); 
                        } 
                    }
                } 
                finally {
                    if (graphics != null) {
                        graphics.Dispose();
                    } 
                }
 
                // Swap nativeImage pointers to make it look like we modified the image in place 
                IntPtr temp = this.nativeImage;
                this.nativeImage = result.nativeImage; 
                result.nativeImage = temp;
            }
            finally {
                if (result != null) { 
                    result.Dispose();
                } 
 
            }
        } 

        /// 
        /// 
        ///    Locks a Bitmap into system memory. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        public BitmapData LockBits(Rectangle rect, ImageLockMode flags, PixelFormat format) { 
            BitmapData bitmapData = new BitmapData();
 
            return LockBits(rect, flags, format, bitmapData);
        }

        ///  
        /// 
        ///    Locks a Bitmap into system memory.  This overload takes a user-defined 
        ///    BitmapData object and is intended to be used with an ImageLockMode.UserInputBuffer. 
        /// 
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)] 
        public BitmapData LockBits(Rectangle rect, ImageLockMode flags, PixelFormat format, BitmapData bitmapData)
        {

            GPRECT gprect = new GPRECT(rect); 
            int status = SafeNativeMethods.Gdip.GdipBitmapLockBits(new HandleRef(this, nativeImage), ref gprect,
                                                    flags, format, bitmapData); 
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            return bitmapData;
        }
 

        ///  
        ///  
        ///    Unlocks this  from system memory.
        ///  
        [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)]
        public void UnlockBits(BitmapData bitmapdata) {
            int status = SafeNativeMethods.Gdip.GdipBitmapUnlockBits(new HandleRef(this, nativeImage), bitmapdata);
 
            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
        } 

        ///  
        /// 
        ///    
        ///       Gets the color of the specified pixel
        ///       in this . 
        ///    
        ///  
        public Color GetPixel(int x, int y) { 

            int color = 0; 

            if (x < 0 || x >= Width) {
                throw new ArgumentOutOfRangeException("x", SR.GetString(SR.ValidRangeX));
            } 

            if (y < 0 || y >= Height) { 
                throw new ArgumentOutOfRangeException("y", SR.GetString(SR.ValidRangeY)); 
            }
 
            int status = SafeNativeMethods.Gdip.GdipBitmapGetPixel(new HandleRef(this, nativeImage), x, y, out color);

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 

            return Color.FromArgb(color); 
        } 

        ///  
        /// 
        ///    
        ///       Sets the color of the specified pixel in this  .
        ///     
        /// 
        public void SetPixel(int x, int y, Color color) { 
            if ((PixelFormat & PixelFormat.Indexed) != 0) { 
                throw new InvalidOperationException(SR.GetString(SR.GdiplusCannotSetPixelFromIndexedPixelFormat));
            } 

            if (x < 0 || x >= Width) {
                throw new ArgumentOutOfRangeException("x", SR.GetString(SR.ValidRangeX));
            } 

            if (y < 0 || y >= Height) { 
                throw new ArgumentOutOfRangeException("y", SR.GetString(SR.ValidRangeY)); 
            }
 
            int status = SafeNativeMethods.Gdip.GdipBitmapSetPixel(new HandleRef(this, nativeImage), x, y, color.ToArgb());

            if (status != SafeNativeMethods.Gdip.Ok)
                throw SafeNativeMethods.Gdip.StatusException(status); 
        }
 
        ///  
        /// 
        ///    Sets the resolution for this . 
        /// 
        [SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly")]
        public void SetResolution(float xDpi, float yDpi) {
            int status = SafeNativeMethods.Gdip.GdipBitmapSetResolution(new HandleRef(this, nativeImage), xDpi, yDpi); 

            if (status != SafeNativeMethods.Gdip.Ok) 
                throw SafeNativeMethods.Gdip.StatusException(status); 
        }
    } 
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.

                        

Link Menu

Network programming in C#, Network Programming in VB.NET, Network Programming in .NET
This book is available now!
Buy at Amazon US or
Buy at Amazon UK