Skip to content

Latest commit

 

History

History
100 lines (66 loc) · 2.49 KB

ConvertTo-ASCIIArt.md

File metadata and controls

100 lines (66 loc) · 2.49 KB
external help file Module Name online version schema
PSScriptTools-help.xml
PSScriptTools
2.0.0

ConvertTo-ASCIIArt

SYNOPSIS

Convert text to ASCII art.

SYNTAX

ConvertTo-ASCIIArt [-Text] <String> [[-Font] <String>] [<CommonParameters>]

DESCRIPTION

This command can be used to transform a string of text into ASCII art. ConvertTo-ASCIIArt utilizes the web service at https://artii.herokuapp.com which allows you to transform text. You might use this to create headers for your scripts or PowerShell profile.

Expect a period of trial and error to find a good font that works with your text. The shorter your text, the better.

EXAMPLES

Example 1

PS C:\> ConvertTo-ASCIIArt -text PScriptTools -Font cybermedium
___  ____ ____ ____ _ ___  ___ ___ ____ ____ _    ____
|__] [__  |    |__/ | |__]  |   |  |  | |  | |    [__
|    ___] |___ |  \ | |     |   |  |__| |__| |___ ___]

Convert the string 'PSScriptTools' with the cybermedium font. The font parameter supports auto-completion so you can tab-complete to see all possible options.

Example 2

PS C:\> ConvertTo-ASCIIArt -Text $env:COMPUTERNAME -Font ogre |
Out-File c:\scripts\computername-art.txt

Convert the computer name to ASCII art and save the results to a text file. Later you can use Get-Content to display the "artistic" version of the computer name.

PARAMETERS

-Font

Specify a font from https://artii.herokuapp.com/fonts_list. Font names are case-sensitive. You can use tab-completion to cycle through the list.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: big
Accept pipeline input: False
Accept wildcard characters: False

-Text

Enter a short string of text to convert.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.String

OUTPUTS

System.String

NOTES

This command has an alias of cart.

Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/

RELATED LINKS