| external help file | Module Name | online version | schema |
|---|---|---|---|
Pansies.dll-Help.xml |
Pansies |
2.0.0 |
Get a range of colors from a starting point aiming to avoid repetition. Doesn't return the starting color unless -Passthru is specified.
Get-Gradient [[-Color] <RgbColor>] [-Count <int>] [-HueStep <int>] [[-BrightStep] <int>]
Get a range of colors that wrap around the hue of the HSL color spectrum.
NOTE: this calls Gradient.GetRainbow, but is named more correctly. When you ask for a lot of colors, the color wheel will wrap around. To avoid repeating colors, it defaults to a HueStep of 50 (meaning it goes a full 360 degrees and wraps around fter 7 steps), but it also changes the brightness, so by the time it wraps around, it's not the same shade. As a result, it doesn't actually repeat unless you ask for hundreds of colors, but the more colors you ask for, the more similar they get. You can tweak that by using BrightStep or HueStep
PS C:\> Get-ColorWheel Magenta -Bright 0
Get a 7-color rainbow. Since we specified Magenta as the starting point, the first returned color is Red.
PS C:\> Get-ColorWheel Magenta
Gets a 2D gradient from the ConsoleColor Red to Blue, with as many colors as the current width of the console.
How much to adjust the lightness (alias Light step)
Type: Int32
Parameter Sets: (All)
Aliases: LightStep
Required: False
Position: Named
Default value: 4
Accept pipeline input: False
Accept wildcard characters: FalseThe starting color (as an RGB color value)
Type: RgbColor
Parameter Sets: (All)
Aliases: StartColor
Required: False
Position: 0
Default value: Red
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseHow many colors to return
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 7
Accept pipeline input: False
Accept wildcard characters: FalseHow many degrees of the color wheel to go for a new color.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 50
Accept pipeline input: False
Accept wildcard characters: FalseIf set, returns the start color in addition to the Count
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).