mirror of
https://github.com/fleschutz/PowerShell.git
synced 2024-12-03 21:36:21 +01:00
396 lines
11 KiB
PowerShell
396 lines
11 KiB
PowerShell
Set-StrictMode -off
|
|
|
|
#
|
|
# Module: PowerShell Console ScreenSaver Version 0.1
|
|
# Author: Oisin Grehan ( http://www.nivot.org )
|
|
#
|
|
# A PowerShell CMatrix-style screen saver for true-console hosts.
|
|
#
|
|
# This will not work in Micrisoft's ISE, Quest's PowerGUI or other graphical hosts.
|
|
# It should work fine in PowerShell+ from Idera which is a true console.
|
|
#
|
|
|
|
if ($host.ui.rawui.windowsize -eq $null) {
|
|
write-warning "Sorry, I only work in a true console host like powershell.exe."
|
|
throw
|
|
}
|
|
|
|
#
|
|
# Console Utility Functions
|
|
#
|
|
|
|
function New-Size {
|
|
param([int]$width, [int]$height)
|
|
|
|
new-object System.Management.Automation.Host.Size $width,$height
|
|
}
|
|
|
|
function New-Rectangle {
|
|
param(
|
|
[int]$left,
|
|
[int]$top,
|
|
[int]$right,
|
|
[int]$bottom
|
|
)
|
|
|
|
$rect = new-object System.Management.Automation.Host.Rectangle
|
|
$rect.left= $left
|
|
$rect.top = $top
|
|
$rect.right =$right
|
|
$rect.bottom = $bottom
|
|
|
|
$rect
|
|
}
|
|
|
|
function New-Coordinate {
|
|
param([int]$x, [int]$y)
|
|
|
|
new-object System.Management.Automation.Host.Coordinates $x, $y
|
|
}
|
|
|
|
function Get-BufferCell {
|
|
param([int]$x, [int]$y)
|
|
|
|
$rect = new-rectangle $x $y $x $y
|
|
|
|
[System.Management.Automation.Host.buffercell[,]]$cells = $host.ui.RawUI.GetBufferContents($rect)
|
|
|
|
$cells[0,0]
|
|
}
|
|
|
|
function Set-BufferCell {
|
|
[outputtype([System.Management.Automation.Host.buffercell])]
|
|
param(
|
|
[int]$x,
|
|
[int]$y,
|
|
[System.Management.Automation.Host.buffercell]$cell
|
|
)
|
|
|
|
$rect = new-rectangle $x $y $x $y
|
|
|
|
# return previous
|
|
get-buffercell $x $y
|
|
|
|
# use "fill" overload with single cell rect
|
|
$host.ui.rawui.SetBufferContents($rect, $cell)
|
|
}
|
|
|
|
function New-BufferCell {
|
|
param(
|
|
[string]$Character,
|
|
[consolecolor]$ForeGroundColor = $(get-buffercell 0 0).foregroundcolor,
|
|
[consolecolor]$BackGroundColor = $(get-buffercell 0 0).backgroundcolor,
|
|
[System.Management.Automation.Host.BufferCellType]$BufferCellType = "Complete"
|
|
)
|
|
|
|
$cell = new-object System.Management.Automation.Host.BufferCell
|
|
$cell.Character = $Character
|
|
$cell.ForegroundColor = $foregroundcolor
|
|
$cell.BackgroundColor = $backgroundcolor
|
|
$cell.BufferCellType = $buffercelltype
|
|
|
|
$cell
|
|
}
|
|
|
|
function log {
|
|
param($message)
|
|
[diagnostics.debug]::WriteLine($message, "PS ScreenSaver")
|
|
}
|
|
|
|
#
|
|
# Main entry point for starting the animation
|
|
#
|
|
|
|
function Start-CMatrix {
|
|
param(
|
|
[int]$maxcolumns = 8,
|
|
[int]$frameWait = 100
|
|
)
|
|
|
|
$script:winsize = $host.ui.rawui.WindowSize
|
|
$script:columns = @{} # key: xpos; value; column
|
|
$script:framenum = 0
|
|
|
|
$prevbg = $host.ui.rawui.BackgroundColor
|
|
$host.ui.rawui.BackgroundColor = "black"
|
|
cls
|
|
|
|
$done = $false
|
|
|
|
while (-not $done) {
|
|
|
|
Write-FrameBuffer -maxcolumns $maxcolumns
|
|
|
|
Show-FrameBuffer
|
|
|
|
sleep -milli $frameWait
|
|
|
|
$done = $host.ui.rawui.KeyAvailable
|
|
}
|
|
|
|
$host.ui.rawui.BackgroundColor = $prevbg
|
|
cls
|
|
}
|
|
|
|
# TODO: actually write into buffercell[,] framebuffer
|
|
function Write-FrameBuffer {
|
|
param($maxColumns)
|
|
|
|
# do we need a new column?
|
|
if ($columns.count -lt $maxcolumns) {
|
|
|
|
# incur staggering of columns with get-random
|
|
# by only adding a new one 50% of the time
|
|
if ((get-random -min 0 -max 10) -lt 5) {
|
|
|
|
# search for a column not current animating
|
|
do {
|
|
$x = get-random -min 0 -max ($winsize.width - 1)
|
|
} while ($columns.containskey($x))
|
|
|
|
$columns.add($x, (new-column $x))
|
|
|
|
}
|
|
}
|
|
|
|
$script:framenum++
|
|
}
|
|
|
|
# TODO: setbuffercontent with buffercell[,] framebuffer
|
|
function Show-FrameBuffer {
|
|
param($frame)
|
|
|
|
$completed=@()
|
|
|
|
# loop through each active column and animate a single step/frame
|
|
foreach ($entry in $columns.getenumerator()) {
|
|
|
|
$column = $entry.value
|
|
|
|
# if column has finished animating, add to the "remove" pile
|
|
if (-not $column.step()) {
|
|
$completed += $entry.key
|
|
}
|
|
}
|
|
|
|
# cannot remove from collection while enumerating, so do it here
|
|
foreach ($key in $completed) {
|
|
$columns.remove($key)
|
|
}
|
|
}
|
|
|
|
function New-Column {
|
|
param($x)
|
|
|
|
# return a new module that represents the column of letters and its state
|
|
# we also pass in a reference to the main screensaver module to be able to
|
|
# access our console framebuffer functions.
|
|
|
|
new-module -ascustomobject -name "col_$x" -script {
|
|
param(
|
|
[int]$startx,
|
|
[PSModuleInfo]$parentModule
|
|
)
|
|
|
|
$script:xpos = $startx
|
|
$script:ylimit = $host.ui.rawui.WindowSize.Height
|
|
|
|
[int]$script:head = 1
|
|
[int]$script:fade = 0
|
|
$randomLengthVariation = (1 + (get-random -min -30 -max 50)/100)
|
|
[int]$script:fadelen = [math]::Abs($ylimit / 3 * $randomLengthVariation)
|
|
|
|
$script:fadelen += (get-random -min 0 -max $fadelen)
|
|
|
|
function Step {
|
|
|
|
# reached the bottom yet?
|
|
if ($head -lt $ylimit) {
|
|
|
|
& $parentModule Set-BufferCell $xpos $head (
|
|
& $parentModule New-BufferCell -Character `
|
|
([char](get-random -min 65 -max 122)) -Fore white) > $null
|
|
|
|
& $parentModule Set-BufferCell $xpos ($head - 1) (
|
|
& $parentModule New-BufferCell -Character `
|
|
([char](get-random -min 65 -max 122)) -Fore green) > $null
|
|
|
|
$script:head++
|
|
}
|
|
|
|
# time to start rendering the darker green "tail?"
|
|
if ($head -gt $fadelen) {
|
|
|
|
& $parentModule Set-BufferCell $xpos $fade (
|
|
& $parentModule New-BufferCell -Character `
|
|
([char](get-random -min 65 -max 122)) -Fore darkgreen) > $null
|
|
|
|
# tail end
|
|
$tail = $fade-1
|
|
if ($tail -lt $ylimit) {
|
|
& $parentModule Set-BufferCell $xpos ($fade-1) (
|
|
& $parentModule New-BufferCell -Character `
|
|
([char](get-random -min 65 -max 122)) -Fore black) > $null
|
|
}
|
|
|
|
$script:fade++
|
|
}
|
|
|
|
|
|
# are we done animating?
|
|
if ($fade -lt $ylimit) {
|
|
return $true
|
|
}
|
|
|
|
# remove last row from tail end
|
|
if (($fade - 1) -lt $ylimit) {
|
|
& $parentModule Set-BufferCell $xpos ($fade - 1) (
|
|
& $parentModule New-BufferCell -Character `
|
|
([char]' ') -Fore black) > $null
|
|
}
|
|
|
|
$false
|
|
}
|
|
|
|
Export-ModuleMember -function Step
|
|
|
|
} -args $x, $executioncontext.sessionstate.module
|
|
}
|
|
|
|
function Start-ScreenSaver {
|
|
|
|
# feel free to tweak maxcolumns and frame delay
|
|
# currently 20 columns with 30ms wait
|
|
|
|
Start-CMatrix -max 20 -frame 30
|
|
}
|
|
|
|
function Register-Timer {
|
|
|
|
# prevent prompt from reregistering if explicit disable
|
|
if ($_ssdisabled) {
|
|
return
|
|
}
|
|
|
|
if (-not (Test-Path variable:global:_ssjob)) {
|
|
|
|
# register our counter job
|
|
$global:_ssjob = Register-ObjectEvent $_sstimer elapsed -action {
|
|
|
|
$global:_sscount++;
|
|
$global:_sssrcid = $event.sourceidentifier
|
|
|
|
# hit timeout yet?
|
|
if ($_sscount -eq $_sstimeout) {
|
|
|
|
# disable this event (prevent choppiness)
|
|
Unregister-Event -sourceidentifier $_sssrcid
|
|
Remove-Variable _ssjob -scope Global
|
|
|
|
sleep -seconds 1
|
|
|
|
# start ss
|
|
Start-ScreenSaver
|
|
}
|
|
|
|
}
|
|
}
|
|
}
|
|
|
|
function Enable-ScreenSaver {
|
|
|
|
if (-not $_ssdisabled) {
|
|
write-warning "Screensaver is not disabled."
|
|
return
|
|
}
|
|
|
|
$global:_ssdisabled = $false
|
|
}
|
|
|
|
function Disable-ScreenSaver {
|
|
|
|
if ((Test-Path variable:global:_ssjob)) {
|
|
|
|
$global:_ssdisabled = $true
|
|
Unregister-Event -SourceIdentifier $_sssrcid
|
|
Remove-Variable _ssjob -Scope global
|
|
|
|
} else {
|
|
write-warning "Screen saver is not enabled."
|
|
}
|
|
}
|
|
|
|
function Get-ScreenSaverTimeout {
|
|
new-timespan -seconds $global:_sstimeout
|
|
}
|
|
|
|
function Set-ScreenSaverTimeout {
|
|
[cmdletbinding(defaultparametersetname="int")]
|
|
param(
|
|
[parameter(position=0, mandatory=$true, parametersetname="int")]
|
|
[int]$Seconds,
|
|
|
|
[parameter(position=0, mandatory=$true, parametersetname="timespan")]
|
|
[Timespan]$Timespan
|
|
)
|
|
|
|
if ($pscmdlet.parametersetname -eq "int") {
|
|
$timespan = new-timespan -seconds $Seconds
|
|
}
|
|
|
|
if ($timespan.totalseconds -lt 1) {
|
|
throw "Timeout must be greater than 0 seconds."
|
|
}
|
|
|
|
$global:_sstimeout = $timespan.totalseconds
|
|
}
|
|
|
|
#
|
|
# Eventing / Timer Hooks, clean up and Prompt injection
|
|
#
|
|
|
|
Start-ScreenSaver
|
|
# timeout
|
|
[int]$global:_sstimeout = 180 # default 3 minutes
|
|
|
|
# tick count
|
|
[int]$global:_sscount = 0
|
|
|
|
# modify current prompt function to reset ticks counter to 0 and
|
|
# to reregister timer, while saving for later on module onload
|
|
|
|
$self = $ExecutionContext.SessionState.Module
|
|
$function:global:prompt = $self.NewBoundScriptBlock(
|
|
[scriptblock]::create(
|
|
("{0}`n`$global:_sscount = 0`nRegister-Timer" `
|
|
-f ($global:_ssprompt = gc function:prompt))))
|
|
|
|
# configure our timer
|
|
$global:_sstimer = new-object system.timers.timer
|
|
$_sstimer.Interval = 1000 # tick once a second
|
|
$_sstimer.AutoReset = $true
|
|
$_sstimer.start()
|
|
|
|
# we start out disabled - use enable-screensaver
|
|
$global:_ssdisabled = $true
|
|
|
|
# arrange clean up on module remove
|
|
$ExecutionContext.SessionState.Module.OnRemove = {
|
|
|
|
# restore prompt
|
|
$function:global:prompt = [scriptblock]::Create($_ssprompt)
|
|
|
|
# kill off eventing subscriber, if one exists
|
|
if ($_sssrcid) {
|
|
Unregister-Event -SourceIdentifier $_sssrcid
|
|
}
|
|
|
|
# clean up timer
|
|
$_sstimer.Dispose()
|
|
|
|
# clear out globals
|
|
remove-variable _ss* -scope global
|
|
}
|
|
|
|
Export-ModuleMember -function Start-ScreenSaver, Get-ScreenSaverTimeout, `
|
|
Set-ScreenSaverTimeout, Enable-ScreenSaver, Disable-ScreenSaver |