Chip 2005 June/ccd0605.iso/LINUX/gopchop-1.1.7.tar.tar/gopchop-1.1.7.tar/gopchop-1.1.7/docs/gopchop.sgml

SGML Document | 2005-05-02 | 5KB

<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- Process this file with docbook-to-man to generate an nroff manual
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
     less'.  A typical entry in a Makefile or Makefile.am is:

manpage.1: manpage.sgml
    docbook-to-man $< > $@
  -->

<!-- This is based on an example constructed by Colin Watson
     <email>[e-mail]</email>, based on a man page template
     provided by Tom Christiansen <email>[e-mail]</email>
     and a DocBook man page example by Craig Small
     <email>[e-mail]</email>.
  -->

  <!-- Fill in the various UPPER CASE things here. -->
  <!ENTITY manfirstname "<firstname>Kees</firstname>">
  <!ENTITY mansurname   "<surname>Cook</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY mandate      "<date>May 2, 2005</date>">
  <!-- SECTION should be 1-8, maybe with subsection. Other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY mansection   "<manvolnum>1</manvolnum>">
  <!ENTITY manemail     "<email>[e-mail]</email>">
  <!ENTITY manusername  "kees">
  <!ENTITY manucpackage "<refentrytitle>gopchop</refentrytitle>">
  <!ENTITY manpackage   "gopchop">
]>

<refentry>
  <refentryinfo>
    <address>
      &manemail;
    </address>
    <author>
      &manfirstname;
      &mansurname;
    </author>
    <copyright>
      <year>2001-2005</year>
      <holder>&manusername;</holder>
    </copyright>
    &mandate;
  </refentryinfo>
  <refmeta>
    &manucpackage;

    &mansection;
  </refmeta>
  <refnamediv>
    <refname>&manpackage;</refname>

    <refpurpose>
      Fast, lossless cuts-only editor for MPEG2 video files
    </refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&manpackage;</command>

      <group choice="opt"><arg><replaceable>options</replaceable></arg></group>
      <group choice="opt"><arg><replaceable>file</replaceable></arg></group>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

     <para>
     <command>&manpackage;</command> cuts and merges MPEG2 video streams. <command>&manpackage;</command> uses
     a method to cut streams that does not require re-encoding,
     and therefore is fast and not prone to the artifacts
     and degradation of quality inherent in re-encoding.
     However, cuts are limited to I-frames or
     group-of-picture (GOP) boundaries. These frames occur
     frequently enough, and often times at scene transitions,
     so that <command>&manpackage;</command>'s method is adequate for many applications.
     </para>
     <para>
     The typical use is manually editing commercials out of
     recorded television programs.
     </para>
     <para>
     Another application is splitting .VOB files from
     dual-layer DVD rips so that the content can be
     re-authored such that each half will fit on one
     single-layer DVD recordable.
     </para>

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <variablelist>
      <varlistentry>
        <term><option>-h, --help</option></term>
        <listitem>
          <para>
        Help.
      </para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term><option>-p, --pipe <replaceable>CMD</replaceable></option></term>
        <listitem>
          <para>
          Use external command for output. Recommended:
                        'mplayer -nocache -novm -'
      </para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term><option>-v, --vo <replaceable>DRIVER</replaceable></option></term>
        <listitem>
          <para>
          Choose internal output driver.  Use 'help' as <replaceable>DRIVER</replaceable> for a list.
      </para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term><option>-s, --states</option></term>
        <listitem>
          <para>
          Show libmpeg2 decoding states during display.  Used mostly for debugging.
      </para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term><option>-V, --version</option></term>
        <listitem>
          <para>
          Display which version of GOPchop is installed.
      </para>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>AUTHOR</title>
    <para><author>&manfirstname;</author> <author>&mansurname;</author>, &manemail;</para>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>gtkspu(1), mpegcat(1)</para>
  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->