Purpose: | Display text vertically in the specified color |
Format: | VSCRPUT row col [/C /U] [BRIght] fg ON [BRIght] bg text |
row | Starting row |
col | Starting column |
fg | Foreground text color |
bg | Background text color |
text | The text to display |
See also: SCRPUT.
Usage:
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.
Example:
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
Options: