Microsoft Programmer's Library 1.3

home *** CD-ROM | disk | FTP | other *** search

/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / sampcode / alde_c / turbo_c / ucturbo / manual3.doc < prev next >

Wrap

Text File | 1987-05-24 | 61.6 KB | 2,940 lines

Unicorn 1 Documentation 3.1 page 112 __________________________________________________________________________ prtbs Sends a backspace character to the printer. Call: prtbs(); Example: main() { prtbs(); /* send a back space to the printer */ } Unicorn 1 Documentation 3.1 page 113 __________________________________________________________________________ prtbuzz Sounds the printers alarm buzzer. Call: prtbuzz(); Example: main() { prtbuzz(); /* sound the printer buzzer */ } Unicorn 1 Documentation 3.1 page 114 __________________________________________________________________________ prtcan Sends a cancel character to the printer and stops the print. Call: prtcan(); Example: main() { prtcan(); /* send a cancel to the printer */ } Unicorn 1 Documentation 3.1 page 115 __________________________________________________________________________ prtcomof Turns off the printers compressed print mode. Call: prtcomof(); Example: main() { prtcomof(); /* Turn off compressed print */ Unicorn 1 Documentation 3.1 page 116 __________________________________________________________________________ prtcomon Turns on the printers compressed print mode. Call: prtcomon(); Example: main() { prtcomon(); /* turn on the compressed mode */ } Unicorn 1 Documentation 3.1 page 117 __________________________________________________________________________ prtcr Sends a carriage return character to the printer. Call: prtcr(); Example: main() { prtcr(); /* send a carriage return to the printer */ } Unicorn 1 Documentation 3.1 page 118 __________________________________________________________________________ prtduboff This function turns off the double strike character mode. Each character is struck twice by the print head. Call: prtduboff(); Example: main() { prtduboff(); /* turn off the double struck characters */ } Unicorn 1 Documentation 3.1 page 119 __________________________________________________________________________ prtdubon This function turns on the double strike character mode. Each character is struck twice by the print head. Call: prtdubon(); Example: main() { prtdubon(); /* turn on the double struck characters */ } Unicorn 1 Documentation 3.1 page 120 __________________________________________________________________________ prtempof This function turns off the emphasized print mode. Call: prtempof(); Example: main() { prtempof(); /* turn off the emphasized print mode */ } Unicorn 1 Documentation 3.1 page 121 __________________________________________________________________________ prtempon Turns on the emphasized print mode. Call: prtempon(); Example: main() { prtempon(); /* Turn on the emphasized print mode */ } Unicorn 1 Documentation 3.1 page 122 __________________________________________________________________________ prtesc Sends an escape character to the printer. Call: prtesc(); Example: main() { prtesc(); /* send an escape to the printer */ } Unicorn 1 Documentation 3.1 page 123 __________________________________________________________________________ prtff Sends a form feed character to the printer. Call: prtff(); Example: main() { prtff(); /* send a form feed to the printer */ } Unicorn 1 Documentation 3.1 page 124 __________________________________________________________________________ prtlf Sends a line feed character to the printer. Call: prtlf(); Example: main() { prtlf(); /* send a line feed to the printer */ } Unicorn 1 Documentation 3.1 page 125 __________________________________________________________________________ prttab Sends a tab character to the printer. Call: prttab(); Example: main() { prttab(); /* send a tab to the printer */ } Unicorn 1 Documentation 3.1 page 126 __________________________________________________________________________ prtwidoff This function turns of the wide or double width character mode. Call: prtwidoff(); Example: main() { prtwidoff(); /* turn off the double width characters */ } Unicorn 1 Documentation 3.1 page 127 __________________________________________________________________________ prtwidon Turns on the printer wide or double width character mode. This mode is automatically canceled at the next new line sent to the printer. Call: prtwidon(); Example: main() { prtwidon(); /* turn on the wide mode */ } E Unicorn Library Documentation 3.1 page 128 __________________________________________________________________ RAD_DEG F Converts angles expressed in radians to the equivalent angle expressed in degrees. Both the angle and the return are doubles. Call: RAD_DEG(angle); angle = angle expressed in radians Example: main() { double a, RAD_DEG(); a = RAD_DEG(3.45); } E Unicorn Library Documentation 3.1 page 129 __________________________________________________________________ raschar F Prints a single large character on the graphics screen using the internal ROM character descriptions. Call: raschar(char, ulc, ulr, hmag, vmag, color); char = character to print ulc = upper left corner column ulr = upper left corner row hmag = horizontal magnification factor vmag = vertical magnification factor color = color of the character Example: main() { sm(4); /* set graphics mode */ /* print a large 'A' in color 3 */ raschar('A', 50, 50, 4, 4, 3); } Unicorn 1 Documentation 3.1 page 130 __________________________________________________________________________ rdhcount Reads the horizontal motion counter value in clicks. Call: rdhcount(); Example: main() { rdhcount(); } Unicorn 1 Documentation 3.1 page 131 __________________________________________________________________________ rdvcount Reads the vertical motion counter value in clicks. Call: rdvcount(); Example: main() { rdvcount(); } Unicorn 1 Documentation 3.1 page 133 __________________________________________________________________________ readkey Returns a key for both ascii and scan codes. Scan code is in high byte of integer return and ascii code is in low byte. This is a destructive read. Call: readkey(); Example: main() { int a; a = readkey(); /* get a key */ } Unicorn 1 Documentation 3.1 page 134 __________________________________________________________________________ redalert Sounds a series of 4 rapid upward glissandos forming a red alert signal. Call: redalert(); Example: main() { redalert(); /* Sound the red alert */ } E Unicorn Library Documentation 3.1 page 135 __________________________________________________________________ replacech F Replaces all occurances of a character in a string with a new character. Call: replacech(str, old, new); str = string to be searched old = original character to be replaced new = the new replacement character for string Example: main() { char *a = "This is a test"; /* replace all lower case t's with upper case T's */ replacech(a, 't', 'T'); } Unicorn 1 Documentation 3.1 page 136 __________________________________________________________________________ rhjoystk Returns the right joystick's current horizontal position. Call: rhjoystk(); Example: main() { printf("The joystick is at %d", rhjoystk()); } Unicorn 1 Documentation 3.1 page 137 __________________________________________________________________________ rvjoystk Returns the right joystick's current vertical position. Call: rvjoystk(); Example: main() { printf("The joystick is at %d", rvjoystk()); } Unicorn 1 Documentation 3.1 page 138 __________________________________________________________________________ scankey This function returns 0 if no key is avialable. If the return is non 0 then the key is read non-destructively and the scan code is returned in the high byte of an integer and the ascii code is returned in the low byte. Call: scankey(); Example: main() { int a; a = scankey(); /* get values if a key is available */ } E Unicorn Library Documentation 3.1 page 139 __________________________________________________________________ setatten F Tandy 1000 only Sound primative function to allow setting the attenuation of any of the 3 sound channels. Call: setatten(voice, level); voice = 1, 2, or 3 level = 1 to 15 with 15 being the maximum attenuation or soundoff. Example: main() { /* set the sound level in voice 1 to very loud and voice 2 to off */ setatten(1, 1); setatten(2, 15); } Unicorn 1 Documentation 3.1 page 140 __________________________________________________________________________ script Writes to the screen using a large script style font. Call: script(character, row, col, color); Example: main() { script('A', 20, 30, 1); /* writes a script A on the screen, the upper left corner will be at row 20, column 30 and it will be written in color 1. */ } Unicorn 1 Documentation 3.1 page 141 __________________________________________________________________________ setcallm Set a user defined subroutine mask. The mouse software interrupts automatically stop execution of your program and call the specified routine whenever 1 or more of the conditions defined in the mask are met. On completion of the subroutine your program continues execution at the point of interruption. Call: setcallm(mask, address); Where: mask = the call mask with mask bits as follows. 0 - cursor postion changes 1 - left button pressed 2 - left button released 3 - right button pressed 4 - right button released 5 to 15 not used. address = address offset to the subroutine. Example: main() { setcallm(2, 0x40); /* calls the subroutine if left button is pressed */ } E Unicorn Library Documentation 3.1 page 142 __________________________________________________________________ setcur F Passes a graphics cursor to the mouse driver allowing the user to define the cursor shape and hot spot. Call: setcur(h_hot_spot, v_hot_spot, cursor); Where: h_hot_spot = horizontal hot spot for cursor v_hot_spot = vertical hot spot for cursor cursor = pointer the the cursor screen and shape arrays Example: main() { /* see the mouse manual for examples on cursor arrays */ } E Unicorn Library Documentation 3.1 page 143 __________________________________________________________________ setcurp F Sets the cursor position to a specified row an column. Call: setcurp(row, column); row = row to set cursor in column = column to set cursor in Example: main() { sm(4); /* set graphics mode */ /* move cursor to row 10, column 43 */ setcurp(10, 43); } E Unicorn Library Documentation 3.1 page 144 __________________________________________________________________ setcurt F Sets the cursor type. (start and stop lines.) Call: setcurt(start, stop); start = the line in character cell where cursor starts stop = the line in character cell where cursor stops Example: main() { /* set the normal 2 line high cursor */ setcurt(0,1); } E Unicorn Library Documentation 3.1 page 145 __________________________________________________________________ sethor F Allows the user to set the maximum and minimum horizontal positions for the mouse. These values are defined by the virtual screen. If the cursor is outside the defined area when called, it moves to just inside the area. If the minimum is graeter the values are swapped. Call: sethor(min, max); Where: min = the minimum position max = the maximum position Example: main() { /* see the mouse manual for examples */ } E Unicorn Library Documentation 3.1 page 146 __________________________________________________________________ setmode F Set the video mode. Uses a C interrupt call. The video mode is defined from the following table. IBM Modes 0 - 40x25 Monochrome text 1 - 40x25 Color text 2 - 80x25 Mono text 3 - 80x25 Color text 4 - 320x200 Color graphics 5 - 320x200 Mono graphics 6 - 640x200 2 color graphics 7 - 80x25 Monochrome adapter text Tandy & PCjr modes 8 - 160x200 16 color graphics 9 - 320x200 16 color graphics 10 - 640x200 4 color graphics EGA Modes 13 - 320x200 16 color graphics 14 - 640x200 16 color graphics 15 - 640x350 Mono graphics 16 - 640x350 4 or 16 color graphics Call: setmode(mode); Where: mode = the desired video mode Example: main() { setmode(4); /* set 4 color graphics mode */ } E Unicorn Library Documentation 3.1 page 147 __________________________________________________________________ setpage F Set the visual page or page being viewed as opposed to the active page being written to. Call: setpage(page); Where: page = the desired video page Example: main() { setpage(0); /* set page 0 */ } E Unicorn Library Documentation 3.1 page 148 __________________________________________________________________ setfreq F Tandy 1000 only Sound function to set a value into a sound register for a specified voice. The value to set is calculated by the formula: value = 111843 / frequency Call: setfreq(voice, frequency); voice = voice ( 0-3) frequency = frequency to set into voice register Example: main() { /* set a 1000 hz tone into voice 2 */ setfreq(2, 1000); } E Unicorn Library Documentation 3.1 page 149 __________________________________________________________________ setpal F Tandy 1000 only Allows the user to set any color into a plalette register. Call: setpal(pal_reg, color); pal_reg = the number of the palette register to change color = color to set into palette register Example: main() { sm(4); /* set graphics mode */ /* set palette register 14 to color 4 (red); setpal(14, 4); /* any reference to color 14 (yellow) will now display color 4 (red) instead. */ } E Unicorn Library Documentation 3.1 page 150 __________________________________________________________________ setpos F Allows the user to set the current mouse cursor position. Call: setpos(hor, ver); Where: hor = desired horizontal position, Must be inside the virtual screen limits ver = desired vertical position, Must be within the virtual screen limits Example: main() { setpos(30, 20); } E Unicorn Library Documentation 3.1 page 151 __________________________________________________________________ settxtc F Select either a software of a hardware text cursor. For the software cursor this function defines the character attribute of the cursor when in the text mode. If a hardware cursor is selected this function defines the first and last scan lines for the text cursor. Call: settxtc(type, first, second); Where: type = 0 for software cursor 1 for hardware cursor first = screen mask value if software cursor, number of first scan line if hardware cursor. second = cursor mask value if software cursor, number of last scam line if hardware cursor. Example: main() { setpos(0, 2, 5); } E Unicorn Library Documentation 3.1 page 152 __________________________________________________________________ setver F Allows the user to set the maximum and minimum vertical positions for the mouse. These values aredefined by the virtual screen. If the cursor is outside the defined area when called, it moves to just inside the area. If the minimum is greater the valuse are swapped. Call: setver(min, max); Where: min = the minimum position max = the maximum position Example: main() { /* see the mouse manual */ } E Unicorn Library Documentation 3.1 page 153 __________________________________________________________________ siren F This function sounds a series of up and down glissandos simulating a siren sound. Call: siren(number); number = the number of up/down glissandos to sound */ Example: main() { siren(5); /* sound 5 up/down siren sounds */ } E Unicorn Library Documentation 3.1 page 154 __________________________________________________________________ sm F Sets the video mode. For this library to work properly all graphics must be done in mode 4 for the IBM-PC version and in mode 9 for the tandy version. The mode 4 version may be used on a Tandy 1000 to create fully compatible IBM-PC programs. In addition upon exiting a tandy version (mode 9) program the mode must be reset back to mode 3. Failure to do so will probably cause the machine to crash. Call: sm(mode); mode = video mode desired according to below table Mode Table 0 - 40x25 balck and white 1 - 40x25 color 2 - 80x25 black and white 3 - 80x25 color 4 - 320x200 4 color graphics 5 - 320x200 black and white graphics 6 - 640x200 black and white graphics 7 - EDo NOT Use!F 8 - 160x200 color graphics with 16 colors 9 - 320x200 color graphics with 16 colors 10 - 640x200 color graphics with 4 colors Example: main() { sm(9); /* set graphics mode 9 for Tandy 1000 */ } E Unicorn Library Documentation 3.1 page 155 __________________________________________________________________ spratio F Sets the ratio of clicks to pixels. The horizontal and vertical ratios specify a number of clicks per 8 pixels. Must be in the range of 0 to 32767. Call: spratio(hor, ver); Where: hor = horizontal click/pixel ratio, default 8/8 ver = vertical click/pixel ratio, default 16/8 Example: main() { spratio( 2, 3); } E Unicorn Library Documentation 3.1 page 156 __________________________________________________________________ sscrcurp F Set the screen cursor to the specified row and column. The home position is 0,0. Used with window functions. Call: sscrcurp(row, col); Where: row = desired row; col = desired column; Example: main() { sscrcurp(5, 8); } E Unicorn Library Documentation 3.1 page 157 __________________________________________________________________ soundoff F Tandy 1000 only Turns off the complex sound generator chip. Call: soundoff(); Example: main() { /* Turn off the complex sound generator chip */ soundoff(); } E Unicorn Library Documentation 3.1 page 158 __________________________________________________________________ soundon F Tandy 1000 only Turns on the complex sound generator chip. Must be called prior to any call to other sound functions. Call: soundon(); Example: main() { /* turn on the sound chip */ soundon(); } E Unicorn Library Documentation 3.1 page 159 __________________________________________________________________ spalreg F Tandy 1000 only Changes the defined color of any palette register from 0 to 15. Call: spalreg(reg_num, color); reg_num = register to change color = new color fro the register Example: main() { sm(4); /* set graphics mode */ /* set palette register 14 to color 4 (red); spalreg(14, 4); /* any reference to color 14 (yellow) will now display color 4 (red) instead. */ } E Unicorn Library Documentation 3.1 page 160 __________________________________________________________________ sstring F Print a stroke character string on the graphics screen. Call: sstring(string, ulc, ulr, hmag, vmag, colorb, colorf); string = string to be printed ulc = upper left corner column ulr = upper left corner row hmag = horizontal magnification vmag = vertical magnification colorb = border outline color colorf = color to use in filling characters Example: main() { sm(4); /* set graphics mode */ /* print the string "test" using stroke characters with a red outline and filled with yellow */ sstring("test", 10, 20, 2, 2, 4, 14); E Unicorn Library Documentation 3.1 page 161 __________________________________________________________________ stchar F Prints a single stroke character on the graphics screen Call: stchar(char, ulc, ulr, hmag, vmag, colorb, colorf); char = character to be printed ulc = upper left corner column ulr = upper left corner row hmag = horizontal magnification vmag = vertical magnification colorb = border outline color colorf = color to use in filling characters Example: main() { sm(4); /* set graphics mode */ /* print the character 't' using stroke characters with a red outline and filled with yellow */ stchar('t', 10, 20, 2, 2, 4, 14); E Unicorn Library Documentation 3.1 page 162 __________________________________________________________________ strclr F Prints a string on the screen in one of 16 colors. Call: strclr(color, string); color = color to use in printing string string = string to print Example: main() { /* print the string "test" in red */ strclr(4, "test"); } E Unicorn Library Documentation 3.1 page 163 __________________________________________________________________ strdel F Deletes a substring from a given string starting at the character numbered 'first' and continuing for 'number' of characters. Call: strdel(str, first, number); str = string to be operated upon first = character to start the delete operation number = number of characters to delete Example: main() { /* delete the word is */ strdel("This is a test", 5,2); } E Unicorn Library Documentation 3.1 page 164 __________________________________________________________________ strpad F Pad a string with blanks on the left. Call: strpad(str, number); str = string to be padded number = number of spaces to be added to the left Example: main(); { /* add 5 spaces to left of "This is a test" */ strpad("This is a test", 5); } E Unicorn Library Documentation 3.1 page 165 __________________________________________________________________ strtolow F Converts all characters in a string to lower case. Call: strtolow(str); str = string to be changed to all lower case. Example: main() { char *a = "Testing"; strtolow(a); } E Unicorn Library Documentation 3.1 page 166 __________________________________________________________________ strtoup F Converts all characters in a string to upper case. Call: strtoup(str); str = string to be changed to all upper case. Example: main() { char *a = "Testing"; strtoup(a); } E Unicorn Library Documentation 3.1 page 167 __________________________________________________________________ turnleft F Turns the turtle's current heading left by a specified number of degrees. Call: turnleft(angle); angle = angle to turn through Example: main() { sm(4); /* set graphics mode */ /* turn the turtle's heading left 50 degrees */ turnleft(50); } E Unicorn Library Documentation 3.1 page 168 __________________________________________________________________ turnright F Turns the turtle's current heading right by a specified number of degrees. Call: turnright(angle); angle = angle to turn through Example: main() { sm(4); /* set graphics mode */ /* turn the turtle's heading right 50 degrees */ turnright(50); } E Unicorn Library Documentation 3.1 page 169 __________________________________________________________________ usrfont F Select and print characters in various fonts on the graphics screen. Call: usrfont(char, ulc, ulr, hmag, vmag, color, font); char = character to be printed ulc = upper left corner column ulr = upper left corner row hmag = horizontal magnification vmag = vertical magnification color = color to use in printing character font = an integer used to select which font. Font Table: 0 - Thin block all capital letters 1 - small characters for sub/superscripts. Generally defined in upper 4 columns and 4 rows of character cell. 2 - NOT YET DEFINED 3 - NOT YET DEFINED 4 - NOT YET DEFINED Example: main() { sm(4); /* set graphics mode */ /* print an 'A' from the sub/superscript font at twice normal size in color 3 */ usrfont('A', 10, 20, 2, 2, 3, 1); } Unicorn 1 Documentation 3.1 page 170 ____________________________________________________________________ wsm Sets the video mode. For this library to work properly all graphics must be done in mode 4 for the IBM-PC version and in mode 9 for the tandy version. The mode 4 version may be used on a Tandy 1000 to create fully compatible IBM-PC programs. In addition upon exiting a tandy version (mode 9) program the mode must be reset back to mode 3. Failure to do so will probably cause the machine to crash. Call: sm(mode); mode = video mode desired according to below table Mode Table 0 - 40x25 balck and white 1 - 40x25 color 2 - 80x25 black and white 3 - 80x25 color 4 - 320x200 4 color graphics 5 - 320x200 black and white graphics 6 - 640x200 black and white graphics 7 - EDo NOT Use!F 8 - 160x200 color graphics with 16 colors 9 - 320x200 color graphics with 16 colors 10 - 640x200 color graphics with 4 colors Example: main() { sm(9); /* set graphics mode 9 for Tandy 1000 */ } E Unicorn Library Documentation 3.1 page 171 __________________________________________________________________ wac F Prints a character on the screen using an attribute byte. Call: wac(attribute, char); attribute = attribute to use in printing character char = character to be printed attribute byte is formed according to below bit definitions foreground; bit 0 = blue bit 1 = green bit 2 = red bit 3 = intensity background; bit 4 = blue bit 5 = green bit 6 = red bit 7 = blink Example: main() { /* print the character 't' with a blue background using bright red character color. */ wac(28, 't'); } E Unicorn Library Documentation 3.1 page 172 __________________________________________________________________ waitkey F Pauses the computer until a key is pressed. It does NOT return the key scan code or ascii value. Call: waitkey(); Example: main() { /* wait until a key is pressed */ waitkey(); } E Unicorn Library Documentation 3.1 page 173 __________________________________________________________________ wbackclr F Sets the background color / pallet / border color. Used with windows. Call: wbackclr(color, tag); Where: color = color desired tag = 0 for background color 1 - palette for graphics modes 1 - border color for text modes Example: main() { wbackclr(1, 0); /* set the background to blue */ } E Unicorn Library Documentation 3.1 page 174 __________________________________________________________________ wbdot F Window BIOS call to set a dot on the graphics screen. Call: wbdot(color, row, col); Where: color = color desired row = row for desired dot col = col for desired dot Example: main() { wbdot(3, 30, 50); } E Unicorn Library Documentation 3.1 page 175 __________________________________________________________________ wco F Prints a character only on the screen. In the graphics modes a color may be specified. Call: wco(char, color); char = character to print color = color to use, ignored in text modes Example: main() { /* prints the character 'W' */ wco('W', 4); waitkey(); /* wait until a key is pressed */ sm(4); /* set the graphics mode */ /* print a 'W' in red on the graphics screen */ wco('W', 4); } E Unicorn Library Documentation 3.1 page 176 __________________________________________________________________ wgbdot F Window BIOS call to get the dot color on the graphics screen. Call: wgbdot(dummy, row, col); Where: dummy = unused parameter row = row for desired dot col = col for desired dot Example: main() { int a; a = wgbdot(3, 30, 50); } E Unicorn Library Documentation 3.1 page 177 __________________________________________________________________ wgetca F Window call to read a character and attribute from the screen Call: wgetca(page); Where: page = the desired page to be read Example: main() { int a; a = wgetca(0); } E Unicorn Library Documentation 3.1 page 178 __________________________________________________________________ wgetcurp F Window call to get the current cursor postion. Returns (256*row + column). Call: wgetcurp(page); Where: page = the desired page to be read Example: main() { int a; a = wgetcurp(0); } E Unicorn Library Documentation 3.1 page 179 __________________________________________________________________ wgetpen F Returns the lightpen status. Used as a part of windowing functions. Call: wgetpen(buffer); Where: buffer = a 4 bit integer. Row and column positions are stored in buffer. Return: 0 if pen not triggered or 1 if it was. Example: main() { int a; int buffer[4]; a = wgetpen(buffer); } E Unicorn Library Documentation 3.1 page 180 __________________________________________________________________ wnaddrow F Inserts a row of blanks by scrolling the lower portion of a window DOWN. The current cursor row is inserted. Call: wnaddrow(); Example: main() { wnaddrow(); } E Unicorn Library Documentation 3.1 page 181 __________________________________________________________________ wnbndry F Checks to see if the cursor is within the defined area of a window. Returns a code indicating the cursor position status. Call: wnbndry(wn); Example: main() { wnbndry(wn); } E Unicorn Library Documentation 3.1 page 182 __________________________________________________________________ wnceol F Clear the window to the end of the current line. Call: wnceol(wn); Example: main() { wnceol(); } E Unicorn Library Documentation 3.1 page 183 __________________________________________________________________ wnclose F Erase the window at the current window control block. If overlapping windows are used then this must be the top window. Call: wnclose(wn); Example: main() { wnclose(wn); } E Unicorn Library Documentation 3.1 page 184 __________________________________________________________________ wncls F Clear the current window and home the cursor for the window. ` Call: wncls(wn); Example: main() { wncls(wn); } E Unicorn Library Documentation 3.1 page 185 __________________________________________________________________ wncur F Provides cursor movement controls for the windows. Primarily for internal use but may be user accessed to provide for the building of additional window functions. Call: wncur(wn, c); Where: wn = the current window pointer c = the cursor control keystroke Example: main() { wncur(wn, c); } E Unicorn Library Documentation 3.1 page 186 __________________________________________________________________ wndelch F Deletes the character at the current window cursor position. Call: wndelch(wn); Example: main() { wndelch(wn); } E Unicorn Library Documentation 3.1 page 187 __________________________________________________________________ wndelrow F Deletes a row by scrolling the lower portion of a window UP and inserting a row of blanks at the bottom of the window. Call: wndelrow(wn); Example: main() { wndelrow(wn); } E Unicorn Library Documentation 3.1 page 188 __________________________________________________________________ wngcurp F Returns the relative window cursor position. Row = wngcurp() & 0xFF and Col = wngcurp >> 8. The home position for a window cursor is 1, 1. Call: wngcurp(wn); Example: main() { wngcurp(wn); } E Unicorn Library Documentation 3.1 page 189 __________________________________________________________________ wngetca F Returns the character and attribute at row, column. Call: wngetca(row, col); Example: main() { int a.; a = wngetca(5, 10); } E Unicorn Library Documentation 3.1 page 190 __________________________________________________________________ wngetch F Returns the character at the window cursor location or a boundry code if the cursor is outside the window. Call: wngetch(wn); Example: main() { int a.; a = wngetch(5, 10); } E Unicorn Library Documentation 3.1 page 191 __________________________________________________________________ wngets F Get the string at the current window cursor location. The number of characters to place in the string may be specified. Reaching this number or the end of the window terminates the function. The number of characters placed in the string is returned. Call: wngets(wn, string, count); Where: wn = a pointer to the window string = the string to stuff with window characters count = max length to be returned Example: main() { int a.; char b[11]; a = wngets(wn, b, 10); } E Unicorn Library Documentation 3.1 page 192 __________________________________________________________________ wngetstr F This is very similar to the previous function except that it stuffs a user typed string rather than one pre-existing in the window Call: wngetstr(wn, string, count); Where: wn = a pointer to the window string = the string to stuff with window characters count = max length to be returned Example: main() { int a.; char b[11]; a = wngetstr(wn, b, 10); } E Unicorn Library Documentation 3.1 page 193 __________________________________________________________________ wninsch F Inserts a character at the current widow cursor position. Call: wninsch(wn, ch); Where: wn = a pointer to the window ch = the character to be inserted Example: main() { int a.; char b; b = 'a'; a = wngetstr(wn, b); } Unicorn 1 Documentation 3.1 page 194 __________________________________________________________________________ wnoise Sounds a white noise signal that is between two user selected frequencies. Call: wnoise(low, high, duration); low = lowest frequency to use high = highest frequency to use duration = time factor, larger number is longer time Example: main() { wnoise(100, 1000, 100); /* white noise between 100 & 1000 */ } Unicorn 1 Documentation 3.1 page 195 __________________________________________________________________________ wnopen Open a window and store the underlying screen data. The border is in a separate structure. Call: wnopen(wbd, row, col, width, height, attribute); Where: wbd = a border pointer row = upper left row for corner col = upper left col for corner width = width of window height = height of window attribute = attribute for window Example: main() { WINDOW *wnopen(wbd, row, col, width, height, attribute); } Unicorn 1 Documentation 3.1 page 196 ____________________________________________________________________ wnpchar Print a character as is at the current cursor window location. Uses cx and cy in the widow control structure block. Call: wnpchar(wn, ch); Where: wn = window pointer ch = character to print Example: main() { wnpchar(wn, ch); } Unicorn 1 Documentation 3.1 page 197 ____________________________________________________________________ wnprinta Very similar to wnprintf except that this function allows the user to specify a row an column position for the print. Call: wnprinta(row, col, wn, format_string, parameter_list); Where: row = row to start at col = col to start at wn = window pointer format_string = similar to printf parameter list = maximum of 14 Example: main() { wnprinta(row, col, wn, format_string, parameter_list); } Unicorn 1 Documentation 3.1 page 198 ____________________________________________________________________ wnprintf Similar to printf but works inside a window. Call: wnprintf(wn, format_string, parameter_list); Where: wn = window pointer format_string = similar to printf parameter list = maximum of 14 Example: main() { wnprintf(wn, format_string, parameter_list); } Unicorn 1 Documentation 3.1 page 199 ____________________________________________________________________ wnputch Print a character inside a window using the cursor position stored in the window structure. Processes CR, LF, BS, TAB and DEL keys. Call: wnputch(wn, ch); Where: wn = window pointer ch = character to print Example: main() { wnputch(wn, 'a'); } Unicorn 1 Documentation 3.1 page 200 ____________________________________________________________________ wnputs Print a string inside a window using the cursor position stored in the window structure. Processes CR, LF, BS, TAB and DEL keys. Call: wnputs(wn, string); Where: wn = window pointer string = string to print Example: main() { wnputs(wn, "Testing"); } Unicorn 1 Documentation 3.1 page 201 ____________________________________________________________________ wnscroll Scrolls the window up one line. Call: wnscroll(wn); Where: wn = window pointer Example: main() { wnscroll(wn); } Unicorn 1 Documentation 3.1 page 202 ____________________________________________________________________ wnscurp Sets the relative window cursor to the specified row and column. If either is zero the cursor is moved in the given axis the number of spaces specified. Positive is right or down. Home position is 1, 1. Call: wnscurp(wn, row, col); Where: wn = window pointer row = new cursor row col = new cursor column Example: main() { wnscurp(wn, 3, 7); } Unicorn 1 Documentation 3.1 page 203 ____________________________________________________________________ wnstrptr Prints a string inside a window using the stored cursor position in the window structure control block. Call: wnstrptr(wn, string); Where: wn = window pointer string = string to be printed Example: main() { wnstrptr(wn, string); } Unicorn 1 Documentation 3.1 page 204 ____________________________________________________________________ wnwac Write a character and attribute to a specific row and column on the screen. The attribute must be located in the high byte of the character. Call: wnwac(row, col, ch); Where: row = desired row col = desired column ch = character to print Example: main() { wnwac(rowm col, ch); } Unicorn 1 Documentation 3.1 page 205 ____________________________________________________________________ wscrldn Scroll a window down. Call: wscrldn(wn, count, attribute); Where: wn = pointer to window count = number of rows to scroll attribute = attribute to place on new rows Example: main() { wscrldn(wn, count, attribute); } Unicorn 1 Documentation 3.1 page 206 ____________________________________________________________________ wscrlup Scroll a window up. Call: wscrlup(wn, count, attribute); Where: wn = pointer to window count = number of rows to scroll attribute = attribute to place on new rows Example: main() { wscrlup(wn, count, attribute); } Unicorn 1 Documentation 3.1 page 207 ____________________________________________________________________ wsetcurp Set the cursor position to a specified row, col. Call: wsetcurp(row, col, page); Where: row = desired row col = desired col page = desired page Example: main() { wsetcurp(4, 7); } Unicorn 1 Documentation 3.1 page 208 ____________________________________________________________________ wsetcurt Set the cursor type by defining a start and end row for the cursor. Call: wsetcurt(start, end); Where: start = starting line for cursor. end = ending line for cursor. Example: main() { wsetcurt(4, 7); } Unicorn 1 Documentation 3.1 page 209 ____________________________________________________________________ wsetpage Set the page. Call: wsetpage(page); Where: page = desired video page Example: main() { wsetpage(0); } E Unicorn Library Documentation 3.1 page 210 __________________________________________________________________ wtty F Prints a character and attribute on the screen. It advances the cursor and responds to control characters. Call: wtty(attribute, character); attribute = attribute to use in printing character char = character to be printed attribute byte is formed according to below bit definitions foreground; bit 0 = blue bit 1 = green bit 2 = red bit 3 = intensity background; bit 4 = blue bit 5 = green bit 6 = red bit 7 = blink Example: main() { /* print the character 't' with a blue background using bright red character color. */ wtty(28, 't'); } Unicorn 1 Documentation 3.1 page 211 ____________________________________________________________________ wwac Write the character and attribute at the current window cursor location. Call: wwac(ch, page, count); Where: ch = character to write page = video page count = number of times to write the character Example: main() { wwac(ch, page, count); } Unicorn 1 Documentation 3.1 page 212 ____________________________________________________________________ wwco Write the character only at the current window cursor location. Call: wwco(ch, page, count); Where: ch = character to write page = video page count = number of times to write the character Example: main() { wwac(ch, page, count); }