source: multimedia/libdriv/frei0r.xml@ 2eeb8695

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY frei0r-download-http "https://files.dyne.org/frei0r/releases/frei0r-plugins-&frei0r-version;.tar.gz">
  <!ENTITY frei0r-download-ftp  " ">
  <!ENTITY frei0r-md5sum        "78a7c7511cbda93013147563dc7a3618">
  <!ENTITY frei0r-size          "1.2 MB">
  <!ENTITY frei0r-buildsize     "39 MB">
  <!ENTITY frei0r-time          "0.1 SBU">
]>

<sect1 id="frei0r" xreflabel="frei0r-plugins-&frei0r-version;">
  <?dbhtml filename="frei0r.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>frei0r-plugins-&frei0r-version;</title>

  <indexterm zone="frei0r">
    <primary sortas="a-frei0r">frei0r</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Frei0r-plugins</title>

    <para>
      <application>Frei0r</application> is a minimalistic plugin API for
      video effects. Note that the 0 in the name is a zero, not a capital
      letter o.
    </para>

    &lfs91_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&frei0r-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&frei0r-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &frei0r-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &frei0r-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &frei0r-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &frei0r-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Frei0r-plugins Dependencies</bridgehead>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para>
       <xref linkend='gavl'/> 
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para>
      <xref linkend='doxygen'/> and
      <xref linkend='opencv'/> (currently broken)

    </para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/frei0r"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Frei0r-plugins</title>

    <para>
      Install <application>Frei0r</application> by running the
      following commands:
    </para>

<screen><userinput>mkdir -vp build &amp;&amp;
cd        build &amp;&amp;

cmake -DCMAKE_INSTALL_PREFIX=/usr \
      -DCMAKE_BUILD_TYPE=Release  \
      -DWITHOUT_OPENCV=TRUE       \
      -Wno-dev ..                 &amp;&amp;

make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>
<!--
    <para>
      <command>sed ... facebl0r.cpp</command>: This command fixes a build
      problem with the current opencv dependency.  
    </para>

    <para>
      <parameter>-DOpenCV_DIR=/usr/share/OpenCV</parameter>: This parameter
      helps the make procedure to find the <filename>libippicv.a</filename>
      library, installed under that directory tree.
    </para>
-->
    <para>
      <option>-DWITHOUT_OPENCV=TRUE</option>: This option instructs the make
      procedure to disable building plugins dependent upon opencv.
    </para>

    <para>
      <option>-DWITHOUT_GAVL=TRUE</option>: This option instructs the make
      procedure to disable building plugins dependent upon gavl.
    </para>
  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>Over 130 video effects plugins</seg>
        <seg>/usr/lib/frei0r-1</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>