GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
notcurses_pile(3) notcurses_pile(3)

notcurses_pile - operations on Notcurses piles

struct ncplane* notcurses_top(struct notcurses* n);

struct ncplane* notcurses_bottom(struct notcurses* n);

struct ncplane* ncpile_top(struct ncplane* n);

struct ncplane* ncpile_bottom(struct ncplane* n);

Notcurses does not export the ncpile type, nor any functionality that uses it directly. Piles are nonetheless an important concept in Notcurses. Functions which operate on piles (e.g. ncpile_render(3) are invoked with any ncplane within that pile.

Piles are collections of ncplanes, independent from one another for purposes of rendering and also thread-safety. While only one pile can be rasterized (written to the display) at a time, arbitrary concurrent actions can be safely performed on distinct piles. Piles do not compose: rasterizing a pile destroys any overlapping material.

A pile is created in one of three ways:

ncpile_create(3) is called,
ncvisual_blit(3) is called with a NULL target plane n, or
ncplane_reparent(3) is called with n equal to newparent, and n is not already a root plane.

A pile is destroyed whenever its last ncplane is destroyed, or reparented into some other pile.

The planes of a pile are totally ordered along the z-axis. ncpile_top and ncpile_bottom return the topmost and bottommost planes, respectively, of the pile containing their argument. notcurses_top and notcurses_bottom do the same for the standard pile.

notcurses(3), notcurses_plane(3), notcurses_render(3), notcurses_visual(3)

nick black <nickblack@linux.com>.
v3.0.7

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.