About old versions of 'etmccalc'

V0.6.4 (2007-09-27)

This is the general command line syntax:

etmccalc [<options>] <fps> [<timcode>[ <timecode>[...]]]

where :

options :
- (-f|--format) <format> : output formating specification. Default is the content of the enviroment variable ETMCCALC_FORMAT or, if empty or not defined, '%P'. See below for more details.
- (-p|--punctuations) <punctuations> : punctuations used for %p (see above). Default is the content of the enviroment variable ETMCCALC_PUNCTUATIONS or, if empty or not defined, ';:'. See below for more details.
fps is the frames-per-second specification for the result (an integer, 23(d|n), 24d, 29(n|d), 30d, 59(n|d) or 60d (d for drop-frame, n for not realtime)),
timecode the timecode for the calculation (currently in h:m:s:f@fps format ; for fps value, see above).

Output formating

Marker	Signification
`%%`	`%` sign
`%<f>d`	Amount of days
`%<f>D`	Same as `%<f>d`
`%<f>h`	Hours in the day
`%<f>H`	Total amount of hours
`%<f>m`	Minutes in the hour
`%<f>M`	Total amount of minutes
`%<f>s`	Seconds in the minute
`%<f>S`	Total amount of seconds
`%<f>f`	Frames in the second
`%<f>F`	Total amount of frames
`%c`	Remainder as float (for testing purpose)
`%C`	Remainder as fraction (for testing purpose)
`%p`	FPS-type dependent punctuation (see below)
`%E`	After Effect format (`%r2h%p%r2m%p%r2s%p%2rf`)
`%P`	Final Cut Pro format (`%r2h:%r2m:%r2s%p%2rf`)

f : [R|r][<w>][(.|,)[<p>]] (1 by default). Optional set of following flags :

R or r : always round up (R) or down (r) respectively,
Leaving the [R|r] out will round as taught in school
w : count of the minimum amount of digits for the integer part,
. or , : the decimal separator to use,
p : count of the maximum amount of digits for the fractional part.

Examples:

f	Signification
`%RF`	Frames rounded up
`%F`	Frames rounded to nearest (best for subtitles)
`%rF`	Frames rounded down; makes sense for most video editing applications
`%.6S`	Total amount in seconds with six decimal places and using a period as delimiter; e.g. used in Audacity label lists

The punctuations option is used for the '%p' format marker. For drop frame, the first character is used. For non-real-time, the second character is used if set. If not the one for drop frame is used. For non drop frame, the third character is used if set. Alternatively the one for non-real-time is used.

V 0.6.2 (2007-09-11)

Command line syntax

This is the general command line syntax:

etmccalc [<options>] <fps> [<timcode>[ <timecode>[...]]]

where :

options :
- (-f|--format) <format> : output formating specification. Default is the content of enviroment variable ETMCCALC_FORMAT or, if empty or not defined, '%P'. See below for more details.
- (-p|--punctuations) <punctuations> : punctuations used for %p (see above). Default is the content of enviroment variable ETMCCALC_PUNCTUATIONS or, if empty or not defined, ';:'. See below for more details.
fps is the frames-per-second specification for the result (an integer, 23(d|n), 24d, 29(n|d), 30d, 59(n|d) or 60d (d for drop-frame, n for not realtime)),
timecode the timecode for the calculation (currently in h:m:s:f@fps format ; for fps value, see above).

Output formating

Marker	Signification
`%%`	`%` sign
`%<f>d`	Amount of days
`%<f>D`	Same as `%<f>d`
`%<f>h`	Hours in the day
`%<f>H`	Total amount of hours
`%<f>m`	Minutes in the hour
`%<f>M`	Total amount of minutes
`%<f>s`	Seconds in the minute
`%<f>S`	Total amount of seconds
`%<f>f`	Frames in the second
`%<f>F`	Total amount of frames
`%c`	Remainder as float (for testing purpose)
`%C`	Remainder as fraction (for testing purpose)
`%p`	FPS-type dependent punctuation (see below)
`%E`	After Effect format (`%r2h%p%r2m%p%r2s%p%2f`)
`%P`	Final Cut Pro format (`%r2h:%r2m:%r2s%p%2f`)

f : [R|r][<w>][(.|,)[<p>]] (1 by default). Optional set of following flags :

R or r : always round up (R) or down (r) respectively,
Leaving the [R|r] out will round as taught in school
w : count of the minimum amount of digits for the integer part,
. or , : the decimal separator to use,
p : count of the maximum amount of digits for the fractional part.

Examples:

f	Signification
`%RF`	Frames rounded up
`%F`	Frames rounded to nearest (best for subtitles)
`%rF`	Frames rounded down; makes sense for most video editing applications
`%.6S`	Total amount in seconds with six decimal places and using a period as delimiter; e.g. used in Audacity label lists

The punctuations option is used for the '%p' format marker. For drop frame, the first character is used. For non-real-time, the second character is used if set. If not the one for drop frame is used. For non drop frame, the third character is used if set. Alternatively the one for non-real-time is used.

Limitations

