X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fnew_pair.3x;h=ae20dd4450c9a018762e5837edc4c4946bffa8f3;hb=6641601a9dd7f34deeaa978899b3730b27635afb;hp=3d2eb09542423550bd5cc8ff7a7bcf9da05fdfc5;hpb=17c5992a16be94247b83f2bbb9accdd9b7e7bb72;p=ncurses.git diff --git a/man/new_pair.3x b/man/new_pair.3x index 3d2eb095..ae20dd44 100644 --- a/man/new_pair.3x +++ b/man/new_pair.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 2017,2018 Free Software Foundation, Inc. * +.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -28,7 +29,7 @@ .\" .\" Author: Thomas E. Dickey .\" -.\" $Id: new_pair.3x,v 1.13 2018/07/28 22:19:56 tom Exp $ +.\" $Id: new_pair.3x,v 1.19 2022/02/12 20:03:40 tom Exp $ .TH new_pair 3X "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -59,11 +60,11 @@ .SH SYNOPSIS \fB#include \fP .sp -\fBint alloc_pair(int fg, int bg);\fP +\fBint alloc_pair(int \fIfg\fB, int \fIbg\fB);\fR .br -\fBint find_pair(int fg, int bg);\fP +\fBint find_pair(int \fIfg\fB, int \fIbg\fB);\fR .br -\fBint free_pair(int pair);\fP +\fBint free_pair(int \fIpair\fB);\fR .SH DESCRIPTION These functions are an extension to the curses library. They permit an application to dynamically allocate a color pair using @@ -81,7 +82,7 @@ That is, the foreground and background colors are applied as a pair. .bP Color pairs are the curses library's way of managing a color palette on a terminal. -If the library does not keep track of the \fIcombinations\fP of +If the library does not keep track of the \fIcombinations\fP of colors which are displayed, it will be inefficient. .bP For simple terminal emulators @@ -89,21 +90,21 @@ with only a few dozen color combinations, it is convenient to use the maximum number of combinations as the limit on color pairs: .NS -\fBCOLORS\fP\fI * \fP\fBCOLORS\fP +\fBCOLORS\fI * \fBCOLORS\fR .NE .bP Terminals which support \fIdefault colors\fP distinct -from \*(``ANSI colors\*('' +from \*(``ANSI colors\*('' add to the possible combinations, producing this total: .NS -\fI( \fP\fBCOLORS\fP\fI + 1 ) * ( \fP\fBCOLORS\fP\fI + 1 )\fP +\fI( \fBCOLORS\fI + 1 ) * ( \fBCOLORS\fI + 1 )\fR .NE .bP An application might use up to a few dozen color pairs to implement a predefined color scheme. .IP Beyond that lies in the realm of programs using the foreground -and background colors for \*(``ASCII art\*('' +and background colors for \*(``ASCII art\*('' (or some other non-textual application). .IP Also beyond those few dozen pairs, the required size for a table @@ -126,7 +127,7 @@ If the table fills up, \fBalloc_pair\fP discards the least-recently allocated entry using \fBfree_pair\fP and allocates a new color pair. .PP All of the color pairs are allocated from a table of possible color pairs. -The size of the table is determined by the terminfo \fIpairs\fP capability. +The size of the table is determined by the terminfo \fBpairs\fP capability. The table is shared with \fBinit_pair\fP; in fact \fBalloc_pair\fP calls \fBinit_pair\fP after updating the ncurses library's fast index to the colors versus color pairs. @@ -160,6 +161,6 @@ Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION. .SH SEE ALSO -\fBcurs_color\fR(3X). +\fBcurs_color\fP(3X). .SH AUTHOR Thomas Dickey.