notcurses/CHANGELOG.md

This document attempts to list user-visible changes and any major internal
rearrangements of Notcurse.

* 1.2.5 (not yet released)
** gradient, polyfill, ncplane_format() and ncplane_stain() all now return the
   number of cells written on success. Failure still sees -1 returned.
** `ncvisual_render()` now returns the number of cells emitted on success, as
    opposed to 0. Failure still sees -1 returned.
** `ncvisual_render()` now interprets length parameters of -1 to mean "to the
   end along this axis", and no longer interprets 0 to mean this. 0 now means
   "a length of 0", resulting in a zero-area rendering.
** `notcurses_at_yx()` no longer accepts a `cell*` as its last parameter.
   Instead, it accepts a `uint32_t*` and a `uint64_t*`, and writes the
   attribute and channels to these parameters. This was done because the
   `gcluster` field of the `cell*` was always set to 0, which was surprising
   and a source of blunders. The EGC is returned via the `char*` return
   value. https://github.com/dankamongmen/notcurses/issues/410

* 1.2.4 2020-03-24
** Add ncmultiselector
** Add `ncdirect_cursor_enable()` and `ncdirect_cursor_disable()`.
More tetris work for book #421 (#423) * tetris: use NES gravities * tetris: use NES grav multiplier of 50ms * tetris: implement move down #421 * README: mention notcurses-tetris #421 * tetris: use double box for boundary #421 * tetris: extract background.h * tetris: break up into chunks suitable for book * tetris: do the rotations 4 years ago			`This document attempts to list user-visible changes and any major internal`
			`rearrangements of Notcurse.`

			`* 1.2.5 (not yet released)`
All fill-type functions return cells changed Fill-type functions used to return 0 for success, and -1 on failure. They now return the number of cells written on success, similarly to ncvisual_render(). Resolves #427. 4 years ago			`** gradient, polyfill, ncplane_format() and ncplane_stain() all now return the`
			`number of cells written on success. Failure still sees -1 returned.`
More tetris work for book #421 (#423) * tetris: use NES gravities * tetris: use NES grav multiplier of 50ms * tetris: implement move down #421 * README: mention notcurses-tetris #421 * tetris: use double box for boundary #421 * tetris: extract background.h * tetris: break up into chunks suitable for book * tetris: do the rotations 4 years ago			** `ncvisual_render()` now returns the number of cells emitted on success, as
			`opposed to 0. Failure still sees -1 returned.`
			** `ncvisual_render()` now interprets length parameters of -1 to mean "to the
			`end along this axis", and no longer interprets 0 to mean this. 0 now means`
			`"a length of 0", resulting in a zero-area rendering.`
notcurses_at_yx(): value-result u32+u64, not cell Resolves #410. notcurses_at_yx() accepted a cell, but the gcluster of this cell was always set to 0. The EGC is instead a heap-allocated copy, returned as the primary return value. This is due to the absence of an egcpool to bind against. Existing callers can be converted thus: instead of passing cell 'c', pass &(c)->attrword, &(c)->channels * either initialize 'c' with CELL_TRIVIAL_INITIALIZER, or set its gcluster field to 0 following the call I've updated all calls from tests/demos, updated the docs, and updated the C++ and Python wrappers. 4 years ago			** `notcurses_at_yx()` no longer accepts a `cell*` as its last parameter.
			Instead, it accepts a `uint32_t` and a `uint64_t`, and writes the
			`attribute and channels to these parameters. This was done because the`
			`gcluster` field of the `cell*` was always set to 0, which was surprising
			and a source of blunders. The EGC is returned via the `char*` return
			`value. https://github.com/dankamongmen/notcurses/issues/410`
More tetris work for book #421 (#423) * tetris: use NES gravities * tetris: use NES grav multiplier of 50ms * tetris: implement move down #421 * README: mention notcurses-tetris #421 * tetris: use double box for boundary #421 * tetris: extract background.h * tetris: break up into chunks suitable for book * tetris: do the rotations 4 years ago
			`* 1.2.4 2020-03-24`
			`** Add ncmultiselector`
			** Add `ncdirect_cursor_enable()` and `ncdirect_cursor_disable()`.