Purpose:Display text vertically in the specified color


Format:VSCRPUT row col [/C /U] [BRIght] fg ON [BRIght] bg text


rowStarting row
colStarting column
fgForeground text color
bgBackground text color
textThe text to display


/C (move cursor)

/U (move to end of string)


See also: SCRPUT.




VSCRPUT writes text vertically on the screen rather than horizontally. It can be used for simple graphs and charts generated by batch files.

Like the SCRPUT command, it uses the colors you specify to write the text. See Colors and Color Names for details about colors and color names, and notes on the use of bright background colors.


The row and column values are zero-based, so on a 25 line by 80 column window valid rows are 0 - 24 and valid columns are 0 - 79. VSCRPUT checks for a valid row and column, and displays a "Usage" error message if either value is out of range.


The maximum row value is determined by the current height of the TCC window. The maximum column value is determined by the current virtual screen width (see Resizing the Take Command Window for more information).


You can also specify the row and column as offsets from the current cursor position. Begin the value with a plus sign [+] to move down the specified number of rows or to the right the specified number of columns before displaying text, or with a minus sign [-] to move up or to the left.


If you specify 999 for the row, VSCRPUT will center the text vertically. If you specify 999 for the column, VSCRPUT will center the text horizontally.


VSCRPUT does not move the cursor when it displays the text.




The following batch file fragment displays an X and Y axis and labels them:


cls bright white on blue

drawhline 20 10 40 1 bright white on blue

drawvline 2 10 19 1 bright white on blue

scrput 21 20 bright red on blue X axis

vscrput 8 9 bright red on blue Y axis




/CMove the cursor to the specified position after writing the string.


/UMove the cursor to the end of the string.