Image Rendering
Images in the terminal!
Images in the terminal!
In addition to all of the features that Terminaux provides, it also provides an extra library that your terminal applications can use, called Terminaux.Images
, that supports Windows, macOS, and Linux. It doesn't use due to its exclusivity to Windows.
With the help of ImageMagick, you can render the images to your console, as long as your console's dimensions is greater than the requested width and height of the image. Using the ImageProcessor
class, you can either use a file path, a byte array, a MagickImage instance, or a stream that contains image data that ImageMagick can process, which you can find a list of suppored extensions .
Here are the examples of how to render a picture to column 5 row 3 of the console with the image width of 40 and height of 20:
You can demonstrate this by running the Terminaux.Console
app (build from source) and running the RenderImage
test fixture:
You can also get colors for each pixel in the image using a file path, a byte array, or a stream that contains image data that ImageMagick can process, using the GetColorsFromImage()
function that returns a 2D array representing the full image width and height.
If you don't want to provide an image file, stream, or array of bytes, or if you're making a UI concept, you can use the placeholder graphic renderer that can be easily be used like this: