Type Definition libnotcurses_sys::NcChannel

type NcChannel = u32;

32 bits of context-dependent info containing RGB + 2 bits of alpha + extra

It is:

• a 24-bit NcRgb value
• plus 8 bits divided in:
  • 2 bits of NcAlphaBits
  • 6 bits of context-dependent info

The context details are documented in NcChannels

Diagram

~~AA~~~~ RRRRRRRR GGGGGGGG BBBBBBBB

type in C: channel (uint32_t)

See also: NcRgb and NcRgba types.

Trait Implementations

impl NcChannelMethods for NcChannel

NcChannel Methods

fn new() -> Self

New NcChannel, set to black and NOT using the “default color”.

fn default() -> Self

New NcChannel, set to black and using the “default color”.

fn from_rgb(rgb: NcRgb) -> Self

New NcChannel, expects NcRgb.

fn from_rgb_alpha(rgb: NcRgb, alpha: NcAlphaBits) -> Self

New NcChannel, expects NcRgb & NcAlphaBits.

fn from_rgb8(r: NcComponent, g: NcComponent, b: NcComponent) -> Self

New NcChannel, expects three RGB NcComponent components.

fn from_rgb8_alpha(
    r: NcComponent,
    g: NcComponent,
    b: NcComponent,
    alpha: NcAlphaBits
) -> Self

New NcChannel, expects three RGB NcComponent components & NcAlphaBits.

fn fcombine(&self, bchannel: NcChannel) -> NcChannels

Combines this NcChannel as foreground, with another as background into an NcChannels.

C style function: channels_combine().

fn bcombine(&self, fchannel: NcChannel) -> NcChannels

Combines this NcChannel as background, with another as foreground into an NcChannels.

C style function: channels_combine().

fn alpha(&self) -> NcAlphaBits

Gets the NcAlphaBits.

C style function: channel_alpha().

fn set_alpha(&mut self, alpha: NcAlphaBits) -> Self

Sets the NcAlphaBits.

C style function: channel_set_alpha().

fn rgb(&self) -> NcRgb

Gets the NcRgb.

C style function: channel_rgb().

fn set(&mut self, rgb: NcRgb) -> Self

Sets the NcRgb, and marks the NcChannel as NOT using the “default color”, retaining the other bits unchanged.

C style function: channel_set().

fn rgb8(&self) -> (NcComponent, NcComponent, NcComponent)

Gets the three NcComponents.

C style function: channel_rgb8().

fn set_rgb8(&mut self, r: NcComponent, g: NcComponent, b: NcComponent) -> Self

Sets the three NcComponents, and marks the NcChannel as NOT using the “default color”.

C style function: channel_set_rgb8().

fn r(&self) -> NcComponent

Gets the red NcComponent.

C style function: channel_r().

fn g(&self) -> NcComponent

Gets the green NcComponent.

C style function: channel_g().

fn b(&self) -> NcComponent

Gets the blue NcComponent.

C style function: channel_b().

fn set_r(&mut self, r: NcComponent) -> Self

Sets the red NcComponent, and returns the new NcChannel.

C style function: channel_set_r().

fn set_g(&mut self, g: NcComponent) -> Self

Sets the green NcComponent, and returns the new NcChannel.

C style function: channel_set_g().

fn set_b(&mut self, b: NcComponent) -> Self

Sets the blue NcComponent, and returns the new NcChannel.

C style function: channel_set_b().

fn default_p(&self) -> bool

Is this NcChannel using the “default color” rather than RGB/palette-indexed?

C style function: channel_default_p().

fn set_default(&mut self) -> Self

Marks this NcChannel as using its “default color”, which also marks it opaque.

C style function: channel_set_default().

fn set_not_default(&mut self) -> Self

Marks this NcChannel as not using its “default color”.

The following methods also marks the channel as NOT using the “default color”:

• new()
• set()
• set_rgb8()

C style function: channel_set_not_default().

fn palindex_p(&self) -> bool

Is this NcChannel using palette-indexed color rather than RGB?

C style function: channel_set_default().