Add rbeesley's ansi-color.cmd, a CMD-based color tool (& more)

.github/actions/spelling/expect/expect.txt

@@ -12,7 +12,6 @@ ACTCTXW
 activatable
 ACTIVEBORDER
 ACTIVECAPTION
-adaa
 ADDALIAS
 ADDREF
 addressof
@@ -161,6 +160,7 @@ Borland
 BOTTOMLEFT
 BOTTOMRIGHT
 boutput
+boxheader
 BPBF
 bpp
 BPPF
@@ -287,8 +287,6 @@ codepage
 codepath
 codepoint
 codeproject
-coffgroup
-coffgrp
 coinit
 COLLECTIONURI
 colorizing
@@ -299,6 +297,7 @@ colorspaces
 colorspec
 colortable
 colortbl
+colortest
 colortool
 COLR
 combaseapi
@@ -402,6 +401,7 @@ creativecommons
 cred
 cref
 crend
+Crisman
 CRLFs
 crloew
 Crt
@@ -480,7 +480,6 @@ dai
 DATABLOCK
 DATAVIEW
 DATAW
-datetime
 DBatch
 dbcs
 DBCSCHAR
@@ -610,6 +609,7 @@ DINLINE
 directio
 DIRECTX
 Dirs
+DISABLEDELAYEDEXPANSION
 DISABLENOSCROLL
 DISPLAYATTRIBUTE
 DISPLAYATTRIBUTEPROPERTY
@@ -641,6 +641,7 @@ DPICHANGE
 DPICHANGED
 dpix
 dpiy
+dpnx
 DRAWFRAME
 DRAWITEM
 DRAWITEMSTRUCT
@@ -672,8 +673,8 @@ dxgidwm
 dxinterop
 dxsm
 dxttbmp
+Dyreen
 eachother
-eae
 eaf
 EASTEUROPE
 ECH
@@ -688,13 +689,13 @@ edputil
 edu
 Efast
 EHsc
+EINS
 EJO
 ELEMENTNOTAVAILABLE
 elems
 elif
 elseif
 emacs
-emplate
 EMPTYBOX
 enabledelayedexpansion
 endian
@@ -714,6 +715,7 @@ enumranges
 envvar
 eol
 EPres
+EQU
 ERASEBKGND
 errno
 errorlevel
@@ -763,11 +765,13 @@ fdw
 fesb
 FFDE
 FFrom
+fgbg
 FGCOLOR
 fgetc
 fgetwc
 FGHIJ
 fgidx
+FGs
 FILEDESCRIPTION
 fileno
 filepath
@@ -821,6 +825,7 @@ FORCEOFFFEEDBACK
 FORCEONFEEDBACK
 FORCEV
 foreach
+forground
 fprintf
 framebuffer
 FRAMECHANGED
@@ -853,7 +858,6 @@ gcy
 gdi
 gdip
 gdirenderer
-GENPROFILE
 geopol
 GETALIAS
 GETALIASES
@@ -938,6 +942,7 @@ groupbox
 gset
 gsl
 GTP
+GTR
 guc
 gui
 guidatom
@@ -972,7 +977,6 @@ hfont
 hfontresource
 hglobal
 hhh
-HHmm
 hhook
 hhx
 HIBYTE
@@ -1002,7 +1006,6 @@ horiz
 HORZ
 hostable
 hostlib
-Hostx
 HPA
 HPAINTBUFFER
 HPCON
@@ -1129,7 +1132,6 @@ INPUTPROCESSORPROFILE
 inputrc
 Inputreadhandledata
 INSERTMODE
-installationpath
 intellisense
 INTERACTIVITYBASE
 INTERCEPTCOPYPASTE
@@ -1358,6 +1360,7 @@ lstrcmp
 lstrcmpi
 LTEXT
 LTLTLTLTL
+ltrim
 ltype
 LUID
 lval
@@ -1384,6 +1387,7 @@ MAXDIMENSTRING
 maxing
 MAXLENGTH
 MAXSHORT
+maxval
 maxversiontested
 MAXWORD
 maybenull
@@ -1429,7 +1433,6 @@ mkdir
 MMBB
 mmcc
 MMCPL
-MMdd
 mmsystem
 MNC
 MNOPQ
@@ -1687,6 +1690,7 @@ OUTOFCONTEXT
 OUTOFMEMORY
 outout
 Outptr
