GUILE NCURSES 2.2

Short Table of Contents

1 Introduction
2 Components of a Curses Interface
3 Types and encodings
4 Curses Tutorial
5 Curses Reference
Index

Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]

GUILE NCURSES

This manual is for the GNU Guile-NCurses library, (version 2.2, 8 April 2017). It provides bindings for the ncurses library, which provides functionality for updating character screens.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, distribute with modifications, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name(s) of the above copyright holders shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization.


• Introduction:
• Components of a Curses Interface:
• Types and encodings:
• Curses Tutorial:
• Curses Reference:
• Index:
— The Detailed Node Listing — Introduction
• Authors:
Components of a Curses Interface
• Terminal Capabilities:
• Keyboards and Keys:
• Characters:
• Windows:
Types and encodings
• Character types:
• Opaque types:
Curses Tutorial
• Hello World!!!:
• Interactive sessions and `guile-ncurses-shell`:
• The Gory Details:
• Initialization:
• A word about windows:
• Output functions:
• Input functions:
• Attributes:
• Windows Tutorial:
• Colors:
• Interfacing with the keyboard:
• Interfacing with the mouse:
• Panels Library:
• Menu Library:
• Forms Library:
Hello World!!!
• Using the Guile Curses module:
Initialization
• Initialization Functions:
• An example:
Output functions
• The `addch` procedure:
• `addstr` class of functions:
• A simple `addstr` example:
• A word of caution:
`addstr` class of functions
• A simple `addstr` example:
• A word of caution:
Input functions
• `getch` class of functions:
• `getnstr` class of functions:
• An example of `getnstr` and `getch`:
Attributes
• The details:
• `attr-on!` vs `attr-set!`:
• `attr-get`:
• `chgat` function:
Windows Tutorial
• The basics:
• Let there be a window:
• Other functions:
• Other border functions:
Colors
• The basics of color:
• Changing color definitions:
Interfacing with the keyboard
• The basics of keys:
• A simple key usage example:
Interfacing with the mouse
• The basics of the mouse:
• Getting the events:
• Miscellaneous functions:
Panels Library
• Panels Basics:
• Compiling With the Panels Library:
• Moving and Resizing Panels:
Menu Library
• Menu Basics:
• Menu Driver:
• Menu Windows:
• Scrolling Menus:
Forms Library
• The Basics (Forms):
• A Form Example:
• Making it useful:
• Playing with fields:
• Field Display Attributes:
• Field Option Bits:
• Field Status:
• Variable-Sized Fields:
• Form Windows:
• Field Validation:
• The Form Driver:
Curses Reference
• The naming of routines:
• The basic curses library:
• Function key labels library:
• The curses panel library:
• The curses menu library:
• The curses form library:
• The termios and miscellaneous library:
The basic curses library: `(ncurses curses)`
• Overview:
• Features determined at compile time:
• Curses screen initialization and manipulation routines:
• Errors and Exceptions:
• Making rendered characters:
• Adding characters:
• Adding strings of characters and attributes:
• Character and window attribute control routines:
• Bell and screen flash routines:
• Window background manipulation routines:
• Borders and lines:
• Clearing windows and parts of window:
• Color manipulation routines:
• Deleting the character under the cursor:
• Deleting and inserting lines:
• Getting characters from the keyboard:
• Handling unmapped keys:
• Receiving strings from the keyboard:
• Cursor location and window coordinates:
• Getting a rendered character from the window:
• Getting a string of characters and attributes from a window:
• Input options:
• Inserting a character before the cursor:
• Inserting a string before the cursor:
• Getting a string of characters from the screen:
• Low-level routines:
• Mouse handling:
• Moving the cursor :
• Output options:
• Overlay and manipulate overlapped windows:
• Create and display pads:
• Print data to a terminal-attached ports:
• Refresh windows and lines:
• Reading and writing a curses screen to a file:
• Scroll a window:
• Terminal attributes:
• Refresh routines:
• Miscellaneous utilities:
• Window creation:
• Terminal resizing:
• Querying the terminfo database:
The Coordinate System The curses menu library: `(ncurses menu)`
• Menus Overview:
• Menu Item Procedures:
• Menu Procedures:
• Menu creation :
• Menu options:
Menu Procedures
• Menu Colors and Attributes:
• Positioning a menu cursor:
• The menu driver:
• Menu sizes:
• Menu mark strings:
Menu options
• Menu pattern buffer:
• Writing or erasing menus from window:
• Control spacing between menu items:
• Associate menus with window:
The curses form library: `(ncurses form)`
• Forms Overview:
• Form procedures:
• Making or breaking connections between forms and fields:
• Color and attribute control for form fields:
• Data type validation for fields:
• Creating forms:
• Form pagination functions:
• Setting and getting form options:
• Setting the page number and field:
• Writing or erasing forms from associated subwindows:
• Printable form request names:
• Form windows:
The termios and miscellaneous library: `(ncurses extra)`
• Termios introduction:
• Standard termios functions:
• Termios port interface:
• Pseudoterminal helper procedures:

Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]