Due to the variable types used, the maximum frame rate is 4294967295 fps. This is also the maximum value for any other integer. Calculations with such huge numbers may not come up with a result though, as they can lead to overflows.

V 6.0.0 (2007-07-03)

Command line syntax

This is the general command line syntax:

etmccalc [<options>] <fps> [<timcode>[ <timecode>[...]]]

where :

options :
- (-f|--format) <format> : output formating specification. Default is the content of enviroment variable ETMCCALC_FORMAT or, if empty or not defined, '%P'. See below for more details.
- (-p|--punctuations) <punctuations> : punctuations used for %p (see above). Default is the content of enviroment variable ETMCCALC_PUNCTUATIONS or, if empty or not defined, ';:'. See below for more details.
fps is the frames-per-second specification for the result (an integer, 23(d|n), 24d, 29(n|d), 30d, 59(n|d) or 60d (d for drop-frame, n for not realtime)),
timecode the timecode for the calculation (currently in h:m:s:f@fps format ; for fps value, see above).

Output formating

Marker	Signification
`%%`	`%` sign
`%<f>d`	Amount of days
`%<f>D`	Same as `%<f>d`
`%<f>h`	Hours in the day
`%<f>H`	Total amount of hours
`%<f>m`	Minutes in the hour
`%<f>M`	Total amount of minutes
`%<f>s`	Seconds in the minute
`%<f>S`	Total amount of seconds
`%<f>f`	Frames in the second
`%<f>F`	Total amount of frames
`%c`	Remainder as float (for testing purpose)
`%C`	Remainder as fraction (for testing purpose)
`%p`	FPS-type dependent punctuation (see below)
`%E`	After Effect format (`%r2h%p%r2m%p%r2s%p%2f`)
`%P`	Final Cut Pro format (`%r2h:%r2m:%r2s%p%2f`)

f : [R|r][<w>][(.|,)[<p>]] (1 by default). Optional set of following flags :

R or r : always round up (R) or down (r) respectively,
Leaving the [R|r] out will round as taught in school
w : count of the minimum amount of digits for the integer part,
. or , : the decimal separator to use,
p : count of the maximum amount of digits for the fractional part.

Examples:

f	Signification
`%RF`	Frames rounded up
`%F`	Frames rounded to nearest (best for subtitles)
`%rF`	Frames rounded down; makes sense for most video editing applications
`%.6S`	Total amount in seconds with six decimal places and using a period as delimiter; e.g. used in Audacity label lists

The punctuations option is used for the '%p' format marker. For drop frame, the first character is used. For non-real-time, the second character is used if set. If not the one for drop frame is used. For non drop frame, the third character is used if set. Alternatively the one for non-real-time is used.

V 0.5.0 (2007-06-19)

Command line syntax

This is the general command line syntax:

etmccalc <output-fps> [<timcode>[ <timecode>[...]]]

where :

<fps> is the frames-per-second specification for the result (an integer, 23(d|n), 24d, 29(n|d), 30d, 59(n|d) or 60d (d for drop-frame, n for not realtime)),
<timecode> the timecode for the calculation (currently in h:m:s:f!fps format ; for fps value, see above).

Output formating

Formating is done using the value stored in the environment variable ETMCCALC_FORMAT. The following markers a recognized:

Marker	Signification	Example value	Display
`%%`	`%` sign	N/A	`%`
`%h`	Hours without leading `0`	9	`9`
`%H`	Hours with leading `0`	8	`08`
`%m`	Minutes without leading `0`	7	`7`
`%M`	Minutes with leading `0`	6	`06`
`%s`	Seconds without leading `0`	5	`5`
`%S`	Seconds with leading `0`	4	`04`
`%i`	Images count without leading `0`	3	`3`
`%I`	Images count with leading `0`	2	`02`
`%r`	Remainder as float	1/4	`0.25`
`%R`	Remainder as fraction	1/3	`1/3`
`%p`	FPS-type dependent punctuation	N/A	See below

%p is replaced with the following :

if the output is non drop frame, the content of environment variable ETMCCALC_NDF_SEPARATOR (: if not defined or empty),
if the output is drop frame, the content of environment variable ETMCCALC_DF_SEPARATOR (; if not defined or empty),
if the output is non real time, the content of environment variable ETMCCALC_NRT_SEPARATOR (. if not defined or empty).

If the environment variable ETMCCALC_FORMAT is not defined or empty, the following format string is used :

%H:%M:%S%p%I

Examples

The following string is used to format the output:

%H:%M:%S%p%I (%R)

$ etmccalc 25 0:0:0:10!25 0:0:0:15!25
00:00:01:00 (0/1)

$ etmccalc 30 0:0:0:10!25 0:0:0:15!25
00:00:01:00 (0/1)

$ etmccalc 29d 1:2:3:4!30 5:6:7:8!25 5:4:3:2!30
11:12:13;17 (-197/1001)

V 0.4.0 (2007-06-15)

This is the general command line syntax:

etmccalc <output-fps> [<timcode>[ <timecode>[...]]]

where :

