tcdecode(1) [debian man page]
tcdecode(1) General Commands Manual tcdecode(1) NAME
tcdecode - read multimedia streams from medium, decode to raw format and print to standard output SYNOPSIS
tcdecode -i name [ -x codec ] [ -t package ] [ -g WxH ] [ -s c,f,r ] [ -C s-e ] [ -y codec ] [ -Y ] [ -Q mode ] [ -A flag ] [ -d verbosity ] [ -v ] COPYRIGHT
tcdecode is Copyright (C) by Thomas Oestreich. DESCRIPTION
tcdecode is part of and usually called by transcode. However, it can also be used independently. tcdecode reads source (from stdin if not explicitely defined) and prints on the standard output. OPTIONS
-i name Specify input source. If ommited, stdin is assumed. tcdecode reads streams from file or from stdin. -g WxH video frame width and height [720x576] -C s-e decode and print out only this frame interval (video) or bytes (audio) [all]. -x codec source codec, if not detected of reading from stdin. This option also specifies video and audio context of the source for decoding. Currently, supported parameter for codec are mp3 MPEG audio (lame) ac3 AC3 audio (liba52) dv Digital Video DV (libdv) mpeg2 MPEG video (libmpeg2) yv12 Y'CbCr YUV mov Quicktime (libquicktime) -t package Currently only argument supported is "lavc". Use the codec by -x from this package. Available (-x) codecs for lavc are: mpeg2, divx3, divx, divx4, mp42, mjpg, rv10, svq1, svq3, vp3, 4xm, wmv1, wmv2, hfyu, indeo3, h263p, h263i -y codec target codec. tcdecode only decodes to raw format suitable for transcode. Valid option parameter for codec are rgb RGB 24bit yv12 Y'CbCr YUV yuy2 4:2:2 YUV pcm SIGNED LE 16bit PCM -s c,f,r audio gain for AC3 downmixing [1.0,1.0,1.0] -Y decoded Digital Video (raw) YUV frame is in YUY2 (packet) format using libdv. Downsample frame to YV12. PAL users should compile libdv with --with-pal-yuv=YV12 to avoid this option [off] -A flag audio flag for AC3/A52 decoder [none]. This flag determines the down-mixing configuration. Valid choices for flag are determined by the following bits set: drc off 1 demux 2 dolby off 4 Add those numbers to turn multiple options on. -Q mode decoding quality. Certain codecs, e.g., DV with libdv allow for changing this parameter if speed is prefered over quality. Valid parameter are 1=fastest-5=best [5]. -d level With this option you can specify a bitmask to enable different levels of verbosity (if supported). You can combine several levels by adding the corresponding values: QUIET 0 INFO 1 DEBUG 2 STATS 4 WATCH 8 FLIST 16 VIDCORE 32 SYNC 64 COUNTER 128 PRIVATE 256 -v Print version information and exit. NOTES
tcdecode is a front end for decoding various sources and is used in transcode(1)'s import modules. EXAMPLES
The command tcdecode -i foo.mp3 -x mp3 decodes an MPEG audio stream and prints raw PCM data to stdout. The command tcextract -i foo.avi -x mp3 | tcdecode -x mp3 extracts an MPEG audio track from the AVI-file foo.avi and pipes the frames into the decoder AUTHORS
tcdecode was written by Thomas Oestreich <ostreich@theorie.physik.uni-goettingen.de> with contributions from many others. See AUTHORS for details. SEE ALSO
avifix(1), avisync(1), avimerge(1), avisplit(1), tcprobe(1), tcscan(1), tccat(1), tcdemux(1), tcextract(1), tcdecode(1), transcode(1) tcdecode(1) 23th August 2003 tcdecode(1)
Check Out this Related Man Page
tcexport(1) General Commands Manual tcexport(1) NAME
tcexport - Simple frontend to transcode's encoding subsystem SYNOPSIS
tcexport [ -i video_file ] [ -p audio_file ] [ -o output_file ] [ -c f1-f2[,f3-f4[,...]] ] [ -N fmt,fmt ] [ -R n[,video_log[,audio_log]] ] [ -P profile[,profile] ] [ -y video_mod,audio_mod,mplex_mod ] [ -w bitrate[,keyint[,crisp]] ] [ -b bitrate[,vbr[,quality[,mode]]] ] [ -D ] [ -d verbosity ] [ -m path ] [ -v ] COPYRIGHT
tcexport is Copyright (C) by Francesco Romani DESCRIPTION
tcexport was designed as a debug tool for transcode's encoding code: it fits in a very limited range of usage cases; however, it can also be used independently if you like. tcexport encodes and multiplexes a raw YUV4MPEG2/WAV V/A stream using given parameters and transcode encoder components. tecexport provides direct and complete access to transcode's encoding features and modules, but hasn't any of transcode import/extracting/decoding/filtering capabilities. Use some other tc* tool if you need those facilities. tcexport's options are intentionally made similar, or identical if feasible, to corresponding transcode's encoding options. OPTIONS
-i video_file Specify the path of video source. Only regular files on filesystem are supported. video_file must be a YUV4MPEG2 stream, nothing else is supported. -p audio_file Specify the path of audio source. Only regular files on filesystem are supported. audio_file must be a WAVE stream, nothing else is supported. -o output_file Specify the (base)path of output file. Some multiplexors (es: raw multiplexor) uses value of this option as an hint to make the final output file(s) (i.e. appending different extensions for A/V streams). -c f1-f2[,f3-f4[, ... ] ] encode only frames f1-f2 [and f3-f4 and so on]. Default is to encode all available frames. Use this and you will get statistics about remaining encoding time. The f[N] parameters may also be timecodes in the HH:MM:SS.FRAME format. Example: -c 500-0:5:01,:10:20-1:18:02.1 Will encode only from frame 500 to 5 minutes and 1 second and from 10 min, 20 sec to 1 hour, 18 min, 2 sec and one frame. Note that tcexport, ad well as transcode, starts counting frames at 0 and excludes the last frame specified. That means that "-c 0-100" will encoded 100 frames starting at frame 0 up to frame 99 -N video_format,audio_format Setup the desired encoded video and audio format respectively. You must always use this option since there is some encoder modules (notably encode_ffmpeg) that support a lot of codecs, and tcexport nor modules can automatically choose a sane one not have defaults (yet). -R n[,video_log[,audio_log]] enable multi-pass encoding (0-3) [0,divx4.log,pcm.log]. 0 Constant bitrate (CBR) encoding. [default] The codec tries to achieve constant bitrate output. This means, each encoded frame is mostly the same size. This type of encod- ing can help in maintaining constant filling of hardware buffer on set top players or smooth streaming over networks. By the way, Constant bitrate is often obtained sacrifying quality during high motion scenes. 1 Variable bitrate encoding: First pass. In this mode, the codec analyses the complete sequence in order to collect data that can improve the distribution of bits in a second VBR pass. The collected data is written to second sub argument (default: divx4.log). This data is codec dependant and cannot be used across codecs. It is strongly advised to use the same codec settings for the VBR analysis pass and the VBR encod- ing pass if you want predictable results. The video output of the first pass is not of much use and can grow very large. It's a good idea to not save the video output to a file but directly to /dev/null. Usually the bitrate is ignored during first pass. Disabling audio export makes sense too, so use -y. 2 Variable bitrate encoding: Second pass. The first pass allowed the codec collecting data about the complete sequence. During the second pass, the codec will use that data in order to find an efficient bit distribution that respects both the desired bitrate and the natural bitrate curve shape. This ensures a good compromise between quality and desired bitrate. 3 Constant quantizer encoding. The quantizer is the "compression level" of the picture. The lower the quantizer is, the higher is the quality of the picture. This mode can help in making sure the sequence is encoded at constant quality, but no prediction can be made on the final bitrate. When using this mode, the -w option changes its meaning, it now takes the quantizer ranging from 1 to 31. Note that constant quantizer encoding is not supported with some codecs (notably mpeg1/2/4 with -y ffmpeg). -P profile[,profile] select export profile(s) to load. An export profile it's just a different, already tuned, set of basic values for tcexport's options. Even if isn't recomended, an user can always overwrite profile settings just using standard options. export profiles are stackable, just requesting to load multiple profiles separated by commas; if some options are set by more than one profile, the last profile determine their value. -y video_mod,audio_mod,mplex_mod Select export modules: video and audio encoders, and multiplexor module. You always must select both the encoders and multiplexor, there isn't implicit modules. The only exception to this rule is if this option isn't used at all: in this case tcexport will use null modules. -w bitrate[,keyint[,crisp]] encoder bitrate[,keyframes[,crispness]] [(6000 for MPEG 1/2, 1800 for others),250,100]. -b bitrate[,vbr[,quality[,mode]]] audio encoder bitrate kBits/s[,vbr[,quality[,mode]]] [128,0,5,0] -D Select dry run mode: tcexport will probe stream, load selected modules then exit, without doing anything else. -d verbosity Select the verbosity of program, support code and modules. See transcode's manpage to see supported verbosity levels. Please note that higher verbosity levels include lower ones, so if You select i.e. TC_DEBUG level you will get TC_DEBUG messages and TC_INFO messages. Please also note that high verbosity levels will output a lot of messages. -m path Look in Path instead of the compiled-in module path for a module. -v Print version information and exit. RETURN VALUES
tcexport uses following return values: 0 successfull 1 bad parameter or command line option 2 error while reading/writing from/to a file 3 requested an inexistent (or unreadable) module 4 a module raised an internal error 5 error while probing input file(s). Make sure they are of right format. 64 internal error. Please provide a report of what's happened on transcode-devel mailing list AUTHORS
tcexport was written by Francesco Romani <fromani@gmail.com> with contributions from the Transcode Team and many others. See AUTHORS for details. SEE ALSO
tccat(1), tcdecode(1), tcdemux(1), tcextract(1), tcprobe(1), transcode(1) tcmodinfo(1) tcexport(1) 9 April 2006 tcexport(1)