2 Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
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.
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.
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.
20 /** @file src/film_viewer.h
21 * @brief A wx widget to view `thumbnails' of a Film.
30 class RGBPlusAlphaImage;
33 * @brief A wx widget to view a preview of a Film.
35 * The film takes the following path through the viewer:
37 * 1. get_frame() asks our _player to decode some data. If it does, process_video()
40 * 2. process_video() takes the image from the decoder (_raw_frame) and calls raw_to_display().
42 * 3. raw_to_display() copies _raw_frame to _display_frame, processing it and scaling it.
44 * 4. calling _panel->Refresh() and _panel->Update() results in paint_panel() being called;
45 * this creates frame_bitmap from _display_frame and blits it to the display.
47 * update_from_decoder() asks the player to re-emit its current frame on the next pass(), and then
48 * starts from step #1.
50 * update_from_raw() starts at step #3, then calls _panel->Refresh and _panel->Update.
52 class FilmViewer : public wxPanel
55 FilmViewer (boost::shared_ptr<Film>, wxWindow *);
57 void set_film (boost::shared_ptr<Film>);
60 void film_changed (Film::Property);
61 void film_content_changed (boost::weak_ptr<Content>, int);
62 void paint_panel (wxPaintEvent &);
63 void panel_sized (wxSizeEvent &);
64 void slider_moved (wxScrollEvent &);
65 void play_clicked (wxCommandEvent &);
66 void timer (wxTimerEvent &);
67 void process_video (boost::shared_ptr<const Image>, bool, Time);
68 void calculate_sizes ();
69 void check_play_state ();
70 void update_from_raw ();
71 void update_from_decoder ();
72 void raw_to_display ();
74 void active_jobs_changed (bool);
75 void back_clicked (wxCommandEvent &);
76 void forward_clicked (wxCommandEvent &);
78 boost::shared_ptr<Film> _film;
79 boost::shared_ptr<Player> _player;
84 wxButton* _back_button;
85 wxButton* _forward_button;
87 wxStaticText* _timecode;
88 wxToggleButton* _play_button;
91 boost::shared_ptr<const Image> _raw_frame;
92 boost::shared_ptr<const Image> _display_frame;
93 /* The x offset at which we display the actual film content; this corresponds
94 to the film's padding converted to our coordinates.
99 /** Size of our output (including padding if we have any) */
100 libdcp::Size _out_size;
101 /** Size that we will make our film (equal to _out_size unless we have padding) */
102 libdcp::Size _film_size;
103 /** Size of the panel that we have available */
104 libdcp::Size _panel_size;