Struct libnotcurses_sys::ffi::notcurses_options

#[repr(C)]
pub struct notcurses_options {
    pub termtype: *const c_char,
    pub renderfp: *mut FILE,
    pub loglevel: ncloglevel_e,
    pub margin_t: c_int,
    pub margin_r: c_int,
    pub margin_b: c_int,
    pub margin_l: c_int,
    pub flags: u64,
}

Configuration for notcurses_init().

Fields

termtype: *const c_char

The name of the terminfo database entry describing this terminal. If NULL, the environment variable TERM is used. Failure to open the terminal definition will result in failure to initialize notcurses.

renderfp: *mut FILE

deprecated, must be NULL, will be removed for ABI3 FIXME

loglevel: ncloglevel_e

Progressively higher log levels result in more logging to stderr. By default, nothing is printed to stderr once fullscreen service begins.

margin_t: c_int

Desirable margins. If all are 0 (default), we will render to the entirety of the screen. If the screen is too small, we do what we can–this is strictly best-effort. Absolute coordinates are relative to the rendering area ((0, 0) is always the origin of the rendering area).

margin_r: c_int

Desirable margins. If all are 0 (default), we will render to the entirety of the screen. If the screen is too small, we do what we can–this is strictly best-effort. Absolute coordinates are relative to the rendering area ((0, 0) is always the origin of the rendering area).

margin_b: c_int

Desirable margins. If all are 0 (default), we will render to the entirety of the screen. If the screen is too small, we do what we can–this is strictly best-effort. Absolute coordinates are relative to the rendering area ((0, 0) is always the origin of the rendering area).

margin_l: c_int

Desirable margins. If all are 0 (default), we will render to the entirety of the screen. If the screen is too small, we do what we can–this is strictly best-effort. Absolute coordinates are relative to the rendering area ((0, 0) is always the origin of the rendering area).

flags: u64

General flags; see NCOPTION_*. This is expressed as a bitfield so that future options can be added without reshaping the struct. Undefined bits must be set to 0.

Implementations

impl notcurses_options

NcOptions Constructors

pub const fn new() -> Self

New NcOptions.

pub const fn with_margins(
    top: NcDim,
    right: NcDim,
    bottom: NcDim,
    left: NcDim
) -> Self

New NcOptions, with margins.

pub const fn with_flags(flags: u64) -> Self

New NcOptions, with flags.

pub const fn with_all_options(
    loglevel: NcLogLevel,
    margin_t: NcDim,
    margin_r: NcDim,
    margin_b: NcDim,
    margin_l: NcDim,
    flags: u64
) -> Self

New NcOptions, with all the options.

Arguments

• loglevel

  Progressively higher log levels result in more logging to stderr. By default, nothing is printed to stderr once fullscreen service begins.

• margin_t, margin_r, margin_b, margin_l

  Desirable margins (top, right, bottom, left).

  If all are 0 (default), we will render to the entirety of the screen. If the screen is too small, we do what we can. Absolute coordinates are relative to the rendering area ((0, 0) is always the origin of the rendering area).

• flags

  General flags; This is expressed as a bitfield so that future options can be added without reshaping the struct. Undefined bits must be set to 0.

  • NCOPTION_INHIBIT_SETLOCALE
  • NCOPTION_NO_ALTERNATE_SCREEN
  • NCOPTION_NO_FONT_CHANGES
  • NCOPTION_NO_QUIT_SIGHANDLERS
  • NCOPTION_NO_WINCH_SIGHANDLER
  • NCOPTION_SUPPRESS_BANNERS

Trait Implementations

impl Clone for notcurses_options

fn clone(&self) -> notcurses_options

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for notcurses_options

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for notcurses_options

fn default() -> Self

Returns the “default value” for a type.

impl Hash for notcurses_options

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for notcurses_options

fn cmp(&self, other: &notcurses_options) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<notcurses_options> for notcurses_options

fn eq(&self, other: &notcurses_options) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &notcurses_options) -> bool

This method tests for !=.

impl PartialOrd<notcurses_options> for notcurses_options

fn partial_cmp(&self, other: &notcurses_options) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for notcurses_options

impl Eq for notcurses_options

impl StructuralEq for notcurses_options

impl StructuralPartialEq for notcurses_options