Subversion Repositories pub

Compare Revisions

Ignore whitespace Rev 536 → Rev 537

/video-contact-sheet/branches/1.13/dist/docs/src/settings.man.inc.xml
5,7 → 5,7
<!ENTITY rArr "&#8658;">
<!ENTITY vcsmanpage "<citerefentry><refentrytitle>vcs</refentrytitle><manvolnum>1</manvolnum></citerefentry>">
]>
<!-- $Date: 2011-08-29 05:14:31 +0200 (dl, 29 ago 2011) $ -->
<!-- $Date: 2011-09-08 04:58:56 +0200 (dj, 08 set 2011) $ -->
<variablelist id="settings" lang="en-GB">
<varlistentry>
<term id="term-all">All settings</term>
26,6 → 26,7
<xref linkend="term-bg_sign" />,
<xref linkend="term-bg_title" />,
<xref linkend="term-bg_tstamps" />,
<xref linkend="term-capturer" />,
<xref linkend="term-columns" />,
<xref linkend="term-debug" />,
<xref linkend="term-decoder" />,
131,6 → 132,24
</listitem>
</varlistentry>
<varlistentry>
<term id="term-capturer"><literal>capturer</literal></term><!-- since 1.13 -->
<listitem>
<para>Controls which capturer to use.</para>
<para>Symbolic values: <literal><symbol>ffmpeg</symbol></literal> &rArr; FFmpeg,
<literal><symbol>mplayer</symbol></literal> &rArr; MPlayer</para>
<para>Default: <literal><symbol>ffmpeg</symbol></literal></para>
<para>Related command-line options:
<option>-F</option>, <option>--ffmpeg</option> and
<option>-M</option>, <option>--mplayer</option>
</para>
<warning>
<para>DVD mode sets the capturer to MPlayer disregarding the value of
this setting.</para>
</warning>
<para role="aside">Since version 1.13</para>
</listitem>
</varlistentry>
<varlistentry>
<term id="term-columns"><literal>columns</literal></term>
<listitem>
<para>Number of columns</para>
148,6 → 167,11
<varlistentry>
<term id="term-decoder"><literal>decoder</literal></term>
<listitem>
<warning>
<para>This setting is <emphasis role="strong">deprecated</emphasis>, use
<xref linkend="term-capturer" /> instead. Notice <xref linkend="term-capturer" />
has a different syntax.</para>
</warning>
<para>Controls which capturer to use.</para>
<para>Symbolic values: <literal><symbol>$DEC_FFMPEG</symbol></literal> &rArr; FFmpeg,
<literal><symbol>$DEC_MPLAYER</symbol></literal> &rArr; MPlayer</para>
/video-contact-sheet/branches/1.13/dist/vcs
182,8 → 182,9
declare -i TIMECODE_FROM=$TC_INTERVAL
# New in 1.13. Replaces the old 'decoder' symbolic option.
# The value is *not* the name of the executable, but a supported capturer,
#+right now 'ffmpeg' or 'mplayer'. Equivalent configuration setting: 'capturer'
declare PREFERRED_CAPTURER=ffmpeg
#+right now 'ffmpeg' or 'mplayer'.
# When none is defined, the first available element in CAPTURERS is used.
declare CAPTURER=
# Options used in imagemagick, these options set the final aspect
# of the contact sheet
declare FORMAT=png # ImageMagick decides the type from the extension
354,7 → 355,7
#+also, ffmpeg allows better seeking: ffmpeg allows exact second.fraction
#+seeking while mplayer apparently only seeks to nearest keyframe
# Starting with 1.13 this value can no longer be overridden directly,
#+setting 'decoder' actually changes PREFERRED_CAPTURER. DECODER is still used
#+setting 'decoder' actually changes CAPTURER. DECODER is still used
#+internally.
declare -i DECODER=$DEC_FFMPEG
 
445,9 → 446,6
CAPTURERS_AVAIL=( )
# Like CAPTURERS_AVAIL, for IDENTIFIERS
IDENTIFIERS_AVAIL=( )
# Set to the first available element in CAPTURERS, unless the user explicitly
#+picks a different one
CAPTURER=''
# Same for IDENTIFIERS
IDENTIFIER=''
# If 1, the selected CAPTURER understands the use of milliseconds
578,8 → 576,7
"TIMECODE_FROM:=:=:T"
"VERBOSITY:=:=:V"
"SIMPLE_FEEDBACK:=:=:b"
"PREFERRED_CAPTURER:=:=:x"
"CAPTURER:PREFERRED_CAPTURER:=:x"
"CAPTURER:=:=:x" # Setting this modifies DECODER and CAPTURER_HAS_MS, from pick_tools()
 
"HEIGHT:=:=:h"
"PADDING:=:=:n"
2239,11 → 2236,11
 