+outstr
 OVERLAPPEDWINDOW
 OWNDC
 OWNERDRAWFIXED
@@ -1983,7 +1987,6 @@ REGISTERVDM
 regkey
 REGSTR
 reingest
-Relayout
 RELBINPATH
 remoting
 renamer
@@ -2046,6 +2049,8 @@ rtf
 RTFTo
 Rtl
 RTLREADING
+Rtn
+rtrim
 RTTI
 ruleset
 runas
@@ -2062,6 +2067,7 @@ runut
 runxamlformat
 rvalue
 RVERTICAL
+rvpa
 RWIN
 rxvt
 safearray
@@ -2261,6 +2267,7 @@ strrev
 strsafe
 strtok
 structs
+STUBHEAD
 STUVWX
 STX
 stylecop
@@ -2770,6 +2777,7 @@ WRITECONSOLE
 WRITECONSOLEINPUT
 WRITECONSOLEOUTPUT
 WRITECONSOLEOUTPUTSTRING
+wrkstr
 wrl
 wrp
 WRunoff

.github/actions/spelling/expect/web.txt

@@ -17,3 +17,12 @@ mdtauk
 cppreference
 gfycat
 Guake
+askubuntu
+dostips
+viewtopic
+rosettacode
+Rexx
+tldp
+HOWTO
+uwspace
+uwaterloo

.github/actions/spelling/patterns/patterns.txt

@@ -25,3 +25,6 @@ std::memory_order_[\w]+
 D2DERR_SHADER_COMPILE_FAILED
 TIL_FEATURE_[0-9A-Z_]+
 vcvars\w*
+ROY\sG\.\sBIV
+!(?:(?i)ESC)!\[
+!(?:(?i)CSI)!(?:\d+(?:;\d+|)m|[ABCDF])

src/tools/ansi-color/README.md

@@ -0,0 +1,31 @@
+# ANSI-COLOR
+
+Ansi-Color.cmd makes it easy to render SGR attributes, foreground colors, and background colors, in a table. This complements ColorTool for diagnostics purposes and seeing all the colors of the applied color scheme.
+
+```plain
+Usage: ansi-color.cmd [flags] [<definition_file>]
+
+   This file echoes a bunch of color codes to the terminal to demonstrate
+   how they will render. The `Data Segment` portion of the file defines the
+   table layout and allows the user to configure whatever matrix of ANSI
+   Escape Sequence control characters they wish. This can also be read from
+   an external definition file using the same structure.
+
+   Flags:
+     /H  :  This message
+     /A  :  Display the ANSI Escape Sequence control characters
+     /R  :  Show cell R1C1 reference addressing instead of cell text
+     /U  :  Enable UTF-8 support
+
+   The script itself only has one external dependency on CHCP if you want
+   to show Unicode text. This just sets the Command Prompt codepage to 65001
+   and will restore it when the script successfully completes.
+   ```
+
+   The entire tool is written as a Windows Command script and the only dependency is on the stock CHCP tool which can be used to change the command prompt code page. The script makes heavy use of Batch "macros," a concept originally explored by Ed Dyreen, Jeb, and Dave Benham on [DosTips.com](https://www.dostips.com/forum/viewtopic.php?f=3&t=1827). The use of macros in Ansi-Color allow complex results and capable of generating tables defined as separate files.
+
+   Of notable interest, the script itself is its own definition file and doesn't require external definition files to work. In fact, the script file itself is just a UTF-8 text file which can easily be edited, doesn't need to be recompiled, and has configuration settings embedded in it, or it can use flags passed as arguments. Additionally, several definition files are included which replicate the output of similar tools.
+
+   Lastly, there are two diagnostic modes which might be useful when writing color schemes. `/A` is a flag which instead of showing the output table, it replaces the actual ESC code in the output string with the Unicode codepoint representation of an ESC character, and when redirected from standard out to a file like `ansi-color /a > out.txt` it will create a text file which shows what would have been generated. This makes it easier to find errors in how something rendered. Additionally the `/R` flag borrows the Excel R1C1 reference address scheme to replace the Cell text with row/column IDs. In this way you can generate a table and then identify a combination of attributes and colors by that corresponding reference.
+
+   Under PowerShell, you can run all the definitions in a folder and subfolders using `gci -r .\*.def | %{write ($_ | rvpa -r) && .\ansi-color.cmd $_}`. This is convenient for finding a specific definition.