ansicon/readme.md

# ANSICON [![Latest release](http://img.shields.io/github/release/adoxa/ansicon.svg)](https://github.com/adoxa/ansicon/releases)

ANSICON provides ANSI escape sequences for Windows console programs. It
provides much the same functionality as `ANSI.SYS` does for MS-DOS.

`source git`：[https://github.com/adoxa/ansicon](https://github.com/adoxa/ansicon)

## Requirements

* 32-bit: Windows 2000 Professional and later (it won't work with NT or 9X).
* 64-bit: AMD64 (it won't work with IA64).

## How it Works

ANSICON *injects* a DLL into a process, *hooking* its functions.

### Injection

One of three methods is used to inject the DLL.

* `LoadLibrary` via `CreateRemoteThread` for a running process.

* `LdrLoadDll` via `CreateRemoteThread` for a 64-bit .NET AnyCPU process.

* Adding the DLL directly to the import table, otherwise.

### Hooking

Hooking is achieved by modifying import addresses, or the return value of
`GetProcAddress`.
Converted readme.txt into Markdown. 2014-07-01 22:56:13 +02:00			`# ANSICON [![Latest release](http://img.shields.io/github/release/adoxa/ansicon.svg)](https://github.com/adoxa/ansicon/releases)`

Strip `readme.md` to just the intro & requirements 2017-11-30 21:22:10 +10:00			`ANSICON provides ANSI escape sequences for Windows console programs. It`
Converted readme.txt into Markdown. 2014-07-01 22:56:13 +02:00			provides much the same functionality as `ANSI.SYS` does for MS-DOS.

readme: udpate 2025-01-21 16:30:05 +08:00			`source git`：[https://github.com/adoxa/ansicon](https://github.com/adoxa/ansicon)

Converted readme.txt into Markdown. 2014-07-01 22:56:13 +02:00			`## Requirements`

Many changes, bad programmer! Just copying the history from the source: recognize the standard handle defines in WriteFile; minor speed improvement by caching GetConsoleMode; keep track of three handles (ostensibly stdout, stderr and a file); test a DOS header exists before writing to e_oemid; more flexible/robust handling of data directories; files writing to the console will always succeed; log: use API file functions and a custom printf; add a blank line between processes; set function name for MyWriteConsoleA; scan imports from "kernel32" (without extension); added dynamic environment variable CLICOLOR; removed _hwrite (it's the same address as _lwrite); join multibyte characters split across separate writes; remove wcstok, avoiding potential interference with the host; similarly, use a private heap instead of malloc. 2017-07-25 18:18:34 +10:00			`* 32-bit: Windows 2000 Professional and later (it won't work with NT or 9X).`
			`* 64-bit: AMD64 (it won't work with IA64).`
Update documentation Expand the install section, adding a note about using the Startup group. Add a brief "How it Works" section to `readme.md`. 2017-12-23 22:04:44 +10:00
			`## How it Works`

			`ANSICON injects a DLL into a process, hooking its functions.`

			`### Injection`

			`One of three methods is used to inject the DLL.`

			* `LoadLibrary` via `CreateRemoteThread` for a running process.

			* `LdrLoadDll` via `CreateRemoteThread` for a 64-bit .NET AnyCPU process.

			`* Adding the DLL directly to the import table, otherwise.`

			`### Hooking`

			`Hooking is achieved by modifying import addresses, or the return value of`
			`GetProcAddress`.