{"id":4691,"date":"2009-01-11T15:15:18","date_gmt":"2009-01-11T15:15:18","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2009\/01\/11\/colorized-capture-of-console-screen-in-html-and-rtf\/"},"modified":"2019-02-18T13:12:54","modified_gmt":"2019-02-18T20:12:54","slug":"colorized-capture-of-console-screen-in-html-and-rtf","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/colorized-capture-of-console-screen-in-html-and-rtf\/","title":{"rendered":"Colorized capture of console screen in HTML and RTF."},"content":{"rendered":"

In the previous post<\/a> we demonstrated how we can use console host API to capture screen buffer contents as text. But what if we want some colors. Would not it be nice to publish colorized copy of console in HTML or insert it as part of Microsoft Word document. For this to work we need to add some modifications to original script. Colors of each character are available as properties of System.Management.Automation.Host.BufferCell object:<\/p>\n

PS E:\\MyScripts> $bufferWidth = $host.ui.rawui.BufferSize.Width                                                         <\/span>
PS E:\\MyScripts> $bufferHeight = $host.ui.rawui.CursorPosition.Y                                                        <\/span>
PS E:\\MyScripts> $rec = new-object System.Management.Automation.Host.Rectangle 0,0,($bufferWidth - 1),$bufferHeight     <\/span>
PS E:\\MyScripts> $buffer = $host.ui.rawui.GetBufferContents($rec)                                                       <\/span>
PS E:\\MyScripts> $buffer[1,1]                                                                                           <\/span>
                                                                                                                        <\/span>
                    Character               ForegroundColor               BackgroundColor                BufferCellType <\/span>
                    ---------               ---------------               ---------------                -------------- <\/span>
                            o                    DarkYellow                   DarkMagenta                      Complete <\/span>
                                                                                                                        <\/span>
                                                                                                                        <\/span>
PS E:\\MyScripts> <\/span>                                                                                                       <\/span>
<\/pre>\n
All we need to do is to iterate through the screen buffer array, keeping track of the cell colors and generate HTML spans or RTF blocks with varying color attributes as soon as they change.<\/p>\n
Why implementing both formats? While HTML is sufficient for Web applications, we will get bad results if we will try to use it in word processing publications. MS Word is much better at pasting and rendering RTF, rather than HTML. The e-mail editor in Microsoft Outlook also produce better results with RTF. By implementing console capture in both formats we will cover much bigger range of applications.<\/p>\n
Usage of the scripts is fairly easy. The following example demonstrates how to put both scripts to a quick test:<\/p>\n
Windows PowerShell V2 (Community Technology Preview - Features Subject to Change)                                       <\/span>
Copyright (C) 2008 Microsoft Corporation. All rights reserved.                                                          <\/span>
                                                                                                                        <\/span>
PS C:\\Users\\Vladimir> cd E:\\MyScripts                                                                                   <\/span>
PS E:\\MyScripts> $htmlFileName = "$env:temp\\ConsoleBuffer.html"                                                         <\/span>
PS E:\\MyScripts> .\\Get-ConsoleAsHtml | out-file $htmlFileName -encoding UTF8                                            <\/span>
PS E:\\MyScripts> $null = [System.Diagnostics.Process]::Start("$htmlFileName")                                           <\/span>
PS E:\\MyScripts>                                                                                                        <\/span>
PS E:\\MyScripts>                                                                                                        <\/span>
PS E:\\MyScripts> $rtfFileName = "$env:temp\\test.rtf"                                                                    <\/span>
PS E:\\MyScripts> .\\Get-ConsoleAsRTF | out-file $rtfFileName -encoding ascii                                             <\/span>
PS E:\\MyScripts> $null = [System.Diagnostics.Process]::Start("$rtfFileName")                                            <\/span>
PS E:\\MyScripts>                                                                                                        <\/span>
<\/pre>\n
Needless to say, the scripts can be further modified to include configurable parameters such as font name and size. The purpose here is to demonstrate the basic techniques for automated generation of simple HTML and RTF documents.<\/p>\n
Hope you will find it useful,\n  
Vladimir Averkin\n  
Windows PowerShell Team  <\/p>\n
\n
\n
############################################################################################################<\/span>\n  
# Get-ConsoleAsHtml.ps1<\/span>\n  
#<\/span>\n  
# The script captures console screen buffer up to the current cursor position and returns it in HTML format.<\/span>\n  
#<\/span>\n  
# Returns: UTF8-encoded string.<\/span>\n  
#<\/span>\n  
# Example:<\/span>\n  
#<\/span>\n  
# $htmlFileName = "$env:temp\\ConsoleBuffer.html"<\/span>\n  
# .\\Get-ConsoleAsHtml | out-file $htmlFileName -encoding UTF8<\/span>\n  
# $null = [System.Diagnostics.Process]::Start("$htmlFileName")<\/span>\n  
#<\/span><\/p>\n
# Check the host name and exit if the host is not the Windows PowerShell console host.<\/span>\n  
if<\/span> <\/span>(<\/span>$host<\/span>.<\/span>Name<\/span> <\/span>-ne<\/span> <\/span>‘ConsoleHost’<\/span>)<\/span>\n  
{<\/span>\n  
  <\/span>write-host<\/span> <\/span>-ForegroundColor<\/span> <\/span>Red<\/span> <\/span>"This script runs only in the console host. You cannot run this script in $($host.Name)."<\/span>\n  
  <\/span>exit<\/span> <\/span>-1<\/span>\n  
}<\/span><\/p>\n
# The Windows PowerShell console host redefines DarkYellow and DarkMagenta colors and uses them as defaults.<\/span>\n  
# The redefined colors do not correspond to the color names used in HTML, so they need to be mapped to digital color codes.<\/span>\n  
#<\/span>\n  
function<\/span> <\/span>Normalize-HtmlColor<\/span> <\/span>(<\/span>$color<\/span>)<\/span>\n  
{<\/span>\n  
  <\/span>if<\/span> <\/span>(<\/span>$color<\/span> <\/span>-eq<\/span> <\/span>"DarkYellow"<\/span>)<\/span> <\/span>{<\/span> <\/span>$color<\/span> <\/span>=<\/span> <\/span>"#eeedf0"<\/span> <\/span>}<\/span>\n  
  <\/span>if<\/span> <\/span>(<\/span>$color<\/span> <\/span>-eq<\/span> <\/span>"DarkMagenta"<\/span>)<\/span> <\/span>{<\/span> <\/span>$color<\/span> <\/span>=<\/span> <\/span>"#012456"<\/span> <\/span>}<\/span>\n  
  <\/span>return<\/span> <\/span>$color<\/span>\n  
}<\/span><\/p>\n
# Create an HTML span from text using the named console colors.<\/span>\n  
#<\/span>\n  
function<\/span> <\/span>Make-HtmlSpan<\/span> <\/span>(<\/span>$text<\/span>,<\/span> <\/span>$forecolor<\/span> <\/span>=<\/span> <\/span>"DarkYellow"<\/span>,<\/span> <\/span>$backcolor<\/span> <\/span>=<\/span> <\/span>"DarkMagenta"<\/span>)<\/span>\n  
{<\/span>\n  
  <\/span>$forecolor<\/span> <\/span>=<\/span> <\/span>Normalize-HtmlColor<\/span> <\/span>$forecolor<\/span>\n  
  <\/span>$backcolor<\/span> <\/span>=<\/span> <\/span>Normalize-HtmlColor<\/span> <\/span>$backcolor<\/span><\/p>\n
  <\/span># You can also add font-weight:bold tag here if you want a bold font in output.<\/span>\n  
  <\/span>return<\/span> <\/span>"<span style=’font-family:Courier New;color:$forecolor;background:$backcolor’>$text<\/span>"<\/span>\n  
}<\/span><\/p>\n
# Generate an HTML span and append it to HTML string builder<\/span>\n  
#<\/span>\n  
function<\/span> <\/span>Append-HtmlSpan<\/span>\n  
{<\/span>\n  
  <\/span>$spanText<\/span> <\/span>=<\/span> <\/span>$spanBuilder<\/span>.<\/span>ToString<\/span>(<\/span>)<\/span>\n  
  <\/span>$spanHtml<\/span> <\/span>=<\/span> <\/span>Make-HtmlSpan<\/span> <\/span>$spanText<\/span> <\/span>$currentForegroundColor<\/span> <\/span>$currentBackgroundColor<\/span>\n  
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$htmlBuilder<\/span>.<\/span>Append<\/span>(<\/span>$spanHtml<\/span>)<\/span>\n  
}<\/span><\/p>\n
# Append line break to HTML builder<\/span>\n  
#<\/span>\n  
function<\/span> <\/span>Append-HtmlBreak<\/span>\n  
{<\/span>\n  
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$htmlBuilder<\/span>.<\/span>Append<\/span>(<\/span>"<br>"<\/span>)<\/span>\n  
}<\/span><\/p>\n
# Initialize the HTML string builder.<\/span>\n  
$htmlBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span>\n  
$null<\/span> <\/span>=<\/span> <\/span>$htmlBuilder<\/span>.<\/span>Append<\/span>(<\/span>"<pre style=’MARGIN: 0in 10pt 0in;line-height:normal’;font-size:10pt>"<\/span>)<\/span><\/p>\n
# Grab the console screen buffer contents using the Host console API.<\/span>\n  
$bufferWidth<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>BufferSize<\/span>.<\/span>Width<\/span>\n  
$bufferHeight<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>CursorPosition<\/span>.<\/span>Y<\/span>\n  
$rec<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>System.Management.Automation.Host.Rectangle<\/span> <\/span>0<\/span>,<\/span>0<\/span>,<\/span>(<\/span>$bufferWidth<\/span> <\/span>–<\/span> <\/span>1<\/span>)<\/span>,<\/span>$bufferHeight<\/span>\n  
$buffer<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>GetBufferContents<\/span>(<\/span>$rec<\/span>)<\/span><\/p>\n
# Iterate through the lines in the console buffer.<\/span>\n  
for<\/span>(<\/span>$i<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$i<\/span> <\/span>-lt<\/span> <\/span>$bufferHeight<\/span>;<\/span> <\/span>$i<\/span>++<\/span>)<\/span>\n  
{<\/span>\n  
  <\/span>$spanBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span><\/p>\n
  <\/span># Track the colors to identify spans of text with the same formatting.<\/span>\n  
  <\/span>$currentForegroundColor<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span> <\/span>0<\/span>]<\/span>.<\/span>Foregroundcolor<\/span>\n  
  <\/span>$currentBackgroundColor<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span> <\/span>0<\/span>]<\/span>.<\/span>Backgroundcolor<\/span><\/p>\n
  <\/span>for<\/span>(<\/span>$j<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$j<\/span> <\/span>-lt<\/span> <\/span>$bufferWidth<\/span>;<\/span> <\/span>$j<\/span>++<\/span>)<\/span>\n  
  <\/span>{<\/span>\n  
    <\/span>$cell<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span>$j<\/span>]<\/span><\/p>\n
    <\/span># If the colors change, generate an HTML span and append it to the HTML string builder.<\/span>\n  
    <\/span>if<\/span> <\/span>(<\/span>(<\/span>$cell<\/span>.<\/span>ForegroundColor<\/span> <\/span>-ne<\/span> <\/span>$currentForegroundColor<\/span>)<\/span> <\/span>-or<\/span> <\/span>(<\/span>$cell<\/span>.<\/span>BackgroundColor<\/span> <\/span>-ne<\/span> <\/span>$currentBackgroundColor<\/span>)<\/span>)<\/span>\n  
    <\/span>{<\/span>\n  
      <\/span>Append-HtmlSpan<\/span><\/p>\n
      <\/span># Reset the span builder and colors.<\/span>\n  
      <\/span>$spanBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span>\n  
      <\/span>$currentForegroundColor<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Foregroundcolor<\/span>\n  
      <\/span>$currentBackgroundColor<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Backgroundcolor<\/span>\n  
    <\/span>}<\/span><\/p>\n
    <\/span># Substitute characters which have special meaning in HTML.<\/span>\n  
    <\/span>switch<\/span> <\/span>(<\/span>$cell<\/span>.<\/span>Character<\/span>)<\/span>\n  
    <\/span>{<\/span>\n  
      <\/span>‘>’<\/span> <\/span>{<\/span> <\/span>$htmlChar<\/span> <\/span>=<\/span> <\/span>‘&gt;’<\/span> <\/span>}<\/span>\n  
      <\/span>‘<‘<\/span> <\/span>{<\/span> <\/span>$htmlChar<\/span> <\/span>=<\/span> <\/span>‘&lt;’<\/span> <\/span>}<\/span>\n  
      <\/span>‘&’<\/span> <\/span>{<\/span> <\/span>$htmlChar<\/span> <\/span>=<\/span> <\/span>‘&amp;’<\/span> <\/span>}<\/span>\n  
      <\/span>default<\/span>\n  
      <\/span>{<\/span>\n  
        <\/span>$htmlChar<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Character<\/span>\n  
      <\/span>}<\/span>\n  
    <\/span>}<\/span><\/p>\n
    <\/span>$null<\/span> <\/span>=<\/span> <\/span>$spanBuilder<\/span>.<\/span>Append<\/span>(<\/span>$htmlChar<\/span>)<\/span>\n  
  <\/span>}<\/span><\/p>\n
  <\/span>Append-HtmlSpan<\/span>\n  
  <\/span>Append-HtmlBreak<\/span>\n  
}<\/span><\/p>\n
# Append HTML ending tag.<\/span>\n  
$null<\/span> <\/span>=<\/span> <\/span>$htmlBuilder<\/span>.<\/span>Append<\/span>(<\/span>"<\/pre>"<\/span>)<\/span><\/p>\n
return<\/span> <\/span>$htmlBuilder<\/span>.<\/span>ToString<\/span>(<\/span>)<\/span><\/p>\n
<\/span><\/p>\n
<\/span><\/p>\n
<\/p>\n
\n
\n
###########################################################################################################<\/span>\n    
# Get-ConsoleAsRtf.ps1<\/span>\n    
#<\/span>\n    
# The script captures console screen buffer up to the current cursor position and returns it in RTF format.<\/span>\n    
#<\/span>\n    
# Returns: ASCII-encoded string.<\/span>\n    
#<\/span>\n    
# Example:<\/span>\n    
#<\/span>\n    
# $rtfFileName = "$env:temp\\ConsoleBuffer.rtf"<\/span>\n    
# .\\Get-ConsoleAsRtf | out-file $rtfFileName -encoding ascii<\/span>\n    
# $null = [System.Diagnostics.Process]::Start("$rtfFileName")<\/span>\n    
#<\/span><\/p>\n
# Check the host name and exit if the host is not the Windows PowerShell console host.<\/span>\n    
if<\/span> <\/span>(<\/span>$host<\/span>.<\/span>Name<\/span> <\/span>-ne<\/span> <\/span>‘ConsoleHost’<\/span>)<\/span>\n    
{<\/span>\n    
  <\/span>write-host<\/span> <\/span>-ForegroundColor<\/span> <\/span>Red<\/span> <\/span>"This script runs only in the console host. You cannot run this script in $($host.Name)."<\/span>\n    
  <\/span>exit<\/span> <\/span>-1<\/span>\n    
}<\/span><\/p>\n
# Maps console color name to RTF color index.<\/span>\n    
# The index of \\cf is referencing the color definition in RTF color table.<\/span>\n    
#<\/span>\n    
function<\/span> <\/span>Get-RtfColorIndex<\/span> <\/span>(<\/span>[string]<\/span>$color<\/span>)<\/span>\n    
{<\/span>\n    
  <\/span>switch<\/span> <\/span>(<\/span>$color<\/span>)<\/span>\n    
  <\/span>{<\/span>\n    
    <\/span>‘Black’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>17<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkBlue’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>2<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkGreen’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>3<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkCyan’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>4<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkRed’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>5<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkMagenta’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>6<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkYellow’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>7<\/span> <\/span>}<\/span>\n    
    <\/span>‘Gray’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>8<\/span> <\/span>}<\/span>\n    
    <\/span>‘DarkGray’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>9<\/span> <\/span>}<\/span>\n    
    <\/span>‘Blue’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>10<\/span> <\/span>}<\/span>\n    
    <\/span>‘Green’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>11<\/span> <\/span>}<\/span>\n    
    <\/span>‘Cyan’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>12<\/span> <\/span>}<\/span>\n    
    <\/span>‘Red’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>13<\/span> <\/span>}<\/span>\n    
    <\/span>‘Magenta’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>14<\/span> <\/span>}<\/span>\n    
    <\/span>‘Yellow’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>15<\/span> <\/span>}<\/span>\n    
    <\/span>‘White’<\/span> <\/span>{<\/span> <\/span>$index<\/span> <\/span>=<\/span> <\/span>16<\/span> <\/span>}<\/span>\n    
    <\/span>default<\/span>\n    
    <\/span>{<\/span>\n    
      <\/span>$index<\/span> <\/span>=<\/span> <\/span>0<\/span>\n    
    <\/span>}<\/span>\n    
  <\/span>}<\/span>\n    
  <\/span>return<\/span> <\/span>$index<\/span>\n    
}<\/span><\/p>\n
# Create RTF block from text using named console colors.<\/span>\n    
#<\/span>\n    
function<\/span> <\/span>Append-RtfBlock<\/span> <\/span>(<\/span>$text<\/span>)<\/span>\n    
{<\/span>\n    
  <\/span>$foreColorIndex<\/span> <\/span>=<\/span> <\/span>Get-RtfColorIndex<\/span> <\/span>$currentForegroundColor<\/span>\n    
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"{\\cf$foreColorIndex"<\/span>)<\/span><\/p>\n
  <\/span># You can also add \\ab* tag here if you want a bold font in the output.<\/span><\/p>\n
  <\/span>$backColorIndex<\/span> <\/span>=<\/span> <\/span>Get-RtfColorIndex<\/span> <\/span>$currentBackgroundColor<\/span>\n    
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"\\chshdng0\\chcbpat$backColorIndex"<\/span>)<\/span><\/p>\n
  <\/span>$text<\/span> <\/span>=<\/span> <\/span>$blockBuilder<\/span>.<\/span>ToString<\/span>(<\/span>)<\/span>\n    
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>" $text}"<\/span>)<\/span>\n    
}<\/span><\/p>\n
# Append line break to RTF builder<\/span>\n    
#<\/span>\n    
function<\/span> <\/span>Append-Break<\/span>\n    
{<\/span>\n    
  <\/span>$backColorIndex<\/span> <\/span>=<\/span> <\/span>Get-RtfColorIndex<\/span> <\/span>$currentBackgroundColor<\/span>\n    
  <\/span>$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"\\shading0\\cbpat$backColorIndex\\par`r`n"<\/span>)<\/span>\n    
}<\/span><\/p>\n
# Initialize the RTF string builder.<\/span>\n    
$rtfBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span><\/p>\n
# Set the desired font<\/span>\n    
$fontName<\/span> <\/span>=<\/span> <\/span>‘Lucida Console’<\/span>\n    
# Append RTF header<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"{\\rtf1\\fbidis\\ansi\\ansicpg1252\\deff0\\deflang1033{\\fonttbl{\\f0\\fnil\\fcharset0 $fontName;}}"<\/span>)<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"`r`n"<\/span>)<\/span>\n    
# Append RTF color table which will contain all Powershell console colors.<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>‘{\\colortbl;red0\\green0\\blue128;\\red0\\green128\\blue0;\\red0\\green128\\blue128;\\red128\\green0\\blue0;\\red1\\green36\\blue86;\\red238\\green237\\blue240;\\red192\\green192\\blue192;\\red128\\green128\\blue128;\\red0\\green0\\blue255;\\red0\\green255\\blue0;\\red0\\green255\\blue255;\\red255\\green0\\blue0;\\red255\\green0\\blue255;\\red255\\green255\\blue0;\\red255\\green255\\blue255;\\red0\\green0\\blue0;}’<\/span>)<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>"`r`n"<\/span>)<\/span>\n    
# Append RTF document settings.<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>‘\\viewkind4\\uc1\\pard\\ltrpar\\f0\\fs23 ‘<\/span>)<\/span>\n    
 <\/span>\n    
