src/wx/film_viewer.h

   1 /*
   2     Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 /** @file  src/film_viewer.h
  21  *  @brief A wx widget to view `thumbnails' of a Film.
  22  */
  23
  24 #include <wx/wx.h>
  25 #include "lib/film.h"
  26
  27 class wxToggleButton;
  28 class FFmpegPlayer;
  29 class Image;
  30 class RGBPlusAlphaImage;
  31 class Subtitle;
  32
  33 /** @class FilmViewer
  34  *  @brief A wx widget to view a preview of a Film.
  35  *
  36  *  The film takes the following path through the viewer:
  37  *
  38  *  1.  get_frame() asks our _player to decode some data.  If it does, process_video()
  39  *      will be called.
  40  *
  41  *  2.  process_video() takes the image and subtitle from the decoder (_raw_frame and _raw_sub)
  42  *      and calls raw_to_display().
  43  *
  44  *  3.  raw_to_display() copies _raw_frame to _display_frame, processing it and scaling it.
  45  *
  46  *  4.  calling _panel->Refresh() and _panel->Update() results in paint_panel() being called;
  47  *      this creates frame_bitmap from _display_frame and blits it to the display.  It also
  48  *      blits the subtitle, if required.
  49  *
  50  * update_from_decoder() asks the player to re-emit its current frame on the next pass(), and then
  51  * starts from step #1.
  52  *
  53  * update_from_raw() starts at step #3, then calls _panel->Refresh and _panel->Update.
  54  */
  55 class FilmViewer : public wxPanel
  56 {
  57 public:
  58         FilmViewer (boost::shared_ptr<Film>, wxWindow *);
  59
  60         void set_film (boost::shared_ptr<Film>);
  61
  62 private:
  63         void film_changed (Film::Property);
  64         void paint_panel (wxPaintEvent &);
  65         void panel_sized (wxSizeEvent &);
  66         void slider_moved (wxScrollEvent &);
  67         void play_clicked (wxCommandEvent &);
  68         void timer (wxTimerEvent &);
  69         void process_video (boost::shared_ptr<Image>, bool, boost::shared_ptr<Subtitle>);
  70         void calculate_sizes ();
  71         void check_play_state ();
  72         void update_from_raw ();
  73         void update_from_decoder ();
  74         void raw_to_display ();
  75         void get_frame ();
  76         void active_jobs_changed (bool);
  77
  78         boost::shared_ptr<Film> _film;
  79         boost::shared_ptr<Player> _player;
  80
  81         wxSizer* _v_sizer;
  82         wxPanel* _panel;
  83         wxSlider* _slider;
  84         wxToggleButton* _play_button;
  85         wxTimer _timer;
  86
  87         boost::shared_ptr<Image> _raw_frame;
  88         boost::shared_ptr<Subtitle> _raw_sub;
  89         boost::shared_ptr<Image> _display_frame;
  90         int _display_frame_x;
  91         boost::shared_ptr<RGBPlusAlphaImage> _display_sub;
  92         Position _display_sub_position;
  93         bool _got_frame;
  94
  95         /** Size of our output (including padding if we have any) */
  96         libdcp::Size _out_size;
  97         /** Size that we will make our film (equal to _out_size unless we have padding) */
  98         libdcp::Size _film_size;
  99         /** Size of the panel that we have available */
 100         libdcp::Size _panel_size;
 101 };