====== tmcq: timecode converter ======

===== Introduction =====
//tmcq// is a tool from the //Epeios// project which makes [[wp>SMPTE_timecode|timecode]] conversions. 

//tmcq// exclusively uses system and C/C++ standard libraries. So, no other packages have to be installed for //tmcq// to work properly.

#@OS_HTML~tmcq~@#.

There is some examples just below. Also take a look at the [[.manual:|user manual]] or the [[.details:|details page]] for more informations.

===== Examples =====

Let's say you want to convert an //NTSC///29.97 frame count to a //PAL// frame count:

<code>
tmcq -f=%F 25 '7035@30d'
=> 5863
</code>

The previous example will make a mathematical rounding. So, if you are interested in the size of the error you can write this:

<code>
tmcq '-f=%F %r' 25 '7035@30d'
=> 5863 -0.0143
</code>

The result now contains a second value that tells you the error in seconds. A negative value means that the actual value should be smaller by the amount given. In this case the value was about 1/100 of a second smaller (0.01 seconds). The resulting value is too large by the same amount.
\\ 
\\ 
If you want to force rounding up or rounding down you can do it like this:

<code>
tmcq '-f=%>0F%F %r' 25 '7035@30d'
=> 5864 0.0257
</code>

For rounding down just swap the ''>'' with a ''<''.
\\ 
\\ 
There currently is no obvious way to convert from seconds (as a float value) to anything else. Here is a workaround:

<code>
tmcq '-f=%<0F%F' 30d '1.7035@10000'
=> 51
</code>
===== Installation =====

See the [[computing:epeios:compilation:|compilation dedicated page]] to see how to obtain the binaries.

Two files called ''tmcq.xcfg'' and ''tmcq.xlcl'' have to be in the same directory as the one containing the binary.


===== Configuration =====

See the [[computing:epeios:configuration:|configuration dedicated page]].

===== Licence =====

#@H_LICENSE_HTML~tmcq~@#

===== Status =====
  * Last stable release: **20150612**
  * [[http://hg.savannah.gnu.org/hgweb/epeios/file/tip/tools/tmcq/CHANGELOG.txt|Changelog]].

===== Download =====

http://q37.info/download/computing/tools/tmcq/

===== Author =====

#@M_AUTHOR_HTML~tmcq~@#

===== Resources =====
  * [[computing:epeios:tools:tmcq:manual:|User manual]],
  * [[http://hg.savannah.gnu.org/hgweb/epeios/file/tip/tools/tmcq/|source repository of the tool]], 
  * //tmcq// is hosted((submission: http://savannah.gnu.org/task/index.php?13648)) on [[http://savannah.nongnu.org/projects/tmcq/|GNU Savannah]]((http://savannah.nongnu.org/projects/tmcq/)) ; you will find there some other resources for this tool (bug tracking service, tech support manager...),
  * //tmcq// is also on [[http://freshcode.club/projects/tmcq|Freshcode]], with its own RSS/Atom feed to which you can subscribe to be informed when there are new releases.