[]
        
(Showing Draft Content)

C1.Util.DX.Direct2D.Bitmap.CopyFromStream

CopyFromStream Method

CopyFromStream(Stream, int, int)

Copies the specified region from a stream into the current bitmap.

Declaration
public void CopyFromStream(Stream stream, int pitch, int length)
Parameters
Type Name Description
Stream stream

The stream to copy the data from.

int pitch

The stride, or pitch, of the source bitmap stored in srcData. The stride is the byte count of a scanline (one row of pixels in memory). The stride can be computed from the following formula: pixel width * bytes per pixel + memory padding.

int length

Length in bytes of the data to copy from the stream.

Remarks

This method does not update the size of the current bitmap. If the contents of the source bitmap do not fit in the current bitmap, this method fails. Also, note that this method does not perform format conversion; the two bitmap formats should match. Passing this method invalid input, such as an invalid destination rectangle, can produce unpredictable results, such as a distorted image or device failure. Calling this method may cause the current batch to flush if the bitmap is active in the batch. If the batch that was flushed does not complete successfully, this method fails. However, this method does not clear the error state of the render target on which the batch was flushed. The failing int and tag state will be returned at the next call to {{EndDraw}} or {{Flush}}.

CopyFromStream(Stream, int, int, RectL)

Copies the specified region from a stream into the current bitmap.

Declaration
public void CopyFromStream(Stream stream, int pitch, int length, RectL destinationArea)
Parameters
Type Name Description
Stream stream

The stream to copy the data from.

int pitch

The stride, or pitch, of the source bitmap stored in srcData. The stride is the byte count of a scanline (one row of pixels in memory). The stride can be computed from the following formula: pixel width * bytes per pixel + memory padding.

int length

Length in bytes of the data to copy from the stream.

RectL destinationArea

In the current bitmap, the upper-left corner of the area to which the region specified by srcRect is copied.

Remarks

This method does not update the size of the current bitmap. If the contents of the source bitmap do not fit in the current bitmap, this method fails. Also, note that this method does not perform format conversion; the two bitmap formats should match. Passing this method invalid input, such as an invalid destination rectangle, can produce unpredictable results, such as a distorted image or device failure. Calling this method may cause the current batch to flush if the bitmap is active in the batch. If the batch that was flushed does not complete successfully, this method fails. However, this method does not clear the error state of the render target on which the batch was flushed. The failing int and tag state will be returned at the next call to {{EndDraw}} or {{Flush}}.