BitmapSource.Create 方法

定义

创建一个新的具有指定属性和选项的 BitmapSourceCreates a new BitmapSource that has the specified properties and options.

重载

Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32)

从像素数组中创建一个新的 BitmapSourceCreates a new BitmapSource from an array of pixels.

Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32)

从存储在非托管内存中的像素数组创建一个新的 BitmapSourceCreates a new BitmapSource from an array of pixels that are stored in unmanaged memory.

Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, Array, Int32)

从像素数组中创建一个新的 BitmapSourceCreates a new BitmapSource from an array of pixels.

public:
 static System::Windows::Media::Imaging::BitmapSource ^ Create(int pixelWidth, int pixelHeight, double dpiX, double dpiY, System::Windows::Media::PixelFormat pixelFormat, System::Windows::Media::Imaging::BitmapPalette ^ palette, Array ^ pixels, int stride);
public static System.Windows.Media.Imaging.BitmapSource Create (int pixelWidth, int pixelHeight, double dpiX, double dpiY, System.Windows.Media.PixelFormat pixelFormat, System.Windows.Media.Imaging.BitmapPalette palette, Array pixels, int stride);
static member Create : int * int * double * double * System.Windows.Media.PixelFormat * System.Windows.Media.Imaging.BitmapPalette * Array * int -> System.Windows.Media.Imaging.BitmapSource
Public Shared Function Create (pixelWidth As Integer, pixelHeight As Integer, dpiX As Double, dpiY As Double, pixelFormat As PixelFormat, palette As BitmapPalette, pixels As Array, stride As Integer) As BitmapSource

参数

pixelWidth
Int32

位图的宽度。The width of the bitmap.

pixelHeight
Int32

位图的高度。The height of the bitmap.

dpiX
Double

位图的水平每英寸点数 (dpi)dots per inch (dpi)The horizontal 每英寸点数 (dpi)dots per inch (dpi) of the bitmap.

dpiY
Double

位图的垂直每英寸点数 (dpi)dots per inch (dpi)The vertical 每英寸点数 (dpi)dots per inch (dpi) of the bitmap.

pixelFormat
PixelFormat

位图的像素格式。The pixel format of the bitmap.

palette
BitmapPalette

位图的调色板。The palette of the bitmap.

pixels
Array

表示位图图像内容的字节数组。An array of bytes that represents the content of a bitmap image.

stride
Int32

位图的跨距。The stride of the bitmap.

返回

BitmapSource

从指定的像素数组创建的 BitmapSourceThe BitmapSource that is created from the specified array of pixels.

示例

下面的示例演示如何使用此方法来创建新的 BitmapSourceThe following example demonstrates how to use this method in order to create a new BitmapSource.

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

另请参阅

适用于

产品 Introduced

Create(Int32, Int32, Double, Double, PixelFormat, BitmapPalette, IntPtr, Int32, Int32)

从存储在非托管内存中的像素数组创建一个新的 BitmapSourceCreates a new BitmapSource from an array of pixels that are stored in unmanaged memory.

public:
 static System::Windows::Media::Imaging::BitmapSource ^ Create(int pixelWidth, int pixelHeight, double dpiX, double dpiY, System::Windows::Media::PixelFormat pixelFormat, System::Windows::Media::Imaging::BitmapPalette ^ palette, IntPtr buffer, int bufferSize, int stride);
public static System.Windows.Media.Imaging.BitmapSource Create (int pixelWidth, int pixelHeight, double dpiX, double dpiY, System.Windows.Media.PixelFormat pixelFormat, System.Windows.Media.Imaging.BitmapPalette palette, IntPtr buffer, int bufferSize, int stride);
[System.Security.SecurityCritical]
public static System.Windows.Media.Imaging.BitmapSource Create (int pixelWidth, int pixelHeight, double dpiX, double dpiY, System.Windows.Media.PixelFormat pixelFormat, System.Windows.Media.Imaging.BitmapPalette palette, IntPtr buffer, int bufferSize, int stride);
static member Create : int * int * double * double * System.Windows.Media.PixelFormat * System.Windows.Media.Imaging.BitmapPalette * nativeint * int * int -> System.Windows.Media.Imaging.BitmapSource
[<System.Security.SecurityCritical>]
static member Create : int * int * double * double * System.Windows.Media.PixelFormat * System.Windows.Media.Imaging.BitmapPalette * nativeint * int * int -> System.Windows.Media.Imaging.BitmapSource
Public Shared Function Create (pixelWidth As Integer, pixelHeight As Integer, dpiX As Double, dpiY As Double, pixelFormat As PixelFormat, palette As BitmapPalette, buffer As IntPtr, bufferSize As Integer, stride As Integer) As BitmapSource

参数

pixelWidth
Int32

位图的宽度。The width of the bitmap.

pixelHeight
Int32

位图的高度。The height of the bitmap.

dpiX
Double

位图的水平每英寸点数 (dpi)dots per inch (dpi)The horizontal 每英寸点数 (dpi)dots per inch (dpi) of the bitmap.

dpiY
Double

位图的垂直每英寸点数 (dpi)dots per inch (dpi)The vertical 每英寸点数 (dpi)dots per inch (dpi) of the bitmap.

pixelFormat
PixelFormat

位图的像素格式。The pixel format of the bitmap.

palette
BitmapPalette

位图的调色板。The palette of the bitmap.

buffer
IntPtr

一个指向缓冲区的指针,该缓冲区中包含内存中的位图数据。A pointer to the buffer that contains the bitmap data in memory.

bufferSize
Int32

缓冲区的大小。The size of the buffer.

stride
Int32

位图的跨距。The stride of the bitmap.

返回

BitmapSource

BitmapSource,它是从非托管内存中的像素数组创建的。A BitmapSource that is created from the array of pixels in unmanaged memory.

属性

适用于

产品 Introduced