-
Notifications
You must be signed in to change notification settings - Fork 0
Usage
This page explains how to use all the commands that are provided by the Dottifier module.
All the commands in this module also have extra information that can provided by using the Get-Help command.
The Get-Dottified command takes a input text value and transforms this into a dottified text output. A list with text lines to be more specific.
Get-Dottified [-text] <String> [[-size] <Int32>] [[-format] <String>] [[-font] <String>] [<CommonParameters>]
The text parameter provides the text that will be transformed. This parameter is of the type string and can be passed into the command using the pipeline or as a parameter.
Type: string
Syntax: Get-Dottified -Text <text>
Pipeline syntax: <text> | Get-Dottified
Example 1:
"Test" | Get-Dottified
OR
Get-Dottified -Text "Test"
Output:
ooooo ooooo ooo ooooo
o o o o o
o o o o
o ooo ooo o
o o o o
o o o o o
o ooooo ooo o
Example 2:
Get-Dottified -Text "Again"
Output:
o ooo o o o o
o o o o o o o o o
o o o o o o oo o
o o o oo o o o o o o
ooooo o o ooooo o o oo
o o o o o o o o o
o o ooo o o o o o
The size parameter provides the amount of character/dots that will be used to draw each character. It increases the thickness of each character.
Concept of thickness:
(from size 1 to 2)
o → oo
oo
Type: int
Syntax:
Get-Dottified -Size <size>
Example 1:
Get-Dottified -Text "Test" -Size 2
Output:
oooooooooo oooooooooo oooooo oooooooooo
oooooooooo oooooooooo oooooo oooooooooo
oo oo oo oo oo
oo oo oo oo oo
oo oo oo oo
oo oo oo oo
oo oooooo oooooo oo
oo oooooo oooooo oo
oo oo oo oo
oo oo oo oo
oo oo oo oo oo
oo oo oo oo oo
oo oooooooooo oooooo oo
oo oooooooooo oooooo oo
Example 2:
"Again" | Get-Dottified -Size 3
Output:
ooo ooooooooo ooo ooo ooo ooo
ooo ooooooooo ooo ooo ooo ooo
ooo ooooooooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo oooooo ooo
ooo ooo ooo ooo ooo ooo oooooo ooo
ooo ooo ooo ooo ooo ooo oooooo ooo
ooo ooo ooo oooooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo oooooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo oooooo ooo ooo ooo ooo ooo ooo
ooooooooooooooo ooo ooo ooooooooooooooo ooo ooo oooooo
ooooooooooooooo ooo ooo ooooooooooooooo ooo ooo oooooo
ooooooooooooooo ooo ooo ooooooooooooooo ooo ooo oooooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooo ooo ooo ooo ooo ooo ooo
ooo ooo ooooooooo ooo ooo ooo ooo ooo
ooo ooo ooooooooo ooo ooo ooo ooo ooo
ooo ooo ooooooooo ooo ooo ooo ooo ooo
The format is basically the character that will be used in the output. There are also special cases, e.g. the :small-dots format which uses braille character dots instead of a single character.
Type:
Syntax: Get-Dottified -Format <format>
Note: The :small-dots (braille) format will not properly render in the Powershell console, you should write it to a file or something similar instead. Also make sure that the encoding supports this character, e.g. UTF-8.
Example 1:
Get-Dottified -Text "Test" -Format "X"
Output:
XXXXX XXXXX XXX XXXXX
X X X X X
X X X X
X XXX XXX X
X X X X
X X X X X
X XXXXX XXX X
Example 2:
"Test" | Get-Dottified -Format ":solid-dots"
Output:
••••• ••••• ••• •••••
• • • • •
• • • •
• ••• ••• •
• • • •
• • • • •
• ••••• ••• •
Example 3:
$path = "output.txt"; "Test" | Get-Dottified -Format ":small-dots" | Set-Content -Encoding UTF8 -Path $path; Notepad $path
This example writes the output to a file and opens it with notepad.
Output:
⠉⡏⠁⢸⣉⠉⢀⢎⣉⠂⠈⢹⠉⢀
⢀⠇⢀⠸⠤⠤⢀⠢⠤⠃⢀⠸⢀⢀
Example 1:
$path = "output.txt"; "Test" | Get-Dottified -Format ":small-dots" -Size 4 | Set-Content -Encoding UTF8 -Path $path; Notepad $path
This example writes the output to a file and opens it with notepad.
Output:
⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⣿⣿⣿⣿⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀⢀⢀⣿⣿⢀⢀⢀⢀⢀⢀⢀⢀
Example 2:
Get-Dottified -Text "Again" -Format "X" -Size 2
Output:
XX XXXXXX XX XX XX XX
XX XXXXXX XX XX XX XX
XX XX XX XX XX XX XX XX XX
XX XX XX XX XX XX XX XX XX
XX XX XX XX XX XX XXXX XX
XX XX XX XX XX XX XXXX XX
XX XX XX XXXX XX XX XX XX XX XX
XX XX XX XXXX XX XX XX XX XX XX
XXXXXXXXXX XX XX XXXXXXXXXX XX XX XXXX
XXXXXXXXXX XX XX XXXXXXXXXX XX XX XXXX
XX XX XX XX XX XX XX XX XX
XX XX XX XX XX XX XX XX XX
XX XX XXXXXX XX XX XX XX XX
XX XX XXXXXX XX XX XX XX XX
Get-Help Get-Dottified -Detailed