Functions/Convert-RGBToHex.ps1
|
function Convert-RGBToHex { <# .SYNOPSIS Converts an RGB color string to hex equivalent .DESCRIPTION Converts an RGB color string to hex equivalent. Input should be in the form 'A,R,G,B' .PARAMETER RGB An RGB color string in the form '#,#,#,#' where each number is between 0 and 255. .PARAMETER Prefix A switch indicating whether hex string should be preceded by a hash symbol #. .PARAMETER IncludeInput A switch indicating whether to include the original decimal RGB input in the output, aliased to 'IncludeOriginal' .NOTES Inspired by ISEColorThemeCmdlets.ps1 Script by Jeff Pollock http://gallery.technet.microsoft.com/ISE-Color-Theme-Cmdlets-24905f9e Modified: a) Changed name of parameter to RGB b) Added -Prefix parameter to make # optional. c) Minor tweaking so that it passes Invoke-ScriptAnalyzer d) Added parameter validation on RGB. e) Added .LINK entries for related items .EXAMPLE Convert-RGBToHex -RGB '128,64,32' Would return 804020 .EXAMPLE Convert-RGBToHex -RGB '255,0,0' -Prefix Would return #FF0000 .EXAMPLE convert-RGBtohex '64,128,255' -Prefix Would return #4080FF .EXAMPLE '128,128,92' | convert-RGBtohex Would return 80805C .EXAMPLE Convert-RGBToHex -RGB @('255,0,0','128,80,80') -Prefix -IncludeInput Would return DecimalRGB HexRGB --------- ------- 255,0,0 #00FF0000 128,80,80 #FF805050 .LINK about_ISE-Color-Theme-Cmdlets .LINK Convert-HexToRGB .OUTPUTS [string] #> #region Parameters [CmdletBinding(DefaultParameterSetName = 'String',ConfirmImpact = 'None')] [OutputType('string')] Param( [parameter(Mandatory, Position = 0, ParameterSetName = 'String', ValueFromPipeline)] [string[]] $RGB, [parameter(ParameterSetName = 'Colors', ValueFromPipelineByPropertyName)] [ValidateRange(0,255)] [Alias('R')] [int] $Red, [parameter(ParameterSetName = 'Colors', ValueFromPipelineByPropertyName)] [ValidateRange(0,255)] [Alias('G')] [int] $Green, [parameter(ParameterSetName = 'Colors', ValueFromPipelineByPropertyName)] [ValidateRange(0,255)] [Alias('B')] [int] $Blue, [parameter(ParameterSetName = 'String')] [parameter(ParameterSetName = 'Colors')] [switch] $Prefix, [parameter(ParameterSetName = 'String')] [parameter(ParameterSetName = 'Colors')] [switch] $IncludeInput ) #endregion Parameters begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { if ($PsCmdlet.ParameterSetName -eq 'String') { foreach ($currentRGB in $RGB) { $currentRGB = $currentRGB -replace ' ', '' $currentError = $false try { [int[]] $ColorArray = $currentRGB -split ',' } catch { Write-Error -Message "[$currentRGB] is not a character string of 3 integers separated by a comma" $currentError = $true } if ($ColorArray.count -ne 3) { Write-Error -Message "[$currentRGB] should be 3 integers separated by a comma" $currentError = $true } else { if ($ColorArray[0] -lt 0 -or $ColorArray[0] -gt 255) { Write-Error -Message 'Red should be between 0 and 255' $currentError = $true } if ($ColorArray[1] -lt 0 -or $ColorArray[1] -gt 255) { Write-Error -Message 'Green should be between 0 and 255' $currentError = $true } if ($ColorArray[2] -lt 0 -or $ColorArray[2] -gt 255) { Write-Error -Message 'Blue should be between 0 and 255' $currentError = $true } if (-not $currentError) { $RedHex = '{0:X2}' -f ($ColorArray[0]) $GreenHex = '{0:X2}' -f ($ColorArray[1]) $BlueHex = '{0:X2}' -f ($ColorArray[2]) $Hex = $RedHex + $GreenHex + $BlueHex if ($Prefix) { $Hex = '#' + $Hex } if ($IncludeInput) { New-Object -TypeName psobject -Property ([ordered] @{ RGB = $currentRGB Hex = $Hex }) } else { Write-Output -InputObject $Hex } } } } } else { $RedHex = '{0:X2}' -f $Red $GreenHex = '{0:X2}' -f $Green $BlueHex = '{0:X2}' -f $Blue $Hex = $RedHex + $GreenHex + $BlueHex if ($Prefix) { $Hex = '#' + $Hex } if ($IncludeInput) { New-Object -TypeName psobject -Property ([ordered] @{ Red = $Red Green = $Green Blue = $Blue Hex = $Hex }) } else { Write-Output -InputObject $Hex } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |