------------------------------------------------------------ demorec-to-ogg-theora: converter to OGG THEORA format This converter is an alpha version and needs the following software to be installed on your system: * ppmtoy4m : this is part of the mjpegtools * ffmpeg2theora * oggzmerge : this is part of oggz-tools Please send any feedback or questions regarding this export filter to chris@DemoRecorder.com ------------------------------------------------------------ demorec-to-ogg-theora [options] inputfile outputfile options: --resolution widthxheight e.g. --resolution 1024x768 resolution of the output-movie. If the input has another resolution, the movie is scaled accordingly. Default: use original resolution of the recording. Default for PAL: 720x576 Default for NTSC: 720x480 --frame-rate n --fps n --frames-per-second n specifies the frame-rate "n" in frames per second. This frame-rate is both the frame-rate used for capturing the demorecorder-movie as well as the frame-rate of the generated movie. The frame rate may be a a floating point number. Default: 25 frames per second. Default for NTSC: 29.97 frames per second. --capture-frames-per-second n specifies the frame-rate "n" used for capturing the demorecorder-movie. The frame-rate of the generated movie is not affected. The difference between both frame-rates may be used for frame-oversampling which may be used for temporal anti-aliasing (depending on the capabilities of the codec). Default: use frame rate set with --fps ( or the default specified for --fps ) --output-frames-per-second n specified the frame-rate "n" used for the generated movie. The frame rate for capturing the demorecorder-movie is not affected. Default: use frame rate set with --fps ( or the default specified for --fps ) --output-bitrate n specifies the (average) video-bitrate "n" of the generated movie in kbits/second. This option only makes sense for lossy codecs such as MPEGx. Defaults: for AVI, MPEG4 and MPEG1: 2000 kbits/sec for MPEG2 and VOB: 6000 kbits/sec --output-min-bitrate n specifies the minimum video-bitrate "n" of the generated movie. Default: no min-bitrate --output-max-bitrate n specifies the maximum video-bitrate "n" of the generated movie. Default: no max-bitrate --output-sound-bitrate n specifies the (average) sound-bitrate "n" used for the sound-track of the generated movie in kbits/second. Default: 64 kb/sec --no-sound don't include the sound in the exported video. --hide-cursor Hide the X-cursor on exporting. This is useful when exporting recordings of VMware because the cursor in the virtual machine is not the X-cursor. Default: show the cursor --speed-factor factor speed up the exported video by factor "factor". "factor" can be a floating point value. With values smaller than 1.0, the exported video can be made slower. Setting a speed factor implies disabling of sound. Default: 1.0 --rectangle widthxheight+x+y Export from a rectangular area of the original video. x is the number of pixels from the left edge of the original video to the left edge of the rectangle. y is the number of pixels from the upper edge of the original video to the upper edge of the rectangle. width is the width of the rectangle in pixels height is the height of the rectangle in pixels Default: Show whole recording. --start rel-starttime start exporting at rel-starttime which is relative to the begin of the video. "rel-starttime" is in one of the following formats: h:m:s, h:m:s.x, m:s, m:s.x, s, s.x where h is the number of hours, m is the number of minutes, s is the number of seconds, x is fractional seconds, i.e. the part after the decimal point Default: start at the beginning of the recording. --end rel-endtime finish exporting at rel-endtime which is relative to the begin of the video. "rel-endtime" is in the same format as "rel-starttime" for the option "--start" Default: finish at the end of the recording --sound-volume volume Default: 1.0 --sound-timeshift timeshift Default: 0 --sound-timefactor timefactor Make sound run faster by timefactor compared to the video. This option is primarily intended as a workaround in case of unknown bugs in the demorec-exporter or in case of bugs in 3rdparty players or 3rdparty importers. Default: 1.0 --screen-follows-mouse This option specifies that the screen containing the mouse-pointer is exported. --screen-num n This option specifies that the contents of screen number n are to be exported. ( n is a number greater or equal 0 and less than the number of screens in the recording ) Please note: --screen-follows-mouse has precedence over --screen-num. (in this case, --screen-num is only used if the screen of the mouse-pointer cannot be determined) Default: 0 --keep-screen-time timespan In mode --screen-follows-mouse: Keep the screen for" timespan" time after a switch to another screen. This avoids very fast multiple switches due to the mouse jumping fast between screens on moving it along the border between those two screens. timespan is given in seconds and may be specified as floating point number. Only applies if the cursor is within the delay-and-keep-region. (c.f. --screen-switch-delay-and-keep-region-width) --screen-switch-delay timespan In mode --screen-follows-mouse: Delay switch to another screen for "timespan" time. Same reasoning as for --keep-screen-time. Only applies if the cursor is within the delay-and-keep-region. (c.f. --screen-switch-delay-and-keep-region-width) --screen-switch-delay-and-keep-region-width width In mode --screen-follows-mouse: the delay timer and the keep timer for a screen-switch only apply if the cursor is within "width" pixels from the border of the screen. Therefore we still avoid fast multiple switches when moving along the border but we get an immediate reaction when the mouse is decisively moved well into the other screen. --batch listOfInputFiles This option specified a list of input files to be exported/rendered. The names of the corresponding outputfiles are computed by $scriptname By default, the name of each outputfile is computed by adding the extension \"$defaultBatchExtension\" to the corresponding inputname. The computation of the outputfilenames can be influenced with the options \"--batch-target-dir\", \"--batch-extension\" and \"--batch-prefix\" The listOfInputFiles is a list of files, separated by whitespace. If used from a shell, the list may contain filenames with shell-glob characters ( \"*\" and \"?\", ... ) , e.g. $scriptname --batch myvideo* Please note: * --batch must be the last option on the commandline because everything which comes after \"--batch\" is interpreted as a filename, even if it starts with a \"-\". * The inputfiles on the list must not contain blanks in their filenames. ( Quoting does not help ) * inputfiles which are not a demorecorder videos are ignored. Therefore it is safe to specify filename patterns such as \"myvideo*\" even if exported files such as avi-files are also matching. --batch-target-dir specifies the target-dir for batchmode outputfiles --batch-extension specifies the filename extension for batchmode outputfiles Please note: please include the \".\" or any other separation characters which the extension uses. e.g. --batch-extension .avi --batch-prefix specifies a prefix which is added at the start of an outputfilename in batchmode. The prefix is added to the basename, i.e. after the directory-name. --help displays this help text.