#Powershell Magic Back once again with the Powershell 🥓 flavour

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net6.0-windows</TargetFramework>
    <OutputType>Library</OutputType>
    <AssemblyName>Image2Text</AssemblyName>
    <RootNamespace>Image2Text</RootNamespace>
    <PlatformTarget>x64</PlatformTarget>
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <NoWarn>CA1416</NoWarn> <!-- Suppress Windows-only API warnings -->
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="System.Drawing.Common" Version="7.0.0" />
  </ItemGroup>

</Project>

using System;
using System.Drawing;
using System.Drawing.Drawing2D;

namespace Image2Text
{
    public class AsciiConverter
    {
        // High-density character set ordered darkest to lightest
        private static readonly string Charset = "$@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/\\|()1{}[]?-_+~<>i!lI;:,\"^`'. ";

        /// <summary>
        /// Converts an image to ASCII art, optionally with ANSI color.
        /// </summary>
        public static string[] Convert(string imagePath, int width, double aspectRatio, double gamma, bool useColor)
        {
            if (!System.IO.File.Exists(imagePath))
                throw new ArgumentException("Image not found: " + imagePath);

            using (var original = new Bitmap(imagePath))
            {
                int height = (int)Math.Round(original.Height * ((double)width / original.Width) * aspectRatio);

                // High-quality resize
                Bitmap resized = new Bitmap(width, height);
                using (Graphics g = Graphics.FromImage(resized))
                {
                    g.InterpolationMode = InterpolationMode.HighQualityBicubic;
                    g.SmoothingMode = SmoothingMode.HighQuality;
                    g.PixelOffsetMode = PixelOffsetMode.HighQuality;
                    g.CompositingQuality = CompositingQuality.HighQuality;
                    g.DrawImage(original, 0, 0, width, height);
                }

                string[] lines = new string[height];

                for (int y = 0; y < height; y++)
                {
                    string line = "";
                    for (int x = 0; x < width; x++)
                    {
                        Color pixel = resized.GetPixel(x, y);
                        double luminance = 0.2126 * pixel.R + 0.7152 * pixel.G + 0.0722 * pixel.B;
                        double normalized = Math.Pow(luminance / 255.0, 1.0 / gamma);
                        int index = (int)(normalized * (Charset.Length - 1));
                        char asciiChar = Charset[index];

                        if (useColor)
                        {
                            string ansi = $"\u001b[38;2;{pixel.R};{pixel.G};{pixel.B}m";
                            line += ansi + asciiChar;
                        }
                        else
                        {
                            line += asciiChar;
                        }
                    }

                    // Reset color at end of line
                    lines[y] = useColor ? line + "\u001b[0m" : line;
                }

                resized.Dispose();
                return lines;
            }
        }
    }
}

@{
    # Module metadata
    RootModule         = 'Image2Text.psm1'
    ModuleVersion      = '1.0.4'
    GUID               = 'd3f9c5a2-7f3e-4c2f-9a1e-abc123456789'
    Author             = 'Adam B.'
    CompanyName        = 'PowerShellMagic'
    Description        = 'Converts images to ASCII art with optional color output and file export. Built for creative automation and terminal flair.'

    # Compatible with PowerShell 5.1 and 7+
    PowerShellVersion  = '7.0'
    CompatiblePSEditions = @('Desktop', 'Core')

    # Functions to export
    FunctionsToExport  = @('Convert-Image2Text')

    # Cmdlets, aliases, variables
    CmdletsToExport    = @()
    AliasesToExport    = @()
    VariablesToExport  = @()

    # Required assemblies
    RequiredAssemblies = @('Image2Text.dll')

    # Private data (optional)
    PrivateData = @{
        PSData = @{
            Tags         = @('ASCII', 'Image', 'Color', 'Terminal', 'Art', 'Export')
            LicenseUri   = 'https://opensource.org/licenses/MIT'
            ProjectUri   = 'https://github.com/yourrepo/Image2Text'
            IconUri      = 'https://yourdomain.com/icon.png'
            ReleaseNotes = 'Added support for color output, file saving, and plain text export.'
        }
    }
}

<#
.SYNOPSIS
Converts images to ASCII art with optional color rendering and file export.

.DESCRIPTION
This module provides a high-performance wrapper around a .NET-based image-to-text converter. It transforms raster images into terminal-friendly ASCII representations, with support for:

- True-color ANSI output for rich console rendering
- Aspect ratio correction and gamma tuning
- File export with automatic plain-text formatting
- Parameter sets to enforce safe and predictable usage

Designed for PowerShell 6 and 7+, it supports creative automation, terminal art, and comic-style branding workflows.

.PARAMETER ImagePath
Path to the input image file (e.g., PNG, JPG, BMP).

.PARAMETER Width
Target width in characters for the ASCII output. Height is auto-calculated based on image dimensions and aspect ratio.

.PARAMETER AspectRatio
Aspect ratio correction factor to compensate for character height distortion in terminal fonts. Default is 0.55.

