1 /***************************************************************************
2 * Copyright (C) 2010 by Till Theato (root@ttill.de) *
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 *
16 * Free Software Foundation, Inc., *
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
18 ***************************************************************************/
21 #ifndef GEOMETRYWIDGET_H
22 #define GEOMETRYWIDGET_H
24 #include "ui_geometrywidget_ui.h"
26 #include <mlt++/Mlt.h>
31 class QGraphicsRectItem;
35 class TimecodeDisplay;
37 class GeometryWidget : public QWidget
41 /** @brief Sets up the UI and connects it.
42 * @param monitor Project monitor
43 * @param clipPos Position of the clip in timeline
44 * @param parent (optional) Parent widget */
45 GeometryWidget(Monitor *monitor, Timecode timecode, int clipPos, bool isEffect, QWidget* parent = 0);
46 virtual ~GeometryWidget();
47 /** @brief Gets the geometry as a serialized string. */
48 QString getValue() const;
49 /** @brief Updates the timecode display according to settings (frame number or hh:mm:ss:ff) */
50 void updateTimecodeFormat();
53 /** @brief Sets up the rect and the geometry object.
54 * @param elem DomElement representing this effect parameter
55 * @param minframe In point of the clip
56 * @param maxframe Out point of the clip */
57 void setupParam(const QDomElement elem, int minframe, int maxframe);
60 Ui::GeometryWidget_UI m_ui;
62 TimecodeDisplay *m_timePos;
63 /** Position of the clip in timeline. */
65 /** In point of the clip (crop from start). */
67 /** Out point of the clip (crop from end). */
70 MonitorScene *m_scene;
71 QGraphicsRectItem *m_rect;
72 KeyframeHelper *m_timeline;
73 /** Stores the different settings in the MLT geometry format. */
74 Mlt::Geometry *m_geometry;
77 /** @brief Updates controls according to position.
78 * @param pos (optional) Position to update to
79 * @param seek (optional, default = true) Whether to seek timleine & project monitor to pos
80 * If pos = -1 (default) the value of m_timePos is used. */
81 void slotPositionChanged(int pos = -1, bool seek = true);
82 /** @brief Updates settings after a keyframe was moved to @param pos. */
83 void slotKeyframeMoved(int pos);
84 /** @brief Adds a keyframe.
85 * @param pos (optional) Position where the keyframe should be added
86 * If pos = -1 (default) the value of m_timePos is used. */
87 void slotAddKeyframe(int pos = -1);
88 /** @brief Deletes a keyframe.
89 * @param pos (optional) Position of the keyframe which should be deleted
90 * If pos = -1 (default) the value of m_timePos is used. */
91 void slotDeleteKeyframe(int pos = -1);
92 /** @brief Goes to the next keyframe or to the end if none is available. */
93 void slotNextKeyframe();
94 /** @brief Goes to the previous keyframe or to the beginning if none is available. */
95 void slotPreviousKeyframe();
96 /** @brief Adds or deletes a keyframe depending on whether there is already a keyframe at the current position. */
97 void slotAddDeleteKeyframe();
99 /** @brief Makes sure the monitor effect scene is only visible if the clip this geometry belongs to is visible.
100 * @param renderPos Postion of the Monitor / Timeline cursor */
101 void slotCheckMonitorPosition(int renderPos);
103 /** @brief Updates the Mlt::Geometry object. */
104 void slotUpdateGeometry();
105 /** @brief Updates the spinBoxes according to the rect. */
106 void slotUpdateProperties();
108 /** @brief Sets the rect's x position to @param value. */
109 void slotSetX(int value);
110 /** @brief Sets the rect's y position to @param value. */
111 void slotSetY(int value);
112 /** @brief Sets the rect's width to @param value. */
113 void slotSetWidth(int value);
114 /** @brief Sets the rect's height to @param value. */
115 void slotSetHeight(int value);
117 /** @brief Resizes the rect by @param value (in perecent) compared to the frame size. */
118 void slotResize(int value);
120 /** @brief Moves the rect to the left frame border (x position = 0). */
122 /** @brief Centers the rect horizontally. */
124 /** @brief Moves the rect to the right frame border (x position = frame width - rect width). */
125 void slotMoveRight();
126 /** @brief Moves the rect to the top frame border (y position = 0). */
128 /** @brief Centers the rect vertically. */
130 /** @brief Moves the rect to the bottom frame border (y position = frame height - rect height). */
131 void slotMoveBottom();
134 void parameterChanged();
135 void checkMonitorPosition(int);