Difference between revisions of "Unit GraphicsConsole"

From Ultibo.org
Jump to: navigation, search
Line 51: Line 51:
 
! '''Note'''
 
! '''Note'''
 
| To be documented
 
| To be documented
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
 +
'''Graphics console functions'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowCreate(Console:PConsoleDevice; Position:LongWord):TWindowHandle;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Create a new Graphics window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Console'''
 +
| The console device to create the new window on
 +
|-
 +
! '''Position'''
 +
| The console position to create the new window at (eg CONSOLE_POSITION_FULL)
 +
|-
 +
! '''Return'''
 +
| Handle to new Graphics window or INVALID_HANDLE_VALUE if the window could not be created
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowCreateEx(Console:PConsoleDevice; Font:TFontHandle; Size,State,Mode,Position:LongWord):TWindowHandle;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Create a new Graphics window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Console'''
 +
| The console device to create the new window on
 +
|-
 +
! '''Font'''
 +
| The handle of the default font for the new console window
 +
|-
 +
! '''Size'''
 +
| The size in bytes to allocate for the new window entry (Defaults to SizeOf(TGraphicsWindow))
 +
|-
 +
! '''State'''
 +
| The state of the new console window (WINDOW_STATE_VISIBLE or WINDOW_STATE_INVISIBLE)
 +
|-
 +
! '''Mode'''
 +
| The mode of the new console window (Normally WINDOW_MODE_GRAPHICS)
 +
|-
 +
! '''Position'''
 +
| The console position to create the new window at (eg CONSOLE_POSITION_FULL)
 +
|-
 +
! '''Return'''
 +
| Handle to new Graphics window or INVALID_HANDLE_VALUE if the window could not be created
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDestroy(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Close and Destroy an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to destroy
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowShow(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Make an existing console window visible and show it on screen</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to show
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowHide(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Make an existing console window invisible and hide it on screen</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to hide
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowFind(Console:PConsoleDevice; Position:LongWord):TWindowHandle; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Find an existing console window in the position specified</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Console'''
 +
| The console device to find the window on
 +
|-
 +
! '''Position'''
 +
| The window position to find (eg CONSOLE_POSITION_FULL)
 +
|-
 +
! '''Return'''
 +
