blackbeard420/notcurses
1
0
Fork 0
mirror of https://github.com/dankamongmen/notcurses synced 2025-03-09 17:19:03 -04:00
Code Issues Projects Releases Wiki Activity

[planes] add NCPLANE_OPTION_VERALIGNED #1465

Browse Source
This commit is contained in:
nick black 2021-03-26 03:47:19 -04:00 committed by Nick Black
parent 3d586844fb
commit 6105913d06
5 changed files with 17 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
NEWS.md
View File

@ -7,7 +7,9 @@ rearrangements of Notcurses.
* Added `notcurses_debug_caps()` to dump terminal properties, both those * Added `notcurses_debug_caps()` to dump terminal properties, both those
reported and those inferred, to a `FILE*`. reported and those inferred, to a `FILE*`.
* Added `NCOPTION_NO_CLEAR_BITMAPS` option for `notcurses_init()`. * Added `NCOPTION_NO_CLEAR_BITMAPS` option for `notcurses_init()`.
* Added `NCVISUAL_OPTION_HORALIGNED` flag for `ncvisual_render()`. * Added `NCVISUAL_OPTION_HORALIGNED` and `NCVISUAL_OPTION_VERALIGNED` flags
for `ncvisual_render()`.
* Added `NCPLANE_OPTION_VERALIGNED` flag for `ncplane_create()`.
* Added the `nctabbed` widget for multiplexing planes data with navigational * Added the `nctabbed` widget for multiplexing planes data with navigational
tabs. Courtesy Łukasz Drukała, in his first contribution. tabs. Courtesy Łukasz Drukała, in his first contribution.
* Removed **notcurses_canpixel()**, which was obsoleted by * Removed **notcurses_canpixel()**, which was obsoleted by

3
USAGE.md
View File

@ -716,7 +716,10 @@ When an `ncplane` is no longer needed, free it with
`ncplane_destroy()`. To quickly reset the `ncplane`, use `ncplane_erase()`. `ncplane_destroy()`. To quickly reset the `ncplane`, use `ncplane_erase()`.
```c ```c
// Horizontal alignment relative to the parent plane. Use ncalign_e for 'x'.
#define NCPLANE_OPTION_HORALIGNED 0x0001ull #define NCPLANE_OPTION_HORALIGNED 0x0001ull
// Vertical alignment relative to the parent plane. Use ncalign_e for 'y'.
#define NCPLANE_OPTION_VERALIGNED 0x0002ull
typedef struct ncplane_options { typedef struct ncplane_options {
int y; // vertical placement relative to parent plane int y; // vertical placement relative to parent plane

7
doc/man/man3/notcurses_plane.3.md
View File

@ -12,6 +12,7 @@ notcurses_plane - operations on ncplanes
```c ```c
#define NCPLANE_OPTION_HORALIGNED 0x0001ull #define NCPLANE_OPTION_HORALIGNED 0x0001ull
#define NCPLANE_OPTION_VERALIGNED 0x0002ull
typedef struct ncplane_options { typedef struct ncplane_options {
int y; // vertical placement relative to parent plane int y; // vertical placement relative to parent plane
@ -217,6 +218,12 @@ and if this latter plane moves, all its bound planes move along with it. When a
plane is destroyed, all planes bound to it (directly or transitively) are plane is destroyed, all planes bound to it (directly or transitively) are
destroyed. destroyed.
If the **NCPLANE_OPTION_HORALIGNED** flag is provided, ***x*** is interpreted
as an **ncalign_e** rather than an absolute position. If the
**NCPLANE_OPTION_VERALIGNED** flag is provided, ***y*** is interpreted as an
**ncalign_e** rather than an absolute postiion. Either way, all positions
are relative to the parent plane.
**ncplane_reparent** detaches the plane ***n*** from any plane to which it is **ncplane_reparent** detaches the plane ***n*** from any plane to which it is
bound, and binds it to ***newparent***. Its children are reparented to its bound, and binds it to ***newparent***. Its children are reparented to its
previous parent. The standard plane cannot be reparented. If ***newparent*** is previous parent. The standard plane cannot be reparented. If ***newparent*** is

4
include/notcurses/notcurses.h
View File

@ -1123,8 +1123,10 @@ notcurses_term_dim_yx(const struct notcurses* n, int* RESTRICT rows, int* RESTRI
API char* notcurses_at_yx(struct notcurses* nc, int yoff, int xoff, API char* notcurses_at_yx(struct notcurses* nc, int yoff, int xoff,
uint16_t* stylemask, uint64_t* channels); uint16_t* stylemask, uint64_t* channels);
// Horizontal alignment relative to the parent plane. Use 'align' instead of 'x'. // Horizontal alignment relative to the parent plane. Use ncalign_e for 'x'.
#define NCPLANE_OPTION_HORALIGNED 0x0001ull #define NCPLANE_OPTION_HORALIGNED 0x0001ull
// Vertical alignment relative to the parent plane. Use ncalign_e for 'y'.
#define NCPLANE_OPTION_VERALIGNED 0x0002ull
typedef struct ncplane_options { typedef struct ncplane_options {
int y; // vertical placement relative to parent plane int y; // vertical placement relative to parent plane

2
src/demo/xray.c
View File

@ -104,7 +104,7 @@ int xray_demo(struct notcurses* nc){
} }
struct ncvisual_options vopts = { struct ncvisual_options vopts = {
.n = n, .n = n,
.scaling = NCSCALE_STRETCH, .scaling = NCSCALE_SCALE_HIRES,
.blitter = NCBLIT_PIXEL, .blitter = NCBLIT_PIXEL,
.flags = NCVISUAL_OPTION_NODEGRADE, // to test for NCBLIT_PIXEL .flags = NCVISUAL_OPTION_NODEGRADE, // to test for NCBLIT_PIXEL
}; };