Struct DisplaySettings 

pub struct DisplaySettings {
    pub columns: usize,
    pub rows: usize,
    pub encoding: TextEncoding,
    pub code_table: Option<u8>,
    pub reset_on_open: bool,
    pub brightness: Option<RangeInclusive<u8>>,
    pub brightness_settle: Duration,
}

Настройки геометрии и ESC/POS-команд дисплея.

columns и rows задают координатную сетку, используемую для проверки print_line и print_at. code_table управляет только аппаратной командой ESC t n, а encoding определяет программное преобразование текста в байты.

Fields

columns: usize

Количество символов в строке.

Допустимый диапазон: 1..=255. Значение используется для обрезки, заполнения пробелами и проверки координаты x.

rows: usize

Количество строк.

Допустимый диапазон: 1..=255. Значение используется для проверки line и y во всех методах печати.

encoding: TextEncoding

Кодировка текстовых байтов.

Это программное преобразование Rust-строки в байты транспорта. Оно не выбирает аппаратную таблицу дисплея.

code_table: Option<u8>

Таблица символов для ESC t n; None отключает отправку команды.

Это отдельная аппаратная команда протокола. Для многих дисплеев CP866 работает только когда одновременно выбраны encoding = TextEncoding::Cp866 и нужное значение code_table.

reset_on_open: bool

Отправлять ESC @ при открытии.

Сброс полезен для predictable startup, но его можно выключить, если приложение намеренно сохраняет состояние дисплея между открытиями.

brightness: Option<RangeInclusive<u8>>

Поддерживаемый диапазон яркости для US X n.

None означает, что типизированная установка яркости запрещена и crate::Vfd::set_brightness вернёт crate::VfdError::UnsupportedBrightness.

brightness_settle: Duration

Задержка после изменения яркости.

Некоторые дисплеи требуют короткую паузу после US X n. Sync API блокирует текущий поток на это время; Tokio API ждёт через async sleep.

Implementations

impl DisplaySettings

pub fn new(columns: usize, rows: usize, encoding: TextEncoding) -> Self

Создаёт ручные настройки дисплея.

По умолчанию включён ESC @ при открытии, яркость 1..=4 и короткая задержка после её изменения. Аппаратная таблица символов не выбирается автоматически: задайте code_table = Some(n), если вашему дисплею нужна команда ESC t n.

Ошибки

Метод сам не возвращает ошибку. Проверка выполняется в DisplaySettings::validate или при создании VfdConfig.

Примеры

use escpos_vfd::{DisplaySettings, TextEncoding};

let mut display = DisplaySettings::new(20, 2, TextEncoding::Cp866);
display.code_table = Some(6);
assert!(display.validate().is_ok());

pub fn validate(&self) -> Result<(), ConfigError>

Проверяет геометрию и диапазоны настроек дисплея.

Ошибки

Возвращает ConfigError::InvalidColumns, ConfigError::InvalidRows или ConfigError::InvalidBrightnessRange.

Trait Implementations

impl Clone for DisplaySettings

fn clone(&self) -> DisplaySettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DisplaySettings

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

Formats the value using the given formatter.

impl Eq for DisplaySettings

impl PartialEq for DisplaySettings

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DisplaySettings