com.peterphi.std.types

Class TimecodeBuilder

java.lang.Object

com.peterphi.std.types.TimecodeBuilder

public class TimecodeBuilder
extends java.lang.Object

Constructs Timecode instances

Constructor Summary

Constructors

Constructor and Description
TimecodeBuilder()

Method Summary

Methods

Modifier and Type	Method and Description
Timecode	build() Constructs a Timecode instance with the fields defined in this builder
static TimecodeBuilder	fromEncodedValue(java.lang.String encoded) Parse a Timecode encoded in the "vidispine style" (hh:mm:ss:ff@timebase).
static TimecodeBuilder	fromFrames(long signedFrameNumber, boolean dropFrame, Timebase rate)
static TimecodeBuilder	fromSamples(SampleCount samples, boolean dropFrame)
static TimecodeBuilder	fromSMPTE(java.lang.String smpte) Part a Timecode encoded in the SMPTE style ([dd:]hh:mm:ss:ff - or [dd:]hh:mm:ss;ff for drop-frame timecode)
static TimecodeBuilder	fromTimecode(Timecode timecode)
long	getDays()
long	getFrames()
long	getHours()
long	getMinutes()
Timebase	getRate()
long	getSeconds()
boolean	isDropFrame()
boolean	isNegative()
java.lang.String	toString()
TimecodeBuilder	withDays(long days)
TimecodeBuilder	withDropFrame(boolean dropFrame)
TimecodeBuilder	withFrames(long frames)
TimecodeBuilder	withHours(long hours)
TimecodeBuilder	withMinutes(long minutes)
TimecodeBuilder	withNegative(boolean negative)
TimecodeBuilder	withRate(Timebase rate)
TimecodeBuilder	withSeconds(long seconds)
TimecodeBuilder	withTimecode(Timecode timecode) Reset this builder to the values in the provided Timecode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TimecodeBuilder

public TimecodeBuilder()

Method Detail

withTimecode

public TimecodeBuilder withTimecode(Timecode timecode)

Reset this builder to the values in the provided Timecode

Parameters:

timecode -

Returns:

withNegative

public TimecodeBuilder withNegative(boolean negative)

withDays

public TimecodeBuilder withDays(long days)

withHours

public TimecodeBuilder withHours(long hours)

withMinutes

public TimecodeBuilder withMinutes(long minutes)

withSeconds

public TimecodeBuilder withSeconds(long seconds)

withFrames

public TimecodeBuilder withFrames(long frames)

withDropFrame

public TimecodeBuilder withDropFrame(boolean dropFrame)

withRate

public TimecodeBuilder withRate(Timebase rate)

build

public Timecode build()

Constructs a Timecode instance with the fields defined in this builder

Returns:

Throws:

java.lang.IllegalArgumentException - if any of the fields are invalid/incompatible

isNegative

public boolean isNegative()

getDays

public long getDays()

getHours

public long getHours()

getMinutes

public long getMinutes()

getSeconds

public long getSeconds()

getFrames

public long getFrames()

getRate

public Timebase getRate()

isDropFrame

public boolean isDropFrame()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

fromTimecode

public static TimecodeBuilder fromTimecode(Timecode timecode)

fromEncodedValue

public static TimecodeBuilder fromEncodedValue(java.lang.String encoded)

Parse a Timecode encoded in the "vidispine style" (hh:mm:ss:ff@timebase). See Timebase.getInstance(java.lang.String) for information on valid timebase representations

Parameters:

encoded - a timecode encoded as hh:mm:ss:ff@timebase

Returns:

a parsed timecode object

Throws:

java.lang.RuntimeException - if the encoded string is not well-formed or could not be parsed

fromSMPTE

public static TimecodeBuilder fromSMPTE(java.lang.String smpte)

Part a Timecode encoded in the SMPTE style ([dd:]hh:mm:ss:ff - or [dd:]hh:mm:ss;ff for drop-frame timecode)

Parameters:

smpte - the SMPTE-encoded timecode

Returns:

a parsed timecode object

Throws:

java.lang.RuntimeException - if parsing fails

fromSamples

public static TimecodeBuilder fromSamples(SampleCount samples,
                          boolean dropFrame)

fromFrames

public static TimecodeBuilder fromFrames(long signedFrameNumber,
                         boolean dropFrame,
                         Timebase rate)