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

<!-- ******************************************************** -->
<!--                                                          -->
<!--  [History]                                               -->
<!--    Converted to DocBook: Katsuya Amako, Aug-2006         -->
<!--                                                          -->
<!-- ******************************************************** -->


<!-- ******************* 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:

<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>
        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.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>