jarib-win32console 1.2.0.1

data/ext/Console/extconf.rb

@@ -0,0 +1,18 @@
+#################################################################
+#
+# To compile and install, do this:
+#
+# Make sure your compiling environment is in your path.
+# In the case of MSVC, this involves running vcvars32.bat first
+# which is located in the bin directory of MS Visual C++.
+#
+# Then:
+#
+# > ruby extconf.rb
+# > nmake Makefile
+# > nmake install
+#
+#
+##################################################################
+require 'mkmf'
+create_makefile('Console')

data/lib/Win32/Console.rb

@@ -0,0 +1,372 @@
+# Win32::Console:  an object implementing the Win32 API Console functions
+# Copyright (C) 2003 Gonzalo Garramuno (ggarramuno@aol.com)
+#
+# Original Win32API_Console was:
+# Copyright (C) 2001 Michael L. Semon (mlsemon@sega.net)
+
+begin
+  # If Console.so is available, use that.  Otherwise, we define
+  # equivalent functions in ruby (a tad slower)
+  # That dll should define everything in an identical interface
+  # to all the ruby code that the rescue below defines.
+
+  require "Console.so"
+  STDERR.print "Using faster, DLL Console.so\n" if $DEBUG
+
+rescue Exception
+
+  STDERR.print "Using slower, non-DLL Console.rb\n" if $DEBUG
+
+  require 'Win32/Console/constants.rb'
+  require 'Win32/Console/api.rb'
+
+end  # rescue
+
+module Win32
+  class Console
+
+    VERSION = '1.0'
+
+    include Win32::Console::Constants
+
+    def initialize( t = nil )
+      if t and ( t == STD_INPUT_HANDLE or t == STD_OUTPUT_HANDLE or
+                 t == STD_ERROR_HANDLE )
+        @handle = API.GetStdHandle( t )
+      else
+        param1 = GENERIC_READ    | GENERIC_WRITE
+        param2 = FILE_SHARE_READ | FILE_SHARE_WRITE
+        @handle = API.CreateConsoleScreenBuffer( param1, param2,
+                                                 CONSOLE_TEXTMODE_BUFFER )
+      end
+    end
+
+    def Display
+      return API.SetConsoleActiveScreenBuffer(@handle)
+    end
+
+    def Select(type)
+      return API.SetStdHandle(type,@handle)
+    end
+
+    def Title(title = nil)
+      if title
+        return API.SetConsoleTitle(title)
+      else
+        return API.GetConsoleTitle()
+      end
+    end
+
+    def WriteChar(s, col, row)
+      API.WriteConsoleOutputCharacter( @handle, s, col, row )
+    end
+
+    def ReadChar(size, col, row)
+      buffer = ' ' * size
+      if API.ReadConsoleOutputCharacter( @handle, buffer, size, col, row )
+        return buffer
+      else
+        return nil
+      end
+    end
+
+    def WriteAttr(attr, col, row)
+      API.WriteConsoleOutputAttribute( @handle, attr, col, row )
+    end
+
+    def ReadAttr(size, col, row)
+      x = API.ReadConsoleOutputAttribute( @handle, size, col, row )
+      return x.unpack('c'*size)
+    end
+
+    def Cursor(*t)
+      col, row, size, visi = t
+      if col
+        row = -1 if !row
+        if col < 0 or row < 0
+          curr_col, curr_row = API.GetConsoleScreenBufferInfo(@handle)
+          col = curr_col if col < 0
+          row = curr_row if row < 0
+        end
+        API.SetConsoleCursorPosition( @handle, col, row )
+        if size and visi
+          curr_size, curr_visi = API.GetConsoleCursorInfo( @handle )
+          size = curr_size if size < 0
+          visi = curr_visi if visi < 0
+          size = 1 if size < 1
+          size = 99 if size > 99
+          API.SetConsoleCursorInfo( @handle, size, visi )
+        end
+      else
+        d, d, curr_col, curr_row = API.GetConsoleScreenBufferInfo(@handle)
+        curr_size, curr_visi = API.GetConsoleCursorInfo( @handle )
+        return [ curr_col, curr_row, curr_size, curr_visi ]
+      end
+    end
+
+    def Write(s)
+      API.WriteConsole( @handle, s )
+    end
+
+    def WriteFile(s)
+      API.WriteFile( @handle, s)
+    end
+
+    def ReadRect( left, top, right, bottom )
+      col = right  - left + 1
+      row = bottom - top  + 1
+      size = col * row
+      buffer = ' ' * size * 4
+      if API.ReadConsoleOutput( @handle, buffer, col, row, 0, 0,
+                               left, top, right, bottom )
+        #return buffer.unpack('US'*size)  # for unicode
+        return buffer.unpack('axS'*size)  # for ascii
+      else
+        return nil
+      end
+    end
+
+    def WriteRect( buffer, left, top, right, bottom )
+      col = right  - left + 1
+      row = bottom - top  + 1
+      API.WriteConsoleOutput( @handle, buffer, col, row, 0, 0,
+                             left, top, right, bottom )
+    end
+
+    def Scroll( left1, top1, right1, bottom1,
+               col, row, char, attr,
+               left2, top2, right2, bottom2 )
+      API.ScrollConsoleScreenBuffer(@handle, left1, top1, right1, bottom1,
+                                    col, row, char, attr,
+                                    left2, top2, right2, bottom2)
+    end
+
+    def MaxWindow(flag = nil)
+      if !flag
+        info = API.GetConsoleScreenBufferInfo(@handle)
+        return info[9], info[10]
+      else
+        return API.GetLargestConsoleWindowSize(@handle)
+      end
+    end
+
+    def Info()
+      return API.GetConsoleScreenBufferInfo( @handle )
+    end
+
+    def GetEvents()
+      return API.GetNumberOfConsoleInputEvents(@handle)
+    end
+
+    def Flush()
+      return API.FlushConsoleInputBuffer(@handle)
+    end
+
+    def InputChar(number = nil)
+      number = 1 unless number
+      buffer = ' ' * number
+      if API.ReadConsole(@handle, buffer, number) == number
+        return buffer
+      else
+        return nil
+      end
+    end
+
+    def Input()
+      API.ReadConsoleInput(@handle)
+    end
+
+    def PeekInput()
+      API.PeekConsoleInput(@handle)
+    end
+
+    def Mode(mode = nil)
+      if mode
+        mode = mode.pack('L') if mode === Array
+        API.SetConsoleMode(@handle, mode)
+      else
+        begin
+          x =  API.GetConsoleMode(@handle)
+          return x
+        rescue
+          return 9999
+        end
+      end
+    end
+
+    def WriteInput(*t)
+      API.WriteConsoleInput(@handle, *t)
+    end
+
+    def Attr(*attr)
+      if attr.size > 0
+        API.SetConsoleTextAttribute( @handle, attr[0] )
+      else
+        info = API.GetConsoleScreenBufferInfo( @handle )
+        return info[4]
+      end
+    end
+
+    def Size(*t)
+      if t.size == 0
+        col, row = API.GetConsoleScreenBufferInfo(@handle )
+        return [col, row]
+      else
+        row = -1 if !t[1]
+        col = -1 if !t[0]
+        if col < 0 or row < 0
+          curr_col, curr_row = Size()
+          col = curr_col if col < 0
+          row = curr_row if row < 0
+        end
+        API.SetConsoleScreenBufferSize(@handle, row, col)
+      end
+    end
+
+    def Window(*t)
+      if t.size != 5
+        info = API.GetConsoleScreenBufferInfo( @handle )
+        return info[5..8]
+      else
+        API.SetConsoleWindowInfo(@handle, t[0], t[1], t[2], t[3], t[4])
+      end
+    end
+
+    def FillAttr(attr, number = 1, col = -1, row = -1)
+      if col < 0 or row < 0
+        d, d, curr_col, curr_row = API.GetConsoleScreenBufferInfo(@handle)
+        col = curr_col if col < 0
+        row = curr_row if row < 0
+      end
+      API.FillConsoleOutputAttribute(@handle, attr, number, col, row)
+    end
+
+    def FillChar(char, number, col = -1, row = -1)
+      if col < 0 or row < 0
+        d, d, curr_col, curr_row = API.GetConsoleScreenBufferInfo(@handle)
+        col = curr_col if col < 0
+        row = curr_row if row < 0
+      end
+      API.FillConsoleOutputCharacter(@handle, char[0], number, col, row)
+    end
+
+    def Cls()
+      attr = ATTR_NORMAL
+      x, y = Size()
+      left, top, right , bottom = Window()
+      vx = right  - left
+      vy = bottom - top
+      FillChar(' ', x*y, 0, 0)
+      FillAttr(attr, x*y, 0, 0)
+      Cursor(0,0)
+      Window(1,0,0,vx,vy)
+    end
+
+    def Console.Free()
+      API.FreeConsole()
+    end
+
+    def Console.Alloc()
+      API.AllocConsole()
+    end
+
+    def Console.MouseButtons()
+      API.GetNumberOfConsoleMouseButtons()
+    end
+
+    def Console.InputCP(codepage=nil)
+      if codepage
+        API.SetConsoleCP(codepage)
+      else
+        return API.GetConsoleCP()
+      end
+    end
+
+    def Console.OutputCP(codepage=nil)
+      if codepage
+        API.SetConsoleOutputCP(codepage)
+      else
+        return API.GetConsoleOutputCP()
+      end
+    end
+
+    def Console.GenerateCtrlEvent( type=nil, pid=nil )
+      type = API.constant('CTRL_C_EVENT') if type == nil
+      pid  = 0 if pid == nil
+      API.GenerateConsoleCtrlEvent(type, pid)
+    end
+
+  end
+end
+
+
+FG_BLACK        = 0
+FG_BLUE         = Win32::Console::API.constant("FOREGROUND_BLUE")
+FG_LIGHTBLUE    = Win32::Console::API.constant("FOREGROUND_BLUE")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_RED          = Win32::Console::API.constant("FOREGROUND_RED")
+FG_LIGHTRED     = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_GREEN        = Win32::Console::API.constant("FOREGROUND_GREEN")
+FG_LIGHTGREEN   = Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_MAGENTA      = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")
+FG_LIGHTMAGENTA = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_CYAN         = Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")
+FG_LIGHTCYAN    = Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_BROWN        = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_GREEN")
+FG_YELLOW       = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+FG_GRAY         = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")
+FG_WHITE        = Win32::Console::API.constant("FOREGROUND_RED")|
+                  Win32::Console::API.constant("FOREGROUND_GREEN")|
+                  Win32::Console::API.constant("FOREGROUND_BLUE")|
+                  Win32::Console::API.constant("FOREGROUND_INTENSITY")
+
+BG_BLACK        = 0
+BG_BLUE         = Win32::Console::API.constant("BACKGROUND_BLUE")
+BG_LIGHTBLUE    = Win32::Console::API.constant("BACKGROUND_BLUE")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_RED          = Win32::Console::API.constant("BACKGROUND_RED")
+BG_LIGHTRED     = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_GREEN        = Win32::Console::API.constant("BACKGROUND_GREEN")
+BG_LIGHTGREEN   = Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_MAGENTA      = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")
+BG_LIGHTMAGENTA = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_CYAN         = Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")
+BG_LIGHTCYAN    = Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_BROWN        = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_GREEN")
+BG_YELLOW       = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+BG_GRAY         = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")
+BG_WHITE        = Win32::Console::API.constant("BACKGROUND_RED")|
+                  Win32::Console::API.constant("BACKGROUND_GREEN")|
+                  Win32::Console::API.constant("BACKGROUND_BLUE")|
+                  Win32::Console::API.constant("BACKGROUND_INTENSITY")
+
+ATTR_NORMAL  = FG_GRAY  | BG_BLACK
+ATTR_INVERSE = FG_BLACK | BG_GRAY
+
+include Win32::Console::Constants

