.. include:: ../../macros.hrst
.. include:: ../../abbreviations.hrst

.. _chapter:BeginningPicturesAndMovies:

Beginning: Pictures & Movies
##############################

Introduction
============

This usecase shows a user how to add pictures and movies to PowerPoint
slides.

Save Screenshot
===============

-  Start |paraview|.
-  Open can.ex2.
-  **Apply**.
-  Rotate and position the object.

-  **File → Save Screenshot**.

   -  Save only selected view will save either the whole window, or the
      selected view.
   -  Change the size of the output files. Note that |paraview| can save
      files that are significantly larger than the current view. This is
      done in off screen memory.
   -  Leave image quality as is.
   -  Override Color Palette allows a user to change the background
      color - for instance, to white.
   -  Stereo mode allows a user to save stereo images.

-  **OK**

   -  Save your images as .png or .jpg. .png is a cleaner format, but
      .jpg's may be smaller.

-  Name and save the file. **OK**

In PowerPoint:

-  Add a new slide.
-  Next, click **Insert → Picture→ From File…**, and pick up the file that we saved in the previous paragraph.
-  You can move the file anywhere you want by holding the left mouse button and dragging.
-  You can resize the picture by grabbing one of the corners and dragging the picture smaller.

Save Animation (make a movie)
=============================

-  Start |paraview|.
-  Open can.ex2.
-  **Apply**.
-  Rotate and position the object.

-  **File → Save Animation**.

   -  Leave Frane Rate and No. of Frames alone.
   -  Change the size of the output files. Note that |paraview| can save
      files that are significantly larger than the current view. This is
      done in off screen memory.
   -  Set timestep range.
   -  Stereo mode allows a user to save stereo images.

-  **OK**

   -  Save your movie. A great option is to save your images as .png or
      .jpg, and then post process them into .avi or .mov files. This
      way, you have your movies and the individual frames. .png is a
      cleaner format, but .jpg's may be smaller.
   -  You can also save a subset of the whole movie.  this is useful if you are
      running out of wall time on a cluster.  Use the **Advanced** icon
      (little gear at the top right), then scroll down to the controls at the bottom of the
      dialog box.

-  Name and save the file.
-  **OK**

In PowerPoint:

-  Add a new slide.
-  Next, click **Insert → Movies and Sounds → Movie from File**.
-  Browse to the location of your movie.
-  Select your file.
-  **OK**.
-  Decide if you want the slide show to be Automatic, or when clicked.
-  Finally, remember that this file is NOT inserted into the PowerPoint slide.
-  You will want this file to be on the computer – in the same location – as it was when you selected it.


A few notes on file formats for movies.
=======================================

- You can make .avi files directly on Windows, Linux or Mac.
- ParaView will create .mp4 movies on Windows, but not Mac or Linux. We can only
  create mp4s if the OS supplies the codec.
- If you are trying to make movies on Linux or Mac, or are making
  movies for a powerwall, one option is to use format .png or .jpg.  Then, if you want
  .avi files for use with PowerPoint, convert these movies to .avi format
  as needed. One option is to use ffmpeg.  Another option is to use enve, which is available with EnSight.

Examples converting a stack of images to movies (mp4 or avi) using ffmpeg is:
- ffmpeg -r 1 -i deleteMeAFfmpegTest.0%03d.png -vf fps=25 out.mp4
- ffmpeg -r 1 -i deleteMeAFfmpegTest.0%03d.png -vf fps=25 out.avi


Movie players (play a movie)

- A great option for an opensource video/movie player is VLC.  VLC can be installed on Windows, Mac or Linux.

Export Scene
============

Export Scene may export all the geometry, coloring, background colors,
and possibly other elements in the current scene to a 3D file format that
can contain those elements and which can be loaded into other programs for 3D
viewing. Examples of formats are Alembic and glTF. The Export
Scene feature is selected from the main menu: File → Export Scene.


**Export Scene** can be used to:

-  Create .webgl files of what is displayed in the viewport.
   A .html file will be written out, which you can load in a web browser.
   This format allows users to create interactive data products that anyone can load in a web browser.
-  Create .pdf files of what is displayed in the viewport.