https://github.com/lionyxml/nocurses

nocurses.h - A terminal screen manipulation library (colors, position, clears, attributes,...)
https://github.com/lionyxml/nocurses

Last synced: about 2 months ago
JSON representation

nocurses.h - A terminal screen manipulation library (colors, position, clears, attributes,...)

• Host: GitHub
• URL: https://github.com/lionyxml/nocurses
• Owner: LionyxML
• License: gpl-2.0
• Created: 2019-10-18T00:39:34.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-03-13T02:07:57.000Z (almost 3 years ago)
• Last Synced: 2024-10-13T10:39:20.983Z (2 months ago)
• Language: C
• Size: 7.42 MB
• Stars: 49
• Watchers: 6
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# nocurses.h

This library provides terminal manipulation capability by the use of VT100 ESC sequences. 

It is aimed to simple applications where ncurses is simple "too much".

Inspired by the old Borland conio.h for DOS.

Here's a demo (demo.c file avaiable in the same repo):

![nocurses.h](img/nocurses.gif)

## Functions Provided

| Function                 |                                       Description                                      |        Example           |

|--------------------------|:--------------------------------------------------------------------------------------:|:------------------------:|

| wait()                   |                           Waits for the user to hit [ENTER].                           | wait();                  |

| clrscr()                 |                                   Clears the screen.                                   | clrscr();                |

| gotoxy(x, y)             | Sets the cursor do the position x, y. Where x is the row number and y the line number. | gotoxy(10,25);           |

| setfontcolor(color_name) | Sets the text color to one of the colors described on the color table below.           | setfontcolor(RED);       |

| setbgrcolor(color_name)  | Sets the background color to one of the colors described on the color table below.     | setbgrcolor(BLUE);       |

| setfontbold(status)      | Sets the bold attribute on or off. status can be TRUE or FALSE.                        | setfontbold(TRUE);       |

| setunderline(status)     | Sets the underline attribute on or off. status can be TRUE or FALSE.                   | setunderline(FALSE);     |

| setblink(status)         | Sets the blink attribute on or off. status can be TRUE or FALSE.                       | setblink(TRUE);          |

| settitle(title)          | Sets the title of the terminal.                                                        | settitle("Hello World"); |

| setcurshape(shape_name)  | Sets the shape of the cursor in the terminal in the shape table below.                 | setcurshape(BAR);        |

| gettermsize()            | Gets the columns and rows of the terminal.                                             | gettermsize();           |

| getch()                  | Gets a character without waiting for enter.                                            | getch();                 |

| getche()                 | Gets a character and echoes it without waiting for enter.                              | getche();                |

| clrline()                | Clears the row contents.                                                               | clrline();               |

| resetcolors()            | Reset terminal to default colors.                                                      | clrline();               |

## color_name

Valid color names are:

| color_name |

|:----------:|

| BLACK      |

| RED        |

| GREEN      |

| YELLOW     |

| BLUE       |

| MAGENTA    |

| CYAN       |

| WHITE      |

## shape_name

Valid shape names are:

| shape_name      |

|:---------------:|

| BLOCK_BLINK     |

| BLOCK           |

| UNDERLINE_BLINK |

| UNDERLINE       |

| BAR_BLINK       |

| BAR             |