nushell/docs/commands/ansi_gradient.md
JT 8c0a2d3c15
Auto-generate markdown command docs (#4451)
* Finish updating

* a couple improvements

* Update renames

* cleanup examples
2022-02-13 21:22:51 -05:00

1.3 KiB

title layout version
ansi gradient command 0.59.0

draw text with a provided start and end code making a gradient

Signature

> ansi gradient ...column path --fgstart --fgend --bgstart --bgend

Parameters

  • ...column path: optionally, draw gradients using text from column paths
  • --fgstart {string}: foreground gradient start color in hex (0x123456)
  • --fgend {string}: foreground gradient end color in hex
  • --bgstart {string}: background gradient start color in hex
  • --bgend {string}: background gradient end color in hex

Examples

draw text in a gradient with foreground start and end colors

> echo '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

> echo '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

> echo '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

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