if [[ $1 = mplayer ]]; then
DECODER=$DEC_MPLAYER
PREFERRED_CAPTURER=mplayer
CAPTURER=mplayer
CAPTURER_HAS_MS=0
elif [[ $1 = ffmpeg ]]; then
DECODER=$DEC_FFMPEG
PREFERRED_CAPTURER=ffmpeg
CAPTURER=ffmpeg
CAPTURER_HAS_MS=1
else
assert false
2250,7 → 2247,7
fi
if [[ $up -eq 1 ]]; then
USR_DECODER=$DECODER
USR_PREFERRED_CAPTURER=$PREFERRED_CAPTURER
USR_CAPTURER=$CAPTURER
fi
}
 
3212,11 → 3209,9
pick_tools() {
trace $@
# User *wants* a certain decoder
if [[ $USR_PREFERRED_CAPTURER ]]; then
if echo "${CAPTURERS_AVAIL[@]}" | grep -qi "$PREFERRED_CAPTURER" ; then
CAPTURER=$(tolower $PREFERRED_CAPTURER)
else
error "User selected capturing tool ($PREFERRED_CAPTURER) is not available"
if [[ $USR_CAPTURER ]]; then
if ! grep -qi "$CAPTURER" <<<"${CAPTURERS_AVAIL[@]}" ; then
error "User selected capturing tool ($CAPTURER) is not available"
return $EX_UNAVAILABLE
fi
fi
3235,24 → 3230,21
break;
fi
done
if [[ $USR_PREFERRED_CAPTURER && $CAPTURER ]]; then
# User choose one, disregard it
assert '[[ $USR_PREFERRED_CAPTURER != $CAPTURER ]]'
warn "$(tolower $USR_PREFERRED_CAPTURER) can't capture in DVD mode, switching to $CAPTURER"
elif [[ -z $CAPTURER ]]; then
# No user-selected but none available with DVD support
if [[ -z $CAPTURER ]]; then
# None available with DVD support
error "No available capturer has DVD support"
return $EX_UNAVAILABLE
fi
if [[ $USR_CAPTURER != $CAPTURER ]]; then
# User choose one, we can't use
warn "$(tolower $USR_CAPTURER) can't capture in DVD mode, switching to $CAPTURER"
fi
fi
 
if [[ $CAPTURER == 'mplayer' ]]; then
CAPTURER_HAS_MS=0
DECODER=$DEC_MPLAYER
elif [[ $CAPTURER == 'ffmpeg' ]]; then
CAPTURER_HAS_MS=1
DECODER=$DEC_FFMPEG
fi
# Propagate to the related settings
local actual=$CAPTURER
[[ -z $USR_CAPTURER ]] || set_capturer $USR_CAPTURER 1 # Preferred
set_capturer $actual 0 # Actual
}
 
### }}}
4978,7 → 4970,6
exit $EX_UNAVAILABLE
fi
DVD_MODE=1
set_capturer mplayer 0
ASPECT_RATIO=-2 # Special value: Auto detect only if ffmpeg couldn't
;;
-q|--quiet)
5086,8 → 5077,7
;;
-D) # Repeat to just test consistency
if [[ $DEBUGGED -gt 0 ]]; then
[[ $DECODER -eq $DEC_MPLAYER ]] && d='mplayer'
[[ $DECODER -eq $DEC_FFMPEG ]] && d='ffmpeg'
pick_tools # Simulate a normal run
infplain '[ svn $Rev$ ]'
# Even when empty, POSIXLY_CORRECT has an effect, check if it's
# set ([[BIS]])
5094,7 → 5084,7
if [[ -n ${POSIXLY_CORRECT+x} ]]; then
pc="'${POSIXLY_CORRECT}'"
else
pc='not set'
pc='{not set}'
fi
# AWK and sed version can't be checked in all variants
awkv=$(awk --version 2>/dev/null | head -1) || true
5105,6 → 5095,12
if [[ -n $sedv ]]; then
sedv="${NL}sed: $sedv"
fi
usrcap=
if [[ -n $USR_CAPTURER ]]; then
usrcap=$USR_CAPTURER
else
usrcap='{default}'
fi
cat >&2 <<-EOD
=== Setup ===
GETOPT: $GETOPT
5112,13 → 5108,13
FFMPEG: $FFMPEG_BIN
AWK: $(realpathr $(type -pf awk))
sed: $(realpathr $(type -pf sed))
Filterchain: [ ${FILTERS_IND[*]} ]
Decoder: $d
POSIXLY_CORRECT: $pc
Capturers (av.): [ ${CAPTURERS_AVAIL[*]} ]
Identif. (av.): [ ${IDENTIFIERS_AVAIL[*]} ]
Pref. capturer: $PREFERRED_CAPTURER
Capturer: $CAPTURER
Chosen capturer: $usrcap
Filterchain: [ ${FILTERS_IND[*]} ]
Safe step: $QUIRKS_LEN_STEP
POSIXLY_CORRECT: $pc
=== Versions ===
Bash: $BASH_VERSION
Getopt: $($GETOPT --version)$awkv$sedv