CachedBitmap.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 / Orcas / QFE / wpf / src / Core / CSharp / System / Windows / Media / Imaging / CachedBitmap.cs / 1 / CachedBitmap.cs

                            //------------------------------------------------------------------------------ 
//  Microsoft Avalon
//  Copyright (c) Microsoft Corporation.  All Rights Reserved.
//
//  File: CachedBitmap.cs 
//
//----------------------------------------------------------------------------- 
 

using System; 
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.ComponentModel; 
using System.ComponentModel.Design.Serialization;
using System.Reflection; 
using MS.Internal; 
using MS.Win32.PresentationCore;
using System.Security; 
using System.Security.Permissions;
using System.Diagnostics;
using System.Windows.Media;
using System.Globalization; 
using System.Runtime.InteropServices;
using System.Windows; 
using System.Windows.Media.Animation; 
using System.Windows.Media.Composition;
 
using SR=MS.Internal.PresentationCore.SR;
using SRID=MS.Internal.PresentationCore.SRID;

namespace System.Windows.Media.Imaging 
{
    #region CachedBitmap 
 
    /// 
    /// CachedBitmap provides caching functionality for a BitmapSource. 
    /// 
    public sealed class CachedBitmap : System.Windows.Media.Imaging.BitmapSource
    {
        ///  
        /// Construct a CachedBitmap
        ///  
        /// BitmapSource to apply to the crop to 
        /// CreateOptions for the new Bitmap
        /// CacheOption for the new Bitmap 
        public CachedBitmap(BitmapSource source, BitmapCreateOptions createOptions, BitmapCacheOption cacheOption)
            : base(true) // Use base class virtuals
        {
            if (source == null) 
            {
                throw new ArgumentNullException("source"); 
            } 

            BeginInit(); 
            _source = source;
            _createOptions = createOptions;
            _cacheOption = cacheOption;
            _syncObject = source.SyncObject; 

            EndInit(); 
        } 

        ///  
        /// 
        /// 
        /// Critical - access critical code, accepts pointer arguments
        ///  
        [SecurityCritical]
        unsafe internal CachedBitmap( 
                    int pixelWidth, 
                    int pixelHeight,
                    double dpiX, 
                    double dpiY,
                    PixelFormat pixelFormat,
                    BitmapPalette palette,
                    IntPtr buffer, 
                    int bufferSize,
                    int stride 
                    ) 

            : base(true) // Use base class virtuals 
        {
            InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                              pixelFormat, palette,
                              buffer, bufferSize, stride); 
        }
 
        ///  
        ///     Creates a managed BitmapSource wrapper around a pre-existing
        ///     unmanaged bitmap. 
        /// 
        /// 
        ///     Critical - access critical code, accepts pointer
        ///  
        [SecurityCritical]
        internal CachedBitmap(BitmapSourceSafeMILHandle bitmap) : base(true) 
        { 
            if (bitmap == null)
            { 
                throw new ArgumentNullException("bitmap");
            }

            // We're not calling CachedBitmap.Begin/EndInit because that would 
            // invoke FinalizeCreation which calls CreateCachedBitmap that does
            // unnecessary work and only deals with BitmapFrames 
            _bitmapInit.BeginInit(); 

            _source = null; 
            _createOptions = BitmapCreateOptions.None;
            _cacheOption = BitmapCacheOption.OnLoad;

            // This will QI to IWICBitmapSource for us. QI also AddRefs, of course. 
            WicSourceHandle = bitmap;
            _syncObject = WicSourceHandle; 
 
            IsSourceCached = true;
            CreationCompleted = true; 

            _bitmapInit.EndInit();
        }
 
        /// 
        /// Create an Empty CachedBitap 
        ///  
        private CachedBitmap()
            : base(true) // Use base class virtuals 
        {
        }

