Skip to content

Latest commit

 

History

History
51 lines (40 loc) · 3.13 KB

README.md

File metadata and controls

51 lines (40 loc) · 3.13 KB

Terminal-Image-To-Ascii

This project converts an image into ASCII art, displayed in the terminal with color. The program maps grayscale intensity levels of the image to specific extended ASCII characters and uses ANSI color codes to represent the original RGB colors of the image.

Features

  • Convert an image to ASCII characters based on pixel intensity.
  • Preserve the original image colors using ANSI color codes.
  • Adjust the ASCII art size to fit within a terminal window.

How It Works

  1. Image Loading: The program uses stb_image.h to load an image in memory.
  2. Pixel Intensity to ASCII: The grayscale intensity of each pixel is mapped to an extended ASCII character.
  3. Color Conversion: The RGB color of each pixel is converted to an ANSI escape code.
  4. Display in Terminal: The ASCII art is displayed in the terminal using the correct colors and characters.

Images

  • Original Image

    Original Image Original Image

  • Terminal Ascii Image

    Ascii Image Ascii Image

Function Overview

Function Description
getAsciiChar(int intensity) Maps a pixel's grayscale intensity (0–255) to an extended ASCII character.
getAnsiColorCode(int r, int g, int b) Converts an RGB value to an ANSI escape sequence for terminal colors.
convertImageToAsciiMatrix(const std::string& imagePath, int width, int height) Loads the image, scales it to fit the terminal, and generates a matrix of ASCII characters and color codes.
displayAsciiMatrix(const std::vector<std::vector<std::pair<std::string, char>>>& matrix) Displays the ASCII matrix in the terminal, including colors, using ANSI codes.

Extended Ascii Characters Used

ASCII Character Hex Code Description
Space ( ) 0x20 Represents the lightest intensity (white).
█ 0xDB Represents the darkest intensity (black).
▒ 0xB2 Medium intensity.
░ 0xB0 Light shading.
▀ 0xFE Dark shading, upper half.
▒ 0xB1 Medium-light shading.
▓ 0xB2 Medium-dark shading.

License

Licence