Class PixelBufferBase
Represents a pixel buffer
Assembly: MicroGraphics.dll
View Source
public abstract class PixelBufferBase : IPixelBuffer, IDisposable
Derived:
Implements:
Meadow.Peripherals.Displays.IPixelBuffer, System.IDisposable
Properties
Width
Width of buffer in pixels
View Source
public int Width { get; protected set; }
Height
Height of buffer in pixels
View Source
public int Height { get; protected set; }
ColorMode
Color mode of the buffer
View Source
public virtual ColorMode ColorMode { get; protected set; }
BitDepth
Bit depth of display as an integer
View Source
public int BitDepth { get; }
ByteCount
Number of bytes in buffer
View Source
public virtual int ByteCount { get; }
Buffer
The buffer that holds the pixel data The packing structure in buffer-specific
View Source
public byte[] Buffer { get; protected set; }
Methods
InitializeBuffer(bool)
Initialize the pixel buffer based on the current width, height and color depth
View Source
public void InitializeBuffer(bool replaceIfExists = false)
Parameters
| Type | Name | Description |
|---|---|---|
System.Boolean | replaceIfExists | If true, will recreates the buffer if it already exists |
Clear()
Clear the array that stores the pixel buffer
View Source
public virtual void Clear()
Fill(Color)
Fill the entire pixel buffer with a color
View Source
public abstract void Fill(Color color)
Parameters
| Type | Name | Description |
|---|---|---|
Meadow.Color | color | Fill color |
Fill(int, int, int, int, Color)
Fill a region of the pixel buffer with a color
View Source
public abstract void Fill(int originX, int originY, int width, int height, Color color)
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | originX | X pixel to start fill |
System.Int32 | originY | Y pixel to start fill |
System.Int32 | width | Width to fill |
System.Int32 | height | height to fill |
Meadow.Color | color | Fill color |
GetPixel(int, int)
Get pixel at location
View Source
public abstract Color GetPixel(int x, int y)
Returns
Meadow.Color
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | x | X pixel location |
System.Int32 | y | Y pixel location |
SetPixel(int, int, Color)
Set pixel at location to a color
View Source
public abstract void SetPixel(int x, int y, Color color)
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | x | X pixel location |
System.Int32 | y | Y pixel location |
Meadow.Color | color | Pixel color |
InvertPixel(int, int)
Invert pixel color at location
View Source
public abstract void InvertPixel(int x, int y)
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | x | X pixel location |
System.Int32 | y | Y pixel location |
WriteBuffer(int, int, IPixelBuffer)
Default way to write a buffer into this buffer.
This is very slow and should be avoided if possible. It loops through every pixel. If the buffer bit depths match there should be faster ways to write using Array.Copy.
View Source
public virtual void WriteBuffer(int originX, int originY, IPixelBuffer buffer)
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | originX | The X coord to start writing |
System.Int32 | originY | The Y coord to start writing |
Meadow.Peripherals.Displays.IPixelBuffer | buffer | The buffer to copy into this buffer |
WriteBufferSlow(int, int, IPixelBuffer)
A slow buffer write operation that writes pixel-by-pixel using the Color struct to scale color based on bit depth.
This method can handle buffers with mismatched bit depths.
View Source
protected void WriteBufferSlow(int originX, int originY, IPixelBuffer buffer)
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | originX | The X coord to start writing the buffer |
System.Int32 | originY | The Y coord to start writing the buffer |
Meadow.Peripherals.Displays.IPixelBuffer | buffer | The buffer to write |
Rotate<T>(RotationType)
Create a new buffer from the existing buffer with a new rotation
View Source
public T Rotate<T>(RotationType rotation) where T : PixelBufferBase, new()
Returns
<T>: The new buffer
Parameters
| Type | Name | Description |
|---|---|---|
Meadow.Peripherals.Displays.RotationType | rotation | Rotation |
Type Parameters
| Name | Description |
|---|---|
T | Buffer type |
ScaleUp<T>(int)
Create a new buffer integer scaled up from the existing buffer
View Source
public T ScaleUp<T>(int scaleFactor) where T : PixelBufferBase, new()
Returns
<T>: The new buffer
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | scaleFactor | Integer scale ratio |
Type Parameters
| Name | Description |
|---|---|
T | Buffer type |
Convert<T>()
Create a new pixel buffer and copy/convert pixel data from existing buffer
View Source
public T Convert<T>() where T : PixelBufferBase, new()
Returns
<T>: A pixel buffer derived from PixelBufferBase##### Type Parameters
| Name | Description |
|:--- |:--- |
| T | The buffer type to convert to |
Resize<T>(int, int)
Resize the buffer to new dimensions using the nearest neighbor algorithm
View Source
public T Resize<T>(int newWidth, int newHeight) where T : PixelBufferBase, new()
Returns
<T>: The resized buffer
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | newWidth | New width |
System.Int32 | newHeight | New height |
Type Parameters
| Name | Description |
|---|---|
T | Buffer type |
ResizeBilinear<T>(int, int)
Resize the buffer to new dimensions using bilinear interpolation
View Source
public T ResizeBilinear<T>(int newWidth, int newHeight) where T : PixelBufferBase, new()
Returns
<T>: The resized buffer
Parameters
| Type | Name | Description |
|---|---|---|
System.Int32 | newWidth | New width |
System.Int32 | newHeight | New height |
Type Parameters
| Name | Description |
|---|---|
T | Buffer type |
Rotate<T>(Angle)
Rotate the buffer by an arbitrary angle
View Source
public T Rotate<T>(Angle angle) where T : PixelBufferBase, new()
Returns
<T>: The rotated buffer
Parameters
| Type | Name | Description |
|---|---|---|
Meadow.Units.Angle | angle | Rotation angle in degrees |
Type Parameters
| Name | Description |
|---|---|
T | Buffer type |
GetColorDistance(Color, Color)
Calculate the uncorrected distance between two colors using bytes for red, green, blue
View Source
public float GetColorDistance(Color color1, Color color2)
Returns
System.Single: The distance as a float
Parameters
| Type | Name |
|---|---|
Meadow.Color | color1 |
Meadow.Color | color2 |
Dispose(bool)
Dispose of the object
View Source
protected virtual void Dispose(bool disposing)
Parameters
| Type | Name | Description |
|---|---|---|
System.Boolean | disposing | Is disposing |
Dispose()
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
View Source
public void Dispose()
Implements
Meadow.Peripherals.Displays.IPixelBufferSystem.IDisposable