| The handle of the existing window or INVALID_HANDLE_VALUE if not found
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowEnumerate(Console:PConsoleDevice; Callback:TGraphicsWindowEnumerate; Data:Pointer):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Enumerate existing console windows on the specified console device</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Console'''
 +
| The console device to enumerate windows for
 +
|-
 +
! '''Callback'''
 +
| The function to call for each window enumerated
 +
|-
 +
! '''Data'''
 +
| A pointer to private data to be passed to the callback (Optional
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowCheckFlag(Handle:TWindowHandle; Flag:LongWord):Boolean; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Check an existing console window to determine if a flag is set or not</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to check
 +
|-
 +
! '''Flag'''
 +
| The window flag to check for (eg WINDOW_FLAG_LINE_WRAP)
 +
|-
 +
! '''Return'''
 +
| True if the flag is set, False if not set
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetMode(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the window mode of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the mode for
 +
|-
 +
! '''Return'''
 +
| The window mode (eg WINDOW_MODE_GRAPHICS)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetState(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the window state of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the state for
 +
|-
 +
! '''Return'''
 +
| The window state (eg WINDOW_STATE_INVISIBLE)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetPosition(Handle:TWindowHandle):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the position of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the position for
 +
|-
 +
! '''Return'''
 +
| The window position (eg CONSOLE_POSITION_FULL)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetPosition(Handle:TWindowHandle; Position:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the position of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to set the position for
 +
|-
 +
! '''Position'''
 +
| The new window position to set
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| The function will return ERROR_INVALID_PARAMETER if another window exists at the position
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetMinX(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current minimum X of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get MinX for
 +
|-
 +
! '''Return'''
 +
| The minimum X value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, X is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetMinY(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current minimum Y of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get MinY for
 +
|-
 +
! '''Return'''
 +
| The minimum Y value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Y is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetMaxX(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current maximum X of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get MaxX for
 +
|-
 +
! '''Return'''
 +
| The maximum X value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, X is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetMaxY(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current maximum Y of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get MaxY for
 +
|-
 +
! '''Return'''
 +
| The maximum Y value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Y is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetRect(Handle:TWindowHandle):TConsoleRect; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the rectangle X1,Y1,X2,Y2 of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the rectangle for
 +
|-
 +
! '''Return'''
 +
| The rectangle of the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Rect is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetRect(Handle:TWindowHandle; const ARect:TConsoleRect):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the rectangle X1,Y1,X2,Y2 of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to set the rectangle for
 +
|-
 +
! '''Rect'''
 +
| The rectangle to set for the window viewport
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Rect is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetViewport(Handle:TWindowHandle; var X1,Y1,X2,Y2:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the X1,Y1,X2,Y2 of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the viewport for
 +
|-
 +
! '''X1'''
 +
| The left edge of the current viewport
 +
|-
 +
! '''Y1'''
 +
| The top edge of the current viewport
 +
|-
 +
! '''X2'''
 +
| The right edge of the current viewport
 +
|-
 +
! '''Y2'''
 +
| The bottom edge of the current viewport
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetViewport(Handle:TWindowHandle; X1,Y1,X2,Y2:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the X1,Y1,X2,Y2 of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the viewport for
 +
|-
 +
! '''X1'''
 +
| The left edge of the window viewport
 +
|-
 +
! '''Y1'''
 +
| The top edge of the window viewport
 +
|-
 +
! '''X2'''
 +
| The right edge of the window viewport
 +
|-
 +
! '''Y2'''
 +
| The bottom edge of the window viewport
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetCols(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current columns of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get columns for
 +
|-
 +
! '''Return'''
 +
| The columns value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Columns is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetRows(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current rows of the window viewport for an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get rows for
 +
|-
 +
! '''Return'''
 +
| The rows value for the current window viewport
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Rows is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetWidth(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the absolute width of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the width for
 +
|-
 +
! '''Return'''
 +
| The absolute width of the window
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Width is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetHeight(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the absolute height of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the height for
 +
|-
 +
! '''Return'''
 +
| The absolute height of the window
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Height is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetFormat(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the color format of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the format for
 +
|-
 +
! '''Return'''
 +
| The color format of the window (eg COLOR_FORMAT_ARGB32)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetForecolor(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current foreground color of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the foreground color for
 +
|-
 +
! '''Return'''
 +
| The foreground color of the window (eg COLOR_WHITE)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetForecolor(Handle:TWindowHandle; Color:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the current foreground color of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to set the foreground color for
 +
|-
 +
! '''Color'''
 +
| The foreground color to set (eg COLOR_WHITE)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetBackcolor(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the current background color of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the background color for
 +
|-
 +
! '''Return'''
 +
| The background color of the window (eg COLOR_BLACK)
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetBackcolor(Handle:TWindowHandle; Color:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the current background color of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to set the background color for
 +
|-
 +
! '''Color'''
 +
| The background color to set (eg COLOR_BLACK)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetFont(Handle:TWindowHandle):TFontHandle;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get the default font of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get the default font for
 +
|-
 +
! '''Return'''
 +
| The font handle of the default font or INVALID_HANDLE_VALUE on error
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowSetFont(Handle:TWindowHandle; Font:TFontHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Set the default font of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to set the default font for
 +
|-
 +
! '''Font'''
 +
| The font handle of the default font to set
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowClear(Handle:TWindowHandle):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Clear the current viewport of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to clear
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowClearEx(Handle:TWindowHandle; X1,Y1,X2,Y2,Color:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Clear part of the the current viewport of an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to clear
 +
|-
 +
! '''X1'''
 +
| The left edge of the area to clear (relative to current viewport)
 +
|-
 +
! '''Y1'''
 +
| The top edge of the area to clear (relative to current viewport)
 +
|-
 +
! '''X2'''
 +
| The right edge of the area to clear (relative to current viewport)
 +
|-
 +
! '''Y2'''
 +
| The bottom edge of the area to clear (relative to current viewport)
 +
|-
 +
! '''Color'''
 +
| The fill color for the area to clear (eg COLOR_WHITE)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawBox(Handle:TWindowHandle; X1,Y1,X2,Y2,Color,Width:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a rectangular box outline on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X1'''
 +
| The left edge of the box (relative to current viewport)
 +
|-
 +
! '''Y1'''
 +
| The top edge of the box (relative to current viewport)
 +
|-
 +
! '''X2'''
 +
| The right edge of the box (relative to current viewport)
 +
|-
 +
! '''Y2'''
 +
| The bottom edge of the box (relative to current viewport)
 +
|-
 +
! '''Color'''
 +
| The color to draw with (eg COLOR_WHITE)
 +
|-
 +
! '''Width'''
 +
