Struct leechbar::BarBuilder

pub struct BarBuilder { /* fields omitted */ }

The bar configuration.

This is used to configure the bar. After configuration, the bar can be created using the spawn method.

Examples

Basic usage:

use leechbar::{BarBuilder, Color};

// All method calls that take parameters are optional
BarBuilder::new()
    .background_color(Color::new(255, 0, 255, 255))
    .foreground_color(Color::new(0, 255, 0, 255))
    .font("Fira Mono Medium 14")
    .output("DVI-1")
    .name("MyBar")
    .height(30)
    .spawn()
    .unwrap();

Methods

impl BarBuilder

fn new() -> Self

Create a new instance of the BarBuilder with default parameters.

fn foreground_color(self, color: Color) -> Self

Change the default foreground color.

Default: White (255, 255, 255, 255)

fn background_color(self, color: Color) -> Self

Change the default background color.

Default: Black (0, 0, 0, 255)

fn background_image(self, image: DynamicImage) -> Self

Change the default background image.

This takes an image and sets it as the default background for the bar. The image is not resized or modified in any way, so it is required to manually adjust it to fit the specified bar geometry.

Default: No background image.

fn name<T: Into<String>>(self, name: T) -> Self

Change the default name of the bar.

This name is used by your Window Manager.

Default: leechbar

fn font<T: Into<String>>(self, font: T) -> Self

Change the default font of the bar.

This font is used for each block unless manually overwritten.

Default: Default pango font.

fn height(self, height: u16) -> Self

Change the default height of the bar.

This specifies the vertical height used in pixels.

Default: 30

fn output<T: Into<String>>(self, output: T) -> Self

Change the default output the bar should be displayed on.

This uses RANDR to get the output with the specified name. An example value for a DVI output would be DVI-0.

If not specified the primary output is selected.

Default: Primary output.

fn text_yoffset(self, text_yoffset: i16) -> Self

Change the default vertical text offset of the bar.

This is overridden by the component's vertical offset if present.

Default: 0

fn spawn(self) -> Result<Bar>

Spawn the bar with the currently configured settings.

This creates a window and registers it as a bar on Xorg.

Trait Implementations

impl Default for BarBuilder

fn default() -> Self

Returns the "default value" for a type.