.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SREVIEW-CUT 1p"
.TH SREVIEW-CUT 1p "2022-12-14" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
sreview\-cut \- cut a talk out of the raw recording data
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
sreview-cut \s-1TALKID\s0
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`sreview\-cut\*(C'\fR performs the following actions:
.IP "\(bu" 4
Look up the talk with id \s-1TALKID\s0 in the database
.IP "\(bu" 4
From the raw files, extract the amount of video that, according to the
schedule, is part of the talk of which the event was given as the main
video (with adjustments as specified by the reviewer, if any, applied).
.IP "\(bu" 4
Extract the 20 minutes just before and the 20 minuts just after the main
video into the pre and post videos.
.IP "\(bu" 4
Apply A/V sync correction values if any exist.
.IP "\(bu" 4
Perform audio normalization, if enabled in the configuration
.IP "\(bu" 4
Extract sample videos from all three channels into preview audio
streams, if enabled in the configuration
.IP "\(bu" 4
Move the talk to the next state.
.PP
sreview-cut will \fBnever\fR re-encode the original video, and will
re-encode the original audio of the main video at most once, after audio
normalization if that was enabled in the configuration.
.PP
Any re-transcodes should be performed by \f(CW\*(C`sreview\-transcode\*(C'\fR (for
production) and/or \f(CW\*(C`sreview\-previews\*(C'\fR (for review previews)
.SH "CONFIGURATION"
.IX Header "CONFIGURATION"
\&\f(CW\*(C`sreview\-cut\*(C'\fR considers the following configuration values:
.IP "workdir" 4
.IX Item "workdir"
The location where any temporary files are stored. Defaults to \f(CW\*(C`/tmp\*(C'\fR,
but can be overridden if necessary. These temporary files are removed
when \f(CW\*(C`sreview\-cut\*(C'\fR finishes.
.IP "dbistring" 4
.IX Item "dbistring"
The \s-1DBI\s0 string used to connect to the database.
.IP "audio_multiplex_mode" 4
.IX Item "audio_multiplex_mode"
The way in which the primary and backup audio channels are encoded in
the video. Can be one of:
.RS 4
.IP "stereo" 4
.IX Item "stereo"
The primary audio is in the left channel, and the backup audio is in the
right channel.
.IP "stream" 4
.IX Item "stream"
The primary audio is in the first audio stream (a mono stream), and the
backup audio is in the second audio stream (also a mono stream).
.IP "none" 4
.IX Item "none"
There is only one audio stream, and if it is a stereo channel then the
right channel is not the backup audio.
.RE
.RS 4
.RE
.IP "inputglob" 4
.IX Item "inputglob"
The location of the (raw) input files. These files should have been put
into the database by way of \f(CW\*(C`sreview\-detect\*(C'\fR
.IP "pubdir" 4
.IX Item "pubdir"
The location of the intermediate files that are published to reviewers.
.IP "accessmethods" 4
.IX Item "accessmethods"
The SReview::Files implementation used to access the input files
and/or the intermediate files.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
sreview-transcode, sreview-previews, sreview-skip, sreview-config