| The width of the box outline
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawLine(Handle:TWindowHandle; X1,Y1,X2,Y2,Color,Width:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a line on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X1'''
 +
| The left starting point of the line (relative to current viewport)
 +
|-
 +
! '''Y1'''
 +
| The top starting point of the box (relative to current viewport)
 +
|-
 +
! '''X2'''
 +
| The right ending point of the box (relative to current viewport)
 +
|-
 +
! '''Y2'''
 +
| The bottom ending point of the box (relative to current viewport)
 +
|-
 +
! '''Color'''
 +
| The color to draw with (eg COLOR_WHITE)
 +
|-
 +
! '''Width'''
 +
| The width of the line
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawBlock(Handle:TWindowHandle; X1,Y1,X2,Y2,Color:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a rectangular filled block on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X1'''
 +
| The left edge of the block (relative to current viewport)
 +
|-
 +
! '''Y1'''
 +
| The top edge of the block (relative to current viewport)
 +
|-
 +
! '''X2'''
 +
| The right edge of the block (relative to current viewport)
 +
|-
 +
! '''Y2'''
 +
| The bottom edge of the block (relative to current viewport)
 +
|-
 +
! '''Color'''
 +
| The color to draw with (eg COLOR_WHITE)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawChar(Handle:TWindowHandle; Ch:Char; X,Y:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a character on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''Ch'''
 +
| The character to draw
 +
|-
 +
! '''X'''
 +
| The left starting point of the character (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the character (relative to current viewport)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawCharEx(Handle:TWindowHandle; Font:TFontHandle; Ch:Char; X,Y,Forecolor,Backcolor:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a character on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''Font'''
 +
| The handle of the font to draw the character with
 +
|-
 +
! '''Ch'''
 +
| The character to draw
 +
|-
 +
! '''X'''
 +
| The left starting point of the character (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the character (relative to current viewport)
 +
|-
 +
! '''Forecolor'''
 +
| The foreground color for the character (eg COLOR_WHITE)
 +
|-
 +
! '''Backcolor'''
 +
| The background color for the character (eg COLOR_BLACK)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawText(Handle:TWindowHandle; const Text:String; X,Y:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a text string on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''Text'''
 +
| The text to draw
 +
|-
 +
! '''X'''
 +
| The left starting point of the text (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the text (relative to current viewport)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawTextEx(Handle:TWindowHandle; Font:TFontHandle; const Text:String; X,Y,Forecolor,Backcolor:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a text string on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''Font'''
 +
| The handle of the font to draw the text with
 +
|-
 +
! '''Text'''
 +
| The text to draw
 +
|-
 +
! '''X'''
 +
| The left starting point of the text (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the text (relative to current viewport)
 +
|-
 +
! '''Forecolor'''
 +
| The foreground color for the text (eg COLOR_WHITE)
 +
|-
 +
! '''Backcolor'''
 +
| The background color for the text (eg COLOR_BLACK)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawPixel(Handle:TWindowHandle; X,Y,Color:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw a single pixel on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X'''
 +
| The column for the pixel (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The row for the pixel (relative to current viewport)
 +
|-
 +
! '''Color'''
 +
| The color for the pixel (eg COLOR_WHITE)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowDrawImage(Handle:TWindowHandle; X,Y:LongWord; Image:Pointer; Width,Height,Format:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw an image on an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X'''
 +
| The left starting point of the image (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the image (relative to current viewport)
 +
|-
 +
! '''Image'''
 +
| Pointer to the image data in a contiguous block of pixel rows
 +
|-
 +
! '''Width'''
 +
| The width in pixels of a row in the image data
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows in the image data
 +
|-
 +
! '''Format'''
 +
| The color format of the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetPixel(Handle:TWindowHandle; X,Y:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get a single pixel from an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get from
 +
|-
 +
! '''X'''
 +
| The column of the pixel (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The row of the pixel (relative to current viewport)
 +
|-
 +
! '''Return'''
 +
| The color of the pixel at X,Y (eg COLOR_WHITE)
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowGetImage(Handle:TWindowHandle; X,Y:LongWord; Image:Pointer; Width,Height,Format:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get an image from an existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get from
 +
|-
 +
! '''X'''
 +
| The left starting point of the image (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the image (relative to current viewport)
 +
|-
 +
! '''Image'''
 +
| Pointer to a block of memory large enough to hold the image in a contiguous block of pixel rows
 +
|-
 +
! '''Width'''
 +
| The width in pixels of a row of the image
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows of the image
 +
|-
 +
! '''Format'''
 +
| The color format to store in the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowCopyImage(Handle:TWindowHandle; const Source,Dest:TConsolePoint; Width,Height:LongWord):LongWord; inline;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Copy an image from one place to another in a existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to copy from and to
 +
|-
 +
! '''Source'''
 +
| The starting point (X,Y) to copy the image from
 +
|-
 +
! '''Dest'''
 +
| The starting point (X,Y) to copy the image to
 +
|-
 +
! '''Width'''
 +
| The width in pixels of each row of the image
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows of the image
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowMoveImage(Handle:TWindowHandle; const Source,Dest:TConsolePoint; Width,Height,Fillcolor:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Move an image from one place to another in a existing console window</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to copy from and to
 +
|-
 +
! '''Source'''
 +
| The starting point (X,Y) to copy the image from
 +
|-
 +
! '''Dest'''
 +
| The starting point (X,Y) to copy the image to
 +
|-
 +
! '''Width'''
 +
| The width in pixels of each row of the image
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows of the image
 +
|-
 +
! '''Fillcolor'''
 +
| The color to fill the area where the image was moved from (COLOR_NONE for no fill, same as copy)
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowImageSize(Handle:TWindowHandle; Width,Height,Format:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Calculate the size in bytes of an image that is Width by Height in the color format specified</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window for the image
 +
|-
 +
! '''Width'''
 +
| The width of the image in pixels
 +
|-
 +
! '''Height'''
 +
| The height of the image in pixels
 +
|-
 +
! '''Format'''
 +
| The color format to use for the calculation (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
 +
|-
 +
! '''Return'''
 +
| The size in bytes for an image of the specified size and format or 0 on error
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowImageFromStream(Handle:TWindowHandle; X,Y:LongWord; Stream:TStream; Width,Height,Format:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Draw an image to an existing console window from a supplied stream</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to draw on
 +
|-
 +
! '''X'''
 +
| The left starting point of the image (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the image (relative to current viewport)
 +
|-
 +
! '''Stream'''
 +
| A stream containing the image data in a contiguous block of pixel rows
 +
|-
 +
! '''Width'''
 +
| The width in pixels of a row in the image data
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows in the image data
 +
|-
 +
! '''Format'''
 +
| The color format of the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 +
|-
 +
|}
 +
</div></div>
 +
<br />
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial; padding-top: 0px; padding-bottom: 15px;">
 +
<pre style="border: 0; padding-bottom:0px;">function GraphicsWindowImageToStream(Handle:TWindowHandle; X,Y:LongWord; Stream:TStream; Width,Height,Format:LongWord):LongWord;</pre>
 +
<div style="font-size: 14px; padding-left: 12px;">'''Description:''' Get an image from an existing console window to a supplied stream</div>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
! '''Handle'''
 +
| The handle of the window to get from
 +
|-
 +
! '''X'''
 +
| The left starting point of the image (relative to current viewport)
 +
|-
 +
! '''Y'''
 +
| The top starting point of the image (relative to current viewport)
 +
|-
 +
! '''Stream'''
 +
| A stream large enough to hold the image in a contiguous block of pixel rows
 +
|-
 +
! '''Width'''
 +
| The width in pixels of a row of the image
 +
|-
 +
! '''Height'''
 +
| The height in pixels of all rows of the image
 +
|-
 +
! '''Format'''
 +
| The color format to store in the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
 +
|-
 +
! '''Return'''
 +
| ERROR_SUCCESS if completed or another error code on failure
 +
|-
 +
! '''Note'''
 +
| For Graphics Console functions, Viewport is based on screen pixels not characters
 
|-
 
|-
 
|}
 
|}

Revision as of 05:06, 1 August 2016

Return to Unit Reference


Description


The Graphics console unit provides access to the underlying framebuffer device as a pixel interface that allows putting blocks (or rectangles) of pixel data on to the screen or getting rectangles of pixel data from the screen. Functions are also included to copy a rectangle from one part of the screen to another and to put text (with a specified font) on to the screen.

Most image formats either consist of, or can be decoded to, a block of data that is a number of horizontal rows each with a number of pixels (columns) with each pixel containing color information in a certain bit size (8/16/24/32) and format (RGB/BGR/RGBA etc).

If the data exists in memory as a single contiguous block with each row following directly after the previous row then that can be passed directly to the functions in this unit (eg GraphicsWindowDrawImage) to be drawn on the screen.

Many graphics libraries do image manipulation, rendering and compositing to a memory buffer in a form that is compatible with the functions in this unit so a complex image can be constructed in memory and then transferred to the screen in a single operation. This is sometimes referred to as a bit block transfer or BitBlt and is a very standard technique for rendering both text and images to a framebuffer device.

This unit extends the console unit by creating a new type of console window (WINDOW_MODE_GRAPHICS) and therefore allows both text console windows and graphics console windows to co-exist on the screen at once.

The functions in this unit cannot be used to draw on a text console window (WINDOW_MODE_TEXT) and vice versa the functions in the console unit cannot be used to draw on a graphics console window.

Like the console unit, the graphics console supports setting a viewport for a specified window to allow masking the area to be written to. However the graphics console does not support a tracking a cursor X and Y position. Setting a window as the default is also not supported since that functionality is purely intended to support the RTL functions for text output.

Graphics windows can only be created on console devices which have a mode of CONSOLE_MODE_PIXEL.

Notes: Unlike the Console unit, Graphics console coordinates are always based on pixels not characters. Graphics console coordinates begin at 0,0 and extend to Width - 1, Height - 1. Graphics Window coordinates X,Y are always based on pixels, beginning at 0,0 and extending to Cols - 1, Rows - 1.

Constants


To be documented

Type definitions


To be documented

Public variables


To be documented

Function declarations



Initialization functions

procedure GraphicsConsoleInit;
Description: To be documented
Note To be documented


Graphics console functions

function GraphicsWindowCreate(Console:PConsoleDevice; Position:LongWord):TWindowHandle;
Description: Create a new Graphics window
Console The console device to create the new window on
Position The console position to create the new window at (eg CONSOLE_POSITION_FULL)
Return Handle to new Graphics window or INVALID_HANDLE_VALUE if the window could not be created


function GraphicsWindowCreateEx(Console:PConsoleDevice; Font:TFontHandle; Size,State,Mode,Position:LongWord):TWindowHandle;
Description: Create a new Graphics window
Console The console device to create the new window on
Font The handle of the default font for the new console window
Size The size in bytes to allocate for the new window entry (Defaults to SizeOf(TGraphicsWindow))
State The state of the new console window (WINDOW_STATE_VISIBLE or WINDOW_STATE_INVISIBLE)
Mode The mode of the new console window (Normally WINDOW_MODE_GRAPHICS)
Position The console position to create the new window at (eg CONSOLE_POSITION_FULL)
Return Handle to new Graphics window or INVALID_HANDLE_VALUE if the window could not be created


function GraphicsWindowDestroy(Handle:TWindowHandle):LongWord; inline;
Description: Close and Destroy an existing console window
Handle The handle of the window to destroy
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowShow(Handle:TWindowHandle):LongWord; inline;
Description: Make an existing console window visible and show it on screen
Handle The handle of the window to show
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowHide(Handle:TWindowHandle):LongWord; inline;
Description: Make an existing console window invisible and hide it on screen
Handle The handle of the window to hide
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowFind(Console:PConsoleDevice; Position:LongWord):TWindowHandle; inline;
Description: Find an existing console window in the position specified
Console The console device to find the window on
Position The window position to find (eg CONSOLE_POSITION_FULL)
Return The handle of the existing window or INVALID_HANDLE_VALUE if not found


function GraphicsWindowEnumerate(Console:PConsoleDevice; Callback:TGraphicsWindowEnumerate; Data:Pointer):LongWord; inline;
Description: Enumerate existing console windows on the specified console device
Console The console device to enumerate windows for
Callback The function to call for each window enumerated
Data A pointer to private data to be passed to the callback (Optional
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowCheckFlag(Handle:TWindowHandle; Flag:LongWord):Boolean; inline;
Description: Check an existing console window to determine if a flag is set or not
Handle The handle of the window to check
Flag The window flag to check for (eg WINDOW_FLAG_LINE_WRAP)
Return True if the flag is set, False if not set


function GraphicsWindowGetMode(Handle:TWindowHandle):LongWord; inline;
Description: Get the window mode of an existing console window
Handle The handle of the window to get the mode for
Return The window mode (eg WINDOW_MODE_GRAPHICS)


function GraphicsWindowGetState(Handle:TWindowHandle):LongWord; inline;
Description: Get the window state of an existing console window
Handle The handle of the window to get the state for
Return The window state (eg WINDOW_STATE_INVISIBLE)


function GraphicsWindowGetPosition(Handle:TWindowHandle):LongWord; inline;
Description: Get the position of an existing console window
Handle The handle of the window to get the position for
Return The window position (eg CONSOLE_POSITION_FULL)


function GraphicsWindowSetPosition(Handle:TWindowHandle; Position:LongWord):LongWord;
Description: Set the position of an existing console window
Handle The handle of the window to set the position for
Position The new window position to set
Return ERROR_SUCCESS if completed or another error code on failure
Note The function will return ERROR_INVALID_PARAMETER if another window exists at the position


function GraphicsWindowGetMinX(Handle:TWindowHandle):LongWord;
Description: Get the current minimum X of the window viewport for an existing console window
Handle The handle of the window to get MinX for
Return The minimum X value for the current window viewport
Note For Graphics Console functions, X is based on screen pixels not characters


function GraphicsWindowGetMinY(Handle:TWindowHandle):LongWord;
Description: Get the current minimum Y of the window viewport for an existing console window
Handle The handle of the window to get MinY for
Return The minimum Y value for the current window viewport
Note For Graphics Console functions, Y is based on screen pixels not characters


function GraphicsWindowGetMaxX(Handle:TWindowHandle):LongWord;
Description: Get the current maximum X of the window viewport for an existing console window
Handle The handle of the window to get MaxX for
Return The maximum X value for the current window viewport
Note For Graphics Console functions, X is based on screen pixels not characters


function GraphicsWindowGetMaxY(Handle:TWindowHandle):LongWord;
Description: Get the current maximum Y of the window viewport for an existing console window
Handle The handle of the window to get MaxY for
Return The maximum Y value for the current window viewport
Note For Graphics Console functions, Y is based on screen pixels not characters


function GraphicsWindowGetRect(Handle:TWindowHandle):TConsoleRect; inline;
Description: Get the rectangle X1,Y1,X2,Y2 of the window viewport for an existing console window
Handle The handle of the window to get the rectangle for
Return The rectangle of the current window viewport
Note For Graphics Console functions, Rect is based on screen pixels not characters


function GraphicsWindowSetRect(Handle:TWindowHandle; const ARect:TConsoleRect):LongWord; inline;
Description: Set the rectangle X1,Y1,X2,Y2 of the window viewport for an existing console window
Handle The handle of the window to set the rectangle for
Rect The rectangle to set for the window viewport
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Rect is based on screen pixels not characters


function GraphicsWindowGetViewport(Handle:TWindowHandle; var X1,Y1,X2,Y2:LongWord):LongWord;
Description: Get the X1,Y1,X2,Y2 of the window viewport for an existing console window
Handle The handle of the window to get the viewport for
X1 The left edge of the current viewport
Y1 The top edge of the current viewport
X2 The right edge of the current viewport
Y2 The bottom edge of the current viewport
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowSetViewport(Handle:TWindowHandle; X1,Y1,X2,Y2:LongWord):LongWord;
Description: Set the X1,Y1,X2,Y2 of the window viewport for an existing console window
Handle The handle of the window to get the viewport for
X1 The left edge of the window viewport
Y1 The top edge of the window viewport
X2 The right edge of the window viewport
Y2 The bottom edge of the window viewport
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowGetCols(Handle:TWindowHandle):LongWord;
Description: Get the current columns of the window viewport for an existing console window
Handle The handle of the window to get columns for
Return The columns value for the current window viewport
Note For Graphics Console functions, Columns is based on screen pixels not characters


function GraphicsWindowGetRows(Handle:TWindowHandle):LongWord;
Description: Get the current rows of the window viewport for an existing console window
Handle The handle of the window to get rows for
Return The rows value for the current window viewport
Note For Graphics Console functions, Rows is based on screen pixels not characters


function GraphicsWindowGetWidth(Handle:TWindowHandle):LongWord;
Description: Get the absolute width of an existing console window
Handle The handle of the window to get the width for
Return The absolute width of the window
Note For Graphics Console functions, Width is based on screen pixels not characters


function GraphicsWindowGetHeight(Handle:TWindowHandle):LongWord;
Description: Get the absolute height of an existing console window
Handle The handle of the window to get the height for
Return The absolute height of the window
Note For Graphics Console functions, Height is based on screen pixels not characters


function GraphicsWindowGetFormat(Handle:TWindowHandle):LongWord;
Description: Get the color format of an existing console window
Handle The handle of the window to get the format for
Return The color format of the window (eg COLOR_FORMAT_ARGB32)


function GraphicsWindowGetForecolor(Handle:TWindowHandle):LongWord;
Description: Get the current foreground color of an existing console window
Handle The handle of the window to get the foreground color for
Return The foreground color of the window (eg COLOR_WHITE)


function GraphicsWindowSetForecolor(Handle:TWindowHandle; Color:LongWord):LongWord;
Description: Set the current foreground color of an existing console window
Handle The handle of the window to set the foreground color for
Color The foreground color to set (eg COLOR_WHITE)
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowGetBackcolor(Handle:TWindowHandle):LongWord;
Description: Get the current background color of an existing console window
Handle The handle of the window to get the background color for
Return The background color of the window (eg COLOR_BLACK)


function GraphicsWindowSetBackcolor(Handle:TWindowHandle; Color:LongWord):LongWord;
Description: Set the current background color of an existing console window
Handle The handle of the window to set the background color for
Color The background color to set (eg COLOR_BLACK)
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowGetFont(Handle:TWindowHandle):TFontHandle;
Description: Get the default font of an existing console window
Handle The handle of the window to get the default font for
Return The font handle of the default font or INVALID_HANDLE_VALUE on error


function GraphicsWindowSetFont(Handle:TWindowHandle; Font:TFontHandle):LongWord;
Description: Set the default font of an existing console window
Handle The handle of the window to set the default font for
Font The font handle of the default font to set
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowClear(Handle:TWindowHandle):LongWord;
Description: Clear the current viewport of an existing console window
Handle The handle of the window to clear
Return ERROR_SUCCESS if completed or another error code on failure


function GraphicsWindowClearEx(Handle:TWindowHandle; X1,Y1,X2,Y2,Color:LongWord):LongWord;
Description: Clear part of the the current viewport of an existing console window
Handle The handle of the window to clear
X1 The left edge of the area to clear (relative to current viewport)
Y1 The top edge of the area to clear (relative to current viewport)
X2 The right edge of the area to clear (relative to current viewport)
Y2 The bottom edge of the area to clear (relative to current viewport)
Color The fill color for the area to clear (eg COLOR_WHITE)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawBox(Handle:TWindowHandle; X1,Y1,X2,Y2,Color,Width:LongWord):LongWord;
Description: Draw a rectangular box outline on an existing console window
Handle The handle of the window to draw on
X1 The left edge of the box (relative to current viewport)
Y1 The top edge of the box (relative to current viewport)
X2 The right edge of the box (relative to current viewport)
Y2 The bottom edge of the box (relative to current viewport)
Color The color to draw with (eg COLOR_WHITE)
Width The width of the box outline
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawLine(Handle:TWindowHandle; X1,Y1,X2,Y2,Color,Width:LongWord):LongWord;
Description: Draw a line on an existing console window
Handle The handle of the window to draw on
X1 The left starting point of the line (relative to current viewport)
Y1 The top starting point of the box (relative to current viewport)
X2 The right ending point of the box (relative to current viewport)
Y2 The bottom ending point of the box (relative to current viewport)
Color The color to draw with (eg COLOR_WHITE)
Width The width of the line
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawBlock(Handle:TWindowHandle; X1,Y1,X2,Y2,Color:LongWord):LongWord;
Description: Draw a rectangular filled block on an existing console window
Handle The handle of the window to draw on
X1 The left edge of the block (relative to current viewport)
Y1 The top edge of the block (relative to current viewport)
X2 The right edge of the block (relative to current viewport)
Y2 The bottom edge of the block (relative to current viewport)
Color The color to draw with (eg COLOR_WHITE)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawChar(Handle:TWindowHandle; Ch:Char; X,Y:LongWord):LongWord;
Description: Draw a character on an existing console window
Handle The handle of the window to draw on
Ch The character to draw
X The left starting point of the character (relative to current viewport)
Y The top starting point of the character (relative to current viewport)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawCharEx(Handle:TWindowHandle; Font:TFontHandle; Ch:Char; X,Y,Forecolor,Backcolor:LongWord):LongWord;
Description: Draw a character on an existing console window
Handle The handle of the window to draw on
Font The handle of the font to draw the character with
Ch The character to draw
X The left starting point of the character (relative to current viewport)
Y The top starting point of the character (relative to current viewport)
Forecolor The foreground color for the character (eg COLOR_WHITE)
Backcolor The background color for the character (eg COLOR_BLACK)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawText(Handle:TWindowHandle; const Text:String; X,Y:LongWord):LongWord;
Description: Draw a text string on an existing console window
Handle The handle of the window to draw on
Text The text to draw
X The left starting point of the text (relative to current viewport)
Y The top starting point of the text (relative to current viewport)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawTextEx(Handle:TWindowHandle; Font:TFontHandle; const Text:String; X,Y,Forecolor,Backcolor:LongWord):LongWord;
Description: Draw a text string on an existing console window
Handle The handle of the window to draw on
Font The handle of the font to draw the text with
Text The text to draw
X The left starting point of the text (relative to current viewport)
Y The top starting point of the text (relative to current viewport)
Forecolor The foreground color for the text (eg COLOR_WHITE)
Backcolor The background color for the text (eg COLOR_BLACK)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawPixel(Handle:TWindowHandle; X,Y,Color:LongWord):LongWord;
Description: Draw a single pixel on an existing console window
Handle The handle of the window to draw on
X The column for the pixel (relative to current viewport)
Y The row for the pixel (relative to current viewport)
Color The color for the pixel (eg COLOR_WHITE)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowDrawImage(Handle:TWindowHandle; X,Y:LongWord; Image:Pointer; Width,Height,Format:LongWord):LongWord;
Description: Draw an image on an existing console window
Handle The handle of the window to draw on
X The left starting point of the image (relative to current viewport)
Y The top starting point of the image (relative to current viewport)
Image Pointer to the image data in a contiguous block of pixel rows
Width The width in pixels of a row in the image data
Height The height in pixels of all rows in the image data
Format The color format of the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowGetPixel(Handle:TWindowHandle; X,Y:LongWord):LongWord;
Description: Get a single pixel from an existing console window
Handle The handle of the window to get from
X The column of the pixel (relative to current viewport)
Y The row of the pixel (relative to current viewport)
Return The color of the pixel at X,Y (eg COLOR_WHITE)
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowGetImage(Handle:TWindowHandle; X,Y:LongWord; Image:Pointer; Width,Height,Format:LongWord):LongWord;
Description: Get an image from an existing console window
Handle The handle of the window to get from
X The left starting point of the image (relative to current viewport)
Y The top starting point of the image (relative to current viewport)
Image Pointer to a block of memory large enough to hold the image in a contiguous block of pixel rows
Width The width in pixels of a row of the image
Height The height in pixels of all rows of the image
Format The color format to store in the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowCopyImage(Handle:TWindowHandle; const Source,Dest:TConsolePoint; Width,Height:LongWord):LongWord; inline;
Description: Copy an image from one place to another in a existing console window
Handle The handle of the window to copy from and to
Source The starting point (X,Y) to copy the image from
Dest The starting point (X,Y) to copy the image to
Width The width in pixels of each row of the image
Height The height in pixels of all rows of the image
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowMoveImage(Handle:TWindowHandle; const Source,Dest:TConsolePoint; Width,Height,Fillcolor:LongWord):LongWord;
Description: Move an image from one place to another in a existing console window
Handle The handle of the window to copy from and to
Source The starting point (X,Y) to copy the image from
Dest The starting point (X,Y) to copy the image to
Width The width in pixels of each row of the image
Height The height in pixels of all rows of the image
Fillcolor The color to fill the area where the image was moved from (COLOR_NONE for no fill, same as copy)
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowImageSize(Handle:TWindowHandle; Width,Height,Format:LongWord):LongWord;
Description: Calculate the size in bytes of an image that is Width by Height in the color format specified
Handle The handle of the window for the image
Width The width of the image in pixels
Height The height of the image in pixels
Format The color format to use for the calculation (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
Return The size in bytes for an image of the specified size and format or 0 on error


function GraphicsWindowImageFromStream(Handle:TWindowHandle; X,Y:LongWord; Stream:TStream; Width,Height,Format:LongWord):LongWord;
Description: Draw an image to an existing console window from a supplied stream
Handle The handle of the window to draw on
X The left starting point of the image (relative to current viewport)
Y The top starting point of the image (relative to current viewport)
Stream A stream containing the image data in a contiguous block of pixel rows
Width The width in pixels of a row in the image data
Height The height in pixels of all rows in the image data
Format The color format of the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters


function GraphicsWindowImageToStream(Handle:TWindowHandle; X,Y:LongWord; Stream:TStream; Width,Height,Format:LongWord):LongWord;
Description: Get an image from an existing console window to a supplied stream
Handle The handle of the window to get from
X The left starting point of the image (relative to current viewport)
Y The top starting point of the image (relative to current viewport)
Stream A stream large enough to hold the image in a contiguous block of pixel rows
Width The width in pixels of a row of the image
Height The height in pixels of all rows of the image
Format The color format to store in the image data (eg COLOR_FORMAT_ARGB32) Pass COLOR_FORMAT_UNKNOWN to use the window format
Return ERROR_SUCCESS if completed or another error code on failure
Note For Graphics Console functions, Viewport is based on screen pixels not characters



Return to Unit Reference