ansi_gradient.md

title	categories	version	platform	usage
ansi gradient	platform	0.86.0	Add a color gradient (using ANSI color codes) to the given string.	Add a color gradient (using ANSI color codes) to the given string.

{{ $frontmatter.title }} for platform

{{ $frontmatter.platform }}

Signature

> ansi gradient {flags} ...rest

Flags

• --fgstart, -a {string}: foreground gradient start color in hex (0x123456)
• --fgend, -b {string}: foreground gradient end color in hex
• --bgstart, -c {string}: background gradient start color in hex
• --bgend, -d {string}: background gradient end color in hex

Parameters

• ...rest: for a data structure input, add a gradient to strings at the given cell paths

Input/output types:

input	output
list<string>	list<string>
record	record
string	string
table	table

Examples

draw text in a gradient with foreground start and end colors

> 'Hello, Nushell! This is a gradient.' | ansi gradient --fgstart '0x40c9ff' --fgend '0xe81cff'

draw text in a gradient with foreground start and end colors and background start and end colors

> 'Hello, Nushell! This is a gradient.' | ansi gradient --fgstart '0x40c9ff' --fgend '0xe81cff' --bgstart '0xe81cff' --bgend '0x40c9ff'

draw text in a gradient by specifying foreground start color - end color is assumed to be black

> 'Hello, Nushell! This is a gradient.' | ansi gradient --fgstart '0x40c9ff'

draw text in a gradient by specifying foreground end color - start color is assumed to be black

> 'Hello, Nushell! This is a gradient.' | ansi gradient --fgend '0xe81cff'

Tips: Command ansi gradient was not included in the official binaries by default, you have to build it with --features=extra flag