[ab4fdfc] | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
[6732c094] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[ed7e39b0] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[8dfc5c3] | 7 | <!ENTITY libquicktime-download-http "&sourceforge-dl;/libquicktime/libquicktime-&libquicktime-version;.tar.gz">
|
---|
[0b83a69] | 8 | <!ENTITY libquicktime-download-ftp " ">
|
---|
| 9 | <!ENTITY libquicktime-md5sum "81cfcebad9b7ee7e7cfbefc861d6d61b">
|
---|
| 10 | <!ENTITY libquicktime-size "1.0 MB">
|
---|
| 11 | <!ENTITY libquicktime-buildsize "20 MB">
|
---|
[e44819d] | 12 | <!ENTITY libquicktime-time "0.7 SBU (includes building all codec modules)">
|
---|
[ed7e39b0] | 13 | ]>
|
---|
| 14 |
|
---|
| 15 | <sect1 id="libquicktime" xreflabel="libquicktime-&libquicktime-version;">
|
---|
| 16 | <?dbhtml filename="libquicktime.html"?>
|
---|
| 17 |
|
---|
| 18 |
|
---|
| 19 | <title>libquicktime-&libquicktime-version;</title>
|
---|
| 20 |
|
---|
| 21 | <indexterm zone="libquicktime">
|
---|
| 22 | <primary sortas="a-libquicktime">libquicktime</primary>
|
---|
| 23 | </indexterm>
|
---|
| 24 |
|
---|
| 25 | <sect2 role="package">
|
---|
| 26 | <title>Introduction to libquicktime</title>
|
---|
| 27 |
|
---|
[0b83a69] | 28 | <para>
|
---|
| 29 | The <application>libquicktime</application> package contains the
|
---|
[4c24eb0a] | 30 | <filename class="libraryfile">libquicktime</filename> library, various
|
---|
[0b83a69] | 31 | plugins and codecs, along with graphical and command line utilities used
|
---|
| 32 | for encoding and decoding QuickTime files. This is useful for reading and
|
---|
| 33 | writing files in the QuickTime format. The goal of the project is to
|
---|
| 34 | enhance, while providing compatibility with the
|
---|
| 35 | <application>Quicktime 4 Linux</application> library.
|
---|
| 36 | </para>
|
---|
[ed7e39b0] | 37 |
|
---|
[181e069f] | 38 | &lfs121_checked;
|
---|
[a958f32] | 39 |
|
---|
[ed7e39b0] | 40 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 41 | <itemizedlist spacing="compact">
|
---|
| 42 | <listitem>
|
---|
[0b83a69] | 43 | <para>
|
---|
| 44 | Download (HTTP): <ulink url="&libquicktime-download-http;"/>
|
---|
| 45 | </para>
|
---|
[ed7e39b0] | 46 | </listitem>
|
---|
| 47 | <listitem>
|
---|
[0b83a69] | 48 | <para>
|
---|
| 49 | Download (FTP): <ulink url="&libquicktime-download-ftp;"/>
|
---|
| 50 | </para>
|
---|
[ed7e39b0] | 51 | </listitem>
|
---|
| 52 | <listitem>
|
---|
[0b83a69] | 53 | <para>
|
---|
| 54 | Download MD5 sum: &libquicktime-md5sum;
|
---|
| 55 | </para>
|
---|
[ed7e39b0] | 56 | </listitem>
|
---|
| 57 | <listitem>
|
---|
[0b83a69] | 58 | <para>
|
---|
| 59 | Download size: &libquicktime-size;
|
---|
| 60 | </para>
|
---|
[ed7e39b0] | 61 | </listitem>
|
---|
| 62 | <listitem>
|
---|
[0b83a69] | 63 | <para>
|
---|
| 64 | Estimated disk space required: &libquicktime-buildsize;
|
---|
| 65 | </para>
|
---|
[ed7e39b0] | 66 | </listitem>
|
---|
| 67 | <listitem>
|
---|
[0b83a69] | 68 | <para>
|
---|
| 69 | Estimated build time: &libquicktime-time;
|
---|
| 70 | </para>
|
---|
[ed7e39b0] | 71 | </listitem>
|
---|
| 72 | </itemizedlist>
|
---|
| 73 |
|
---|
[71db115] | 74 | <!--
|
---|
[89d37eb8] | 75 | <bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
---|
| 76 | <itemizedlist spacing="compact">
|
---|
| 77 | <listitem>
|
---|
| 78 | <para>
|
---|
| 79 | Required patch:
|
---|
[12ebd0e] | 80 | <ulink url="&patch-root;/libquicktime-&libquicktime-version;-ffmpeg4-1.patch"/>
|
---|
[89d37eb8] | 81 | </para>
|
---|
| 82 | </listitem>
|
---|
| 83 | </itemizedlist>
|
---|
[71db115] | 84 | -->
|
---|
[89d37eb8] | 85 |
|
---|
[ed7e39b0] | 86 | <bridgehead renderas="sect3">libquicktime Dependencies</bridgehead>
|
---|
| 87 |
|
---|
| 88 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
[0b83a69] | 89 | <para role="optional">
|
---|
| 90 | <xref linkend="alsa-lib"/>,
|
---|
[6de7590] | 91 | <xref linkend="doxygen"/>,
|
---|
[0b83a69] | 92 | <xref linkend="faac"/>,
|
---|
| 93 | <xref linkend="faad2"/>,
|
---|
[71db115] | 94 | <!--<xref linkend="ffmpeg"/>,-->
|
---|
[0b83a69] | 95 | <xref linkend="lame"/>,
|
---|
| 96 | <xref linkend="libdv"/>,
|
---|
| 97 | <xref linkend="libjpeg"/>,
|
---|
| 98 | <xref linkend="libpng"/>,
|
---|
| 99 | <xref linkend="libvorbis"/>,
|
---|
[27c8cca] | 100 | <xref linkend="x264"/>,
|
---|
[82b0e62] | 101 | <xref linkend="xorg7-lib"/>,
|
---|
| 102 | >k2; and
|
---|
[27c8cca] | 103 | <ulink url="https://launchpad.net/schroedinger">Schroedinger</ulink>
|
---|
[0b83a69] | 104 | </para>
|
---|
[ed7e39b0] | 105 |
|
---|
| 106 | </sect2>
|
---|
| 107 |
|
---|
| 108 | <sect2 role="installation">
|
---|
| 109 | <title>Installation of libquicktime</title>
|
---|
| 110 |
|
---|
[6d7516e] | 111 | <para>
|
---|
| 112 | First fix an issue with gcc14:
|
---|
| 113 | </para>
|
---|
| 114 |
|
---|
| 115 | <screen><userinput>sed -i '/qtpng.h/a #include <string.h>' plugins/png/qtpng.c</userinput></screen>
|
---|
| 116 |
|
---|
[0b83a69] | 117 | <para>
|
---|
| 118 | Install <application>libquicktime</application> by running the
|
---|
| 119 | following commands:
|
---|
| 120 | </para>
|
---|
[6d7516e] | 121 |
|
---|
| 122 | <screen><userinput>CFLAGS="-msse -msse2" \
|
---|
| 123 | ./configure --prefix=/usr \
|
---|
[6de7590] | 124 | --enable-gpl \
|
---|
| 125 | --without-doxygen \
|
---|
[71db115] | 126 | --without-ffmpeg \
|
---|
[b0de1262] | 127 | --docdir=/usr/share/doc/libquicktime-&libquicktime-version;
|
---|
[ed7e39b0] | 128 | make</userinput></screen>
|
---|
| 129 |
|
---|
[0b83a69] | 130 | <para>
|
---|
| 131 | This package does not come with a test suite.
|
---|
| 132 | </para>
|
---|
[ed7e39b0] | 133 |
|
---|
[0b83a69] | 134 | <para>
|
---|
| 135 | Now, as the <systemitem class="username">root</systemitem> user:
|
---|
| 136 | </para>
|
---|
[ed7e39b0] | 137 |
|
---|
| 138 | <screen role="root"><userinput>make install &&
|
---|
[41d241e] | 139 |
|
---|
[e44819d] | 140 | install -v -m755 -d /usr/share/doc/libquicktime-&libquicktime-version; &&
|
---|
| 141 | install -v -m644 README doc/{*.txt,*.html,mainpage.incl} \
|
---|
| 142 | /usr/share/doc/libquicktime-&libquicktime-version;</userinput></screen>
|
---|
[ed7e39b0] | 143 |
|
---|
| 144 | </sect2>
|
---|
| 145 |
|
---|
[dd3551e9] | 146 | <sect2 role="commands">
|
---|
[4bed342] | 147 | <title>Command Explanations</title>
|
---|
[864b24de] | 148 |
|
---|
[0b83a69] | 149 | <para>
|
---|
[aa93e7ab] | 150 | <parameter>--enable-gpl</parameter>: Changes the licence to GPL. This
|
---|
| 151 | enables some extra plugins, such as FAAC, FAAD2, and x264.
|
---|
[0b83a69] | 152 | </para>
|
---|
[dd3551e9] | 153 |
|
---|
[0b83a69] | 154 | <para>
|
---|
[41d241e] | 155 | <parameter>--without-doxygen</parameter>: This is necessary if you do not
|
---|
| 156 | have <application>Doxygen</application>, omit this if it is installed and
|
---|
| 157 | you wish the API documentation installed.
|
---|
[0b83a69] | 158 | </para>
|
---|
[4bed342] | 159 |
|
---|
[71db115] | 160 | <para>
|
---|
| 161 | <parameter>--without-ffmpeg</parameter>: This switch disables ffmpeg
|
---|
| 162 | support because it is incompatible with ffmpeg-5.
|
---|
| 163 | </para>
|
---|
| 164 |
|
---|
[0b83a69] | 165 | <para>
|
---|
[aa93e7ab] | 166 | <option>--with-libdv</option>: Build with libdv support.
|
---|
| 167 | Not enabled by default.
|
---|
[0b83a69] | 168 | </para>
|
---|
[dd3551e9] | 169 |
|
---|
[71db115] | 170 |
|
---|
[dd3551e9] | 171 | </sect2>
|
---|
[4bed342] | 172 |
|
---|
[ed7e39b0] | 173 | <sect2 role="content">
|
---|
| 174 | <title>Contents</title>
|
---|
| 175 |
|
---|
| 176 | <segmentedlist>
|
---|
| 177 | <segtitle>Installed Programs</segtitle>
|
---|
| 178 | <segtitle>Installed Libraries</segtitle>
|
---|
| 179 | <segtitle>Installed Directories</segtitle>
|
---|
| 180 |
|
---|
| 181 | <seglistitem>
|
---|
[0b83a69] | 182 | <seg>
|
---|
| 183 | libquicktime_config, lqtplay, lqtremux, lqt_transcode,
|
---|
[6de7590] | 184 | qt2text, qtdechunk, qtdump, qtinfo, qtrechunk, qtstreamize, and
|
---|
[0b83a69] | 185 | qtyuv4toyuv
|
---|
| 186 | </seg>
|
---|
| 187 | <seg>
|
---|
| 188 | libquicktime.so and several plugin codec libraries
|
---|
| 189 | </seg>
|
---|
| 190 | <seg>
|
---|
| 191 | /usr/include/lqt,
|
---|
[6de7590] | 192 | /usr/lib/libquicktime, and
|
---|
[0b83a69] | 193 | /usr/share/doc/libquicktime-&libquicktime-version;
|
---|
| 194 | </seg>
|
---|
[ed7e39b0] | 195 | </seglistitem>
|
---|
| 196 | </segmentedlist>
|
---|
| 197 |
|
---|
| 198 | <variablelist>
|
---|
| 199 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 200 | <?dbfo list-presentation="list"?>
|
---|
| 201 | <?dbhtml list-presentation="table"?>
|
---|
| 202 |
|
---|
| 203 | <varlistentry id="libquicktime_config">
|
---|
| 204 | <term><command>libquicktime_config</command></term>
|
---|
| 205 | <listitem>
|
---|
[0b83a69] | 206 | <para>
|
---|
| 207 | is a graphical front end to examine and configure the available
|
---|
[4c24eb0a] | 208 | <application>libquicktime</application> audio and video codecs
|
---|
[0b83a69] | 209 | </para>
|
---|
[ed7e39b0] | 210 | <indexterm zone="libquicktime libquicktime_config">
|
---|
| 211 | <primary sortas="b-libquicktime_config">libquicktime_config</primary>
|
---|
| 212 | </indexterm>
|
---|
| 213 | </listitem>
|
---|
| 214 | </varlistentry>
|
---|
| 215 |
|
---|
[52b1b8c] | 216 | <varlistentry id="lqtplay">
|
---|
| 217 | <term><command>lqtplay</command></term>
|
---|
[ed7e39b0] | 218 | <listitem>
|
---|
[0b83a69] | 219 | <para>
|
---|
[4c24eb0a] | 220 | is a simple QuickTime movie player for X Window System
|
---|
[0b83a69] | 221 | </para>
|
---|
[52b1b8c] | 222 | <indexterm zone="libquicktime lqtplay">
|
---|
| 223 | <primary sortas="b-lqtplay">lqtplay</primary>
|
---|
[ed7e39b0] | 224 | </indexterm>
|
---|
| 225 | </listitem>
|
---|
| 226 | </varlistentry>
|
---|
| 227 |
|
---|
[e5e7a1d] | 228 | <!--
|
---|
| 229 | <varlistentry id="lqtremux">
|
---|
| 230 | <term><command>lqtremux</command></term>
|
---|
| 231 | <listitem>
|
---|
| 232 | <para>
|
---|
| 233 |
|
---|
| 234 | </para>
|
---|
| 235 | <indexterm zone="libquicktime lqtremux">
|
---|
| 236 | <primary sortas="b-lqtremux">lqtremux</primary>
|
---|
| 237 | </indexterm>
|
---|
| 238 | </listitem>
|
---|
| 239 | </varlistentry>
|
---|
| 240 | -->
|
---|
| 241 |
|
---|
[ed7e39b0] | 242 | <varlistentry id="lqt_transcode">
|
---|
| 243 | <term><command>lqt_transcode</command></term>
|
---|
| 244 | <listitem>
|
---|
[0b83a69] | 245 | <para>
|
---|
| 246 | is a command-line program used to encode video and/or audio
|
---|
[4c24eb0a] | 247 | files from one format to another
|
---|
[0b83a69] | 248 | </para>
|
---|
[ed7e39b0] | 249 | <indexterm zone="libquicktime lqt_transcode">
|
---|
| 250 | <primary sortas="b-lqt_transcode">lqt_transcode</primary>
|
---|
| 251 | </indexterm>
|
---|
| 252 | </listitem>
|
---|
| 253 | </varlistentry>
|
---|
| 254 |
|
---|
[e5e7a1d] | 255 | <varlistentry id="qt2text">
|
---|
| 256 | <term><command>qt2text</command></term>
|
---|
| 257 | <listitem>
|
---|
| 258 | <para>
|
---|
[4c24eb0a] | 259 | is used to dump all text strings from a quicktime file
|
---|
[e5e7a1d] | 260 | </para>
|
---|
| 261 | <indexterm zone="libquicktime qt2text">
|
---|
| 262 | <primary sortas="b-qt2text">qt2text</primary>
|
---|
| 263 | </indexterm>
|
---|
| 264 | </listitem>
|
---|
| 265 | </varlistentry>
|
---|
| 266 |
|
---|
[ed7e39b0] | 267 | <varlistentry id="qtdechunk">
|
---|
| 268 | <term><command>qtdechunk</command></term>
|
---|
| 269 | <listitem>
|
---|
[0b83a69] | 270 | <para>
|
---|
| 271 | can take movies containing rgb frames and write them out as
|
---|
[4c24eb0a] | 272 | ppm images
|
---|
[0b83a69] | 273 | </para>
|
---|
[ed7e39b0] | 274 | <indexterm zone="libquicktime qtdechunk">
|
---|
| 275 | <primary sortas="b-qtdechunk">qtdechunk</primary>
|
---|
| 276 | </indexterm>
|
---|
| 277 | </listitem>
|
---|
| 278 | </varlistentry>
|
---|
| 279 |
|
---|
[e5e7a1d] | 280 | <varlistentry id="qtdump">
|
---|
| 281 | <term><command>qtdump</command></term>
|
---|
| 282 | <listitem>
|
---|
| 283 | <para>
|
---|
[4c24eb0a] | 284 | displays the parsed contents of the provided file
|
---|
[e5e7a1d] | 285 | </para>
|
---|
| 286 | <indexterm zone="libquicktime qtdump">
|
---|
| 287 | <primary sortas="b-qtdump">qtdump</primary>
|
---|
| 288 | </indexterm>
|
---|
| 289 | </listitem>
|
---|
| 290 | </varlistentry>
|
---|
| 291 |
|
---|
| 292 | <varlistentry id="qtinfo">
|
---|
| 293 | <term><command>qtinfo</command></term>
|
---|
| 294 | <listitem>
|
---|
| 295 | <para>
|
---|
| 296 | prints various pieces of metadata parsed by the libquicktime
|
---|
| 297 | library for the provided file
|
---|
| 298 | </para>
|
---|
| 299 | <indexterm zone="libquicktime qtinfo">
|
---|
| 300 | <primary sortas="b-qtinfo">qtinfo</primary>
|
---|
| 301 | </indexterm>
|
---|
| 302 | </listitem>
|
---|
| 303 | </varlistentry>
|
---|
| 304 |
|
---|
[ed7e39b0] | 305 | <varlistentry id="qtrechunk">
|
---|
| 306 | <term><command>qtrechunk</command></term>
|
---|
| 307 | <listitem>
|
---|
[0b83a69] | 308 | <para>
|
---|
[4c24eb0a] | 309 | concatenates input frames into a QuickTime movie
|
---|
[0b83a69] | 310 | </para>
|
---|
[ed7e39b0] | 311 | <indexterm zone="libquicktime qtrechunk">
|
---|
| 312 | <primary sortas="b-qtrechunk">qtrechunk</primary>
|
---|
| 313 | </indexterm>
|
---|
| 314 | </listitem>
|
---|
| 315 | </varlistentry>
|
---|
| 316 |
|
---|
[e5e7a1d] | 317 | <varlistentry id="qtstreamize">
|
---|
| 318 | <term><command>qtstreamize</command></term>
|
---|
| 319 | <listitem>
|
---|
| 320 | <para>
|
---|
| 321 | is used to make a file streamable by placing the moov header at the
|
---|
[4c24eb0a] | 322 | beginning of the file
|
---|
[e5e7a1d] | 323 | </para>
|
---|
| 324 | <indexterm zone="libquicktime qtstreamize">
|
---|
| 325 | <primary sortas="b-qtstreamize">qtstreamize</primary>
|
---|
| 326 | </indexterm>
|
---|
| 327 | </listitem>
|
---|
| 328 | </varlistentry>
|
---|
| 329 |
|
---|
[ed7e39b0] | 330 | <varlistentry id="qtyuv4toyuv">
|
---|
| 331 | <term><command>qtyuv4toyuv</command></term>
|
---|
| 332 | <listitem>
|
---|
[0b83a69] | 333 | <para>
|
---|
| 334 | is used to write a YUV4 encoded movie as a planar YUV 4:2:0
|
---|
[4c24eb0a] | 335 | file
|
---|
[0b83a69] | 336 | </para>
|
---|
[ed7e39b0] | 337 | <indexterm zone="libquicktime qtyuv4toyuv">
|
---|
| 338 | <primary sortas="b-qtyuv4toyuv">qtyuv4toyuv</primary>
|
---|
| 339 | </indexterm>
|
---|
| 340 | </listitem>
|
---|
| 341 | </varlistentry>
|
---|
| 342 |
|
---|
| 343 | <varlistentry id="libquicktime-lib">
|
---|
[4c24eb0a] | 344 | <term><filename class="libraryfile">libquicktime.so</filename></term>
|
---|
[ed7e39b0] | 345 | <listitem>
|
---|
[0b83a69] | 346 | <para>
|
---|
| 347 | is a library for reading and writing QuickTime files. It provides
|
---|
| 348 | convenient access to QuickTime files with a variety of supported
|
---|
| 349 | codecs. The library contains new functions integrated with all the
|
---|
| 350 | original QuickTime 4 Linux library functions used to encode and
|
---|
[4c24eb0a] | 351 | decode QuickTime files
|
---|
[0b83a69] | 352 | </para>
|
---|
[ed7e39b0] | 353 | <indexterm zone="libquicktime libquicktime-lib">
|
---|
| 354 | <primary sortas="c-libquicktime">libquicktime.so</primary>
|
---|
| 355 | </indexterm>
|
---|
| 356 | </listitem>
|
---|
| 357 | </varlistentry>
|
---|
| 358 |
|
---|
| 359 | </variablelist>
|
---|
| 360 |
|
---|
| 361 | </sect2>
|
---|
| 362 |
|
---|
| 363 | </sect1>
|
---|