# Grab the console screen buffer contents using the Host console API.<\/span>\n    
$bufferWidth<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>BufferSize<\/span>.<\/span>Width<\/span>\n    
$bufferHeight<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>CursorPosition<\/span>.<\/span>Y<\/span>\n    
$rec<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>System.Management.Automation.Host.Rectangle<\/span> <\/span>0<\/span>,<\/span>0<\/span>,<\/span>(<\/span>$bufferWidth<\/span> <\/span>–<\/span> <\/span>1<\/span>)<\/span>,<\/span>$bufferHeight<\/span>\n    
$buffer<\/span> <\/span>=<\/span> <\/span>$host<\/span>.<\/span>ui<\/span>.<\/span>rawui<\/span>.<\/span>GetBufferContents<\/span>(<\/span>$rec<\/span>)<\/span><\/p>\n
# Iterate through the lines in the console buffer.<\/span>\n    
for<\/span>(<\/span>$i<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$i<\/span> <\/span>-lt<\/span> <\/span>$bufferHeight<\/span>;<\/span> <\/span>$i<\/span>++<\/span>)<\/span>\n    
{<\/span>\n    
  <\/span>$blockBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span><\/p>\n
  <\/span># Track the colors to identify spans of text with the same formatting.<\/span>\n    
  <\/span>$currentForegroundColor<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span> <\/span>0<\/span>]<\/span>.<\/span>Foregroundcolor<\/span>\n    
  <\/span>$currentBackgroundColor<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span> <\/span>0<\/span>]<\/span>.<\/span>Backgroundcolor<\/span><\/p>\n
  <\/span>for<\/span>(<\/span>$j<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span> <\/span>$j<\/span> <\/span>-lt<\/span> <\/span>$bufferWidth<\/span>;<\/span> <\/span>$j<\/span>++<\/span>)<\/span>\n    
  <\/span>{<\/span>\n    
    <\/span>$cell<\/span> <\/span>=<\/span> <\/span>$buffer<\/span>[<\/span>$i<\/span>,<\/span>$j<\/span>]<\/span><\/p>\n
    <\/span># If the colors change, generate an RTF span and append it to the RTF string builder.<\/span>\n    
    <\/span>if<\/span> <\/span>(<\/span>(<\/span>$cell<\/span>.<\/span>ForegroundColor<\/span> <\/span>-ne<\/span> <\/span>$currentForegroundColor<\/span>)<\/span> <\/span>-or<\/span> <\/span>(<\/span>$cell<\/span>.<\/span>BackgroundColor<\/span> <\/span>-ne<\/span> <\/span>$currentBackgroundColor<\/span>)<\/span>)<\/span>\n    
    <\/span>{<\/span>\n    
      <\/span>Append-RtfBlock<\/span><\/p>\n
      <\/span># Reset the block builder and colors.<\/span>\n    
      <\/span>$blockBuilder<\/span> <\/span>=<\/span> <\/span>new-object<\/span> <\/span>system.text.stringbuilder<\/span>\n    
      <\/span>$currentForegroundColor<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Foregroundcolor<\/span>\n    
      <\/span>$currentBackgroundColor<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Backgroundcolor<\/span>\n    
    <\/span>}<\/span><\/p>\n
    <\/span># Substitute characters which have special meaning in RTF.<\/span>\n    
    <\/span>switch<\/span> <\/span>(<\/span>$cell<\/span>.<\/span>Character<\/span>)<\/span>\n    
    <\/span>{<\/span>\n    
      <\/span>"`t"<\/span> <\/span>{<\/span> <\/span>$rtfChar<\/span> <\/span>=<\/span> <\/span>‘\\tab’<\/span> <\/span>}<\/span>\n    
      <\/span>‘\\’<\/span> <\/span>{<\/span> <\/span>$rtfChar<\/span> <\/span>=<\/span> <\/span>‘\\\\’<\/span> <\/span>}<\/span>\n    
      <\/span>‘{‘<\/span> <\/span>{<\/span> <\/span>$rtfChar<\/span> <\/span>=<\/span> <\/span>‘\\{‘<\/span> <\/span>}<\/span>\n    
      <\/span>‘}’<\/span> <\/span>{<\/span> <\/span>$rtfChar<\/span> <\/span>=<\/span> <\/span>‘\\}’<\/span> <\/span>}<\/span>\n    
      <\/span>default<\/span>\n    
      <\/span>{<\/span>\n    
        <\/span>$rtfChar<\/span> <\/span>=<\/span> <\/span>$cell<\/span>.<\/span>Character<\/span>\n    
      <\/span>}<\/span>\n    
    <\/span>}<\/span><\/p>\n
    <\/span>$null<\/span> <\/span>=<\/span> <\/span>$blockBuilder<\/span>.<\/span>Append<\/span>(<\/span>$rtfChar<\/span>)<\/span>\n    
  <\/span>}<\/span><\/p>\n
  <\/span>Append-RtfBlock<\/span>\n    
  <\/span>Append-Break<\/span>\n    
}<\/span><\/p>\n
# Append RTF ending brace.<\/span>\n    
$null<\/span> <\/span>=<\/span> <\/span>$rtfBuilder<\/span>.<\/span>Append<\/span>(<\/span>‘}’<\/span>)<\/span><\/p>\n
return<\/span> <\/span>$rtfBuilder<\/span>.<\/span>ToString<\/span>(<\/span>)<\/span>\n    <\/p>\n
<\/span><\/p>\n
 <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
In the previous post we demonstrated how we can use console host API to capture screen buffer contents as text. But what if we want some colors. Would not it be nice to publish colorized copy of console in HTML or insert it as part of Microsoft Word document. For this to work we need […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[131,197,294],"class_list":["post-4691","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-console","tag-html","tag-rtf"],"acf":[],"blog_post_summary":"
In the previous post we demonstrated how we can use console host API to capture screen buffer contents as text. But what if we want some colors. Would not it be nice to publish colorized copy of console in HTML or insert it as part of Microsoft Word document. For this to work we need […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4691","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=4691"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4691\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=4691"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=4691"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=4691"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}