data/lib/Win32/Console/ANSI.rb

@@ -0,0 +1,349 @@
+# encoding: binary
+#
+# Win32::Console::ANSI
+#
+# Copyright 2004 - Gonzalo Garramuno
+# Licensed under GNU General Public License or Perl's Artistic License
+#
+# Based on Perl's Win32::Console::ANSI
+# Copyright (c) 2003 Jean-Louis Morel <jl_morel@bribes.org>
+# Licensed under GNU General Public License or Perl's Artistic License
+#
+require "Win32/Console"
+
+
+module Kernel
+
+  # Kernel#putc is equivalent to $stdout.putc, but
+  # it doesn't use $stdout.putc.  We redefine it to do that
+  # so that it will buffer the escape sequences properly.
+  # See Win32::Console::ANSI::IO#putc
+  remove_method :putc
+  def putc(int)
+    $stdout.putc(int)
+  end
+
+end
+
+module Win32
+  class Console
+    module ANSI
+
+      class IO < IO
+
+        VERSION = '0.05'
+        DEBUG = nil
+
+        require "win32/registry"
+
+        include Win32::Console::Constants
+
+        # @todo: encode is another perl module
+        EncodeOk = false
+
+        # Retrieving the codepages
+        cpANSI = nil
+        Win32::Registry::HKEY_LOCAL_MACHINE.open('SYSTEM\CurrentControlSet\Control\Nls\CodePage' ) { |reg|
+          cpANSI = reg['ACP']
+        }
+
+        STDERR.puts "Unable to read Win codepage #{cpANSI}" if DEBUG && !cpANSI
+
+
+        cpANSI = 'cp'+(cpANSI ? cpANSI : '1252')      # Windows codepage
+        OEM = Win32::Console::OutputCP()
+        cpOEM = 'cp' + OEM.to_s                       # DOS codepage
+        @@cp = cpANSI + cpOEM
+
+        STDERR.puts "EncodeOk=#{EncodeOk} cpANSI=#{cpANSI} "+
+          "cpOEM=#{cpOEM}" if DEBUG
+
+        @@color = { 30 => 0,                                               # black foreground
+              31 => FOREGROUND_RED,                                  # red foreground
+              32 => FOREGROUND_GREEN,                                # green foreground
+              33 => FOREGROUND_RED|FOREGROUND_GREEN,                 # yellow foreground
+              34 => FOREGROUND_BLUE,                                 # blue foreground
+              35 => FOREGROUND_BLUE|FOREGROUND_RED,                  # magenta foreground
+              36 => FOREGROUND_BLUE|FOREGROUND_GREEN,                # cyan foreground
+              37 => FOREGROUND_RED|FOREGROUND_GREEN|FOREGROUND_BLUE, # white foreground
+              40 => 0,                                               # black background
+              41 => BACKGROUND_RED,                                  # red background
+              42 => BACKGROUND_GREEN,                                # green background
+              43 => BACKGROUND_RED|BACKGROUND_GREEN,                 # yellow background
+              44 => BACKGROUND_BLUE,                                 # blue background
+              45 => BACKGROUND_BLUE|BACKGROUND_RED,                  # magenta background
+              46 => BACKGROUND_BLUE|BACKGROUND_GREEN,                # cyan background
+              47 => BACKGROUND_RED|BACKGROUND_GREEN|BACKGROUND_BLUE, # white background
+        }
+
+        def initialize
+          super(1,'w')
+          @Out = Win32::Console.new(STD_OUTPUT_HANDLE)
+          @x = @y = 0           # to save cursor position
+          @foreground = 7
+          @background = 0
+          @bold =
+          @underline =
+          @revideo =
+          @concealed = nil
+          @conv = 1        # char conversion by default
+          @buffer = []
+          STDERR.puts "Console Mode=#{@Out.Mode}" if DEBUG
+        end
+
+        # this redefined #putc buffers escape sequences but passes
+        # other values to #write as normal.
+        def putc(int)
+          if @buffer.empty?
+            unless int == ?\e
+               write(int.chr)
+            else
+              @buffer << int
+            end
+          else
+            @buffer << int
+            case int
+            when ?m, ?J, ?L, ?M, ?@, ?P, ?A, ?B, ?C, ?D,
+                 ?E, ?F, ?G, ?H, ?f, ?s, ?u, ?U, ?K, ?X
+              write(@buffer.pack("c*"))
+              @buffer.clear
+            end
+          end
+        end
+
+        # #write checks if $stdout is going to the console
+        # or if it's being redirected.
+        # When to the console, it passes the string to
+        # _PrintString to be parsed for escape codes.
+        #
+        # When redirected, it passes to WriteFile to allow escape
+        # codes and all to be output.  The application that is
+        # handling the redirected IO should handle coloring.
+        # For Ruby applications, this means requiring Win32Conole again.
+        def write(*s)
+          if redirected?
+            s.each{ |x| @Out.WriteFile(x.dup.to_s) }
+          else
+            s.each{ |x| _PrintString(x) }
+          end
+        end
+
+        # returns true if outputs is being redirected.
+        def redirected?
+          @Out.Mode > 31
+        end
+
+        private
+
+        def _PrintString(t)
+          s = t.dup.to_s
+          while s != ''
+            if s.sub!( /([^\e]*)?\e([\[\(])([0-9\;\=]*)([a-zA-Z@])(.*)/s,'\5')
+              @Out.Write((_conv("#$1")))
+              if $2 == '['
+                case $4
+                when 'm'        # ESC[#;#;....;#m Set display attributes
+                  attributs = $3.split(';')
+                  attributs.push(nil) unless attributs  # ESC[m == ESC[;m ==...==ESC[0m
+                  attributs.each do |attr|
+                    atv = attr.to_i
+                    case atv
+                    when 0  # ESC[0m reset
+                      @foreground = 7
+                      @background = 0
+                      @bold =
+                      @underline =
+                      @revideo =
+                      @concealed = nil
+                    when 1
+                      @bold = 1
+                    when 21
+                      @bold = nil
+                    when 4
+                      @underline = 1
+                    when 24
+                      @underline = nil
+                    when 7
+                      @revideo = 1
+                    when 27
+                      @revideo = nil
+                    when 8
+                      @concealed = 1
+                    when 28
+                      @concealed = nil
+                    when 30..37
+                      @foreground = atv - 30
+                    when 40..47
+                      @background = atv - 40
+                    end
+                  end
+
+                  if @revideo
+                    attribut = @@color[40+@foreground] |
+                      @@color[30+@background]
+                  else
+                    attribut = @@color[30+@foreground] |
+                      @@color[40+@background]
+                  end
+                  attribut |= FOREGROUND_INTENSITY if @bold
+                  attribut |= BACKGROUND_INTENSITY if @underline
+                  @Out.Attr(attribut)
+                when 'J'
+                  if !$3 or $3 == ''  # ESC[0J from cursor to end of display
+                    info = @Out.Info()
+                    s = ' ' * ((info[1]-info[3]-1)*info[0]+info[0]-info[2]-1)
+                    @Out.WriteChar(s, info[2], info[3])
+                    @Out.Cursor(info[2], info[3])
+                  elsif $3 == '1' # ESC[1J erase from start to cursor.
+                    info = @Out.Info()
+                    s = ' ' * (info[3]*info[0]+info[2]+1)
+                    @Out.WriteChar(s, 0, 0)
+                    @Out.Cursor(info[2], info[3])
+                  elsif $3 == '2' # ESC[2J Clear screen and home cursor
+                    @Out.Cls()
+                    @Out.Cursor(0, 0)
+                  else
+                    STDERR.print "\e#$2#$3#$4" if DEBUG # if ESC-code not implemented
+                  end
+                when 'K'
+                  info = @Out.Info()
+                  if !$3 or $3 == ''                  # ESC[0K Clear to end of line
+                    s = ' ' * (info[7]-info[2]+1)
+                    @Out.Write(s)
+                    @Out.Cursor(info[2], info[3])
+                  elsif $3=='1'   # ESC[1K Clear from start of line to cursor
+                    s = ' '*(info[2]+1)
+                    @Out.WriteChar(s, 0, info[3])
+                    @Out.Cursor(info[2], info[3])
+                  elsif $3=='2'   # ESC[2K Clear whole line.
+                    s = ' '* info[0]
+                    @Out.WriteChar(s, 0, info[3])
+                    @Out.Cursor(info[2], info[3])
+                  end
+                when 'L'  # ESC[#L Insert # blank lines.
+                  n = $3 == ''? 1 : $3.to_i  # ESC[L == ESC[1L
+                  info = @Out.Info()
+                  @Out.Scroll(0, info[3], info[0]-1, info[1]-1,
+                              0, info[3] + n.to_i,
+                               ' '[0], @Out.Attr(),
+                               0, 0, 10000, 10000)
+                  @Out.Cursor(info[2], info[3])
+                when 'M'   # ESC[#M Delete # line.
+                  n = $3 == ''? 1 : $3.to_i  # ESC[M == ESC[1M
+                  info = @Out.Info();
+                  @Out.Scroll(0, info[3]+n, info[0]-1, info[1]-1,
+                              0, info[3],
+                              ' '[0], @Out.Attr(),
+                              0, 0, 10000, 10000)
+                  @Out.Cursor(info[2], info[3])
+                when 'P'   # ESC[#P Delete # characters.
+                  n = $3 == ''? 1 : $3.to_i  # ESC[P == ESC[1P
+                  info = @Out.Info()
+                  n = info[0]-info[2] if info[2]+n > info[0]-1
+                  @Out.Scroll(info[2]+n, info[3] , info[0]-1, info[3],
+                              info[2], info[3],
+                              ' '[0], @Out.Attr(),
+                              0, 0, 10000, 10000)
+                  s = ' ' * n
+                  @Out.Cursor(info[0]-n, info[3])
+                  @Out.Write(s)
+                  @Out.Cursor(info[2], info[3])
+                when '@'      # ESC[#@ Insert # blank Characters
+                  s = ' ' * $3.to_i
+                  info = @Out.Info()
+                  s << @Out.ReadChar(info[7]-info[2]+1, info[2], info[3])
+                  s = s[0..-($3.to_i)]
+                  @Out.Write(s);
+                  @Out.Cursor(info[2], info[3])
+                when 'A'     # ESC[#A Moves cursor up # lines
+                  (x, y) = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[A == ESC[1A
+                  @Out.Cursor(x, y-n)
+                when 'B'    # ESC[#B Moves cursor down # lines
+                  (x, y) = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[B == ESC[1B
+                  @Out.Cursor(x, y+n)
+                when 'C'    # ESC[#C Moves cursor forward # spaces
+                  (x, y) = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[C == ESC[1C
+                  @Out.Cursor(x+n, y)
+                when 'D'    # ESC[#D Moves cursor back # spaces
+                  (x, y) = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[D == ESC[1D
+                  @Out.Cursor(x-n, y)
+                when 'E'    # ESC[#E Moves cursor down # lines, column 1.
+                  x, y = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[E == ESC[1E
+                  @Out.Cursor(0, y+n)
+                when 'F'    # ESC[#F Moves cursor up # lines, column 1.
+                  x, y = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[F == ESC[1F
+                  @Out.Cursor(0, y-n)
+                when 'G'   # ESC[#G Moves cursor column # in current row.
+                  x, y = @Out.Cursor()
+                  n = $3 == ''? 1 : $3.to_i;  # ESC[G == ESC[1G
+                  @Out.Cursor(n-1, y)
+                when 'f' # ESC[#;#f Moves cursor to line #, column #
+                  y, x = $3.split(';')
+                  x = 1 unless x    # ESC[;5H == ESC[1;5H ...etc
+                  y = 1 unless y
+                  @Out.Cursor(x.to_i-1, y.to_i-1) # origin (0,0) in DOS console
+                when 'H' # ESC[#;#H  Moves cursor to line #, column #
+                  y, x = $3.split(';')
+                  x = 1 unless x    # ESC[;5H == ESC[1;5H ...etc
+                  y = 1 unless y
+                  @Out.Cursor(x.to_i-1, y.to_i-1) # origin (0,0) in DOS console
+                when 's'       # ESC[s Saves cursor position for recall later
+                  (@x, @y) = @Out.Cursor()
+                when 'u'       # ESC[u Return to saved cursor position
+                  @Out.Cursor(@x, @y)
+                when 'U'     # ESC(U no mapping
+                  @conv = nil
+                when 'K'     # ESC(K mapping if it exist
+                  @Out.OutputCP(OEM)      # restore original codepage
+                  @conv = 1
+                when 'X'     # ESC(#X codepage **EXPERIMENTAL**
+                  @conv = nil
+                  @Out.OutputCP($3)
+                else
+                  STDERR.puts "\e#$2#$3#$4 not implemented" if DEBUG # ESC-code not implemented
+                end
+              end
+            else
+              @Out.Write(_conv(s))
+              s=''
+            end
+          end
+        end
+
+        def _conv(s)
+          if @concealed
+            s.gsub!( /\S/,' ')
+          elsif @conv
+            if EncodeOk
+              from_to(s, cpANSI, cpOEM)
+            elsif @@cp == 'cp1252cp850'      # WinLatin1 --> DOSLatin1
+              s.tr!("���������������������������������������������������������������������������������������������������ÁāŁƁǁȁɁʁˁ́́΁ρЁсҁӁԁՁցׁ؁فځہ܁݁ށ߁��������������������������������������������","???�??????????????????????????��������ρ��݁�����������������������������������������󁨁������ǎ����Ԑ�ҁӁށցׁ؁с������噞����ꚁ��ᅁ���Ƅ�������������Ё������䔁����������")
+            elsif @@cp == 'cp1252cp437'      # WinLatin1 --> DOSLatinUS
+              s.tr!("���������������������������������������������������������������������������������������������������ÁāŁƁǁȁɁʁˁ́́΁ρЁсҁӁԁՁցׁ؁فځہ܁݁ށ߁��������������������������������������������", "??????????????????????????????������?�????������???�����??��?��??��������?��????����?�???????��????�?????�??�ᅁ��?�������������?������?���?�����??�")
+            elsif @@cp == 'cp1250cp852'      # WinLatin2 --> DOSLatin2
+              s.tr!("���������������������������������������������������������������������������������������������������ÁāŁƁǁȁɁʁˁ́́΁ρЁсҁӁԁՁցׁ؁فځہ܁݁ށ߁��������������������������������������������",
+              "??????????��?��??????????��?������������ρ�?����?��������?����?���???����������񖁾�聵���Ǝ���������Ӂ��ցׁҁс�Ձ��⊙����ށ�뚁�݁�ꁠ��DŽ���������؁���ԁЁ�偢�����������������" )
+            elsif @@cp == 'cp1251cp855'      # WinCyrillic --> DOSCyrillic
+              s.tr!("���������������������������������������������������������������������������������������������������ÁāŁƁǁȁɁʁˁ́́΁ρЁсҁӁԁՁցׁ؁فځہ܁݁ށ߁��������������������������������������������",
+              "��?�??????�?����?????????�?����������??���?���?��?�??��????������������쁭������􁸁��ǁсӁՁׁ݁���聫�����������������������끬������󁷁��ƁЁҁԁց؁���灪������������������")
+            end
+          end
+          return s
+        end
+
+      end
+
+# end print overloading
+
+    end
+  end
+end
+
+$stdout = Win32::Console::ANSI::IO.new()
+