App::ANSIColorUtils - Utilities related to ANSI color
This document describes version 0.010 of App::ANSIColorUtils (from Perl distribution App-ANSIColorUtils), released on 2021-01-20.
This distributions provides the following command-line utilities:
ansi16-to-rgb
ansi256-to-rgb
rgb-to-ansi-bg-code
rgb-to-ansi-fg-code
rgb-to-ansi16
rgb-to-ansi16-bg-code
rgb-to-ansi16-fg-code
rgb-to-ansi24b-bg-code
rgb-to-ansi24b-fg-code
rgb-to-ansi256
rgb-to-ansi256-bg-code
rgb-to-ansi256-fg-code
show-ansi-color-table
show-assigned-rgb-colors
show-colors
show-colors-from-scheme
show-colors-from-theme
show-rand-rgb-colors
show-text-using-color-gradation
Usage:
show_ansi_color_table(%args) -> [status, msg, payload, meta]
Show a table of ANSI codes & colors.
This function is not exported.
Arguments ('*' denotes required arguments):
width => str (default: 8)
Returns an enveloped result (an array).
First element (status) is an integer containing HTTP status code (200 means OK, 4xx caller error, 5xx function error). Second element (msg) is a string containing error message, or 'OK' if status is 200. Third element (payload) is optional, the actual result. Fourth element (meta) is called result metadata and is optional, a hash that contains extra information.
Return value: (any)
show_assigned_rgb_colors(%args) -> [status, msg, payload, meta]
Take arguments, pass them through assign_rgb_color(), show the results.
assign_rgb_color() from Color::RGB::Util takes a string, produce SHA1 digest from it, then take 24bit from the digest as the assigned color.
assign_rgb_color()
strings* => array[str]
tone => str
show_colors(%args) -> [status, msg, payload, meta]
Show colors specified in argument as text with ANSI colors.
colors* => array[str]
show_colors_from_scheme(%args) -> [status, msg, payload, meta]
Show colors from a Graphics::ColorNames scheme.
scheme* => perl::colorscheme::modname
show_colors_from_theme(%args) -> [status, msg, payload, meta]
Show colors from a ColorTheme scheme.
theme* => perl::colortheme::modname_with_optional_args
show_rand_rgb_colors(%args) -> [status, msg, payload, meta]
Produce N random RGB colors using rand_rgb_colors() and show the results.
light_color => bool (default: 1)
n* => posint
show_text_using_color_gradation(%args) -> [status, msg, payload, meta]
Print text using gradation between two colors.
Examples:
Example #1:
show_text_using_color_gradation(text => "Hello, world", color1 => "blue", color2 => "pink");
Result:
[undef, "0000ff", undef, {}]
This can be used to demonstrate 24bit color support in terminal emulators.
color1 => color::rgb24 (default: "ffff00")
color2 => color::rgb24 (default: "0000ff")
text => str
If unspecified, will show a bar of '=' across the terminal.
Please visit the project's homepage at https://metacpan.org/release/App-ANSIColorUtils.
Source repository is at https://github.com/perlancar/perl-App-ANSIColorUtils.
Please report any bugs or feature requests on the bugtracker website https://github.com/perlancar/perl-App-ANSIColorUtils/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2021, 2020, 2019, 2017 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::ANSIColorUtils, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::ANSIColorUtils
CPAN shell
perl -MCPAN -e shell install App::ANSIColorUtils
For more information on module installation, please visit the detailed CPAN module installation guide.