Struct EventBuilder 

pub struct EventBuilder<'a> { /* private fields */ }

Builder for creating ASS events with fluent API

Provides an ergonomic way to construct ASS events with method chaining. Supports all event types and automatically handles format validation.

Examples

use ass_editor::{EventBuilder, EditorDocument};

let mut doc = EditorDocument::new();

// Create a dialogue event
let event_line = EventBuilder::dialogue()
    .start_time("0:00:00.00")
    .end_time("0:00:05.00")
    .style("Default")
    .speaker("Character")
    .text("Hello, world!")
    .layer(0)
    .build()
    .unwrap();

// Add to document
doc.add_event_line(&event_line).unwrap();

Implementations

impl<'a> EventBuilder<'a>

pub fn new() -> Self

Create a new event builder

pub fn dialogue() -> Self

Create a dialogue event builder

pub fn comment() -> Self

Create a comment event builder

pub fn start_time<S: Into<Cow<'a, str>>>(self, time: S) -> Self

Set start time (e.g., “0:00:05.00”)

pub fn end_time<S: Into<Cow<'a, str>>>(self, time: S) -> Self

Set end time (e.g., “0:00:10.00”)

pub fn speaker<S: Into<Cow<'a, str>>>(self, name: S) -> Self

Set speaker/character name

pub fn text<S: Into<Cow<'a, str>>>(self, text: S) -> Self

Set dialogue text

pub fn style<S: Into<Cow<'a, str>>>(self, style: S) -> Self

Set style name

pub fn layer(self, layer: u32) -> Self

Set layer (higher layers render on top)

pub fn margin_left(self, margin: u32) -> Self

Set left margin

pub fn margin_right(self, margin: u32) -> Self

Set right margin

pub fn margin_vertical(self, margin: u32) -> Self

Set vertical margin

pub fn margin_top(self, margin: u32) -> Self

Set top margin (V4++)

pub fn margin_bottom(self, margin: u32) -> Self

Set bottom margin (V4++)

pub fn effect<S: Into<Cow<'a, str>>>(self, effect: S) -> Self

Set effect

pub fn build(self) -> Result<String>

Build the event (validates required fields)

pub fn build_with_version(self, version: ScriptVersion) -> Result<String>

Build the event with a specific format version

pub fn build_with_format(&self, format: &[&str]) -> Result<String>

Build the event with a specific format line The format parameter should contain field names like [“Layer”, “Start”, “End”, “Style”, “Text”]

Trait Implementations

impl<'a> Debug for EventBuilder<'a>

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

Formats the value using the given formatter.

impl<'a> Default for EventBuilder<'a>

fn default() -> EventBuilder<'a>

Returns the “default value” for a type.