source: trunk/documents/UserDoc/DocBookUsersGuides/ForApplicationDeveloper/xml/Visualization/makingamovie.xml @ 1211

<!-- ******************************************************** -->
<!--                                                          -->
<!--  [History]                                               -->
<!--    Converted to DocBook: Katsuya Amako, Aug-2006         -->
<!--    Updates for Qt: Laurent Garnier, Dec-2008             -->
<!--                                                          -->
<!-- ******************************************************** -->


<!-- ******************* Section (Level#1) ****************** -->
<sect1 id="sect.MkMovie">
<title>
Making a Movie
</title>

<para>
These instructions are suggestive only. The following procedures
have not been tested on all platforms. There are clearly some
instructions that apply only to Unix-like systems with an X-Windows
based windowing system. However, it should not be difficult to take
the ideas presented here and extend them to other platforms and
systems. 
</para>

<para>
The procedures described here need graphics drivers that
can produce picture files that can be converted to a form suitable
for an MPEG encoder. There may be other ways of capturing the
screen images and we would be happy to hear about them. Graphics
drivers currently capable of producing picture files are:

<ulink url="http://bmrc.berkeley.edu/frame/research/mpeg/mpeg_encode.html">More informations about MPEG encoder</ulink>

<informaltable>
  <tgroup cols="2">
    <tbody>
    <row>
      <entry>
        <emphasis role="bold">Driver</emphasis>
      </entry>
      <entry>
        <emphasis role="bold">File type</emphasis>
      </entry>
    </row>
    <row>
      <entry>
        DAWNFILE
      </entry>
      <entry>
        prim then eps using <emphasis role="bold">dawn</emphasis>
      </entry>
    </row>
    <row>
      <entry>
        HepRepFile
      </entry>
      <entry>
        HepRep1
      </entry>
    </row>
    <row>
      <entry>
        HepRep
      </entry>
      <entry>
        HepRep2
      </entry>
    </row>
    <row>
      <entry>
        OGLX
      </entry>
      <entry>
        eps
      </entry>
    </row>
    <row>
      <entry>
        Qt
      </entry>
      <entry>
        jpeg, eps, ppm, ...
      </entry>
    </row>
    <row>
      <entry>
        RayTracer
      </entry>
      <entry>
        jpeg
      </entry>
    </row>
    <row>
      <entry>
        VRMLFILE
      </entry>
      <entry>
        vrml
      </entry>
    </row>
    </tbody>
  </tgroup>
</informaltable>
</para>

<para>
So far, only DAWNFILE, OGLX and RayTracer have been "road tested".
Once in a standard format, such as eps, the 
<emphasis role="bold">convert</emphasis> program from 
<ulink url="http://www.imagemagick.org">
ImageMagick
</ulink>
 can convert to ppm files suitable for 
<emphasis role="bold">mpeg2encode</emphasis>.
</para>


<!-- ******************* Section (Level#2) ****************** -->
<sect2 id="sect.MkMovie.OGLX">
<title>
OGLX
</title>

<para>
Make a macro something like this:

<informalexample>
<programlisting>
/control/verbose 2
/vis/open OGLSX 600x600-0+0
/vis/drawVolume
/vis/viewer/reset
/vis/viewer/set/style surface
/vis/viewer/set/projection perspective 50 deg
/control/alias phi 30
/control/loop movie.loop theta 0 360 1
</programlisting>
</informalexample>

which invokes movie.loop, which is something like:

<informalexample>
<programlisting>
/vis/viewer/set/viewpointThetaPhi {theta} {phi}
/vis/viewer/zoom 1.005
/vis/ogl/printEPS
</programlisting>
</informalexample>
</para>

<para>
This produces lots of eps files. Then...

<informalexample>
<programlisting>
<ulink url="./make_mpeg2encode_parfile.sh">make_mpeg2encode_parfile.sh</ulink> G4OpenGL_*eps
</programlisting>
</informalexample>
</para>

<para>
Then edit mpeg2encode.par to specify file type and size, etc.:

<informalexample>
<programlisting>
$ diff mpeg2encode.par~ mpeg2encode.par
7c7
&lt; 1         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
---
&gt; 2         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
15,17c15,17
&lt;    /* horizontal_size */
&lt;   /* vertical_size */
&lt; 8         /* aspect_ratio_information 1=square pel, 2=4:3, 3=16:9, 4=2.11:1 */
---
&gt; 600   /* horizontal_size */
&gt; 600  /* vertical_size */
&gt; 1         /* aspect_ratio_information 1=square pel, 2=4:3, 3=16:9, 4=2.11:1 */
</programlisting>
</informalexample>
</para>

<para>
Then convert to ppm:

<informalexample>
<programlisting>
for i in G4OpenGL*eps; 
  do j=`basename $i .eps`; command="convert $i $j.ppm"; echo $command; $command; done
</programlisting>
</informalexample>
</para>

<para>
Then

<informalexample>
<programlisting>
mpeg2encode mpeg2encode.par G4OpenGL.mpg
</programlisting>
</informalexample>
</para>

<para>
Then, on Mac, for example:

<informalexample>
<programlisting>
open G4OpenGL.mpg
</programlisting>
</informalexample>

opens a QuickTime player.
</para>

</sect2>

<!-- ******************* Section (Level#2) ****************** -->
<sect2 id="sect.MkMovie.Qt">
<title>
Qt
</title>

<para>
The Qt driver provides one of the easiest ways to make a movie.
Of course, you first need to add the Qt libraries and link with Qt,
but once you have that, Qt provides a ready-made function to store all updates of the OpenGL
frame into the movie format.
You then use loops (as defined in OGLX section above) or even move/rotate/zoom you scene
by mouse actions to form your movie.
</para>
<para>
The Qt driver automatically handles all of the movie-making steps described in the OGLX section of this document - storing the files, converting them and assembling the finished movie.
You just have to take care of installing an mpeg_encoder.
</para>
<para>
To make a movie :
<itemizedlist spacing="compact">
  <listitem><para>
   Right click to display a context menu, "Action"->"Movie parameters".
  </para></listitem>
  <listitem><para>
   Select MPEG encoder path if it was not found.
  </para></listitem>
  <listitem><para>
   Select the name of the output movie.
  </para></listitem>
  <listitem><para>
   Let go! Hit SPACE to Start/Pause recording, RETURN to STOP
  </para></listitem>
</itemizedlist>
</para>
<para>
Then, open your movie (on Mac, for example):

<informalexample>
<programlisting>
open G4OpenGL.mpg
</programlisting>
</informalexample>

opens a QuickTime player.
</para>

</sect2>


<!-- ******************* Section (Level#2) ****************** -->
<sect2 id="sect.MkMovie.DAWNFILE">
<title>
DAWNFILE
</title>

<para>
You need to invoke <emphasis role="bold">dawn</emphasis> in "direct" mode, 
which picks up parameters from .DAWN_1.history, and suppress the GUI:

<informalexample>
<programlisting>
alias dawn='dawn -d'
export DAWN_BATCH=1
</programlisting>
</informalexample>
</para>

<para>
Change OGLSX to DAWNFILE in the above set of Geant4 commands and
run. Then convert to ppm files as above:

<informalexample>
<programlisting>
for i in g4_*.eps; 
  do j=`basename $i .eps`; command="convert $i $j.ppm"; echo $command; $command; done
</programlisting>
</informalexample>
</para>

<para>
Then make a .par file:

<informalexample>
<programlisting>
<ulink url="./make_mpeg2encode_parfile.sh">make_mpeg2encode_parfile.sh</ulink> g4_*ppm
</programlisting>
</informalexample>

and edit mpeg2encode.par:

<informalexample>
<programlisting>
$ diff mpeg2encode.par~ mpeg2encode.par
7c7
&lt; 1         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
---
&gt; 2         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
9c9
&lt; 1         /* number of first frame */
---
&gt; 0         /* number of first frame */
15,16c15,16
&lt;    /* horizontal_size */
&lt;   /* vertical_size */
---
&gt; 482   /* horizontal_size */
&gt; 730  /* vertical_size */
</programlisting>
</informalexample>
</para>

<para>
Then encode and play:

<informalexample>
<programlisting>
mpeg2encode mpeg2encode.par DAWN.mpg
open DAWN.mpg
</programlisting>
</informalexample>
</para>

</sect2>


<!-- ******************* Section (Level#2) ****************** -->
<sect2 id="sect.MkMovie.RyTrcX">
<title>
RayTracerX
</title>

<para>
<informalexample>
<programlisting>
/control/verbose 2
/vis/open RayTracerX 600x600-0+0
# (Raytracer doesn't need a scene; smoother not to /vis/drawVolume.)
/vis/viewer/reset
/vis/viewer/set/style surface
/vis/viewer/set/projection perspective 50 deg
/control/alias phi 30
/control/loop movie.loop theta 0 360 1
</programlisting>
</informalexample>

where movie.loop is as above. This produces lots of jpeg files (but
takes 3 days!!!). Then...

<informalexample>
<programlisting>
<ulink url="./make_mpeg2encode_parfile.sh">make_mpeg2encode_parfile.sh</ulink> g4RayTracer*jpeg
</programlisting>
</informalexample>
</para>

<para>
Then edit mpeg2encode.par to specify file type and size, etc.:

<informalexample>
<programlisting>
$ diff mpeg2encode.par.orig mpeg2encode.par      
7c7
&lt; 1         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
---
&gt; 2         /* input picture file format: 0=*.Y,*.U,*.V, 1=*.yuv, 2=*.ppm */
15,17c15,17
&lt;    /* horizontal_size */
&lt;   /* vertical_size */
&lt; 8         /* aspect_ratio_information 1=square pel, 2=4:3, 3=16:9, 4=2.11:1 */
---
&gt; 600   /* horizontal_size */
&gt; 600  /* vertical_size */
&gt; 1         /* aspect_ratio_information 1=square pel, 2=4:3, 3=16:9, 4=2.11:1 */
</programlisting>
</informalexample>
</para>

<para>

Then convert to ppm, encode and play:

<informalexample>
<programlisting>
for i in g4*jpeg; 
  do j=`basename $i .jpeg`; command="convert $i $j.ppm"; echo $command; $command; done
mpeg2encode mpeg2encode.par g4RayTracer.mpg
open g4RayTracer.mpg
</programlisting>
</informalexample>
</para>


</sect2>
</sect1>