<fps> is the frames-per-second specification for the result (an integer, 23(d|n), 24d, 29(n|d), 30d, 59(n|d) or 60d (d for drop-frame, n for not realtime)),
<timecode> the timecode for the calculation (currently in h:m:s:f!fps format ; for fps value, see above).

Examples (the fraction between parentheses are for testing purpose, and shows the part of the next frame which is ignored ) :

$ etmccalc 25 0:0:0:10!25 0:0:0:15!25
00:00:01:00(0/1)

$ etmccalc 30 0:0:0:10!25 0:0:0:15!25
00:00:01:00(0/1)

$ etmccalc 29d 1:2:3:4!30 5:6:7:8!25 5:4:3:2!30
11:12:13;16(804/1001)

V 0.3.0 (2007-06-12)

This is the general command line syntax:

etmccalc <output-fps> [<timcode> <fps> [<timecode> <fps> [...]]

where :

<output-fps> is the frames-per-second specification for the result (an integer, 23d, 23n, 24d, 29d, 29n or 30d (d for drop-frame, n for not realtime)),
<timecode> the timecode for the calculation (currently in h:m:s:f format) and
<fps> the frames-per-second specification for the previous <timecode> (an integer, 23d, 23n, 24d, 29d, 29n or 30d (d for drop-frame, n for not realtime)).

Examples (the fraction between parentheses are for testing purpose, and shows the part of the next frame which is ignored ) :

$ etmccalc 25 0:0:0:10 25 0:0:0:15 25
00:00:01:00(0/1)

$ etmccalc 30 0:0:0:10 25 0:0:0:15 25
00:00:01:00(0/1)

$ etmccalc 29d 1:2:3:4 30 5:6:7:8 25 5:4:3:2 30
11:12:13;16(804/1001)

V 0.2.2 (2007-06-08)

This is the general command line syntax:

etmccalc <output-fps> [<timcode> <fps> [<timecode> <fps> [...]]

where :

<output-fps> is the frames-per-second specification for of the result (an integer, or 29d or 23d (d for drop-frame)),
<timecode> the timecode for the calculation (currently in h:m:s:f format) and
<fps> the frames-per-second specification for the previous <timecode> (an integer, or 29d or 23d (d for drop-frame)).

Examples (the fraction between parentheses are for testing purpose, and shows the part of the next frame which is ignored ) :

$ etmccalc 25 0:0:0:10 25 0:0:0:15 25
00:00:01:00(0/1)

$ etmccalc 30 0:0:0:10 25 0:0:0:15 25
00:00:01:00(0/1)

$ etmccalc 29d 1:2:3:4 30 5:6:7:8 25 5:4:3:2 30
11:12:53;25(3/5)

V 0.2.0 (2007-06-04)

This is the general command line :

etmccalc <output-fps> [<timcode> <fps> [<timecode> <fps> [...]]

where :

<output-fps> is the frames-per-second specification for of the result (an integer possibly followed by the d letter (for drop-frame)),
<timecode> the timecode for the calculation (currently in h:m:s:i: format) and
<fps> the frames-per-second specification for the previous <timecode> (an integer possibly followed by the d letter (for drop-frame)).

Examples (the fraction between parentheses are for testing purpose, and shows the part of the next frame which is ignored ) :

$ etmccalc 25 0:0:0:10 25 0:0:0:15 25
00:00:01:00(0/1)

$ etmccalc 30 0:0:0:10 25 0:0:0:15 25
00:00:00:25(0/1)

$ etmccalc 30d 1:2:3:4 30 5:6:7:8 25 5:4:3:2 30
11:12:53;25(3/5)

V 0.1.2 (2007-06-01)

This is the general command line :

etmccalc <output-fps> [<timcode> <fps> [<timecode> <fps> [...]]

where :

<output-fps> is the frames-per-second specification for of the result (a float possibly followed by the d letter (for drop-frame)),
<timecode> the timecode for the calculation (currently in h:m:s:i: format) and
<fps> the frames-per-second specification for the previous <timecode> (a float possibly followed by the d letter (for drop-frame)).

Examples :

$ etmccalc 25 0:0:0:10 25 0:0:0:15 25
00:00:01:00

$ etmccalc 30 0:0:0:10 25 0:0:0:15 25
00:00:00:25

$ etmccalc 30d 1:2:3:4 30 5:6:7:8 25 5:4:3:2 30
10:21:49;18

V 0.1.0 (2007-05-29)

This is the general command line :

etmccalc <output-fps> [<timcode> <fps> [<timecode> <fps> [...]]

where :

<output-fps> is the frames-per-second specification for of the result (currently available values : 25, 30 and 30d),
<timecode> the timecode for the calculation (currently in h:m:s:i: format) and
<fps> the frames-per-second specification for the previous <timecode> (currently available values : 25, 30 and 30d)

Examples :

$ etmccalc 25 0:0:0:10 25 0:0:0:15 25
00:00:01-00

$ etmccalc 30 0:0:0:10 25 0:0:0:15 25
00:00:00-25

$ etmccalc 25 1:2:3:4 30 5:6:7:8 30d 5:4:3:2 30
13:26:18-02