.PARAMETER Gamma
Gamma correction factor to adjust perceived brightness. Default is 2.2.

.PARAMETER UseColor
Switch to enable true-color ANSI output for console rendering. Only available in the 'Console' parameter set.

.PARAMETER SaveToFile
Path to save the ASCII output as a plain-text file. Automatically strips ANSI codes. Only available in the 'File' parameter set.

.PARAMETER InvertColor
Switch to invert image colors before conversion. Only available in the 'File' parameter set. This uses MS Paint to perform the inversion.

.EXAMPLE
Convert-Image2Text -ImagePath "C:\Images\logo.png" -Width 150 -UseColor

.EXAMPLE
Convert-Image2Text -ImagePath "C:\Images\logo.png" -Width 150 -SaveToFile "C:\Output\logo.txt"

.EXAMPLE
Convert-Image2Text -ImagePath "C:\Images\logo.png" -Width 400 -SaveToFile "C:\Output\logo.txt" -InvertColor

.NOTES
Author: Adam B.
Module: Image2Text
Version: 1.0.0
License: MIT
#>

# Load the compiled .NET assembly vital to this module's functionality
$assemblyPath = Join-Path $PSScriptRoot 'Image2Text.dll'
if (-not (Test-Path $assemblyPath)) {
    throw "Required assembly not found: $assemblyPath"
}
Add-Type -Path $assemblyPath

function Convert-Image2Text {
    [CmdletBinding(DefaultParameterSetName = 'Console')]
    param (
        [Parameter(Mandatory, ParameterSetName = 'Console')]
        [Parameter(Mandatory, ParameterSetName = 'File')]
        [string]$ImagePath,

        [Parameter(ParameterSetName = 'Console')]
        [Parameter(ParameterSetName = 'File')]
        [int]$Width = 100,

        [Parameter(ParameterSetName = 'Console')]
        [Parameter(ParameterSetName = 'File')]
        [double]$AspectRatio = 0.55,

        [Parameter(ParameterSetName = 'Console')]
        [Parameter(ParameterSetName = 'File')]
        [double]$Gamma = 2.2,

        [Parameter(ParameterSetName = 'Console')]
        [switch]$UseColor,

        [Parameter(Mandatory, ParameterSetName = 'File')]
        [string]$SaveToFile,

        [Parameter(ParameterSetName = 'File')]
        [switch]$InvertColor

    )

    try {
        if (-not (Test-Path $ImagePath)) {
            throw "Image file not found: '$ImagePath'"
        }

        $useColorFlag = $UseColor.IsPresent
        $lines = [Image2Text.AsciiConverter]::Convert($ImagePath, $Width, $AspectRatio, $Gamma, $useColorFlag)

        if ($PSCmdlet.ParameterSetName -eq 'File') {
            if ($PSCmdlet.ParameterSetName -eq 'File') {
                # Always strip ANSI codes for file output
                $lines = $lines | ForEach-Object { $_ -replace "\u001b\[[0-9;]*m", "" }
            }

            $parentFolder = Split-Path $SaveToFile -Parent
            if (-not (Test-Path $parentFolder)) {
                throw "SaveToFile path is invalid or the folder does not exist: '$parentFolder'"
            }

            if ($InvertColor.IsPresent) {
                $tempPath = Join-Path $env:TEMP ("inverted_" + [System.IO.Path]::GetFileName($ImagePath))
                Copy-Item $ImagePath $tempPath -Force
                Write-Host "Inverting image colors via MS Paint..."

                # Launch Paint
                Start-Process "mspaint.exe" -ArgumentList "`"$tempPath`""
                Start-Sleep -Seconds 2  # Give Paint time to open

                # Create VBScript to send keys
                $vbs = @"
Set WshShell = WScript.CreateObject("WScript.Shell")
WScript.Sleep 1000
WshShell.SendKeys "^a"
WScript.Sleep 500
WshShell.SendKeys "^+i"
WScript.Sleep 500
WshShell.SendKeys "^s"
WScript.Sleep 500
WshShell.SendKeys "%{F4}"
"@

                $vbsPath = Join-Path $env:TEMP "invertPaint.vbs"
                Set-Content -Path $vbsPath -Value $vbs -Encoding ASCII

                # Run the VBScript
                Start-Process "wscript.exe" -ArgumentList "`"$vbsPath`"" -WindowStyle Hidden

                Start-Sleep -Seconds 3  # Wait for Paint to close and save

                # Use the inverted image
                $ImagePath = $tempPath
            }



            try {
                [System.IO.File]::WriteAllLines($SaveToFile, $lines)
                Write-Host "ASCII output saved to: $SaveToFile"
            } catch {
                throw "Failed to write to file: '$SaveToFile'. Check permissions."
            }
        } else {
            $lines
        }
    } catch {
        Write-Error $_
    }
}

[Image2Text.AsciiConverter].GetMethod("Convert").GetParameters()