Struct StylingInfo

pub struct StylingInfo {
    pub font_name: Option<String>,
    pub font_size: Option<u32>,
    pub color: Option<String>,
    pub bold: bool,
    pub italic: bool,
    pub underline: bool,
}

Optional styling information for subtitle entries with comprehensive formatting support.

This structure contains visual formatting information that can be applied to subtitle text. Not all formats support all styling options, and some styling may be lost during format conversions.

Format Support

• SRT: Limited support (bold, italic, underline via HTML tags)
• ASS: Full support for all styling options plus advanced features
• VTT: Good support via CSS-style declarations
• SUB: No styling support (ignored)

Color Format

Colors can be specified in various formats:

• Hex: “#FF0000”, “#ff0000”
• RGB: “rgb(255, 0, 0)”
• Named: “red”, “blue”, “white”
• ASS format: “&H0000FF&” (BGR order)

Examples

use subx_cli::core::formats::StylingInfo;

// Basic text styling
let basic_style = StylingInfo {
    bold: true,
    italic: false,
    underline: false,
    ..Default::default()
};

// Complete styling with font and color
let full_style = StylingInfo {
    font_name: Some("Arial".to_string()),
    font_size: Some(20),
    color: Some("#FFFFFF".to_string()),
    bold: true,
    italic: false,
    underline: false,
};

assert!(full_style.has_font_styling());
assert!(full_style.has_text_decoration());

Fields

font_name: Option<String>

Font family name for the subtitle text.

Common fonts: “Arial”, “Times New Roman”, “Helvetica”, “SimHei” Some formats may fall back to default fonts if not available.

font_size: Option<u32>

Font size in points or pixels (format-dependent).

Typical ranges: 12-24 for normal subtitles, larger for accessibility. The exact interpretation depends on the target format.

color: Option<String>

Text color specification.

Supports multiple formats: hex (#FF0000), RGB, named colors. Default is usually white (#FFFFFF) for video subtitles.

bold: bool

Whether the text should be rendered in bold weight.

italic: bool

Whether the text should be rendered in italic style.

underline: bool

Whether the text should have underline decoration.

Implementations

impl StylingInfo

pub fn new(bold: bool, italic: bool, underline: bool) -> Self

Create new styling with only text decorations.

Arguments

• bold - Apply bold weight
• italic - Apply italic style
• underline - Apply underline decoration

Examples

let style = StylingInfo::new(true, false, false); // Bold only

pub fn has_font_styling(&self) -> bool

Check if any font-related styling is applied.

Returns true if font name, size, or color is specified.

pub fn has_text_decoration(&self) -> bool

Check if any text decoration is applied.

Returns true if bold, italic, or underline is enabled.

pub fn has_any_styling(&self) -> bool

Check if any styling is applied at all.

Returns true if either font styling or text decoration is present.

pub fn normalized_color(&self) -> Option<String>

Convert color to hex format if possible.

Attempts to normalize the color specification to #RRGGBB format. Returns the original color string if conversion is not possible.

pub fn to_css(&self) -> String

Generate CSS-style representation of the styling.

Creates a CSS declaration block that can be used for VTT format or web-based subtitle rendering.

Returns

CSS string like “font-family: Arial; font-weight: bold; color: #FF0000;”

Trait Implementations

impl Clone for StylingInfo

fn clone(&self) -> StylingInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StylingInfo

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

Formats the value using the given formatter.

impl Default for StylingInfo

fn default() -> StylingInfo

Returns the “default value” for a type.