BitmapSource Clase

Definición

Espacio de nombres:

System.Windows.Media.Imaging

Ensamblado:

PresentationCore.dll

Representa un solo conjunto constante de píxeles con un tamaño y resolución determinados.

public ref class BitmapSource abstract : System::Windows::Media::ImageSource

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class BitmapSource : System.Windows.Media.ImageSource

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type BitmapSource = class
    inherit ImageSource

Public MustInherit Class BitmapSource
Inherits ImageSource

Herencia

Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource

Derivado

System.Windows.Interop.InteropBitmap

System.Windows.Media.Imaging.BitmapFrame

System.Windows.Media.Imaging.BitmapImage

System.Windows.Media.Imaging.CachedBitmap

System.Windows.Media.Imaging.ColorConvertedBitmap

System.Windows.Media.Imaging.CroppedBitmap

System.Windows.Media.Imaging.FormatConvertedBitmap

System.Windows.Media.Imaging.RenderTargetBitmap

System.Windows.Media.Imaging.TransformedBitmap

System.Windows.Media.Imaging.WriteableBitmap

Atributos

LocalizabilityAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear y BitmapSource usarlo como origen de un Image control.

// Define parameters used to create the BitmapSource.
PixelFormat pf = PixelFormats.Bgr32;
int width = 200;
int height = 200;
int rawStride = (width * pf.BitsPerPixel + 7) / 8;
byte[] rawImage = new byte[rawStride * height];

// Initialize the image with data.
Random value = new Random();
value.NextBytes(rawImage);

// Create a BitmapSource.
BitmapSource bitmap = BitmapSource.Create(width, height,
    96, 96, pf, null,
    rawImage, rawStride);

// Create an image element;
Image myImage = new Image();
myImage.Width = 200;
// Set image source.
myImage.Source = bitmap;

' Define parameters used to create the BitmapSource.
Dim pf As PixelFormat = PixelFormats.Bgr32
Dim width As Integer = 200
Dim height As Integer = 200
Dim rawStride As Integer = CType((width * pf.BitsPerPixel + 7) / 8, Integer)
Dim rawImage(rawStride * height) As Byte

' Initialize the image with data.
Dim value As New Random()
value.NextBytes(rawImage)

' Create a BitmapSource.
Dim bitmap As BitmapSource = BitmapSource.Create(width, height, 96, 96, pf, Nothing, rawImage, rawStride)

' Create an image element;
Dim myImage As New Image()
myImage.Width = 200
' Set image source.
myImage.Source = bitmap

En el ejemplo de código siguiente se usa una BitmapSource clase derivada, BitmapImage, para crear un mapa de bits a partir de un archivo de imagen y usarlo como origen de un Image control.

// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;

' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

Comentarios

BitmapSourcees el bloque de creación básico de la canalización de creación de imágenes de Windows Presentation Foundation (WPF), que representa conceptualmente un único conjunto constante de píxeles a un tamaño y resolución determinados. Un BitmapSource podría ser un solo marco en un archivo de imagen que proporciona un descodificador, o bien podría ser el resultado de una transformación que opera en un BitmapSource de su propio. BitmapSource no se usa para representar una imagen de varios fotogramas ni una animación.

Windows Presentation Foundation (WPF) admite de forma nativa la compresión y descompresión del mapa de bits (BMP), el formato de intercambio de gráficos (GIF), el grupo de expertos en fotografías conjuntas (JPEG), los gráficos de red portable (PNG) y las imágenes con formato de archivo de imagen etiquetado (TIFF).

Para escenarios de descodificación de mapa de bits, BitmapSource usa la detección automática de códecs, en función de los códecs instalados en el sistema del usuario.

El alto y ancho máximo de una imagen es de 2^16 píxeles a 32 bits por canal * 4 canales. El tamaño máximo de un BitmapSource es de 2^32 bytes (64 gigabytes) y el tamaño máximo de la imagen es de cuatro gigapixeles. El tamaño mínimo de la imagen es 1x1.

Constructores

BitmapSource()

Inicializa una nueva instancia de la clase BitmapSource.

Propiedades

CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Heredado de Freezable)
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
DpiX	Obtiene los puntos horizontales por pulgada (ppp) de la imagen.
DpiY	Obtiene los puntos verticales por pulgada (ppp) de la imagen.
Format	Obtiene el PixelFormat nativo de los datos del mapa de bits.
HasAnimatedProperties	Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto. (Heredado de Animatable)
Height	Obtiene el alto del mapa de bits de origen en unidades independientes del dispositivo (1/96 pulgadas por unidad).
IsDownloading	Obtiene un valor que indica si el contenido de BitmapSource se está descargando actualmente.
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Metadata	Obtiene los metadatos asociados a esta imagen de mapa de bits.
Palette	Obtiene la paleta de colores del mapa de bits, si se especifica una.
PixelHeight	Obtiene el alto del mapa de bits en píxeles.
PixelWidth	Obtiene el ancho del mapa de bits en píxeles.
Width	Obtiene el ancho del mapa de bits en unidades independientes del dispositivo (1/96 pulgadas por unidad).

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
CheckIfSiteOfOrigin()	Comprueba si el contenido de origen del mapa de bits es de un sitio de origen conocido. Este método se utiliza para asegurarse de que las operaciones de copia son seguras.
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
Clone()	Crea un clon modificable de este BitmapSource y hace copias en profundidad de los valores de este objeto. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.
CloneCore(Freezable)	Convierte esta instancia en una copia en profundidad del valor de BitmapSource especificado. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.
CloneCurrentValue()	Crea un clon modificable de este objeto BitmapSource y hace copias en profundidad de sus valores actuales. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.
CloneCurrentValueCore(Freezable)	Convierte esta instancia en una copia en profundidad modificable del elemento BitmapSource especificado mediante los valores de propiedad actuales. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
CopyPixels(Array, Int32, Int32)	Copia los datos de píxeles del mapa de bits en una matriz de píxeles con el paso especificado, a partir de la posición de desplazamiento especificada.
CopyPixels(Int32Rect, Array, Int32, Int32)	Copia los datos de píxeles del mapa de bits del rectángulo especificado en una matriz de píxeles con el paso especificado, a partir de la posición de desplazamiento especificada.
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Copia los datos de píxeles del mapa de bits dentro del rectángulo especificado.
Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32)	Crea una nueva clase BitmapSource a partir de una matriz de píxeles.
Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32)	Crea una nueva clase BitmapSource a partir de una matriz de píxeles que se almacenan en memoria no administrada.
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada. (Heredado de Freezable)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
Freeze()	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Heredado de Freezable)
FreezeCore(Boolean)	Crea una instancia de la clase BitmapSource o una clase derivada inmutable.
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del objeto DependencyProperty especificado. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte esta instancia en un clon del objeto BitmapSource especificado.
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de Freezable con los valores de propiedad actuales. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte esta instancia en un clon inmovilizado del valor de BitmapSource especificado. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales.
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnChanged()	Se le llama cuando el objeto Freezable actual se modifica. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Se asegura de que se tiene acceso a Freezable desde un subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de las API que leen miembros de datos que no son propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Crea una representación de cadena de este objeto basándose en la referencia cultural actual. (Heredado de ImageSource)
ToString(IFormatProvider)	Crea una representación de cadena de este objeto basándose en el objeto IFormatProvider que se pasa. Si el proveedor es null, se usará la propiedad CurrentCulture. (Heredado de ImageSource)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el evento Changed para Freezable e invoca su método OnChanged(). Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de las API que escriben en miembros de datos que no son propiedades de dependencia. (Heredado de Freezable)

Eventos

Changed	Se produce cuando se modifican la clase Freezable o un objeto que la contiene. (Heredado de Freezable)
DecodeFailed	Se produce si no puede cargarse la imagen debido a un encabezado de imagen dañado.
DownloadCompleted	Se produce cuando se ha descargado completamente el contenido de mapa de bits.
DownloadFailed	Se produce cuando no se puede descargar el contenido de mapa de bits.
DownloadProgress	Se produce cuando el progreso de la descarga del contenido de mapa de bits sufre un cambio.

Implementaciones de interfaz explícitas

IFormattable.ToString(String, IFormatProvider)

Da formato al valor de la instancia actual usando el formato especificado. (Heredado de ImageSource)

Consulte también

• BitmapImage
• Componente de creación de imágenes de Microsoft Windows
• IWCBitmapSource