        ///  
        /// 
        ///  
        /// Critical - calls unmanaged objects 
        /// TreatAsSafe - all inputs verified, including buffer sizes
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        unsafe internal CachedBitmap(
            int pixelWidth,
            int pixelHeight, 
            double dpiX,
            double dpiY, 
            PixelFormat pixelFormat, 
            BitmapPalette palette,
            System.Array pixels, 
            int stride
            )
            : base(true) // Use base class virtuals
        { 
            if (pixels == null)
                throw new System.ArgumentNullException ("pixels"); 
 
            if (pixels.Rank != 1)
                throw new ArgumentException (SR.Get (SRID.Collection_BadRank), "pixels"); 

            int elementSize = -1;

            if (pixels is byte[]) 
                elementSize = 1;
            else if (pixels is short[] || pixels is ushort[]) 
                elementSize = 2; 
            else if (pixels is int[] || pixels is uint[] || pixels is float[])
                elementSize = 4; 
            else if (pixels is double[])
                elementSize = 8;

            if (elementSize == -1) 
                throw new ArgumentException(SR.Get(SRID.Image_InvalidArrayForPixel));
 
            int destBufferSize = elementSize * pixels.Length; 

            if (pixels is byte[]) 
            {
                fixed(void * pixelArray = (byte[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is short[]) 
            {
                fixed(void * pixelArray = (short[])pixels) 
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is ushort[])
            { 
                fixed(void * pixelArray = (ushort[])pixels) 
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            }
            else if (pixels is int[])
            { 
                fixed(void * pixelArray = (int[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is uint[])
            {
                fixed(void * pixelArray = (uint[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride); 
            } 
            else if (pixels is float[])
            { 
                fixed(void * pixelArray = (float[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride); 
            }
            else if (pixels is double[]) 
            { 
                fixed(void * pixelArray = (double[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride);
            }
        } 

        ///  
        /// Common implementation for CloneCore(), CloneCurrentValueCore(), 
        /// GetAsFrozenCore(), and GetCurrentValueAsFrozenCore().
        ///  
        /// 
        /// Critical - calls critical InitFromWICSource
        /// 
        [SecurityCritical] 
        private void CopyCommon(CachedBitmap sourceBitmap)
        { 
            // Avoid Animatable requesting resource updates for invalidations that occur during construction 
            Animatable_IsResourceInvalidationNecessary = false;
 
            if (sourceBitmap._source != null)
            {
                BeginInit();
                _syncObject = sourceBitmap._syncObject; 
                _source = sourceBitmap._source;
                _createOptions = sourceBitmap._createOptions; 
                _cacheOption = sourceBitmap._cacheOption; 

                // 
                if (_cacheOption == BitmapCacheOption.OnDemand)
                    _cacheOption = BitmapCacheOption.OnLoad;
                EndInit();
            } 
            else
            { 
                InitFromWICSource(sourceBitmap.WicSourceHandle); 
            }
            // The next invalidation will cause Animatable to register an UpdateResource callback 
            Animatable_IsResourceInvalidationNecessary = true;
        }

 
        // ISupportInitialize
 
        ///  
        /// Prepare the bitmap to accept initialize paramters.
        ///  
        private void BeginInit()
        {
            _bitmapInit.BeginInit();
        } 

        ///  
        /// Prepare the bitmap to accept initialize paramters. 
        /// 
        ///  
        /// Critical - access critical resources
        /// TreatAsSafe - All inputs verified
        /// 
        [SecurityCritical, SecurityTreatAsSafe] 
        private void EndInit()
        { 
            _bitmapInit.EndInit(); 

            // if we don't need to delay, let 'er rip 
            if (!DelayCreation)
                FinalizeCreation();
        }
 
        ///
        /// Create the unmanaged resources 
        /// 
        /// 
        /// Critical - access critical resource 
        /// 
        [SecurityCritical]
        internal override void FinalizeCreation()
        { 
            lock (_syncObject)
            { 
                WicSourceHandle = CreateCachedBitmap(_source as BitmapFrame, _source.WicSourceHandle, _createOptions, _cacheOption, _source.Palette); 
            }
 
            IsSourceCached = (_cacheOption != BitmapCacheOption.None);
            CreationCompleted = true;
            UpdateCachedSettings();
        } 

        #region Public Methods 
        ///  
        ///     Shadows inherited Copy() with a strongly typed
        ///     version for convenience. 
        /// 
        public new CachedBitmap Clone()
        {
            return (CachedBitmap)base.Clone(); 
        }
 
        ///  
        ///     Shadows inherited CloneCurrentValue() with a
        ///     strongly typed version for convenience. 
        /// 
        public new CachedBitmap CloneCurrentValue()
        {
            return (CachedBitmap)base.CloneCurrentValue(); 
        }
 
        #endregion Public Methods 

        //----------------------------------------------------- 
        //
        //  Protected Methods
        //
        //----------------------------------------------------- 

        #region Protected Methods 
 
        /// 
        /// Implementation of Freezable.CreateInstanceCore. 
        /// 
        /// The new Freezable.
        /// 
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces clone of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe] 
        protected override Freezable CreateInstanceCore()
        { 
            return new CachedBitmap();
        }

        ///  
        /// Implementation of Freezable.CloneCore.
        ///  
        ///  
        /// Critical - accesses critical code.
        /// TreatAsSafe - method only produces clone of original image. 
        /// 
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void CloneCore(Freezable sourceFreezable)
        { 
            CachedBitmap sourceBitmap = (CachedBitmap) sourceFreezable;
 
            base.CloneCore(sourceFreezable); 

            CopyCommon(sourceBitmap); 
        }

        /// 
        /// Implementation of Freezable.CloneCurrentValueCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces clone of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void CloneCurrentValueCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap) sourceFreezable; 

            base.CloneCurrentValueCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 


        /// 
        /// Implementation of Freezable.GetAsFrozenCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces GetAsFrozen of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void GetAsFrozenCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap)sourceFreezable; 

            base.GetAsFrozenCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 


        /// 
        /// Implementation of Freezable.GetCurrentValueAsFrozenCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces GetCurrentValueAsFrozen of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void GetCurrentValueAsFrozenCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap)sourceFreezable; 

            base.GetCurrentValueAsFrozenCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 

        #endregion ProtectedMethods

        /// 
        /// Create from WICBitmapSource
        /// 
        ///  
        /// Critical - calls unmanaged objects
        ///  
        [SecurityCritical]
        private void InitFromWICSource(
                    SafeMILHandle wicSource
                    ) 
        {
            _bitmapInit.BeginInit(); 
 
            BitmapSourceSafeMILHandle bitmapSource = null;
 
            lock (_syncObject)
            {
                using (FactoryMaker factoryMaker = new FactoryMaker())
                { 
                    HRESULT.Check(UnsafeNativeMethods.WICImagingFactory.CreateBitmapFromSource(
                            factoryMaker.ImagingFactoryPtr, 
                            wicSource, 
                            WICBitmapCreateCacheOptions.WICBitmapCacheOnLoad,
                            out bitmapSource)); 
                }

                bitmapSource.CalculateSize();
            } 
            WicSourceHandle = bitmapSource;
            _isSourceCached = true; 
 
            _bitmapInit.EndInit();
 
            UpdateCachedSettings();
        }

        /// 
        /// Create from memory
        /// 
        ///  
        /// Critical - calls unmanaged objects, accepts pointer parameters
        ///  
        [SecurityCritical]
        private void InitFromMemoryPtr(
                    int pixelWidth,
                    int pixelHeight, 
                    double dpiX,
                    double dpiY, 
                    PixelFormat pixelFormat, 
                    BitmapPalette palette,
                    IntPtr buffer, 
                    int bufferSize,
                    int stride
                    )
        { 
            if (pixelFormat.Palettized == true && palette == null)
                throw new InvalidOperationException(SR.Get(SRID.Image_IndexedPixelFormatRequiresPalette)); 
 
            if (pixelFormat.Format == PixelFormatEnum.Default && pixelFormat.Guid == WICPixelFormatGUIDs.WICPixelFormatDontCare)
            { 
                throw new System.ArgumentException(
                        SR.Get(SRID.Effect_PixelFormat, pixelFormat),
                        "pixelFormat"
                        ); 
            }
 
            _bitmapInit.BeginInit(); 

            try 
            {
                BitmapSourceSafeMILHandle wicBitmap;

                // Create the unmanaged resources 
                Guid guidFmt = pixelFormat.Guid;
 
                using (FactoryMaker factoryMaker = new FactoryMaker()) 
                {
                    HRESULT.Check(UnsafeNativeMethods.WICImagingFactory.CreateBitmapFromMemory( 
                            factoryMaker.ImagingFactoryPtr,
                            (uint)pixelWidth, (uint)pixelHeight,
                            ref guidFmt,
                            (uint)stride, 
                            (uint)bufferSize,
                            buffer, 
                            out wicBitmap)); 

                    wicBitmap.CalculateSize(); 
                }

                HRESULT.Check(UnsafeNativeMethods.WICBitmap.SetResolution(
                        wicBitmap, 
                        dpiX,
                        dpiY)); 
 
                if (pixelFormat.Palettized)
                { 
                    HRESULT.Check(UnsafeNativeMethods.WICBitmap.SetPalette(
                        wicBitmap,
                        palette.InternalPalette));
                } 

                WicSourceHandle = wicBitmap; 
                _isSourceCached = true; 
            }
            catch 
            {
                _bitmapInit.Reset();
                throw;
            } 

            _createOptions = BitmapCreateOptions.PreservePixelFormat; 
            _cacheOption = BitmapCacheOption.OnLoad; 
            _syncObject = WicSourceHandle;
            _bitmapInit.EndInit(); 

            UpdateCachedSettings();
        }
 
        BitmapSource        _source;
        BitmapCreateOptions _createOptions = BitmapCreateOptions.None; 
        BitmapCacheOption   _cacheOption = BitmapCacheOption.Default; 
    }
    #endregion // CachedBitmap 
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------------------ 
//  Microsoft Avalon
//  Copyright (c) Microsoft Corporation.  All Rights Reserved.
//
//  File: CachedBitmap.cs 
//
//----------------------------------------------------------------------------- 
 

using System; 
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.ComponentModel; 
using System.ComponentModel.Design.Serialization;
using System.Reflection; 
using MS.Internal; 
using MS.Win32.PresentationCore;
using System.Security; 
using System.Security.Permissions;
using System.Diagnostics;
using System.Windows.Media;
using System.Globalization; 
using System.Runtime.InteropServices;
using System.Windows; 
using System.Windows.Media.Animation; 
using System.Windows.Media.Composition;
 
using SR=MS.Internal.PresentationCore.SR;
using SRID=MS.Internal.PresentationCore.SRID;

namespace System.Windows.Media.Imaging 
{
    #region CachedBitmap 
 
    /// 
    /// CachedBitmap provides caching functionality for a BitmapSource. 
    /// 
    public sealed class CachedBitmap : System.Windows.Media.Imaging.BitmapSource
    {
        ///  
        /// Construct a CachedBitmap
        ///  
        /// BitmapSource to apply to the crop to 
        /// CreateOptions for the new Bitmap
        /// CacheOption for the new Bitmap 
        public CachedBitmap(BitmapSource source, BitmapCreateOptions createOptions, BitmapCacheOption cacheOption)
            : base(true) // Use base class virtuals
        {
            if (source == null) 
            {
                throw new ArgumentNullException("source"); 
            } 

            BeginInit(); 
            _source = source;
            _createOptions = createOptions;
            _cacheOption = cacheOption;
            _syncObject = source.SyncObject; 

            EndInit(); 
        } 

        ///  
        /// 
        /// 
        /// Critical - access critical code, accepts pointer arguments
        ///  
        [SecurityCritical]
        unsafe internal CachedBitmap( 
                    int pixelWidth, 
                    int pixelHeight,
                    double dpiX, 
                    double dpiY,
                    PixelFormat pixelFormat,
                    BitmapPalette palette,
                    IntPtr buffer, 
                    int bufferSize,
                    int stride 
                    ) 

            : base(true) // Use base class virtuals 
        {
            InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                              pixelFormat, palette,
                              buffer, bufferSize, stride); 
        }
 
        ///  
        ///     Creates a managed BitmapSource wrapper around a pre-existing
        ///     unmanaged bitmap. 
        /// 
        /// 
        ///     Critical - access critical code, accepts pointer
        ///  
        [SecurityCritical]
        internal CachedBitmap(BitmapSourceSafeMILHandle bitmap) : base(true) 
        { 
            if (bitmap == null)
            { 
                throw new ArgumentNullException("bitmap");
            }

            // We're not calling CachedBitmap.Begin/EndInit because that would 
            // invoke FinalizeCreation which calls CreateCachedBitmap that does
            // unnecessary work and only deals with BitmapFrames 
            _bitmapInit.BeginInit(); 

            _source = null; 
            _createOptions = BitmapCreateOptions.None;
            _cacheOption = BitmapCacheOption.OnLoad;

            // This will QI to IWICBitmapSource for us. QI also AddRefs, of course. 
            WicSourceHandle = bitmap;
            _syncObject = WicSourceHandle; 
 
            IsSourceCached = true;
            CreationCompleted = true; 

            _bitmapInit.EndInit();
        }
 
        /// 
        /// Create an Empty CachedBitap 
        ///  
        private CachedBitmap()
            : base(true) // Use base class virtuals 
        {
        }

        ///  
        /// 
        ///  
        /// Critical - calls unmanaged objects 
        /// TreatAsSafe - all inputs verified, including buffer sizes
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        unsafe internal CachedBitmap(
            int pixelWidth,
            int pixelHeight, 
            double dpiX,
            double dpiY, 
            PixelFormat pixelFormat, 
            BitmapPalette palette,
            System.Array pixels, 
            int stride
            )
            : base(true) // Use base class virtuals
        { 
            if (pixels == null)
                throw new System.ArgumentNullException ("pixels"); 
 
            if (pixels.Rank != 1)
                throw new ArgumentException (SR.Get (SRID.Collection_BadRank), "pixels"); 

            int elementSize = -1;

            if (pixels is byte[]) 
                elementSize = 1;
            else if (pixels is short[] || pixels is ushort[]) 
                elementSize = 2; 
            else if (pixels is int[] || pixels is uint[] || pixels is float[])
                elementSize = 4; 
            else if (pixels is double[])
                elementSize = 8;

            if (elementSize == -1) 
                throw new ArgumentException(SR.Get(SRID.Image_InvalidArrayForPixel));
 
            int destBufferSize = elementSize * pixels.Length; 

            if (pixels is byte[]) 
            {
                fixed(void * pixelArray = (byte[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is short[]) 
            {
                fixed(void * pixelArray = (short[])pixels) 
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is ushort[])
            { 
                fixed(void * pixelArray = (ushort[])pixels) 
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            }
            else if (pixels is int[])
            { 
                fixed(void * pixelArray = (int[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette, 
                                      (IntPtr)pixelArray, destBufferSize, stride);
            } 
            else if (pixels is uint[])
            {
                fixed(void * pixelArray = (uint[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride); 
            } 
            else if (pixels is float[])
            { 
                fixed(void * pixelArray = (float[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY,
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride); 
            }
            else if (pixels is double[]) 
            { 
                fixed(void * pixelArray = (double[])pixels)
                    InitFromMemoryPtr(pixelWidth, pixelHeight, dpiX, dpiY, 
                                      pixelFormat, palette,
                                      (IntPtr)pixelArray, destBufferSize, stride);
            }
        } 

        ///  
        /// Common implementation for CloneCore(), CloneCurrentValueCore(), 
        /// GetAsFrozenCore(), and GetCurrentValueAsFrozenCore().
        ///  
        /// 
        /// Critical - calls critical InitFromWICSource
        /// 
        [SecurityCritical] 
        private void CopyCommon(CachedBitmap sourceBitmap)
        { 
            // Avoid Animatable requesting resource updates for invalidations that occur during construction 
            Animatable_IsResourceInvalidationNecessary = false;
 
            if (sourceBitmap._source != null)
            {
                BeginInit();
                _syncObject = sourceBitmap._syncObject; 
                _source = sourceBitmap._source;
                _createOptions = sourceBitmap._createOptions; 
                _cacheOption = sourceBitmap._cacheOption; 

                // 
                if (_cacheOption == BitmapCacheOption.OnDemand)
                    _cacheOption = BitmapCacheOption.OnLoad;
                EndInit();
            } 
            else
            { 
                InitFromWICSource(sourceBitmap.WicSourceHandle); 
            }
            // The next invalidation will cause Animatable to register an UpdateResource callback 
            Animatable_IsResourceInvalidationNecessary = true;
        }

 
        // ISupportInitialize
 
        ///  
        /// Prepare the bitmap to accept initialize paramters.
        ///  
        private void BeginInit()
        {
            _bitmapInit.BeginInit();
        } 

        ///  
        /// Prepare the bitmap to accept initialize paramters. 
        /// 
        ///  
        /// Critical - access critical resources
        /// TreatAsSafe - All inputs verified
        /// 
        [SecurityCritical, SecurityTreatAsSafe] 
        private void EndInit()
        { 
            _bitmapInit.EndInit(); 

            // if we don't need to delay, let 'er rip 
            if (!DelayCreation)
                FinalizeCreation();
        }
 
        ///
        /// Create the unmanaged resources 
        /// 
        /// 
        /// Critical - access critical resource 
        /// 
        [SecurityCritical]
        internal override void FinalizeCreation()
        { 
            lock (_syncObject)
            { 
                WicSourceHandle = CreateCachedBitmap(_source as BitmapFrame, _source.WicSourceHandle, _createOptions, _cacheOption, _source.Palette); 
            }
 
            IsSourceCached = (_cacheOption != BitmapCacheOption.None);
            CreationCompleted = true;
            UpdateCachedSettings();
        } 

        #region Public Methods 
        ///  
        ///     Shadows inherited Copy() with a strongly typed
        ///     version for convenience. 
        /// 
        public new CachedBitmap Clone()
        {
            return (CachedBitmap)base.Clone(); 
        }
 
        ///  
        ///     Shadows inherited CloneCurrentValue() with a
        ///     strongly typed version for convenience. 
        /// 
        public new CachedBitmap CloneCurrentValue()
        {
            return (CachedBitmap)base.CloneCurrentValue(); 
        }
 
        #endregion Public Methods 

        //----------------------------------------------------- 
        //
        //  Protected Methods
        //
        //----------------------------------------------------- 

        #region Protected Methods 
 
        /// 
        /// Implementation of Freezable.CreateInstanceCore. 
        /// 
        /// The new Freezable.
        /// 
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces clone of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe] 
        protected override Freezable CreateInstanceCore()
        { 
            return new CachedBitmap();
        }

        ///  
        /// Implementation of Freezable.CloneCore.
        ///  
        ///  
        /// Critical - accesses critical code.
        /// TreatAsSafe - method only produces clone of original image. 
        /// 
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void CloneCore(Freezable sourceFreezable)
        { 
            CachedBitmap sourceBitmap = (CachedBitmap) sourceFreezable;
 
            base.CloneCore(sourceFreezable); 

            CopyCommon(sourceBitmap); 
        }

        /// 
        /// Implementation of Freezable.CloneCurrentValueCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces clone of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void CloneCurrentValueCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap) sourceFreezable; 

            base.CloneCurrentValueCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 


        /// 
        /// Implementation of Freezable.GetAsFrozenCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces GetAsFrozen of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void GetAsFrozenCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap)sourceFreezable; 

            base.GetAsFrozenCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 


        /// 
        /// Implementation of Freezable.GetCurrentValueAsFrozenCore. 
        /// 
        ///  
        /// Critical - accesses critical code. 
        /// TreatAsSafe - method only produces GetCurrentValueAsFrozen of original image.
        ///  
        [SecurityCritical, SecurityTreatAsSafe]
        protected override void GetCurrentValueAsFrozenCore(Freezable sourceFreezable)
        {
            CachedBitmap sourceBitmap = (CachedBitmap)sourceFreezable; 

            base.GetCurrentValueAsFrozenCore(sourceFreezable); 
 
            CopyCommon(sourceBitmap);
        } 

        #endregion ProtectedMethods

        /// 
        /// Create from WICBitmapSource
        /// 
        ///  
        /// Critical - calls unmanaged objects
        ///  
        [SecurityCritical]
        private void InitFromWICSource(
                    SafeMILHandle wicSource
                    ) 
        {
            _bitmapInit.BeginInit(); 
 
            BitmapSourceSafeMILHandle bitmapSource = null;
 
            lock (_syncObject)
            {
                using (FactoryMaker factoryMaker = new FactoryMaker())
                { 
                    HRESULT.Check(UnsafeNativeMethods.WICImagingFactory.CreateBitmapFromSource(
                            factoryMaker.ImagingFactoryPtr, 
                            wicSource, 
                            WICBitmapCreateCacheOptions.WICBitmapCacheOnLoad,
                            out bitmapSource)); 
                }

                bitmapSource.CalculateSize();
            } 
            WicSourceHandle = bitmapSource;
            _isSourceCached = true; 
 
            _bitmapInit.EndInit();
 
            UpdateCachedSettings();
        }

        /// 
        /// Create from memory
        /// 
        ///  
        /// Critical - calls unmanaged objects, accepts pointer parameters
        ///  
        [SecurityCritical]
        private void InitFromMemoryPtr(
                    int pixelWidth,
                    int pixelHeight, 
                    double dpiX,
                    double dpiY, 
                    PixelFormat pixelFormat, 
                    BitmapPalette palette,
                    IntPtr buffer, 
                    int bufferSize,
                    int stride
                    )
        { 
            if (pixelFormat.Palettized == true && palette == null)
                throw new InvalidOperationException(SR.Get(SRID.Image_IndexedPixelFormatRequiresPalette)); 
 
            if (pixelFormat.Format == PixelFormatEnum.Default && pixelFormat.Guid == WICPixelFormatGUIDs.WICPixelFormatDontCare)
            { 
                throw new System.ArgumentException(
                        SR.Get(SRID.Effect_PixelFormat, pixelFormat),
                        "pixelFormat"
                        ); 
            }
 
            _bitmapInit.BeginInit(); 

            try 
            {
                BitmapSourceSafeMILHandle wicBitmap;

                // Create the unmanaged resources 
                Guid guidFmt = pixelFormat.Guid;
 
                using (FactoryMaker factoryMaker = new FactoryMaker()) 
                {
                    HRESULT.Check(UnsafeNativeMethods.WICImagingFactory.CreateBitmapFromMemory( 
                            factoryMaker.ImagingFactoryPtr,
                            (uint)pixelWidth, (uint)pixelHeight,
                            ref guidFmt,
                            (uint)stride, 
                            (uint)bufferSize,
                            buffer, 
                            out wicBitmap)); 

                    wicBitmap.CalculateSize(); 
                }

                HRESULT.Check(UnsafeNativeMethods.WICBitmap.SetResolution(
                        wicBitmap, 
                        dpiX,
                        dpiY)); 
 
                if (pixelFormat.Palettized)
                { 
                    HRESULT.Check(UnsafeNativeMethods.WICBitmap.SetPalette(
                        wicBitmap,
                        palette.InternalPalette));
                } 

                WicSourceHandle = wicBitmap; 
                _isSourceCached = true; 
            }
            catch 
            {
                _bitmapInit.Reset();
                throw;
            } 

            _createOptions = BitmapCreateOptions.PreservePixelFormat; 
            _cacheOption = BitmapCacheOption.OnLoad; 
            _syncObject = WicSourceHandle;
            _bitmapInit.EndInit(); 

            UpdateCachedSettings();
        }
 
        BitmapSource        _source;
        BitmapCreateOptions _createOptions = BitmapCreateOptions.None; 
        BitmapCacheOption   _cacheOption = BitmapCacheOption.Default; 
    }
    #endregion // CachedBitmap 
}

// 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