PodNet.Boxify.Bmp 1.0.0

PodNet.Boxify.Bmp

An extension for PodNet.Boxify that wraps System.Drawing.Bitmap for drawing box-drawings of images to text, files or terminals

Usage

This NuGet package contains a simple implementation of PodNet.Boxify's IBoxBitmapSource, that wraps a System.Drawing.Bitmap from System.Drawing.Common.

This is only used to provide the bridge between PodNet.Boxify and a commonly used bitmap source, but you should consider implementing IBoxBitmapSource yourself if you already have an image representation in your application to avoid taking a dependency on another image manipulation library.

var bmp = new Bitmap("mybmp.bmp");
using var source = new BitmapSource(bmp);
var boxArt = Renderer.Default.Render(source, PixelPalette.Halves);

There are no additional options for resizing, colorizing or applying effects. Do note that the renderer will render a character for each pixel into the resulting string, so any additional image manipulation you have to do yourself prior to rendering to the string (or do the manipulation, specifically the resizing and transformations in your custom wrapper).

For details on how to use PodNet.Boxify, see the repo at https://github.com/podNET-Hungary/PodNet.Boxify/.

This package is also required by PodNet.Boxify.Svg that allows converting SVG vector-based images to bitmaps so that they can in turn be converted to box-drawings.

Contributing and Support

This project is intended to be widely usable, but no warranties are provided. If you want to contact us, feel free to do so in the org's [Discussions], at our website at podnet.hu, or find us anywhere from LinkedIn to Meetup, YouTube or X.

Any kinds of contributions from issues to PRs and open discussions are welcome!

Don't forget to give us a ⭐ if you like this repo (it's free to give kudos!) or share it on socials!

Sponsorship

If you're using our work or like what you see, consider supporting us. Every bit counts. 🙏 See here for more info.