1
0
mirror of https://github.com/DarthAffe/CUE.NET.git synced 2025-12-13 09:08:34 +00:00

Updated Image Brush (markdown)

DarthAffe 2017-01-15 10:50:11 +01:00
parent 73a795f4b2
commit 2d7fcd4390

@ -1 +1,24 @@
TODO
The _ImageBrush_ is one of the default brushes provided by CUE.NET.
It's used to draw a bitmap into a rectangle.
Using the _ImageBrush_ is really easy. You just need to assign your bitmap to the __Image__-property after creating the brush (it can even be changed on the fly) like this:
```C#
ImageBrush imageBrush = new ImageBrush();
imageBrush.Image = myBitmap;
myLedGroup.Brush = imageBrush;
```
### Configure the image-rendering
There are multiple properties which allow you to customize the way how the brush renders the image.
> This might be expanded later but right now there's only one possibility for every setting.
#### ImageScaleMode
The _ImageScaleMode_ defines how the image is stretched or cropped if the aspect ratio of the image isn't equal the aspect ratio of the rectangle drawn to. (Default: _Stretch_:)
- **Stretch**
The image is resized to fill the destination-rectangle. The aspect ratio is not preserved.
#### ImageInterpolationMode
The _ImageInterpolationMode_ defines how the image is scaled down to the low pixel-resolution of the keyboard.
- **PixelPerfect**
The image is scaled by taking always the single pixel nearest to the requested point. This method is really fast, but doesn't do any smoothing or interpolation, and might yield not the best quality.