Main/Set-ConsoleTransparency.ps1
|
<#
.SYNOPSIS Sets console transparency .DESCRIPTION Adjust the console transparency to a given level .EXAMPLE PS> Set-ConsoleTransparency Sets console transparency to default level of 220 .EXAMPLE PS> Set-ConsoleTransparency -Off Disables console transparency .EXAMPLE PS> Set-ConsoleTransparency -Level 200 Sets console transparency to the given level .EXAMPLE PS> Set-ConsoleTransparency -Persist Sets console transparency to the predefined level and persist its value for other sessions .EXAMPLE #> function Set-ConsoleTransparency { [CmdletBinding(DefaultParameterSetName = "Level")] param( [Parameter(ParameterSetName = "Level")] [ValidateRange(0, 255)] # Set transparency level [int] $Level = 220, [Parameter(ParameterSetName = "Off")] # Disables transparency [switch] $Off = $false, [Parameter(ParameterSetName = "Level")] [Parameter(ParameterSetName = "Off")] # Whether to apply this change for future sessions or not [switch] $Persist = $false ) if ($Off) { $Level = 255 if ($Persist) { Invoke-ScriptBlockWithRetry -Context { Remove-Item $script:localSetConsoleTransparencyConfig } -RetryPolicy $script:consoleTransparencyRetryPolicy } } if ($Persist -and -not $Off) { $config = [PSCustomObject] @{ Level = $Level } $saveFileDefinition = { $config | ConvertTo-Json -Compress | Out-File $script:localSetConsoleTransparencyConfig } Invoke-ScriptBlockWithRetry -Context $saveFileDefinition -RetryPolicy $script:consoleTransparencyRetryPolicy } $hwnd = (Get-Process -Id $PID).MainWindowHandle if ([xUtilityTransparency.Win32Methods]::transparencyLevel -ne 0) { [xUtilityTransparency.Win32Methods]::SetWindowTransparent($hwnd, 255) } [xUtilityTransparency.Win32Methods]::SetWindowTransparent($hwnd, $level) } Add-Type -Type @" using System; using System.Runtime.InteropServices; using System.Text; namespace xUtilityTransparency { public static class Win32Methods { internal const int GWL_EXSTYLE = -20; internal const int WS_EX_LAYERED = 0x80000; internal const int LWA_ALPHA = 0x2; internal const int LWA_COLORKEY = 0x1; public static int transparencyLevel = 0; [DllImport("user32.dll")] internal static extern bool SetLayeredWindowAttributes(IntPtr hwnd, uint crKey, byte bAlpha, uint dwFlags); [DllImport("user32.dll")] internal static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong); [DllImport("user32.dll")] internal static extern int GetWindowLong(IntPtr hWnd, int nIndex); public static void SetWindowTransparent(IntPtr hWnd, byte level) { SetWindowLong(hWnd, GWL_EXSTYLE, GetWindowLong(hWnd, GWL_EXSTYLE) ^ WS_EX_LAYERED); SetLayeredWindowAttributes(hWnd, 0, level, LWA_ALPHA); transparencyLevel = level; } } } "@ # Initialization code $script:localSetConsoleTransparencyPath = Join-Path -Path $script:moduleWorkPath -ChildPath "Set-ConsoleTransparency" $script:consoleTransparencyRetryPolicy = New-RetryPolicy -Policy $script:consoleTransparencyPolicyName -Milliseconds $script:consoleTransparencyWaitTime -Retries $script:consoleTransparencyRetries if (-not (Test-Path $script:localSetConsoleTransparencyPath)) { New-Item -ItemType 'Directory' -Path $script:localSetConsoleTransparencyPath | Write-Verbose } $script:localSetConsoleTransparencyConfig = Join-Path -Path $script:localSetConsoleTransparencyPath -ChildPath "config.json" if ((Test-Path $script:localSetConsoleTransparencyConfig)) { $fileRetrieval = { (Get-Content $script:localSetConsoleTransparencyConfig) | Out-String | ConvertFrom-Json | Write-Output } $transparencyConfig = Invoke-ScriptBlockWithRetry -Context $fileRetrieval -RetryPolicy $script:consoleTransparencyRetryPolicy $hwnd = (Get-Process -Id $PID).MainWindowHandle [xUtilityTransparency.Win32Methods]::SetWindowTransparent($hwnd, $transparencyConfig.Level) } |